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

Running the BMC Digital Workplace Catalog installer

After you have extracted the installation files, created an installation options file, and uploaded the file to the Linux server, run the BMC Digital Workplace Catalog installation script.

Before you begin

Before you run the installer, ensure that you have completed the following tasks.

To run the installer

The installation process can take between 30 to 60 minutes to complete successfully. The installer runs a series of tests and then installs the BMC Digital Workplace Catalog application.

  1. On the Linux server, find the directory where you extracted the installation files.

  2. Run the script and specify the location of the installation options file. In the following example, the installation options file is named myoptions.txt.

    ./ -o myoptions.txt
  3. Read the End User License Agreement (EULA), and press q to exit.

  4. Enter y to accept the terms of the EULA.

  5. Enter y to verify that the system dependencies have been installed, and then continue with the installation.
    Watch for status updates while you wait for the installation process to finish.

  6. If the installation fails due to an error:

    • Run the script to delete any temporary files, and then run the installation script again.

    • Delete the BMC Digital Workplace Catalog system and application database or tablespace.

    • Delete the BMC Digital Workplace Catalog user for the database or tablespace.

Successful result message

You should receive the following messages that indicate a successful installation. The BMC Digital Workplace Catalog application server host name is shown in the URL.

Messages displayed during the installation process
$ ./ -o myoptions.txt

          Welcome to the BMC Digital Workplace Catalog Installer

In order to use this software you are required to accept the license
agreement, please press [Enter/Return] key to view the license.

You can scroll with the arrow keys and quit the viewer by pressing 'q'.


Do you agree to the terms and conditions as defined in the EULA [y/n]?
Do you agree to the terms and conditions as defined in the EULA [y/n]? y

The installation will take rougly 30-60 minutes, depending on hardware.
You can monitor the progress by viewing the logs:

        tail -f /tmp/dwp_install_log.txt
        tail -f /tmp/dwpsystem_install_log.txt

[ Installation started: 03:24:52 ]

This script must be run as root in order to install dependencies. If
you are sure dependencies have been satisfied, you can continue as
the current user. Without these dependencies your installation will

Do you want to continue with the installation [y/n]? y

Installing BMC Digital Workplace Platform    ................    [  PASS  ]
Installing BMC Digital Workplace Catalog    .................    [  PASS  ]
Cleaning up installation files    ...........................    [  PASS  ]
Performing final restart    .................................    [  PASS  ]


 Installation successful. Complete the steps to load the tenant data and
 and then log into the BMC Digital Workplace Catalog administration


To test the installation

  1. Edit the placeholders in the following URL to match your server environment, and open the URL in a web browser to go to the BMC Digital Workplace Catalog login page.

    Example URL


    Port 8008 is the default port number used by the Jetty web server. If you changed the Jetty configuration to use a different port number, or if you enabled access without a port number, modify the port number value in the URL accordingly.

  2. If you see the BMC Digital Workplace Catalog application login screen, then your installation was a success!
    At this point you will not be able to log in until you have loaded the initial tenant data, which includes the tenant administrative user account. See Loading the BMC Digital Workplace Catalog tenant setup data.

Troubleshooting installation issues

To review the installation log files

If you experience any issues in the installation, review the following log files for errors:

  • /tmp/dwpsystem_install_log.txt—Reports issues while installing the platform.
  • /tmp/dwp_install_log.log—Reports issues while installing the application.

For examples of log messages that can assist your troubleshooting, see Troubleshooting with log files.

Run-time errors

The following table lists an example of run-time errors that you might encounter and how you can resolve the error.

Error typeAction steps
Error in configuration options

Update the configuration options in the installation options file and run the installer again.

The following are common errors:

  • Java JRE location is missing or has an error
  • Application Service or DSO password exceeds the maximum eight character length
  • (Oracle) SID length is longer than 8 characters
  • (Oracle) Database character set is not UNICODE and system character set is UTF-8
