Manually installing or upgrading the IBM SoftLayer Provider

This topic describes how to install the IBM SoftLayer Provider manually and how to verify the installation. The topic includes:

• • Prerequisites for installing the IBM SoftLayer Provider
  • Before you begin
  • Deploying OSGi files on the Cloud Platform Manager
  • Deploying .def and .arx files on the BMC AR System Server
    • To switch to Base Development mode
    • To import the IBM_New_Forms.def file   
    • To import IBM_Workflows.def file
    • To configure BMC Remedy AR forms
    • To re-import the .def files
    • To import data files
  • Clearing the Mid Tier and browser cache
  • To verify the installation

Prerequisites for installing the IBM SoftLayer Provider

Before installing IBM SoftLayer Provider, ensure that:

• You have downloaded the IBM SoftLayer Provider installer file (IBM SoftLayer Windows Installer 1.0.00.zip or IBM SoftLayer Linux Installer 1.0.00.tar), extracted the file contents, and stored the files on your local computer.
• The following BMC Cloud Lifecycle Management stack components are running when you install the IBM SoftLayer Provider:
  • Cloud Platform Manager
  • BMC Remedy Action Request System Server (BMC AR System Server)
• You have the same operating system (Windows or Linux) on the computer from where you will run the installer and the computer where BMC Cloud Lifecycle Management stack components are installed.
• You have the following privileges on the computer on which you want to run the installer and on which the BMC Cloud Lifecycle Management stack components are installed:
  • Administrator (for Windows)
  • root (for Linux)
• BMC Server Automation Network Shell (NSH) is installed, and the RSCD agent is running on the computer on which you want to run the installer and on which the BMC Cloud Lifecycle Management stack components are installed.
• You have Java 1.7.x 64-bit installed and have set the environment variables (JAVA_HOME and jre PATH).

Before you begin

Download and extract the following IBM SoftLayer provider installer files and store them on your local computer.

Folder	Subfolder	Files
AR	def	IBM_New_Forms.def IBM_Workflows.def
AR	arx	ProviderVendorMapping.arx ResourceType_VendorMapping.arx SysMessage.arx
OSGi		Softlayer-1.0.0.jar Softlayerconnect-1.0.0.jar

Deploying OSGi files on the Cloud Platform Manager

1. On the Platform Manager host, navigate to the Platform Manager installation folder, for example:
   • C:\Program Files\BMC Software\BMCCloudLifeCycleManagement\Platform_Manager (for Windows) 
   • /gsf or data1/bmc/BMCCloudLifeCycleManagement/Platform_Manager (for Linux) 
2. (Applicable only when replacing the existing .jar files) Make a backup copy of the following files in the Platform Manager installation folder:
   • PlatformManagerInstallFolder/configuration/config.ini
   • PlatformManagerInstallFolder/configuration/providers.json
   • PlatformManagerInstallFolder/configuration/cloudservices.json
   • PlatformManagerInstallFolder/configuration/lib/softlayer-1.0.0.jar
   • PlatformManagerInstallFolder/configuration/lib/softlayerconnect-1.0.0.jar
3. Copy the following .jar files to the PlatformManagerInstallFolder/configuration/lib folder:
   • softlayer-1.0.0.jar
   • softlayerconnect-1.0.0.jar
4. Edit the media.properties file as per your BMC Cloud Lifecycle Management environment.
5. Copy the media.properties file to the PlatformManagerInstallFolder/configuration folder:
6. Open the config.ini file and append in the end of osgi.bundles parameter value as follows:
   
   ,lib/softlayer-1.0.0.jar@start,lib/softlayerconnect-1.0.0.jar@start
7.  (Applicable only when replacing the existing .jar files) Delete the following folder contents and folder:
   
   • PlatformManagerInstallFolder/cache folder contents
   • PlatformManagerInstallFolder/configuration/org.eclipse.osgi folder
