Limited support This version of the product is in limited support. However, the documentation is available for your convenience. You will not be able to leave comments. Click here to view the documentation for the current version.

Creating a BMC Digital Workplace Catalog installation options file


Before you can install BMC Digital Workplace Catalog, you must create a text file that provides the required information about the Linux server and database server for the installation.

Before you begin

Collect the information about the Linux server and database server on the Installation-worksheets-for-BMC-Digital-Workplace-Catalog.

Extract the installation archive files as described in Extracting-the-downloaded-archive.

Providing options for the installation

To install BMC Digital Workplace Catalog, you must provide the details about the Linux server and database server that you collected in the Installation-worksheets-for-BMC-Digital-Workplace-Catalog. After you extract the files from the installation package, you can edit the options.txt file from the package. The second file, advanced-options.txt, contains the required options in the options.txt file as well as additional options for you to customize the installation.

Note

If you are editing the options files on a Windows computer, use a text editor that supports UNIX line endings.

To edit the installation options file

You can choose to edit the options.txt file directly on the Linux server where you will install BMC Digital Workplace Catalog. The following steps show another approach where you create the installation options file on your local machine to upload to the Linux server afterward.

  1. Download the options.txt file to a local machine, and rename it.
    Exampledwpoptions_server01.txt
  2. In a text editor, edit the files to update the settings based on the values in the installation worksheets.
  3. (Optional) If you are installing into a cluster, create a different file for each server to identify the server to be installed. Provide values for the following parameters that are specific to each server.

    Parameter name and description

    Parameter to add in the options file

    Examples

    BMC Digital Workplace Catalog server instance name

    When installing on to servers in a cluster, specify the name of the cluster alias as the <BMC_DWP_SERVER_NAME> parameter.

    Note: The alias can be any valid name, but the same name must be used for all servers in the cluster.

    For more information about aliases, see Understanding server group naming.

    -J BMC_DWP_SERVER_NAME=
    {{code language="none"}}
    dwp-catalog-ha-server-group
    {{/code}}

    BMC Digital Workplace Catalog server host name

    When installing on to servers in a cluster, specify the fully qualified domain name of specific primary or secondary as the <BMC_DWP_SERVER_HOST_NAME> parameter.

    -J BMC_DWP_SERVER_HOST_NAME=
    {{code language="none"}}
    dwp-catalog-ha-server-01.domain.com
    {{/code}}

    Application database overwrite existing data

    When installing on to secondary servers in a cluster, add the the <{{code language="none"}}
    BMC_DATABASE_OPTION
    {{/code}}
    >
    parameter with an empty value.

    -J BMC_DATABASE_OPTION=

    (empty value)

To customize the installation options file

If you need to customize server or port settings to accommodate your environment, copy only the required fields from the  advanced-options.txt file. You do not need to edit the advanced-options.txt file directly

For a detailed reference about the installation parameters, see BMC-Digital-Workplace-Catalog-installation-parameter-reference.

Parameter prefix descriptions

An installation options file contains parameters prefaced by -P-J, and -A, which are explained in the following table:

Where to go from here

When you have completed the installation options file, you are ready to install BMC Digital Workplace Catalog. Upload the installation options file to the appropriate server into a folder in a location that is available to the installation script, and proceed to the next task.

Running-the-BMC-Digital-Workplace-Catalog-installer

 

Tip: For faster searching, add an asterisk to the end of your partial query. Example: cert*