Patches

This topic contains an overview of the enhancements in patches, and provides instructions for downloading and installing the patch.

Build information

The latest patch for BMC Cloud Lifecycle Management is 4.6.07.002. The following table lists the build information for recent patches.

Updates in recent 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.

http://<Platform_Manager>:<PORT>/csm/Activity/addActivityTimeline
Method : POST
Request BODY :
{
    "timeout": -1,
    "preCallout": "",
    "postCallout": "",
    "operationParams": [ {
            "name": "transactionId",
            "type": "java.lang.String",
            "multiplicity": "1",
            "value": "b9244652-5d69-40f0-850d-8544822d9c7e"
        }, {
            "name": "ServiceOfferingInstanceId",
            "type": "java.lang.String",
            "multiplicity": "1",
            "value": "558767b4-fdc4-4266-b84f-3e11af9a68a3"
        }, {
            "name": "header",
            "type": "java.lang.String",
            "multiplicity": "1",
            "value": "MB"
        }, {
            "name": "subheader",
            "type": "java.lang.String",
            "multiplicity": "1",
            "value": "MB"
        }, {
            "name": "message",
            "type": "java.lang.String",
            "multiplicity": "1",
            "value": "test message"
        }, {
            "name": "isError",
            "type": "java.lang.Boolean",
            "multiplicity": "0..1",
            "value": false
        } ]
}

transactionId, ServiceOfferingInstanceId : Obtain from CSMRequest XML.
header : Header for Message
subHeader : Sub Heading for the message
Message : Actual Message
isError
: Specify false for success messages otherwise specify true. If true 
specified then failure sytle message will be displayed.

Corrected issues in Patch 2 for version 4.6.07

Back to top

Corrected issues in Patch 1 for version 4.6.07

Back to top

Corrected issues in Patch 1 for version 4.6.06

Back to top

Corrected issues in Patch 2 for version 4.6.05

Back to top

Corrected issues in Patch 1 for version 4.6.04

Back to top

Supported upgrade paths

You can only upgrade to a particular patch from its base feature pack version. The following table lists the supported upgrade paths:

Back to top

Preparing to install a patch 

Before installing the patch, ensure that you review and complete the following tasks:

1. Based on your deployment size, ensure that the following services are up and running, :

   • Enterprise BMC Remedy AR System primary and secondary servers
   • Platform Manager
   • QuickStart

   • Self-Check Monitor

   • Cloud Portal Web Application - This is applicable only if the My Cloud Services console or the End User Portal is installed on a remote system and not on the Platform Manager host.

2. Ensure that you have the supported versions of products in the BMC Cloud Lifecycle Management solution. For 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.

4. If you have changed the administrator password or port for the Enterprise BMC Remedy AR System application after the last time you installed BMC Cloud Lifecycle Management, do the following:

   1. On the Enterprise BMC Remedy AR System primary server, generate an encrypted password. Do the following:
      
      1. On the Enterprise BMC Remedy AR System server, navigate to the <CLMInstallationDirectory>\BMCCloudLifeCycleManagement\Utilities directory.
      2. Run the BMCCloudLifeCycleManagementMaintenanceTool.bat/sh file.
      3. Click Encrypt.
      4. In the Password and Confirm Password fields, enter the new BMC Remedy AR System password.
      5. Click Encrypt.
      6. Copy the new encrypted password.
   2. On the Enterprise BMC Remedy AR System primary server, update the encrypted password or port in the installation configuration file. Do the following:
      1. On the Enterprise BMC Remedy AR System server, navigate to the<CLMInstallationDirectory>\BMCCloudLifeCycleManagement\  directory.
      2. Open the BMCCloudLifeCycleManagementInstalledConfiguration.xml file in a text editor and search for the BMC_AR_PASSWORD_HOSTING attribute.
      3. In the value field of the attribute, update the encrypted password.
      4. Save the BMCCloudLifeCycleManagementInstalledConfiguration.xml file.
      5. Open the <ARInstallationDirectory>\ARSystemInstalledConfiguration.xml file.
      6. Search for the BMC_AR_PORT property value.
      7. If the port is not correct, update the correct port number and save the ARSystemInstalledConfiguration.xml file.
   3. On the Enterprise BMC Remedy AR System secondary server, repeat step a and b.

