# Installation and Upgrade Guide

# Configuring Exchange Portlet Properties

This chapter provides information for modifying portlet properties files for mail, contact, and calendar portlets.

## Configuring Mail Properties

In addition to the settings you can manage in the Administrative Preferences page of the portlets, you can modify settings in the mail_properties.xml, which is installed in the following directory by default: C:\bea\alui\PortletSuiteExchange2000\3.2\settings\config\.

To configure your mail properties:

1. Open the mail_properties.xml file in a text editor.
2. You can modify true/false values to enable or disable a feature. You can modify numeric values to set preferred constraints. You can change image file names if you have copied custom image files to the Image Service. The following table lists the preference values that administrators typically modify.

   Preference | Value Description
   --- | ---
   message.editor.height message.editor.width | These preferences control the height and width of the window that opens for the message editor. Enter a numeric value followed by px (the default for both height and width is 500px).
   enable.sorting enable.sorting.<column> | Enter a true/false value to enable/disable sorting in general and enable/disable sorting by column.
   display.toolbar display.button.<button> | Enter a true/false value to enable/disable the toolbar and associated buttons.
   display.header.<column> | Enter a true/false value to enable/disable the display of property columns for messages.
   image.directory image.<image> | The image directory and image file names are set according to the default file names installed on the Image Service. These should not be modified unless the source file names have been modified or replaced with new files.
   page.sizes | Controls the values in the user interface drop-down list for users to determine the number of messages per page. For example, you can modify the following value in the default string:
       <page.sizes>3,5,10,15,20</page.sizes>
   to
       <page.sizes>3,5,10,15,20,50</page.sizes>
   This enables users to display up to 50 messages per page.
   enable.50styles | Enter a true/false value to enable/disable the display of styles contained in Plumtree Corporate Portal 5.0.

3. To load the new values, save the changes to the file and restart your Web application server.

## Configuring Contact Properties

In addition to the settings you can manage in the Administrative Preferences page of the portlets, you can modify settings in the contact_properties.xml, which is installed in the following directory by default: C:\bea\alui\PortletSuiteExchange2000\3.2\settings\config\.

To configure your contact properties:

1. Open the contact_properties.xml file in a text editor.
2. You can modify true/false values to enable or disable a feature. You can modify numeric values to set preferred constraints. You can change image file names if you have copied custom image files to the Image Service. The table below lists the preference values that administrators typically modify.

   Preference | Value Description
   --- | ---
   page.sizes | Controls the values in the user interface drop-down list for users to determine the number of contacts displayed per page in a contact search. For example, you can modify the following value in the default string: `<page.sizes>5,10,15,20,25,30,35,40</page.sizes>` to `<page.sizes>5,10,15,20,25,30,35,40,45,50</page.sizes>` This enables users to display up to 50 contacts per page.
   enable.email.clickthrough | Enter a true/false value to enable/disable a contact's displayed e-mail address as a link. If this value is set to true, users can click the linked e-mail to enable a new message addressed to the contact. If this value is set to false, the e-mail is displayed as plain text.
   display.button.<button> | Enter a true/false value to enable/disable the toolbar buttons
   image.directory | The image directory and image file names are set according to the default file names installed on the Image Service. These should not be modified unless the source file names have been modified or replaced with new files.
   max.wml.size | Controls the maximum character length allowed in a WML display before it truncates. Enter a numeric value for your desired character length.
   enable.50styles | Enter a true/false value to enable/disable the display of styles contained in Plumtree Corporate Portal v.5.0.

3. To load the new values, save the changes to the file and restart your Web application server.

## Configuring Calendar Properties

In addition to the settings you can manage in the Administrative Preferences page of the portlets, you can modify settings in the calendar_properties.xml, which is installed in the following directory by default: C:\bea\alui\PortletSuiteExchange2000\3.2\settings\config\.

To configure your calendar properties:

1. Open the calendar_properties.xml file in a text editor.
2. You can modify true/false values to enable or disable a feature. You can modify numeric values to set preferred constraints. You can change image file names if you have copied custom image files to the Image Service. The table below lists the preference values that administrators typically modify.

   Preference | Value Description
   --- | ---
   enable.address.search | Enter a true/false value to enable/disable users to search from among other users to add to a meeting request.
   enable.meeting.request | Enter a true/false value to enable/disable meeting request functionality in the portlet.
   message.editor.height message.editor.width | These preferences control the height and width of the window that opens for the message editor. Enter a numeric value followed by px (the default for both height and width is 500px).
   enable.calendar.links | Enter a true/false value to enable /disable links for viewing details of listed appointments in the calendar display.
   display.button.<button> display.toolbar | Enter a true/false value to enable/disable the display of the toolbar and associated buttons.
   image.directory | The image directory and image file names are set according to the default file names installed on the Image Service. These should not be modified unless the source file names have been modified or replaced with new files.
   enable.50styles | Enter a true/false value to enable/disable the display of styles contained in Plumtree Corporate Portal 5.0.x.

3. To load the new values, save the changes to the file and restart your Web application server.