Red Hat LINUX VIRTUAL SERVER 4.7 - ADMINISTRATION Setup Guide

J2X1-7607-01ENZ0(05)April 2012Windows/LinuxServerView Resource Orchestrator Virtual Edition V3.0.0Command Reference

ContentsChapter 1 Overview...

Chapter 1 OverviewThis chapter provides an overview of the commands available in Resource Orchestrator.Four types of commands are available: the login

Table 1.1 List of CommandsCommand FunctionRequired Privileges LocationOSAdministratorResourceOrchestratorPrivilegedUserAdminServerManagedServerrcxlogi

executes this command after logging into Resource Orchestrator, the operating system privileges will be replaced by Resource Orchestratorprivileges. T

Chapter 2 LoginThis chapter explains the command used to log in to Resource Orchestrator.2.1 rcxlogin Name[Windows]Installation_folder\Manager\bin\rcx

1. Start the cluster service on the primary node.In the Failover Cluster Management tree, right-click [RC-manager] under [Services and Applications],

NoteThe script must be executed by the operating system user account that was used to save the password on the admin server. ExampleScript (batch fi

Chapter 3 Resource OperationsThis chapter explains the commands used to manage resources in Resource Orchestrator.3.1 rcxadm chassis Name[Windows]Inst

LocationAdmin server Exit StatusThis command returns the following values:0The command executed successfully.non-zeroAn error has occurred. Note- Whe

Descriptionrcxadm server is the command used to control server resources. This function provides the following functionality:- Display of server statu

Preface PurposeThis manual explains the commands available in ServerView Resource Orchestrator (hereinafter Resource Orchestrator). Target ReadersThis

Property Contents- warning- unknown- stop- error- fatalFor an explanation of possible server statuses, refer to "5.2 Resource Status" of the

-type {physical|vmguest|all} (optional)This defines the type of server (physical servers, VM guests, all servers) to be listed up.The following proper

Property ContentsSERVER Server name (physical OS or VM host)PRIMARYPrimary serverName of the physical server that will be switched over with a spare

Property ContentsPHYSICAL_SERVER Physical server nameBOOT_AGENTSet boot agentDisplays one of the following:- DOS- Windows PEThe following options can

This option cannot be specified for the following models:- SPARC Enterprise- PRIMEQUEST RequirementsPermissionsOne of the following permissions is req

>rcxadm server list -type vmguest <RETURN>PHYSICAL_SERVER SERVER VM_HOST ADMIN_IP STATUS--------------- ------

- 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 andprocesses executed.R

Chapter 4 Image OperationsThis chapter explains the commands used for operations on images managed by Resource Orchestrator.4.1 rcxadm image Name[Wind

If any one of the "backup", "restore", "create", or "deploy" subcommands is executed, the target server is aut

Property ContentsNAME Name of the cloning imageVERSION Cloning image versionsCREATIONDATE Creation date and time of the cloning imageCOMMENT Comment d

[Xen/KVM] Sections related to Xen and RHEL-KVM[Linux/Solaris/VMware] Sections related to Linux, Solaris, and VMware[Linux/VMware/Xen] Sections related

-version version (optional)Specify the version number of the system image to restore in version.If omitted, the latest version of the system image wil

- Alphanumeric characters- Hyphens ("-")- Periods (".") [Linux]The following options can be specified for the delete subcommand:-v

- To restore a system image to a managed server >rcxadm image restore -server blade07 -version 2 <RETURN>- To delete a system image >rcxad

Exit StatusThis command returns the following values:0The command executed successfully.non-zeroAn error has occurred.- 23 -

Chapter 5 Control and Environment SetupThis chapter explains the commands used to control the manager and agent, as well as those used to configure en

- When compressing with bzip2rcxtssnap_server_name.tar.bz2- When compressing with gziprcxtssnap_server_name.tar.gz- When compressing with compressrcxt

RequirementsPermissionsOS AdministratorLocationManaged server Exit StatusThis command returns the following values:0The command executed successfully.

SubcommandslistDisplays a list of current SSL certificates. Each certificate stored in the certificates data file is indexed by a unique alias (*1).

>rcxadm certctl init <RETURN> Exit StatusThis command returns the following values:0The command executed successfully.non-zeroAn error has oc

NoteFor the password, enter a string including upper case alphabetic characters, lower case alphabetic characters, and numerals. The lengthof the st

Manual Name Abbreviated Form PurposeServerView Resource Orchestrator VirtualEdition V3.0.0 MessagesMessages VERead this when you want detailed informa

Options-encryptAlways specify this option when encrypting the password. RequirementsPermissionsOS AdministratorLocationManaged server Exit StatusThis

SubcommandsinfoDisplays current image settings (the maximum number of image versions and the location of the image files folder).The following propert

- The specified path should have proper security settings[Linux]For safer administration, it is recommended to use either the following permissions se

non-zeroAn error has occurred.5.6 rcxadm lanctl Name[Windows]Installation_folder\Agent\bin\rcxadm lanctl - Network parameters configuration[Linux]/opt

>rcxadm lanctl set <RETURN>- To undo the network parameters configuration >rcxadm lanctl unset <RETURN>- To enable the network param

# service name port number/protocol namercxmgr 23460/tcprcxweb 23461/tcprcxtask 23462/tcprcxmongrel1 23463/tcprcxmongrel2 23

- rcxtask- rcxmongrel1- rcxmongrel2- rcxdb- nfdomain- nfagentThe following options can be specified for the snap subcommand:-dir directory(Optional)Sp

- Admin server[Windows]rcxtssnap_server_name.jarThe server_name part will be in lower case when the -all option is specified, or upper case when omitt

Managed server[Windows]Managed_Server\rcxtssnap_physical_server_name_error.txt[Linux]Managed_Server\rcxtssnap_physical_server_name_error.txt Requireme

deleteDeletes a registered SNMP trap transmission destination.listDisplays a list of registered SNMP trap transmission destinations.The following prop

Abbreviation ProductsRed Hat(R) Enterprise Linux(R) AS (4.5 for x86)Red Hat(R) Enterprise Linux(R) ES (4.5 for x86)Red Hat(R) Enterprise Linux(R) AS (

Synopsisrcxadm storagemgr register -name name -soft_name soft_namercxadm storagemgr listrcxadm storagemgr unregister -name name Descriptionrcxadm sto

LocationAdmin server Exit StatusThis command returns the following values:0The command executed successfully.non-zeroAn error has occurred.5.10 rcxadm

modifyDeletes the registered directory services OptionsThe following options can be specified when using the register and modify subcommands:-port por

-passwd password (optional)Specify the password for the administrative user name of the directory service.-passwd_file password_file (optional)Specify

Descriptionrcxadm license is the command used to register licenses or to check the licenses already registered. SubcommandsaddRegisters a license.list

Name- Manager[Windows]Installation_folder\Manager\bin\deployment_service_uninstall.bat - Uninstallation of the related services[Linux]/opt/FJSVrcvmr/b

5.13 rcxadm vmmgr Name[Windows]Installation_folder\Manager\bin\rcxadm vmmgr - VM management software operations[Linux]/opt/FJSVrcvmr/bin/rcxadm vmmgr

refreshThe regular update of VM management software is forcibly implemented. Options-name nameIn name, specify the name of the target VM management so

Chapter 6 Backup and Restore the Configuration ofResource OrchestratorThis Chapter explains how to use the commands to backup and restore the configur

-immediateUse this option to return directly to the command prompt without waiting for the operation being executed on the admin server tocomplete its

Abbreviation ProductsRed Hat(R) Enterprise Linux(R) AS (4.5 for EM64T)Red Hat(R) Enterprise Linux(R) ES (4.5 for EM64T)Red Hat(R) Enterprise Linux(R)

[Linux]"\"- The folder path or directory path can be specified using up to 100 characters.- For the -timeout option, "172800" or l

>rcxrestore -file mgr_20110123_1159.bz2 <RETURN> Exit StatusThis command returns the following values:0The command executed successfully.non-

- System Images and Cloning Images Table 6.1 List of Items for Backup/Restore [Windows]No Overview Item1 System images (*1)Image_file_storage_folder\M

Table 6.4 List of Items for Backup/Restore [Linux]No Overview Item1 Configuration file /etc/opt/FJSVscw-common/scwconf.reg2 Database/var/opt/FJSVscw-

Backup can only be performed when no operation is being executed for the resources. If an operation is being executed, this commandwill return an erro

- For restoration, the certificates, configuration definition information, OS property definition files, system images, and cloningimages must have be

0The command executed successfully.non-zeroAn error has occurred. Note- When specifying files, take note of the following points:- Do not use double-

No Overview Item2Session encryptionkeysInstallation_folder\Manager\rails\config\rcx_secret.key3 Definition filesInstallation_folder\Manager\etc\custom

[Windows]Installation_folder\Manager\var\backup[Linux]/var/opt/FJSVrcrmr/backup-immediateUse this option to return directly to the command prompt with

[Windows]"/"[Linux]"\"- The folder or directory path can be specified using up to 100 characters.- For restoration, the certificat

Abbreviation ProductsRed Hat(R) Enterprise Linux(R) 6.2 (for x86)Red Hat(R) Enterprise Linux(R) 6.2 (for Intel64)RHEL-KVMRed Hat(R) Enterprise Linux(R

Exit StatusThis command returns the following values:0The command executed successfully.non-zeroAn error has occurred. Note- When specifying files,

Glossary access pathA logical path configured to enable access to storage volumes from servers. active modeThe state where a managed server is perform

blade serverA compact server device with a thin chassis that can contain multiple server blades, and has low power consumption.As well as server blad

environmental dataMeasured data regarding the external environments of servers managed using Resource Orchestrator.Measured data includes power data c

Hyper-VVirtualization software from Microsoft Corporation.Provides a virtualized infrastructure on PC servers, enabling flexible management of operat

LSB (Logical System Board)A system board that is allocated a logical number (LSB number) so that it can be recognized from the domain, during domainco

OSThe OS used by an operating server (a physical OS or VM guest). PDU (Power Distribution Unit)A device for distributing power (such as a power strip)

rackA case designed to accommodate equipment such as servers. rack mount serverA server designed to be mounted in a rack. RAID (Redundant Arrays of I

SAN (Storage Area Network)A specialized network for connecting servers and storage. serverA computer (operated with one operating system). server blad

software initiatorAn initiator processed by software using OS functions. Solaris ContainerSolaris server virtualization software.On Solaris servers,

Abbreviation ProductsResource Coordinator VEServerView Resource Coordinator VESystemwalker Resource Coordinator Virtual server EditionResource Orchest

UPS (Uninterruptible Power Supply)A device containing rechargeable batteries that temporarily provides power to computers and peripheral devices in th

VM maintenance modeOne of the settings of server virtualization software, that enables maintenance of VM hosts.For example, when using high availabili

Index[D]deployment_service_uninstall....44[R]rcxadm agtctl....

Month/Year Issued,EditionManual CodeJanuary 2012, 1.2 J2X1-7607-01ENZ0(02)February 2012, 1.3 J2X1-7607-01ENZ0(03)March 2012, 1.4 J2X1-7607-01ENZ0(04)A