5. Based on your deployment size, take a VM snapshot and a database backup of the following servers:

   • Enterprise BMC Remedy AR System primary server
   • Enterprise BMC Remedy AR System secondary server, if applicable

   • Cloud Platform Manager

   • Self-Check Monitor

   • Cloud Portal Web Application - This is applicable only if the My Cloud Services console or the End User Portal is installed on a remote system and not on the Platform Manager host.

   Warning: Following BMC Remedy AR System best practices

   Installing the patch can affect the BMC Remedy AR objects in a non-overlay mode. Ensure that you follow the Enterprise BMC Remedy AR System best practices for customizations. Customizations made to the base objects in the 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 .

6. Ensure that you do not set the JAVA_HOME environment variable. 
   If the JAVA_HOME environment variable is set on any of the host servers, remove it and restart the server before upgrading BMC Cloud Lifecycle Management. 

7. Ensure that you do not set environment variables such as JRE_HOME and PATH to bundled Java that is located within a product installation directory. 

8. Ensure that you do not use bundled Java that is located in an installation directory of one product for configurations in a different product. For example, do not use C:\Program Files\BMC Software\BMCCloudLifeCycleManagement\jre, which is the bundled JRE of Cloud Portal AR Extensions in armonitor.conf of AR server for migrating it to Java 1.8. Use external JRE 1.8.

9. Ensure that the X11 libraries are installed on the Linux servers.

10. Ensure that the file paths are not specified by using environment variables like JRE_HOME, JAVA_HOME, or symbolic links in the product configuration files.
    For example, do not use /usr/bin/java  where java is a symbolic link. Replace /usr/bin/java with /usr/jre1.7.0_45/bin/java.

Back to top

Installing the patch

To install a patch in your environment, do the following:

1. Log in to the host computer as a user with administrator privileges.

2. From the  BMC Electronic Product Distribution (EPD)  location, download the patch file based on your operating system.

   Patch version	Operating System	Installation package name	To access the installation files
   4.6.07.002	Windows	CLM_FeaturePack_4.6.07.002_Windows_Installer.zip	Extract the zip package CLM_FeaturePack_4.6.07.002_Windows_Installer.zip
   	Linux	CLM_FeaturePack_4.6.07.002_Linux_Installer.tar.gz	Extract the package using the following command: tar –xvf CLM_FeaturePack_4.6.07.002_Linux_Installer.tar.gz
   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
   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
   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

3. Copy the extracted files on all the applicable VMs.

   • For compact deployment, copy the installer to the compact deployment host.
   • For small or medium deployment, copy the installer to the following hosts:
     
     • Enterprise BMC Remedy AR System primary server
     • Enterprise BMC Remedy AR System secondary server, if applicable

     • Cloud Platform Manager

     • Self-Check Monitor

     • Cloud Portal Web Application - This is applicable only if the My Cloud Services console or the End User Portal is installed on a remote system and not on the Platform Manager host.

4. Based on your deployment size, determine the hosts on which you need to install the patch.

   • For compact deployment, install the patch on the compact deployment host.
   • For small or medium deployment, install the patch on the hosts in the following sequence:
     
     1. Enterprise BMC Remedy AR System primary server
     2. Enterprise BMC Remedy AR System secondary server, if applicable

     3. Cloud Platform Manager

     4. Self-Check Monitor

     5. Cloud Portal Web Application - This is applicable only if the My Cloud Services console or the End User Portal is installed on a remote system and not on the Platform Manager host.

