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

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.



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 or later, and also 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.

The Remedy ITSM Version 18.08.00 Patch 001 Deployment Management Package for BMC Digital Workplace 18.11.00 patch will work with BMC Digital Workplace for all versions between 18.11.00 and 19.05.00.

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
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 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 serverTo 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.
  • Configuring BMC Digital Workplace for Remedy Single Sign-OnBMC 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
  • Making configuration changes to integrated applicationsYou can change the settings that Product name library 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 Product name library application).
  • Configuring multitenancyThe multitenancy feature provides the ability to segregate all data by operating company and customer company. This topic describes how to configure Product name library so that configuration data it provides is restricted to a specific tenant company.
  • Modifying ports for BMC Digital WorkplaceThis topic provides instructions to change the Product name library 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 environmentsThe Data Transfer tool, available with a Product name library installation is a set of multiple scripts that work in conjunction to export and import Product name library data between different Product name library 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 

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.

 


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

Comments