Installing an additional backup domain manager

Considerations about installing an additional backup domain manager

This picture describes the steps required for installing the master domain manager. You are now at step 5: installing the backup domain manager

You can perform a typical installation, as described in the following scenario, or you can customize the installation parameters, as described in FAQ - master domain manager and backup master domain manager customizations.

The backup domain manager shares the database with its master domain manager and requires a dedicated Open Liberty, installed on the same workstation as the backup domain manager.

After installing a master domain manager, the administrator runs the serverinst command again to install a backup domain manager on a dedicated workstation. The backup domain manager is an agent that can assume the responsibilities of its master domain manager. The serverinst command connects to the database you specify, discovers that a master domain manager is already installed, and proceeds to install a backup domain manager.

You might want to install an additional backup domain manager for increased performance and reliability, for example you can move the event processor or the Dynamic Workload Console workload to the backup domain manager.

The HCL Workload Automation administrator needs the following information, which is the same provided when installing the master domain manager, with the exception of the Open Liberty installation directory, which is located on the workstation where you are installing the backup domain manager:
Table 1. Required information

Required information for performing the installation

Command parameter Information type Provided in...
Database information
--rdbmstype database type Creating and populating the database
--dbhostname database hostname
--dbport database port
--dbname database name
--dbuser database user name
--dbpassword database password
HCL Workload Automation information
--wauser HCL Workload Automation administrative user name Creating the HCL Workload Automation administrative user
--wapassord HCL Workload Automation administrative user password
Open Liberty information
--wlpdir Open Liberty installation directory Installing Open Liberty
Before starting the backup domain manager installation, ensure the following steps have been completed:
  1. Installing Open Liberty on the workstation where you plan to install the backup domain manager.
  2. Encrypting passwords (optional).
  3. Creating and populating the database for the master domain manager. The backup domain manager shares the database with the master domain manager.
  4. Creating the HCL Workload Automation administrative user
  5. Installing the master domain manager and backup master domain manager

You can run the serverinst command specifying a typical set of parameters. In this case, default values are used for all remaining parameters.

Default values are stored in the serverinst.properties file, located in image_location/TWS/interp_name.

If you need to modify any of the default values, edit the serverinst.properties file, but do not modify the serverinst.template file located in the same path.

To install the backup domain manager, perform the following steps:
  1. Log in to the workstation where you plan to install as root.
  2. Browse to the folder where the serverinst command is located in image_location/TWS/interp_name.
  3. . Start the installation specifying a minimum set of parameters. In this case, default values are used for all remaining parameters:
    On Windows operating systems
    cscript serverinst.vbs --acceptlicense yes --rdbmstype <db_type> 
        --dbhostname <db_hostname> --dbport <db_port> --dbname <db_name> 
        --dbuser <db_user> --dbpassword <db_password> --wauser <wa_user> 
        --wapassword <wa_password> --wlpdir <Liberty_installation_dir>
    On UNIX operating systems
    ./serverinst.sh --acceptlicense yes --rdbmstype <db_type> 
            --dbhostname <db_hostname> --dbport <db_port> --dbname <db_name> 
            --dbuser <db_user> --dbpassword <db_password> --wauser <wa_user> 
            --wapassword <wa_password> --wlpdir <Liberty_installation_dir>
  4. To verify that the installation completed successfully, browse to the directory where you installed the backup domain manager and type the following commands:
     . ./tws_env.sh
    optman ls

    This command lists the HCL Workload Automation configurations settings and confirms that HCL Workload Automation installed correctly.

You have now successfully installed the backup domain manager.

If you want to customize more installation parameters, see FAQ - master domain manager and backup master domain manager customizations.