Patches

This topic contains information about fixes and updates in the various patches, and provides instructions for downloading and installing the patch. 

Updates in the latest 4.1.00 patch

Patch 7 for BMC Cloud Lifecycle Management 4.1.00 (4.1.00.007) is the latest cumulative patch that includes the fixes of all the earlier patches.

To locate any update for a particular patch, perform any of the following actions:

• Select a patch number from the Available in list to filter the table by patch version numbers.
• Type a character string in one or more of the boxes to filter the list of updates.  
• Click any column heading to sort this table or change sort direction.

Downloading the patch

This section lists the installation files required to download the patch and describes the procedure the download the files from the Electronic Product Distribution (EPD).

Downloading the BMC Cloud Lifecycle Management patch files

The following table lists the patch installation file to download:

To download the files

1. Create a directory in which to place the downloaded files.

   Note

   On Windows computers, ensure that the directory is only one level into  the directory structure. The EPD package creates a directory in the  temporary directory when you extract the files, and the directory that  contains the installation image should not be in a directory deeper than  two levels into the directory structure.

2. Go to http://www.bmc.com/available/epd.html.

3. At the logon prompt, enter your user ID and password, and click Submit.

4. On the Export Compliance and Access Terms page, provide the  required information, agree to the terms of the agreements, and click Continue.

5. If you are accessing this site for the first time, create an EPD profile to specify the languages and platforms you want to see, per the EPD site help otherwise, skip to step 6.

6. Verify that the correct profile is displayed for your download purpose, and select the Product Patches tab.

7. Expand BMC Cloud Lifecycle Management or BMC Cloud Extension Pack to show its versions, and then expand the version, platform, and language to show its downloadable files.

8. Select the files that you want to download.

9. Click Download (FTP) or Download Manager:

   • Download (FTP) places the selected items in an FTP directory, and the credentials and FTP instructions are sent to you in an e-mail message.

   • Download Manager enables you to download multiple files consecutively, and to resume an interrupted download if the connection drops.
     This method requires a one-time installation of the Akami NetSession  Client program on the target computer and is usually the faster and more  reliable way to transfer files. A checksum is used to verify file  integrity automatically.

     Tip

     You can also click on a download file and be prompted to save it.

_{Back to top}

Supported upgrade paths

The following table describes the supported upgrade paths if you want to install the latest BMC Cloud Lifecycle Management patch. 

Preparing to install the patch

Before installing the latest patch, ensure that the following conditions are met:

1. If you are using any of the earlier versions, upgrade to BMC Cloud Lifecycle Management version 4.1.
2. Ensure that the supported products are at the latest service pack or patch level. 
   For more information about the supported product versions, see Component BMC product service pack and patch levels.
3. To resolve QM001886418, you must apply BMC Network Automation 8.5.01 hotfix#31. To avail the hotfix, contact BMC Support at http://www.bmc.com/support.

4. If you have changed the administrator user password for the enterprise AR System and cloud AR System after the last time you installed BMC Cloud Lifecycle Management, you must ensure that the passwords match the installation configuration file. If the passwords do not match, the installation fails.  

    Perform the following steps to ensure that the passwords match

   1. Generate an encrypted password: 
      
      1. On the Cloud Platform Manager, go to C:\Program Files\BMC Software\BMCCloudLifeCycleManagement\Utilities.
      2. Run the BMCCloudLifeCycleManagementMaintenanceTool.bat/sh file.
      3. Click Encrypt.
      4. In the Password and Confirm Password fields, enter the new password.
      5. Click Encrypt.
      6. Copy the new encrypted password.
   2. Update the encrypted password in the installation configuration file on the enterprise AR System: 
      1. Go to  InstallationDirectory\BMCCloudLifeCycleManagement\ and open the ARSystemInstalledConfiguration.xml file.
      2. Search for the BMC_AR_PASSWORD_HOSTING attribute.
      3. In the value field for the attribute, enter the encrypted password.
   3. On the cloud AR System server, follow the same steps to update the encrypted password in the installation configuration file.
5. Ensure that the BMC Remedy AR System ports specified in the ARSystemInstalledConfiguration.xml  file are accurate. 
   If the ports are not accurate, stop the enterprise AR System or cloud AR System services, updated the port numbers, and restart the service. For more information, see BMC Knowledge Article KA410544.

