Top
ServerView Resource Orchestrator V2.3.0 Reference Guide
Chapter 2 Resource Configuration Information and User Definition Information (XML Files) > 2.3 L-Servers > 2.3.1 For Physical L-Servers
PreviousNext

2.3.1 For Physical L-Servers

This section explains the XML definitions of physical 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 physical 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>
    <BootType>Boot mode</BootType>
    <PXENetworkLink name="Network resource name"/>
    <Disks>
      <Disk name="Disk name" type="Disk Connection Type">
        <DiskIndex>Disk Index</DiskIndex>
        <Exist>Existing LUN</Exist>
        <DiskLink name="Disk name of existing LUN"/>
      </Disk>
      <Disk>
        <DiskLink name="Disk name of existing LUN" />
        <DiskIndex>Disk Index</DiskIndex>
      </Disk>
      <Disk>
        <Exist>Existing LUN</Exist>
        <Shared>Shared configuration</Shared>
        <DiskLink name="Disk name of existing LUN" />
        <DiskIndex>Disk Index</DiskIndex>
      </Disk>
      <Disk name="Disk name" type="Connection type">
        <DiskIndex>Disk Index</DiskIndex>
        <DiskSize>Disk Size</DiskSize>
        <From>
          <VirtualStorage name="Virtual storage resource name"/>
          <Pool name="Storage pool name"/>
        </From>
      </Disk>
    </Disks>
    <NICGroups>
      <NICGroup>
        <NICGroupIndex>NIC redundancy group index</NICGroupIndex> 
        <NetworkLinks>
        <NetworkLink name="Network name" index="0" />
        <IpAddress>IP Address</IpAddress>
        </NetworkLinks>
        <NICLinks>
        <NICLink>Numbers of NICs contained in NIC group</NICLink>
        </NICLinks>
      </NICGroup>
    </NICGroups>
    <NICs>
      <NIC>
        <NICIndex>NIC Index</NICIndex>
        <NetworkLink name="Network name"/>
        <MacAddress auto="MAC address auto select" from="MacAddressSet" pool="Address pool"/>
        <IpAddress>IP Address</IpAddress>
      </NIC>
    </NICs>
    <HBAs>
      <HBA>
        <HBAIndex>HBAIndex</HBAIndex>
        <WWN auto="WWNAutoSelect" from="WWNAddressSet" Pool=AddressPool"/>
      </HBA>
    </HBAs>
    <IOVirtualOptionPool name="Address pool"/>
    <Policy>
      <Redundancy>Redundancy</Redundancy>
      <Priority>Priority</Priority>
      <Repurpose>Server Automatic Release(true|false)</Repurpose>
      <SpareSelection method="Spare server selection method" />
    </Policy>
    <Primary>Next server to start</Primary>
    <From>
      <PhysicalServer name="Physical server name"/>
    </From>
    <From>
      <Pool name="Server pool"/> or
      <PhysicalServer name="Physical server"/>
    </From>
    <Spare>
      <Pool name="Reserve setting server pool"/>
    </Spare>
    <Allocation>Allocation of Resources</Allocation>
    <OSSetting>
      <ComputerName>Computer name, hostname</ComputerName>
    </OSSetting>
  </LServer>
</Resources>
Table 2.3 List of Items Specified in XML Definitions for Physical L-Servers

Element Name

Description

Remarks (Possible Values, Examples)

L-Server name (*1, *2)

(LServer name)

Name of the L-Server

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

Label (*1, *2)

(LServer label)

Label for the L-Server (optional)

Character string of up to 32 alphanumeric characters or symbols

Comment (*1, *2)

(Comment)

Comment for the L-Server (optional)

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 (optional)

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 (optional)

Specify the resource name of an existing cloning image.

Specify using a name containing a resource folder.

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 (optional)

An integer
If omitted, the latest version is used.

Server type (*3)

(ServerType)

Type of server to allocate as an L-Server

Specify "Physical".

Model (*2)

(Model)

Model name of the server to allocate to L-Server

Specify the model name of the server to allocate to the L-Server.
Specify the model name of the server after selecting the server resource on the server resource tree, and checking the model name on the [Resource Details] tab.

Boot mode (*1, *2)

(BootType)

L-Server boot method

