Space banner

 

This documentation supports the 20.02 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 JDK 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 JDK 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. Uwe Reimers

    The BMC_MIDTIER_PASSWORD is mentioned to be set in the minimal Options file - but it is not used during installation of Version 20.02. The Default Password is used instead.

    Aug 06, 2020 02:46
    1. Ravee Panjwani

      You are right, the default password (!9FviS^# ) documented on this topic is used.

      Sep 30, 2020 06:16