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

1.3.1 rcxadm lserver

Name

[Windows]
Installation_folder\Manager\bin\rcxadm lserver - L-Server operations

[Linux]
/opt/FJSVrcvmr/bin/rcxadm lserver - L-Server operations


Format

rcxadm lserver create -file file.xml [-nowait]
rcxadm lserver delete -name name [-allow deldisk] [-nowait]
rcxadm lserver modify -name name -file file.xml [-nowait]
rcxadm lserver list
rcxadm lserver show -name name [-format {text|xml}]
rcxadm lserver start -name name [-nowait]
rcxadm lserver stop -name name [-force] [-nowait]
rcxadm lserver restart -name name [-force] [-nowait]
rcxadm lserver move -name name [-to folder] [-nowait]
rcxadm lserver attach -name name {-size size [-disk disk] [-from {pool|vstorage}]|-disk disk} [-exist] [-index index] [-nowait]
rcxadm lserver attach -name name -net network_name [-ip ipaddress] [-nowait] rcxadm lserver detach -name name -disk disk [-online] [-system] [-force] [-allow deldisk] [-nowait]
rcxadm lserver detach -name name [-nic nic_index] [-nowait] rcxadm lserver migrate -name name [-to vmhost] [-mode {live|cold}] [-nowait] rcxadm lserver setup -name name -type network [-dryrun] rcxadm lserver set -name name -attr attr[,attr[...]] [-net network_name] rcxadm lserver convert [-name name] -with with [-label label] [-comment comment] [-to folder] [-nowait] rcxadm lserver revert -name name [-nowait]

Description

rcxadm lserver is the command used to perform L-Server management and operations.


Subcommands

create

Creates an L-Server.

delete

Deletes an L-Server. The resources allocated to the L-Server are automatically released, and the L-Server definition is also deleted.

modify

Modifies the resources comprising an L-Server.

list

Displays a list of L-Servers.

The following detailed information is displayed:

  • For Physical L-Servers

    Table 1.1 Physical L-Server Information

    Item Name

    Description

    NAME

    L-Server name

    TYPE

    Server type

    SPEC (*1)

    CPU performance, number of CPUs, and memory size

    DISKS

    Disk size

    IPADDRESSES

    IP address

    STATUS

    L-Server operation status

    RESOURCES

    Resource allocation status

    *1: Not displayed when using rack mount servers on which agents have not been registered.

  • For Virtual L-Servers

    Table 1.2 Virtual L-Server Information

    Item Name

    Description

    NAME

    L-Server name

    TYPE

    Server type

    SPEC

    CPU performance, number of CPUs, and memory size

    DISKS

    Disk size

    When there are multiple disks, they are displayed separated by commas.

    IPADDRESSES

    IP address

    When there are multiple IP addresses, they are displayed separated by commas.

    STATUS

    L-Server operation status

    RESOURCES

    Resource allocation status

show

Displays the detailed information for an L-Server.

