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

3.11 rcxadm server

Name

[Windows Manager]
Installation_folder\SVROR\Manager\bin\rcxadm server - Managed server operations

[Linux Manager]
/opt/FJSVrcvmr/bin/rcxadm server - Managed server operations


Format

rcxadm server start -name resource [-nowait]
rcxadm server stop -name resource [-force] [-nowait]
rcxadm server restart -name resource [-force] [-nowait]
rcxadm server switchover -name resource [-spare spare_server] [-nowait]
rcxadm server failback -name resource [-nowait]
rcxadm server takeover -name resource [-nowait]
rcxadm server list [{[-type {physical|vmguest|all}] | [-spare] | [-bootagt]}]
rcxadm server migrate -name guest_name -to vmhost [-mode {live|cold}] [-nowait]
rcxadm server migrate -home [-name vmhost] [-nowait]
rcxadm server set -name resource -attr {vmm_mode={maintenance|active}|vmware.maintenance={maintenance|active}} [VMware]
rcxadm server set -name resource -attr vmm_mode={maintenance|active|maintenance_with_move} [Hyper-V] [Xen] [Citrix Xen]
rcxadm server set -name resource -attr bootagt={dos|winpe}

Information

rcxserver is an abbreviated form of the rcxadm server command. Both forms provide the same subcommands and options, and produce the same results.


Description

rcxadm server is the command used to control server resources. This function provides the following functionality:

When stopping or restarting a VM host, any VM guests that are running will also be stopped.
Verify that stopping the affected VM guests will not cause any problems before stopping or restarting a VM host.

For details on the switchover, failback and takeover operations, refer to "Chapter 18 Server Switchover Settings" in the "User's Guide VE".
For details on VM guest migrations, refer to "15.1 Migration of VM Guests between Servers" in the "User's Guide VE".
For details on VM maintenance mode settings, refer to "15.2 VM Maintenance Mode of VM Hosts" in the "User's Guide VE".


Subcommands

start

Starts the target server (physical server, physical OS, VM host, or VM guest).

stop

Stops the target server (physical server, physical OS, VM host, or VM guest).

restart

Restarts the target server (physical server, physical OS, VM host, or VM guest).

switchover

Switches over the target server (physical OS or VM host) with one of its spare servers.

failback

Switches back a server in switchover state (physical OS or VM host). The spare server that was switched over with is stopped, and the operating system will be restarted on the primary server.

takeover

Sets a post-switchover configuration as final, and allows the spare server to take over the role of the original primary server (physical OS or VM host). After takeover, both servers exchange their roles: the original spare server becomes the new primary server, while the original primary server becomes the new spare server.

list