Missing system dependencies librariesThe Linux system administrator with root user permissions should review the task to install the system dependencies in Preparing a Linux server for BMC Digital Workplace Catalog installation.

Your environment requires the following packages:


rpcbind error
Example error
Your installation encountered a problem:
 rpcbind: symbol lookup error: rpcbind: undefined symbol: libtirpc_set_debug

This known issue is with Red Hat Enterprise Linux 7.3 systems that have been updated.

To resolve the error, the Linux system administrator with root user permissions should update the libtirpc library and its dependencies by issuing the yum update command.

# yum update libtirpc
Loaded plugins: langpacks, product-id, search-disabled-repos, subscription-manager
Resolving Dependencies
--> Running transaction check
---> Package libtirpc.x86_64 0:0.2.4-0.6.el7 will be updated
---> Package libtirpc.x86_64 0:0.2.4-0.8.el7 will be an update
--> Finished Dependency Resolution
Dependencies Resolved
 Package             Arch              Version                  Repository                     Size
 libtirpc            x86_64            0.2.4-0.8.el7            rhel-7-server-rpms             88 k
Transaction Summary
Upgrade  1 Package
Total size: 88 k
Is this ok [y/d/N]: y
Downloading packages:
Running transaction check
Running transaction test
Transaction test succeeded
Running transaction
  Updating   : libtirpc-0.2.4-0.8.el7.x86_64                                                    1/2
  Cleanup    : libtirpc-0.2.4-0.6.el7.x86_64                                                    2/2
  Verifying  : libtirpc-0.2.4-0.8.el7.x86_64                                                    1/2
  Verifying  : libtirpc-0.2.4-0.6.el7.x86_64                                                    2/2
  libtirpc.x86_64 0:0.2.4-0.8.el7

Error when you install BMC Digital Workplace Catalog on a secondary server

While configuring BMC Digital Workplace Catalog for high availability, if the BMC Digital Workplace Catalog installation fails on the secondary server, and you see THROWABLE EVENT {Description=[Failed to delete Install user]} in the dwp_install_log.txt file, run the following commands on the primary server before you try to reinstall BMC Digital Workplace Catalog on the secondary server.

#  cd  /opt/bmc/digitalworkplace/bin
# export ARTCPPORT=9988
# export LD_LIBRARY_PATH=.
# ./arcache -Ud -e999999999999999  -n "Action Request Installer Account"

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


  1. Emmanuel Galia

    Had an issue where the installation was failing but no errors were listed in either dwp_install_log.txt or dwpsystem_install_log.txt. However, after some troubleshooting with Jeff@BMC, we found the error in the file: platform_install_stdout_stderr.log

    The error was related to the Oracle DB being non-Unicode, but the System lang is set to: en_US.UTF-8:

    (Nov 28 2018 08:31:21.399 AM -0500),WARNING,com.bmc.install.product.arsuitekit.platforms.arsystemservers.arserver.ARServerLocaleValidationTask, LOG EVENT {Description=[Validating System LANG variable],Detail=[Database is Non-UNICODE but the System lang is set to: en_US.UTF-8]} (Nov 28 2018 08:31:21.400 AM -0500),SEVERE,com.bmc.install.product.arsuitekit.platforms.arsystemservers.arserver.ARServerLocaleValidationTask, LOG EVENT {Description=[INVALID_SYSTEM_LANG_UNICODE_DATABASE_NOT[String:en_US.UTF-8]],Detail=[Your system LANG variable is set to en_US.UTF-8 but the database is not configured for UNICODE. You must change your LANG variable to a supported NON-UNICODE language before you can complete this installation.]} (Nov 28 2018 08:31:21.842 AM -0500),CONFIG,Command return code,

    LOG EVENT {Description=[255]}

    The fix is prior to running the installation script, do these first: export LANG=C export LC_ALL=C

    After that's set, the install was able to go through fine.

    Hope that helps!! (Thanks again to Jeff@BMC Remedy Customer Support)

    Nov 29, 2018 01:29