Configuration properties reference
Overview
This topic describes the properties that are used with the configuration tasks during WebSphere Portal installation. Note that the specific properties required for installation can vary, depending on how you are deploying Portal and its related components. Refer to the installation instructions for each component for information on which properties set.
All of these properties are located in the wpconfig.properties file, located in...
/qibm/userdata/webas5/base/instance/portalserver5/config
When modifying values in this file, use a text editor and only change those values that are required for the configuration tasks you are running.
How to edit and use properties and values
During installation and configuration, WebSphere Portal requires that you edit a properties file with component values that are unique to the environment. The following precautions should be taken when working with this file:
- For security reasons, not leave passwords in the wpconfig.properties file. It is recommended that you edit the wpconfig.properties prior to running a configuration task, inserting the passwords needed for that task. Then, after the task has run, delete all passwords from the wpconfig.properties file.
Alternatively, you can specify the password on the command line rather than update the wpconfig.properties file.
For example:
- WPSconfig.sh -DPortalAdminPwd=password validate-wps-admin-login
If you select the Install and Configure option when installing WebSphere Portal, or use the IBM Web Administration for iSeries tool, the passwords in the wpconfig.properties file are automatically removed after configuration.
- Create a backup copy before you begin working in a properties file. This copy can be used to restore default values if necessary. Each time you modify a properties file make a backup copy. You can back up the file manually or by using the configuration task:
WPSconfig.sh backup-main-cfg-file
- Values identified for properties should not have trailing spaces.
- Do not enclose values in quotes.
- You can modify the wpconfig.properties file locally on the iSeries system by entering the following on an OS/400 command line:
EDTF '/qibm/userdata/webas5/base/instance/portalserver5/config/wpconfig.properties'
- Preserve the case of values, such as class names and directory paths.
- Change only the values indicated in the component configuration steps. Do not change any other values.
- Some values require multiple entries. Separate each entry with a semi-colon. Do not add spaces between the values.
- Once a property is set during configuration, its value cannot be overridden. The precedence order for setting properties is as follows, from highest precedence to lowest precedence:
- Properties set on the command line when the configuration task is launched
- Properties set in a parent properties file
- Properties set in the wpconfig.properties file
- Properties set in the XML configuration files themselves
- You can add comments to the properties files as needed using the pound or hash symbol (#). This allows you to keep track of changes you have made and why.
Properties
Properties are listed as they appear in the properties files.
- WAS properties
- Java properties
- Portal configuration properties
- Dependency Checking Properties
- Database properties
- Document Manager Database properties
- Document Manager Additional properties
- Member Manager properties
- Lotus Collaborative Components properties
- WebSphere Portal Security LTPA and SSO Configuration
- General Global Security Settings
- Credentials for WAS administration secure SOAP connection
- Custom User Registry Configuration
- LDAP Properties Configuration
- Advanced LDAP Configuration
- WebSphere Translation Server Properties
- Configuration task properties
The following tables provide a description, value, and default for each of the associated properties:
WAS properties Property Value VirtualHostName Name of the WAS virtual host. Value type: Alphanumeric text string
Example: my_virtual_host
Default Value:
default_hostWasAdminServer Name of the WAS administration server. Value type: Alphanumeric text string
Default Value:
instanceThis value is defaulted to the WAS instance name. If the WAS instance was created with a different WAS administration server name, change this value to reflect that.
WasHome The directory where WAS is installed. Value type: Directory path with elements delimited by forward slashes (/).
Default Value:
/QIBM/ProdData/WebAS5/PMEWasUserHome The directory where WAS user database is created. Value type:Directory path with elements delimited by forward slashes (/).
Default Value:
/QIBM/UserData/WebAS5/Base/instanceWasUserid The user ID for WAS security authentication. For LDAP configuration this value should not contain spaces.
Value type:Alphanumeric text string
Examples: When using LDAP security:
IBM Directory Server: uid=wpsbind,cn=users,dc=yourco,dc=com Domino: cn=wpsbind,o=yourco.com Active Directory: cn=wpsbind,cn=users,dc=yourco,dc=com SunOne: uid=wpsbind,ou=people,o=yourco.com Novell eDirectory: uid=wpsbind,ou=people,o=yourco.com
Default Value:
ReplaceWithYourWASUserIDWasPassword The password for WAS security authentication. Value type: Alphanumeric text string
Default Value:
ReplaceWithYourWASUserPwdWPSInstallLocation The directory where WebSphere Portal is installed. Value type: Directory path with elements delimited by forward slashes (/).
Default Value:
/QIBM/UserData/WebAS5/Base/instance/PortalServer5CellName The WAS cell to which the WAS belongs. Value type: Alphanumeric text string
Default Value:
YourSystem_instanceNodeName The node within the WAS cell to which the WebSphere Portal application server belongs. This value must be unique among other node names in the same cell. Typically this value is the same as the host name for the computer.
Value type: Alphanumeric text string
Default Value:
YourSystem_instanceServerName Name of the application server where the WebSphere Portal enterprise application is deployed. This value must be unique among other application server names in the same cell.
Value type: Alphanumeric text string
Default Value:
instanceWpsHostName The fully-qualified host name of the Web server that WAS is configured to use. This value is set by the installation program based on user input during installation. http://WpsHost:WpsPort/WpsContextRoot/WpsDefaultHome For example: http://HostName.yourco.com:80/wps/portal Value type: Host name, including domain.
Example: HostName.yourco.com
Default Value:
localhostWpsHostPort The port number used to access the host machine identified by the WpsHostName property.
Value type: Port number.
Default Value:
80WpsAdminConsolePort The port used by WAS Administrative Console deployed on WebSphere Portal. This property might not be used to reconfigure the WpsAdminConsolePort.
For example: http://WpsHost:<WpsAdminConsolePort>/admin http://localhost:9081/admin
Value type: Port number.
Default Value:
NoneWpsAppName Name of the WebSphere Portal enterprise application, as deployed into WAS. Value type: Alphanumeric text string
Default Value:
wpsWpsContextRoot The context root or base URI for the portal. All URLs beginning with this path will be reserved for the portal. The value of this property is part of the URL used to access WebSphere Portal from a browser:
http://WpsHost:WpsPort/WpsContextRoot/WpsDefaultHome
Value type: Alphanumeric text string
Example: http://HostName.yourco.com:80/wps/portal
Default Value:
wpsWpsDefaultHome Default portal page for unauthenticated users.
http://WpsHost:WpsPort/WpsContextRoot/WpsDefaultHome
Value type: Alphanumeric text string
For example...
http://HostName.yourco.com:80/wps/portalDefault Value:
portalWpsPersonalizedHome The portal page for users who have already logged in to the portal. This page cannot be accessed by anonymous users. The value of this property is part of the URL used to access WebSphere Portal from a browser:
http://WpsHost:WpsPort/WpsContextRoot/WpsPersonalizedHome
Value type: Alphanumeric text string
For example...
http://HostName.yourco.com:80/wps/myportalDefault Value:
MyPortalContentAccessServiceProxyHost The fully-qualified HostName of the proxy server that WebSphere Portal should use, if the security configuration includes a proxy server.
Value type: Host name, including domain.
For example...
proxyHostName.yourco.com.Default Value:
NoneContentAccessServiceProxyPort The port number used to access the proxy server identified by the ContentAccessServiceProxyHost property.
Value type: Port number.
Default Value:
None
Portal configuration properties Property Value PortalAdminId The user ID for the WebSphere Portal administrator.
For LDAP configuration this value should not contain spaces.
Value type: Alphanumeric text string, conforming to the LDAP distinguished name format.
Examples for LDAP:
IBM Directory Server: uid=PortalAdminId,cn=users,dc=yourco,dc=com Domino: cn=PortalAdminId,o=yourco.com Active Directory: cn=PortalAdminId,cn=users,dc=yourco,dc=com SunOne: uid=PortalAdminId,ou=people,o=yourco.com Novell eDirectory: uid=PortalAdminId,ou=people,o=yourco.com
Example for Custom User Registry (CUR): uid=PortalAdminId
Default value: uid=PortalAdminId,o=default organization
PortalAdminIdShort The short form of the user ID for the WebSphere Portal administrator, as defined in the PortalAdminId property.
Value type: Alphanumeric text string
For example...
PortalAdminIdDefault Value: PortalAdminId
PortalAdminPwd The password for the WebSphere Portal administrator, as defined in the PortalAdminId property.
Value type: Alphanumeric text string
For example...
yourportaladminpwdDefault Value: None
PortalAdminGroupId The group ID for the group to which the WebSphere Portal administrator belongs.
Value type: Alphanumeric text string, conforming to the LDAP distinguished name format.
Examples for LDAP:
- IBM Directory Server: cn=wpsadmins,cn=groups,dc=yourco,dc=com
- Domino: cn=wpsadmins
- Active Directory: cn=wpsadmins,cn=groups,dc=yourco,dc=com
- SunOne: cn=wpsadmins,ou=groups,o=yourco.com
- Novell eDirectory: cn=wpsadmins,ou=groups,o=yourco.com
Example for Custom User Registry (CUR): cn=wpsadmins,o=default organization
Default Value: cn=wpsadmins,o=default organization
PortalAdminGroupIdShort The short form of the group ID for the WebSphere Portal administrator, as defined in the PortalAdminGroupId property.
Value type: Alphanumeric text string
For example...
wpsadminsDefault Value: wpsadmins
PortalUniqueID An identifier that is unique to this Portal instance. Usually a MAC address from a communications adapter on this node.
Value type: 12 hex digits
Default Value: Unique 12-character ID
Database properties Property Value DbSafeMode This only applies to database specific tasks. If this property is set to true none database specific updates will be performed, such as create/modify/drop database. The property should be used if a pre-configured database (from a previous installation) already exists. If the property is set to false the database will be updated, and the pre-existing database configuration is overwritten.
Value type: true, false
Default Value: false
DbType The type of database used to store information for WebSphere Portal. Value type:
- DB2: db2
- Oracle: oracle
- Informix: informix
- MS SQL Server: sqlserver
- Cloudscape: cloudscape
- DB2 for iSeries: db2_iseries
- DB2 for z/OS and OS/390: db2_zos
Default Value: db2_iseries
WpsDbName Database name where you want the WebSphere Portal objects created. Notes:
- This value is also the database element in the DbUrl property.
- If you are configuring a remote DB2 for z/OS and OS/390 database, this property refers to the database subsystem. Name of the physical database is set with the WpsDbNameOnZos property.
Value type: Alphanumeric text string.
Default Value: *LOCAL/QWPS50
WpsDbSchema Name of the WebSphere Portal database schema. For iSeries only.
Value type: Alphanumeric text string
Default Value: QWPS50
WpsDbNameOnZos Name of the remote WebSphere Portal database for DB2 for z/OS and OS/390 only. If you are running DB2 for z/OS and OS/390 as a remote database, set this property to the name of the remote WebSphere Portal database.
Value type: Alphanumeric text string
Default Value: WPSTST02
cswps.jdbc.schema.names The schema list for cswps.jdbc.schema.names must include the user defined schema for WebSphere Portal . The values for these schema are derived from the properties DbUser and WpcpDbUser respectively.
These values should be considered read-only and should never be changed before, during, or after database transfer.
Value type: db2admin, wcmdbadm
Default Value: db2admin, FEEDBACK, PZNADMIN, EJB, wcmdbadm
DbDriver The Java class name for the JDBC provider that WebSphere Portal uses to communicate with its databases.
Value type: Alphanumeric text string, conforming to the Java namespace syntax for specifying classes. For example, COM.ibm.db2.jdbc.app.DB2Driver. The following values can be specified:
- DB2: COM.ibm.db2.jdbc.app.DB2Driver
- DB2 for iSeries: com.ibm.db2.jdbc.app.DB2Driver
- DB2 for iSeries (remote): com.ibm.as400.access.AS400JDBCDriver
- Oracle: oracle.jdbc.driver.OracleDriver
- Informix: com.informix.jdbc.IfxDriver
- SQL Server: com.microsoft.jdbc.sqlserver.SQLServerDriver
Default Value:com.ibm.db2.jdbc.app.DB2Driver (DB2 for iSeries)
DbDriverDs The data source for the JDBC provider that WebSphere Portal uses to communicate with its databases.
Value type: Alphanumeric text string, conforming to the Java namespace syntax for specifying classes. For example, COM.ibm.db2.jdbc.DB2ConnectionPoolDataSource. The following values can be specified:
- DB2: COM.ibm.db2.jdbc.DB2ConnectionPoolDataSource
- DB2 for iSeries: com.ibm.db2.jdbc.app.UDBConnectionPoolDataSource
- DB2 for iSeries (remote): com.ibm.as400.access.AS400JDBCDriver
- Oracle: oracle.jdbc.pool.OracleConnectionPoolDataSource
- Informix: Not applicable
- SQL Server: com.microsoft.jdbcx.sqlserver.SQLServerDataSource
Default Value: com.ibm.db2.jdbc.app.UDBConnectionPoolDataSource (DB2 for iSeries)
JdbcProvider Name of the JDBC provider that WebSphere Portal uses to communicate with its databases.
Value type: Alphanumeric text string
Default Value: wps50JDBC
DbUrl The database URL used to access the WebSphere Portal database with JDBC, where HostName is the name of the remote server and port is the port where the appropriate database instance is listening. The value must conform to standard JDBC URL syntax. Note: The database element of this value should match the value of WpsDbName.
Value type: Alphanumeric text string, conforming to standard JDBC URL syntax.
Example: jdbc:db2:WPS50. The following values can be specified, where HostName indicates the server where the database is running:
DB2: jdbc:db2:WPS50 DB2 for iSeries: jdbc:db2:*LOCAL/QWPS50 DB2 for iSeries (remote): jdbc:access:hostName/QWPS50 Oracle: jdbc:oracle:thin:@HostName:1521:wps50 Informix: informix-sqli://HostName:1526/wps50:informixserver=HostName SQL Server: jdbc:microsoft:sqlserver://HostName:1433;DbName=wps50
Default Value: jdbc:db2:*LOCAL/QWPS50 (DB2 for iSeries)
DbUser The user ID for the database administrator.
Value type: Alphanumeric text string
Default Value: db2admin
DbPassword The password for the database administrator.
Value type: Alphanumeric text string
Default Value: ReplaceWithYourDbAdminPwd
DbLibrary The directory path where the classes for the JDBC provider are located.
Value type: Directory path with elements delimited by forward slashes (/).
In UNIX environments, use a colon (:) instead of a semi-colon (;) to separate multiple paths.
Example:
DB2: SQLLIB/java12/db2java.zip DB2_iSeries: /QIBM/ProdData/Java400/ext/db2_classes.jar DB2 iSeries (remote): /QIBM/ProdData/PortalServer5/IBMTrans/lib/jt400.jar Oracle: Oracle_Home/jdbc/lib/classes12.zip Informix: Informix_Home/lib/ifxjdbc.jar;SQLServerHome/lib/ifxjdbcx.jar SQL Server: SQLServerHome/lib/mssqlserver.jar; SQLServerHome/lib/msbase.jar; SQLServerHome/lib/msutil.jar
Default Value:
/QIBM/ProdData/Java400/ext/db2_classes.jarFor remote DB2 configuration, this value should be...
/QIBM/ProdData/PortalServer5/IBMTrans/lib/jt400.jarWpsDsName Name of the data source that WebSphere Portal uses to communicate with its databases.
If the WebSphere Portal data source name is changed due to database migration, which is reflected in wp_root/config/wpconfig.properties, update the resource mappings by executing the following steps:
- Login to the WAS Administrative Console.
- Select Application -> Enterprise Applications.
- Select the WebSphere Portal application.
- Select the Map resource references to resources option.
- Change the JNDI Name for reference binding jdbc/wpsDS to specify the new data source name.
- Click OK.
- Save the configuration changes.
Value type: Alphanumeric text string
Default Value: wps50DS
WpsXDbName The TCP/IP alias for the database to be used as ds name. This value is used to specify the data source on machines that are not running Windows.
Value type: Alphanumeric text string
Default Value: wps5TCP
WpsDbNode This value is the node for the WebSphere Portal database Value type: Alphanumeric text string
Default Value: wpsNode
Document Manager Database properties Property Value WpcpDbNode The node for the content publishing database. Must be set for all non-Windows platforms when using DB2.
Value type: Alphanumeric text string
Default Value: wcmNode
WpcpXDbName The TCP/IP alias for the database. This value is used to specify the data source on machines that are not running Windows. Must be set for all non-Windows platforms when using DB2.
Value type: Alphanumeric text string
Default Value: *LOCAL/QWPCP50
FeedbackXDbName The TCP/IP alias for the Feedback database. This value is used to specify the data source on machines that are not running Windows. Must be set for all non-Windows platforms when using DB2.
Value type: Alphanumeric text string
Default Value: *LOCAL/QWPS50
LikemindsXDbName The TCP/IP alias for the Likeminds database. This value is used to specify the data source on machines that are not running Windows. Must be set for all non-Windows platforms when using DB2.
Value type: Alphanumeric text string
Default Value: *LOCAL/QWPS50
WpcpDbPort The port used to access the WebSphere Portal content publishing database. Note: Required for Informix only. Value type: Alphanumeric text string
Default Value: 1526
WpcpDbInstanceName Database instance name (for example, ol_myserver). Required for Informix only.
Value type: Alphanumeric text string
Default Value: ol_myserver
WpcpDbHostName The fully-qualified host name of the Web server that WAS is configured to use. Required for MS SQL Server and Informix only.
Value type: Alphanumeric text string
Default Value: myserver
WpcpDbName Name of the content publishing database. Notes:
- This value is also the database element in the WpcpDbUrl property.
- If you are configuring a remote DB2 for z/OS and OS/390 database, this property refers to the database subsystem. Name of the physical database is set with the WpsDbNameOnZos property.
Value type: Alphanumeric text string.
Default Value: *LOCAL/QWPS50
WpcpDbSchema The WPCP database schema name. Required for iSeries only.
Value type: Alphanumeric text string
Default Value: QWPS50
WpcpDbNameOnZos Name of the remote WPCP database for DB2 for z/OS and OS/390 only. Required for DB2 for z/OS and OS/390 only. If you are running DB2 for z/OS and OS/390 as a remote database, set this property to the name of the remote WebSphere Portal database.
Value type: Alphanumeric text string
Default Value: wpcp5zos
WpcpDbTablespace Name of the content publishing database tablespace.
Required for DB2 for z/OS and OS/390 only.
Value type: Alphanumeric text string
Default Value: wpcp50ts
WpcpDbUser The user ID for the database administrator. Value type: Alphanumeric text string
Default Value: wcmdbadm
WpcpDbPassword The password associated with the user profile specified in the WpcpDbUser property. Value type: Alphanumeric text string
Default Value: ReplaceWithYourDbAdminPwd
WpcpDbUrl The database URL used to access the content publishing database with JDBC, where <HostName> is the name of the remote server and <port> is the port where the appropriate Oracle instance is listening. The value must conform to standard JDBC URL syntax.
Note: The database element of this value should match the value of WpcpDbName.
Value type: Alphanumeric text string, conforming to standard JDBC URL syntax. For example, jdbc:db2:wcm. The following values can be specified, where <HostName> indicates the server where the database is running, <portnumber> indicates the port on which the database is communicating, and dbname indicates the name of the database as specified in the WpcpDbName property.
- DB2: jdbc:db2:dbname
- DB2 for iSeries: jdbc:db2:*LOCAL/QWPCP50
- DB2 for iSeries (remote): jdbc:access:hostName/QWPCP50
- Oracle: jdbc:oracle:thin:@<HostName>:<portnumber>:dbname
- Informix: informix-sqli://<HostName>:<portnumber>/dbname:informixserver=<HostName>
- MS SQL Server: jdbc:microsoft:sqlserver://<HostName>:<portnumber>;DbName=dbname
Default Value: jdbc:db2:*LOCAL/QWPS50 (DB2 for iSeries)
PznDbName Name of the WPCP database. This value should also appear as the database element in PznDbUrl.
Value type: Alphanumeric text string
Default Value: *LOCAL/QWPS50
PznSchema The WPCP database schema name. Used for iSeries only.
Value type: Alphanumeric text string
Default Value: QWPS50
PznDbUrl The Pzn database URL. This value should also appear as the database element in PznDbName.
Value type: Alphanumeric text string
Default Value: jdbc:db2:*LOCAL/QWPS50
BrbDbName Name of the WPCP database. This value should also appear as the database element in BrbDbUrl.
Value type: Alphanumeric text string
Default Value: *LOCAL/QWPS50
BrbSchema Business Rules Beans (BrBeans) database schema name. Used for iSeries only.
Value type: Alphanumeric text string
Default Value: QWPS50
BrbDbUrl Business Rules Beans (BrBeans) database URL. This value should also appear as the database element in BrbDbName.
Value type: Alphanumeric text string
Default Value: jdbc:db2:*LOCAL/QWPS50
WpcpDbEjbPassword The password for Enterprise Java Bean (EJB) user.
Required for MS SQL Server and Oracle only.
Value type: Alphanumeric text string
Default Value: ejb
WpcpDbPznadminPassword The password for PZNADMIN user.
Required for MS SQL Server and Oracle only.
Value type: Alphanumeric text string
Default Value: pznadmin
FeedbackDbPort The port used to access the content publishing Feedback database. Required for Informix only.
Value type: Alphanumeric text string
Default Value: 1526
FeedbackDbInstanceName The feedback database instance name (for example, ol_myserver). Required for Informix only.
Value type: Alphanumeric text string
Default Value: ol_myserver
FeedbackDbHostName The fully-qualified host name of the Web server that WAS is configured to use. This value is set by the installation program based on user input during installation or on values in a response file. Note: Required for MS SQL Server and Informix only. Value type: Alphanumeric text string
Default Value: myserver
FeedbackDbName Name of the Feedback database. Notes:
- This value is also the database element in the FeedbackDbUrl property.
- If you are configuring a remote DB2 for z/OS and OS/390 database, this property refers to the database subsystem. Name of the physical database is set with the WpsDbNameOnZos property.
Value type: Alphanumeric text string.
Default Value: *LOCAL/QWPS50
FeedbackSchema The feedback database schema name.
Used for iSeries only.
Value type: Alphanumeric text string.
Default Value: QWPS50
FeedbackDbNameOnZos Name of the remote WPCP Feedback database for DB2 for z/OS and OS/390 only. If you are running DB2 for z/OS and OS/390 as a remote database, set this property to the name of the remote WebSphere Portal database.
Value type: Alphanumeric text string
Default Value: fdbk5zos
FeedbackDbTablespace Name of the Feedback database tablespace. Required for DB2 and z/OS only.
Value type: Alphanumeric text string
Default Value: fdbk50ts
FeedbackDbUser The database user for feedback database. This property is required for DB2, DB2 for z/OS and OS/390, and Informix only. For SQL Server and Oracle only, this value must be set to FEEDBACK.
Value type: Alphanumeric text string
Default Value: wcmdbadm
FeedbackDbPassword The database password for feedback database. Value type: Alphanumeric text string
Default Value: ReplaceWithYourDbAdminPwd
FeedbackDbUrl The database URL used to access the feedback database with JDBC, where <HostName> is the name of the remote server and <port> is the port where the appropriate database instance is listening. The value must conform to the standard JDBC URL syntax. Note: The database element of this value should match the value of FeedbackDbName. Value type: Alphanumeric text string, conforming to standard JDBC URL syntax.
Example: jdbc:db2:wcm. The following values can be specified, where <HostName> indicates the server where the database is running, <portnumber> indicates the port on which the database is communicating, and dbname indicates the name of the database as specified in the FeedbackDbName property.
- DB2: jdbc:db2:dbname
- DB2 for iSeries: jdbc:db2:*LOCAL/QFDBK50
- DB2 for iSeries (remote): jdbc:access:/QWPS50
- Oracle: jdbc:oracle:thin:@<HostName>:<portnumber>:dbname
- Informix: informix-sqli://<HostName>:<portnumber>/dbname:informixserver=<HostName>
- MS SQL Server: jdbc:microsoft:sqlserver://<HostName>:<portnumber>;DbName=dbname
Default Value: jdbc:db2:*LOCAL/QWPS50 (DB2 for iSeries)
LikemindsDbPort The port used to access the content publishing Likeminds database.
Required for Informix only.
Value type: Alphanumeric text string
Default Value: 1526
LikemindsDbInstanceName The Likeminds database instance name (for example, ol_myserver). Required for Informix only.
Value type: Alphanumeric text string
Default Value: ol_myserver
LikemindsDbHostName The fully-qualified host name of the Web server that WAS is configured to use. This value is set by the installation program based on user input during installation or on values in a response file. Required for MS SQL Server and Informix only. Value type: Alphanumeric text string
Default Value: myserver
LikemindsDbName Name of the Likeminds database. Notes:
- This value is also the database element in the LikemindsDbUrl property.
- If you are configuring a remote DB2 for z/OS and OS/390 database, this property refers to the database subsystem. Name of the physical database is set with the LikemindsDbUrl property.
- If WebSphere Portal Version 5.0.2 and a previous version of WebSphere Portal coexist on the same box, this value must be different than the WebSphere Member Services database name in the previous version of WebSphere Portal.
Value type: Alphanumeric text string.
Default Value: *LOCAL/QWPS50
LikemindsDbNameOnZos Name of the remote WPCP Likeminds database for DB2 for z/OS and OS/390 only. If you are running DB2 for z/OS and OS/390 as a remote database, set this property to the name of the remote WebSphere Portal database.
Value type: Alphanumeric text string
Default Value: lmdb5zos
LikemindsDbTablespace Name of the Likeminds database tablespace. Required for DB2 and z/OS only.
Value type: Alphanumeric text string
Default Value: lmdb50ts
LikemindsDbUser The database user for Likeminds database. This property is required for DB2, DB2 for z/OS and OS/390, and Informix only.
Value type: Alphanumeric text string
Default Value: wcmdbadm
LikemindsDbPassword The database password for Likeminds database. Value type: Alphanumeric text string
Default Value: ReplaceWithYourDbAdminPwd
LikemindsDbUrl The database URL used to access the Likeminds database with JDBC, where <HostName> is the name of the remote server and <port> is the port where the appropriate database instance is listening. The value must conform to the standard JDBC URL syntax. Note: The database element of(&(|(cn=%v)(samAccountName=%v))(objectclass=user)) this value should match the value of LikemindsDbName. Value type: Alphanumeric text string, conforming to standard JDBC URL syntax.
Example: jdbc:db2:wcm. The following values can be specified, where <HostName> indicates the server where the database is running, <portnumber> indicates the port on which the database is communicating, and dbname indicates the name of the database as specified in the FeedbackDbName property.
- Cloudscape: jdbc:db2j:<lmdb50>;create=true
- DB2: jdbc:db2:<lmdb50>
- Oracle: jdbc:oracle:thin:@<HostName>:<portnumber>:<lmdb50>
- Informix: informix-sqli://<HostName>:<portnumber>/<lmdb50>:informixserver=<HostName>
- MS SQL Server: jdbc:microsoft:sqlserver://<HostName>:<portnumber>;DbName=<lmdb50>
Default Value: jdbc:db2:*LOCAL/QWPS50
Member Manager properties Property Value WmmDsName Name of the data source that WebSphere Portal uses to communicate with the Member Manager database.
Value type: Alphanumeric text string
Default Value: wmmDS
WmmAppName Name of the Member Manager enterprise application, as deployed into WAS. Value type: Alphanumeric text string
Default Value: wmmApp
WmmDbName Name of the Member Manager database.
Notes:
- If you are configuring a remote DB2 for z/OS and OS/390 database, this property refers to the database subsystem. Name of the physical database is set with the WmmDbNameOnZos property.
- WebSphere Portal Version 5.0.2 and a previous version of WebSphere Portal coexist on the same box, this value must be different than the WebSphere Member Services database name in the previous version of WebSphere Portal.
Value type: Alphanumeric text string.
Default Value: *LOCAL/QWPS50
WmmDbSchema Name of the Member Manager database schema. This is used for iSeries only.
Value type: Alphanumeric text string
Default Value: QWPS50
WmmDbNameOnZos Name of the remote Member Manager database for DB2 for z/OS and OS/390 only.
If you are running DB2 for z/OS and OS/390 as a remote database, set this property to the name of the remote WebSphere Portal database.
Value type: Alphanumeric text string
Default Value: WPSTST01
WmmDbUser The user ID for the database administrator.
Value type: Alphanumeric text string
Default Value: db2admin
If you are migrating from a previous version of WebSphere Portal, this value must match the database user name for the WebSphere Member Services database from the previous WebSphere Portal version.
WmmDbPassword The password for the database administrator.
Value type: Alphanumeric text string
Default Value: ReplaceWithYourDbAdminPwd
WmmDbUrl The database URL used to access the Member Manager database with JDBC. The value must conform to standard JDBC URL syntax. Note: The database element of this value should match the value of WmmDbName.
Value type: Alphanumeric text string, conforming to standard JDBC URL syntax.
Example: jdbc:db2:wmmdb. The following values can be specified, where HostName indicates the server where the database is running:
DB2: jdbc:db2:dbname DB2 for iSeries: jdbc:db2:*LOCAL/QWPS50 DB2 for iSeries (remote): jdbc:as400:HostName/QWPS50 Oracle: jdbc:oracle:thin:@HostName:1521:dbname Informix: informix-sqli://HostName:1526/dbname:informixserver=HostName SQL Server: jdbc:microsoft:sqlserver://HostName:1433;DbName=dbname
Default Value:jdbc:db2:*LOCAL/QWPS50 (DB2 for iSeries)
WmmEjbName The Enterprise Java Bean (like a classname) that other applications need to know it in order to communicate with it. Value type: Alphanumeric text string
Default Value: ejb/MemberServiceHome
Lotus Collaborative Components Properties Property Value LCC.QuickPlace.Enabled The property that determines whether Lotus QuickPlace is enabled. Value type: true, false
Default Value: false
LCC.QuickPlace.Server Name of the Lotus QuickPlace server. Value type: Alphanumeric text string; must be the HostName or IP address.
Default Value: my.server.com
LCC.QuickPlace.Protocol The protocol used to connect to the Lotus QuickPlace server. Value type: http, https
Default Value: http
LCC.QuickPlace.Port The port number for the Lotus QuickPlace server. Value type: Alphanumeric text string
Default Value: 80
LCC.Sametime.Enabled The property that determines whether Lotus Sametime is enabled. Value type: true, false
Default Value: false
LCC.Sametime.Server Name of the Lotus Sametime server. Value type: Alphanumeric text string; must be the HostName or IP address.
Default Value: my.server.com
LCC.Sametime.Protocol The protocol used to connect to the Lotus Sametime server. Value type: http, https
Default Value: http
LCC.Sametime.Port The port number for the Lotus Sametime server. Value type: Alphanumeric text string
Default Value: 80
LCC.DiscoveryServer.Enabled The property that determines whether Lotus DiscoveryServer is enabled. Value type: true, false
Default Value: false
LCC.DiscoveryServer.Server Name of the Lotus DiscoveryServer server. Value type: Alphanumeric text string; must be the HostName or IP address.
Default Value: my.server.com
LCC.DiscoveryServer.Protocol The protocol used to connect to the Lotus DiscoveryServer server. Value type: http, https
Default Value: http
LCC.DiscoveryServer.Port The port number for the Lotus DiscoveryServer server. Value type: Alphanumeric text string
Default Value: 80
LCC.DominoDirectory.Enabled The property that determines whether Lotus DominoDirectory is enabled. Value type: true, false
Default Value: false
LCC.DominoDirectory.Server Name of the Lotus DominoDirectory server. Value type: Alphanumeric text string; must be the HostName or IP address.
Default Value: my.server.com
LCC.DominoDirectory.Port The port number for the Lotus DominoDirectory server. Value type: Alphanumeric text string
Default Value: 389
LCC.DominoDirectory.SSL Use this property to enable or disable the SSL connection to the Domino Directory Value type: true, false
Default Value: false
WebSphere Portal Security LTPA and SSO configuration Property Value LTPAPassword The password for the LTPA bind. Value type: Alphanumeric text string
Default Value: None
LTPATimeout The property that sets the time out for the LTPA bind. Value type: Numeric text string
Default Value: 120
SSOEnabled The property that specifies that the Single Sign-On function is enabled. Value type: true, false
Default Value: true
SSORequiresSSL The property that specifies that Single Sign-On function is enabled only when requests are over HTTPS Secure Socket Layer (SSL) connections. Value type: true, false
Default Value: false
SSODomainName The property that specifies the domain name for all Single Sign-On hosts; for example, ibm.com. Value type: Alphanumeric text string
Default Value: None
General Global Security Settings Property Value useDomainQualifiedUserNames The qualified user names for the domain. Value type: true, false
Default Value: false
cacheTimeout The property that sets the cache time out. Value type: Alphanumeric text string, greater than 30
Default Value: 600
issuePermissionWarning The property that prompts for user credentials. Value type: true, false
Default Value: true
activeProtocol The property that sets the protocol for WAS. Value type: BOTH
Default Value: BOTH
activeAuthMechanism The property that sets the authentication mechanism for WAS. Value type: LTPA
Default Value: LTPA
Credentials for WAS administration secure SOAP connection Property Value TrustStore The location of the trust store. Value type: Path name
Default Value: /etc/DummyClientTrustFile.jks
TrustStorePwd The password to access the trust store. Value type: Alphanumeric text string
Default Value: WebAS
KeyStore The location of the key store Value type: Path name
Default Value: /etc/DummyClientKeyFile.jks
KeyStorePwd The password to access the key store. Value type: Alphanumeric text string
Default Value: WebAS
LDAP Properties Configuration Property Value LookAside The purpose of a Lookaside database is to store attributes which cannot be stored in the LDAP server. You can either install with LDAP only or with LDAP using a Lookaside database. To enable a Lookaside database, set this property to true. If you intend to use a Lookaside database, set this value before configuring security, as it cannot be configured after security is enabled. Using a Lookaside database can slow down performance.
Value type: true, false
Default Value: false
LDAPHostName The host information for the LDAP server that WebSphere Portal will use. Value type: Fully qualified host name of the LDAP server
Default Value: yourldapserver.com
LDAPPort The server port of the LDAP directory. Value type: Alphanumeric text string
Default Value: 389; (636 for SSL)
LDAPAdminUId The user ID for the administrator of the LDAP directory. Value type: Alphanumeric text string, conforming to the LDAP distinguished name format. For example, cn=userid.
Default Value: cn=root
LDAPAdminPwd The password for the LDAP directory administrator, as defined in the LDAPAdminUId property. Value type: Alphanumeric text string
Default Value: <none>
LDAPServerType The type of LDAP Server to be used. Value type:
- IBM Directory Server: IBM_DIRECTORY_SERVER
- Domino 5: DOMINO502
- Active Directory: ACTIVE_DIRECTORY
- SunOne: IPLANET
- Novell eDirectory: NDS
Default Value: IBM_DIRECTORY_SERVER
LDAPBindID The user ID for LDAP Bind authentication. Value type:
IBM Directory Server: uid=wpsbind,cn=users,dc=yourco,dc=com Domino: cn=wpsbind,o=yourco.com Active Directory: cn=wpsbind,cn=users,dc=yourco,dc=com SunOne: uid=wpsbind,ou=people,o=yourco.com Novell eDirectory: uid=wpsbind,ou=people,o=yourco.com
Default Value: uid=wpsbind,cn=users,dc=yourco,dc=com
LDAPBindPassword The password for LDAP Bind authentication. Value type: Alphanumeric text string
Default Value:<none>
Advanced LDAP Configuration Property Value LDAPUserFilter This key is used to configure the user filter. Value type:
IBM Directory Server: (&(uid=%v)(objectclass=inetOrgPerson)) Domino: (&(|(cn=%v)(uid=%v))(objectclass=dominoPerson)) Domino 5.x without dominoUNID: (&(|(cn=%v)(uid=%v))(objectclass=inetOrgPerson)) Active Directory: (&(|(cn=%v)(samAccountName=%v))(objectclass=user)) SunOne: (&(uid=%v)(objectclass=inetOrgPerson)) Novell eDirectory: (&(uid=%v)(objectclass=inetOrgPerson))
Default Value: (&(uid=%v)(objectclass=inetOrgPerson))
LDAPGroupFilter This key is used to configure the user filter. Value type:
- IBM Directory Server: (&(cn=%v)(objectclass=groupOfUniqueNames))
- Domino: (&(cn=%v)(objectclass=dominoGroup))
- Domino 5 without dominoUNID: (&(cn=%v)(|(objectclass=groupOfNames)(objectclass=groupOfUniqueNames)(objectclass=dominoGroup)))
- Active Directory: (&(cn=%v)(objectclass=group))
- SunOne: (&(cn=%v)(objectclass=groupOfUniqueNames))
- Novell eDirectory: (&(cn=%v)(objectclass=groupOfUniqueNames))
Default Value: (&(cn=%v)(objectclass=groupOfUniqueNames))
LDAPSuffix The LDAP Suffix. Choose the value appropriate for the LDAP server. Value type:
- IBM Directory Server: dc=yourco,dc=com
- Domino: <this value is null>
- Active Directory: dc=yourco,dc=com
- SunOne: o=yourco.com
- Novell eDirectory: o=yourco.com
Default Value: dc=yourco,dc=com
LdapUserPrefix The DN prefix attribute name for user entries. Choose the value appropriate for the LDAP server. Value type:
- IBM Directory Server: uid
- Domino: cn
- Active Directory: cn
- SunOne: uid
- Novell eDirectory: uid
Default Value: uid
LDAPUserSuffix The DN suffix attribute name for user entries. Choose the value appropriate for the LDAP server. Value type:
- IBM Directory Server: cn=users
- Domino: o=yourco.com
- Active Directory: cn=users
- SunOne: ou=people
- Novell eDirectory: ou=people
Default Value: cn=users
LdapGroupPrefix The DN prefix attribute name for group entries. Value type: cn
Default Value: cn
LDAPGroupSuffix The DN suffix attribute name for group entries. Choose the value appropriate for the LDAP server. Value type:
- IBM Directory Server: cn=groups
- Domino: <this value is null>
- Active Directory: cn=groups
- SunOne: ou=groups
- Novell eDirectory: ou=groups
Default Value: cn=groups
LDAPUserObjectClass The User object class corresponding to the directory. Choose the value appropriate for the LDAP server. Value type:
- IBM Directory Server: inetOrgPerson
- Domino: dominoPerson
- Domino 5 without dominoUNID: inetOrgPerson
- Active Directory: user
- SunOne: inetOrgPerson
- Novell eDirectory: inetOrgPerson
Default Value: inetOrgPerson
LDAPGroupObjectClass The Group object class corresponding to the directory. Choose the value appropriate for the LDAP server. Value type:
- IBM Directory Server: groupOfUniqueNames
- Domino: dominoGroup
- Domino 5 without dominoUNID: groupOfNames
- Active Directory: group
- SunOne: groupOfUniqueNames
- Novell eDirectory: groupOfNames
- Shared UserRegistry with WebSeal/TAM: accessGroup
Default Value: groupOfUniqueNames
LDAPGroupMember The property that specifies the attribute name of the membership attribute of the group attribute name. Choose the value appropriate for the LDAP server. Value type:
- IBM Directory Server: uniqueMember
- Domino: member
- Active Directory: member
- SunOne: uniqueMember
- Novell eDirectory: uniqueMember
- Shared UserRegistry with WebSeal/TAM: member
Default Value: uniqueMember
LDAPGroupMinimumAttributes These attributes are loaded for group search related to performance issues. This is an advanced configuration property, and this value is typically not required to change. Value type: Empty
Default Value: None
LDAPUserBaseAttributes These attributes are loaded for user login related to performance issues. This is an advanced configuration property, and this value is typically not required to change. Value type: Depends on the specific application.
Default Value: givenName,sn,preferredLanguage
LDAPUserMinimumAttributes These attributes specify the minimum user attributes and are loaded for user search related to performance issues. Value type: Depends on the specific application.
Default Value: <none>
LDAPsearchTimeout The property that specifies the timeout value in seconds for an LDAP server to respond before aborting a request. Value type: Numeric text string
Default Value: 120
LDAPreuseConnection The property that specifies whether the LDAP connection can be reused. Should set to checked by default to reuse the LDAP connection. Value type: true, false
Default Value: true
LDAPIgnoreCase The property that specifies whether the LDAP search is case-sensitive or ignores case. Value type: true, false
Default Value: true
LDAPsslEnabled The property that specifies whether Secure Sockets communications is enabled for the LDAP server. Value type: true, false
Default Value: false
Configuration Task Properties Property Value parentProperties This property specifies the location of a parent properties file to be used when running the configuration program (WPSconfig script). When using a parent properties file, a property value from that file supersedes a value for the same property in the main properties file (wpconfig.properties).
Value type: Path name
Default Value: None
SaveParentProperties When specified in conjunction with the parentProperties property, this property indicates that upon successful execution of the configuration task, the property values specified in the parent properties file will be copied to the main properties file (wpconfig.properties) to reflect the current state of the configuration information.
Value type: True, False
Default Value: True
-->
LDAPUserFilter Specifies the LDAP object class for users in the directory. Value type: This value must match the object class of the users in the directory.
Default Value:objectclass=inetOrgPerson
LDAPGroupFilter Specifies LDAP object class for groups in the directory. Value type: This value must match the object class of the groups in the directory.
Default Value:objectclass=groupOfUniqueNames
LDAPUserIdMap Specifies the Distinguished Name (DN) or Relative Distinguished Name (RDN) prefix attribute for user entries. Value type:
- IBM Directory Server, Sun ONE, Active Directory: uid
- Domino: CN
Default Value:uid
LDAPGroupIdMap Specifies prefix attribute for group entries. Value type: This value must match the object class of the groups in the directory.
Default Value:cn
LDAPGroupMemberIdMap Specifies prefix attribute for group entries. Value type: Text string.
Default Value:groupOfNames:member;groupOfUniqueNames:uniqueMember
LDAPCertificateFilter Specifies whether to use the filter Certificate Mapping property to specify the LDAP filter, which is used to map attributes in the client certificate to entries in the LDAP registry. Value type: Depends on the specific application.
Default Value:EXACT_DN
LDAPCertificateMapMode Specifies whether to map X.509 certificates into an LDAP directory by EXACT_DN or CERTIFICATE_FILTER. Value type: Empty
Default Value:Empty
LdapUserPrefix DN prefix attribute name for user entries. Value type:
- IBM Directory Server: uid
- Domino: cn
- Active Directory: cn
- SunOne: uid
- Novell eDirectory: uid
Default Value: uid
LdapGroupPrefix DN prefix attribute name for group entries. Value type: cn
Default Value: cn
LDAPUserContainer Specifies the DN suffix for user entries. This is the DN of the portal administrator. Value type: This value must match the last part of the User DN suffix.
- IBM Directory Server, Active Directory: cn=users
- Domino: o=yourco.com
Default Value: cn=users
LDAPGroupContainer Specifies the DN suffix for group entries. Value type: This value must match the last part of the Group DN suffix.
- IBM Directory Server, Active Directory: cn=groups
Default Value: cn=groups
LDAPUserAttribute An advanced configuration property. This is an advanced configuration property, and this value is typically not required to change. Value type: userPassword
Default Value: userPassword
LDAPGroupType Specifies the attribute name of the membership attribute of the group objectclass. Value type: For groupOfUniqueNames, the membership attribute is typically uniqueMember. For groupOfNames, the membership attribute is typically member.
Default Value:uniqueMember
See also