Replace the WebSphere Portal administrator user ID

If we change the security configuration, we might need to replace the old IBM WebSphere Portal administrator user ID with a new WebSphere Portal administrator user ID.

If we are using WCM within our clustered environment, complete these steps on every node in the cluster. If WCM is not configured, complete these steps only on the primary node.

1. Create a user in the Manage Users and Groups portlet to replace the current WebSphere Portal administrative user.

2. Replace the old WebSphere Portal administrative user with the new user:

   cd WP_PROFILE/ConfigEngine
   ./ConfigEngine.sh wp-change-portal-admin-user \
                     -DWasPassword=foo \
                     -DnewAdminId=newadminid \
                     -DnewAdminPw=newpassword \
                     -DnewAdminGroupId=newadmingroupid 
   

   The -DnewAdminGroupId parameter is required only if we plan to replace the old administrative group ID.

   This task verifies the user against a running server instance. If the server is stopped, add the parameter to skip validation...

   -Dskip.ldap.validation=true

3. Verify the task completed successfully.

4. Stop and restart all required servers.

5. Change the information stored in the SearchAdminUser alias:

   1. Log in to the WAS admin console.

   2. Click...
      Security | Global security | Authentication | Java Authentication and Authorization Service | J2C authentication data

   3. Edit the SearchAdminUser alias.

   4. Update the user ID and/or password to match the WebSphere Portal administrator information.

6. Clustered environments: Synchronize the nodes.

   1. Log on to the dmgr and go to...
      System Administration | Nodes

   2. Select the nodes to synchronize from the list.

   3. Click Full Resynchronize.

What to do next

• If we use an external security manager such as Security Access Manager, manually remove the old administrator user ID from the external security manager.

• If we are using the default portal administrator user ID as the crawler user ID for Portal Search, adapt that crawler user ID accordingly. See the topic about Manage the content sources of a search collection.

Parent Update user ID and passwords

Related tasks:

Manage the content sources of a search collection