Unsupported content This version of the product has reached end of support. The documentation is available for your convenience. However, you must be logged in to access it. You will not be able to leave comments.

Upgrading the IBM Bluemix Infrastructure Provider


The following sections describe the process for upgrading to the latest version of IBM Bluemix Infrastructure (formerly IBM SoftLayer) provider by using the IBM Bluemix Infrastructure provider installer.

Before you begin

Ensure that the following prerequisites have been met before you perform the IBM Bluemix Infrastructure provider upgrade procedure:

  • Successfully upgrade BMC Cloud Lifecycle Management to 4.5.00 or later and ensure that you use the compatible version of the IBM Bluemix Infrastructure provider. For more information, see Upgrading.
  • (4.5.00 and earlier) You have downloaded the IBM Bluemix Infrastructure Provider installer zip file (IBM SoftLayer Windows Installer 1.0.00.zip or IBM SoftLayer Linux Installer 1.0.00.tar) from CLM Zipkit - IBM SoftLayer Provider on BMC Communities, extracted the file contents, and stored the files on your local computer. Make sure that the IBM Bluemix Infrastructure provider installer files (setup.cmd or setup.sh) are on your local computer.
  • (4.6.00) To use BMC Cloud Lifecycle Management 4.6.00 with the IBM Bluemix Infrastructure provider, install 4.6.03. DO NOT install the IBM Bluemix Infrastructure provider separately.
  • Ensure that prior to upgrading to IBM Bluemix Infrastructure provider, the osgi.bundles parameter values (lib/softlayer-1.0.0.jar@start and lib/softlayerconnect-1.0.0.jar@start) exists for the IBM Bluemix Infrastructure provider in the <Platform_Manager_installation_directory>/configuration/config.ini file.

To upgrade the IBM Bluemix Infrastructure provider

The following table lists the steps to upgrade the IBM Bluemix Infrastructure provider to the latest version:

Task sequence

High-level task

Procedure

1

Perform the prerequisites for the upgrade

Complete the required prerequisite steps before you start the IBM Bluemix Infrastructure upgrade process. For example, back up your database and take snapshots of product virtual machines.

2

Run the upgrade

  1. Extract the setup.cmd or setup.sh file from CLM Zipkit - IBM SoftLayer Provider on BMC Communities.
  2. Run the installer to upgrade the IBM Bluemix Infrastructure provider.
    Note: During upgrade, you must specify your enterprise AR System server or cloud AR System server details depending on your environment.

3

Perform postupgrade configuration

  1. Stop the Cloud Platform Manager service.
  2. On the Cloud Platform Manager computer, delete the BMC Software\BMCCloudLifeCycleManagement\ Platform_Manager\configuration\org.eclipse.osgi folder.
  3. Start the Cloud Platform Manager service.
  4. Log on to http://<hosts>:8080/arsys/shared/config/config.jsp and flush the BMC Remedy Mid Tier cache.

4

Verify the upgrade

Log on to the BMC Remedy Mid Tier and verify that the following IBM Bluemix Infrastructure resources are displayed correctly:

  1. Verify that the IBM Bluemix Infrastructure Provider is registered as shown in the following figure:

    AzProv.png

  2. Verify that multiple accounts for the IBM Bluemix Infrastructure provider are created as shown in the following figure:
    MulAc.png

Note:

If you are upgrading a non-registered IBM Bluemix Infrastructure provider, ensure the following items after upgrade:

  • The softlayer-1.0.0.jar and softlayerconnect-1.0.0.jar files exist with the new time stamp (current date when the upgrade is done) in the Platform_Manager/lib folder.
  • The osgi.bundles parameter value exists for the IBM Bluemix Infrastructure provider in the <Platform_Manager_installation_directory>/configuration/config.ini file.


Post-upgrade caveats for an upgraded SOI

After upgrading from IBM Bluemix Infrastructure provider 1.0.00 to 4.5.00 (or later) or 1.1.00 (only the upgraded SOIs from 1.0.00) to 4.5.00 or later, consider the following caveats while performing Day 2 operations on an upgraded SOI:

  • An upgraded SOI is not covered under Quota calculations because Quota management is not supported for the servers provisioned by IBM Bluemix Infrastructure provider 1.0.00.

    Note

    You might expect incorrect quota calculations for servers provisioned in an upgraded environment. The cloud administrator must ensure that the quota allocation is done correctly.

  • If you transfer an upgraded SOI to another user, and the user performs the Add disk or Remove disk operation, the operations are performed on the original storage account in IBM Bluemix Infrastructure.
  • If you or any other user performs the Add server operation on an upgraded SOI, then the new VM disk is created or placed on a different storage account in IBM Bluemix Infrastructure instead of the storage account used for the original SOI servers.

Where to go from here

Configuring-the-IBM-Bluemix-Infrastructure-provider

Related topic

IBM-Bluemix-Infrastructure-provider-issue

 

Tip: For faster searching, add an asterisk to the end of your partial query. Example: cert*