Top
ServerView Resource Orchestrator V2.2.1 User's Guide
Appendix H XML > H.3 L-Servers
PreviousNext

H.3 L-Servers

The XML definition for an 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>
    <Model>Model Name</Model>
    <VMType>VM Type</VMType>
    <OSType>OS Type</OSType>
    <CPU>
      <CPUArch>CPU Architecture</CPUArch>
      <CPUPerf>CPU Performance</CPUPerf>
      <NumOfCPU>Number of CPUs</NumOfCPU>
    </CPU>
    <Memory>
      <MemorySize>Memory Size</MemorySize>
    </Memory>
    <Disks>
      <Disk name="Disk name">
        <DiskIndex>Disk Index</DiskIndex>
        <DiskSize>Disk Size</DiskSize>
        <From>
          <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>
    <HBAs>
      <HBA>
        <HBAIndex>HBAIndex</HBAIndex>
        <WWN auto="WWNAutoSelect" from="WWNAddressSet" Pool=AddressPool"/>
      </HBA>
    </HBAs>
    <Policy>
      <Redundancy>Redundancy</Redundancy>
      <Positioning>Positioning</Positioning>
      <Exclusion>Exclusion</Exclusion>
    </Policy>
    <Repurpose>Server Automatic Release(true|false)</Repurpose>
    <Primary>Next server to start</Primary>
    <From>
      <VmHost name="VM host resource name"/>
      <Pool name="Pool name"/>
      <PhysicalServer name="Physical server name"/>
    </From>
    <Spare>
      <Pool name="Reserve setting server pool name"/>
      <PhysicalServer name="Physical server name"/>
    </Spare>
    <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>

To place an L-Server in a specific resource folder, enclose the L-Server tag in the Folder tag, not the Resources tag.
If the Resources tag is specified, the L-Server is created in the home folder of the user that executed the operation.
To modify an already created L-Server, use the Resources tag.

<?xml version="1.0" encoding="utf-8"?>
<Folder name="Resource folder name">
  <LServer name="L-Server name" label="Label">
    ...
  </LServer>
</Folder>

Element Name

Description

Remarks (Possible Values, Examples)

L-Server name (*1, *2)

Name of the L-Server

Character string beginning with an alphanumeric character and containing up to 64 alphanumeric characters, underscores ("_"), and hyphens ("-")

Label (*1, *3)

Label for the L-Server (optional)

Character string of up to 32 alphanumeric characters or symbols

Comment (*1, *3)

Comment for the L-Server (optional)

Character string of up to 256 alphanumeric characters or symbols

L-Server template name

Name of the L-Server template to use for the L-Server (optional)

Specify the resource name of an existing L-Server template.

Image name

Name of the cloning image to deploy to the L-Server's boot disk (optional)

Specify the resource name of an existing cloning image.

For details, refer to "5.1 Creation Using an L-Server Template".

Image version

Version of the cloning image to deploy to the L-Server's boot disk (optional)

An integer
If omitted, the latest version is used.

Server type (*4)

Type of server to assign as an L-Server

When the server type is "Virtual", specify Virtual.
When the server type is "Physical", specify Physical.

Model name (Physical servers only)

Model name of the server to assign to L-Server

Specify the model name of the server to assign to the L-Server.
Specify the model name of the server after checking the basic information on the [Resource details] tab of the server resource tree.

VM type (*4)
(Virtual servers only)

Type of VM to assign as an L-Server

VMware
Hyper-V

OS type (*1)

Type of OS for the L-Server.
This setting can be omitted if an image is specified.

[VMware]
For the possible values that can be set, refer to the information displayed on the GUI, or the values described in the "NAME" column of the VMware website (*5).

[Hyper-V]
For the possible values that can be set, refer to the information displayed on the GUI, or the Name of the operating system object that can be obtained from the Virtual Machine Manager database of Microsoft(R) System Center Virtual Machine Manager 2008 R2.
This information can be obtained using Get-OperatingSystem Cmdlet.

CPU architecture (*4)

CPU architecture to assign to L-Server (optional)

IA
If omitted, IA is set.

CPU performance (*1, *4)