5. On the applicable hosts, perform the following steps:

   1. Do the following:
      • (Microsoft Windows) Navigate to the ..\CLMPatchInstaller\Disk1 directory, double-click the setup.exe file.

      • (Linux) Navigate to the ../CLMPatchInstaller/Disk1 directory and run the setup.bin file by using any X clients such as Xmanager or VConsole.

   2. On the Welcome panel, review the instructions, and click Next. 

   3. On the Details panel, read the instructions and click Next.

   4. Depending on your setup, provide the BMC Remedy AR System server details, and click Next.
   5. On the Java Information panel, select any of the following options:
      
      • Use the bundled JRE - Select this option to use the Zulu JRE that is bundled with the installer.

      • Select the JRE path- Select this option to use the external JRE. You can use one of the following options:

        • If you have purchased the Oracle Java license, use the external Oracle JRE path.

        • You can copy the Zulu JRE under ..\CLMPatchInstaller\Disk1\files to an external location and use it as the external JRE.

        Note: Java update by the installer

        The patch installer updates Java for the Platform Manager, Cloud Portal, Self-Checker, Cloud Portal Web Application. The installer does not update Java for Remedy Components which are Enterprise BMC Remedy AR System, Mid-tier, and Atrium Web Services.

   6. On the Cacerts Password Information panel, enter the Cacerts password and click Next. This password is used to restore SSL certificates from older Java cacerts to newer Java cacerts  irrespective of whether the product is configured to use HTTPS or not. 
   7. (Optional and applicable only if you have not configured RSSO details in the Platform Manager during previous upgrades) On the Remedy Single Sign-On (RSSO) Configuration panel, select Enable RSSO. Provide the following details and click Next.
      1. RSSO Service URL in the following format:
         https://<fqdnNameRSSOServer>:<port>/rsso
      2. RSSO Administrator Username
      3. RSSO Administrator Password
      4. RSSO Realm
         For information about how to configure realms, see  Configuring realms  in BMC Remedy Single Sign-On 9.1 documentation. 

      5. RSSO Session Timeout (in minutes) - This value must be equal to the timeout value set on the RSSO server. The default value is 1440 minutes.
         
         

         Note: Using RSSO

         For using the RSSO authentication, the BMC Cloud Lifecycle Management user must be present in the BMC Remedy AR System server. If you want to use the Administrator portal, you must refer to a local user. To use a SAML or LDAP user for the Administrator portal, set a local password for the user in BMC Remedy AR System server.

   1. On the Installation Preview panel, review the patch installer information and click Install. 
   2. On the Installation Summary panel, review the installation log and click Done to finish the installation.

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

If you are upgrading from a version earlier than BMC Cloud Lifecycle Management 4.6.05.002, do the following:

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.

To update BMC Remedy AR System, Atrium Web Services, and Mid-tier Configuration files

Do the following:

1. Stop the BMC Remedy AR System, Atrium Web Services, and Mid-tier services on primary and secondary hosts.

2. Upgrade the external JRE to 1.8 on BMC Remedy AR System, Atrium Web Services, and Mid-tier primary and secondary hosts. Use one of the following options:

   • Use External JRE – Oracle - Use this option only if you have purchased the Oracle Java license.
   • Use External JRE – Zulu - You can copy the JRE under ..\CLMPatchInstaller\Disk1\files to an external location.

3. Update the Java path depending on your operating system:

   Windows

   Registry key for BMC Remedy AR System, Midtier, and Atrium Web Services : HKEY_LOCAL_MACHINE\SOFTWARE\Wow6432Node\Apache Software Foundation\Procrun 2.0\<TomcatServiceName>\Parameters\Java <ARInstallationDirectory>/conf/armonitor.cfg <ARInstallationDirectory>/approval/bin/approval-utils.bat <ARInstallationDirectory>/AREmail/EmailStart.bat <ARInstallationDirectory>/AREmail/EmailStop.bat <ARInstallationDirectory>/pluginsvr/pluginsvr_config.xml <ARInstallationDirectory>/diserver/data-integration/set-pentaho-env.bat <atriumWebservicesInstallationDirectory>/wsc/atriumws81/lib/atriumwsenv.cmd

   Linux

   /etc/arsystem/<hostname>/armonitor.conf  <ARInstallationDirectory>/approval/bin/approval-utils.sh  <ARInstallationDirectory>/bin/arsystem  <ARInstallationDirectory>/AREmail/emaild.sh  <ARInstallationDirectory>/pluginsvr/pluginsvr_config.xml  <ARInstallationDirectory>/diserver/data-integration/set-pentaho-env.sh <midtier_apache_tomcat>/bin/startup.sh <midtier_apache_tomcat>/bin/shutdown.sh <atrium_webservices_tomcat>/bin/startup.sh <atrium_webservices_tomcat >/bin/shutdown.sh <atrium_webservices_tomcat>/bin/bmcAtriumSetenv.sh <atriumWebservicesInstallationDirectory>/wsc/atriumws81/lib/atriumwsenv

