Running the BMC Digital Workplace Catalog installer
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.
- On the Linux server, find the directory where you extracted the installation files.
Run the install-digitalworkplace.sh script and specify the location of the installation options file. In the following example, the installation options file is named myoptions.txt.
Example./install-digitalworkplace.sh -o myoptions.txt- 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./remove-digitalworkplace.sh- 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.
===========================================================================
Welcome to the BMC Digital Workplace Catalog Installer
===========================================================================
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'.
[Enter/Return]
Do you agree to the terms and conditions as defined in the EULA [y/n]?
Do you agree to the terms and conditions as defined in the EULA [y/n]? y
The installation will take rougly 30-60 minutes, depending on hardware.
You can monitor the progress by viewing the logs:
tail -f /tmp/dwp_install_log.txt
tail -f /tmp/dwpsystem_install_log.txt
[ Installation started: 03:24:52 ]
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
fail.
Do you want to continue with the installation [y/n]? y
Installing BMC Digital Workplace Platform ................ [ PASS ]
Installing BMC Digital Workplace Catalog ................. [ PASS ]
Cleaning up installation files ........................... [ PASS ]
Performing final restart ................................. [ PASS ]
===========================================================================
Installation successful. Complete the steps to load the tenant data and
and then log into the BMC Digital Workplace Catalog administration
console:
http://digitalworkplace-catalog.example.com/myitsbe/login
===========================================================================
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.
Example URLhttp://digitalworkplace-catalog.example.com:8008/myitsbe- If you see the BMC Digital Workplace Catalog application login screen, then your installation was a success!
At this point you will not be able to 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 any issues in the installation, review the following log files for errors:
- /tmp/dwpsystem_install_log.txt—Reports issues while installing the platform.
- /tmp/dwp_install_log.log—Reports issues while installing the application.
For examples of log messages that can assist your troubleshooting, see Troubleshooting with log files.
Run-time errors
The following table lists an example of run-time errors that you might encounter and how you can resolve the error.
Where to go from here