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.
  
  Perform the following steps to log on to CDP as an administrator.
  
  1. On the server where the CDP is installed, run the services.msc command on the command prompt.
  2. From the list of services running, select BMC Atrium Orchestrator Configuration Distribution Peer service, right-click and select Properties.
  3. Click the Logon tab and select This account option.
  4. Click Browse and select the Administrator user account.
  5. Specify the password for the account.
  6. Save and restart the service.
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.
  Warning
  Do not enter the default BMC Atrium Single Sign-on account amadmin in the RepositoryUser field.
- 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 settings

Setting	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 fields

Template 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:

-P installLocation=C:\Program Files\BMC Software\silentwinSDA
-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.