This documentation supports the 19.11 version of BMC Digital Workplace Advanced.

To view the latest version, select the version from the Product Version menu.

BMC Digital Workplace Catalog installation parameter reference


This topic is a reference for every parameter that you might encounter when you install BMC Digital Workplace Catalog. You do not need to provide a value for every parameter when you create an installation options file.


List of all BMC Digital Workplace Catalog installation parameters

The following table lists the parameters and the step in the process when the parameters apply. Use the filter options to search for specific parameters by name, or limit the view to the parameters by their function. For example, select one of the following views by using the dropdown selector:

  • Show parameters that are used for database creation.
  • Show parameters that are used for tenant creation.
  • Show parameters for which you must provide a value in the minimal options file.
  • Show parameters that you can choose to edit in the advanced options file.

To view more details about a specific parameter, click the parameter name.

Oops, it seems that you need to place a table or a macro generating a table within the Table Filter macro.

The table is being loaded. Please wait for a bit ...


Parameter nameDatabase creationTenant creationMinimal options fileAdvanced options file
<BMC_ALLOWED_CROSS_ORIGIN_SOURCES>



X
<BMC_DATABASE_DBA_TABLESPACE_NAME>X XX
<BMC_DATABASE_HOST>X XX
<BMC_DATABASE_INSTANCE>X XX
<BMC_DATABASE_LOGIN>
X XX
<BMC_DATABASE_PASSWORD> X
XX
<BMC_DATABASE_ORACLE_SID_OR_SERVICE>X XX
<BMC_DATABASE_PORT>X XX
<BMC_DATABASE_TYPE>X XX
<BMC_DWP_APPLICATION_PASSWORD>   X
<BMC_DWP_PLUGIN_PORT>   X
<BMC_DWP_PORT>   X
<BMC_DWP_SERVER_HOST_NAME> XXX
<BMC_DWP_SERVER_NAME>  XX
<BMC_JAVA_JRE_64_BIT_HOME_PATH>  XX
<BMC_JAVA_PLUGIN_PORT>   X
<BMC_MIDTIER_PASSWORD>  XX
<BMC_DWP_SERVER_ROLE>

XX
<featureDWPSystemServers>   X
<installLocation>   X

BMC Digital Workplace Catalog installation parameter reference

The following table describes the BMC Digital Workplace Catalog installation parameters and examples.

Oops, it seems that you need to place a table or a macro generating a table within the Table Filter macro.

The table is being loaded. Please wait for a bit ...


Parameter name and descriptionParametersExample value

Application database administrator user credentials

Specify the name of a user account that can create objects inside the application database or tablespace. You must grant this account full administration rights to the database or tablespace named in <BMC_DATABASE_DBA_TABLESPACE>.

 

<BMC_DATABASE_LOGIN>
<BMC_DATABASE_PASSWORD>

 

dwp_admin_app
Passw0rd!

Application database or tablespace name

Specify the name of your SQL Server database or Oracle tablespace where you will store the BMC Digital Workplace Catalog application data.

 

<BMC_DATABASE_DBA_TABLESPACE_NAME>

 

dwp_db_app

Application feature to install

This setting indicates only that BMC Digital Workplace Catalog will be installed.

 

<featureDWPSystemServers>

 

(value is not required)

BMC Digital Workplace Catalog Java plugin port

Specify the port on which the Java plugins on the application server will listen for connections.

 

<BMC_JAVA_PLUGIN_PORT>

 

9999

BMC Digital Workplace Catalog Mid Tier password

Specify an application service password that you can use to grant a Remedy Mid Tier with the ability to configure settings on the BMC Digital Workplace Catalog application server.

 

<BMC_MIDTIER_PASSWORD>

 

!9FviS^#

BMC Digital Workplace Catalog application installation location

Specify the directory in which BMC Digital Workplace Catalog will be installed. The user account that will be used to install the application must be able to create files and folders in this location.

 

<installLocation>

 

/opt/bmc/digitalworkplace

BMC Digital Workplace Catalog application server port

Specify the port on which the application server will listen for connections.

 

<BMC_DWP_PORT>

 

9988

BMC Digital Workplace Catalog plugin port

Specify the port on which the application server will listen for calls to plugins.

 

<BMC_DWP_PLUGIN_PORT>

 

9977

BMC Digital Workplace Catalog server host name

Specify the fully qualified domain name or IP address of the computer on which you are installing BMC Digital Workplace Catalog. A network system administrator can provide the value assigned to this computer in the network DNS configuration.

 

<BMC_DWP_SERVER_HOST_NAME>

 

dwp-catalog-server.domain.com

BMC Digital Workplace Catalog server instance name

Specify the alias name of the computer on which you are installing BMC Digital Workplace Catalog.

 

<BMC_DWP_SERVER_NAME>

 

localhost
dwp-catalog-server

Database reference by SID or service name

(Oracle only) The database server instance name parameter value type, which is represented by one of the following values:

  • true: To refer to the database server by its SID
  • false: To refer to the database server by its service name

 

<BMC_DATABASE_ORACLE_SID_OR_SERVICE>

 

true | false

Database server engine type

Specify the database engine that you will use to store your data.

 

<BMC_DATABASE_TYPE>

 

SQL_SERVER | ORACLE

Database server hostname or IP address

Specify the fully qualified domain name or IP address that can be used to reach the database server over the network.

 

<BMC_DATABASE_HOST>

 

dwpcatalog-db.server.com | 172.22.192.54

Database server instance name

The name of the database engine instance, which can be one of the following values:

  • (SQL Server) database instance name
  • (Oracle) database service name
  • (Oracle) database service ID (SID)
    Note: The Oracle SID cannot be more than eight characters.

 

<BMC_DATABASE_INSTANCE>

 

database_name

Database server port

Specify the port number assigned to the database server.

 

<BMC_DATABASE_PORT>

 

(SQL Server) 1433 | (Oracle) 1521

Oracle JRE or OpenJDK home path

Specify the name of the Java home folder.

Best Practice

We recommend that a user with system root administration permissions installs the latest version of Oracle Java or OpenJDK as described in Preparing a Linux server for BMC Digital Workplace Catalog installation.

<BMC_JAVA_JRE_64_BIT_HOME_PATH>

/usr/java/latest

Unused application service password

Create a secure password to lock out the application service. BMC Digital Workplace Catalog does not use this feature. The password cannot be longer than eight characters.

 

<BMC_DWP_APPLICATION_PASSWORD>

 

P@ssw0rd

Allowed cross origin sources

Provide the URL to the Business Workflow application on the BMC Helix Platform server, from which cross-launch into BMC Digital Workplace Catalog will be seamlessly allowed.

<BMC_ALLOWED_CROSS_ORIGIN_SOURCES> http://innovation-suite-server.domain.com

Was this page helpful? Yes No Submitting... Thank you

Comments

  1. Mohamed Atta

    is this page updated with new version of DWPC 19.11 values?, as the names of databases have been changed in this version

    Feb 10, 2020 10:37
    1. Olha Horbachuk

      Hi Mohamed Atta,

      I am checking this issue. Will circle back to you once I resolve your request.

      Regards,

      Olha

      Feb 21, 2020 03:44
      1. Ravee Panjwani

        Thanks again for your comment, Mohamed Atta. This topic has been updated for the values that are applicable to version 19.11.

        Thanks,
        Ravee

        Feb 26, 2020 09:06