Installing and configuring Common Interface Server
To install and configure CIS
Start the Installation System as described in Starting an installation.
- Select a product that uses CIS. For a complete list of products, that use CIS, see Products that use the infrastructure components.
Generate the installation jobs as described in Generating installation jobs.
Generate the configuration jobs for the infrastructure components as described in Configuring Common Interface Server options.
Run the generated jobs as described in Running the generated jobs.
- Make sure that you complete all the generated jobs for CIS. The full list of generated jobs is in your JCL library.
- After installation, if additional customization is required, update the CIS environment variable values in the CISERVER and CISCMNEV members of the &INSTALLHLQ.UBMCSAMP data set. For more details, see the variables listed in the following table.
CIS environment variables
Environment variable | Default value | Description | Which member uses this | Where it is specified |
|---|---|---|---|---|
JAVA_HOME | /usr/lpp/java/J17.0 | Path for a 64-bit Java17 home directory on the installed host | CISERVER | UBMCSAMP |
CIS_INSTALL_PATH | /u/CIS | Root path for a CIS directory You must specify a unique path for a CIS installation. Important: Make sure the CIS users have the Read, Write, and Execute permissions to the CIS_INSTALL_PATH directory | CISERVER | UBMCSAMP |
SDSF_HOME | /usr/lpp/sdsf/java/ | Path for SDSF classes and APF-authorized libraries | CISCMNEV | UBMCSAMP |
CIS_PORT | 15566 | CIS port number | CISCMNEV | UBMCSAMP |
CIS_SSL_ENABLE | Yes | Set as Yes if you are using the SSL connection. We recommend using an SSL (HTTPS) connection because running CIS with HTTP might cause a security vulnerability. | CISCMNEV | UBMCSAMP |
CIS _KEYSTORE_TYPE | BLANK (default blank valid) | If the CIS_SSL_ENABLE parameter value is set to Yes, enter the keystore type. Valid values are:
| CISCMNEV | UBMCSAMP |
CIS_KEYSTORE_PASSWORD | BLANK (default blank valid) | If the CIS_SSL_ENABLE parameter value is set to Yes, enter a password to be used to protect the integrity of the keystore. | CISCMNEV | UBMCSAMP |
CIS _KEYSTORE_NAME | BLANK (default blank valid) | If the CIS_SSL_ENABLE parameter value is set to Yes, enter the keystore name. | CISCMNEV | UBMCSAMP |
CIS _KEYSTORE_ALIAS | BLANK (default blank valid) | Specify an alias value for a single data key (Certificate Label Name). | CISCMNEV | UBMCSAMP |
CIS_CLIENT_AUTH | none | Specify one of the following values for client certificate authorization:
Enter need if a client certificate is required. | CISCMNEV | UBMCSAMP |
CIS_TRUSTSTORE_TYPE | BLANK (default blank valid) | Set this parameter value if the CIS_CLIENT_AUTH value is need. Enter the truststore type. Valid values are:
| CISCMNEV | UBMCSAMP |
CIS_TRUSTSTORE_NAME | BLANK (default blank valid) | Truststore name Set this parameter value if the CIS_CLIENT_AUTH value is need. | CISCMNEV | UBMCSAMP |
CIS_TRUSTSTORE_PASSWORD | BLANK (default blank valid) | Truststore password Set this parameter value if the CIS_CLIENT_AUTH value is need. Specify the truststore password to protect the integrity of the truststore. | CISCMNEV | UBMCSAMP |