Running the BMC Digital Workplace Catalog installer
After you have extracted the installation files, created an installation options file, and uploaded the file to the Linux server, run the BMC Digital Workplace Catalog installation script.
Before you begin
Before you run the installer, ensure that you have completed the following tasks:
- Confirm that the database connection is open and listening for connections.
- Confirm that the target application server is ready for the installation. See Preparing a Linux server for BMC Digital Workplace Catalog installation.
To run the installer
The installation process can take between 30 to 60 minutes to complete successfully. The installer runs a series of tests and then installs the BMC Digital Workplace Catalog application.
Extract the files from the installation archive package. For instructions, see Extracting the downloaded archive.
On the Linux server, find the directory where you extracted the installation files.
Run the install script and specify the installation options file. For more information, see Creating a BMC Digital Workplace Catalog installation options file.Example
./install-digitalworkplace.sh -o myoptions.txt
If you want to use the configuration wizard to create a new options file, run the above command without specifying the installation options file. Follow the prompts to proceed with the installation.
If you specified the options file, the following message will be displayed. Enter y to validate your options file, and enter n to skip the validation and proceed with the next step.
Would you like you validate your options file using the DWPCatalog Configuration Wizard
Read the End User License Agreement (EULA), and press q to exit.
Enter y to accept the terms of the EULA.
Enter y to verify that the system dependencies have been installed, and then continue with the installation.
Watch for status updates while you wait for the installation process to finish.
If the installation fails due to an error:
Run the remove-digitalworkplace.sh script to delete any temporary files, and then run the installation script again.Example
Delete the BMC Digital Workplace Catalog system and application database or tablespace.
Delete the BMC Digital Workplace Catalog user for the database or tablespace.
Successful result message
You should receive the following messages that indicate a successful installation. The BMC Digital Workplace Catalog application server host name is shown in the URL.
$ ./install-digitalworkplace.sh -o myoptions.txt
Welcome to the BMC Digital Workplace Catalog Installer
Would you like you validate your options file using the DWPCatalog
Configuration Wizard [y/n]? n
In order to use this software you are required to accept the license
agreement, please press [Enter/Return] key to view the license.
You can scroll with the arrow keys and quit the viewer by pressing 'q'.
Do you agree to the terms and conditions as defined in the EULA [y/n]? y
The installation will take roughly 30-60 minutes, depending on hardware and
You can monitor the progress by viewing the logs:
tail -f /tmp/dwp_install_log.txt
[ Installation started: 15:54:11 ]
This script must be run as root in order to install dependencies. If
you are sure dependencies have been satisfied, you can continue as
the current user. Without these dependencies your installation will
Do you want to continue with the installation [y/n]? y
[15:54:13] Validating Files .............................. [ PASS ]
[15:54:36] Deploying File System ......................... [ PASS ]
[15:54:56] Setting Up Database ........................... [ PASS ]
[15:55:00] Starting Server ............................... [ PASS ]
[15:57:43] Deploying Smart Bundles ....................... [ PASS ]
[15:57:43] Deploying BMC DWP Catalog ..................... [ PASS ]
[15:58:02] File Cleanup .................................. [ PASS ]
[15:58:06] Restarting Server ............................. [ PASS ]
Installation successful. Complete the steps to load the tenant data and
and then log into the BMC DWP Catalog administration console:
To test the installation
Edit the placeholders in the following URL to match your server environment, and open the URL in a web browser to go to the BMC Digital Workplace Catalog login page.
Port 8008 is the default port number that the Jetty web server uses. If you changed the Jetty configuration to use a different port number, or if you enabled access without a port number, modify the port number value in the URL accordingly.
If you see the BMC Digital Workplace Catalog application login screen, then your installation was a success!
You cannot log in until you have loaded the initial tenant data, which includes the tenant administrative user account. See Loading the BMC Digital Workplace Catalog tenant setup data.
Troubleshooting installation issues
To review the installation log files
If you experience issues in the installation, review the following log file for errors:
- /tmp/dwpsystem_install_log.txt—Reports issues while installing the platform.
For examples of log messages that can assist your troubleshooting, see Troubleshooting common BMC Digital Workplace Catalog issues by using log files.
The following table lists an example of run-time errors that you might encounter and how you can resolve the error.
|Error in configuration options
Update the configuration options in the installation options file and run the installer again.
The following errors are common:
|Missing system dependencies libraries
|The Linux system administrator with root user permissions should review the task to install the system dependencies in Preparing a Linux server for BMC Digital Workplace Catalog installation.
Your environment requires the following packages:
This known issue is with Red Hat Enterprise Linux 7.3 systems that have been updated.
To resolve the error, the Linux system administrator with root user permissions should update the libtirpc library and its dependencies by issuing the
Error when you install BMC Helix Digital Workplace Catalog on a secondary server
While configuring BMC Digital Workplace Catalog for high availability, if the BMC Digital Workplace Catalog installation fails on the secondary server, and you see
|Post upgrade error on a secondary node
Ignore the error.
|An installation halts during the Remedy Action Request System final restart.
The installation should be successful.