Top
ServerView Resource Orchestrator Cloud Edition V3.3.0 Automatic Quarantining FunctionUser's Guide
FUJITSU Software
Chapter 4 Reference > 4.3 rcxadm lserver
PreviousNext

4.3 rcxadm lserver

Name

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

Format

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


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


delete
Deletes an L-Server. The resources allocated to the L-Server are released automatically and the definitions for the L-Server are also deleted.
modify
Changes the network resources comprising the L-Server.
  • Changes the connection destination and the IP address of the network connected to the NIC of the L-Server.
    Multiple NICs can be specified as the modification target in the XML file.
    • For an L-Server linked with a configured virtual PC or SBC server
      - 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
    • When the NIC IP address is changed, the IP address used by the target OS to connect to the L-Server is not reconfigured automatically.
      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 the NIC is connected to network resources
      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
    • Modification of the IP address and the destination network is performed for the NIC corresponding to the NICIndex specified in the XML file.
    • During changing of the destination network, the existing NIC definition is compared to the contents of the XML file, and the following processing is performed.
      - 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.
    • When adapting to VM management software
      Modify the destination network of the L-Server so it is aligned with the VM guest.
    • When adapting to L-Servers
      Using the VM management software, modify the network of the target VM guest so it is aligned with the L-Server.
list
Displays a list of L-Server information.
The following information is displayed.
  • For Physical L-Servers
    Table 4.2 Physical L-Server Information
    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
  • For Virtual L-Servers
    Table 4.3 Virtual L-Server Information
    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
show
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.
  • For Physical L-Servers
    Table 4.4 Detailed Information of Physical L-Servers (Excerpt)
    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.
    • Resources are already allocated (allocated)
    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.
    • Resources are already allocated (allocated)
    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.
  • For Virtual L-Servers
    Table 4.5 Detailed Information of Virtual L-Servers (Excerpt)
    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.
    • Resources are already allocated (allocated)
    VmGuest
    VM name corresponding to the L-Server
    Displayed when the L-Server is in the following state.
    • Resources are already allocated (allocated)
    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.
    • Resources are already allocated (allocated)
    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
    • When the IP addresses of virtual PCs are changed, the IP addresses of the virtual L-Servers linked to those virtual PCs are also changed accordingly, and "true" is displayed.
      • true
      When the IP addresses of virtual PCs are changed, the IP addresses of the virtual L-Servers linked to those virtual PCs are also changed accordingly.
    • Displayed when there are virtual PCs operating on any of the following VM hosts.
      • VMware
      • Hyper-V
      • XenServer
convert
Creates a link between an L-Server and a configured virtual PC or SBC server.
revert
Cancels the link between an L-Server and a configured virtual PC or SBC server.
Options


-file file.xml
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 the definitions of XML files, 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)".
-format text|xml
Specify the display format. "text" or "xml" can be specified.
When -format is omitted, it is displayed in text format.
-type physical
For this option, only "physical" can be specified. Specify when using the modify subcommand to target a physical L-Server with the 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.
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".
  • "List of Items Specified in XML Definitions for Physical L-Servers" in "15.3.1 Definition Information for Physical L-Servers (XML)"
  • "List of Items Specified in XML Definitions for Virtual L-Servers" in "15.3.2 Definition Information for Virtual L-Servers (XML)"
When the convert subcommand is specified without the -name option, the L-Server name is set as follows:
  • When linking configured virtual PCs with virtual L-Servers
    • If the VM name of the configured virtual PC is a usable value for the L-Server name
      The VM name is set as the L-Server name.
    • If a value other than a usable value is used for the L-Server name
      The command exits with an error.
  • When linking configured SBC servers with physical L-Servers
    • If the name of the physical server of the configured SBC server is a usable value for the L-Server name
      The physical server name will be set as the L-Server name.
    • If a value other than a usable value is used for the L-Server name
      The command exits with an error.
-force
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.
-to folder
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.
-allow deldisk
This option can only be specified for deldisk.
-label label
In label, specify the label for the L-Server.
-comment comment
In comment, specify any comments for the L-Server.
-with with
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
-refreship
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.
  • VMware
  • Hyper-V
  • XenServer
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.
  1. The modified IP addresses of the virtual PCs are not included in the IP address ranges of any network resources.
  2. The modified IP addresses of the virtual PCs are already being used by other L-Servers.
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.

Usage Example


PreviousNext
Copyright 2017-2018 FUJITSU LIMITED