Specify the L-Server boot method.

  • Disk

    Specify this mode when performing the boot from the disk connected to the L-Server.

  • PXE

    Specify this mode when performing the network boot using PXE (Preboot eXecution Environment).

Network name for PXE boot (*1, *2)

(PXENetworkLink name)

Network resource name to perform PXE boot of the L-Server (optional)

Specify the resource name of an existing network when performing a PXE boot.

Disk name (*2)

(Disk name)

Name of the disk to allocate 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 connection type (*2)

(Disk type)

The connection method of the disk to allocate to the L-Server

  • FC

    Specify the disk with a Fibre Channel connection to allocate.

  • iSCSI

    Specify the disk with an iSCSI connection to allocate.

Setting is possible only when disks have the number 0.

If omitted, "FC" is set.

Existing LUN (*2)

(Exist)

Specify that the LUN to allocate to the L-Server was created in advance by using storage management software, or was automatically created by Resource Orchestrator (optional)

  • true

    Specify when the LUN was created in advance by using storage management software, or was automatically created by Resource Orchestrator.

  • false

    Specify when the LUN was created automatically by Resource Orchestrator.

When connecting a LUN that was created in advance by using storage management software, or was automatically created by Resource Orchestrator, this setting cannot be omitted.

Sharing Configuration (*2)

(Shared)

Shared configuration of the disk to allocate to the L-Server (optional)

  • true

    Specify when sharing the disk between multiple L-Servers.

  • false

    Specify when restricting it to one L-Server.

If left blank, "false" is set.

Disk name of the existing LUN (*2)

(DiskLink name)

Disk name of the LUN which was created in advance by using storage management software, or was automatically created by Resource Orchestrator to allocate to the L-Server (optional)

Specify the disk name to allocate.

Disk index (*2, *3)

(DiskIndex)

Number of the disk to allocate to the L-Server

Integer starting from 0
0: Boot disk
Other than 0: Data disk
Specify a number between 0 and 59.
Specify 0 if "iSCSI" was specified for the disk connection type.

Disk size (*3)

(DiskSize)

Size of disk to create

A number with up to one decimal place, in units of gigabytes
For details on the scope which can be specified, refer to "D.3 [Disk] Tab" of the "ServerView Resource Orchestrator User's Guide".

Virtual storage (*2)

(VirtualStorage name)

