Create a static cluster on Windows

 

+

Search Tips   |   Advanced Search

 

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

To create the cluster:

1. If the Deployment Manager is configured to use a stand-alone LDAP user registry, update...
   profile_root/ConfigEngine/properties/wkplc.properties

   ...on the primary node with the stand-alone LDAP user registry property values from the Deployment Manager. You can find these settings under the VMM Stand-alone LDAP configuration heading.

   Ensure that you set WasUserid and WasPassword to the Deployment Manager user ID and password.

2. Stop the server1 and WebSphere_Portal servers on the primary node

3. Edit...
   profile_root/ConfigEngine/properties/wkplc.properties

   ...and ensure that the following parameters are set correctly...

   WasSoapPort	Set to port used to connect remotely to the deployment manager
   WasRemoteHostName	Set to full host name of the server used to remotely connect to the deployment manager
   WasPassword	Set to deployment manager password
   PortalAdminPwd	Set to WebSphere Portal password
   ClusterName	Set
   PrimaryNode	Set to true

4. If available, make a backup copy of...
   profile_root/config/cells/cell/wim/config/wimconfig.xml
   profile_root/config/cells/cell/wim/model/wimxmlextension.xml

5. On the primary node, run
   cd profile_root/ConfigEngine
   ./ConfigEngine.bat cluster-node-config-pre-federation -DWasPassword=wpsadmin

   To specify custom ports for the nodeagent, add the parameter...

   -DPortPropsFile=/path/to/portsfile

   You can use the ports files that are found on the Setup CD for WebSphere_Portal and server1 as a guide.

   You may receive a message about accepting an SSL signer certificate. Failure to accept the SSL signer certificate will cause the script to fail.

   To work around, edit ssl.client.props and set...

   com.ibm.ssl.enableSignerExchangePrompt=true

   ...for "DefaultSSLSettings" to allow acceptance of the signer during the connection attempt.

   If the cluster-node-config-pre-federation fails for any reason, before rerunning the task...

   1. Remove the node if the AddNode task succeeded.

   2. Log on to the deployment manager and perform the following steps if the items exist:
      • Remove all enterprise applications.
      • Remove the WebSphere_Portal server definition.
      • Remove the WebSphere Portal JDBC Provider.

   If you are migrating from a version prior to v6.1.0 that contains Lookaside data, see: Migrating with Lookaside Data

6. If you either...

   • Configured a database user registry or a property extension database.

   • Migrated the primary node from a release prior to v6.1.0, even if you did not configure a database user registry or a property extension database.

   ...you need to set up access to the database drivers...

   1. Edit wkplc.properties and set property value for....
      • federated.db.DbType if using a database user registry

        la.DbType if using a property extension database

      If you migrated the primary node from a version prior to v6.1.0 and you are not using a database user registry or a property extension database, set the property value for federated.db.DbType to the same value that is in wkplc.properties on the primary node.

   2. Create the variable used to access the VMM database jars.
      cd profile_root/ConfigEngine
      ./ConfigEngine.bat wp-node-prep-vmm-db-secured-environment -DWasPassword=wpsadmin -DDbDomain=la|federated.db -DVmmNodeName=node_name -Ddb_type.NodeDbLibrary=/path/to//database/jars

      Where DbDomain is either la or federated.db depending on whether you are using...

      • property extension database (la)
      • database user registry (federated.db)

      VmmNodeName is a list of one or more WebSphere Portal nodes names in the cell which share the same database driver paths.

      The db_type in db_type.NodeDbLibrary should be set to the type of database you are using, for example db2.

      The /path/to/DB/jars should be one of the following options:

      DB2 Type 4 driver	db2jcc.jar:db2jcc_license_cu.jar
      DB2 for z/OS Type 4 driver	db2jcc_license_cisuz.jar;db2jcc_javax.jar
      Oracle 10g Type 4 driver	ojdbc14.jar
      Oracle 11g Type 4 driver (WAS V6.1)	ojdbc5.jar
      Oracle 11g Type 4 driver (WAS V7)	ojdbc6.jar
      SQL Server JDBC driver provided by Microsoft	sqljdbc.jar
      SQL Server JDBC driver provided by DataDirect	sqlserver.jar;base.jar;util.jar