The following detailed information is displayed:

  • For Physical L-Servers

    Table 1.3 Detailed Information for Physical L-Servers

    Item Name

    Description

    Name

    L-Server name

    Label

    Label

    Comment

    Comment

    ServerType

    Server type

    OSType

    Type of OS

    CPUArch

    CPU architecture

    CPUPerf(SPEC) (*1)

    CPU performance specified (the performance of the CPU allocated to the physical server)

    NumOfCPU(SPEC) (1)

    Number of CPUs specified (the number of CPUs (Cores) allocated to the physical server)

    MemorySize(SPEC) (*1)

    Memory size specified (the amount of memory allocated to the physical server)

    Model

    Model name of the server to allocate to L-Server

    This is displayed when an L-Server status is one of the following:

    • Resources have been allocated (allocated)

    PhysicalServer

    Physical server name

    This is displayed when an L-Server status is one of the following:

    • Resources have been allocated (allocated)

    OriginalServer

    The physical server or resource pool to allocate to L-Servers

    LastServer

    The physical server that last started the L-Server

    This is displayed when a physical L-Server status is one of the following:

    • Servers have been released (preserved)

    Status

    L-Server operation status

    PowerStatus

    L-Server power status

    Resources

    Resource allocation status

    ControlledResources

    Scope of controlled resources
    Combinations of Server and Storage are displayed.

    This is displayed for L-Servers linked to configured physical servers.

    NumOfDisk

    The number of disks

    Disk[num]

    The disk name to allocate to L-Servers

    The index number of the disk element is configured in num. The number is "0" or larger.

    This is displayed when an L-Server status is one of the following:

    • Resources have been allocated (allocated)

    • Servers have been released (preserved)

    DiskType[num]

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

    The index number of the disk element is configured in num. The number is "0" or larger.

    DiskSize[num]

    The disk size to allocate to L-Servers

    The index number of the disk element is configured in num. The number is "0" or larger.

    DiskType[num]

    Virtual disk type of the disk to be allocated to the L-Server

    The index number of the disk element is configured in num. The number is "0" or larger.

    Shared[num]

    Shared status of disks

    The index number of the disk element is configured in num. The number is "1" or larger.

    When the disk is used by multiple L-Servers, "Yes" is displayed.

    When the disk is not used by multiple L-Servers, "No" is displayed.

    OriginalStorage

    Virtual storage or resource pool to create the disk to allocate to L-Servers

    NumOfNIC

    Number of NICs

    NIC[num]

    The network resource name assigned to L-Servers

    The network element of index number is configured in num. The number is "0" or larger.

    NIC[num][MACAddress]

    MAC address of NIC

    NIC[num][PhysicalNum]

    The number of the physical NIC corresponding to the NIC of an L-Server

    The number is "0" or larger.

    NIC[num][IPAddress]

    IP address to allocate to L-Servers

    The network element of index number is configured in num. The number is "0" or larger.

    NIC[num][netlinknum][IpAddress]

    IP address

    NIC[num][netlinknum][VlanMode]

    VLAN mode

    NIC[num][netlinknum][DNSServer]

    DNS server address

    NIC[num][netlinknum][DefaultGateway]

    Default gateway address

    NICGroup[num][netlinknum][IpAddress]

    IP address

    NICGroup[num][netlinknum][VlanMode]

    VLAN mode

    NICGroup[num][netlinknum][DNSServer]

    DNS server address

    NICGroup[num][netlinknum][DefaultGateway]

    Default gateway address

    NICGroup[num][netlinknum][NicLinks]

    NIC number to be bound

    Redundancy

    Server redundancy to assign to L-Servers

    Positioning

    Physical location of the server to allocate to L-Servers

    WWNN[num]

    WWNN to assign to an L-Server

    The index number of the disk element is configured in num. The number is "0" or larger.

    WWPN[num]

    WWPN to assign to an L-Server

    The index number of the disk element is configured in num. The number is "0" or larger.

    FCConnectionPattern

    FC connection pattern file

    AliveMonitoring

    Alive monitoring setting status

    One of the following is displayed:

    • on

      This is displayed when alive monitoring is enabled.

    • off

      This is displayed when alive monitoring is disabled.

    Priority

    Priority order for L-Server creation or startup

    ReserveResources

    Retaining server resources

    iSCSI

    Name of the disk resource to allocate to the L-Server

    iSCSI DISK Index

    Index number of the disk to allocate to the L-Server

    iSCSI IQN[num][IQN]

    IQN name used for the disk connected to the L-Server using iSCSI

    The index number of the disk element is configured in num. The number is "1" or larger.

    iSCSI IpAddress

    IP address used for the disk connected to the L-Server using iSCSI

    iSCSI port

    iSCSI communication port number used for the disk connected to the L-Server using iSCSI

    FCSinglePath

    SAN Path Status

    When single-path is set, "true" is displayed.

    *1: Not displayed when using rack mount servers on which agents have not been registered.

  • For Virtual L-Servers

    Table 1.4 Detailed Information for Virtual L-Servers

    Item Name

    Description

    Name

    L-Server name

    Label

    Label

    Comment

    Comment

    Template

    L-Server template name

    ServerImage

    Image name and version

    When the L-Server version cannot be distinguished, it will not be displayed.

    ServerType

    Server type

    VMType

    VM type

    OSType

    Type of OS

    CPUArch

    CPU architecture

    CPUPerf

    CPU performance

    When the limit is not set, a hyphen ("-") is displayed.

    CPUReserve (*1)

    The minimum number of CPU resources to be allocated

    CPUShare (*1)

    The relative proportion for allocation of CPU resources

    CPUWeight (*2)

    The priority for allocation of CPU resources

    NumOfCPU

    Number of CPUs

    MemorySize

    Memory size

    MemoryReserve (*1)

    The minimum amount of memory resources to be allocated

    MemoryShare (*1)

    The relative proportion for allocation of memory resources

    StartupRAM (*2)

    Initial memory capacity to be allocated at startup

    MemoryBuffer (*2)

    Available memory to be reserved as a buffer

    MemoryWeight (*2)

    The priority for allocation of memory resources

    DynamicMemory (*2)

    Dynamic memory settings

    One of the following is displayed:

    • on

      Displayed when dynamic memory settings are enabled.

    • off

      Displayed when dynamic memory settings are disabled.

    MaxDefinableMemory (*3)

    Maximum memory size

    VmHost

    VM host name

    This is displayed when an L-Server status is one of the following:

    • Resources have been allocated (allocated)

    VmGuest

    VM name for an L-Server

    This is displayed when an L-Server status is one of the following:

    • Resources have been allocated (allocated)

    OriginalServer

    VM host or resource pool to create a virtual machine to allocate to L-Servers

    LastServer

    VM host that started the last L-Server virtual machine

    This is displayed when an L-Server status is one of the following:

    • Servers have been released (preserved)

    Status

    L-Server operation status

    PowerStatus

    L-Server power status

    Resources

    Resource allocation status

    ControlledResources

    Scope of controlled resources
    Combinations of Server and Storage are displayed.

    This is displayed for L-Servers linked to configured virtual machines.

    NumOfDisk

    The number of disks

    Disk[num]

    The disk name to allocate to L-Servers

    The index number of the disk element is configured in num. The number is "0" or larger.

    This is displayed when an L-Server status is one of the following:

    • Resources have been allocated (allocated)

    • Servers have been released (preserved)

    DiskSize[num]

    The disk size to allocate to L-Servers

    The index number of the disk element is configured in num. The number is "0" or larger.

    Shared[num]

    Shared status of disks

    The index number of the disk element is configured in num. The number is "1" or larger.

    The status is displayed when the disk is used by multiple L-Servers.

    DiskType[num]

    Virtual disk type of the disk to be allocated to the L-Server

    The index number of the disk element is configured in num. The number is "0" or larger.

    DevicePath[num]

    Device path of the disk to be allocated to the L-Server

    The index number of the disk element is configured in num. The number is "0" or larger.

    OriginalStorage

    Virtual storage or resource pool to create the disk to allocate to L-Servers

    NumOfNIC

    Number of NICs

    NIC[num]

    The network resource name assigned to L-Servers

    The network element of index number is configured in num. The number is "0" or larger.

    NIC[num][IPAddress]

    IP address to allocate to L-Servers

    The network element of index number is configured in num. The number is "0" or larger.

    NIC[num][MACAddress]

    MAC address to allocate to the L-Server

    The network element of index number is configured in num. The number is "0" or larger.

    Redundancy

    Server redundancy to assign to L-Servers

    One of the following is displayed:

    • HA

    • None

    • VMware FT

    SecondaryServer

    VM host name on which a VMware FT secondary virtual machine operates

    If access to the VM host failed, a hyphen ("-") is displayed.

    Positioning

    Physical location of the server to allocate to L-Servers

    AliveMonitoring

    Alive monitoring setting status

    One of the following is displayed:

    • on

      This is displayed when alive monitoring is enabled.

    • off

      This is displayed when alive monitoring is disabled.

    • A hyphen ("-")

      This is displayed when alive monitoring is not performed from Resource Orchestrator.

    Exclusion

    Exclusion

    When an operation, in which a resource set to be operated exclusively is outside the range of their user access, is performed, only the resource name is displayed.

    Priority

    Priority order for L-Server creation or startup

    OverCommit

    Setting for overcommit

    Only displayed when overcommit settings are enabled.

    ReserveResources

    Retaining server resources

    Snapshot[num]

    Snapshot collected from L-Servers

    The version, collected date, and comments are displayed.

    *1: When values are set for VMware, it is displayed.
    *2: When values are set for Hyper-V, it is displayed.
    *3: In RHEL-KVM, the status of allocated resources is displayed as below.
    - Resources have been allocated (allocated)
    - Servers have been released (preserved)

