8.1 rcxadm template

Name

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

[Linux Manager]
/opt/FJSVrcvmr/bin/rcxadm template - L-Server template operations

Format

rcxadm template import -file file [-force] [-nowait]
rcxadm template list [-verbose]
rcxadm template show -name name
rcxadm template export -file file [-name name]
rcxadm template modify -name name {[-new_name name] [-label label] [-comment comment]} [-nowait]
rcxadm template delete -name name [-force] [-nowait]

Description

rcxadm template is the command used to perform operations on L-Server templates. L-Server templates define the values such as the number of CPUs, memory capacity, and disk capacity that comprise an L-Server. Using an L-Server template enables easy creation of L-Servers.

Subcommands

import: Imports the L-Server template defined in an XML file.

list

Displays a list of the L-Server templates that can be accessed. Using the -verbose option also displays information regarding the redundancy configuration and operation location.

The following detailed information is displayed:

For Physical L-Servers

Table 8.1 Information for L-Server Templates of Physical L-Servers
Item Name	Description
NAME	L-Server template name
TYPE	Server type
SPEC/MODEL	Model
DISKS	Disk size When there are multiple disks, they are displayed separated by commas.
NICS	Number of NICs (a hyphen "-" is displayed, as this parameter is not supported)
REDUNDANCY (*)	Server redundancy
POSITIONING (*)	Positioning (a hyphen "-" is displayed, as this parameter is not supported)

* Note: When specifying -verbose for the option, it is displayed.

For Virtual L-Servers

Table 8.2 Information for L-Server Templates of Virtual L-Servers
Item Name	Description
NAME	L-Server template name
TYPE	Server type
SPEC	CPU clock frequency, CPU number, and memory size used to comprise the L-Server
DISKS	Disk size When there are multiple disks, they are displayed separated by commas.
NICS	Number of NICs
REDUNDANCY (*)	Server redundancy
POSITIONING (*)	Positioning

* Note: When specifying -verbose for the option, it is displayed.

show

Displays the detailed information for the specified L-Server template.

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 8.3 Detailed Information for L-Server Templates of Physical L-Servers
Item Name	Description
Name	L-Server template name
Label	Label
Comment	Comment
ServerType	Server type
Model	Server model name
CPUPerf	CPU performance
NumOfCPU	Number of CPUs
MemorySize	Memory size
DiskType[num]	Disk type name 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.
NumOfNIC	Number of NICs used for an L-Server
NIC[num][NumOfNetworkLinks]	Number of networks that use VLAN In num, the NIC number is set. The number is "0" or larger.
NICGroup[num][NumOfNetworkLinks]	Number of networks to be redundant In num, specify the NIC redundancy group number. The number is "0" or larger.
NICGroup[num][NICLinks]	NIC number for redundancy In num, specify the NIC redundancy group number. The number is "0" or larger.
Redundancy	Server redundancy to assign to L-Servers
FCConnectionPattern	FC connection pattern file
AliveMonitoring	Alive monitoring setting status
ReserveResources	Retention of resources
SpareSelection	Selection method for spare servers
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.
LServer	L-Servers created using this L-Server template. When there is more than one, they are displayed separated by commas.

For Virtual L-Servers

Table 8.4 Detailed Information for L-Server Templates of Virtual L-Servers
Item Name	Description
Name	L-Server template name
Label	Label
Comment	Comment
DeployDisk	Disk deployment settings during image specification When configuring the settings in the same configurations as for images "all" is displayed.
FitDiskSizeToImage	Configure the same disk capacity as that of the image. One of the following is displayed: true Displayed when the same disk capacity as that of the image has been configured during L-Server creation. false Displayed when disks with larger disk capacities than the disk of the image and the L-Server template or the disk capacity specified in the DiskSize element of the L-Server XML are allocated, during L-Server creation.
ServerType	Server type
VMType	VM type
CPUArch	CPU architecture
CPUPerf	CPU performance
NumOfCPU	Number of CPUs
CPUReserve	The minimum number of CPU resources to be allocated
CPUShare	The relative proportion for allocation of CPU resources
CPUWeight	The priority for allocation of CPU resources
MemorySize	Memory size
MemoryReserve	The minimum amount of memory resources to be allocated
MemoryShare	The relative proportion for allocation of memory resources
StartupRAM	Initial memory capacity to be allocated at startup
MemoryBuffer	Available memory to be reserved as a buffer
MemoryWeight	The priority for allocation of memory resources
DynamicMemory	Dynamic memory settings One of the following is displayed: When dynamic memory settings are enabled "on" is displayed. When dynamic memory settings are disabled "off" is displayed. If left blank, no value is displayed.
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 "0" or larger.
NumOfNIC	Number of NICs used for an L-Server
Redundancy	Server redundancy to assign to L-Servers
Positioning	Physical location of the server to allocate to L-Servers
AliveMonitoring	Alive monitoring setting status
OverCommit	Setting for overcommit One of the following is displayed: When overcommit settings are enabled "true" is displayed. When overcommit settings are disabled "false" is displayed.
ReserveResources	Retention of resources
LServer	L-Servers created using this L-Server template. When there is more than one, they are displayed separated by commas.

