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

To view an earlier 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.


 To see an example of a basic options.txt file, click here.

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

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

# 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 1.8 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 system administrator credentials
#
# Specify the name of the account that will perform administrative functions,
# such as starting the BMC Digital Workplace Catalog application, configuring
# the application, and preparing the tenant workspace by loading the tenant data.
#
# Example: dwpadmin / Passw0rd!
#
-J BMC_DWP_USER=

-J BMC_DWP_PASSWORD=
-J BMC_DWP_CONFIRM_PASSWORD=


# 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
################################################################################
#
# Database server administrator user credentials
#
# Specify the name of a user account that has full administrative control over
# the database server. If you are installing the application into databases that
# have already been created, specify the same credentials as the
# <BMC_DATABASE_LOGIN> account in the installation options file.
#
# Example: dwp_admin_app / Passw0rd!
#
-J BMC_DATABASE_DBA_LOGIN=

-J BMC_DATABASE_DBA_PASSWORD=


# 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=
-J BMC_DATABASE_CONFIRM_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=

 To see an example of an advanced options.txt file, click here.

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

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

# 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 1.8 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 system administrator credentials
#
# Specify the name of the account that will perform administrative functions,
# such as starting the BMC Digital Workplace Catalog application, configuring
# the application, and preparing the tenant workspace by loading the tenant data.
#
# Example: dwpadmin / Passw0rd!
#
-J BMC_DWP_USER=

-J BMC_DWP_PASSWORD=
-J BMC_DWP_CONFIRM_PASSWORD=


# 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
################################################################################
#
# Database server administrator user credentials
#
# Specify the name of a user account that has full administrative control over
# the database server. If you are installing the application into databases that
# have already been created, specify the same credentials as the
# <BMC_DATABASE_LOGIN> account in the installation options file.
#
# Example: dwp_admin_app / Passw0rd!
#
-J BMC_DATABASE_DBA_LOGIN=

-J BMC_DATABASE_DBA_PASSWORD=


# 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=
-J BMC_DATABASE_CONFIRM_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


# Unused local Distributed Server Option (DSO) password
#
# Create a secure password to lock out the legacy distributed server option
# for server groups. BMC Digital Workplace Catalog does not use this feature.
# The password cannot be longer than eight characters.
#
# Example: P@ssw0rd
#
-J BMC_DWP_DSO_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=


################################################################################
# Additional database settings
################################################################################

# Application database data file name
#
# Specify the name or full path to the BMC Digital Workplace Catalog
# application database file.
#
# Example: dwp_db_app.dbf
#
-J BMC_DATABASE_DBA_DATAFILE_NAME=


# Application database log file name
#
# Specify the name or full path to the BMC Digital Workplace Catalog
# application database log file.
#
# Example: dwp_db_app.log
#
-J BMC_DATABASE_DBA_LOGFILE_NAME=


# Application database overwrite existing data
#
# Specify whether the installer should overwrite the existing data in
# the database, or use the existing data for the installation.
#
# For the following scenarios, do the action indicated:
# - For a fresh installation, leave the comment marker (#).
# - To overwrite data, remove the comment marker (#) and specify
# the value overwrite.
#
# Example: (commented out by default)
#
#-J BMC_DATABASE_OPTION=


# Database server authentication method
#
# BMC Digital Workplace Catalog supports only SQLAUTH.
#
# Example: SQLAUTH
#
-J BMC_SQLSERVER_WINDOWSAUTH_OR_SQLAUTH=SQLAUTH


# Application database data file size
#
# Specify the maximum size of the BMC Digital Workplace Catalog
# application database file.
#
# Example: 2000
#
-J BMC_DATABASE_DBA_DATAFILE_SIZE=2000


# Application database log file size
#
# Specify the maximum size of the BMC Digital Workplace Catalog
# application database log file.
#
# Example: 1000
#
-J BMC_DATABASE_DBA_LOGFILE_SIZE=1000


# Database server character encoding method
#
# Specify whether your database uses UTF character encoding.
# The following values are supported: true | false
#
# Example: true
#
-J BMC_DATABASE_UTF=true


