Top
ServerView Resource Orchestrator V2.3.0 Reference Guide
Chapter 1 Command Reference > 1.3 Resource Operations > 1.3.1 rcxadm lserver
PreviousNext

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] [-shared] [-index index] [-system] [-nowait]
rcxadm lserver detach -name name -disk disk [-shared] [-online] [-system] [-force] [-allow deldisk] [-nowait]
rcxadm lserver detach -name name -type server [-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 boot={default|pxe} [-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 the defined L-Servers.

The following detailed information is displayed:

show

To display the detailed information for an L-Server.

The following detailed information is displayed:

start

Starts an L-Server.

stop

Stops an L-Server.

restart

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

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.

detach

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

When specifying the -type option, if the "Boot Location" of the physical L-Server is set as "Relocate at startup", the physical server can be released from the 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.

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

Configure 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, the data on the disk will not be deleted.
When using delete or detach on a LUN that has been created in advance, 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 "5.3.3 Storage Resources" of the "ServerView Resource Orchestrator User's Guide".


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

Note

When outputting the XML for a virtual L-Server with Hyper-V specified for the VM type, units are displayed for the values of Startup RAM and Memory Buffer. However this has no effect on operation.

-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 For Physical L-Servers" and "2.3.2 For Virtual L-Servers".

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

  • When linking a physical server to an L-Server

    If the physical server name of the configured physical server is a possible value for the L-Server name described in "Table 2.3 List of Items Specified in XML Definitions for Physical L-Servers" in "2.3.1 For Physical L-Servers", the physical server name will be set as the L-Server name. If not, an error will occur and the operation will be aborted.

  • When linking a configured virtual machine to an L-Server

    If the VM name of the configured virtual machine is a possible value for the L-Server name described in "Table 2.5 List of Items Specified in XML Definitions for Virtual L-Servers" in "2.3.2 For Virtual L-Servers", the VM name will be set as the L-Server name. If not, an error will occur and the operation will be aborted.

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

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

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

-exist

For physical L-Servers, specify an already created LUN for connection.

Specify this option only for physical L-Servers.

-shared

For physical L-Servers, specify a disk resource to share with other L-Servers.

Specify this option only for physical L-Servers.

-system

When attach/detach is specified, the system disk will be the target. If omitted, the system disk is not the target.

Specify this option only for physical L-Servers.

-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 boot={default|pxe}

When using a physical L-Server, configure the boot mode by specifying default or pxe.

When setting the boot mode to PXE, specify "pxe". When returning the boot mode to the default mode, specify "default".

-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

-type server

For physical L-Servers, specify in order to release a physical server from an L-Server.

-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

Examples

PreviousNext
Copyright FUJITSU LIMITED 2011