Top
ServerView Resource Orchestrator Cloud Edition V3.0.0 Reference Guide for Infrastructure Administrators (Resource Management)

2.2.2 Virtual L-Server Templates

The L-Server template for virtual L-Servers is as follows:

<?xml version="1.0" encoding="utf-8"?>
<LServerTemplates>
  <LServerTemplate name="L-Server#1 Template Name" id="L-Server Template ID" label="Label">
    <Comment>Comment</Comment>
    <ServerType>Server Type</ServerType>
    <VMType>VM Type</VMType>
    <CPU>
      <CPUArch>CPU Architecture</CPUArch>
      <CPUPerf>CPU Performance</CPUPerf>
      <NumOfCPU>Number of CPUs</NumOfCPU>
      <CPUReserve>CPU Reservation Performance</CPUReserve>
      <CPUShare>CPU Shares</CPUShare>
      <CPUWeight>CPU Allocation Priority</CPUWeight>
    </CPU>
    <Memory>
      <MemorySize>Memory Size</MemorySize>
      <MemoryReserve>Memory Reservation Capacity</MemoryReserve>
      <MemoryShare>Memory Shares</MemoryShare>
      <DynamicMemory>Dynamic Memory Settings</DynamicMemory>
      <StartupRAM>Initial Memory Size</StartupRAM>
      <MemoryBuffer>Memory Buffer</MemoryBuffer>
      <MemoryWeight>Memory Allocation Priority</MemoryWeight>
    </Memory>
    <Disks>
      <Disk>
        <DiskIndex>Disk Index</DiskIndex>
        <DiskSize>Disk Size</DiskSize>
      </Disk>
    </Disks>
    <NICs>
      <NumOfNIC>Number of NICs</NumOfNIC>
    </NICs>
    <Policy>
      <Redundancy>Redundancy</Redundancy>
      <Positioning>Positioning</Positioning>
      <Repurpose>Server Automatic Release(true|false)</Repurpose>
      <OverCommit>Enabling/Disabling Overcommit</OverCommit>
      <AliveMonitoring>AliveMonitoring Setting(true|false)</AliveMonitoring>
    </Policy>
  </LServerTemplate>
  <LServerTemplate name="L-Server#2 Template Name" id="L-Server Template ID" label="Label">
  ...
  </LServerTemplate>
</LServerTemplates>
Table 2.2 List of Items Specified in L-Server Template XML Definitions for Virtual L-Servers

Element Name

Description

Remarks (Possible Values, Examples)

L-Server template name

(LServerTemplate name)

Name of L-Server template

Specify a character string beginning with an alphanumeric character and containing up to 32 alphanumeric characters, underscores ("_"), and hyphens ("-").

L-Server template ID

(LServerTemplate id)

ID for L-Server template

Optional. For internal management purposes.

Label

(LServerTemplate label)

Label for L-Server template

(optional)

Specify a character string of up to 32 alphanumeric characters or symbols.

Comment

(Comment)

Comment for L-Server template

(optional)

Specify a character string of up to 256 alphanumeric characters or symbols.

Server type

(ServerType)

Type of server to allocate as an L-Server

Specify "Virtual".

VM type

(VMType)

Type of VM to allocate as an L-Server

(optional)

  • VMware

  • Hyper-V

  • RHEL-Xen

  • RHEL-KVM

  • Oracle VM

If omitted, it must be specified when creating the L-Server.

CPU architecture

(CPUArch)

CPU architecture of the server to allocate to the L-Server

(optional)

Specify IA.

If omitted, "IA" is set.

CPU performance

(CPUPerf)

CPU performance to allocate to L-Server

Specify a number with up to one decimal place, in units of gigahertz.

For details on the scope which can be specified, refer to "10.3.2 [Server] Tab" in the "User's Guide for Infrastructure Administrators (Resource Management) CE".

Number of CPUs

(NumOfCPU)

Number of CPUs to allocate to L-Server

Specify an integer equal to or greater than "1".

For details on the scope which can be specified, refer to "10.3.2 [Server] Tab" in the "User's Guide for Infrastructure Administrators (Resource Management) CE".

CPU reservation performance (*1, *2)

(CPUReserve)

The minimum number of CPU resources to be allocated to an L-Server

(optional)

Specify a number with up to one decimal place, in units of gigahertz.

Specify a value in the range from "0" to the upper limit of the CPU performance.
If left blank, "0" is set when creating the L-Server.

