4.6.05 enhancements

This topic provides a list of the enhancements included in version 4.6.05 of the BMC Cloud Lifecycle Management solution. It also provides an overview of how to get started with the new version. The topic includes the following sections:

Version 4.6.05 enhancements

Version 4.6.05 is available on the Customer Support website at http://www.bmc.com/support.

The following table outlines the features in this release and where you can find more information:

Category	Description
Azure provider	The following enhancements were introduced for the Azure provider: BMC Cloud Lifecycle Management supports nested templates. In this case, a "nested" template is a template that the Master template refers to. You can provision to an existing resource group (instead of having BMC Cloud Lifecycle Management create a new resource group for each SOI).For more information, see Product compatibility and limitations for the Azure provider. New blueprint parameters such as resource-container, AZURE_OS_TYPE, and Azure_StorageAccount_Name were added. (For a complete list, see Service blueprint parameters for Azure.) When onboarding a logical data center (LDC) with Azure Resource Manager template-based provisioning, you can select a virtual network or a region. When onboarding an LDC through compute- or instance-based provisions (without Azure Resource Manager templates), you can select only a virtual network. (See Managing Logical Data Centers for the Azure Provider and Provisioning for Azure Resource Manager (with or without templates).) The `EnrollServerForNativeManagement` and `ValidateAgentStatus` attributes were added in the providers.json file. For more information, see Access attributes for service providers and cloud services. Support for Azure Resource Manager has been expanded beyond templates. Version 4.6.05 also supports functionality that it supports for the classic Azure Services Manager, such as: Multi-NIC provisioning Single-tier provisioning and decommissioning Adding software to a service offering instance Day 1 and Day 2 actions for CPU and memory Day 2 actions (such as Add Software) Stopping and starting services and servers Transfer ownership, request on behalf of, sharing services Note BMC Cloud Lifecycle Management 4.6.05 shipped with the latest Microsoft Azure Java SDK available at the time of the release. The version is 1.0.0-beta4-SNAPSHOT, and is still a BETA version. When Microsoft officially releases the Azure Java SDK, BMC will run a re-certification to verify that no functionality is affected. Then, if necessary, BMC will release a hotfix to address any found issues.
Activity log messages	VMware and AWS troubleshooting messages for the following activities appear in the Activity Timeline Details window: Transaction requestable offering (TRO or Day 2) actions Operator actions used to manage the services and servers For more information, see Using the Activity Log.
Support for Docker swarm mode	You can register a cluster of Docker engines in swarm mode. For more information, see PaaS provisioning for Docker.
Synchronizing migrated server infrastructure	To make sure that your upgraded server infrastructure and BMC Cloud Lifecycle Management SOIs are synchronized and are always running with updated resources, you can run `migrate` SDK commands for service instances whose infrastructure servers are migrated across virtual clusters (VCs), VC appliances, clusters, PODs, network centers (NCs), switches, and so on. For more information, see Synchronizing migrated server infrastructure.
API and SDK	The following updates were made to the API and SDK: An addActivityTimeline API was added to the Activity class. This API adds a new timeline entry with a specified message in a specified activity record. This method is useful for BMC Atrium Orchestrator callouts or customization logic to inject additional provisioning updates or similar actions to end users. New `migrate` commands were added to the SDK to aid in synchronizing migrated server infrastructure. See `cluster`, `host`, `resource-pool`, and `service`.

Downloading the feature pack

To download version 4.6.05 , see Downloading the installation files.

Preparing to install the feature pack

Before installing the feature pack, ensure that the following conditions are met:

If you are using any of the earlier versions, upgrade to BMC Cloud Lifecycle Management version 4.6.00.
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.
Close any open session of BMC Remedy Developer Studio before running the installer.
Make sure that the Enterprise BMC Remedy AR System Primary server is running.
Make sure that the primary BladeLogic Application Server is running.
Make sure that the Quick Start service is running.
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 BMCCloudLifeCycleManagementInstalledConfiguration.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.
Make sure that the BMC Remedy AR System ports specified in the BMCCloudLifeCycleManagementInstalledConfiguration.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.
Take a VM snapshot and a database backup of the enterprise AR System server and Platform Manager.
Ensure that the JAVA_HOME variable is set on the servers where you are installing the feature pack. On Linux servers, ensure that X11 libraries are installed.
Save any customizations performed in non-overlay mode. Otherwise, they are deleted during the feature pack installation.
Warning

