This documentation supports the 19.08 version of BMC Digital Workplace Basic.

To view an earlier version, select the version from the Product Version menu.

Troubleshooting installation and upgrade issues in BMC Digital Workplace

This topic contains information that can help troubleshoot the issues faced during installation and upgrade of BMC Digital Workplace.

Related topic


Error reportedSolution

The installation or upgrade failed.

Check the installer logs for exceptions. Search the log entries for SEVERE level entries.

The log file is located at:

  • (Windows) C:\Users\Administrator\AppData\Local\Temp\digital_workplace_install_log.txt
  • (Linux) \tmp\digital_workplace_install_log.txt
The installation completed with warnings.

Check the installer logs for exceptions. Search the log entries for non-SEVERE level entries.

The log file is located at:

  • (Windows) C:\Users\Administrator\AppData\Local\Temp\digital_workplace_install_log.txt
  • (Linux) \tmp\digital_workplace_install_log.txt

Database exceptions in schema creation and upgrade indicated by the following message:

"Schema creation and population failed" 

For fresh install:

  1. Identify the cause of failure and correct it.
  2. Continue with the installation.
    1. If the BMC Digital Workplace schema was created in the database, delete it.
    2. Uninstall BMC Digital Workplace. See Uninstalling BMC Digital Workplace.
    3. Delete BMC Digital WorkplaceInstallDirectory.
    4. Run the installer.

For upgrade:

  1. Restore the BMC Digital Workplace database that you backed up before starting upgrade.
  2. Correct the cause of failure and run the installer again.

Note: If you do not have the BMC Digital Workplace and AR System database backup, contact BMC Support.

AR definition (DEF) file import failure.

For fresh install:

  1. Check the RIK log files located at SmartITInstallDirectory/SmartITMyIT/logs/
    See Contents of the logs for more information.
  2. Debug the failure. See Troubleshooting data and workflow import issues .

  3. Perform steps to clean up the BMC Digital Workplace database, and uninstall BMC Digital Workplace. Refer to the steps listed for Database exception in schema in the previous row.
  4. Log in to AR server from Developer Studio, search and filter all the forms prefixed with MyIT, and delete them.
  5. Ensure that the cause of the previous failed installation is corrected.
  6. Run the installer.

For upgrade:

  1. Perform step 1 and 2 of the previous procedure. 
  2. Restore the BMC Digital Workplace database you backed up before starting upgrade.
  3. Ensure that the cause of the upgrade failure is corrected.
  4. Run the installer. 

Note: If you do not have the BMC Digital Workplace database and AR System database backup, contact BMC Support.

AR System data import (ARX) failure or warnings.

Check the install and RIK log files located at installDirectory/logs/ for debugging the cause of the failure. See Contents of the logs for more information.

Note: You can run the Data import command line after installation to fix data import warnings. See Data Import command-line utility options . For previous versions of AR System, look for the corresponding version in that topic.



Apache Tomcat startup warnings and the BMC Digital Workplace applications are not getting loaded.

After the installation is complete, stop and restart Apache Tomcat.

BMC Digital Workplace database and AR System errors occurred during upgrade.

If you do not have the BMC Digital Workplace and AR System database backup, contact BMC Support.

Installation of the ITSM Integration patch, as a non-root user on a Linux computer, fails if Security-Enhanced Linux (SELinux) is enabled.

By default, if SELinux is enabled, you cannot run any binary from /tmp directory. So, when SELinux is enabled, the installer cannot run the /tmp/Utilities/Rik/driver.exe file, and you get a permission-denied error.

Before you install the UX patch, use one of the following workarounds:

  • Disable SELinux.
  • If you want to keep SELinux enabled, point the IATEMPDIR variable to a directory other than /tmp directory.

For more information, see  KA 000120721 from the BMC Knowledge Base.

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

Comments