CPU shares (*1)

(CPUShare)

The relative proportion for allocation of CPU resources on an L-Server

(optional)

Specify an integer equal to or greater than "1". (*3)

If left blank, the value of "the number of CPUs multiplied by 1,000" is set when creating the L-Server.

CPU allocation priority (*2)

(CPUWeight)

CPU allocation priority

(optional)

Specify an integer between 1 and 10,000.

If left blank, "100" is set when creating the L-Server. The upper limit is not checked.

Memory Size

(MemorySize)

Size of memory to allocate to L-Server

Specify a number with up to one decimal place, in units of gigabytes.

For details on the scope which can be specified, refer to "10.3.2 [Server] Tab" in the "User's Guide for Infrastructure Administrators (Resource Management) CE".

Memory reservation capacity (*1)

(MemoryReserve)

The minimum amount of memory resources to be reserved for an L-Server

(optional)

Specify a number with up to one decimal place, in units of gigabytes.

Specify a value in the range from "0" to the upper limit of Memory Size.
If left blank, the value specified for Memory Size is set when creating the L-Server. (*4)

Memory shares (*1)

(MemoryShare)

The relative proportion for allocation of memory resources on an L-Server

(optional)

Specify an integer equal to or greater than "0". (*3)

If left blank, the number determined by multiplying the value specified for Memory Size by 1024 by 10 is set when creating the L-Server.

Dynamic memory settings (*2)

(DynamicMemory)

Dynamic memory settings

(optional)

  • When enabling dynamic memory

    Specify "true".

  • When disabling dynamic memory

    Specify "false".

If left blank, the value differs depending on the setting values for Initial Memory Size and Memory Buffer.

  • Initial Memory Size and Memory Buffer are already set
    "true" is set.

  • Initial Memory Size and Memory Buffer are not set
    No value is set.

When the command is executed, "on" is displayed for expressing the enabled status and "off" for the disabled status. If left blank, no value is displayed.
When this element is not configured while exporting an L-Server template, this element will not be output.

Initial memory size (*2)

(StartupRAM)

Initial memory size

(optional)

Specify the memory size in the range of 0.1 to the value specified for Memory Size.

If left blank, the value specified for Memory Size is set when dynamic memory is enabled in L-Server creation.

If dynamic memory is disabled when creating an L-Server, the specified value is ignored.

Memory buffer (*2)

(MemoryBuffer)

Available memory to be reserved as a buffer (%)

(optional)

Specify an integer between 5 and 2000.

If left blank, "20" is set when the dynamic memory is enabled in L-Server creation. The upper limit is not checked.
If dynamic memory is disabled when creating an L-Server, the specified value is ignored.

Memory allocation priority (*2)

(MemoryWeight)

Memory allocation priority

(optional)

Specify an integer between 0 and 10,000.

The upper limit is not checked. If left blank, "5000" is set when creating the L-Server.

Disk index

(DiskIndex)

Number of the disk to allocate to the L-Server

(Optional, but required when specifying disk size)

Specify an integer starting from "0".

0: Boot disk
Other than 0: Data disk
For details of the specifiable range, refer to "2.3.2 Definition Information for Virtual L-Servers (XML)".

Creation of a virtual L-Server with no disk specified nor cloning image deployed is not possible. When not specifying a disk in the L-Server template, specify one or more disks in the XML file for the L-Server, or specify a cloning image.

Disk size

(DiskSize)

Size of disk to create

(Optional, but required when specifying disk number)

Specify a number with up to one decimal place, in units of gigabytes.

If omitted, a disk size is assigned according to the size of the image specified when creating the L-Server.
For details on the scope which can be specified, refer to "10.3.3 [Disk] Tab" in the "User's Guide for Infrastructure Administrators (Resource Management) CE".

Number of NICs

(NumOfNIC)

Number of NICs used for an L-Server

(optional)

Specify an integer equal to or greater than "1".

Redundancy

(Redundancy)

Server redundancy to allocate to L-Servers

(optional)

  • None

    No redundancy

  • HA

    Places in a server with HA set

If omitted and not specified when creating the L-Server, "None" is set.
For details on the redundancy, refer to "10.3.2 [Server] Tab" in the "User's Guide for Infrastructure Administrators (Resource Management) CE".
When "RHEL-Xen" or "RHEL-KVM" has been specified for the VM type, only "None" can be specified.

Positioning

(Positioning)

Physical location of the server to allocate to L-Servers

