Patches

This topic contains information about fixes and updates in patches, as well as instructions to download and install a patch.

Updates in the latest

Patch 3 for BMC Cloud Lifecycle Management 4.5.00 (4.5.00.003) is the latest cumulative patch that includes the fixes of the earlier patch.

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

For download instructions, see, Downloading the installation files.

Supported upgrade paths

To install BMC Cloud Lifecycle Management version 4.5.00.003, you must first install 4.5.00. 

Preparing to install the patch 

Before installing the 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.5.
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. Close any open session of BMC Remedy Developer Studio before running the installer.

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 000081555.

6. Take a VM snapshot and a database backup of the enterprise AR System server and Platform Manager.
   

   Warning

   Installing the patch can affect the AR objects in a non-overlay mode. Ensure that you follow the BMC Remedy AR System best practices for customizations. Customizations made to the base objects in Developer Studio base development mode are not preserved through upgrades. For more information, see Best Practice Customization mode and Customizing applications using overlays and custom objects.

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 section describes the procedure to install a patch.

See the following BMC Communities video to apply patches to BMC Cloud Lifecycle Management. It covers preparing for and executing the installation, verifying the installation, and troubleshooting any installation issues.

https://youtu.be/yoV2dIg4-dI

To install the patch

Perform the following steps to install a patch in your environment:

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. Enterprise AR System Secondary server, if applicable

   3. Cloud Platform Manager

   Depending on which operating system you are on and the patch version that you are installing, download either of the following files:

   Patch version	OS	Installation package name	To access the installation files
   For 4.6.06.001	Windows	CLM_FeaturePack_4.6.06.001_Windows_Installer.zip	Extract the zip package CLM_FeaturePack_4.6.06.001_Windows_Installer.zip
   	Linux	CLM_FeaturePack_4.6.06.001_Linux_Installer.tar.gz	Extract the package using the following command: tar –xvf CLM_FeaturePack_4.6.06.001_Linux_Installer.tar.gz
   For 4.6.05.002	Windows	CLM_FeaturePack_4.6.05.002_Windows_Installer.zip	Extract the zip package CLM_FeaturePack_4.6.05.002_Windows_Installer.zip
   	Linux	CLM_FeaturePack_4.6.05.002_Linux_Installer.tar.gz	Extract the package using the following command: tar –xvf CLM_FeaturePack_4.6.05.002_Linux_Installer.tar.gz
   For 4.6.04.001	Windows	4.6.04_Patch1.zip	Extract the package and navigate to the following path: 4.6.04_Patch1\PatchInstaller\linux\CLMPatchInstaller\Disk1
   	Linux	4.6.04_Patch1.zip	Extract the package and navigate to the following path: 4.6.04_Patch1\PatchInstaller\windows\CLMPatchInstaller\Disk1

   Important

   • Ensure that you install the patch on the enterprise BMC Remedy AR System first and then on Platform Manager.
   • On the Cloud Platform Manager host, set JAVA_HOME to the bundled JRE (for example, C:\Program Files\BMC Software\BMCCloudLifeCycleManagement\JVM_1.8.0_60).
2. Install the patch on the Enterprise AR System server and the Enterprise AR System Secondary server, as follows:
   
   1. Depending on the Operating System you are on, run either 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.

      Note

      With Xmanager, X applications installed on remote UNIX-based computers run seamlessly with Windows applications side by side. You can also use the VConsole to launch the installer.

   2. On the Welcome panel, review and implement the best practices in your environment, and then click Next. 
   3. On the Installation Preview panel, review the patch installer information and then click Install. 
   4. On the Installation Summary panel, review the installation log and then click Done to finish the installation.

3. Repeat step 2 on the Cloud Platform Manager if you are running a Small Deployment. You do not have to perform this step, if you are on a compact deployment, that is, if all your components are installed on a single server.

   Tip

   While testing in the BMC lab environment, a patch is generally installed on a Platform Manager server in approximately 2-3 minutes .

4. If the My Cloud Services console or the End User Portal is installed on a remote system (for example: tomcat) and not on the Platform Manager host, you must perform step 2 on the remote system. Note that performing this step automatically updates the clmui.war file with new data.

Back to top

Configuring after installing the patch

Ensure that you perform the following post-configuration procedures after installing the patch:

To refresh the Register Provider screen

1. From the BMC Cloud Lifecycle Management Administration Console, click the vertical Workspaces menu on the left side of the window and select Providers.
2. Under Quick Links, select Custom.
3. On the Providers page, click the Edit icon.
4. In the Register Provider dialog box, complete or modify the fields, as necessary.
5. Click Submit.
   

   Note

   This is applicable only if you are upgrading from a version earlier than BMC Cloud Lifecycle Management 4.6.05.002.

   
   

To clear the cache

Use this procedure to clear Platform Manager, mid-tier, and browser cache:

1. Stop the Platform Manager service (BMC CSM on Windows, bmccsm on Linux).
2. Back up the Platform Manager cache (for example, <BMC_CLM_Installation>/Platform_Manager/cache) and Platform Manager configuration (for example, <BMC_CLM_Installation>/Platform_Manager/configuration)
3. Delete the cache folder.
4. Delete the org.eclipse.core.runtime, org.eclipse.equinox.app, and org.eclipse.osgi files from the configuration folder.
5. Restart the Platform Manager service.
6. 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.
7. Log on to the Mid Tier Configuration Tool. 
8. 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.
9. Clear the browser cache.
10. 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:

       1. ARSystem\midtier\attstore

       2. ARSystem\midtier\cache

       3. ARSystem\midtier\cachetemp

       4. ARSystem\midtier\dvmodule

       5. ARSystem\midtier\PluginsCache

       6. ARSystem\midtier\WEB-INF\atriumDeploymentPackages

       7. ARSystem\midtier\WEB-INF\AtriumWidget

       8. 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.

Related topics

Downloading the installation files
Known and corrected issues