Installing a new backup master domain manager

Before you begin

About this task

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.

For more information about all serverinst parameters and default values, see Server components installation - serverinst script.

The procedure to install the backup master domain manager is exactly the same as installing a master domain manager. The backup master domain manager is installed on a workstation different from the master domain manager and points to its local WebSphere Application Server Liberty Base installation. HCL Workload Automation detects the presence of an existing master domain manager in the environment and proceeds to install a backup master domain manager.

The HCL Workload Automation administrator installs the master domain manager. The following information is required:

Table 1. Required information
Required information for performing the upgrade
Command parameter	Information type	Provided in..
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	Creating the HCL Workload Automation administrative user
WebSphere Application Server Liberty Base information
--wlpdir	WebSphere Application Server Liberty Base installation directory	Installing WebSphere Application Server Liberty

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 master domain manager, perform the following steps:

Procedure

Log in as root to the workstation where you plan to install.
Browse to the folder where the serverinst command is located in image_location/TWS/interp_name.
Start the installation specifying a typical 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>\wlp
```
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>/wlp
```
where
acceptlicense

Specify yes to accept the product license.

rdbmstype|-r rdbms_type
The database type. Supported databases are:
- DB2
- ORALE
- IDS (Informix), only for UNIX operating systems
- MSSQL
This parameter is optional. The default value is db2.
dbhostname db_hostname

The host name or IP address of database server.

dbport db_port

The port of the database server.

dbname db_name

The name of the HCL Workload Automation database.

dbuser db_user

The user that has been granted access to the HCL Workload Automation tables on the database server.

dbpassword db_password

The password for the user that has been granted access to the HCL Workload Automation tables on the database server.

wauser user_name

The user for which you are installing HCL Workload Automation.

wapassword wauser_password

The password of the user for which you are installing HCL Workload Automation.

On Windows operating systems

Supported characters for the password are alphanumeric, dash (-), underscore (_) characters, and ()|?*~+.

On UNIX operating systems

Supported characters for the password are alphanumeric, dash (-), underscore (_) characters, and ()|?=*~+.

wlpdir

The path where WebSphere Application Server Liberty Base is installed.
To verify that the installation completed successfully, browse to the directory where you installed the backup master 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.

Results

You have now successfully installed the backup master domain manager and it is inserted in the next production plan. To have the backup domain manager added immediately to the production plan, run

JnextPlan -for 0000

What to do next

You can now proceed to Configuring security or to Uninstalling the back-level backup master domain manager.