Unsupported content

 

This version of the product has reached end of support. The documentation is available for your convenience. However, you must be logged in to access it. You will not be able to leave comments.

Implementing simplified disk names in the legacy console

Virtual machine disks have display names of Disk1, Disk2,.. Diskn according to the order in which those disks were provisioned. This naming convention 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.5 or later from a version earlier than 4.1. However, if you are upgrading from CLM 3.1.01 Patch 2, you do need to run this utility because the simplified disk names feature is included in Patch 2.

If you have directly installed BMC Cloud Lifecycle Management 4.5 or later, the disk names are created automatically by using the new format.

Running the DiskRenameUtility utility

Before running the utility, ensure that:

  • (For a two AR server environment) The 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 you 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 suit your requirement. 
    For more information about the available modes, see Available modes for the utility.properties
  3. Set the JAVA_HOME in the environment variable.
  4. Perform one of the following actions:
    • (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 nameDescription
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 the output.html file from workfolder directory.

To specify this mode, set 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 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; 


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.

Comments