Top
ServerView Resource Orchestrator Cloud Edition V3.1.1 Reference Guide (Command/XML)
ServerView
Part 2 File Reference > Chapter 15 XML Files > 15.2 L-Server Template > 15.2.2 Virtual L-Server Templates
PreviousNext

15.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>
    <ServerImageLink disk="Disk Deployment Settings during Image Specifications(all)" fit_disk_size="Disk Size Extension (true|false)"/>
    <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 15.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.

Disk deployment settings during image specification

(disk)

Disk deployment settings held by images

(optional)

"all"

Create an L-Server with the same disk configuration as an image.
When omitted, only system disks for images are deployed.

Disk size expansion

(fit_disk_size)

Configure the same size as the disk capacity of the image

(optional)

  • true (by default)

    Create a virtual L-Server with the same disk capacity as that of the image.

  • false

    Compare the disk size of the image and the disk size specified for the DiskSize element, and create an L-Server disk with the larger disk capacity.
    When the VM type is "VMware" or "Hyper-V", disk size expansion can be specified.
    When omitted, the disk capacity of the image is set.
    This specification is valid only when specifying images during L-Server creation.
    When creating an L-Server, if expanding the data disk space included in images, set "all" for [ServerImageLink].

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

  • Solaris Containers

  • Citrix-Xen

  • OVM-x86

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)

[VMware] [Hyper-V] [KVM] [Xen] [OVM for x86 2.2] [Citrix Xen] [OVM for x86 3.2]
Specify IA.

[Solaris Zones]
Specify SPARC.

When omitted, it is automatically configured according to the VM type.

If the VM type is not specified, "IA" is automatically configured.

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 "16.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 "16.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.

[Citrix Xen]
Specify an integer from 1 - 65535.
If omitted, no value is set.

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 "16.3.2 [Server] Tab" in the "User's Guide for Infrastructure Administrators (Resource Management) CE".

[OVM for x86 3.2]
Specify a number between 0.3 and 1024.

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 (*1)

(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 data disk, please specifies the value consecutively starting from one.
For details of the specifiable range, refer to "15.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 (*5)

(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 "16.3.3 [Disk] Tab" in the "User's Guide for Infrastructure Administrators (Resource Management) CE".
When all is specified in "ServerImageLink", and an image is specified, priority is given to the disk capacity of the image, and a disk is created.

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

    When "Solaris Containers" is configured for the VM type, it is placed in a server which has a spare server

If omitted and not specified when creating the L-Server, "None" is set.
For details on the redundancy, refer to "16.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 "16.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 "17.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 the document, referring to the following URL:

URL: http://www.vmware.com/support/pubs/

*4: When omitted, the memory reservation capacity will be the same value as the value for the memory size, and the memory overcommit function will be disabled. When using the memory overcommit function, specify the value.
*5: The disk elements can be omitted when automatically selecting the destination to store disks during L-Server creation. When creating an L-Server by specifying a template on the ROR console, configure the relevant disk elements for the template when specifying the destination to store disks.

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 VMware for the VM type and creating an L-Server template with the same disk configuration as that of an image (with 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>
  <ServerImageLink disk="all"/>
  <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>10</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>

PreviousNext
Copyright 2010-2013 FUJITSU LIMITED