Installing a new backup master domain manager

Installing the 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
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

  1. Log in as root to the workstation where you plan to install.
  2. Browse to the folder where the serverinst command is located in image_location/TWS/interp_name.
  3. 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.
  4. 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.