This documentation supports the 19.02 version of BMC Digital Workplace Advanced.

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

Installing BMC Digital Workplace


This section describes how to install the BMC Digital Workplace application for administering the end user request experience. For information about setting up the application to support the enhanced catalog, see Installing BMC Digital Workplace Catalog.


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. The planning section includes information about system requirements and sizing your environment.

Stage 1: Prepare for installation 

Complete the following tasks:

Task Action Additional information
1 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 Downloading 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 either JRE or OpenJDK on all the servers where you will install BMC Digital Workplace. Set the Java Home path.

4 Pre-creating 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) 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 Installing the ITSM integration patch

Before you install BMC Digital Workplace, you must 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

Task Action Additional information
1

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 with In a New Cluster option during installation.
  2. Install BMC Digital Workplace on the secondary server. Specify the with 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.

Task Action Addtional information
1 (Recommended) Configure 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.
2 (Recommended) Configure BMC Digital Workplace for Remedy Single Sign-On

BMC Remedy Single Sign-On authentication applies to both the universal client and to 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 user is shown the login page again for authentication.


3

(Recommended) Enable full text search (FTS)

BMC recommends that you use Full Text Search which is available by default.


Full text search (FTS) is an optional feature that you can install with the BMC Remedy AR System server. To use FTS with Smart IT, you must install BMC Remedy Knowledge Management, even if you do not plan to create knowledge articles. To use the complete FTS capability, you must configure and enable the feature.


Unable to render {include} The included page could not be found.

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.

 


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

Comments