7. Perform cluster post config...
   ./ConfigEngine.bat cluster-node-config-post-federation -DWasPassword=wpsadmin

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

   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.

   For example, in the console, add...

   cn=wpsadmins,o=defaultWIMFileBasedRealm

   ...to...

   Users and Groups | Manage Groups

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

   The password value for -DWasPassword is the Deployment Manager administrative password.

   cd profile_root/ConfigEngine directory
   ./ConfigEngine.bat wp-change-portal-admin-user -DWasPassword=wpsadmin -DnewAdminId=uid=wpsadmin,o=defaultWIMFileBasedRealm -DnewAdminPw=wpsadmin -DnewAdminGroupId=cn=wpsadmins,o=defaultWIMFileBasedRealm

   Provide the full distinguished name for the newAdminId and newAdminGroupId parameters.

   This task verifies the user against a running server instance.

   If the server is stopped, add the -Dskip.ldap.validation=true parameter to the task to skip the validation.

   Fast path: If the value for newAdminGroupId contains a space; for example Software Group, open wkplc.properties and add the values for newAdminId, newAdminPw, and newAdminGroupId. Save changes and run...

   ./ConfigEngine.bat wp-change-portal-admin-user -DWasPassword=wpsadmin

   If standalone LDAP security is already enabled on the Deployment Manager cell, delay running the wp-change-portal-admin-user task until after the cluster-node-config-cluster-setup (static cluster) or cluster-node-config-dynamic-cluster-setup (dynamic cluster) task completes. After running the wp-change-portal-admin-user task, start or restart the WebSphere_Portal server to use the updated administrator user ID.

9. Run...
   ./ConfigEngine.bat cluster-node-config-cluster-setup -DWasPassword=wpsadmin

10. Configure the cluster to use an external Web server to take advantage of features such as workload management. Choose one of the following options:
    • Configure a Web server and an appserver on separate machines (remote)
    • Configure a Web server and an appserver profile on the same machine
    • Configure a Web server and a deployment manager profile on the same machine

    Start with the step about launching the Plug-ins installation wizard.

11. To access the Web Content Management content through an external Web server...

    1. Log on to the deployment manager administrative console.

    2. Select...
       Environment | WebSphere Variables

    3. From the Scope drop-down menu, select the...
       Node=nodename, Server=servername

       ...option to narrow the scope of the listed variables, where Node=nodename is the node that contains the appserver.

    4. Update the WCM_HOST variable with the fully qualified host name used to access the WebSphere Portal server through the Web server or On Demand Router.

    5. Update the WCM_PORT variable with the port number used to access the WebSphere Portal server through the Web server or On Demand Router.

    6. To synchronize the node with the deployment manager:

       1. Select...
          System Administration | Nodes

       2. Select the node that you want to synchronize from the list.

       3. Click Full Resynchronize.

    7. Log off of the deployment manager administrative console.

12. Propagate your changes:

    WebSphere_Portal_nodename is the name of the node's WebSphere Portal server; but if you customized the server name, the default name changes. If you are uncertain of the server name, run the serverstatus -all task to get a list of the server names and their status.

    cd dmgr_profile_root/bin
    stopManager.bat -username admin_userid -password admin_password
    cd profile_root/bin
    stopNode.bat -username admin_userid -password admin_password
    stopServer.bat WebSphere_Portal_nodename -username admin_userid -password admin_password
    stopServer.bat WebSphere_Portal -username admin_userid -password admin_password
    cd dmgr_profile_root/bin
    startManager.bat
    cd profile_root/bin
    startNode.bat
    startServer.bat WebSphere_Portal_nodename -username admin_userid -password admin_password

13. Change the task list settings to point to the cluster instead of a single server if using Portal business process integration.

    See one of the following sections in the Information Center for information:

    Option	Description
    Cross cell	Adding a BPI-enabled portal server to a managed cell in a cross-cell setup
    Single cell	Adding a BPI-enabled portal server to a managed cell in a single-cell setup

Parent topic:

Choose the type of cluster to create on Windows

Related tasks

Add a BPI-enabled portal server to a managed cell in a cross-cell setup
Add a BPI-enabled portal server to a managed cell in a single-cell setup