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

BMC Digital Workplace Advanced 18.02 ... Installing Installing BMC Digital Workplace Catalog Preparing for installation of BMC Digital Workplace Catalog

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.

Related topics

Installation process overview for BMC Digital Workplace Catalog

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

Start adding filters for your table either in the macro settings or on the filtration pane.

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>

wp_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.


Start adding filters for your table either in the macro settings or on the filtration pane.

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.

Start adding filters for your table either in the macro settings or on the filtration pane.

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.

Start adding filters for your table either in the macro settings or on the filtration pane.

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
Last modified by Tashfeen Mahmud on Nov 19, 2018
installation reference worksheets planning preinstallation

Comments

  1. Stefan Telley

    Be carefully with the Database Instance Name . This Parameter will work for the DWP Part of the Installer, but it will not be set in the ar.cfg for the underlaying ARServer. The Silent Installer for the arserver thinks pre default, that the Instance Name of a MS SQL Database is always the same as the Servername... which is correct if you install MS SQL the Default way.

    As soon as you have a constellation like this: -J BMC_DATABASE_HOST=DatabaseServer -J BMC_DATABASE_INSTANCE=DatabaseInstanceName

    means where Instance Name differ from Servername, you have to take care of it. Our solution was to set an entry in the Hostsfile, where the InstanceName Target is the same as the Servername Target...

    After the Installation we modified the ar.conf to set the correct value..

    Apr 02, 2019 02:25
    1. Ievgeniia Afinogenova

      Stefan, thank you for your comment.

      We execute installations on a Named SQL instance, where BMC_DATABASE_HOST and BMC_DATABASE_INSTANCE has different values, and the installer automatically takes care of updating the ar.conf with the correct value. 

      The example below shows the values set in the options file:
       
      -J BMC_DATABASE_HOST=clm-aus-022027.bmc.com
      -J BMC_DATABASE_INSTANCE=clm-aus-022027\\SS_QAINSTANCE
       
      After installation, the value in ar.conf is automatically set to the below one.

      Db-Host-Name: clm-aus-022027\SS_QAINSTANCE

      May 23, 2019 09:55
Preparing for installation of BMC Digital Workplace Catalog
BMC Digital Workplace Catalog installation parameter reference
© Copyright 2013 - 2018 BMC Software, Inc.
Legal notices

Powered by Atlassian Confluence and Scroll Viewport

© Copyright 2005-2019 BMC Software, Inc.