Displays all registered servers (physical OS's, VM hosts, and VM guests).

The following properties are displayed for each server (when no options are specified).

Item Name

Description

PHYSICAL_SERVER

Physical server name

SERVER

Server name (physical OS or VM host)

ADMIN_IP

Admin LAN IP address

STATUS

Server status

Displays one of the following:

  • normal

  • warning

  • unknown

  • stop

  • error

  • fatal

For an explanation of possible server statuses, refer to "11.2 Resource Status" in the "Operation Guide CE".

MAINTENANCE

Current maintenance mode

  • If maintenance mode is set

    "ON" is displayed.

  • If maintenance mode is not set

    "OFF" is displayed.

For details on the maintenance mode, refer to "Appendix C Maintenance Mode" in the "User's Guide for Infrastructure Administrators (Resource Management) CE".

migrate

Migrates a VM guest to a VM host on a different physical server.

set

Sets or releases VM maintenance mode for a given VM host.
Change the boot agent used when manipulating images.


Options

The following option can be specified for subcommands other than the list subcommand:

-name resource

Specify the name of the target server in resource.


The following option can be specified when using subcommands other than the list or set subcommand:

-nowait (optional)

Use this option to return directly to the command prompt without waiting for the command to complete its execution.


The following option can be specified for the stop and restart subcommands:

-force (optional)

Use this option to forcibly stop or restart a server without shutting down its operating system.


The following option can be specified for the switchover subcommand:

-spare spare_server (optional)

This defines the spare server (physical server) to be switched over with. If omitted, an appropriate server will be automatically selected from the list of spare servers already assigned to the target server.


The following options can be specified for the list subcommand:

-type {physical|vmguest|all} (optional)

This defines the type of server (physical servers, VM guests, all servers) to be listed up.
The following properties are displayed for each server. The option column shows the relationship between displayed properties and the option given in -type ("always" in the table below designates properties that are always displayed, independently from the option given in -type).

Item Name

Description

Options

PHYSICAL_SERVER

Physical server name

always

SERVER

Server name (for a Physical OS, VM host, or VM guest)

always

TYPE

Server type

Displays one of the following:

  • native

    Physical OS

  • vm_host

    VM host

  • vm_guest

    VM guest

physical

all

VM_HOST

VM host name

For a VM guest, this shows the name of the VM host on which this VM guest operates.

vmguest

all

ADMIN_IP

Admin LAN IP address

always

STATUS

Server status

Displays one of the following:

  • normal

  • warning

  • unknown

  • stop

  • error

  • fatal

For an explanation of possible server statuses, refer to "11.2 Resource Status" in the "Operation Guide CE".

always

MAINTENANCE

Current maintenance mode

  • If maintenance mode is set

    "ON" is displayed.

  • If maintenance mode is not set

    "OFF" is displayed.

For details on the maintenance mode, refer to "Appendix C Maintenance Mode" in the "User's Guide for Infrastructure Administrators (Resource Management) CE".

physical

all


-spare (optional)

When using spare servers, this shows the spare server(s) (physical server) assigned to each server.
The following properties are displayed for each server.

Item Name

Description

SERVER

Server name (physical OS or VM host)

PRIMARY

Primary server

Name of the physical server that will be switched over with a spare server during a server switchover.

SPARE

Spare server

Name of the spare server (switchover destination) assigned to the primary server.
If multiple spare servers are assigned, the name of each spare server is displayed using commas (",") as a delimiters.

VLAN_SWITCH (*)

Network reconfiguration flag

This flag defines whether network settings will be reconfigured during a server switchover.

  • When network settings are reconfigured during server switchover

    "ON" is displayed.

  • When network settings are not reconfigured during server switchover

    "OFF" is displayed.

AUTO_SWITCH

Auto-Recovery flag

This flag defines whether Auto-Recovery is enabled.

  • When Auto-Recovery is enabled

    "ON" is displayed.

  • When Auto-Recovery is not enabled

    "OFF" is displayed.

ACTIVE

Active server

Displays the name of the currently active physical server.

SWITCHOVER_STATE

Switchover state

Displays the current switchover state. Displays one of the following:

  • normal

    Normal status (There are no switchover, failback, or takeover operations in progress).

  • switchover running

    A switchover operation is in progress.

  • switchover completed

    A switchover operation has been completed.

  • failback running

    A failback operation is in progress.

  • takeover running

    A takeover operation is in progress.

* Note: When a LAN switch blade is in IBP mode or Converged Fabric mode, the details of settings are displayed in this parameter.

-bootagt (optional)

Displays the information about the boot agent used when manipulating images.
The following properties are displayed for each server.

Item Name

Description

PHYSICAL_SERVER

Physical server name

BOOT_AGENT

Set boot agent

Displays one of the following:

  • DOS

  • Windows PE


The following options can be specified for the migrate subcommand:

-name guest_name

Specify the name of the destination target VM guest in guest_name.

-to vmhost

Specify the name of the destination VM host in vmhost.

-mode {live|cold} (optional)

The type of migration method to perform is given for mode.
Depending on the power state of the VM guest to migrate, only one of those types may be available. When omitted, the appropriate type will be chosen depending on the state of the VM guest.
The following values can be specified.

live

Performs a live migration: migration of an active (powered-on) VM guest.

cold

Performs a cold migration: migration of an inactive (powered-off) VM guest.

The power status of the VM guest after migration will be the same as it was before migration.

-home

Specify when performing migration to the VM Home Position.

-name vmhost (optional)

Specify the name of the operation target VM host in vmhost.


The following options can be specified for the set subcommand:

-attr {vmm_mode={maintenance|active}|vmware.maintenance={maintenance|active}}

Sets or releases VM maintenance mode for the target VM host.

-attr vmm_mode={maintenance|active|maintenance_with_move}

Sets or releases VM maintenance mode for the target VM host, or migrates the VM guest when set.

-attr bootagt={dos|winpe}

Changes the boot agent used when manipulating images to DOS or Windows PE.

When the managed server has the following configuration, this option must be specified before manipulating images to change the boot agent settings.

  • SAN data environments using a built-in disk boot, and a physical WWN or VIOM, must be converted to DOS.

  • When using the Red Hat Enterprise Linux 6 ext4 file system and one of the following conditions applies, it needs to be changed to Windows PE.

    • SAN boot environment using HBA address rename

    • Rack mount or tower servers have been registered with "Disabled" selected for "Association with server management software (ServerView)"

  • In a SAN boot environment using HBA address rename and where the following model or OS is used, it needs to be changed to Windows PE.

    • PRIMERGY BX960 S1

    • XenServer6 or later

This option cannot be specified for the following models:

  • Fujitsu M10/SPARC Enterprise

  • PRIMEQUEST


Requirements

Permissions

One of the following permissions is required:

Location

Admin server


Examples

Exit Status

This command returns the following values:

0

The command executed successfully.

non-zero

An error has occurred.

Note

  • A VM guest can be configured to automatically start or stop whenever its VM host starts up or shuts down. This can be achieved by setting up the VM guest's startup and shutdown options in the server virtualization software used.
    For more information, please refer to the server virtualization software manual.

  • As a result of power operation being performed on a VM guest, an error may occur if the VM guest is moved to another VM host and processes executed.
    Refer to "D.3 Functional Differences between Products" in the "Design Guide VE" for details.

  • VM guests should be properly configured in order to use the "stop" or "restart" subcommands.
    Stopping or restarting a VM guest that was not properly configured will result in an error unless the -force option is specified.
    Refer to "D.2 Configuration Requirements" in the "Design Guide VE" for details.

  • For PRIMEQUEST servers, the warning message will not be displayed, even if there is a chance that the switchover will not be correctly performed using Reserved SB settings.

  • If ServerView Deployment Manager is used on the admin LAN, the switchover and failback subcommands cannot be used if the managed servers do not fulfill the following conditions.
    For more details, please refer to "Appendix B Co-Existence with ServerView Deployment Manager" in the "Setup Guide VE".

    • Servers in local boot environments

    • Servers in SAN boot environments without VIOM profiles

  • The changes to the boot agent are valid while the physical server is registered. After reregistering the physical server, change the boot agent using the command if necessary.


This section explains the additional functions of the Cloud Edition.

Only the additional functions can be used for a server that has been allocated to an L-Server.

Name

[Windows Manager]
Installation_folder\SVROR\Manager\bin\rcxadm server - Managed server operations

[Linux Manager]
/opt/FJSVrcvmr/bin/rcxadm server - Managed server operations

Format

rcxadm server set -name resource -mode {active|maintenance}

Description

The additional functions of rcxadm server are indicated below.

Options

-name resource

For resource, specify a server name to place into or release from maintenance mode.

-mode active|maintenance

Specify whether the server is to be placed into or released from maintenance mode.

active

Release maintenance mode.

maintenance

Places into maintenance mode.

PreviousNext
Copyright 2010-2013 FUJITSU LIMITED