Unsupported content This version of the documentation is no longer supported. However, the documentation is available for your convenience. You will not be able to leave comments.

Creating a BMC Atrium DIL cluster and joining nodes to the cluster

For BMC Dashboards for BSM to operate in a cluster configuration, use the procedures in this topic to prepare the nodes, create the BMC Atrium DIL cluster, and join the nodes to the cluster.

To prepare the BMC Atrium DIL nodes

  1. Install the primary BMC Atrium DIL cluster node. For more information, see Installing-BMC-Dashboards-for-BSM-in-a-clustered-configuration.
  2. Install the secondary BMC Atrium DIL cluster node on a separate host. For more information, see Installing-BMC-Dashboards-for-BSM-in-a-clustered-configuration.
  3. Repeat step 2 for each additional secondary node.

To create the cluster on the primary node

When you create the cluster on the primary node, the BMC Atrium DIL server component on that node is automatically joined to the cluster.

  1. On the primary BMC Atrium DIL node, navigate to BSMDASHBOARDS_HOME\DIL\CIS\apps\dil and run DILCluster.bat (Microsoft Windows) or DILCluster.sh (UNIX or Linux).
  2. In the BMC Atrium DIL Configuration Utility, type option 1 (Create a new BMC Atrium DIL cluster on this computer) and press Enter.

  3. Type a name for the cluster and press Enter.

    If you use a cluster name with spaces, ensure that the cluster name is enclosed in quotation marks, for example, "My New Cluster".

    The output that you should see is similar to the following example where the variable name is the name of the cluster:

    Cluster Name: <name>
    Output type <DELIMITED, LABELED> (DELIMITED):
    Using configuration from C:\BMCSoftware\BMCDashboardsfForBSM\DIL
    OS - windows Server 2008
    Executing "C:\BMCSoftware\BMCDashboardsForBSM\DIL\CIS\bin
    \cluster_util.bat"     -server localhost -port 9400 -user dil_admin -password
    <BLOCKED_PASSWORD> -domain composite -create -clusterName <name> -debug:
    DONE

To join a BMC Atrium DIL node to the cluster

When you join the node to the cluster, you retrieve the cluster configuration information first to find the name of any BMC Atrium DIL server that is already a member of the cluster.

  1. On the primary BMC Atrium DIL server node or a node already in the cluster, navigate to BSMDASHBOARDS_HOME\DIL\CIS\apps\dil and run DILCluster.bat (Microsoft Windows) or DILCluster.sh (UNIX or Linux).

  2. In the BMC Atrium DIL Configuration Utility, type option 6 (Retrieve cluster configuration information) and press Enter.

    The output is similar to the following example:

    Using configuration from C:\BMCSoftware\BMCDashboardsForBSM\DIL
    OS = Windows Server 2008
    Executing "C:\BMCSofware\BMCDashboardsForBSM\DIL\CIS\bin
    \cluster_util.bat"     -server localhost -port 9400 -user dil_admin -password
    <BLOCKED_PASSWORD> -domain composite -getConfig -debug:
    Cluster name: DILCluster
    Cluster member nodes:
    --Server name: bsmdash5.bmc.com-9400-1719378104
    Server host name: bsmdash5.bmc.com
    Server port: 9400
    DONE
  3. Record the host name of a BMC Atrium DIL server already in the cluster. In the previous example, bsmdash5.bmc.com is the host name of a BMC Atrium DIL server in the cluster.
  4. On the BMC Atrium DIL server that you want to add to the cluster, run DILCluster.bat (Microsoft Windows) or DILCluster.sh (UNIX or Linux).
  5. In the BMC Atrium DIL Configuration Utility, type option 2 (Join this BMC Atrium DIL Server to an existing cluster) and press Enter.

  6. In response to the prompt Cluster Server Name, type the host name that you recorded in step 3 and press Enter.

    The output that see is similar to the following example:

    Executing JoinCluster with the following parameters:
    input parameters = CLUSTER.SERVER.NAME=vl-aus-atm-qa03
    CLUSTER.SERVER.NAME = vl-aus-atm-qa03
    Using configuration from C:\BMCSoftware\BMCDashboardsForBSM\DIL
    OS = Windows Server 2008
    Executing "C:\BMCSoftware\BMCDashboardsForBSM\DIL\CIS\bin
    \cluster_util.bat"     -server localhost -port 9400 -user dil_admin -password
    <BLOCKED_PASSWORD. - domain composite -join -memberServer vl-aus-atmqa03.
    bmc.com -memberPort 9400 -memberUser dil_admin -memberPassword
    <BLOCKED_PASSWORD> -memberDomain composite -debug:
    This action may take minutes to complete...
    Server has joined cluster AAA.
    Using configuration from C:\BMCSoftware\BMCDashboardsForBSM\DIL
    DONE

Troubleshooting the cluster failure

If the attempt to join the cluster fails, use the information in the following table.

Issue

Resolution

The attempt to join the cluster fails, and the following message appears in the BMCDashboardsInstallationDirectory \DIL\CIS\logs\
cluster\cs_cluster.log file on the joining node:

WARN 2011-07-11 19:20:42.370 +0000
NewClusterNode - Failed to connect to hostname.
Cause: java.net.SocketException: Invalid argument:
sun.nio.ch.Net.setIntOption

 Restart the primary BMC Atrium DIL node.

You are not able to add Windows hosts to the BMC Atrium DIL cluster and an error message appears in one or both of the following Composite log files:

  • BMCDashboardsInstallationDirectory\CIS\logs\
    cs_server.log
  • BMCDashboardsInstallationDirectory\CIS\logs\
    cluster\cs_cluster.log

The error message that appears follows:

WARN [main] 2011-09-01 23:43:59.490 +0000
TCP - failed to join /224.0.75.75:7500 on
net3: java.net.SocketException:
Unrecognized Windows Sockets error: 0: no
Inet4Address associated with interface

Edit the file C:\Windows\system32\drivers\etc\hosts for each host by adding a # symbol to the following line so that it is not used, as follows:

# ::1 localhost

Where to go from here

For information about administering the BMC Atrium DIL cluster, see Administering-the-BMC-Atrium-DIL-cluster.

 

Tip: For faster searching, add an asterisk to the end of your partial query. Example: cert*