Top
ServerView Resource Orchestrator V2.2.1 User's Guide

E.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 [-nowait]
rcxadm lserver modify -name name -file file.xml [-nowait]
rcxadm lserver list
rcxadm lserver show -name name
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 [-from {pool|vstorage}] [-disk disk] [-index index] [-nowait]
rcxadm lserver detach -name name -disk disk [-online] [-nowait] 
rcxadm lserver migrate -name name [-to vmhost] [-mode {live|cold}] [-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 assigned 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 the defined L-Servers.

When the server type is "Physical", the following items are not displayed.

  • For rack mount servers

    CPU performance, number of CPUs, and memory capacity

show

Displays the detailed information for an L-Server.

When the server type is "Physical", the following items are not displayed.

  • For rack mount servers

    CPU performance, number of CPUs, and memory capacity

start

Starts an L-Server.

stop

Stops an L-Server.

restart

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

When the server type is "Physical", specification is not possible.

detach

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

When the server type is "Physical", specification is not possible.

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.
When the server type is "Physical", specification is not possible.


Options

-file file.xml

In file.xml, specify the path of the XML file that defines the resources that comprise the L-Server. For details on the file definition, refer to "H.3 L-Servers".

-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 inside a resource folder, it is necessary to also specify the resource folder name connected with a slash ("/").

-to vmhost

When the server type is "Virtual", 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

When the server type is "Virtual", specify the migration method. Specify "live" to perform a live migration. Specify "cold" to perform a cold migration. 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

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

-to folder

Specify the destination resource folder in folder. When omitted, the server is moved to the home folder.

-size size

In size, specify the disk capacity, in units of GB. 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 assign to the L-Server. When omitted, resource selection is performed automatically with priority given to storage pools.

-disk disk

Specify the name of the disk resource to assign 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 assigned plus one is used. The maximum value differs according to the server type.

-online

Use this option to remove the disk from the L-Server while the server is running. Setting is only possible when the server type is "VM". 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.


Examples