4. (For BMC Cloud Lifecycle environment with HTTPS/SSL) For all the following servers, import Platform Manager cacerts into the JRE using the Java keytool utility:

   1. BMC Remedy AR System primary and secondary servers

   2. All Mid-tier servers
      For more details, see  Enabling SSL .

5. Start the BMC Remedy AR System, Atrium Web Services, and Mid-tier services on primary and secondary hosts.
   

To configure RSSO agent on End User Portal

This is applicable only if you have not configured RSSO details during previous upgrades. To configure RSSO agent on the End User Portal for BMC Cloud Lifecycle Management, do the following:

1. Download the Remedy SSO 18.05 from the BMC Electronic Product Distribution (EPD) site. For Remedy SSO 18.05 download information, see  Downloading the installation files  in the Remedy Single Sign-On 18.05 documentation.

2. Extract the downloaded zip files to a temporary location.

3. Stop the End User Portal Tomcat service.
4. Do the following:
   1. Copy rsso-agent-all.jar from the ..\BMCRemedySSO\Disk1\files\rsso-agent directory to the ..\tomcat\webapps\clmui\WEB-INF\lib directory. 
   2. Copy the gson-2.3.1.jar file from ..\BMCRemedySSO-18.05.00\BMCRemedySSO\Disk1\files\lib directory to the ..\tomcat\webapps\clmui\WEB-INF\lib directory.
   3. Copy the rsso-agent.properties file from the ..\BMCRemedySSO\Disk1\files\rsso-agent directory to the ..\tomcat\webapps\clmui\WEB-INF\classes directory.
   4. Edit the rsso-agent.properties file to set the values for the following variables: 
      
      1. agent-id – The URL of the application with which the RSSO agent is integrated.
      2. logout-urls – Set the value to /rssoLogout.html.
      3. excluded-url-pattern – Append any URLs that should not be intercepted by the RSSO web agent.
      4. sso-external-url - URL of the RSSO server (for example, https://<FQDN>:8443/rsso).
      5. sso-service-url – URL of the RSSO server same (for example, https://<FQDN>:8443/rsso).
      6. msp-deployment – Set the value to false.
      7. msp-always-show-domain-entry-page – Set the value to false.

5. Edit the ..\tomcat\webapps\clmui\WEB-INF\web.xml file and uncomment the following RSSO agent filter:

   <filter>
         <filter-name>RSSOFilter</filter-name>
         <filter-class>com.bmc.rsso.agent.RSSOFilter</filter-class>
   </filter>
   <filter-mapping>
         <filter-name>RSSOFilter</filter-name>
         <url-pattern>/*</url-pattern>
   </filter-mapping>

6. Edit the ..\tomcat\webapps\clmui\WEB-INF\classes\config.properties file and set com.bmc.cloud.ui.isRSSOEnabled flag to true.
7. Restart the End User Portal Tomcat service.

8. (Optional) If you want to use Platform Manager in the SSL mode, perform these steps:

   1. Copy the keystore file on the Platform Manager from the <PlatformManagerInstallDir>/security/keystore directory to the server where the End User Portal Tomcat is installed.

   2. Run the following command to import the keystore file:

      C:\server1\jre1.8.0_73\bin>keytool.exe -importkeystore -srckeystore c:\keystore -destkeystore <pathCacertsFile>\lib\security\cacerts -srcstoretype JKS -deststoretype JKS -srcstorepass changeit -deststorepass changeit

To remove outdated version of Java 

Remove the version of Java that was shipped during earlier product installations. This Java is used for launching product maintenance tools and uninstallers. The following hosts are impacted:

• BMC AR System Server – Cloud Portal database - primary and secondary servers
• Atrium Web Services
• Atrium Orchestrator Content

Do the following:

1. Take a VM snapshot of the impacted servers: Enterprise BMC Remedy AR System - primary and secondary, Atrium Web Services, Atrium Orchestrator.

2. Back up the following directories and delete the directories:

   Host	Directory
   Enterprise BMC Remedy AR System - Primary and Secondary	<AtriumCoreInstallationDirectory>/BMCAtriumCoreInstallJVM6   <SRMInstallationDirectory>/BMCServiceRequestManagementInstallJVM <RemedyITSMSuitePreconfiguredStackInstallationDirectory>/BMCRemedyITSMSuitePreconfiguredStackInstallJVM
   Atrium Web Services	<atriumWebservicesInstallationDirectory>/BMCAtriumCoreInstallJVM6
   Atrium Orchestrator	<AOContentInstallationDirectory>/ContentInstallJVM

3. Log in to the impacted servers and ensure that you can launch the maintenance tools successfully. Use the following commands:
   
   

   <AtriumCoreInstallationDirectory>/atriumcore/AtriumCoreMaintenanceTool.sh   
<atriumWebservicesInstallationDirectory>/atriumcore/AtriumCoreMaintenanceTool.sh
<SRMInstallationDirectory>/Utilities/BMCServiceRequestManagementMaintenanceTool.sh
<AOContentInstallationDirectory>/Utilities/ContentMaintenanceTool.sh

To clear the cache

To clear the Platform Manager cache, do the following:

1. Stop the Platform Manager service.
   • Windows: BMC CSM
   • Linux: bmccsm
2. Back up the Platform Manager cache and Platform Manager configuration directories. The default values are:
   
   • Platform Manager cache: <CLMInstallationDirectory>/Platform_Manager/cache
   • Platform Manager configuration: <CLMInstallationDirectory>/Platform_Manager/configuration
3. Delete the cache directory.
4. From the configuration directory, delete the following directories:
   • org.eclipse.core.runtime
   • org.eclipse.equinox.app
   • org.eclipse.osgi
5. Start the Platform Manager service.

To clear the mid-tier cache, do the following:

1. Log in to the Mid Tier Configuration Tool. 
2. To remove all items from the caches that BMC Remedy Mid Tier maintains, perform a flush cache.
3. To hard delete the mid-tier cache, do the following:

   1. Stop the mid-tier Tomcat service.

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

      • ..\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. From the ..\ARSystem\midtier\WEB-INF\lib directory, delete the atrium-* files.
   4. From the ....\...\Apache Software Foundation\Tomcat X.X directory, delete the contents of the work and temp directories.
   5. From the ..\ARSystem\midtier\WEB-INF\Classes directory, delete the viewStats.dat and viewStats.dat.bak files.
   6. Start the mid-tier Tomcat service.

To verify the patch upgrade

Do the following:

1. Launch a browser and clear the browser cache.

2. Use the following URL to open the BMC Remedy Action Request System login page:
   http://<ARSystemhostname>:<portNumber>/arsys

3. Enter the BMC Cloud Lifecycle Management administrator details and click Log In.
4. From the left navigation pane, click Applications > Cloud Lifecycle Management > Administration console.
5. In the top-right pane, click About.
6. Ensure that the displayed version number is correct.

Back to top

Troubleshooting patch installer issues

Issue: After a successful upgrade to the latest BMC Cloud Lifecycle Management patch, when you access BMC Cloud Lifecycle Management Administration Console > Service Designer Console, the user interface is not loaded and stops responding.

Resolution: Ensure that you update the older occurrences of the Java file path in the BMC Remedy AR System, Atrium Web Services primary and secondary, and Mid-tier Configuration files with  Java 1.8 path. For details about the steps to update the older occurrences of the Java file path, see Remove outdated version of Java.

Issue: After upgrading to the latest BMC Cloud Lifecycle Management patch, when you access BMC Cloud Lifecycle Management Administration Console > Service Catalog Console, you receive the following error message:

Failed to login to the Platform Manager

Resolution: Ensure that you perform the following steps:

• Execute all the Java configurations steps. For details, see Remove outdated version of Java.
• Import the Platform manager Java cacerts into the cacerts of Java used by the BMC Remedy AR System, Atrium Web Services primary and secondary, and Mid-tier servers. For details, see the Enabling SSL HTTPS page.

Related video

The following video explains how to apply patches to BMC Cloud Lifecycle Management. It includes information related to preparing and executing the installation, verifying the installation, and troubleshooting any installation issues.

 https://youtu.be/yoV2dIg4-dI