Create a static cluster on AIX


Overview

After installing IBM WebSphere Portal on the primary node, configuring a remote database, and preparing the primary node to communicate with the Deployment Manager, you can create static cluster to handle failover requests.


Create the cluster

  1. ./ConfigEngine.sh cluster-node-config-post-federation -DWasPassword=dmgr_password

  2. If dmgr is running standalone security, edit wkplc.properties and set...

      standalone.ldap.id=FOO01LDAP
      standalone.ldap.host=foo-ldap-tam60.cna.com
      standalone.ldap.port=636
      standalone.ldap.bindDN=uid=wpbind,cn=serviceids,ou=special users,dc=bar,dc=com
      standalone.ldap.bindPassword=foo
      standalone.ldap.userIdMap=*:ou
      standalone.ldap.groupIdMap=*:cn
      standalone.ldap.userFilter=(&(uid=%v)(objectclass=inetOrgPerson))
      standalone.ldap.groupFilter=(&(cn=%v)(objectclass=groupOfUniqueNames))
      standalone.ldap.groupMemberIdMap=groupofuniquenames:uniquemember;groupofnames:member
      standalone.ldap.serverId=uid=wpadmin,cn=serviceids,ou=special users,dc=bar,dc=com
      standalone.ldap.serverPassword=
      standalone.ldap.primaryAdminId=uid=wpadmin,cn=serviceids,ou=special users,dc=bar,dc=com
      standalone.ldap.primaryAdminPassword=
      standalone.ldap.primaryPortalAdminId=uid=wpadmin,cn=serviceids,ou=special users,dc=bar,dc=com
      standalone.ldap.primaryPortalAdminPassword=
      standalone.ldap.primaryPortalAdminGroup=cn=wp.admins,ou=groups,dc=bar,dc=com
      standalone.ldap.baseDN=dc=bar,dc=com
      standalone.ldap.personAccountParent=ou=people,dc=bar,dc=com
      standalone.ldap.groupParent=ou=groups,dc=bar,dc=com
      standalone.ldap.sslEnabled=true
      standalone.ldap.realm=myrealm

  3. Since the WebSphere Portal node is now using security settings from the Deployment Manager cell, you need to update the WebSphere Portal administrative user ID and password to match an administrative user defined in the cell's user registry. Run...

    To update the WebSphere Portal administrative user ID if the Deployment Manager cell is using a different user registry.

        cd WP_PROFILE/ConfigEngine


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

    The password value for -DWasPassword is the Deployment Manager administrative password. Provide the full distinguished name (DN) for the newAdminId and newAdminGroupId parameters.

    Additional parameter for stopped servers: This task verifies the user against a running server instance. If the server is stopped, add the parameter...

      -Dskip.ldap.validation=true

    .to the task to skip the validation.

    If the value for newAdminGroupId contains a space; for example Software Group, open wkplc.properties and add the values for...

    • newAdminId
    • newAdminPw
    • newAdminGroupId

    Save changes and run...

      ConfigEngine.sh wp-change-portal-admin-user -DWasPassword=dmgr_password

    If standalone LDAP security is already enabled on the Deployment Manager cell, delay running...

      wp-change-portal-admin-user

    .until after the...

      cluster-node-config-cluster-setup

    .or...

      cluster-node-config-dynamic-cluster-setup

    .completes. After running the wp-change-portal-admin-user task, start or restart the WebSphere_Portal server to use the updated administrator user ID.

    The WebSphere Portal administrative user ID and administrative group must exist in the Deployment Manager before running the wp-change-portal-admin-user task. -DnewAdminPw is an optional parameter to update the Administrative password in wkplc.properties if required.

  4. ./ConfigEngine.sh cluster-node-config-cluster-setup -DWasPassword=dmgr_password

  5. If you entered passwords in any of the properties files while creating cluster, you should remove them for security purposes. See "Deleting passwords from properties files" under Related tasks for information.

  6. Add a new JCRSeedBus cluster bus member and remove the previous server bus member:

    1. Log on to the Deployment Manager Administrative Console.

    2. Navigate to...

        Service Integration | Buses | JCRSeedBus | Topology | Bus members | Add

    3. Click the Cluster radio button to define the type of new bus member and then select the name of this newly created Portal cluster from the drop-down menu. Click Next to continue.

    4. Ensure that the Enable Messaging Engine Policy Assistance checkbox is checked. Then choose the required messaging engine policy setting .

    5. Click Next.

    6. Select the Data store radio button and then click Next.

    7. Click the name of the first messaging engine listed in the table.

    8. Enter the following information on the Specify data store properties panel:

      Field Value
      Data source JNDI name jdbc/data_source_name

      ...where data_source_name is the value for the jcr.DataSourceName property in wkplc_dbdomain.properties file located in the WP_PROFILE/ConfigEngine/properties directory of the primary node.

      Schema name Value of the jcr.DbSchema property in wkplc_dbdomain.properties.
      Authentication alias Choose the entry in the drop-down list whose name contains the JCR data source name.

    9. Ensure that the Create tables checkbox is checked and then click Next to continue.

    10. The Configure messaging engines panel displays containing the list of messaging engines. If any additional messaging engines are displayed, repeat the steps to configure each additional messaging engine in the table. Then click Next to continue.

    11. Review the heap sizes on the Tune performance parameters panel. Click Next to continue.

      To change the values, click the Change heap sizes checkbox and enter new values in the Proposed heap sizes text fields.

    12. The Summary panel displays, which allows you to review the messaging engine configuration changes. Click Previous if you need to go back and make additional changes or click Finish to complete the configuration process.

    13. Click Save to save the changes to the master configuration.

    14. The table of bus members displays. Select the Server bus member type with the name of the Portal server from the primary node and click Remove.

    15. Click OK to verify the removal of the server bus member.

    16. Navigate to...

        Resources | JMS | Topic Connection Factories | JCRSeedTCF

    17. For the property Durable Subscription Home, select the new bus member you created from the drop-down menu; for example

        PortalCluster.000-JCRSeedBus

    18. Click OK to confirm the update to JCRSeedTCF.

    19. Click Save to save the changes to the master configuration.

    20. Synchronize changes to the primary node.

      • If you previously configured a data store type of bus member, you need to remove it first before you recreate it. Also, follow the instructions in this tech note. The tech note explains how to clean up the tables. If you do not clean up the tables, the bus member does not properly start.

  7. Propagate changes:

      ./stopServer.sh WebSphere_Portal_x -username admin_userid -password foo
      ./startServer.sh WebSphere_Portal_servername

    If you are uncertain of the server name, to get a list...

      serverstatus -all


See also

Prepare to create the cluster on AIX
Delete passwords from properties files


+

Search Tips   |   Advanced Search