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
--wapassword	HCL Workload Automation administrative user password	Creating the HCL Workload Automation administrative user
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:

Installing Open Liberty on the workstation where you plan to install the backup domain manager.
Encrypting passwords (optional).
Creating and populating the database for the master domain manager. The backup domain manager shares the database with the master domain manager.
Creating the HCL Workload Automation administrative user
Installing the master domain manager and backup master domain manager
On UNIX™ operating systems, ensure that umask is set to 022. To verify that umask is set to the correct value, from a command prompt, run the umask command. If the value is different from 022, modify it by running the following command:
```
umask 022
```

You can run the serverinst command specifying a typical set of parameters. In this case, default values are used for all remaining parameters. For more information about all serverinst parameters and default values, see Server components installation - serverinst script.

A properties file named serverinst.properties is available if you do not want to type parameters in the command line. This is expecially useful if you need to specify many parameters or if you want to reuse the file for several installations. The file is located in image_location/TWS/interp_name.

You can specify values in the properties file, type them in the command line, or use both methods. If a parameter is specified both in the properties file and in the command line, the command line value takes precedence.

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:

Log in to the workstation where you plan to install as root.
Browse to the folder where the serverinst command is located in image_location/TWS/interp_name.

. 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>

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.