Installing the new master domain manager configured as a backup
About this task
You install a master domain manager at the latest product version level configured as the new backup master domain manager by running the serverinst script. The installation process is able to detect the presence of an existing master domain manager and automatically configures this one as the backup master domain manager. The new backup master domain manager is configured to point to the existing database instance.
The HCL Workload Automation administrator installs the master domain manager as the backup. The following information is required:
Command parameter | Information type | Provided in.. |
Database information | ||
--rdbmstype | database type | Upgrading the database schema for the server components |
--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 | |
WebSphere Application Server Liberty Base information | ||
--wlpdir | WebSphere Application Server Liberty Base installation directory | Installing WebSphere Application Server Liberty |
HCL Workload Automation installation directory | ||
--inst_dir | installation directory | Current procedure |
Security information | ||
--sslkeysfolder | location of converted certificates | Converting default certificates |
--sslpassword | password of converted certificates | Converting default certificates |
For more information about all of the serverinst parameters and default values, see Server components installation - serverinst script.
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 master domain manager as a backup, perform the following steps:
Procedure
- Log in to the workstation where you plan to install the master domain manager.
- Download the installation images from Flexnet or from HCL Software.
-
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 --sslkeysfolder <certificate_files_path> --sslpassword <keystore_truststore_password> --inst_dir <installation_dir> --licenseserverid <license_server_ID>
- 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 --sslkeysfolder <certificate_files_path> --sslpassword <keystore_truststore_password> --inst_dir <installation_dir> --licenseserverid <license_server_ID>
- --acceptlicense
- Specify yes to accept the product license.
- --rdbmstype|-r rdbms_type
- The database type. Supported databases are:
- db2
- oracle
- ids (informix, only on UNIX operating systems)
- onedb
- mssql
- --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 database 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. Special characters are not supported.
- --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 any alphanumeric, dash (-), underscore (_) characters, and ()|?=*~+..
- --wlpdir
- The path where Open Liberty is installed.
- --licenseserverid
- The ID of the license server which processes license usage information. This parameter is required. For more information about enabling your product license, see Enabling product license management. For more information about creating and setting up the license server, see What is the HCL License & Delivery Portal (FlexNet Portal)?
- --sslkeysfolder keystore_truststore_folder
- The name and path of the folder containing certificates in
.PEM format. The installation program
automatically processes the keystore and truststore files using the
password you specify with the --sslpassword
parameter. The folder must contain the following files:
-
- ca.crt
- The Certificate Authority (CA) public certificate. Note that if certificates being installed are part of a chain consisting of 3 or more certificates (one Root CA, followed by one or more Intermediate CAs, followed by the end user certificate), then this file must contain the Root CA certificate only. Any Intermediate CA certificates must be stored in the additionalCAs subfolder, which therefore becomes a mandatory subfolder. Each Intermediate CA must be stored in the additionalCAs subfolder in its own file.
-
- tls.key
- The private key of the end user certificate for the instance to be installed.
-
- tls.crt
- The public part of the previous key, that is the end user certificate.
You can optionally create a subfolder to contain one or more *.crt files to be added to the server truststore as trusted CA, whose name must be additionalCAs. This can be used for example to add to the list of trusted CAs the certificate of the LDAP server or DB2 server. Additionally, you can store here any intermediate CA certificate to be added to the truststore. The subfolder must be named additionalCAs. Note that if the end user certificate being installed in the instance is part of a chain consisting of 3 or more certificates (one Root CA, followed by one or more Intermediate CAs, followed by the end user certificate), then the Intermediate CAs certificates must be stored in the additionalCAs subfolder, which therefore becomes a mandatory subfolder. Each Intermediate CA must be stored in the additionalCAs subfolder in its own file.
-
- --sslpassword ssl_password
- You can use this parameter to define the password for
either default or custom certificates, as follows:
- If you want HCL Workload Automation to generate default certificates, provide the password to be used for the default certificates. HCL Workload Automation generates the certificates and stores them on the master domain manager in the installation_directory/defaultCerts and TWA_DATA_DIR/ssl/depot directories. You can then use the TWA_DATA_DIR/ssl/depot to retrieve the default certificates for the other product components.
- If you want HCL Workload Automation to process custom certificates, provide the password for the custom certificates and the path to the folder containing certificates in .PEM format with the sslkeysfolder parameter. To process custom certificates, the sslkeysfolder parameter is required.
For more information, see sslkeysfolder.
You can optionally encrypt the password using the secure script. For more information, see Optional password encryption - secure script. - --inst_dir installation_dir
- The directory of the HCL Workload Automation installation.
- --licenseserverid license_server_ID
- The ID of the license server which processes license usage information. This parameter is required. Instructions about how to obtain the ID of the license server which processes license usage information are provided with the mail confirming your license. For more information, see License computation model and Enabling product license management
Note: The values for the following parameters must match the values you provided when creating and populating the database:- --rdbmstype
- --dbhostname
- --dbport
- --dbname
- --dbuser
- --dbpassword
Note: Before starting the deployment of a new master domain manager or backup master domain manager on an already used database, be sure that no failed plan creation/extension has been performed. If a failed plan creation/extension has been performed, resolve the failure before attempting the new deployment or unlock the database by running the planman unlock db command.
Results
You have now successfully installed the master domain manager as the backup master domain manager.