start

Powers on an L-Server.

stop

Powers off an L-Server.

restart

Restarts the L-Server.

move

Moves an L-Server to the specified resource folder.

attach

Connects a disk resource to an L-Server and enables it to be accessed.

[VMware] [Hyper-V] [KVM]
Adds a NIC to an L-Server.

Note

  • When an L-Server is powered on, the disk to be attached to must be recognized by the L-Server. Follow the procedure provided by the OS.

  • When using physical L-Servers, disks cannot be attached to L-Servers that use iSCSI boot.

[Hyper-V] [KVM]

When adding a NIC, ensure that the VM guest and the L-Server is powered OFF. If the VM guest or L-Server is powered ON, NIC addition will fail.

detach

Releases a disk resource from an L-Server and disables it from being accessed.

[VMware] [Hyper-V] [KVM]
Deletes a NIC of an L-Server.

Note

When deleting the disk while the physical L-Server is powered on, it is necessary to detach the disk to be deleted in advance.

[Hyper-V] [KVM]
When deleting a NIC, ensure that the L-Server is powered OFF. If the L-Server is powered ON, NIC deletion will fail.

migrate

Changes the location of an L-Server to a specified host.

Specify either to perform a live migration, which changes the location of the L-Server without stopping it, or a cold migration, which changes the location of the L-Server after temporarily stopping it.
For physical L-Servers, specification is not possible.

