search cancel

nhJoinCluster command (Legacy KB ID CNC TS13097 )


Article ID: 52279


Updated On:


CA eHealth


After you add the first member to a cluster, you can add additional eHealth systems to the cluster.

NOTE: Always add one eHealth system at a time. Allow the nhJoinCluster command to finish before you run it on another eHealth system that you want to add to the cluster. This keeps the cluster member tables synchronized.

To add additional systems to the cluster:

1. Log in to the eHealth system that you are adding to the cluster as the eHealth administrator.

2. If the eHealth system is a UNIX system, do the following:

     a. Change to the eHealth home directory: cd /ehHome

NOTE: /ehHome represents the pathname of the directory where eHealth is installed.

     b. Source the nethealthrc file for your shell environment using one of the commands listed in Table below.

NOTE : If you do not source the eHealth resource file, change to the /ehHome/ in directory or specify that directory in your eHealth commands.

Sourcing the eHealth Resource File
Shell            Command
Bourne        .
C                 source nethealthrc.csh
Korn            . nethealthrc.ksh

3. Close the eHealth Console, any secondary eHealth Consoles, and any open Live Health applications on the local system. This ensures that eHealth updates the object IDs with the cluster information. You can restart these applications after you join the system to the cluster.

4. Enter the following command, where hostname is the hostname of a system that is already a member of the cluster that you want to join:

           nhJoinCluster -host hostname -useStdDac yes

The -useStdDac argument specifies whether the system that you are adding should replicate its Standard service profile settings to the other cluster members (yes value), or whether it should replace its Standard profile with the Standard profile used by the cluster (no value). Within the cluster, the Standard service profile must have the same values on all cluster members to ensure that the reports from each Distributed eHealth System use the same thresholds for data analysis.

NOTE: You can specify additional optional arguments; refer to "nhJoinCluster" on page 187 for details.

5. At the following prompt, enter the cluster password:

          Enter Cluster Password:

The command displays messages that inform you of the status of the join process. When you add a Distributed eHealth Console to a cluster, the messages are similar to the following:

Join cluster initiated:

Validating supplied host .. OK
Adding local machine to cluster .. OK
Updating local database ...... OK
Updating database handles .. OK
Synchronizing objects of type element .. OK
Synchronizing objects of type group .. OK
Synchronizing objects of type groupSection .. OK
Synchronizing objects of type groupList .. OK
Synchronizing objects of type groupListContents .. OK
Synchronizing objects of type serviceProfile.. OK
Replicating objects of type serviceProfile .. OK
Replicating objects of type dataAnalysisRec .. OK

These messages inform you that the join process first synchronizes the local (joining) system with the information on the other cluster members. It then replicates the information for the objects on the local system with the other cluster members. For a Distributed eHealth Console, the synchronized information includes elements, groups, group contents, group lists, group list contents, and service profile.s. The replication process includes service profile and data analysis record objects.

For further Cluster information, please refer to the Distributed eHealth Admin Guide.


Related Issues/Questions:
nhJoinCluster command
How to Add Additional Members to the Cluster

Problem Environment:

(Legacy KB ID CNC TS13097 )


Release: LHBASC99000-6.2-eHealth-Live Health Upgrade Elements