Installation_folder\SVROR\Manager\bin\rcxadm lserver - L-Server operations
rcxadm lserver delete -name name -allow deldisk [-nowait] rcxadm lserver modify -name name [-type physical] -file file.xml [-nowait] rcxadm lserver list rcxadm lserver show -name name [-format {text|xml}] rcxadm lserver convert [-name name] -with with [-label label] [-comment comment] [-to folder] [-nowait] [-refreship] rcxadm lserver revert -name name [-force] [-nowait]
rcxadm lserver is the command used to manage and operate L-Servers.
Note
As a result of performing virtual PC operations, processes that are executed after a virtual PC is migrated to another VM host may fail.
For details, refer to "9.2.2 Functional Differences between Products" in the "Design Guide VE".
Deletes an L-Server. The resources allocated to the L-Server are released automatically and the definitions for the L-Server are also deleted.
Changes the network resources comprising the L-Server.
Multiple NICs can be specified as the modification target in the XML file.
- When the NIC is connected to network resources
This command modifies the IP address of the NIC and the destination network of the target OS.
Note
For Both Virtual L-Servers and Physical L-Servers
After modifying the IP address, log in to the target OS and then manually set the IP address displayed in the detailed information of the L-Server.
After setting the IP address, confirm that the changed NIC can communicate with external devices correctly.
For Virtual L-Servers
Modification of the IP address and the destination network is performed for the NIC corresponding to the MAC address specified in the XML file. Therefore, ensure a MAC Address is specified.
When there are no NICs, or multiple NICs, that have the MAC address specified in the XML file, NIC modification is not performed.
When there are no VM guest NICs, or multiple VM guest NICs, that have the MAC address specified in the XML file, NIC modification is not performed for the VM guests.
Only modification of the IP address and the destination network in the NIC definition is performed.
For Physical L-Servers
- New network connections are added for any NICs that have been added in the XML file.
- Existing network connections corresponding to any NICs that have been omitted from the XML file are deleted.
Therefore, be sure to include descriptions of all existing NICs in the XML file, even if no changes have been made to them.
Point
Modification of a network using VM management software may cause differences in the network information of L-Servers and VM guests. In this case, perform one of the following procedures to make the network information consistent between L-Servers and VM guests.
Modify the destination network of the L-Server so it is aligned with the VM guest.
Using the VM management software, modify the network of the target VM guest so it is aligned with the L-Server.
Displays a list of L-Server information.
The following information is displayed.
| Item Name | Description |
|---|---|
| NAME | L-Server name |
| TYPE | Server Type |
| SPEC (*) | CPU performance, CPU count, memory capacity |
| DISKS | Disk size |
| IPADDRESSES | IP address |
| STATUS | Operational status of the L-Server |
| RESOURCES | Resource allocation status |
* Note: Not displayed when using rack mount servers on which agents have not been registered
| Item Name | Description |
|---|---|
| NAME | L-Server name |
| TYPE | Server Type |
| SPEC | CPU performance, CPU count, memory capacity |
| DISKS |
Disk size When there are multiple disks, the disk sizes are displayed separated by commas. When disk size cannot be acquired, a hyphen ("-") is displayed. |
| IPADDRESSES |
IP address When there are multiple IP addresses, they are displayed separated by commas. |
| STATUS | Operational status of the L-Server |
| RESOURCES | Resource allocation status |
Displays the detailed information of the L-Server.
The following information is displayed.
Note
The number and display order of the items may be changed by enhancement of Resource Orchestrator.
| Item Name | Description |
|---|---|
| Name | L-Server name |
| Label | Label |
| Comment | Comment |
| PhysicalServer |
Physical server name Displayed when the L-Server is in the following state.
|
| OriginalServer | The physical server or resource pool to allocate to L-Servers |
| ServerPool |
The name of the pool in which the physical servers allocated to L-Servers are registered Displayed when the L-Server is in the following state.
|
| Status | Operational status of the L-Server |
| PowerStatus | Power status of the L-Server |
| Resources | Resource allocation status |
| ControlledResources |
The scope of the controlled resources This is displayed for L-Servers linked to configured physical servers. |
| NumOfNIC | The number of NICs |
| NIC[num] |
The name of the network resource to be allocated to the L-Server In num, the index number of the network element is displayed. The number is equal to or larger than 0. |
| NIC[num][MACAddress] | MAC address of NIC |
| NIC[num][PhysicalNum] |
The number of the physical NIC corresponding to the NIC of an L-Server The number is equal to or larger than 0. |
| NIC[num][IPAddress] |
IP address to allocate to the L-Server In num, the index number of the network element is displayed. The number is equal to or larger than 0. |
| NIC[num][netlinknum][IpAddress] | IP address |
| NIC[num][netlinknum][VlanMode] | VLAN mode |
| NIC[num][netlinknum][DNSServer] | DNS server address |
| NIC[num][netlinknum][DefaultGateway] | Default gateway address |
| NICGroup[num][netlinknum][IpAddress] | IP address |
| NICGroup[num][netlinknum][VlanMode] | VLAN mode |
| NICGroup[num][netlinknum][DNSServer] | DNS server address |
| NICGroup[num][netlinknum][DefaultGateway] | Default gateway address |
| NICGroup[num][netlinknum][NicLinks] | NIC number to be bound |
* Note: Not displayed when using rack mount servers on which agents have not been registered.
| Item Name | Description |
|---|---|
| Name | L-Server name |
| Label | Label |
| Comment | Comment |
| VmHost |
VM host name Displayed when the L-Server is in the following state.
|
| VmGuest |
VM name corresponding to the L-Server Displayed when the L-Server is in the following state.
|
| OriginalServer | The VM host or the resource pool in which virtual PCs to be allocated to the L-Server are to be created |
| VMHostPool |
The name of the pool in which the VM host with the virtual PCs allocated to the L-Server is registered Displayed when the L-Server is in the following state.
|
| Status | Operational status of the L-Server |
| PowerStatus | Power status of the L-Server |
| Resources | Resource allocation status |
| ControlledResources |
The scope of the controlled resources The combination of Server, Storage, and Network is displayed. This is displayed for the L-Servers linked with configured virtual PCs. |
| NumOfNIC | The number of NICs |
| NIC[num] |
The name of the network resource to be allocated to the L-Server In num, the index number of the network element is displayed. The number is equal to or larger than 0. |
| NIC[num][IPAddress] |
IP address to allocate to the L-Server In num, the index number of the network element is displayed. The number is equal to or larger than 0. |
| NIC[num][MACAddress] |
MAC address to allocate to the L-Server In num, the index number of the network element is displayed. The number is equal to or larger than 0. |
| RefreshIP |
|
Creates a link between an L-Server and a configured virtual PC or SBC server.
Cancels the link between an L-Server and a configured virtual PC or SBC server.
In file.xml, specify the XML file with the definitions of the resources that comprise the L-Server.
When changing the basic information or specifications of an L-Server, multiple NICs can be specified as the modification target in the XML file.
For details on the XML file definition, refer to "Table A.2 Excerpt from Definition Information for Physical L-Servers (XML)" and "Table A.1 Excerpt from Definition Information for Virtual L-Servers (XML)".
Specify the display format. "text" or "xml" can be specified.
When -format is omitted, it is displayed in text format.
For this option, only "physical" can be specified. Specify when using the modify subcommand to target a physical L-Server with the operation.
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.
In name, specify the name of the target L-Server to perform an operation with.
For an L-Server allocated in a tenant or a resource folder, specify the tenant name or resource folder name using slashes ("/").
When specifying the convert subcommand, specify the name for the L-Server. For details on the characters that can be used for L-Server names, refer to the following section in the "Reference Guide (Command/XML) CE".
When the convert subcommand is specified without the -name option, the L-Server name is set as follows:
The VM name is set as the L-Server name.
The command exits with an error.
The physical server name will be set as the L-Server name.
The command exits with an error.
Specify this option when using the revert subcommand to forcibly cancel the link between a virtual L-Server and a virtual PC created using Resource Orchestrator.
In folder, specify a resource folder to place L-Servers in. For the hierarchized resource folder, specify the resource folder name using slashes ("/"). If omitted, L-Servers are placed in the home folder.
When executed by a user who has multiple access scopes specified, it cannot be omitted. Specify a resource folder.
This option can only be specified for deldisk.
In label, specify the label for the L-Server.
In comment, specify any comments for the L-Server.
In with, specify the virtual PCs and SBC servers to link with the target L-Server.
Use slashes ("/") to connect the names of the resource folder and the resource pool.
/Resource_folder_name/Resource_pool_name/VM_host_name/Virtual_PC_name /Resource_pool_name/VM_host_name/Virtual_PC_name /Resource_folder_name/Resource_pool_name/SBC_server_name /Resource_pool_name/SBC_server_name
Automatically updates the IP addresses of the virtual L-Servers linked with virtual PCs when the IP addresses of those virtual PCs are changed by DHCP.
This option can only be specified for virtual PCs that operate on any of the following VM hosts. If it is specified for virtual PCs other than those that operate on VMware, an error occurs.
Note
Even if this option is specified in either of the following cases, it will not be possible to automatically update the IP addresses of the corresponding L-Servers when the IP addresses of virtual PCs are changed by DHCP.
In order to automatically update the IP addresses of L-Servers that are created by linking, execute the rcxadm lserver revert command to cancel the link between the virtual L-Servers and the virtual PCs and then create the link again, specifying this option.
OS Administrator
Admin server
> rcxadm lserver list
NAME TYPE SPEC DISKS IPADDRESSES STATUS RESOURCES
---- ---- -------------- -------------- ----------- ------ ---------
L-Server1 Virtual 1.0GHz,1,2.0GB 30.0GB,100.0GB 10.20.30.40,10.20.40.50 normal allocated
L-Server2 Virtual 1.0GHz,1,2.0GB 30.0GB,100.0GB 10.20.30.41 stop preserved
L-Server3 Virtual 1.0GHz,1,2.0GB 30.0GB,100.0GB - stop defined
L-Server11 Physical 2.3GHz,2,72.0GB 30.0GB 10.30.40.2 normal allocated
L-Server12 Physical 2.3GHz,2,72.0GB 30.0GB 10.30.40.3 stop preserved
L-Server13 Physical 2.3GHz,2,72.0GB 30.0GB - stop defined
> rcxadm lserver show -name /TenantA/test4
Name: test4
ServerType: Virtual
VMType: VMware
OSType: Microsoft Windows Server 2012
CPUArch: IA
CPUPerf: 1GHz
CPUReserve: 0.7GHz
CPUShare: 1000
NumOfCPU: 1
MemorySize: 1GB
MemoryReserve: 0.7GB
MemoryShare: 1000
VmHost: vmhost
VmGuest: test4-62
Status: stop
PowerStatus: off
Resources: allocated
NumOfDisk: 1
Disk[0]: test4-0-disk0
DiskSize[0]: 4GB
NumOfNIC: 1
NIC[0]: vnet1
NIC[0][IPAddress]: 192.168.1.2
NIC[0][MACAddress]: 00:50:56:91:09:21
Redundancy: None
Positioning: Fixed
Priority: 128
ReserveResources: true
OverCommit: true
Refreship: true
> rcxadm lserver modify -name web-lserver1 -file web-lserver1.xml
This command returns the following values:
The command executed successfully.
An error has occurred.