Top
ServerView Resource Orchestrator Cloud Edition V3.1.1 Reference Guide (Command/XML)
ServerView
Part 1 Command Reference > Chapter 3 Resource Operations > 3.6 rcxadm lserver
PreviousNext

3.6 rcxadm lserver

Name

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

[Linux Manager]
/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 modify -name name -disk disk -size size [-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 [-define] -net network_name [-ip ipaddress] [-nowait]
rcxadm lserver detach -name name -disk disk [-online] [-system] [-force] [-allow deldisk] [-nowait]
rcxadm lserver detach -name name [-define] -nic nic_index [-nowait]
rcxadm lserver migrate -name name [-to vmhost] [-mode {live|cold}] [-force] [-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 [-force] [-nowait]

Description

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


Subcommands

create

Creates an L-Server.

Note

  • For Physical L-Servers

    Due to restrictions of the hardware to configure, a maximum of two commands to create physical L-Servers can be executed at the same time. When creating two or more physical L-Servers, wait some time after executing the command, and then execute the next command.

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.

[VMware] [Hyper-V]
Increases the disk capacity already allocated to an L-Server.

list

Displays a list of L-Servers.

The following detailed information is displayed:

  • For Physical L-Servers

    Table 3.14 Physical 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

    IPADDRESSES

    IP address

    STATUS

    L-Server operation status

    RESOURCES

    Resource allocation status

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

  • For Virtual L-Servers

    Table 3.15 Virtual L-Server Information

    Item Name

    Description

    NAME

    L-Server name

    TYPE

    Server type

    SPEC

    CPU performance, number of CPUs, and memory size

    [Solaris Zones] [Citrix Xen]
    Refer to *5 in "Table 3.17 Detailed Information for Virtual L-Servers".

    DISKS

    Disk size

    When there are multiple disks, they are displayed separated by commas.
    If the disk capacity cannot be obtained, a hyphen ("-") is displayed.

    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:

Note

The number and display order of the items may be changed by enhancement of Resource Orchestrator.

  • For Physical L-Servers

    Table 3.16 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) (*)

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

    NumOfCPU(SPEC) (*)

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

    MemorySize(SPEC) (*)

    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)

    ServerPool

    The name of the pool in which the physical servers allocated to L-Servers are registered

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

    • Resources have been allocated (allocated)

    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 disks have been allocated or disks to use have been specified for the L-Server.

    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.

    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.

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

    • Resources have been allocated (allocated)

    • Servers have been released (preserved)

    OriginalStorage[num]

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

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

    StoragePool[num]

    The name of an allocated storage pool

    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)

    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.

    UseInfraUser

    L-Server that infrastructure administrators are authorized to operate (L-Server for Infrastructure Administrators)

    "allow" is displayed.

    SpareServerForceOFF

    When Physical servers in Spare server pool are running out; use the Physical server that is set "Allow forced turning off" after performing force OFF the target Physical server. Then "true" is displayed.

    AllowForceOFF

    When Physical servers in Spare server pool are running out; allow to perform force OFF the target Physical server even if that server is Power on. Then "true" is displayed.

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

  • For Virtual L-Servers

    Table 3.17 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.

    Deploy Disk (*1)

    Data disk deployment settings for images

    • When configuring the settings in the same configurations as those for images

      "all" is displayed.

    ServerType

    Server type

    VMType

    VM type

    OSType

    Type of OS

    CPUArch

    CPU architecture

    CPUPerf (*5)

    CPU performance

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

    CPUReserve (*2)

    The minimum number of CPU resources to be allocated

    CPUShare (*2)

    The relative proportion for allocation of CPU resources

    CPUWeight (*3)

    The priority for allocation of CPU resources

    NumOfCPU (*5)

    Number of CPUs

    MemorySize (*6)

    Memory size

    MemoryReserve (*2)

    The minimum amount of memory resources to be allocated

    MemoryShare (*2)

    The relative proportion for allocation of memory resources

    StartupRAM (*3)

    Initial memory capacity to be allocated at startup

    MemoryBuffer (*3)

    Available memory to be reserved as a buffer

    MemoryWeight (*3)

    The priority for allocation of memory resources

    DynamicMemory (*3)

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

    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)

    VMHostPool

    The name of the pool in which the VM hosts containing virtual machines allocated to L-Servers are registered

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

    • Resources have been allocated (allocated)

    Status

    L-Server operation status

    PowerStatus

    L-Server power status

    Resources

    Resource allocation status

    ControlledResources

    Scope of controlled resources
    Combinations of Server and Storage and Network 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 disks have been allocated or disks to use have been specified for the L-Server.

    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.
    If the disk capacity is not decided, a hyphen ("-") is displayed.

    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.

    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]

    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.

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

    • Resources have been allocated (allocated)

    • Servers have been released (preserved)

    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.

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

    • Resources have been allocated (allocated)

    • Servers have been released (preserved)

    OriginalStorage[num]

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

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

    StoragePool[num]

    The name of an allocated storage pool

    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)

    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

    Settings for overcommit

    Only displayed when overcommit settings are enabled.

    ReserveResources

    Retaining server resources

    UseInfraUser

    L-Server that infrastructure administrators are authorized to operate (L-Server for Infrastructure Administrators)

    "allow" is displayed.

    Snapshot[num]

    Snapshot collected from L-Servers

    The version, collected date, and comments are displayed.

    ContainerPoolManaged (*7)

    Management status of the container resource pool

    One of the following is displayed:

    • true

      Displayed when the resource pool used by the container is being managed by Resource Orchestrator.

    • false

      Displayed when the resource pool used by the container is not being managed by Resource Orchestrator.

    *1: When creating an L-Server that deploys cloning images, this item is only displayed when "all" is specified in "ServerImageLink".
    *2: When values are set for VMware, it is displayed.
    *3: When values are set for Hyper-V, it is displayed.
    *4: In RHEL-KVM, the status of allocated resources is displayed as below.
    - Resources have been allocated (allocated)
    - Servers have been released (preserved)
    *5: [Solaris Zones]

    When one of following conditions is met, a hyphen ("-") is displayed for the number of CPUs or CPU performance for an L-Server.

    - The CPU cap value is not configured in the non-global zone

    - The non-global zone is not managed in the managed resource pool

    When these conditions are not met, the values calculated by the following formula are displayed for the number of CPUs and CPU performance of an L-Server.

    - Number of CPUs = cap values of CPUs (rounding up the number of decimal places)

    - CPU performance = (cap values of CPUs/(Number of CPUs * 100)) * physical CPU performance(GHz)

    When the cap values calculated using the CPU performance and the number of CPUs for L-Servers are the same as those configured for the non-global zone, the CPU performance and the number of CPUs for L-Servers are not updated, and the values are not changed from the configured values.

    Example

    When the CPU cap value is 720, and the physical CPU performance is 3.0 GHz

    - Number of CPUs

    720 / 100 (rounded up) = 8 (cores)

    - CPU performance

    (720 / (8 * 100)) * 3.0 = 2.7 (GHz)

    When a hyphen ("-") is given for the number of CPUs and CPU performance, the amount of resources used by an L-Server is calculated using zero for the values.
    When any numbers are given for CPUs and CPU performance, make calculations using those values.

    [Citrix Xen]
    When one of following conditions is met, a hyphen ("-") is displayed for the CPU performance for an L-Server.

    • Links an L-Server with a configured virtual machine on XenCenter

    When a hyphen ("-") is displayed for the CPU performance, the amount of using CPU is calculated by 0 for an L-Server.
    *6: [Solaris Zones]

    When the memory cap values are not configured in the non-global zone, a hyphen ("-") is displayed for the memory size of an L-Server. When cap values are configured, the cap values for the L-Server memory size are displayed

    *7: In Solaris Containers, 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.

