IBM BS029ML - WebSphere Portal Server Self Help Manual page 129

WebSphere Member Manager (WMM) configuration files
The main configuration files for the WebSphere Member Manager (WMM) are inside the
directory <portal_root>/wmm, which is outside of the scope of the WebSphere Application
Server. In a clustered environment, in order for the Deployment Manager (Dmgr) to be able to
synchronize the files with the nodes in the cell, these WMM files are copied into
<wsas_profile_root>/config/cells/wmm. Thus, when making changes to the WMM
configuration files in a clustered environment, you should not simply modify the files on the
node or Dmgr directly; instead, the recommended and supported process is shown below:
1. From the primary node, change the directory to <portal_root>/config, and run the following
configuration task to check out the WMM files from Dmgr:
– UNIX/Linux:./WPSconfig.sh check-out-wmm-cfg-files-from-dmgr
– Windows: WPSconfig.bat check-out-wmm-cfg-files-from-dmgr
2. Change the directory to <portal_root>/wmm on the primary node, and modify the WMM
files in the directory.
3. Change the directory to <portal_root>/config, and run the following command:
– UNIX/Linux:./WPSconfig.sh check-in-wmm-cfg-files-to-dmgr
– Windows: WPSconfig.bat check-in-wmm-cfg-files-to-dmgr
4. Run a full manual synchronization from the Dmgr to push the changes to all nodes.
5. Restart the cluster to make the change effective.
Note: The WMM files are read once only during server startup. A restart is required for any
changes made to them to be effective.
wmm.xml
This is the most important file for WMM configuration. Any typo in the file can prevent the
WMM EJB from starting up or functioning correctly. As we already stated in Example 1, when
making manual changes to this file in a clustered environment, only modify the one under
<portal_root>/wmm on the primary node, and use the "check-out" and "check-in" procedure to
keep the file synchronized to the Deployment Manager and other nodes. This file specifies
configuration settings for WMM, such as the supported member types (Person, Group,
OrganizationalUnit, and Organization), the LDAP server host name and the bind user DN and
password, WMM connection pool data, different repositories, and so on. A scaled-down
sample of wmm.xml is shown in Example 4-10 on page 118.
Example 4-7 A sample wmm.xml
<?xml version="1.0" encoding="UTF-8"?>
<wmm name="member manager"
defaultRealmName="portal"
horizontalPartitioning="false"
lookAside="true"
configurationFile="wmmAttributes.xml"
maximumSearchResults="200"
searchTimeOut="120000"
userSecurityNameAttribute="uid"
passwordAttribute="userPassword">
<supportedMemberTypes>
<supportedMemberType name="Person"
rdnAttrTypes="uid"
defaultParentMember="ou=people,ou=dept,o=acme.com"
Chapter 4. WebSphere Portal security
115