(optional)

  • Fixed

    Fixed physical position

  • AttachAtBoot

    Position changes upon startup

When "RHEL-Xen" has been specified for the VM type, only "Fixed" can be specified.
If omitted and not specified when creating the L-Server, Fixed is set.
For details on the positioning, refer to "10.3.2 [Server] Tab" in the "User's Guide for Infrastructure Administrators (Resource Management) CE".

Repurpose

(Repurpose)

Automatic release of servers during power off

(optional)

Specify whether 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".

When "RHEL-Xen" has been specified for the VM type, only "false" can be specified.
If omitted, no value is set. In this case, the value set in the definition file is used when creating the L-Server.
For details on the definition file, refer to "11.8.1 Installation" in the "User's Guide for Infrastructure Administrators (Resource Management) CE".

Enabling/disabling overcommit

(OverCommit)

Setting for overcommit

(optional)

Set enabling/disabling of overcommit.

If left blank, "false" is set.

When enabling overcommit, specify "true".
When disabling overcommit, specify "false".

Alive Monitoring Settings

(AliveMonitoring)

Alive Monitoring Settings

(optional)

  • When enabling alive monitoring

    Specify "true"

  • When disabling alive monitoring

    Specify "false"

If omitted and not specified when creating the L-Server, "false" is set.

*1: When the VM type of an L-Server is VMware, the specified value is reflected.
*2: When the VM type of an L-Server is Hyper-V, the specified value is reflected.
*3: 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/ (As of February 2012)

*4: 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.

Example

  • When specifying VMware for the VM type, create an L-Server template (two NICs)

    <?xml version="1.0" encoding="utf-8"?>
    <LServerTemplate name="template1" label="for virtual machine">
      <Comment>2010/XX/XX created for work A</Comment>
      <ServerType>Virtual</ServerType>
      <VMType>VMware</VMType>
      <CPU>
        <CPUArch>IA</CPUArch>
        <CPUPerf>1.0</CPUPerf>
        <NumOfCPU>2</NumOfCPU>
      </CPU>
      <Memory>
        <MemorySize>2.0</MemorySize>
      </Memory>
      <Disks>
        <Disk>
          <DiskIndex>0</DiskIndex>
          <DiskSize>100.0</DiskSize>
        </Disk>
        <Disk>
          <DiskIndex>1</DiskIndex>
          <DiskSize>200.0</DiskSize>
        </Disk>
      </Disks>
      <NICs>
        <NumOfNIC>2</NumOfNIC>
      </NICs>
      <Policy>
        <Redundancy>None</Redundancy>
        <Positioning>Fixed</Positioning>
      </Policy>
    </LServerTemplate>
  • When specifying RHEL-Xen for the VM type and creating a L-Server template to share the data disks (for one NIC)

    <?xml version="1.0" encoding="utf-8"?>
    <LServerTemplate name="template1" label="for first server">
      <Comment>2010/XX/XX created for work A</Comment>
      <ServerType>Virtual</ServerType>
      <VMType>RHEL-Xen</VMType>
      <CPU>
        <CPUArch>IA</CPUArch>
        <CPUPerf>1.0</CPUPerf>
        <NumOfCPU>1</NumOfCPU>
      </CPU>
      <Memory>
        <MemorySize>1.0</MemorySize>
      </Memory>
      <Disks>
        <Disk>
          <DiskIndex>0</DiskIndex>
          <DiskSize>40.0</DiskSize>
        </Disk>
        <Disk>
          <DiskIndex>1</DiskIndex>
          <DiskSize>80.0</DiskSize>
        </Disk>
      </Disks>
      <NICs>
        <NumOfNIC>1</NumOfNIC>
      </NICs>
      <Policy>
        <Redundancy>None</Redundancy>
        <Positioning>Fixed</Positioning>
      </Policy>
    </LServerTemplate>
  • When creating an L-Server template using detailed L-Server information

    Modify the following information.

    • Delete the Resources element

    • Modify the name attribute of the LServer element

    • Change the LServer element to the LServerTemplate element

    • Delete the name attribute of the DiskLink and Disk elements

    • Delete the NIC, NetworkLink, NICIndex, MacAddress, and IpAddress elements

    • Add the NumOfNIC element

    <?xml version="1.0" encoding="utf-8"?>
    <LServerTemplate name="L-Server-template" 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>
        <NumOfNIC>1</NumOfNIC>
      </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>
    </LServerTemplate>