export: Exports the specified L-Server template information in the XML format. If you do not specify an L-Server template with the -name option, all L-Server templates are exported.

modify: Modifies the label, comment, and name of the specified L-Server template.

delete: Deletes the specified L-Server template. Use the -force option to forcibly delete the specified L-Server template even if there are L-Servers created from the template.

Options

-file file: In file, specify the L-Server template XML file to import or export.

-nowait: Use this option to return directly to the command prompt without waiting for the operation of the L-Server template specified in the subcommand to complete its execution.

-name name: In name, specify the L-Server template name.

-verbose: Use this option to display the redundancy configuration and the operation location.

-new_name name: In name, specify the new L-Server template name.

-label label: In label, specify the new label.

-comment comment: In comment, specify the new comments.

-force

Use the -force option to import to overwrite the L-Server template even if there are existing L-Server templates.

Use the -force option to forcibly delete the specified L-Server template even if there are L-Servers created from the template.

Examples

To display a list of the L-Server templates that can be accessed:

For Virtual L-Servers

>rcxadm template list <RETURN>
NAME                TYPE        SPEC                DISKS               NICS
----                ----        ----                -----               ----
no-nic              Virtual     1.0GHz,1,2.0GB      10.0GB,12.0GB       -
small               Virtual     1.0GHz,1,1.0GB      10.0GB              -

For Physical L-Servers

>rcxadm template list <RETURN>
NAME                TYPE        SPEC/MODEL          DISKS               NICS
----                ----        ----------          -----               ----
sample_physical     Physical    "PRIMERGY BX922 S2" 40.0GB              -

>/opt/FJSVrcvmr/bin/rcxadm template list -verbose <RETURN>
NAME                TYPE        SPEC/MODEL          DISKS               NICS REDUNDANCY POSITIONING
----                ----        ----------          -----               ---- ---------- -----------
sample_physical     Physical    "PRIMERGY BX922 S2" 40.0GB              -    None       -
sample_physical2    Physical    2.0GHz,4,8.0GB      40.0GB              1    None       -

To also display information regarding the redundancy configuration and the positioning:

>rcxadm template list -verbose <RETURN>
NAME                TYPE        SPEC                DISKS               NICS REDUNDANCY POSITIONING
----                ----        ----                -----               ---- ---------- -----------
no-nic              Virtual     1.0GHz,1,2.0GB      10.0GB,12.0GB       -    None       Fixed
small               Virtual     1.0GHz,1,1.0GB      10.0GB              -    None       Fixed

To display the detailed information for the specified L-Server template:

For Virtual L-Servers

>rcxadm template show -name small <RETURN>
Name: small
Label: label of the small
ServerType: Virtual
VMType: VMware
CPUArch: IA
CPUPerf: 1.0GHz
NumOfCPU: 1
MemorySize: 1.0GB
DiskSize[0]: 10.0GB
Redundancy: None
Positioning: Fixed
AliveMonitoring: on

For Physical L-Servers

>rcxadm template show -name sample_physical2 <RETURN>
Name: sample_physical2
Label: sample of physical template
ServerType: Physical
CPUPerf: 2.0GHz
NumOfCPU: 4
MemorySize: 8.0GB
DiskType[0]: FC
DiskSize[0]: 40.0GB
NumOfNIC: 1
Redundancy: None
FCConnectionPattern: fc_connect
AliveMonitoring: on
SpareServerForceOFF: on
AllowForceOFF: off