# Database server case sensitivity selection
#
# Specify whether your database is case insensitive.
# The following values are supported:
# - T: The database is case-insensitive.
# - F: The database is case-sensitive.
#
# Example: T
#
-J BMC_DATABASE_CASE_INSENSITIVE=T


################################################################################
# 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


# Parameters to modify local server port settings if required
#
# When installing BMC Digital Workplace Catalog in a server group, these port
# settings might need to be set to unique values on each server to prevent
# conflicts. In most cases, these port settings can remain as their
# default values.
#
# Example: Default settings applied
#
-J BMC_ATRIUM_PLUGIN_PORT_NUMBER=9556
-J BMC_NE_PLUGIN_PORT_NUMBER=9555
-J BMC_DBONLY_UPGRADE_CONFIRM=false


################################################################################
# Options file parameters that should not be changed
################################################################################

# Tenant installation mode selection
#
# By default, multitenancy is enabled.
#
# Example: Default setting applied
#
-J BMC_TENANT_INSTALL_MODE=MULTI


# BMC Digital Workplace Catalog email SMTP server settings
#
# BMC Digital Workplace Catalog can send email notifications to catalog
# administrators for service-related actions such as being submitted for approval,
# published, or rejected. These parameters do not influence the configuration
# of any other system notifications.
#
# Leave these parameters blank to disable the notifications. Otherwise, provide
# valid credentials to an SMTP server. The SMTP server configuration does not
# support SSL encryption.
#
# Example: (empty values)
#
-J BMC_SMTP_ADDRESS=
-J BMC_SMTP_PORT=
-J BMC_SMTP_USER_NAME=
-J BMC_SMTP_PASSWORD=


# Not applicable: Viewing language
#
# BMC Digital Workplace Catalog supports only English.
#
# Example: Default setting applied
#
-J BMC_USER_SELECTED_VIEW_LANGUAGES=en


# Not applicable: Data language
#
# BMC Digital Workplace Catalog supports only English.
#
# Example: Default setting applied
#
-J BMC_USER_SELECTED_DATA_LANGUAGE=en


# Not applicable: Upgrade language locale
#
# BMC Digital Workplace Catalog does not support any language upgrades.
#
# Example: Default setting applied
#
-J BMC_ADD_LOCALE_UPGRADE=false


# Server dependent: Java 32-bit plugin support
#
# Specify whether the 32-bit version of Java is enabled on the
# BMC Digital Workplace Catalog application server.
# The following values are supported:
# - For a 32-bit version, specify true.
# - For a 64-bit version, specify false.
#
# Example: false
#
-J BMC_JAVA_DWP_SERVER_SELECTED_FOR_32BIT=false


# Server dependent: Java 32-bit email server support
#
# Specify whether the 32-bit version of Java is enabled on the
# BMC Digital Workplace Catalog application server.
# The following values are supported:
# - For a 32-bit version, specify true.
# - For a 64-bit version, specify false.
#
# Example: false
#
-J BMC_JAVA_EMAIL_ENGINE_SELECTED_FOR_32BIT=false


# Not applicable: Enable BMC port mapper
#
# BMC Digital Workplace Catalog only communicates through assigned ports
# and does not use the standard BMC port mapper.
#
# Example: Default setting applied
#
-J BMC_PORT_MAPPER_ENABLED=false


# Not applicable: Ignore precheck installation warnings
#
# The installation script monitors the installation and halts if there are
# any errors. You do not need to enable additional precheck error warnings.
#
# Example: Default setting applied
#
-J BMC_IGNORE_PRECHECK_ERROR=true


# Not applicable: Skip startup health check
#
# You do not need to enable the health check.
#
# Example: Default setting applied
#
-J SKIP_HEALTH_CHECK=true


# Not applicable: Load sample data into the server
#
# Sample data is not provided for BMC Digital Workplace Catalog.
#
# Example: Default setting applied
#
-J BMC_DWPSERVER_SAMPLE_DATA=false


# 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. Lisa Greene

    Thanks again, Thad. I appreciate your help! Feel free to send any other feedback you have on the BMC Digital Workplace documentation.

    Jun 21, 2019 07:55