This section explains the XML definitions of virtual L-Servers.
To specify the level, change the Resources tag to the Folder tag.
Refer to "Example Creating an L-Server in a resource folder or a tenant folder".
The XML definition for a virtual L-Server is shown below.
<?xml version="1.0" encoding="utf-8"?> <Resources> <LServer name="L-Server name" label="Label"> <Comment>Comment</Comment> <TemplateLink name="L-Server template name"/> <ServerImageLink name="image name" version="image version"/> <ServerType>Server Type</ServerType> <VMType>VM Type</VMType> <OSType>OS Type</OSType> <CPU> <CPUArch>CPU Architecture</CPUArch> <CPUPerf>CPU Performance</CPUPerf> <CPUReserve>CPU reservation performance</CPUReserve> <CPUShare>CPU shares</CPUShare> <NumOfCPU>Number of CPUs</NumOfCPU> </CPU> <Memory> <MemorySize>Memory Size</MemorySize> <MemoryReserve>Memory reservation capacity</MemoryReserve> <MemoryShare>Memory shares</MemoryShare> </Memory> <Disks> <Disk name="Disk name"> <DiskIndex>Disk Index</DiskIndex> <DiskLink name="Name of the disk created in advance"> or <DiskLink name="Source disk name to copy"> <DiskSize>Disk Size</DiskSize> <From auto="Automatic selection of storage for use"> <VirtualStorage name="Virtual storage resource name"/> <Pool name="Storage pool name"/> </From> </Disk> </Disks> <NICs> <NIC> <NICIndex>NIC Index</NICIndex> <NetworkLink name="Network name"/> <MacAddress auto="MACAddressAutoSelect" from="MacAddressSet" pool="AddressPool"/> <IpAddress>IP Address</IpAddress> </NIC> </NICs> <Policy> <Redundancy>Redundancy</Redundancy> <Positioning>Positioning</Positioning> <Exclusion>Exclusion</Exclusion> <Priority>Priority</Priority> <Repurpose>Server Automatic Release(true|false)</Repurpose> <OverCommit>Enabling/disabling overcommit</OverCommit> </Policy> <From keep="Retention of a used server" auto="Automatic selection of a used server"> <VmHost name="VM host resource name"/> <Pool name="Pool name"/> </From> <Allocation>Allocation of Resources</Allocation> <OSSetting> <ComputerName>Computer name, hostname</ComputerName> <FullName>Full Name</FullName> <ProductKey>Product Key</ProductKey> <AdminPassword>Administrator Password</AdminPassword> <CAL>License Mode</CAL> <CALMaxConnection>Maximum Number of Connections</CALMaxConnection> <OrganizationName>Organization Name</OrganizationName> <DomainName>Domain Name</DomainName> <DNSSearchPaths> <DNSSearchPath>DNS Search Path</DNSSearchPath> <DNSSearchPath>DNS Search Path</DNSSearchPath> </DNSSearchPaths> <DNSServers> <DNSServer nic="NIC Index" ip="DNS IP Address" /> <DNSServer nic="NIC Index" ip="DNS IP Address" /> </DNSServers> <TimeZone>Time Zone</TimeZone> <HardwareClock>Hardware Clock Configuration</HardwareClock> </OSSetting> </LServer> </Resources> |
Element Name | Description | Remarks (Possible Values, Examples) |
---|---|---|
L-Server name (*1, *2) (LServer name) | Name of the L-Server | Enter a name for the L-Server. |
Label (*1, *2) (LServer label) | Label for the L-Server | Character string of up to 32 alphanumeric characters or symbols |
Comment (*1, *2) (Comment) | Comment for the L-Server | Character string of up to 256 alphanumeric characters or symbols |
L-Server template name (*2) (TemplateLink name) | Name of the L-Server template to use for the L-Server | Specify the resource name of an existing L-Server template. |
Image name (*2) (ServerImageLink name) | Name of the cloning image to deploy to the L-Server's boot disk | Specify the resource name of an existing cloning image. For details, refer to "6.1 Creation Using an L-Server Template" of the "ServerView Resource Orchestrator User's Guide". |
Image version (*2) (ServerImageLink version) | Version of the cloning image to deploy to the L-Server's boot disk | An integer |
Server type (*3) (ServerType) | Type of server to allocate as an L-Server | Specify "Virtual". |
VM type (*2, *3) (VMType) | Type of VM to allocate as an L-Server |
|
OS type (*1, *2) (OSType) | Type of OS for the L-Server. | [VMware] [Hyper-V] [Xen] |
CPU architecture (*3) (CPUArch) | CPU architecture of the server to allocate to the L-Server | IA |
CPU performance (*1, *2, *3) (CPUPerf) | CPU performance to allocate to L-Server | A number with up to one decimal place, in units of gigahertz [Xen] |
CPU reservation performance (*1, *5, *6, *7) (CPUReserve) | The minimum number of CPU resources to be allocated to an L-Server | A number with up to one decimal place, in units of gigahertz
Enabled when VM type is set to "VMware". |
CPU shares (*1, *5, *6, *7) (CPUShare) | The relative proportion for allocation of CPU resources on an L-Server | An integer equal to or greater than 1 (*8)
Enabled when VM type is set to "VMware". |
Number of CPUs (*1, *2, *3) (NumOfCPU) | Number of CPUs to allocate to L-Server | An integer equal to or greater than 1 [Xen] |
Memory size (*1, *2, *3) (MemorySize) | Size of memory to allocate to L-Server | A number with up to one decimal place, in units of gigabytes [Xen] |
Memory reservation capacity (*1, *5, *6, *7) (MemoryReserve) | The minimum amount of memory resources to be reserved for an L-Server | A number with up to one decimal place, in units of gigabytes
Enabled when VM type is set to "VMware". |
Memory shares (*1, *5, *6, *7) (MemoryShare) | The relative proportion for allocation of memory resources on an L-Server | An integer equal to or greater than 0 (*8)
Enabled when VM type is set to "VMware". |
Disk name (*2) (Disk name) | The disk name to allocate to L-Servers | Character string beginning with an alphanumeric character and containing up to 32 alphanumeric characters, underscores ("_"), and hyphens ("-") |
Disk index (*2, *3) (DiskIndex) | Number of the disk to allocate to the L-Server | Integer starting from 0 [VMware] [Hyper-V] [Xen] [Oracle VM] |
Name of the disk created in advance (*2) (DiskLink name) | The name of a disk created in advance for allocation to the L-Server | Name of a disk which already exists |
Disk size (*2, *3) (DiskSize) | Size of disk to create | A number with up to one decimal place, in units of gigabytes [Xen] |
Disk shared attributes (*3) (Shared) | Specify when sharing disks among L-Servers |
|
Automatic selection of the storage to use (*2) (From auto) | Automatically selects the storage destination used for an L-Server |
If omitted, the resource is automatically selected if "Virtual storage resource name" or "Storage pool name" is not specified. |
Disk name of the source (*3) (DiskCopy name) | Data disk name of the source to copy the content from | Specify the disk name of the source data disk to copy the content from. When the VM type is "RHEL-Xen", the disk name can be specified. |
Virtual storage (*2) (VirtualStorage name) | Virtual storage from which the disk to allocate to the L-Server is created | Specify the resource name of an existing virtual storage. [Hyper-V] |
Storage pool (*2) (Pool name) | Resource pool for extracting the virtual storage to create the disk to allocate to the L-Server | Specify the resource name of an existing storage pool. [Hyper-V] |
NIC Index (*2) (NICIndex) | Number to identify the NIC definition to allocate to the L-Server | An integer starting from 0. [VMware] [Hyper-V] [Xen] [Oracle VM] |
Network Name (*2) (NetworkLink name) | Name of the network that the L-Server connects to | Specify the name of an existing network resource. |
MAC address (Media Access Control address) (MacAddress) | The MAC address to allocate to the L-Server NIC | The MAC address can be specified using the following methods: |
IP address (*2) (IpAddress) | IP address to allocate to L-Servers | The IP can be specified using the following methods: <IpAddress auto="true"/> |
Redundancy (*1, *2, *3) (Redundancy) | Server redundancy to allocate to L-Servers |
If omitted and not specified when creating the L-Server, None is set. When "RHEL-Xen" has been specified for the VM type, only "None" can be specified. |
Positioning (*1, *2, *3) (Positioning) | Physical location of the server to allocate to L-Servers |
If omitted, Fixed is set. When "RHEL-Xen" has been specified for the VM type, only "Fixed" can be specified. |
Exclusion (*1, *2) (Exclusion) | Exclusive operation with another virtual machine on a physical server | Specify the L-Server_name or the Resource_folder_name. /Folder1/Folder2 Specify resources included in the access scope. |
Priority (*1, *2) (Priority) | Priority when allocating resources or creating an L-Server | When the L-Server is the target of batch power operations, or when performing batch creation of multiple L-Servers using XMLs of resource folders, specify the priority in the range of 1 to 256. If a VM type other than "RHEL-Xen" is specified, L-Servers are created depending on the priority which has been specified. |
Server Automatic Release (*1, *2) (Repurpose) | Automatic release of servers during power off | Specify whether or not to automatically release the servers allocated to the L-Server, when they are powered off. When enabling automatic release, specify "true". When not enabling automatic release, specify "false". If the values of this attribute and "Server Automatic Release" of the L-Server template are omitted, the value that is set in the definition file is used. |
Enabling/disabling overcommit (OverCommit) | Setting for overcommit | Set enabling/disabling of overcommit. |
Retention of used servers (*2) (From keep) | Retains the server destination used for an L-Server |
If not specified, "true" is set. |
Automatic selection of the server to use (*2) (From auto) | Automatically selects the server destination used for an L-Server |
If omitted, when "VM host" or "VM pool name" is specified, the "VM host" or the "VM pool name" is given priority. When "VM host" or "VM pool name" is not specified, the resource is automatically selected. |
VM host name (*1, *2) (VmHost name) | VM host to create the VM to allocate to the L-Server | Specify the resource name of a registered VM host. |
VM pool (*1, *2) (Pool name) | Resource pool to extract the VM host to create the VM to allocate to the L-Server from | Specify the resource name of a registered VM pool. |
Allocation of resources (Allocation) | Status of resources allocated to the L-Server |
If this attribute is omitted, the value set in the definition file is used. For details on the definition file, refer to "6.9.1 Installation" of the "ServerView Resource Orchestrator User's Guide". |
Computer name, hostname (*2, *10) (ComputerName) | Computer name and hostname | [VMware] [Hyper-V] [Xen] |
Full name (*2, *10) (FullName) | Full name used for Windows | [VMware] [Hyper-V] |
Product key (*2, *10) (ProductKey) | Windows product key | |
Administrator password (*2, *10) (AdminPassword) | Administrator password used for Windows | |
License mode (*2, *10) (CAL) | Client access license set for Windows | |
Maximum number of connections (*2, *10) (CALMaxConnection) | Number of client connections set for Windows | |
Organization name (*2, *10) (OrganizationName) | Organization name used for Windows | |
Domain name (*2, *10) (DomainName) | Domain name used for the OS | |
DNS search path (*2, *10) (DNSSearchPath) | DNS search path used for Linux | To specify multiple values, use multiple tags. [VMware] [Hyper-V] |
NIC Index (*2, *10) (DNSServer nic) | NIC index used to set the DNS | NIC index used to set the DNS IP address. |
DNS IP address (*2, *10) (DNSServer id) | DNS IP address | For Windows, use the DNS IP address to set for each NIC. |
Time zone (*2, *10) (TimeZone) | Time zone for the OS |
|
Hardware clock configuration (*2, *10) (HardwareClock) | Clock configuration used for Linux | [VMware] [Hyper-V] |
*1: Values that can be changed by modifying an L-Server. Even if an L-Server template name or the content of an L-Server template specified for the L-Server template name is modified, the L-Server configuration will not be modified. Only change the OS type if no OS is installed.
*2: Values can be changed by modifying an L-Server, only when its status is "defined" (only the configuration definition has been created).
*3: Only specify if no L-Server template is used or if the values specified in the L-Server template will not be used.
*4: For details on the possible values, refer to the VMware web site below.
*5: The value can be changed using the rcxadm lserver modify command. For details on the rcxadm lserver modify command, refer to "1.3.1 rcxadm lserver".
*6: For VMware, the value can be changed.
VMware web site
URL: |
*7: For VMware, the specified value is set.
*8: For details on the values that can be specified, refer to the "vSphere Resource Management Guide" of VMware.
Refer to the relevant version of document, referring to the following URL:
URL: http://www.vmware.com/support/pubs/vs_pubs.html (As of July 2011) |
*9: When omitted, the memory reservation capacity will be the same value as the value for the memory capacity, and the memory overcommit function will be disabled. When using the memory overcommit function, specify the value.
*10: Information to be specified individually after the image is deployed. Only specify if there is no OS property definition file or if you want to change the existing values. For Oracle VM, the values cannot be specified individually. If set, the value is ignored.
*11: Refer to the Microsoft web site below.
Microsoft web site
URL: |
Example
Creating an L-Server that does not deploy a cloning image using an L-Server template
<?xml version="1.0" encoding="utf-8"?> <Resources> <LServer name="first_server"> <TemplateLink name="small"/> <ServerType>Virtual</ServerType> <OSType>Red Hat Enterprise Linux 5 (32-bit)</OSType> <NICs> <NIC> <NICIndex>0</NICIndex> <NetworkLink name="net01"/> </NIC> </NICs> </LServer> </Resources> |
Creating an L-Server that deploys a cloning image using an L-Server template (pre-configured OS property definition file)
<?xml version="1.0" encoding="utf-8"?> <Resources> <LServer name="second_server"> <TemplateLink name="small"/> <ServerType>Virtual</ServerType> <ServerImageLink name="/ImagePool/master_image"/> <NICs> <NIC> <NICIndex>0</NICIndex> <NetworkLink name="net01"/> </NIC> </NICs> <OSSetting> <ComputerName>host2</ComputerName> </OSSetting> </LServer> </Resources> |
Creating an L-Server that deploys a Linux cloning image without using an L-Server template (pre-configured OS property definition file)
<?xml version="1.0" encoding="utf-8"?> <Resources> <LServer name="L-Server"> <ServerImageLink name="/ImagePool/RHEL5"/> <ServerType>Virtual</ServerType> <CPU> <CPUPerf>1.0</CPUPerf> <NumOfCPU>1</NumOfCPU> </CPU> <Memory> <MemorySize>2</MemorySize> </Memory> <Disks> <Disk> <DiskIndex>0</DiskIndex> <DiskSize>20.0</DiskSize> </Disk> <Disk> <DiskIndex>1</DiskIndex> <DiskSize>30.0</DiskSize> </Disk> </Disks> <NICs> <NIC> <NICIndex>0</NICIndex> <NetworkLink name="net01"/> </NIC> </NICs> <Policy> <Redundancy>None</Redundancy> <Positioning>Fixed</Positioning> </Policy> <OSSetting> <ComputerName>host1</ComputerName> <DomainName>xx.zz.yy</DomainName> <DNSSearchPaths> <DNSSearchPath>10.20.30.40</DNSSearchPath> </DNSSearchPaths> </OSSetting> </LServer> </Resources> |
Creating an L-Server in a resource folder or a tenant folder
<?xml version="1.0" encoding="utf-8"?> <Folder name="Resource folder name or tenant folder name"> <LServer name="L-Server name" label="Label"> ... </L-Server> </Folder> |
Element Name | Description | Remarks (Possible Values, Examples) |
---|---|---|
Resource folder name or tenant folder name (*1) | Name of the resource folder or the tenant folder to place the L-Server in | To specify the level, use the following format: Resource_folder_name/Resource_folder_name Tenant_folder_name/Resource_folder_name Resource_folder_name/Tenant_folder_name |
*1: Specify if creating an L-Server in a resource folder or a tenant folder.
Creating an L-Server (with one NIC) on a specific host without deploying cloning images using an L-Server template (for RHEL-Xen)
<?xml version="1.0" encoding="utf-8"?> <Resources> <LServer name="first_server"> <TemplateLink name="template1"/> <ServerType>Virtual</ServerType> <OSType>Linux</OSType> <NICs> <NIC> <NICIndex>0</NICIndex> <NetworkLink name="net01"/> <MacAddress auto="true" from="mac_address_set"/> </NIC> </NICs> <From> <VmHost name="vmhost1"/> </From> </LServer> </Resources> |
Creating another L-Server using detailed L-Server information
Modify the following information.
Enclose everything in the Resources tags.
Modify the name of the LServer tag.
Delete the DiskLink, MacAddress, IpAddress tags and the name of Disk tag.
Add the OSSetting tag.
When the name field of the NetworkLink tag is left blank, add an appropriate network resource name.
The following example is used to create an L-Server that has the same configuration as one already created, using the detailed information of the L-Server created with a Linux cloning image that has been deployed.
When deploying a Windows cloning image, changes should be made referring to the XML definition shown above.
<?xml version="1.0" encoding="utf-8"?> <Resources> <LServer name="L-Server2" id="rctest_1220" label=""> <Comment></Comment> <TemplateLink name="sample_small" id="rctest_23" /> <ServerType>Virtual</ServerType> <VMType>VMware</VMType> <OSType>Red Hat Enterprise Linux 5 (32-bit)</OSType> <CPU> <CPUArch>IA</CPUArch> <CPUPerf>1.0</CPUPerf> <NumOfCPU>1</NumOfCPU> </CPU> <Memory> <MemorySize>1.0</MemorySize> </Memory> <Disks> <Disk> <DiskIndex>0</DiskIndex> <DiskSize>10.0</DiskSize> </Disk> </Disks> <NICs> <NIC> <NetworkLink name="vnet30" id="rctest_1123" /> <NICIndex>0</NICIndex> </NIC> </NICs> <ExternalIdentifier>42114bec-d26d-0c3d-c9aa-080a0c40d020</ExternalIdentifier> <Current> <VmHost name="gekkou-pri" id="rctest_62" /> <VmGuest name="L-Server1-75" id="rctest_1224" /> </Current> <ExternalProfile/> <ServerImageLink name="/ImagePool/pool" version="1" id="rctest_132" /> <Policy> <Redundancy>None</Redundancy> <Positioning>Fixed</Positioning> <Exclusion></Exclusion> <Priority>128</Priority> <Repurpose>false</Repurpose> </Policy> <Status> <ResourceStatus>stop</ResourceStatus> <PowerStatus>off</PowerStatus> <AllocationStatus>attached</AllocationStatus> <MaintenanceMode>active</MaintenanceMode> <Resources>allocated</Resources> <ServerAllocationStatus>true</ServerAllocationStatus> <DiskAllocationStatus>true</DiskAllocationStatus> <AddressAllocationStatus>true</AddressAllocationStatus> </Status> <OSSetting> <DNSSearchPaths> <DNSSearchPath>10.20.30.40</DNSSearchPath> </DNSSearchPaths> </OSSetting> </LServer> </Resources> |