[OVM for SPARC]

Since non global zone constructed on the Solaris zone is also influenced when the power supply OFF of virtual L-Server which constructed the Solaris zone on the guest domain is performed, please operate it by checking the extent of the impact.

restart

Restarts the L-Server.

[OVM for SPARC]
Since non global zone constructed on the Solaris zone is also influenced when rebooting virtual L-Server which constructed the Solaris zone on the guest domain, please operate it by checking the extent of the impact.

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] [Solaris Zones] [OVM for SPARC] [OVM for x86 3.2] [Citrix Xen]
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.

  • When NIC is added, the automatic setting of Internet Protocol address on guest OS is not done.
    Log in guest OS after adding NIC, and set IP address displayed in a detailed information of L-Server to guest OS manually.
    Confirm added NIC can be correctly communicated with the external instrument after IP address is set.
    When two or more NIC is added, it is recommended to add it one by one.

[Solaris Zones]

  • NICs can be added to L-Servers that have been linked to a non-global zone of a Solaris Zone.

  • Up to 8 NICs are supported.

[OVM for SPARC] [OVM for x86 3.2]

  • NICs cannot be added when using an L-Server for which only the configuration definition has been created.

  • Up to 8 NICs are supported.

  • When the guest domain of OVM for SPARC is registered as VM host and also registered as L-Server, NIC cannot be added to L-Server by specifying VM host's admin IP address. It is because IP addresss is reserved on the VM host.