CPU performance to assign to L-Server

A number with up to one decimal place, in units of gigahertz
For details of the specifiable range, refer to "D.2 [Server] Tab".

Number of CPUs (*1, *4)

Number of CPUs to assign to L-Server

An integer equal to or greater than 1
For details of the specifiable range, refer to "D.2 [Server] Tab".

Memory size (*1, *4)

Size of memory to assign to L-Server

A number with up to one decimal place, in units of gigabytes
For details of the specifiable range, refer to "D.2 [Server] Tab".

Disk name

Name of the disk to assign to the L-Server (optional)

Character string beginning with an alphanumeric character and containing up to 32 alphanumeric characters, underscores ("_"), and hyphens ("-").
If omitted, a name is automatically generated.

Disk index (*4)

Number of the disk to assign to the L-Server

Integer starting from 0
0: Boot disk
Other than 0: Data disk
Specify a number between 0 and 59.

Disk size (*4)

Size of disk to remove

A number with up to one decimal place, in units of gigabytes
For details of the specifiable range, refer to size in "D.3 [Disk] Tab".

Virtual storage

Virtual storage from which the disk to assign to the L-Server is removed (optional)
If specified at the same time as storage pool, priority is given to this attribute.

Specify the resource name of an existing virtual storage.

[Hyper-V]
When specifying this element, specify the same virtual storage for all disks.

Storage pool

Resource pool for extracting the virtual storage to create the disk to assign to the L-Server (optional)

Specify the resource name of an existing storage pool.
If there are storage pools with the same name on different levels, the level must also be specified.
Folder/Pool

[Hyper-V]
When specifying this element, specify the same storage pool for all disks.

NIC Index

Number to identify the NIC definition to assign to the L-Server

An integer starting from 0.
Specify a number between 0 and 9.

Network Name

Name of the network that the L-Server connects to

Specify the name of an existing network resource.

When the server type is "Physical", for the NIC with the NICIndex 0, do not specify the network name and IP address. This NIC is used for the admin LAN. The NIC with the NICIndex 1 is used for redundancy of the admin LAN, so do not specify the network name or IP address.

MAC Address (Physical servers only)

MAC address to assign to the L-Server

The MAC address can be specified using the following methods:

  • MAC address direct specification
    <MacAddress auto="false">MAC address format</MacAddress>
    For the MAC address format, specify the MAC address in either hyphen ("-") or colon (":") delimited form.
    ("xx-xx-xx-xx-xx-xx" or "xx:xx:xx:xx:xx:xx")

  • Auto allocation
    <MacAddress auto="true" from="MacAddressSetResource"/>
    or
    <MacAddress auto="true" pool="Address pool"/>
    An address in the MAC address range set in the MACAddressSetResource or MAC address range registered in the specified address pool will automatically be assigned.

IP address

IP address to assign to the L-Server (optional)

The IP address can be specified using the following methods:
<IpAddress>IP address format</IpAddress>
Specify an IP address.

<IpAddress auto="true"/>
An IP address is automatically assigned from the address range set for the network resource.
Even if the IpAddress tag is omitted, an IP address is automatically assigned from the address range set for the network resource.

HBA Number (Physical servers only)

Number to identify the HBA definition to assign to the L-Server

Integer starting from 0
Specify a number between 0 and 1.

WWN (Physical servers only)

WWN to assign to the L-Server

The WWN can be specified using the following methods:

  • WWN direct specification
    <WWN auto="false">WWN format</WWN>
    For the WWN format, specify the WWN in colon (":") delimited form.
    ("xx:xx:xx:xx:xx:xx")

  • Auto allocation
    <WWN auto="true" from=" WWNAddressSetResource"/>
    <WWN auto="true" pool="Address pool name"/>
    An address in the WWN scope set in the WWN address set resources or WWN scope registered in the specified address pool will automatically be assigned.

Redundancy (*1, *4)

