Roadmap: Multiple clusters | HCL Digital Experience
Add an HCL Digital Experience cluster to an existing cluster.
Read Planning for multiple clusters before you start to create your multiple clusters.
Who should use this roadmap
- An organization that has an existing cluster and needs to add more clusters to the existing one.
- An organization that wants to manage many application servers and clusters within a single administrative domain or cell.
- An organization that wants to manage multiple portals and portal-based products within the same managed cell.
Topology diagram
A network load balance directs incoming traffic between the two web servers. Each cluster has a web server. However, a single on-demand router might be used instead.
Preparing for the installation process
- Check requirements.
- Documentation resource: System requirements
- Get the software.
- Documentation resource: Getting the software
Installing prerequisite
You can use existing prerequisite software installations. Verify that your existing version is supported. If it is not, upgrade to the appropriate version. Otherwise, install a web server, database server, and user registry server. Typically the database and user registry servers are already installed and configured. However, there might be specific configuration steps that are required to integrate them with the portal server.
- Install a web server.
- Documentation resource: Preparing a remote web server
- Prepare a database server.
- Documentation resource: Installing and preparing the database software
- Prepare a user registry.
- Documentation resource: Preparing the user registry software
Installing the HCL Digital Experience
- Documentation resource: Installing the HCL Digital Experience software
Applying the latest cumulative fix
- Documentation resource: Roadmap: Applying maintenance
Creating cluster A
Create your first cluster, including the database transfer, augmenting the Deployment Manager, creating a cluster node, enabling security, and creating additional horizontal cluster nodes. These instructions are for a horizontal cluster only. For information on setting up a vertical cluster, see Setting up a Cluster in the Configuring section of the documentation.
http://hostname.example.com:10039/wps/portal,
where hostname.example.com is the fully qualified host name of the server where
Portal is running and 10039 is the default transport port that is created by DX® Application Server. The port number might be different
for your environment.
- To get the latest updates for the wizard, apply the most recent Combined
Cumulative Fix. For more information about applying the latest fix pack, see
HCL Digital Experience Combined Cumulative Fix
Strategy.Note: Skip this step, if you have the most recent fix pack applied.
- Access the Configuration Wizard. Go to http://your_server:10200/hcl/wizard.Note: If working with HCL Digital Experience 8.5 or 9 software level prior to CF18, the wizard address will be: http://your_server:10200/ibm/wizard. After installing CF18, the configuration wizard will automatically be adjusted to http://your_server:10200/hcl/wizard.Restriction: There is a known issue with Chrome version 45.x and the Configuration Wizard. If you are experiencing difficulties, use a different browser when you access the wizard.
- Log in to the Configuration Wizard with the administrative ID
for the configuration wizard profile, cw_profile.
Note: The wizard user interface might not be available in all languages. If the language is not currently supported, you might see the English version. For details on the supported languages for all of the HCL Digital Experience user interfaces, see Supported languages.
- Select Note: The Database Transfer configuration option in the Configuration Wizard assigns users and permissions, creates databases, obtains support for database collation, and transfers your database.
.
- Provide information about your environment. Attention: Record your database settings so that you can use the same information when you create Portal B. If cluster A exists, upgrade it to match Portal B.Important: Maintain the same number of data sources with identical names to the Cluster A data sources. Then, the data source bindings in the applications can be resolved on every cluster. If you share databases across the clusters, this statement refers to both the shared and non-shared domains. All domains must use the same names. For example, if Cluster A uses relDS comDS custDS jcrDS fbkDS lmDS, then Cluster B must also use six data sources with the same names. Cluster B cannot be configured to use a single data source. An enterprise application that is shared between cluster contains only a single binding to a single data source name. An application cannot contain a binding to multiple data source names. If the data source names are the same and the user ID and password are the same, then the extra aliases are not required. The binding in the application resolves to the data source for both clusters because the name is the same and the user ID and password is the same.
- Save your configuration settings.
- Choose one of the following options:
- Click Download Files to run the steps remotely; or
- Click Run All Steps to run the steps locally.
- Log in to HCL Portal to verify that you have a working portal server.
- Select .
- Provide information about your environment.
- Save your configuration settings.
- Choose one of the following options:
- Click Download Files to run the steps remotely; or
- Click Run All Steps to run the steps locally.
- Optional: If you changed the context root during the installation or configuration of HCL Digital Experience, then you must complete the optional next step from the Configuration Wizard to update parameters with the new context path after you complete the Create a Deployment Manager configuration option. For more information about this configuration option and completing the next steps, see Create a deployment manager.
- Log in to HCL Portal to verify that you have a working portal server.
- Select .
- Provide information about your environment.
- Save your configuration settings.
- Choose one of the following options:
- Click Download Files to run the steps remotely; or
- Click Run All Steps to run the steps locally.
- Log in to HCL Portal to verify that you have a working portal server.
- Note: If you set Use Administrator IDs stored in your LDAP user registry to yes, the WebSphere® Application Server and HCL Portal user IDs and passwords are changed to the LDAP user ID and password. If you do not want to change both user IDs and passwords to match the LDAP user ID and password, set this value to no. After you configure your LDAP user registry, you can manually change the user IDs and passwords.
- Documentation resource: Updating user ID and passwords
. - Provide information about your environment.
- Save your configuration settings.
- Choose one of the following options:
- Click Download Files to run the steps remotely; or
- Click Run All Steps to run the steps locally.
- Log in to HCL Portal to verify that you have a working portal server.
- Install HCL Digital Experience on the additional node.Install HCL Digital Experience
on the idle standby.
Documentation resource: Installing the HCL Digital Experience software.
Tip: For additional nodes, you only need to install the HCL Portal product binary files. Therefore, on the Features screen of the IBM® Installation Manager, ensure that Portal Server Profile is not selected. - Optional: If you want to shorten your site URL for search engine optimization
benefits, you can modify your context root and remove navigational state information
from your URL by using the Modify Site URLs for Search Engine
Optimization configuration option.
- Documentation resource: Configuration Wizard instructions: Modify site URLs for search engine optimization
- Note: If you are setting up a vertical cluster, manual instructions are available for dynamic and static cluster configurations. For more information, see Adding vertical cluster members to a static cluster or Adding vertical cluster members to a dynamic cluster.
.
- Provide information about your environment.
- Save your configuration settings.
- Choose one of the following options:
- Click Download Files to run the steps remotely; or
- Click Run All Steps to run the steps locally.
- Log in to HCL Portal to verify that you have a working portal server.
Configuring portal B
Install HCL Digital Experience. Then, use the Configuration Wizard to deploy a stand-alone portal.
http://hostname.example.com:10039/wps/portal,
where hostname.example.com is the fully qualified host name of the server where
Portal is running and 10039 is the default transport port that is created by DX® Application Server. The port number might be different
for your environment.
- Access the Configuration Wizard. Go to http://your_server:10200/hcl/wizard.
Note: If working with HCL Digital Experience 8.5 or 9 software level prior to CF18, the wizard address will be: http://your_server:10200/ibm/wizard. After installing CF18, the configuration wizard will automatically be adjusted to http://your_server:10200/hcl/wizard.Restriction: There is a known issue with Chrome version 45.x and the Configuration Wizard. If you are experiencing difficulties, use a different browser when you access the wizard.
- Log in to the Configuration Wizard with the administrative ID for
the configuration wizard profile, cw_profile.
Note: The wizard user interface might not be available in all languages. If the language is not currently supported, you might see the English version. For details on the supported languages for all of the HCL Digital Experience user interfaces, see Supported languages.
- Select .
- Provide information about your environment. Important: Maintain the same number of data sources with identical names to the Cluster A data sources. Therefore, the data source bindings in the applications can be resolved on every cluster. If you share databases across the clusters, this statement refers to both the shared and non-shared domains. All domains must use the same names.
- Save your configuration settings.
- Choose one of the following options:
- Click Download Files to run the steps remotely; or
- Click Run All Steps to run the steps locally.
- Log in to HCL Portal to verify that you have a working portal server.
- Select Note: If you set Use Administrator IDs stored in your LDAP user registry to yes, the WebSphere® Application Server and HCL Portal user IDs and passwords are changed to the LDAP user ID and password. If you do not want to change both user IDs and passwords to match the LDAP user ID and password, set this value to no. After you configure your LDAP user registry, you can manually change the user IDs and passwords.
- Documentation resource: Updating user ID and passwords
. - Provide information about your environment.
- Save your configuration settings.
- Choose one of the following options:
- Click Download Files to run the steps remotely; or
- Click Run All Steps to run the steps locally.
- Log in to HCL Portal to verify that you have a working portal server.
Configuring the multiple cluster
- Optional: Complete the following steps on the primary node of Cluster
A.Use the same database user ID and password for each identically named domain or data source. It allows the existing JAAS Authentication Aliases to be functional. If a unique database user ID and password are required, more manual configuration is required to create and map JAAS Authentication Aliases for each data source.
- Open a command prompt.
- Change to the wp_profile_root/ConfigEngine directory.
- Run the following task to create the JAAS Authentication Aliases:Result:
- AIX® HP-UX Linux™ Solaris: ./ConfigEngine.sh create-alias-multiple-cluster -DauthDomainList=release,jcr -DWasPassword=dmgr_password
- IBM® i: ConfigEngine.sh create-alias-multiple-cluster -DauthDomainList=release,jcr -DWasPassword=dmgr_password
- Windows™: ConfigEngine.bat create-alias-multiple-cluster -DauthDomainList=release,jcr -DWasPassword=dmgr_password
Where authDomainList is set to a list of domains that use unique database user ID and passwords. The domain properties are set correctly in the wkplc_dbdomain.properties file, including user ID and password.
- Optional: If necessary, upgrade Portal B to the current fix pack.
- Complete the following steps to create an inventory list of Portal B enterprise
applications and portlets:
- Open a command prompt on Portal B.
- Change to the wp_profile_root/ConfigEngine directory.
- Run the following task to create the list:Example:
- AIX® HP-UX Linux™ Solaris: ./ConfigEngine.sh mapped-app-list-create -DWasPassword=password
- IBM® i: ConfigEngine.sh mapped-app-list-create -DWasPassword=password
- Windows™: ConfigEngine.bat mapped-app-list-create -DWasPassword=password
- z/OS®: ./ConfigEngine.sh mapped-app-list-create -DWasPassword=password
- Run the following command from the wp_profile_root/bin
directory to federate Portal B:Example:
./addNode.sh dmgr_hostname dmgr_port -includeapps -username was_admin_user -password was_admin_password
addNode.sh dmgr_hostname dmgr_port -includeapps -username was_admin_user -password was_admin_password
addNode.bat dmgr_hostname dmgr_port -includeapps -username was_admin_user -password was_admin_password
The variables are defined as:- dmgr_hostname is the TCP/IP host name of the Deployment Manager server
- dmgr_port is the SOAP port number of the Deployment Manager server
- was_admin_user and was_admin_password are the user ID and password for the Deployment Manager administrator
- -localusername local_was_admin_user
- -localpassword local_was_admin_password
Warning: If the addNode task fails for any reason, you must complete the following steps before you rerun the task:- Remove the node if the AddNode task succeeded in creating the node.
- If the items exist, log on to the deployment manager and complete the
following steps:
- Remove the HCL Portal server definition.
- Remove the HCL Portal JDBC Provider.
- Stop the HCL Portal server on the primary node of Cluster B and ensure
that the following parameters are set correctly in the
wkplc.properties file:Note: You can add these parameters (particularly passwords) directly to any task. However, you might want to temporarily add them to the properties file. You can then remove them when you are finished to keep your environment secure.
- Set WasSoapPort to the port used to connect remotely to the deployment manager.
- Set WasRemoteHostName to the full host name of the server that is used to remotely connect to the deployment manager.
- Verify that WasUserid is set to your Deployment Manager administrator user ID.
- Verify that WasPassword is set to your Deployment Manager administrator password.
- Verify that PortalAdminPwd is set to your HCL Portal administrator password.
- Verify that ClusterName is set.
- Verify that PrimaryNode is set to true.
- Run the following task to determine which applications from the inventory list are
no longer mapped to Portal B. The task uses the application profiles in the cell to
restore the mappings. Wait 30 minutes after you run this task to allow all EAR
files to expand before you proceed to the next step.Choose from:
- AIX® HP-UX Linux™ Solaris: ./ConfigEngine.sh map-apps-to-server -DWasPassword=password
- IBM® i: ConfigEngine.sh map-apps-to-server -DWasPassword=password
- Windows™: ConfigEngine.bat map-apps-to-server -DWasPassword=password
- Ensure that all database parameters are correctly set, including passwords, in the wkplc_comp.properties and wkplc_dbtype.properties files on Portal B.
- Run the following task on Portal B. Choose from:
- AIX® HP-UX Linux™ Solaris: ./ConfigEngine.sh cluster-node-config-post-federation -DWasPassword=password
- IBM® i: ConfigEngine.sh cluster-node-config-post-federation -DWasPassword=password
- Windows™: ConfigEngine.bat cluster-node-config-post-federation -DWasPassword=password
- The HCL Portal node is federated. It uses the Deployment Manager cell and its user
registry. If the administrative user ID and group name are different between
HCL Portal and Deployment Manager, choose one of the following options. Choose
from:
- Add the existing administrative user ID and group to the Deployment Manager security configuration
- Complete the following steps to change the values in the HCL Portal
configuration to match the Deployment Manager values
- If necessary, start the HCL Portal server.
- Verify that the required HCL Portal administrative user ID and group ID are defined in the Deployment Manager user registry that provides security.
- Run the following task:
- AIX® HP-UX Linux™ Solaris: ./ConfigEngine.sh wp-change-portal-admin-user -DWasPassword=password -DnewAdminId=newadminid -DnewAdminPw=newpassword -DnewAdminGroupId=newadmingroupid
- IBM® i: ConfigEngine.sh wp-change-portal-admin-user -DWasPassword=password -DnewAdminId=newadminid -DnewAdminPw=newpassword -DnewAdminGroupId=newadmingroupid
- Windows™: ConfigEngine.bat wp-change-portal-admin-user -DWasPassword=password -DnewAdminId=newadminid -DnewAdminPw=newpassword -DnewAdminGroupId=newadmingroupid
- z/OS®: ./ConfigEngine.sh wp-change-portal-admin-user -DWasPassword=password -DnewAdminId=newadminid -DnewAdminPw=newpassword -DnewAdminGroupId=newadmingroupid
Where:- WasPassword is set to the administrative password for the Deployment Manager cell
- newAdminId is set to the fully qualified distinguished name (DN) of the HCL Portal administrative user ID in the cell
- newAdminGroupId is set to the
fully qualified DN of the group for the HCL Portal administrative user
ID in the cellImportant: If the value for newAdminGroupId contains a space; for example, Software Group, open the wkplc.properties file. Add the values for newAdminId, newAdminPw, and newAdminGroupId. Save your changes and then run the wp-change-portal-admin-user task.
- After the task completes, stop the HCL Portal server.
- Complete the following steps from the WebSphere® Integrated Solutions Console on Portal B:
- Log on to WebSphere® Integrated Solutions Console.
- Click .
- Check the box next to the required node agent and then click Restart.
- Stop and restart the deployment manager.
- Stop and restart the HCL Portal server on Portal B.
- Restart the HCL Portal server on Cluster A. Verify that Cluster A is
functionally intact; check pages and portlets. Verify that Portal B is functionally
intact; check the pages and portlets that you deployed into Portal B before it was
federated. Any discrepancies or errors must be corrected before you continue.Note: If Portal B has an administrative ID other than wpsadmin, the server is not functional. It is functional after the cluster is complete and the administrative ID is configured to match the security settings.
- Choose one of the following options to define a cluster with Portal B as the basis.
Choose from:
- Complete the following steps to define a static cluster:
- Run the following task:
- AIX® HP-UX Linux™ Solaris: ./ConfigEngine.sh cluster-node-config-cluster-setup -DWasPassword=dmgr_password
- IBM® i: ConfigEngine.sh cluster-node-config-cluster-setup -DWasPassword=dmgr_password
- Windows™: ConfigEngine.bat cluster-node-config-cluster-setup -DWasPassword=dmgr_password
- z/OS®: ./ConfigEngine.sh cluster-node-config-cluster-setup -DWasPassword=dmgr_password
- Configure the cluster to use an external web server to take advantage of
features such as workload management. Go to Configuring a web server and an application server on
separate machines (remote) for information.Note: Start with the step about starting the plug-ins installation wizard.
- Run the following task:
- Complete the following steps to define a dynamic cluster:
- Log on to the deployment manager WebSphere® Integrated Solutions Console.
- Complete the following steps to create a node group:
- Click .
- Click New.
- Type the node group Name.
- Type any information about the node group in the Description text box.
- Click OK.
- Click the Save link to save your changes to the master configuration.
- Complete the following steps to add members to the node group:
- Click .
- Click the name of the node group that you want to add members to.
- Click Node group members under Additional Properties.
- Click Add.
- Select the primary node and then click Add.
- Click the Save link to save your changes to the master configuration.
- Complete the following steps to create a dynamic cluster in the node
group:
- Click .
- Click New.
- Select WebSphere® Application Server from the Server Type menu and then click Next.
- Select Automatically define cluster members with rules.
- Type the cluster name in the Dynamic cluster name text box. Then, click Next. Type the same value that you provided for the ClusterName parameter in the wkplc.properties file of your primary node.
- Remove all default membership policies and then click Subexpression builder.
- Enter the following information in the Subexpression builder window:
- Select and from the Logical operator menu.
- Select Nodegroup from the Select operand menu.
- Select Equals (=) from the Operator menu.
- Type the node group name that you created in the previous step in the Value text box.
- Click Generate subexpression.
- Click Append.
- Click Preview membership to verify that all nodes included in the node group display and then click Next.
- Click Create the cluster member using an existing server as a template and then select the primary node HCL Digital Experience server.
- Click Next.
- Specify the dynamic cluster properties for the minimum and maximum number of server instances.
- Review the summary page to verify your actions and then click Finish.
- Run the following task to create the dynamic cluster:
- AIX® HP-UX Linux™ Solaris: ./ConfigEngine.sh cluster-node-config-dynamic-cluster-setup -DWasPassword=dmgr_password
- IBM® i: ConfigEngine.sh cluster-node-config-dynamic-cluster-setup -DWasPassword=dmgr_password
- Windows™: ConfigEngine.bat cluster-node-config-dynamic-cluster-setup -DWasPassword=dmgr_password
- z/OS®: ./ConfigEngine.sh cluster-node-config-dynamic-cluster-setup -DWasPassword=dmgr_password
- Complete the following steps to define a static cluster:
- Complete the following steps to access the Web Content Manager content
through an external web server:
- Log on to the deployment manager WebSphere® Integrated Solutions Console.
- Select .
- From the Scope menu, select the Node=nodename, Server=servername option to narrow the scope of the listed variables. Node=nodename is the node that contains the HCL Portal application server.
- Update the WCM_HOST variable with the fully qualified host name that is used to access the HCL Portal server through the web server or On Demand Router.
- Update the WCM_PORT variable with the port number used to access the HCL Portal server through the web server or On Demand Router.
- Update the WCM_HOST and WCM_PORT variable for each additional HCL Portal application server that exists in the cluster.
- Synchronize the node with the deployment manager.
- Save your changes and then restart the deployment manager, the node agents, and the HCL Portal servers.
- Install any additional nodes for Cluster B. Then, federate them as secondary nodes and define them as cluster members on these nodes. You can add more nodes to a static or dynamic cluster. You can also add more vertical cluster members to an existing node in a static or dynamic cluster to provide vertical scaling.
- Restart the HCL Portal server on Cluster A and Cluster B.
- After you set up your multiple clusters, complete the extra tasks to ensure a
balanced workload and failover support. Choose from:
- Update the web server configuration to enable user requests to be routed to the new cluster. Refer to your web server documentation for information about using a web server with multiple clusters in a cell.
- Update your database configuration to share database domains between clusters. Refer to Database sharing between multiple clusters for information about redundancy and failover support.
- If you entered passwords in any of the properties files when you created your cluster, remove them for security purposes. Refer to Deleting passwords from properties files for information.
Results: Deployment of Cluster B is complete. It is now an independent cluster from Cluster A, which means that Cluster B can have its own configuration, set of user portlets, and target community. Any applications that are common between Cluster A and Cluster B are most likely infrastructure or related to administration. Special care must be taken to preserve their commonality between clusters and correct maintenance levels.
Configuring the web server
- Documentation resource: Web servers
Tuning the servers in your environment
Tuning the servers is important to the performance of your portal environment.
HCL Digital Experience is not tuned for a production environment after installation and deployment. You can apply tuning now or prior to "production", but under no circumstance should Portal be placed into production without some level tuning.
- Run the performance tuning tool to complete an initial tuning of your servers.
- Documentation resource: HCL Digital Experience Performance Tuning Guide
- Check the tuning guide for more instructions. Use the tuning guide for the previous
product version when the tuning guide for the current release is unavailable.
- Documentation resource: HCL Digital Experience Performance Tuning Guide
- Set the Portal to replicate Dynamic Cache (Dynacache) in your HCL Portal and HCL Web
Content Manager 8.5, 9 or 9.5 environment using the non_WAS ND method.
You need to be on the HCL V8.5, 9 or 9.5 CF18 , or 9.5 Container Update release CF_171 or later to perform this task. Afterwards, configure the following property in the IBM WebSphere Application Server Resource Provider (REP):
use.db.cache.invalidation.table
= (Boolean, which controls whether or not Dynacache invalidation table is used)- For Single node HCL Portals, this does not matter.
- Set to
True
for Kubernetes or Farming of more than one (1) POD instances. - Set to
False
in a “true” WAS ND cluster (e.g. to let WAS ND control Dynacache invalidation via the DRS manager).
For further HCL 8.5 and 9, or 9.5 deployment guidance, see Replicate Dynacache service for HCL Digital Experience.
Configuring a remote search service
- Use the IBM® Installation Manager to
install the remote search service.
- Documentation resource: Installing remote search service by using IBM Installation Manager
- If you use single-sign on, prepare the security for the remote search service.
- Documentation resource: Creating a single-sign on domain between HCL Portal and the remote search service
- Configure the security between portal and the remote search server.
- Documentation resource: Configuring user repositories on the remote search server
- Set the search user ID.
- Documentation resource: Setting the search user ID
- Configure the remote search service.
- Documentation resource: Configuring a remote search service
- Configure the seedlist servlet.
- Documentation resource: Configuring HTTP for the seedlist servlet