[VMware] [Hyper-V]
After adding NICs using this command, if restoration is executed using the virtual server snapshots, NIC inconsistency occurs between the virtual server NIC and the L-Server NIC. Ensure snapshots are collected after adding NICs.

[KVM]

A MAC address is automatically selected from the accessible resources from the user that executed the rcxadm command. To select an address set resource included in a specific tenant, execute this command, after login using tenant administrator privileges.

[Citrix Xen]

  • NICs cannot be added when using an L-Server for which only the configuration definition has been created.

  • Up to 7 NICs are supported.

detach

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

[VMware] [Hyper-V] [KVM] [Solaris Zones] [OVM for SPARC] [OVM for x86 3.2] [Citrix Xen]
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.

  • Delete IP address of the local area connection of Windows before deleting NIC when guest OS is Windows.
    When NIC is deleted with IP address set, the setting of the local area connection where IP address is allocated might be maintained in Windows.
    There is a possibility of generating the local area connection to which old IP address that misappropriates the setting where NIC to which Windows is added is maintained when NIC is added in the state, and is used by other guests OS is set.

[Solaris Zones]

  • NICs can be deleted from L-Servers that have been linked to a non-global zone of a Solaris Zone.

[OVM for SPARC] [OVM for x86 3.2]

  • NICs cannot be deleted when using an L-Server for which only the configuration definition has been created.

[VMware]
To delete a NIC while a VM guest is powered on, it is necessary to install VMware Tools on the guest in advance. If the detach command is executed without VMware Tools installed, the NIC will be deleted from the L-Server, but not from the VM guest. In this case, contact the infrastructure administrator and request to have the NIC deleted from the VM guest using VM management software.

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

[VMware] [Hyper-V]
After deleting NICs using this command, if restoration is executed using the virtual server snapshots, NIC inconsistency occurs between the virtual server NIC and the L-Server NIC. Ensure snapshots are collected after deleting NICs.

[Citrix Xen]

  • NICs cannot be deleted when using an L-Server for which only the configuration definition has been created.

  • Only NICs which have been added using NIC add operations can be deleted.

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.

[Solaris Zones]

  • Only cold migration is possible.

  • Specification is not possible when a spare server is configured for the VM host.

[OVM for SPARC]
Since non global zone constructed on the Solaris zone is also influenced when carrying out migration of virtual L-Server which constructed the Solaris zone on the guest domain, please operate it by checking the extent of the impact.

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\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 "14.5 Storage Resources" in 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 "15.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 "15.2 L-Server Template" or "15.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

  • When it has when reverting compulsorily correlation of virtual L-Server created from this product and a virtual machine and taking it in again, and the existing composition is evacuated

-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 or a resource folder, it is necessary to also specify the tenant 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 "15.3.1 Definition Information for Physical L-Servers (XML)" and "15.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.

Specify when migrating to the destination VM host ignoring the error which occurs in cases where communication with the source VM host is not possible, using the migrate command. Specification is only possible when the VM type of the L-Server is "Solaris Containers" or "RHEL-KVM".

For revert, specify when the relation of virtual L-Server and a virtual machine is compulsorily released.

Specify this option only for virtual L-Server of VMware.

Note

When using migrate, ensure that the source VM host is stopped. If specified when the source VM host is operating, a duplicate mount will occur, which may corrupt the data on the disk of the L-Server.

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

When extending disk size, specify a value larger than that of the current disk size. Even if the same values as the size of existing disks are specified, no errors occur.

[Hyper-V]
When values including numbers with a decimal point are specified for expansion of disk capacity, the numbers are automatically rounded up by SCVMM. Therefore, it is recommended to specify integers when increasing disk capacity.

-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, release from the L-Server, or to modify.

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

[OVM for x86 2.2]
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 for PXE boot, or the network resource name to connect additional NICs to.

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

[Solaris Zones] [OVM for SPARC] [Citrix Xen] [OVM for x86 3.2]
Always specify this option.

Note

The MAC address of NIC is not displayed in detailed information on L-Server for NIC that adds the NIC definition.

[VMware] [Hyper-V] [KVM]
This option cannot be specified.

-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

PreviousNext
Copyright 2010-2013 FUJITSU LIMITED