Chapter 6 Modifying the Properties and Attributes

This chapter contains the following:

• communitymc.properties File

• communitymgmnt.properties File

• Community Webservice URL

communitymc.properties File

This file configures the community membership and configuration component of the Portal Server software. For the most part, this file contains low level configuration that need not be modified. For performance reasons, if the community feature is not used, this file must be changed to avoid calls to Java DB on each portal request.

To modify the file, log into any system that has portal server installed as superuser and access the file in the PortalServer-DataDir/portals/portal-ID/config/ directory.

The file contains the following variables:

manager.contributors

Specifies the active membership and configuration contributor types in the system. By default, this list includes:

am-global

Access Manager service schema

am-org

Access Manager organizations

am-role

Access Manager roles

am-frole

Access Manager filtered roles

jdo

Java DB, through Java Data Objects (JDO) layer

Each of these contributor types provides membership and configuration data from a different source.

communitymgmnt.properties File

This file contains configuration for the community management SDK component. The configuration variables defined in the communitymc.properties file, in most cases, need not be modified. To modify the file, log into any system that has portal server installed as superuser and access the file in the PortalServer-DataDir/portals/portal-ID/config/ directory.

The file contains the following (modifiable) variables:

ps-search-url

Specifies the URL of the search server to use when creating communities.

ps-dp-priority-base

Specifies the base value used to set display profile priorities for created communities.

ps-community-notification-notifier-classes

Specifies the implementation classes to use to send notification. The following implementation is available: com.sun.portal.community.notification.impl.JavaMailNotifierImpl.

ps-community-notification-types

Specifies types of events for which notification is to be triggered. The following event is available: user_invited. Leave the value empty if you do not wish to use the notification feature.

mail.transport.protocol

Specifies the mail protocol (smtp) to use. See JavaMail^TM specification for more information.

mail.imap.host

Specifies the hostname of the mail server. See JavaMail specification for more information.

mail.debug

Specifies the debug mode for JavaMail. See JavaMail specification for more information.

ps-community-notification-javamail-default-sender-addr

Specifies the default sender address if there is none available for the user sending the notification.

ps-community-notification-javamail-authenticator-class

Provides simple authentication implementation to be used with JavaMail. The following implementation is available: com.sun.portal.community.notification.impl.SimpleAuthenticator. See JavaMail specification for more information.

ps-community-notification-javamail-simpleauthenticator-user

Specifies the user name to be used with the SimpleAuthenticator implementation.

ps-community-notification-javamail-simpleauthenticator-password

Specifies the password to be used with the SimpleAuthenticator implementation.

Community Webservice URL

Community search and administration functionality involves a community webservice. By default, the community webservice URL contains the same host as the first Portal instance. In a multi-node installation that uses a load balancer, you can change the community webservice URL to use the load balancer host.

To get and set the community webservice URL, type:

./psadmin get-attribute -u amadmin -p portal-ID -m communities -a WebServicesURL

./psadmin set-attribute -u amadmin -p portal-ID -m communities -a WebServicesURL URL

Here:

amadmin

Specifies the administrator's distinguished name.

portal-ID

Specifies the portal ID.

WebServicesURL

Specifies the value for the WebServicesURL attribute. For example, the URL can be of the format http://foo.com:8080/communitymanagerwebservices/communitymanagerwebservices. Please note that the communitymanagerwebservices/communitymanagerwebservices part of the URL must not be changed.

There is no default value for the WebServicesURL attribute. By default, an empty value indicates that the host of the first Portal instance will be used.