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.

Example options.txt files

The options.txt file contains the required parameter options that you must supply before you can run the installation script from the command line. For examples of the configuration options that you can configure, click the following links.


################################################################################
# BMC Digital Workplace Catalog with Microsoft SQL Server or ORACLE database
#
# Minimal installation settings
#
################################################################################

################################################################################
# Minimal installation settings
################################################################################

# BMC Digital Workplace Server Role
#
# Supported values:
# - master: single instance server or primary node (Default if not specified)
# - slave: for each secondary server in the cluster.
#
-J BMC_DWP_SERVER_ROLE=master

# Oracle JRE home path
#
# Specify the name of the Java home folder.
# Best practice: BMC recommends that a user with system root administration
# permissions installs the latest version of Oracle Java 11 as shown
# in Preparing a Linux server for a BMC Digital Workplace Catalog installation.
#
# Example: /usr/java/latest
#
-J BMC_JAVA_JRE_64_BIT_HOME_PATH=


# 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.
#
# Example: Passw0rd!
#
-J BMC_MIDTIER_PASSWORD=


# BMC Digital Workplace Catalog server instance name
#
# Specify the alias name of the computer on which you are installing
# BMC Digital Workplace Catalog. A user with system root administration
# permissions would have assigned a name and included this value in the
# /etc/hosts when provisioning this server.
#
# Example: dwp-catalog-server
#
-J BMC_DWP_SERVER_NAME=


# 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.
#
# Example: dwp-catalog-server.domain.com
#
-J BMC_DWP_SERVER_HOST_NAME=


################################################################################
# Database server options
################################################################################
#
# 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>.
#
# Example:
# -J BMC_DATABASE_LOGIN=dwp_admin_app
# -J BMC_DATABASE_PASSWORD=Passw0rd!
#
-J BMC_DATABASE_LOGIN=

-J BMC_DATABASE_PASSWORD=


# Database server engine type
#
# Specify the database engine that you will use to store your data.
#
# Supported Values:
# - SQL_SERVER
# - ORACLE
#
-J BMC_DATABASE_TYPE=


# 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.
#
# Example: dwpcatalog-db.server.com | 172.22.192.54
#
-J BMC_DATABASE_HOST=


# Database server port
#
# Specify the port number assigned to the database server.
#
# Example: (SQL Server) 1433 | (Oracle) 1521
#
-J BMC_DATABASE_PORT=


# 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: An Oracle SID cannot be more than eight characters.
#
# Example: database_name
#
-J BMC_DATABASE_INSTANCE=


# 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
#
# Supported Values:
# - true
# - false
#
-J BMC_DATABASE_ORACLE_SID_OR_SERVICE=true


# 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.
#
# Example: dwp_db_app
#
-J BMC_DATABASE_DBA_TABLESPACE_NAME=

################################################################################
# BMC Digital Workplace Catalog with Microsoft SQL Server or ORACLE database
#
# All installation settings (advanced options)
#
################################################################################

################################################################################
# Minimal installation settings
################################################################################

# Supported values:
# - master: single instance server or primary node (Default if not specified)
# - slave: for each secondary server in the cluster.
#
-J BMC_DWP_SERVER_ROLE=master

# Oracle JRE home path
#
# Specify the name of the Java home folder.
# Best practice: BMC recommends that a user with system root administration
# permissions installs the latest version of Oracle Java 11 as shown
# in Preparing a Linux server for a BMC Digital Workplace Catalog installation.
#
# Example: /usr/java/latest
#
-J BMC_JAVA_JRE_64_BIT_HOME_PATH=


# 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.
#
# Example: Passw0rd!
#
-J BMC_MIDTIER_PASSWORD=


# BMC Digital Workplace Catalog server instance name
#
# Specify the alias name of the computer on which you are installing
# BMC Digital Workplace Catalog. A user with system root administration
# permissions would have assigned a name and included this value in the
# /etc/hosts when provisioning this server.
#
# Example: dwp-catalog-server
#
-J BMC_DWP_SERVER_NAME=


