This documentation supports the 18.05 version of BMC Digital Workplace. To view the latest version, select the version from the Product version menu.

Installation worksheets for BMC Digital Workplace Catalog

During the installation of BMC Digital Workplace Catalog, you will assign names to servers, databases, and user accounts. Before you start installing or upgrading, review the installation configuration options and values in the tables in this topic, and select names that align with your IT policies. You will use the values from these worksheets in your installation options text file, tenant creation text file, and BMC Digital Workplace Catalog server configuration tasks.

Follow your organization's IT policies and standards for assigning names to Linux server host names, database server credentials, and user account credentials in the following worksheets.

For a description of the parameter placeholders in the following tables, see BMC Digital Workplace Catalog installation parameter reference

Tip

In the Tools menu, select Export to Word to create a planning worksheet from this page for recording your decisions in the Assigned value column.

BMC Digital Workplace Catalog installation tenant organization parameters

You must specify a tenant domain name and obtain a license key for the Linux server on which BMC Digital Workplace Catalog will be installed.

Parameter name and descriptionParameter placeholderExamplesAssigned value

Tenant organization domain name

<TENANT_DOMAIN_NAME>

calbroservices.com


Server license number based on Linux server MAC address

If you are installing into a server group for high availability, you must obtain a different license key for each server.

See Obtaining BMC Remedy license keys

(None)

ABC-123456


Database server and data storage creation parameters

Complete the following worksheet to collect the information about the databases or tablespaces that will be used for the installation. A database administrator can provide the values that were used for preparing the database server as shown in the following topics.

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 nameParameter placeholder used in examplesExamplesAssigned value

Database server engine type

<BMC_DATABASE_TYPE>

SQL_SERVER | ORACLE


Database server instance name

<BMC_DATABASE_INSTANCE>

database_name


Database reference by SID or service name

<BMC_DATABASE_ORACLE_SID_OR_SERVICE>

true | false


Database server hostname or IP address

<BMC_DATABASE_HOST>

dwpcatalog-db.server.com | 172.22.192.54


Database server port

<BMC_DATABASE_PORT>

(SQL Server) 1433 | (Oracle) 1521


Application database or tablespace name

<BMC_DATABASE_DBA_TABLESPACE_NAME>

dwp_db_app


Database server administrator user credentials

<BMC_DATABASE_DBA_LOGIN>

dwp_admin_app


<BMC_DATABASE_DBA_PASSWORD>

Passw0rd!


Application database administrator user credentials

<BMC_DATABASE_LOGIN>

dwp_admin_app


<BMC_DATABASE_PASSWORD> / <BMC_DATABASE_CONFIRM_PASSWORD>

Passw0rd! / Passw0rd!


Tenant database or tablespace name

<BMC_DATABASE_TENANT_TABLESPACE>

dwp_db_tenant


Tenant database administrator user credentials

<BMC_DATABASE_TENANT_USER>

dwp_admin_tenant


<BMC_DATABASE_TENANT_PASSWORD>

Passw0rd!


Database temporary tablespace name

<BMC_TEMP_TABLESPACE>

dwp_db_temp


Database server privilege role

<BMC_DATABASE_ADMIN_ROLE>

dwp_dbadmin_role


Application database data file name

<BMC_DATABASE_DBA_DATAFILE_NAME>

dwp_db_app.dbf


Application database log file name

<BMC_DATABASE_DBA_LOGFILE_NAME>

dwp_db_app.log


BMC Digital Workplace Catalog required server parameters

Complete the following worksheet to collect the parameter values to install BMC Digital Workplace Catalog as a single application instance. If you are installing into a server group for high availability, see the notes about the server name parameters in BMC Digital Workplace Catalog high availability server parameters.

A Linux server administrator can provide some of the values used when preparing the Linux server, as shown in the following topic.


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 nameParameter placeholder used in examplesExamplesAssigned value

Oracle JRE home path

<BMC_JAVA_JRE_64_BIT_HOME_PATH>

/usr/java/latest


BMC Digital Workplace Catalog system administrator credentials

<BMC_DWP_USER>

dwpadmin


<BMC_DWP_PASSWORD> / <BMC_DWP_CONFIRM_PASSWORD>

Passw0rd! / Passw0rd!


BMC Digital Workplace Catalog Mid Tier password

<BMC_MIDTIER_PASSWORD>

Passw0rd!


