Installing BMC Service Desk Automation run book
The BMC Atrium Orchestrator content installation program automates the installation of the adapters, modules, BMC Remedy AR artifacts (filters and operational categories), and BMC Remedy ITSM templates required for the BMC Service Desk Automation run book.
This topic describes how to install the BMC Service Desk Automation run book.
Before you begin
Before installing the run book, you must have performed the following tasks:
- Downloaded the BMC Atrium Orchestrator Content Installer from the BMC Electronic Product Distribution (EPD) website.
For more information, see Downloading-the-BMC-Atrium-Orchestrator-Content-installation-file. - Installed BMC Atrium Orchestrator Platform components such as the repository and the Configuration Distribution Peer (CDP) and are up and running.
For installing BMC Atrium Orchestrator Platform, see Installing in BMC Atrium Orchestrator Platform documentation.After installing the CDP, ensure that you provide administrator permissions to the CDP.
- Installed BMC Remedy AR System and BMC Remedy ITSM suite of products as required for the run book.
- If integrating with BMC MyIT, installed BMC MyIT.
- Created a user account (Orchestration) in BMC Remedy ITSM to be used for installing the run book.
To install BMC Service Desk Automation run book by using the GUI
The BMC Atrium Orchestrator Content installation program installs all of the dependent adapters and modules required for the run book. It also verifies that you have the correct versions of BMC Remedy AR System and BMC Remedy ITSM installed and prompts you for the BMC Remedy ITSM server configuration parameters and BMC Remedy ITSM template fields wherever applicable.
To install the solution:
- Navigate to the folder where you have downloaded the installation files and start the installation program.
- Windows: setup.cmd
- Linux or Solaris: setup.sh
- On the Welcome to BMC Atrium Orchestrator panel, review the information and click Next.
- On the license agreement panel, select I agree to the terms of the license agreement; then click Next.
- On the Directory Selection panel, accept the default location, or click Browse to select a different location; then click Next.
- On the Repository Communications Settings panel, enter the repository settings, and click Next:
- Web Server Protocol: Select https or http.
- Host Name or IP Address: Enter the fully qualified domain name of the repository.
- Web Server Port Number: Enter the port number where the repository is installed.
Repository User: Enter the user name of the account created in BMC Atrium Single Sign-On that you use to log on to the repository.
- Repository Password: Enter the password that matches the specified user account.
- On the Installation Type panel, select BSM Solutions and click Next.
- On the Solution feature selection panel, select BMC Service Desk Automation and click Next.
The installation program preselects the required base and BMC applications adapters on the Adapter feature selection panel. - On the Adapter feature selection panel, click Next.
- The installation program preselects the required Operations Actions Management modules on the Module feature selection panel.
- On the Module feature selection, click Next.
On the Remedy Integration panel, configure the BMC Remedy ITSM integration settings, described in the following table:
BMC Remedy ITSM integration settingsSetting
Value
Host name
Type the name or the IP address of the computer running the BMC Remedy ITSM service.
Port number
Select Port mapper or assign a specific port of the computer running the BMC Remedy ITSM service (if known).
Note: If the BMC Remedy AR System server is configured to use a port mapper, set the port number to 0. If the BMC Remedy AR System server is configured to use a specific port to receive requests, assign that specific port number.
User name
Type the BMC Remedy ITSM administrator logon user name.
For example, Orchestration
Password
Type the BMC Remedy ITSM administrator logon password that matches the specified user name.
- Click Next.
On the ITSM data input panel, select the appropriate data in the fields where you want to customize the BMC Remedy ITSM templates, and then click Next.
If you want to use the template default for a field, leave it blank. The following table describes the customization fields: BMC Remedy ITSM template customization fieldsTemplate field
Description
Support Company
Specifies the BMC Remedy ITSM support company name for imported templates.
For example, Calbro Services.
Support Organization
Specifies the BMC Remedy ITSM support organization name for imported templates.
For example, IT Support.
Support Group
Specifies the BMC Remedy ITSM support group name for imported templates.
For example, Service Desk.
- On the Installation preview panel, review the features to be installed, and then click Install.
- When the installation finishes, click Done.
To install the BMC Service Desk Automation run book silently by using the option file
In a silent installation, you run the installation program from a command line. You can run a silent installation on Red Hat or SUSE Linux, Oracle Solaris, and Windows to install the BMC Service Desk Automation run book. To execute a silent installation, you specify an options file to feed the installation settings to the program. The options file is a text file that defines all the required installation properties.
The following figure shows a sample options file for installing BMC Service Desk Automation run book:
-J AO_INSTALLING_FEATURES= ServiceDeskAutomation
-J AO_REPOSITORY_PROTOCOL=https
-J AO_REPOSITORY_HOST=abc-pun-654321.bmc.com
-J AO_REPOSITORY_PORT=38080
-J AO_REPOSITORY_USER_NAME=admin
-J AO_REPOSITORY_PASSWORD=admin123
-J AO_CONTENT_INSTALL_TYPE=INSTALL_TYPE_SOLUTIONS
-J INSTALL_REMEDY_ITSM_INTEGRATIONS=true
-J REMEDY_PORT_NUMBER=0
-J REMEDY_USER_NAME=orchestration
-J REMEDY_HOSTNAME=xyz-pun-123456
-J REMEDY_PASSWORD=*****
-J ITSM_AUTHORING_COMPANY=Calbro Services
-J ITSM_AUTHORING_ORGANIZATION=IT Support
-J ITSM_AUTHORING_GROUP=Service Desk
Where to go from here
- If you encounter any issues while installing the run book, see Troubleshooting-BMC-Service-Desk-Automation-run-book.
- To view the artifacts installed in your BMC Remedy ITSM environment by the BMC Atrium Orchestrator Content Installer, see Artifacts-reference-for-BMC-Service-Desk-Automation-run-book.
- After you install the solution, you can now start configuring your environment. For more information, see Configuration-roadmap-for-BMC-Service-Desk-Automation-run-book.
Perform the following steps to log on to CDP as an administrator.