Unsupported content This version of the documentation is no longer supported. However, the documentation is available for your convenience. You will not be able to leave comments.

Implementing simplified disk names

Virtual machine disks will now have display names of Disk1, Disk2,.. Diskn according to the order in which those disks were provisioned. This provides a simpler and clearer view of the disks in the BMC Cloud Lifecycle Management user interface. The original name of a disk is available in the Description field in the CloudDB. You can sort the system disks by the Name field on the Server details screen.

To implement the simplified disk names functionality, you must run the DiskRenameUtility.zip file. This topic describes how to run the utility. 

Note

You need to run this utility only if you are upgrading to BMC Cloud Lifecycle Management 4.1 from an earlier version. However, if you are upgrading from CLM 3.1.01 Patch 2, then you need not run this utility as the simplified disk names feature is included in Patch 2.

If you have directly installed BMC Cloud Lifecycle Management 4.1, the disk names will be automatically created by using the new format.

Running the DiskRenameUtility utility

Before running the utility, ensure that:

  • (For two AR server environment) Enterprise AR system server and the cloud AR System server are up and running. 
  • DSO and reconciliation is working on both the servers.
  • (For a single AR server environment) The AR System server is up and running and run the utility from the server. 

To run the DiskRenameUtility.zip file:

  1. Download the DiskRenameUtility.zip file from the following location and place it on the Cloud AR system server.
    ftp://ftp.bmc.com/pub/3101p2/DiskRenameUtility.zip 
  2. Extract the zip file and navigate to the workfolder directory and update the utility.properties file to run in any of the modes that suits your requirement. 
    For more information about the available modes, see the Available modes for the utility.properties section below. 
  3. Set the JAVA_HOME in the environment variable.
  4. (Windows) While logged on as an Administrator, open a command prompt and type:
    C:\workfolder>run.bat(Linux) Provide execute permission to the run.sh script and then run the utility:
    chmod 755 run.sh
    ./run.sh

Available modes for the utility.properties file

To run the DiskRenameUtility, you must configure the utility.properties file to run in a suitable mode. You can configure the following modes in the utility.properties file:

Mode name

Description

Print

In Print mode, the utility captures the details of disks present in the environment with their current names and the proposed new names. You can view the report by opening theoutput.html file from workfolder directory.

To specify this mode, set the PrintFlag=1.  

Output (Default mode)

After verifying the report, you can run the utility in the output mode, by setting the PrintFlag value to 0. Running the utility in output mode renames the disks to new name format.To specify this mode, set the PrintFlag=0

If no values are specified, the utility runs in the output mode.

Rollback 

In the Rollback mode, the changes made to the disk names are reverted to the original disk names.

  • 1 – Enable rollback mode
  • 0 – disable rollback mode (default)

Optional

In the Optional mode, you can also run the utility against a specific VM by specifying the VirtualguestNames property.

 For example, VirtualguestNames= vg1;vg2;vg3; 


 

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