Name
[KVM]
/opt/FJSVrcxat/bin/rcxvmdiskagt - Output of the device information recognized by a VM host
[Solaris Zones] [OVM for SPARC]
/opt/FJSVrcvat/bin/rcxvmdiskagt - Output of the device information recognized by a VM host
Format
[KVM]
rcxvmdiskagt -ip IP_address
[Solaris Zones] [OVM for SPARC]
rcxvmdiskagt -ip IP_address [-vmtype {solaris-zone|ovm-sparc}]
Description
rcxvmdiskagt is the command that outputs the device information recognized by a VM host to the standard output in XML format.
The following detailed information is displayed:
Element Name/Attribute Name | Description |
|---|---|
VmHost/ip | The admin LAN IP address for the VM host |
Disk/path | Absolute path to the raw device or partition recognized by the VM host |
Disk/size | The capacity of the raw device or partition recognized by the VM host (unit: GB) |
Element Name/Attribute Name | Description |
|---|---|
VmHost/ip | The admin LAN IP address of the global zone |
Disk/path | Mount point of a raw device or partition connected to a non-global zone, which is described in the /etc/vfstab file in the global zone |
Disk/size | The capacity of the raw device or partition recognized by the global zone (unit: GB) |
Element Name/Attribute Name | Description |
|---|---|
VmHost/ip | The admin LAN IP address for the VM host |
Disk/path | The value in which the virtual disk service name of service domain in host is combined with the volume name corresponding to raw device or partition connected with VM guest Example When the volume name and the virtual disk service name are shown as below, the value specified for here is vol0@primary-vds0. volume name: vol0 virtual disk srevice name: primary-vds0 |
Disk/size | The capacity of the raw device or partition recognized by the VM host (unit: GB) |
Option
Specify the IP address of the admin LAN for the VM host.
Specify the type of VM management software. When -vmtype is omitted, The disk resource configuration information when the VM management software is Solaris zones is displayed.
[Solaris Zones]
Speciey "solaris-zone"
[OVM for SPARC]
Specify "ovm-sparc"
Example [KVM]
>rcxvmdiskagt -ip 192.168.23.153 <RETURN>
<?xml version="1.0" encoding="utf-8"?>
<VmHost ip="192.168.23.153">
<Disks>
<Disk name="*" path="/dev/disk/by-id/scsi-3600000e00d0000000001321300010000" size="10.0"/>
<Disk name="*" path="/dev/disk/by-id/scsi-3600000e00d0000000001321300020000" size="10.0"/>
<Disk name="*" path="/dev/disk/by-id/scsi-3600000e00d0000000001321300030000" size="10.0"/>
<Disk name="*" path="/dev/disk/by-id/scsi-3600000e00d0000000001321300040000" size="10.0"/>
<Disk name="*" path="/dev/disk/by-id/scsi-3600000e00d0000000001321300050000" size="10.0"/>
</Disks>
</VmHost> |
Example [Solaris Zones]
>rcxvmdiskagt -ip 192.168.23.153 <RETURN>
<?xml version="1.0" encoding="utf-8"?>
<VmHost ip="192.168.23.153">
<Disks>
<Disk name="*" path="/ror/zones/zone1" size="10.0"/>
<Disk name="*" path="/ror/zones/zone2" size="10.0"/>
<Disk name="*" path="/ror/zones/zone3" size="10.0"/>
</Disks>
</VmHost> |
Example [OVM for SPARC]
>rcxvmdiskagt -ip 192.168.23.153 <RETURN>
<?xml version="1.0" encoding="utf-8"?>
<VmHost ip="192.168.23.153">
<Disks>
<Disk name="*" path="vol0@primary-vds0" size="10.0"/>
<Disk name="*" path="vol1@primary-vds0" size="10.0"/>
<Disk name="*" path="vol2@primary-vds0" size="10.0"/>
</Disks> |
Note
This command should be performed using a user account with administrative privileges within the operating system.
The information output by this command will be the input information for the rcxvmdisk command. Therefore, the output information must be saved as a file.
The rcxvmdisk command is included in the manager. Therefore, move the files that store the output information of this command to the server where the manager is running.
Although there are no limitations on the name of the files that store the output information of this command, when there are multiple VM hosts (or global zones in Solaris zones), users are recommended to use file names that do not overlap with the file names used on the other VM hosts. In addition, those files must have the extension "xml".
Delete the following from the output information:
Devices not used by VM guests (non-global zones in Solaris zones)
Devices not to be used nor mounted on VM hosts (global zones in Solaris Zones)
LVM disks
Delete the information on the devices already registered with the manager as disk resources for virtual L-Servers. However, this does not apply when changing registered information using the rcxadm disk modify command.
For details on the conditions of the device information output in the Disk element used for this command, refer to "Information".
When the device information registered in Resource Orchestrator is not output when this command is used, add the Disk element.
For details on the Disk element, refer to "15.4.1 Disk Resources [KVM]", "15.4.3 Disk Resources [Solaris Zones]", or "15.4.4 Disk Resources [OVM for SPARC]".
[KVM]
This command is included in the agents that operate on Red Hat(R) Enterprise Linux(R) 6 (for Intel64).
[Solaris Zones]
This command is included in the agents that operate on Solaris 10.
The devices for this command are shown as below. When defining other devices as disk resources, edit the XML definitions of the disk resource configuration information for virtual L-Servers.
Solaris standard special files (/dev/dsk/c*t*d*s*)
mplb special files (/dev/FJSVmplb/dsk/mplb*s*)
Information
The conditions for the device information to be output to the Disk element are as follows:
[KVM]
The device is a SCSI disk (a disk beginning with "scsi-" in /dev/disk/by-id/)
The device has not been mounted on the VM host at the time when this command is executed (except disks or partitions that have been mounted as /dev/sd* referring to the /etc/mtab information)
[Solaris Zones]
SCSI disks (the disk starting with "c" under /dev/dsk/ or the disk starting with "mplb" under /dev/FJSVmplb/dsk/)
The mount point of a device has been specified in a global zone (a disk which refers to the information in /etc/vfstab and whose mount point for /dev/dsk/c* disk or /dev/FJSVmplb/dsk/mplb* is set to something other than "-" in that file)
The device has not been mounted in the global zone at the time when this command is executed (except disks that have been mounted at /dev/dsk/c* or dev/FJSVmplb/dsk/mplb* referring to the /etc/mnttab information)
[OVM for SPARC]
When the service of ldmd is started on the VM host and the /sbin/ldm command can be executed, the conditions for the device information are output to the Disk element.
The volume is managed by the virtual disk service on the VM host.
SCSI disks (the disk starting with "c" under /dev/dsk/ or the disk starting with "mplb" under /dev/FJSVmplb/dsk/) recognized by VM hosts
For partitioned disks, the information for each partition is output.
When there is no raw device or partition that meets the above conditions, the elements other than the Disk element are output.
