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.

System requirements

Creating a BMC Digital Workplace Catalog installation options file

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 description	Parameter placeholder	Examples	Assigned value
Tenant organization domain name	`<TENANT_DOMAIN_NAME>`	`calbroservices.com`
Server license number based on Linux server MAC address	`(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.

Parameter name	Parameter placeholder used in examples	Examples
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`
Database server administrator user credentials	`<BMC_DATABASE_DBA_PASSWORD>`	`Passw0rd!`
Application database administrator user credentials	`<BMC_DATABASE_LOGIN>`	`dwp_admin_app`
Application database administrator user credentials	`<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`
Tenant database administrator user credentials	`<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 Configuring BMC Digital Workplace Catalog for high availability.

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

Preparing a Linux server for BMC Digital Workplace Catalog installation

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

Parameter name	Parameter placeholder used in examples	Examples
Oracle JDK or OpenJDK 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 name Parameter placeholder used in examples Examples Assigned value

BMC Digital Workplace Catalog server instance name

When installing on 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 servers in a server group, specify the fully qualified domain name of the specific primary or secondary server 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 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.

Parameter name	Parameter placeholder	Examples
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 following values.

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

Parameter name and description	Parameter placeholder	Examples
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

Installation worksheets for BMC Digital Workplace Catalog

BMC Digital Workplace Catalog installation tenant organization parameters

Database server and data storage creation parameters

BMC Digital Workplace Catalog required server parameters

BMC Digital Workplace Catalog high availability server parameters

BMC Digital Workplace Catalog custom installation parameters

BMC Digital Workplace Catalog default installation parameters

Where to go from here

Comments