setup

When using a physical L-Server, the network information is sent to a specified L-Server.

The information is stored as a file in the destination server.
The storage location and file are as follows:

  • File name

    net_info.conf

  • Storage location of the file

    [Windows]
    Agent_installation_folder\Resource Orchestrator\Agent\etc\net

    [Linux]
    /etc/opt/FJSVrcxat/net/

set

Configures specific parameters, for a physical L-Server.

When the -attr option is specified, the boot mode can be set.

convert

Links an L-Server with a configured virtual machine or physical server.

revert

Cancels the link between an L-Server and a configured physical server or virtual machine.

Note

  • When the disk resource is a LUN that has been created in advance, a LUN for iSCSI boot, or a disk resource for a virtual L-Server, the data on the disk will not be deleted.
    When releasing a disk using delete or detach, it is recommended to delete the data on the disk.
    For details on the method for deleting the data on a disk, refer to cautionary notes in "7.5 Storage Resources" of the "User's Guide for Infrastructure Administrators (Resource Management) CE".

  • To prevent a disk that has been saved after detachment from virtual storage from being re-used unintentionally in an L-Server, such disks cannot be automatically selected and are not selected by create or attach when using pool specification.
    To connect a disk that has been saved after separation from virtual storage when deleting the disk to an L-Server using create or attach, specify the disk explicitly.


Options

-file file.xml

In file.xml, specify the path of the XML file that defines the resources that comprise the L-Server.

When modifying the basic information or specifications of an L-Server, only elements to be modified can be specified in the XML file.
When modifying an L-Server for which only the configuration definition has been created, unmodified information must be described also.

For details on the XML file definition, refer to "2.3 L-Servers".

[Xen]
When the VM type is "RHEL-Xen", the image name cannot be specified.

-format text|xml

Specify the display format. You can specify text or xml format.

When -format is omitted, it is displayed in text format.

When performing the following operation, specify the XML and obtain the information.

For XML, refer to "2.2 L-Server Template" or "2.3 L-Servers".

  • When changing an L-Server using a command

  • When creating an L-Server template from an existing L-Server

  • When creating an L-Server with the same configuration as an existing L-Server using a command

-nowait

Use this option to return directly to the command prompt without waiting for the operation of the L-Server specified in the subcommand to complete its execution.

-name name

In name, specify the name of the target L-Server to perform an operation with.
To specify an L-Server that is located in a tenant folder or a resource folder, it is necessary to also specify the tenant folder name or the resource folder name connected with a slash ("/").

When specifying the convert subcommand, specify the name for the L-Server. For the characters that can be used for L-Server names, refer to the list of items specified in XML Definitions in "2.3.1 Definition Information for Physical L-Servers (XML)" and "2.3.2 Definition Information for Virtual L-Servers (XML)".

When specifying the convert subcommand and omitting the -name option, the L-Server name is set as follows.

-to vmhost

For virtual L-Servers, specify the name of the destination VM host in vmhost. The VM host must be registered in a VM pool.
If this option is not specified, a VM host is automatically selected from the VM pools.

Specify a destination VM host with available CPU capacity and memory. If there is insufficient CPU capacity or memory, migration between servers or starting of L-Servers may fail.

-mode live|cold

For virtual L-Servers, specify the migration method.

  • When performing a live migration

    Specify "live".

  • When performing a cold migration

    Specify "cold".

This may not be able to be specified, depending on the power state of the VM guest.
When omitted, the appropriate type will be chosen depending on the state of the VM guest.

-force

For stop/restart, use this option to forcibly stop or restart an L-Server without shutting down the operating system it is running on.

For detach, also use this option to release disk resources, ignoring any errors which occur when releasing disk resources for physical L-Servers. Specify this option only for physical L-Servers.

-to folder