6. Take a VM snapshot and a database backup of the components involved; for example, Enterprise AR System Server, CloudDB, and Platform Manager.

   Warning

   Installing the patch can affect the AR objects in a non-overlay mode. Ensure that you follow the best practices for customizations. 

7. Ensure that the JAVA_HOME variable is set on the servers where you are installing the patch. On Linux servers, ensure that X11 libraries are installed.

^{Back to top}

Installing the patch

This topic describes the procedure to install the latest patch.

To install the latest patch: 

1. Download and extract the patch installer and place a copy on each of the VMs that have the following components installed:
   1. Enterprise BMC Remedy AR System server

   2. Cloud Platform Manager

      Notes

      Install the patch on the enterprise BMC Remedy AR System first and then on Platform Manager.

      For Linux, extract the installer by using the tar –xvf CLMPatchInstaller4100Px.tar command.
      In the above command, x refers to the patch number. Therefore, to extract patch 7, run tar –xvf CLMPatchInstaller4100P7.tar.

2. On the Enterprise AR System server, install the patch: 
   1. Start one of the following installation programs:
      • On Microsoft Windows, double-click the setup.exe file. 

      • On Linux, navigate to the  \CLMPatchInstaller\Disk1 location and run the setup.bin file  by using Xmanager.

        With Xmanager, X applications installed on remote UNIX-based computers run seamlessly with Windows applications side by side.

        Note

        You can also use the VConsole to launch the installer.

   2. On the Welcome pane, note the warnings and click Next. 
   3. On the Directory selection pane, navigate to the location on the host where you want to install the BMC Cloud Lifecycle Management patch installer files and click Next.
      You can accept the default value if you do not have a specific location for the installation files.
   4. On the Installation Preview pane, review the summary and click Next. 
3. Repeat step 2 on the Cloud Platform Manager. 

4. (Optional; only if you have a high availability environment) On each additional or secondary enterprise AR System server, copy all the files from the  <CLMPatchInstaller>\Disk1\files\patch\ear\Px\jars\Cloud_Portal\plugin (except pluginsrv_config.xml and log4j.xml) and replace them in the  <BMCCloudLifeCycleManagementInstallationDirectory>\Cloud_Portal\plugin  location.

   Note

   In the above path, x refers to the patch number. Therefore, to refer to the path for patch 7, specify <CLMPatchInstaller>\Disk1\files\patch\ear\P7\jars\Cloud_Portal\plugin .

^{Back to top}

Configuring after installing the patch

You must clear the cache after installing the patch. Perform the following post configuration steps: 

1. Clear the mid-tier cache.
   If the mid-tier used by the BMC Cloud Lifecycle Management console is different than the mid-tier running on the enterprise AR System server, then you need to clear the cache.
2. Log on to the Mid Tier Configuration Tool. 
3. Perform a flush cache.
   The flush cache removes all items from the caches that BMC Remedy Mid Tier maintains. The next time the mid tier needs those objects, the most up-to-date versions are retrieved from the AR System server.
4. Clear the browser cache.
5. Perform the following steps to hard delete the mid-tier cache:
   

   1. Stop the mid-tier service.

   2. Log in to the mid-tier server, and delete the contents of the following folders:

      • ARSystem\midtier\attstore

      • ARSystem\midtier\cache

      • ARSystem\midtier\cachetemp

      • ARSystem\midtier\dvmodule

      • ARSystem\midtier\PluginsCache

      • ARSystem\midtier\WEB-INF\atriumDeploymentPackages

      • ARSystem\midtier\WEB-INF\AtriumWidget

      • ARSystem\midtier\WEB-INF\AtriumWidget-7604

   3. Delete the atrium-* files in the ARSystem\midtier\WEB-INF\lib folder.

   4. Delete the contents of the work and temp folders in the ....\...\Apache Software Foundation\Tomcat X.X folder.

   5. Delete the viewStats.dat and viewStats.dat.bak files from the ARSystem\midtier\WEB-INF \Classes folder.

   6. Start the Tomcat (JSP Engine) service.

^{Back to top}

Related topics

Patch installation issues
Downloading the installation files