# 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.
#
# Example: dwp-catalog-server.domain.com
#
-J BMC_DWP_SERVER_HOST_NAME=


# 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>.
#
# Example: dwp_admin_app / Passw0rd!
#
-J BMC_DATABASE_LOGIN=

-J BMC_DATABASE_PASSWORD=


# Database server engine type
#
# Specify the database engine that you will use to store your data.
#
# Example: SQL_SERVER | ORACLE
#
-J BMC_DATABASE_TYPE=


# 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.
#
# Example: dwpcatalog-db.server.com | 172.22.192.54
#
-J BMC_DATABASE_HOST=


# Database server port
#
# Specify the port number assigned to the database server.
#
# Example: (SQL Server) 1433 | (Oracle) 1521
#
-J BMC_DATABASE_PORT=


# 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: An Oracle SID cannot be more than eight characters.
#
# Example: database_name
#
-J BMC_DATABASE_INSTANCE=


# 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
#
# Example: true | false
#
-J BMC_DATABASE_ORACLE_SID_OR_SERVICE=true


# 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.
#
# Example: dwp_db_app
#
-J BMC_DATABASE_DBA_TABLESPACE_NAME=


################################################################################
# Additional parameters for customizing the installation
################################################################################

################################################################################
# Additional server and security settings
################################################################################

# 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.
#
# Example: /opt/bmc/digitalworkplace
#
-P installLocation=/opt/bmc/digitalworkplace


# 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.
#
# Example: P@ssw0rd
#
-J BMC_DWP_APPLICATION_PASSWORD=P@ssw0rd

# Allowed cross-origin sources
#
# Provide the URL to the Business Workflow application on the Innovation Suite
# server, from which cross-launch into Digital Workplace Catalog will be
# seamlessly allowed.
#
# Example: http://innovation-suite-server.domain.com/
#
-J BMC_ALLOWED_CROSS_ORIGIN_SOURCES=

################################################################################
# Server local communication port settings
################################################################################

# BMC Digital Workplace Catalog application server port
#
# Specify the port on which the application server will listen for connections.
#
# Example: 9988
#
-J BMC_DWP_PORT=9988


# BMC Digital Workplace Catalog plugin port
#
# Specify the port on which the application server will listen for calls to plugins.
#
# Example: 9977
#
-J BMC_DWP_PLUGIN_PORT=9977


# BMC Digital Workplace Catalog Java plugin port
#
# Specify the port on which the Java plugins on the application server will
# listen for connections.
#
# Example: 9999
#
-J BMC_JAVA_PLUGIN_PORT=9999

# Application feature to install
#
# This setting indicates only that BMC Digital Workplace Catalog shall be installed.
#
# Example: (value is not required)
#
-A featureDWPSystemServers

Where to go from here

Running the BMC Digital Workplace Catalog installer

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

Comments

  1. Jan Hartung

    The sample options files suggest that it is possible to configure the Mid-Tier administration password using the setting -J BMC_MIDTIER_PASSWORD. However, since administrators are required to use the database dump file provided by BMC for the installation, the Mid-Tier administration password will always be !9FviS^# - no matter what was set for BMC_MIDTIER_PASSWORD. The options files should be updated accordingly.

    Jul 17, 2020 05:22
    1. Ravee Panjwani

      Thanks for your comment, Jan. I am updating the options file for this version.

      Thanks, Ravee

      Jul 22, 2020 12:39
  2. Abhishek Verma

    in 19.08 we have to mention dwp user name and password, but in 20.02 no such parameters were defined in the option.txt file.

    What will the default dwp username and password to start the dwpcontroller services.

    Oct 22, 2020 06:16
    1. Ravee Panjwani

      Thanks for your comment, Abhishek.

      That is correct, we have an updated list of required parameters for 20.02 here → BMC Digital Workplace Catalog installation parameter reference.

      Thanks,
      Ravee

      Nov 13, 2020 02:47