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.

Creating a BMC Digital Workplace Catalog upgrade options file

Before you upgrade BMC Digital Workplace Catalog, you must create a text file that provides the information about the current installation. You can use the information that you captured in the Upgrade-worksheet-for-BMC-Digital-Workplace-Catalog to create this text file.

Related topics

Upgrade-process-overview-for-BMC-Digital-Workplace-Catalog

BMC-Digital-Workplace-Catalog-installation-parameter-reference

Before you begin

  1. Downloading-the-BMC-Digital-Workplace-Catalog-upgrade-files.
  2. Extract the files and locate the options.txt file that is part of the package.

To edit the upgrade options file

You can edit the options.txt file directly on the Linux server where you will upgrade BMC Digital Workplace Catalog.

Alternatively, you can edit the options.txt file on your local machine, and then upload it to the BMC Digital Workplace Catalog server before performing the upgrade.

Note

If you are editing the options file on a Windows computer, use a text editor that supports UNIX line endings.

  1. In a text editor, edit the file to update the settings based on the values in the upgrade worksheet.
  2. Save the file with a new name.
    Example: dwpoptions_upgrade_server01.txt
  3. (Optional) If you are upgrading BMC Digital Workplace Catalog in a cluster, create a different options file for each server to identify the server to be upgraded.
    Example: Create different options-based files with details that pertain to the following Linux servers: 
    • dwpoptions_upgrade_server_01.txt—for server host name dwpcatalog-server-01.calbro.com 
    • dwpoptions_upgrade_server_02.txt—for server host name dwpcatalog-server-02.calbro.com 
    • dwpoptions_upgrade_server_n.txt—for server host name dwpcatalog-server-nn.calbro.com
  4. (Optional) If you edited the file on a local machine, upload the options file to the appropriate server. Place the file in a folder that is available to the upgrade script.

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

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

################################################################################
# BMC Digital Workplace Catalog with Microsoft SQL Server or ORACLE database
# Required upgrade settings
#
################################################################################

################################################################################
# Application server specific properties
################################################################################

# 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 path to the existing Oracle Java installation..
#
# Example: BMC_JAVA_JRE_64_BIT_HOME_PATH=/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 performs 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:
# -J BMC_DWP_USER=dwpadmin
# -J BMC_DWP_PASSWORD=dwppassword
#
-J BMC_DWP_USER=

-J BMC_DWP_PASSWORD=

# BMC Digital Workplace Catalog server instance name
#
# Specify the machine name of the computer on which BMC Digital Workplace Catalog
# is installed.
#
# 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 BMC Digital Workplace Catalog is installed.
#
# Example: dwp-catalog-server.domain.com
#
-J BMC_DWP_SERVER_HOST_NAME=

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

Where to go from here

Upgrading-a-BMC-Digital-Workplace-Catalog-server

 

Tip: For faster searching, add an asterisk to the end of your partial query. Example: cert*