Installing the feature pack can affect the AR objects in a non-overlay mode. Ensure that you follow the best practices for customizations. For more information, see Creating overlays with BPCU for existing customizations.

Installing the feature pack

This section describes the procedure to install the latest feature pack.

Note

For installing the latest feature pack on a single-VM compact deployment setup, place the installer file on the host and extract the files. Perform step 2 to install the feature pack.

To install the latest feature pack

For Small Deployment environment (Multiple VMs), the following installation sequence of Feature Pack 4.6.05 is critical.
For Compact Deployment environment (Single VM), the installation sequence of Feature Pack 4.6.05 does not apply.

Note

In the BMC lab environment, installing the feature pack took about 15 minutes in the Windows Compact Deployment.

Download and extract the Feature Pack 4.6.05 installer (CLM_FeaturePack_4.6.05_Windows_Installer.zip for Windows and CLM_FeaturePack_4.6.05_Linux_Installer.tar.gz for Linux) and place a copy on each of the VMs that have the following components installed:
1. Enterprise BMC Remedy AR System Primary server
2. Enterprise AR System Secondary server, if applicable
3. Cloud Platform Manager
  Notes
  
  Install the feature pack on the enterprise BMC Remedy AR System first and then on Platform Manager.
  For Linux, extract the installer by using the tar –xvf CLM_FeaturePack_4.6.05_Linux_Installer.tar.gz command.
  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).
4. Standalone CLM Self-Check Monitor
5. Standalone Cloud Portal Web Application (clmui)
On the Enterprise AR System server, install patch:
1. Start one of the following installation programs:
  - On Microsoft Windows, navigate to the ..CLM_FeaturePack_4.6.05_Windows_Installer\CLMPatchInstaller\Disk1 location and then run the setup.exe file or double-click the setup.exe file.
  - On Linux, navigate to the .. CLM_FeaturePack_4.6.05_Linux_Installer/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 panel, review and implement the best practices in your environment, and then click Next.
  For example, take a snapshot of the host, back up the database, and so on.
3. Review the components detected by the installer, and then click Next.
  The installer applies updates to the detected components.
4. On the Directory Selection panel, review the location on the host where you want to install the BMC Cloud Lifecycle Management feature pack files and then click Next.
  You can accept the default value if you do not have a specific location for the installation files.
5. On the Installation Preview panel, review the patch installer information (for example, the location of the feature pack) and then click Install.
6. On the Installation Summary panel, review the installation log and then click Done to finish the installation.
Repeat step 2 on the Enterprise AR System Secondary server if you are running a Small Deployment.
This step does not apply to Compact Deployment.
Repeat step 2 on the Cloud Platform Manager host if you are running a Small Deployment.
This step does not apply to Compact Deployment.
Repeat step 2 on the standalone CLM Self-Check Monitor host if you are running a Small Deployment.
This step does not apply to Compact Deployment.
Repeat step 2 on the standalone Cloud Portal Web Application (clmui) host if you are running a Small Deployment.
This step does not apply to Compact Deployment.

Configuring after installing the feature pack

Perform the following post configuration procedures after installing the latest feature pack:

To clear the cache on the primary mid-tier

Use this procedure to clear the cache on the primary mid-tier host.

Log on to the Mid Tier Configuration Tool for the primary mid-tier installed in your cloud environment. This mid-tier is different than the mid-tier running on the enterprise AR System server.
Perform a flush cache.
The flush cache removes all items from the cache that the primary 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.
Clear the browser cache.

To clear the cache on the secondary mid-tier hosts

Use this procedure to clear the cache on secondary mid-tier hosts. You do not need to perform these steps for the mid-tier running on the Enterprise AR System server.

Log on to the Mid Tier Configuration Tool for the secondary mid-tiers used by the BMC Cloud Lifecycle Management console that are different than the mid-tier running on the enterprise AR System server.
Perform a flush cache.
The flush cache removes all items from the caches that the secondary 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.
Clear the browser cache.
Perform the following steps to hard delete the secondary 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.