Virtual storage from which the disk to allocate to the L-Server is created (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.

Storage pool (*2)

(Pool name)

Resource pool for extracting the virtual storage to create the disk to allocate 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

NICGroups

(NICGroups)

A collection of NIC redundancy group definitions (optional)

Specify when NIC redundancy is necessary.

Specify one or more NICGroup tags.

NIC redundancy group (*2)

(NICGroup)

NIC redundancy group

Specify a NIC redundancy group.

NIC IP addresses with the index specified in NICLink, and the Network name, are ignored.

NIC Redundancy Index (*2)

(NICGroupIndex)

NIC redundancy index

Specify a NIC redundancy index.

Specify for each NICGroup.

Specify sequential numbers starting from 0.

NIC numbers contained in the NIC group (*2)

(NICLink)

NIC number contained in the NIC group

Specify NIC numbers contained in the NIC group.

If there are multiple NIC numbers, specify the NICLink for each NIC number.

Specify a set of redundancies.

The NIC number cannot be longer than the length of the NICGroup tag.

NIC

(NIC)

NIC definition

When not performing NIC redundancy, specify the NetworkLink tag and the NetworkLinks tag.
When not connecting a NIC to a network, the NetworkLink tag and the NetworkLinks tag are not necessary.

The child elements are the IpAddress tag, the NetworkLink tag, the NetworkLinks tag, the MacAddress tag, and the NICIndex tag.

NIC Index (*2)

(NICIndex)

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

Integer starting from 0
Specify a number between 0 and 9.
Check that sequential numbers starting from 0 are used for each NIC tag.
NIC number (NICIndex) + 1 corresponds to a network (NIC) number of the [General] tab in the [Create an L-Server] dialog.

Network Name (*2)

(NetworkLink name)

Name of the network that the L-Server connects to

Specify the name of an existing network resource.

When the network resource is an admin LAN resource or one for iSCSI, specify "untagged" for vlan_mode.

Network Index (*2)

(NetworkLink index)

Network index (Optional)

For multiple network names, specify a network index. The index starts from 0. When there is one network name, the network index can be omitted.

VLAN mode (*2)
(NetworkLink vlan_mode)

VLAN mode (optional)

Specify a VLAN mode.

The VLAN mode can be specified using the following methods:

  • Untagged VLAN Communication

    vlan_mode="untagged"

  • Tagged VLAN Communication

    vlan_mode="tagged"

When vlan_mode is omitted, tagged VLAN communication is used.

MAC address (*2)

(MacAddress)

MAC address to allocate to the L-Server
(Optional, when specifying the address pool)

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 allocated.

IP address (*2)

(IpAddress)

IP address to allocate 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 (*2)

(HBAIndex)

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

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

WWN (*2)

(WWN)

WWN to allocate to the L-Server
(Optional, when specifying the address pool)

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.

Address pool (*2)

(IOVirtualOptionPool name)

Address pool to allocate to the L-Server
If specified at the same time as MAC address and WWN, priority is given to this attribute.
(Optional, when specifying the MAC address and WWN)

Specify the resource name of the address pool to store address set resources (WWNs and MAC addresses) to allocate to L-Servers.

  • When the physical server to allocate to the L-Server is a blade server

    WWNs and MAC addresses of address set resources are the target of configuration.

  • When the physical server to allocate to the L-Server is a rack mount server

    WWNs of address set resources are the target of configuration.

The address pool can be specified using the following methods:
<IOVirtualOptionPool name="Address pool"/>
If there are address pools with the same name on different levels, the level must also be specified.
Folder name/ Pool name

Redundancy (*1, *2, *3)

(Redundancy)

Server redundancy to allocate to L-Servers
(optional)

  • None

    None

  • HA

    Specify when performing redundancy.

If omitted and not specified when creating the L-Server, None is set.
For details on redundancy, refer to "Server Recovery" in "D.2.1 When "Physical" is Selected for [Server type]" of the "ServerView Resource Orchestrator User's Guide".

Priority (*1, *2)

(Priority)

Priority when allocating resources or creating an L-Server
(optional)

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.
Smaller values indicate higher priority.
If omitted, "128" is set.
When 0 is specified, the server is excluded from batch power operations.

Server Automatic Release (*1, *2)

(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 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.
For details on the definition file, refer to "6.9.1 Installation" of the "ServerView Resource Orchestrator User's Guide".
Ensure that "true" is specified for L-Servers to change the usage of.

Spare server selection method (*1, *2)

(SpareSelection method)

Selection method for a spare server (optional)

  • name_order

    Spare servers are selected from among servers that match the model name of the operating server, in order of physical server names.

  • keep_spec

    A server that provides the same or higher performance figures as the operating server, and the least difference in performance is selected.

If omitted, "keep_spec" is set.

Server pool (*1, *2)

(Pool name)

The resource pool that comprises the physical servers allocated 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 name/ Pool name

Physical server (*1, *2)

(PhysicalServer name)

Specify the physical server to allocate to the L-Server.
If specified at the same time as server pool, priority is given to the specifications of the physical server.

Specify the physical server to allocate to the L-Server.

Reserve setting server pool (*1, *2)

(Pool name)

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 name/ Pool name

Allocation of resources

(Allocation)

Status of resources allocated to the L-Server (optional)

  • true

    Specify to allocate resources.

  • false

    Only specify when creating a configuration definition.

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

(ComputerName)

Computer name and hostname

[Windows/Linux]
For specifiable values, refer to "F.7.3 [OS] Tab Configuration" in the "ServerView Resource Orchestrator User's Guide".

*1: Values can be changed by modifying an L-Server, only when its status is "allocated" (resources have been allocated) or "preserved" (servers have been released).
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 configuration of L-Servers already created using the template will not be modified.
*2: Values can be changed by modifying an L-Server, only when its status is "defined" (only the configuration definition has been created).
*3: Specify if no L-Server template is used or if the values specified in the L-Server template will not be used.
*4: Personalizing information to be specified after the image is deployed.

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>Physical</ServerType>
    <Model>PRIMERGY BX920 S2</Model>
    <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

    <?xml version="1.0" encoding="utf-8"?>
<Resources>
  <LServer name="second_server">
    <TemplateLink name="small"/>
    <ServerType>Physical</ServerType>
    <Model>PRIMERGY BX920 S2</Model>
    <ServerImageLink name="/ImagePool/master_image"/>
    <NICs>
      <NIC>
        <NICIndex>0</NICIndex>
        <NetworkLink name="net01"/>
      </NIC>
    </NICs>
    <OSSetting>
      <ComputerName>host1</ComputerName>
    </OSSetting>
  </LServer>
</Resources>

  • Creating an L-Server that deploys a Linux cloning image without using an L-Server template

    <?xml version="1.0" encoding="utf-8"?>
<Resources>
  <LServer name="L-Server">
    <ServerImageLink name="/ImagePool/RHEL5"/>
    <ServerType>Physical</ServerType>
    <Model>PRIMERGY BX920 S2</Model>
    <BootType>Disk</BootType>
    <Disks>
      <Disk>
        <DiskIndex>0</DiskIndex>
        <DiskSize>40.0</DiskSize>
      </Disk>
      <Disk>
        <DiskIndex>1</DiskIndex>
        <DiskSize>30.0</DiskSize>
      </Disk>
    </Disks>
    <NICs>
      <NIC>
        <NICIndex>0</NICIndex>
        <NetworkLink name="net01"/>
      </NIC>
    </NICs>
    <HBAs>
      <HBA>
        <HBAIndex>0</HBAIndex>
      </HBA>
    </HBAs>
    <IOVirtualOptionPool auto="true" />
    <Policy>
      <Redundancy>None</Redundancy>
      <Priority>128</Priority>
    </Policy>
    <Repurpose>true</Repurpose>
    <Allocation>true</Allocation>
    <OSSetting>
      <ComputerName>host1</ComputerName>
    </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>
    Table 2.4 List of Items Specified in XML Definitions when Creating an L-Server in a Resource Folder or a Tenant Folder

    Element Name

    Description

    Remarks (Possible Values, Examples)

    Resource folder name or tenant folder name (*1)

    The name of a resource folder or a tenant folder to place L-Servers in (optional)

    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.

  • 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 name of the DiskLink tag and Disk tag. (Modify name if allocating an existing LUN)

      If none of these tags exist, add them.

    • Modify the MacAddress, IpAddress, and WWN tags. (If specifying an address pool for address assignment, or resources)

      If none of these tags exist, add them as necessary.

    • Modify PhysicalServer in From tags or Spare tags. (If specifying tags)

    <?xml version="1.0" encoding="utf-8"?>
<Resources>
<LServer name="P-Server2" id="WIN-66N8JTJM2BD_2853" label="">
  <Comment></Comment>
  <ServerType>Physical</ServerType>
  <Model>PRIMERGY BX920 S1</Model>
  <CPU>
    <CPUArch>ia32</CPUArch>
    <CPUPerf>2.0</CPUPerf>
    <NumOfCPU>0</NumOfCPU>
  </CPU>
  <Memory>
    <MemorySize>0.0</MemorySize>
  </Memory>
  <BootType>Disk</BootType>
  <Disks>
      <Disk name="P-Server2-0-disk0">
        <DiskIndex>0</DiskIndex>
        <DiskSize>20.0</DiskSize>
      </Disk>
  </Disks>
  <NICGroups>
  </NICGroups>
  <NICs>
    <NIC>
      <NICIndex>0</NICIndex>
      <MacAddress auto="true" from="mac_address_set"/>
      <NetworkLinks>
          <NetworkLink name="admin_lan" index="0" vlan_mode="tagged">
            <IpAddress auto="true"/>
          </NetworkLink>
      </NetworkLinks>
    </NIC>
  </NICs>
  <HBAs>
    <HBA>
      <HBAIndex>0</HBAIndex>
      <WWN auto="true" pool="/AddressPool" />
    </HBA>
  </HBAs>
  <ExternalIdentifier></ExternalIdentifier>
  <Current>
    <PhysicalServer name="chassis4-2" id="WIN-66N8JTJM2BD_83" />
  </Current>
  <ExternalProfile/>
  <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>false</DiskAllocationStatus>
    <AddressAllocationStatus>true</AddressAllocationStatus>
  </Status>
  <From>
    <PhysicalServer name="chassis4-2" id="WIN-66N8JTJM2BD_83" />
  </From>
  <Spare>
  </Spare>
</LServer>
</Resources>

PreviousNext
Copyright FUJITSU LIMITED 2011