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.

Related topics

Uninstalling BMC Digital Workplace

Upgrading BMC Digital Workplace

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:

Task	Action	Additional information
1	Complete 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.
2	Download 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.
3	Install 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.
4	Pre-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 installer	If a non-root user will run the installer in a Linux environment, a system administrator must set the needed permissions.
6	Install 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

Task	Action	Additional information
1	Installing BMC Digital Workplace on a single server	Not applicable
	Installing BMC Digital Workplace in a cluster	Install BMC Digital Workplace on the primary server. Specify the In a New Cluster option during installation. 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.
2	Resolve 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.
3	Verifying the BMC Digital Workplace installation	Perform 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 rsso-agent.properties file
If you plan to integrate the BMC Digital Workplace with Remedy Single Sign-On, you need to create the rsso-agent.properties 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)
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

Task	Additional 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.