The naming conventions in the IBM Cloud Infrastructure Center

When a volume is created or attached to virtual machines in the IBM® Cloud Infrastructure Center, storage objects are created on the backend storage provider. This section introduces the naming conventions about the storage objects created by the IBM Cloud Infrastructure Center, including the volume and storage host.

Volume

1. Volume display name in the IBM Cloud Infrastructure Center

When a volume is created in the IBM Cloud Infrastructure Center, the volume is given a display name which is shown as the name of the volume in the IBM Cloud Infrastructure Center UI.

  • If the volume is created explicitly by user as introduced in Create volumes, the display name is specified by user.

  • If the volume is created in the process of Boot From Volume, the display name is set as (vm_display_name)-(boot|data)-(BDM id) where:

    • vm_display_name is the display name of the vm to be deployed.

    • boot|data is boot for a root volume and data for a data volume.

    • BDM id is an IBM Cloud Infrastructure Center internal ID.

    Here are some examples of the volume name: mytestvm-boot-10, mytestvm-data-234

2. Volume name on the backend storage provider

When a volume is created in the IBM Cloud Infrastructure Center, a volume is created in the process on the backend storage provider.

  • For volumes created on the IBM Storage FlashSystem, the volume name on the storage backend is: volume-(display_name)(:37)-(id)(:13) where:

    • display_name is the volume display name in IBM Cloud Infrastructure Center and (display_name)(:37) means a maximum of 37 characters are used. If the display_name is more than 37 characters, only the first 37 characters are used.

    • id is the UUID of the volume in the IBM Cloud Infrastructure Center. (id)(:13) means the first 13 characters are included in the name.

    Here are some examples of the volume name on the backend storage: volume-mytestvm-boot-10-ef122565-353e, volume-mytestvm-data-234-97e2e4e4-4e7e

  • For volumes created on the IBM Storage DS8000, the volume name on the storage backend is: **OSvol:(display_name)(:10)_(vol_hex_id)***where:

    • display_name is the volume display name in the IBM Cloud Infrastructure Center and (display_name)(:10) means a maximum of 10 characters are used. If the display_name is more than 10 characters, only the first 10 characters are used.

    Here are some examples of the volume name on the backend storage: OSvol:bfv78_boot_0109, OSvol:bill_test1_0048

Host created on the backend storage provider

When a volume is attached to a virtual machine in the IBM Cloud Infrastructure Center, a host is created if it does not exist and the volume is mapped to this host. When the IBM Cloud Infrastructure Center creates the host, the host is named in the following pattern:

  1. For IBM Storage FlashSystem:

    • For z/VM, a separate host is created on the backend storage provider for each virtual machine that has FC volumes attached. The host is named in pattern: (LPAR name)_(VM userid)-(8-random-digits), where:

      • LPAR name is the name of the z/VM LPAR where the vm resides.

      • VM userid is the userid of the target VM on z/VM.

      • 8-random-digits is 8 digital characters generated randomly.

      Here are some examples of the host name on the backend storage: BOEM5401_INS00002-12160702, BOEM5409_INS00806-68067477

    • For KVM, only one single host is created on the backend storage provider for each compute node. The IBM Cloud Infrastructure Center re-uses the host if it exists in the backend storage provider. Otherwise, a host is created with the name of pattern: (KVM hostname)(:55)-(8-random-digits), where:

      • KVM hostname is the KVM hostname and (KVM hostname)(:55) means a maximum of 55 characters are used. If the KVM hostname is more than 55 characters, only the first 55 characters are used.

      • 8-random-digits is 8 digital characters generated randomly.

      Here are some examples of the host name on the backend storage: kvmperfserver-79196107, kvm4ocp9.icic.boe-49792158

  2. For IBM Storage DS8000:

    • For z/VM, a separate host is created on the backend storage provider for each virtual machine that has FC volumes attached. The host name pattern is: (OShost:(LPAR name)_(VM userid))(:32), where:

      • LPAR name is the name of the z/VM LPAR the vm resides.

      • VM userid is the userid of the target VM on z/VM.

      • (:32) means the maximum length of the entire host name is 32 characters. If the length exceeds that, the first 32 characters are used as the name.

      Here is an example of the host name: OShost:BOEM5401_INS00017.

    • For KVM, only one single host is created on the backend storage provider for each compute node. The IBM Cloud Infrastructure Center re-uses the host if it exists in the backend storage provider. Otherwise, a host is created with the name pattern: (OShost:(KVM hostname))(:32), where:

      • KVM hostname is the KVM hostname.

      • (:32) means the maximum length of the entire host name is 32. If the length exceeds that, the first 32 characters are used as the name.

      Here is an example of the host name: OShost:kvmperf4_icic_boe.