Create and augment a new dmgr profile on IBM i
For a production environment you should install the dmgr on a server that is remote from the portal installation. Use pmt.sh or manageprofiles.sh to create the remote dmgr profile. In a test or dev environment, we can install the dmgr locally using the Installation Manager. Skip these steps if we are using the Installation Manager to install a local dmgr profile on the primary node.
- Prerequisites
- Prepare the IBM i operating system in a clustered environment
- Prepare the primary node on IBM i
- Clustered environment: Install with Installation Manager response file on IBM i
Create and augment the dmgr profile
- If IBM WAS is not installed on the system you plan to use for the dmgr:
- Click the appropriate link under "Prerequisites" for installation instructions.
- Install Installation Manager on the dmgr server.
- Add WebSphere Portal repositories
- Install WAS ND only
- We can either use an existing dmgr profile or we can run the following command from the WAS_HOME/bin directory:
manageprofiles -create -templatePath WAS_HOME/profileTemplates/management -hostName hostname -profileName Dmgr01 -profilePath WAS_HOME/Dmgr01 -enableAdminSecurity true -adminUserName dmgradmin -adminPassword dmgrpassRestriction: To use the back up and restore task documented in the product documentation, use the default profile path for the dmgr profile; otherwise, the back up and restore tasks cannot locate the profile.
- Collect files from the primary node and copy them to the remote dmgr:
- Copy...
PORTAL_HOME/filesForDmgr/filesForDmgr.zip
...to the remote dmgr server.
- Stop the dmgr.
- Expand the filesForDmgr.zip file into the installation root directory of the dmgr; for example this may be a subdirectory under the AppServer directory and it contains the bin and profileTemplates directories.
If the dmgr profile was not created in the default Appserver/profiles/Dmgr01 directory, then...
Appserver/profiles/Dmgr01/config/.repository/metadata_wkplc.xml
...in the compressed file, must be copied into
DMGR_PROFILE/config/.repository
- Start the dmgr.
- cd WAS_HOME/bin
manageprofiles.sh -augment -templatePath WAS_HOME/profileTemplates/management.portal.augment -profileName dmgr
Use the continuation character "\" to avoid seeing the "not found" error message.
In this example, the portal profile template is installed under the WAS_HOME/profileTemplates directory. The existing dmgr profile is named dmgr and is located under the WAS_HOME/profiles/Dmgr01 directory.
- Stop and restart the dmgr server; see "Starting and stopping servers, dmgrs, and node agents" for information.
- If there are common shortnames between the default dmgr security configuration and the LDAP server:
- Log on to the dmgr console.
- Navigate to Security > Global security.
- Under User account repository, click Configure.
- In the Primary administrative user name field, alter the user ID so that is using the full distinguished user name. For the default file user registry, the syntax is...
uid=userID,o=defaultWIMFileBasedRealm
for example: uid=wpadmin,o=defaultWIMFileBasedRealm.
- Click Apply.
- Enter the password for the user and then confirm the password.
- Save all changes.
- Log out of the WAS admin console.
- If you changed the context root on the panel...
Configuration for IBM WebSphere Portal: Profile configuration details: Advanced
...during installation:
- Log on to the dmgr console.
- Go to Security > Global security.
- Click Trust association in the Web and SIP security section.
- Click Interceptors in the Additional Properties section.
- Click com.ibm.portal.auth.tai.HTTPBasicAuthTAI.
- Edit the urlBlackList and urlWhiteList parameters with the new context path; for example:
- urlBlackList: /wpsmodified/myportal*
- urlWhiteList: /wpsmodified/mycontenthandler*
- Click Apply.
- Save all changes.
- Log out of the dmgr console.
Parent: Set up a cluster on IBM i
Previous: Prepare the primary node on IBM i
Next: Create the cluster on IBM i
Related:
Start and stop servers, dmgrs, and node agents
Start and stop servers, dmgrs, and node agents