Redundancy to assign to L-Server (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.
Refer to the server redundancy on the "D.2 [Server] Tab".

Positioning (*1, *4)

Physical position to assign to L-Server (optional)

  • Fixed

    Fixed physical position

  • AttachAtBoot

    Position changes upon startup

If omitted, Fixed is set.
When the server type is "Physical", specification is not possible.

Exclusion (Virtual servers only) (*1)

Exclusive operation with another virtual server on a physical server (optional)

L-Server name or folder name.
No exclusion is performed if the L-Server or folder is not included in the access scope or the specified resource does not exist.

Server Automatic Release
(Physical servers only)

Automatic release of servers during power off (optional)

Specify whether or not to automatically release the servers assigned to the L-Server when they are powered off.
When enabling automatic release, specify true.
When not enabling automatic release, specify false.
If left blank false is set.

Next server to start
(Physical servers only)

Next server to start (optional)

Valid when true is specified for Server automatic release.
When true is specified, specify the next server to start as follows:

  • When starting from the same server
    <Primary>
    <PhysicalServer name="Physical server name"/>
    </Primary>
    A server in the server pool
    <Primary>
    <Pool name="Server pool name"/>
    </Primary>

  • When specifying automatic selection from all usable servers in the server pool
    <Primary auto="true">

If left blank, the physical server that was used the last time will be set.

VM host
(Virtual servers only)

VM host to create the VM to assign to the L-Server (valid when assigning for the first time only).
If specified at the same time as resource pool, priority is given to this attribute. (optional)

Specify the resource name of a registered VM host.

VM pool
(Virtual servers only)

Resource pool to extract the VM host to create the VM to assign to the L-Server (valid only when assigning for the first time). (optional)

Specify the resource name of a registered VM pool.
If there are VM pools with the same name on different levels, the level must also be specified.
Folder/Pool

Server pool
(Physical servers only)

The resource pool that comprises the physical servers assigned to L-Servers.

Specify the resource names of existing server pools.
If there are server pools with the same name on different levels, the level must also be specified.
Folder/Pool

Reserve setting server pool (Optional)
(Physical servers only)

Specify the server pool for reserve settings. (optional)

Valid when redundancy has been configured.
If there are server pools with the same name on different levels, the level must also be specified.
Folder/Pool

Computer name, hostname (*6)

Computer name and hostname

For values that can be specified, refer to "Table D.1 List of Settings" of the "D.5 [OS] Tab".

Full name (*6)

Full name used for Windows

Product key (*6)

Windows product key

Administrator password (*6)

Administrator password used for Windows

License mode (*6)

Client access license set for Windows

Maximum number of connections (*6)

Number of client connections set for Windows

Organization name (*6)

Organization name used for Windows

Domain name (*6)

Domain name used for the OS

DNS search path (*6)

DNS search path used for Linux

For values that can be specified, refer to "Table D.1 List of Settings" of the "D.5 [OS] Tab".
To specify multiple values, use multiple tags.
<DNSSearchPaths>
<DNSSearchPath>DNS Search Path 1</DNSSearchPath>
<DNSSearchPath>DNS Search Path 2</DNSSearchPath>
</DNSSearchPaths>

NIC Index (*6)

NIC index used to set the DNS

NIC index used to set the DNS IP address.
This index is required when the OS is Windows.
If the OS is Linux, leave the nic attribute blank.
Specify a number between 0 and 9.

DNS IP address (*6)

DNS IP address

For Windows, use the DNS IP address to set for each NIC.
For Linux, use the DNS IP address to set for the system.

Time zone (*6)

Time zone for the OS

  • For the time zones that can be specified using Windows, refer to the Microsoft website (*7).
    Convert the value from the "Index" column to a decimal, or specify a value from the "Time" column.

  • Examples of the time zones that can be specified using Linux are listed below. To specify other time zones, refer to the information displayed using commands provided by the OS such as timeconfig.

    • Asia/Tokyo

    • US/Pacific

    • US/Central

    • US/Eastern

    • Europe/Berlin

    • Europe/Amsterdam

    • Europe/London

    • Asia/Seoul

    • Asia/Hong_Kong

    • Australia/Canberra

Hardware clock configuration (*6)

Clock configuration used for Linux.

For values that can be specified, refer to "Table D.1 List of Settings" of the "D.5 [OS] Tab".

Resource folder name (*8)

Name of the resource folder to place the L-Server

To specify the level, use the following format:
Folder name/ Folder name

*1: Values can be changed by changing an L-Server when the server type is "Virtual". 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: When "Physical" has been specified for the server type and an image name has been specified, the L-Server name will be the OS hostname/computer name.
When specifying a Windows image name, enter a character string of up to 63 alphanumeric characters (upper or lowercase) for the L-Server name. The string cannot be composed solely of numbers.
*3: Values can be changed by changing an L-Server when the server type is "Physical".
*4: Only specify if no L-Server template is used or if the values specified in the L-Server template will not be used.
*5: For details on the possible values, refer to the VMware website below.

VMware web site

URL:
http://www.vmware.com/support/developer/vc-sdk/visdk400pubs/ReferenceGuide/vim.vm.GuestOsDescriptor.GuestOsIdentifier.html (As of November 2010)

*6: Personalizing information to be specified after the image is deployed. Only specify if there is no OS property definition file or if you want to change the existing values.
*7: Refer to the Microsoft web site below.

Microsoft web site

URL: http://support.microsoft.com/kb/973627/en-us/ (As of November 2010)

*8: Specify if creating an L-Server in a resource folder.

Example

  • Creating an L-Server that does not deploy a cloning image using an L-Server template (When server type is "Physical")

    <?xml version="1.0" encoding="utf-8"?>
<Resources>
  <LServer name="first_server">
    <TemplateLink name="small"/>
    <ServerType>Physical</ServerType>
    <Model>PRIMERGY BX620 S6</Model>
    <NICs>
      <NIC>
        <NICIndex>2</NICIndex>
        <NetworkLink name="net01"/>
      </NIC>
    </NICs>
  </LServer>
</Resources>

  • Creating an L-Server that does not deploy a cloning image using an L-Server template (When server type is "Virtual")

    <?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) (When server type is "Physical")

    <?xml version="1.0" encoding="utf-8"?>
