Installing the Dynamic Workload Console

Procedure for installing two Dynamic Workload Console servers on two separate nodes.

Figure 1. Install fresh Dynamic Workload Console
The procedure to perform a fresh installation is demonstrated through a typical scenario where two Dynamic Workload Console servers are installed on separate workstations, sharing the same remote database.

From Version 9.5, the Dynamic Workload Console is based on a new architectural foundation that does not include Jazz for Service Management nor Dashboard Application Services Hub, therefore no direct upgrade procedure is supported, but you perform a fresh installation of the Dynamic Workload Console at version 9.5.x or 10.1.x to 10.2.x.

Note: If you are installing the Dynamic Workload Console version 10.2.3 or later, the Federator is also automatically installed. This component enables you to monitor your objects through the Orchestration Monitor page of the Dynamic Workload Console. For detailed information about how to configure and use the Federator, see Mirroring the z/OS current plan to enable the Orchestration Monitor.

If you are currently using Derby, you need to install a supported database and migrate your data. This is necessary because Derby is no longer supported as of version 10.2.3. For more information, see Connecting the Dynamic Workload Console to a new node or database.

In this scenario, the IBM® Workload Scheduler administrator installs two Dynamic Workload Console instances on two separate workstations, sharing the same remote database. The IBM Workload Scheduler administrator performs the operations listed below on both workstations.

Certificates are now required when installing or upgrading IBM Workload Scheduler. You can no longer install nor upgrade IBM Workload Scheduler without securing your environment with certificates. The required certificates are:
  • ca.crt
  • tls.key
  • tls.crt
For UNIX systems, ensure that all the files have the ownership of the user who installed the master domain manager and the correct permissions (644).

Convert the certificates as described in Converting default certificates and copy them locally.

The IBM Workload Scheduler administrator installs the Dynamic Workload Console. The following information is required:
Table 1. Required information
Command parameter Required information Provided in..
Database information
--rdbmstype database type Creating and populating the database for the Dynamic Workload Console
--dbhostname database hostname
--dbport database port
--dbname database name
--dbuser database user name
--dbpassword database password
WebSphere Application Server Liberty Base information
--wlpdir WebSphere Application Server Liberty Base installation directory Installing WebSphere Application Server Liberty Base
Security information
--sslkesfolder location of converted certificates Converting default certificates
--sslpassword password of converted certificates Converting default certificates

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

Default values are stored in the dwcinst.properties file, located in the root directory of the installation image.

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

In a typical installation scenario, it is recommended you install the Dynamic Workload Console as a non-root user on UNIX systems and as a local administrator on Windows systems.

This user is automatically created by the installation process in the WebSphere Application Server Liberty Base repository. Ensure that the user has full access to the WebSphere Application Server Liberty Base installation directory.

To install the Dynamic Workload Console, perform the following steps:

  1. Log in to the workstation where you plan to install the Dynamic Workload Console.
  2. Download the installation images from IBM Fix Central.
  3. Browse to the folder where the dwcinst command is located in image_location/TWS/interp_name.
  4. Start the installation specifying a typical set of parameters:
    On Windows operating systems
    cscript dwcinst.vbs --acceptlicense yes --rdbmstype db_type
--user dwc_admin_user --password dwc_pwd --dbname db_name
--dbuser db_user --dbpassword db_pwd --dbhostname db_hostname
--dbport db_port --wlpdir Liberty_installation_dir\wlp
--sslkeysfolder certificate_files_path --sslpassword keystore_truststore_password
    On UNIX operating systems
    ./dwcinst.sh --acceptlicense yes --rdbmstype db_type
--user dwc_admin_user --password dwc_pwd --dbname db_name
--dbuser db_user --dbpassword db_pwd --dbhostname db_hostname
--dbport db_port --wlpdir Liberty_installation_dir/wlp
--sslkeysfolder certificate_files_path --sslpassword keystore_truststore_password
    where,
    user dwc_admin_user
    is the administrator of the Dynamic Workload Console. This user is added to the group of the Dynamic Workload Console administrators at installation time. You can use this account to log in to the Dynamic Workload Console and manage your environment.
    password dwc_pwd
    is the password of the Dynamic Workload Console user.
    On UNIX operating systems
    Supported characters for the password are as follows:
    • Uppercase letters: A–Z
    • Lowercase letters: a–z
    • Digits: 0–9
    • Underscore (_)
    • Space ( )
    • Parentheses ( ( and ) )
    • Pipe (|)
    • Question mark (?)
    • Tilde (~)
    • Plus sign (+)
    • Dash (-)
    • Period (.)
    • At symbol (@)
    • Exclamation mark (!)
    • Caret (^)
    • Asterisk (*)
    • Equals sign (=)
    On Windows operating systems
    Supported characters for the password are as follows:
    • Uppercase letters (A–Z)
    • Lowercase letters (a–z)
    • Digits (0–9)
    • Underscore (_)
    • Space ( )
    • Parentheses ( ( and ) )
    • Pipe (|)
    • Question mark (?)
    • Tilde (~)
    • Plus sign (+)
    • Dash (-)
    • Period (.)
    • At symbol (@)
    • Exclamation mark (!)
    • Caret (^)
    • Asterisk (*)
You have now successfully installed the Dynamic Workload Console.

For more information about all dwcinst parameters and default values, see Dynamic Workload Console installation - dwcinst script.

If you had previously exported the Dynamic Workload Console, as described in Connecting the Dynamic Workload Console to a new node or database, you can now import them in the new Dynamic Workload Console from the Administration > Manage Settings menu. If you have a high availability configuration, import the settings on one node.

You can now proceed to Creating the IBM Workload Scheduler administrative user.