8. Start the Platform Manager service and monitor the csm log files in the PlatformManagerInstallFolder\Logs folder.

Deploying .def and .arx files on the BMC AR System Server

You must import the .def and .arx files and configure the forms on the BMC AR System Server computer. To do so, follow this process:

1. Switch to Base Development mode in BMC Remedy Developer Studio.
2. Import the IBM_New_Forms.def file.
3. Import IBM_Workflows.def file.
4. Configure BMC Remedy AR forms.
5. Re-import the .def files.
6. Import the data files.

The procedures for these steps are in the sections below.

To switch to Base Development mode

1. Log on to the BMC Remedy Developer Studio as Administrator.
2. To switch to Base Development mode, choose File > Switch Mode > Base Development.
   

To import the IBM_New_Forms.def file   

1. Choose File > Import.
2. Select ObjectDefinitions, and click Next.
    The Import Objects window is displayed.
3. From the Import File field, browse to the .def file, and select it.
4. Click Next.
    The selected object details are displayed in the Object Selection.
5. Select the Replace Objects on the Destination Server check box.
6. Click Finish.
    The .def file is imported.
7. Click Save.

To import IBM_Workflows.def file

1. Choose File > Import.
2. Select ObjectDefinitions, and click Next.
    The Import Objects window is displayed.
3. In the Import File field, browse to the .def file and select it.
4. Click Open.
5. Select the Replace Objects on the Destination Server check box.
6. Select the Delete Excess fields check box.
7. In Handle Conflicting Types, select Display Conflict Error.
8. Click Finish to import the .def file.
9. Click All Objects > Applications.
10. Navigate to the Application's List and double-click to open the BMC Cloud Management Administrator and BMC Cloud Management Foundation applications.

To configure BMC Remedy AR forms

1. Choose All Objects > Applications.
2. Navigate to the Applications List and double-click to open the BMC Cloud Management Administrator and BMC Cloud Management Foundation applications.
   

3. Configure the following forms as the Primary Form in the respective applications.

   Application name	Form name
   BMC Cloud Management Foundation	CMF:ProviderIBM_v
   BMC Cloud Management Administrator	IBMCMA:ManageIBMUserAccounts

   1. In the Form Selector window, enter the form name in the Filtering options field (for example, CMF:ProviderIBM_v  or CMA:ManageIBMUserAccounts).
   2. Click OK to add the selected form in the application.
   3. Click Save.

To re-import the .def files

1. To re-import the IBM_New_Forms.def, perform the steps in To import the IBM_New_Forms.def file.
2. To re-import the IBM_Workflows.def, perform the steps in To import IBM_Workflows.def file. 

To import data files

1. Log on to the BMC Remedy Import Tool.
2. Choose File > Preferences, and then select Generate New Id for All Records under Handle Duplicate Requests.
3. Select File > New Mapping to open the Import Mappings dialog box.
   

4. Enter the field values as applicable for importing the .arx files:

   Source data file	Target server	Target form name
   ProviderVendorMapping.arx	Target server name	ProviderVendorFormMapping
   ResourceType_VendorMapping.arx	Target server name	ResourceType_VendorMapping
   SysMessage.arx	Target server name	SysMessageBox

5. Click Auto Map.
6. Click on Import > Start Import.

Clearing the Mid Tier and browser cache

Perform the steps listed below to clear the BMC Remedy Mid Tier and the web browser cache:

1. Log on to the Mid Tier Configuration Tool at http://<midTierHost>:<portNumber>/arsys/shared/config/config.jsp.
2. In the left navigation pane, click Cache Settings.
3. Click Flush Cache.
4. Clear the browser cache.

To verify the installation

1. In the BMC Cloud Lifecycle Management – Administration Console, click the vertical Workspaces menu on the left side of the window, and select Providers.
2. Click Register .
3. In the Register Provider window, verify that the IBM SOFTLAYER provider type appears in the Provider Type list.