Specify a resource folder to place an L-Server in for folder. For the hierarchized resource folder, specify the resource folder name using slashes ("/"). When omitted, the L-Server is placed in the home folder.

When executed by a user who has multiple access scopes specified, it cannot be omitted. Specify a resource folder.

-size size

In size, specify the disk capacity, in units of gigabytes. Up to one decimal place can be specified.

-from pool|vstorage

Specify the name of the resource pool or virtual storage resource from which to take the disk capacity to allocate to the L-Server.

For a resource pool or a virtual storage resource located in the resource folder, specify the resource folder name using slashes ("/").

When omitted, resource selection is performed automatically with priority given to storage pools.

-disk disk

Specify the name of the disk resource to allocate to the L-Server or release from the L-Server.

-index index

Specify the disk number of the disk resource. By default, the number of the last disk allocated plus one is used. The maximum value differs according to the server type.

-online

Use this option only when removing the disk from the L-Server while the server is running. If you remove a disk in use while the server is running, inconsistencies may occur in the data or the OS management information. Use this option after checking the status of the OS and applications.

[Oracle VM]
The disk cannot be removed while the L-Server is running.

-exist

Specify when connecting an already created LUN or a disk resource created (and saved) from virtual storage.

Specify this option only for physical L-Servers or virtual L-Servers with RHEL-KVM or Hyper-V.

When specifying this option for virtual L-Servers with Hyper-V, the -size option cannot be specified at the same time.

-dryrun

The network information file is output.

NIC0_MacAddress="xx:xx:xx:xx:xx:xx"

# Single NIC Information
SingleNics="0"
NIC0_NetworkLinks="0"

NIC0_0_VlanMode="untagged"
NIC0_0_IpAddress="192.168.24.124"
NIC0_0_Vlanid=1
NIC0_0_Netmask="255.255.255.0"
NIC0_0_DefaultGateway="192.168.24.254"
-attr attr

For physical L-Servers, set the boot mode and SAN path status.

  • For boot mode, specify "-attr boot={default|pxe}".

    • When setting the boot mode to PXE

      Specify "pxe".

    • When setting the initial boot mode.

      Specify "default".

  • When setting SAN path status, specify "-attr fcsinglepath={true|false}".

    • When setting a single-path to the SAN for the physical L-Server

      Specify "true".

    • When setting a multi-path to the SAN for the physical L-Server

      Specify "false".

    • If the SAN path status for the physical L-Server and the value specified in this option are the same

      The current settings are kept.

    • If the physical L-Server is powered on

      If this option is specified, an error will occur.

Both boot and fcsinglepath can be specified at the same time.

-net network_name

In network_name, specify the network resource name to perform PXE boot.

When PXE is set for the boot mode, perform PXE boot from the network of the specified network resource.

-allow deldisk

This option can only be specified for deldisk.

Specify this option when there are no problems even if disk contents are deleted by the following operations. Omitting this option will cause an operational failure when there is the possibility that disk contents will be deleted by these operations.

  • Deleting an L-Server

  • Releasing disk resources from an L-Server

-deny deldisk

This option can only be specified for deldisk.

Specify this option when the content of the disk is to be saved rather than deleting the disk resource from virtual storage, as the following procedure describes.

  • Releasing disk resources from an L-Server

Specify this option only for physical L-Servers or virtual L-Servers with Hyper-V. This option and the -allow deldisk option cannot be specified at the same time.
When the disk resource is not a LUN created in advance, either -allow deldisk or -deny deldisk must be specified.

The option is only valid when detaching a disk. The disk resource cannot be saved permanently by using this option.
When this option is to be used to save the content of the disk rather than deleting the disk resource from virtual storage, the disk resource is automatically registered in the storage pool in which the virtual storage resource that is the origin of the disk resource is registered.

-type network

For physical L-Servers, specify in order to send network information to the L-Server that is specified for the -name option.

-label label

In label, specify the label for the L-Server.

-comment comment

In comment, specify the comments for the L-Server.

-with with

In with, specify the virtual machine or physical server linked to an L-Server.

Specify the resource folder name or the resource pool name connected with slashes ("/").

/Resource_folder_name/Resource_pool_name/VM_host_name/Virtual_machine_name
/Resource_folder_name/Resource_pool_name/Physical_server name
/Resource_pool_name/VM_host_name/Virtual_machine_name
/Resource_pool_name/Physical_server_name
-nic nic_index

Specify a network index to delete.

-ip ipaddress

Specify the IP address to allocate to the NIC. If omitted, an address is automatically allocated.


Examples