This documentation supports the 20.08 version of BMC Digital Workplace Basic, which is available only to BMC Helix subscribers (SaaS).
To view an earlier version, select the version from the Product Version menu.

General troubleshooting

This topic offers troubleshooting tips for BMC Digital Workplace issues. See the Related topics for additional troubleshooting topics.

The following table describes general system problems:


BMC Digital Workplace do not start after a Java upgrade

Starting from version 19.02 and later, BMC Digital Workplace Catalog is compatible with OpenJDK 11.

If you want to upgrade Java on BMC Digital Workplace and BMC Digital Workplace Catalog manually, you must update the path to the new location for Java.

Optional. Perform these instructions before the BMC Digital Workplace Catalog installation.

Log on to the DWP server as root. Perform the following steps:

  1. Issue alternatives --config java.
  2. Choose the Java version you installed by entering a number. If you issue alternatives --config Java again, the option you selected should have a + sign.
  3. Click Enter.
  4. Export the Java path. Example: exportJAVA_HOME=/usr/java/jre1.8.0_92.
  5. Edit  /.bashrc  
         vi ~/.bashrc 
  6. Add this to the end of the file and save: export JAVA_HOME=/usr/java/jre1.8.0_92.
  7. Reload .bashrc  
       source ~/.bashrc
  8. Update the symbolic link to the new Java by using one of the following paths with your own credentials:
  • If you want to use /usr/java/latest for the Java path in options.txtln -s /usr/java/jre1.8.0_181-amd64 /usr/java/latest.
  • Restart BMC Digital Workplace Catalog— ./dwpcontroller  start -u dwpadmin -p bmcAdm1n.

You can perform additional checks:

  1. Make sure that you use Oracle JDK or OpenJDK 11 for versions 19.02 and later.
  2. Make sure that .bmc_profile exists under /root/.bmc_profile.
  3. Make sure that /root/.bash_profile looks like:

      # .bash_profile   
    # Get the aliases and functions   
    if [ -f ~/.bashrc ]; then   
            . ~/.bashrc   
    # User specific environment and startup programs   
      export JAVA_HOME=/usr/java/jre1.8.0_92  
    export PATH   
    . /root/.bmc_profile   
  4. Make sure that all BMC Digital Workplace Catalog AR Server configuration files have the new Java directory. These files are:
 Click here to see...
#!/bin/env bash   
export TENANT_NAME=   
export BMC_AR_SYSTEM_HOME=/opt/bmc/ARSystem   
export UISERVICE_URL=http://localhost:8008/api/myit-sb/ui   
export RX_SERVER=http://localhost:8008   
export GIBRALTAR_HOSTNAME=localhost   
export GIBRALTAR_PORT=8008   
export GIBRALTAR_PATH=/mp   
export AR_HOST=localhost   
export AR_DB_NAME=rxn:/myit-sb/   
export AR_PORT=9988   
export RAILS_PATH=/rails_vm   
export MP_FILE_ROOT_PATH=${BMC_AR_SYSTEM_HOME}/dragonfly   
export MP_SERVER=   
export MP_SECRET_KEY_BASE=802b27fd1cf5b22900da654bd13ce830610ebf2f62bf71cd30d8cb915f84a94c7fd74796ee248ba166caf305651a36cd7320f2a15c192b778c1d0e48d9ae73a8   
export MAXIMUM_PERM_SIZE=2048M   
export LANG=en_US.UTF-8   
export LC_ALL=en_US.UTF-8   
  export JAVA_HOME=/usr/java/jre1.8.0_92  
export PATH=$PATH:${JRUBY_HOME}/bin   
export GEM_HOME=   
export PATH=$GEM_HOME/bin:$PATH   
export SEND_EMAILS=   



The following table describes issues that you might encounter if you have BMC Digital Workplace Basic:

FeatureProblemWorkaroundReference topic


BMC Digital Workplace installed on a Microsoft Windows 7 server is not localized in Internet Explorer 11.

Make sure you set the Format to the correct locale under Region settings.

Perform the following steps:

  1. Click the Start button, and then click Control Panel.
  2. Click Clock, Language, and Region, and then click Regional and Language Options.
    The Regional and Language Options dialog box appears.
  3. On the Formats tab, under Current format, click Customize this format.
    The Customize Regional Options dialog box appears.
  4. Click the tab that contains the settings that you want to modify, and make your changes.
Localizing titles and messages
AR System server

Issue connecting to the AR System server or SMTP.

Review and correct the connection settings in the BMC Digital Workplace Admin console (go to Configuration > Application Features, and review the Providers table).

Then restart the BMC Digital Workplace server. 

Email notificationsEmail notifications are not sent to end users.Starting from version 19.05, the Backend URL is mandatory for enabling email notifications for end users. If the Backend URL is not configured, end users do not receive email notifications. Make sure you have configured the email notifications correctly. For information about how to configure notifications, see Configuring email notifications.Configuring email notifications
The How do you want to open this link? window is not shown when an end user opens a deep link in the email by using iPad.For iPads upgraded to iOS 13, end users should disable the Request Desktop Website toggle. This toggle is turned on by default in iOS 13.

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