Top
ServerView Resource Orchestrator V2.3.0 Reference Guide

2.2.2 For Virtual L-Servers

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>
      <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>
        <DiskIndex>Disk Index</DiskIndex>
        <DiskSize>Disk Size</DiskSize>
        <Shared>Disk Shared Attributes</Shared>
      </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>
    </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

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)

Character string of up to 32 alphanumeric characters or symbols

Comment

(Comment)

Comment for L-Server template (optional)

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)

VM type to allocate to the L-Server (optional)

  • VMware

  • Hyper-V

  • RHEL-Xen

  • Oracle VM

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

CPU architecture

(CPUArch)

CPU architecture to allocate to L-Server (optional)

IA
If omitted, "IA" is set.

CPU performance

(CPUPerf)

CPU performance to allocate to L-Server

A number with up to one decimal place, in units of gigahertz
For details of the specifiable range, refer to "2.3.2 For Virtual L-Servers".

CPU reservation performance (*1)

(CPUReserve)

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

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.

CPU shares (*1)

(CPUShare)

The relative proportion for allocation of CPU resources to an L-Server (optional)

An integer equal to or greater than 1 (*2)
If left blank, the value of "the number of CPUs multiplied by 1000" is set.

Number of CPUs

(NumOfCPU)

Number of CPUs to allocate to L-Server

An integer equal to or greater than 1
For details of the specifiable range, refer to "2.3.2 For Virtual L-Servers".

Memory Size

(MemorySize)

Size of memory to allocate to L-Server

A number with up to one decimal place, in units of gigabytes
For details of the specifiable range, refer to "2.3.2 For Virtual L-Servers".

Memory reservation capacity (*1)

(MemoryReserve)

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

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 the memory capacity.
If left blank, the value specified for memory capacity is set. (*3)

Memory shares (*1)

(MemoryShare)

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

An integer equal to or greater than 0 (*2)
If left blank, the number determined by multiplying the value specified for memory capacity by 1024 by 10 is set.

Disk index

(DiskIndex)

Number of the disk to allocate to the L-Server
(Optional, but required when specifying disk size)

Integer starting from 0
0: Boot disk
Other than 0: Data disk
For details of the specifiable range, refer to "2.3.2 For Virtual L-Servers".

Disk size

(DiskSize)

Size of disk to create
(Optional, but required when specifying disk number)

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 of the specifiable range, refer to "2.3.2 For Virtual L-Servers".

Disk shared attributes

(Shared)

Specify when sharing disks among L-Servers (optional)

  • true

    Specify when sharing disks among L-Servers.

  • false

    Specify when not sharing disks among L-Servers.
    When this attribute is not specified, the disk is not shared.
    When the VM type is not specified, or the software is "RHEL-Xen", the disk can be specified.
    This element cannot be specified, for disks with the number 0.
    When exporting an L-Server template, if there are no attributes, the disk is not shared.

Number of NICs

(NumOfNIC)

Number of NICs for L-Server (optional)

An integer equal to or greater than 1

Redundancy

(Redundancy)

Server redundancy to allocate to L-Servers
(optional)

  • None

    No redundancy

  • HA

    Place in a server with HA set

If omitted and not specified when creating the L-Server, None is set.
For details on redundancy, refer to "Server Recovery" in "D.2.2 When "VM" is Selected for [Server type]" of the "ServerView Resource Orchestrator User's Guide".
When "RHEL-Xen" has been specified for the VM type, only "None" can be specified.

Positioning

(Positioning)

Physical position to allocate to L-Server (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 boot location, refer to "Boot Location" in "D.2.2 When "VM" is Selected for [Server type]" of the "ServerView Resource Orchestrator User's Guide".

Repurpose

(Repurpose)

Automatic release of servers during power off
(optional)

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 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 "6.9.1 Installation" of the "ServerView Resource Orchestrator User's Guide".

Enabling/disabling overcommit

(OverCommit)

Overcommit settings (optional)

Set enabling/disabling of overcommit.
If left blank, "false" is set.

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

*1: For VMware, the specified value is set.
*2: 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)

*3: 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>
  • Specify RHEL-Xen for the VM type, and create 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>
          <Shared>true</Shared>
        </Disk>
      </Disks>
      <NICs>
        <NumOfNIC>1</NumOfNIC>
      </NICs>
      <Policy>
        <Redundancy>None</Redundancy>
        <Positioning>Fixed</Positioning>
      </Policy>
    </LServerTemplate>
  • Creating an L-Server template using detailed L-Server information

    Modify the following information.

    • Modify the name of the LServer tag.

    • Change the LServer tag to LServerTemplate tag.

    • Delete the name of the DiskLink tag and Disk tag.

    • Delete the NIC, NetworkLink, NICIndex, MacAddress, and IpAddress tags.

    • Add a NumOfNIC tag.

    <?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>