Installing 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:
|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) Install 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
|Installing BMC Digital Workplace silently||
Silent installation reads the parameters provided in the
|2||Resolve issues indicated by the installer, if any.||
The installer performs the following pre-install checks before proceeding with the installation:
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 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 desktop and mobile applications. When a user logs on to a mobile device, the user is prompted to enter the hostname 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 u
- Making configuration changes to integrated applications — You can change the settings that BMC_Digital_Workplace uses to connect to BMC Service Request Management, BMC Remedy IT Service Management, and BMC Remedy Action Request System (BMC Remedy AR System, dedicated to the BMC_Digital_Workplace application).
- Configuring multitenancy — The multitenancy feature provides the ability to segregate all data by operating company and customer company. This topic describes how to configure BMC_Digital_Workplace so that configuration data provided by BMC_Digital_Workplace is restricted to a specific tenant company.
- Modifying ports for BMC Digital Workplace — This topic provides instructions to change the BMC_Digital_Workplace server port post 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
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.