Creating and populating the database for PostgreSQL for the master domain manager
Instructions for creating and populating the HCL Workload Automation database for PostgreSQL for the master domain manager
Before you begin
- Create the PostgreSQL database and ensure it is configured to allow remote connections.
- Create a user dedicated specifically to the new database schema and do not use the administrator user (postgres) for this purpose.
About this task
You can perform a typical database procedure, as described in the following scenarios, or you can customize the database parameters, as described in FAQ - Database customizations.
For more information about all parameters and supported values of the configureDb command, see Database configuration - configureDb script.
You can optionally configure PostgreSQL in SSL mode on UNIX operating systems by specifying the sslkeysfolder and sslpassword parameters when you run the configureDb command. For more information, see How can I use certificates when Db2 or PostgreSQL is in SSL mode?
You can run the configureDb command specifying a typical set of parameters. In this case, default values are used for all remaining parameters.
Default values are stored in the configureDbPostgresql.properties file, located in image_location. If you need to modify any of the default values, edit the configureDbPostgresql.properties file, but do not modify the configureDbPostgresql.template file located in the same path. For an example of a properties file, see What is the content of a database properties file?.
If you need to modify any of the default values, edit the configureDbPostgresql.properties file, but do not modify the configureDbPostgresql.template file located in the same path.
To create and populate the HCL Workload Automation database and tables, perform the following steps:
Procedure
- On the workstation where you plan to install the master domain manager, extract the HCL Workload Automation package to a directory of your choice.
- Browse to the path image_location/TWS/interp_name.
-
Type the following command to create and populate the HCL Workload Automation database
tables with typical settings:
On Windows operating systems
-
cscript configureDb.vbs --rdbmstype POSTGRESQL --dbhostname DB_hostname --dbport db_port --dbname db_name --dbuser db_user --dbadminuser DB_administrator --dbadminuserpw DB_administrator_password
On UNIX operating systems
-
./configureDb.sh --rdbmstype POSTGRESQL --dbhostname DB_hostname --dbport db_port --dbname db_name --dbuser db_user --dbadminuser DB_administrator --dbadminuserpw DB_administrator_password
- --rdbmstype
- The database vendor.
- --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 you must create before running the
configureDb
command. - --dbadminuser db_admin_user
- The database administrator user that creates the HCL Workload Automation schema objects on the database server.
- --dbadminuserpw db_admin_password
- The password of the DB administrator user that creates the HCL Workload Automation schema objects on the database server. Special characters are not supported.
Note: The following parameters are also required when installing the master components and their values must be the same:- --rdbmstype
- --dbhostname
- --dbport
- --dbname
- --dbuser
Results
You have now successfully created and populated the HCL Workload Automation database.
What to do next
You can now proceed to Creating and populating the database for PostgreSQL for the Dynamic Workload Console.