Limited support


This version of the product is in limited support. However, the documentation is available for your convenience. You will not be able to leave comments. Click here to view the documentation for the current version.

Installing BMC Digital Workplace

This section describes how to install the BMC Digital Workplace application for administering the end user request experience.

Best practice

BMC recommends installing BMC Digital Workplace on a dedicated server. To avoid issues and to improve performance, do not install on servers that host other applications, such as BMC Remedy Mid Tier.

Before you begin

To plan your BMC Digital Workplace deployment, complete the steps in Planning, which includes information about system requirements and sizing your environment.

Stage 1: Prepare for installation 

Complete the following tasks:

TaskActionAdditional information
1Complete installation worksheets for Digital Workplace.Before you start installing the products, you must gather information about the parameters that the installer requires for each product. The planning spreadsheet provided in this section helps you gather these parameter values. To avoid installation errors, refer to this spreadsheet when you run the installation.
2Download the BMC Digital Workplace installation files.This topic explains how to obtain the files that you need for installation from the BMC Electronic Product Distribution (EPD) site.
3Install 64-bit Java Runtime Environment (JRE) 8 or 11, or install OpenJDK 11.

Install JRE or OpenJDK on all the servers where you will install BMC Digital Workplace. Set the Java Home path.

4Pre-create the database.

If you have database access restrictions and cannot allow the BMC Digital Workplace installer to create a database, a DBA can create a pre-existing database.

5(Linux) Review Requirements for a non-root user to run the installerIf a non-root user will run the installer in a Linux environment, a system administrator must set the needed permissions.
6Install the ITSM integration patch.

Before you install BMC Digital Workplace, install the BMC Digital Workplace ITSM integration patch on your BMC Remedy ITSM server. This patch enables BMC Remedy ITSM to work with BMC Digital Workplace. Without this patch, timelines, email notifications, and social features will not work in BMC Digital Workplace.

Note: If you have installed BMC Remedy ITSM 18.08 Patch 1, and also downloaded and installed the Remedy ITSM Version 18.08.00 Patch 001 Deployment Management Package for BMC Digital Workplace 18.11.00 patch, you do not need to download and install the BMC Digital Workplace ITSM Integration Patch Version 18.05.00 patch from the BMC Digital Workplace installation files.

7(Linux) Installing the package to launch the UI installer (on Linux).

On a Linux environment, to invoke the UI installer for installing BMC Digital Workplace, you must download a package containing Xorg libraries.


Stage 2: Install BMC Digital Workplace

TaskActionAdditional information

Installing BMC Digital Workplace on a single server

Not applicable

Installing BMC Digital Workplace in a cluster

  1. Install BMC Digital Workplace on the primary server. Specify the In a New Cluster option during installation.
  2. Install BMC Digital Workplace on the secondary server. Specify the In an Existing Cluster option during installation.


Installing BMC Digital Workplace silently

Silent installation reads the parameters provided in the options.txt file and installs BMC Digital Workplace without launching the installation wizard.

2Resolve issues indicated by the installer, if any.

The installer performs the following pre-install checks before proceeding with the installation:

  • Disk space
  • JAVA runtime version
  • Database version
  • Directory permissions
  • BMC Digital Workplace installed version
  • Components operation status

Installation does not proceed if the pre-install check detects inconsistencies in the required components.

3Verifying the BMC Digital Workplace installationPerform these checks to verify your installation.

Stage 3: Configure BMC Digital Workplace

Perform the following tasks before you validate that installation was successful.

This section describes the tasks to be performed after installing BMC Digital Workplace. It includes the following topics:

  • Configuring SSL for the Tomcat server

    To provide communication security among applications, configure SSL for the Apache Tomcat server. If you enabled SSL as part of the installation, SSL is already configured.

  • Creating file

    If you plan to integrate the BMC Digital Workplace with Remedy Single Sign-On, you need to create the file on the BMC Digital Workplace server.

  • Configuring BMC Digital Workplace for Remedy Single Sign-On

    BMC Remedy Single Sign-On authentication applies to browsers and mobile applications. When a user logs on to a mobile device, the user is prompted to enter the host name and port. If the server has SSO enabled, the mobile client opens a browser to the SSO login page. The SSO server sets the SSO cookies after authentication on to the device browser. When the user relaunches the application, if the cookies are not expired, the mobile client displays the application. If the cookies are expired, the user is shown the login page again for authentication.

  • Modifying ports for BMC Digital Workplace

    This topic provides instructions to change the BMC Digital Workplace server port after installation. You might need to change the ports if you did not specify an open port during installation, or if these ports are in use.

  • Transferring data between environments

    The Data Transfer tool, available with a BMC Digital Workplace installation is a set of multiple scripts that work in conjunction to export and import BMC Digital Workplace data between different BMC Digital Workplace environments.

  • Enable full text search (FTS) Open link
    BMC recommends that you use Full Text Search which is available by default.

Before you deploy BMC Digital Workplace to users, perform additional administration tasks.

Stage 4: Deploy BMC Digital Workplace clients to users 

TaskAdditional information
Deploy clients

IT users access BMC Digital Workplace using desktops and mobile devices (Apple iOS and Google Android). Use the methods described in Deploying clients to deploy the BMC Digital Workplace client applications for your users.


This version of the documentation is no longer supported. However, the documentation is available for your convenience. You will not be able to leave comments.