BMC Digital Workplace Catalog server instance name

<BMC_DWP_SERVER_NAME>

dwp-catalog-server


BMC Digital Workplace Catalog server host name

<BMC_DWP_SERVER_HOST_NAME>

dwp-catalog-server.domain.com


BMC Digital Workplace Catalog high availability server parameters

When you install BMC Digital Workplace Catalog on multiple servers in a server group for high availability, use the information from the preceding table when installing each of the servers in the server group. However, change the values for the server-specific parameters shown in the following table to the values that are required for the secondary server.

You must also add an additional parameter to the installation options file that is used on the secondary server.

Parameter nameParameter placeholder used in examplesExamplesAssigned value

BMC Digital Workplace Catalog server instance name

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

<BMC_DWP_SERVER_NAME>

dwp-catalog-ha-server-group


BMC Digital Workplace Catalog server host name

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

<BMC_DWP_SERVER_HOST_NAME>

dwp-catalog-ha-server-02.domain.com


Application database overwrite existing data

When installing on to secondary servers in a server group, add the the <BMC_DATABASE_OPTION> parameter with an empty value.

<BMC_DATABASE_OPTION>

(empty value)


BMC Digital Workplace Catalog custom installation parameters

 To customize the installation, you can specify a different installation folder or port assignments.

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 nameParameter placeholderExamplesAssigned value

BMC Digital Workplace Catalog application installation location

<installLocation>

/opt/bmc/digitalworkplace


Unused application service password

<BMC_DWP_APPLICATION_PASSWORD>

P@ssw0rd


Unused local Distributed Server Option (DSO) password

<BMC_DWP_DSO_PASSWORD>

P@ssw0rd


BMC Digital Workplace Catalog application server port

<BMC_DWP_PORT>

9988


BMC Digital Workplace Catalog plugin port

<BMC_DWP_PLUGIN_PORT>

9977


BMC Digital Workplace Catalog Java plugin port

<BMC_JAVA_PLUGIN_PORT>

9999


Parameters to modify local server port settings if required

<BMC_ATRIUM_PLUGIN_PORT_NUMBER>

9556


<BMC_NE_PLUGIN_PORT_NUMBER>

9555


<BMC_DBONLY_UPGRADE_CONFIRM>

false


BMC Digital Workplace Catalog email SMTP server settings

<BMC_SMTP_ADDRESS>
<BMC_SMTP_PORT>
<BMC_SMTP_USER_NAME>
<BMC_SMTP_PASSWORD>

(empty value)


BMC Digital Workplace Catalog default installation parameters

BMC Digital Workplace Catalog uses default values for these parameters, so you do not need to change the values.

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 descriptionParameter placeholderExamplesAssigned value

Application database overwrite existing data

<BMC_DATABASE_OPTION>

(commented out by default)


Database server authentication method

<BMC_SQLSERVER_WINDOWSAUTH_OR_SQLAUTH>

SQLAUTH


Database server character encoding method

<BMC_DATABASE_UTF>

true


Database server case sensitivity selection

<BMC_DATABASE_CASE_INSENSITIVE>

T


Tenant installation mode selection

<BMC_TENANT_INSTALL_MODE>

MULTI


Not applicable: Viewing language

<BMC_USER_SELECTED_VIEW_LANGUAGES>

en


Not applicable: Data language

<BMC_USER_SELECTED_DATA_LANGUAGE>

en


Not applicable: Upgrade language locale

<BMC_ADD_LOCALE_UPGRADE>

false


Server dependent: Java 32-bit plugin support

<BMC_JAVA_DWP_SERVER_SELECTED_FOR_32BIT>

false


Server dependent: Java 32-bit email server support

<BMC_JAVA_EMAIL_ENGINE_SELECTED_FOR_32BIT>

false


Not applicable: Enable BMC port mapper

<BMC_JAVA_DWP_SERVER_SELECTED_FOR_32BIT>

false


Not applicable: Ignore precheck installation warnings

<BMC_IGNORE_PRECHECK_ERROR>

true


Not applicable: Skip startup health check

<SKIP_HEALTH_CHECK>

true


Not applicable: Load sample data into the server

<BMC_DWPSERVER_SAMPLE_DATA>

false


Application feature to install

<featureDWPSystemServers>

(does not accept any value)


Where to go from here

Downloading the BMC Digital Workplace Catalog installation files

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

Comments