<Resources>
  <LServer name="second_server">
    <TemplateLink name="small"/>
    <ServerType>Physical</ServerType>
    <ServerImageLink name="master_image"/>
    <NICs>
      <NIC>
        <NICIndex>2</NICIndex>
        <NetworkLink name="net01"/>
      </NIC>
    </NICs>
    <OSSetting>
      <ComputerName>host2</ComputerName>
    </OSSetting>
  </LServer>
</Resources>

  • Creating an L-Server that deploys a cloning image using an L-Server template (pre-configured OS property definition file) (When server type is "Virtual")

    <?xml version="1.0" encoding="utf-8"?>
<Resources>
  <LServer name="second_server">
    <TemplateLink name="small"/>
    <ServerType>Virtual</ServerType>
    <ServerImageLink name="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) (When server type is "Physical")

    <?xml version="1.0" encoding="utf-8"?>
<Resources>
  <LServer name="L-Server">
    <ServerImageLink name="RHEL5"/>
    <ServerType>Physical</ServerType>
    <Model>PRIMERGY BX620 S6</Model>
    <Disks>
      <Disk>
        <DiskIndex>0</DiskIndex>
        <DiskSize>40.0</DiskSize>
      </Disk>
      <Disk>
        <DiskIndex>1</DiskIndex>
        <DiskSize>30.0</DiskSize>
      </Disk>
    </Disks>
    <NICs>
      <NIC>
        <NICIndex>2</NICIndex>
        <NetworkLink name="net01"/>
        <MacAddress auto="true" from="MacAddressset" pool="AddressPool"/>
      </NIC>
    </NICs>
    <HBAs>
      <HBA>
        <HBAIndex>0</HBAIndex>
        <WWN auto="true" from="WnnAddressset" pool="AddressPool"/>
      </HBA>
    </HBAs>
    <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 that deploys a Linux cloning image without using an L-Server template (pre-configured OS property definition file) (When server type is "Virtual")

    <?xml version="1.0" encoding="utf-8"?>
<Resources>
  <LServer name="L-Server">
    <ServerImageLink name="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>

PreviousNext
Copyright 2010 FUJITSU LIMITED