ServerView Resource Orchestrator Cloud Edition V3.4.0 Reference Guide (Command/XML)

15.7.2 Modification

When modifying network devices, only elements that have been defined can be modified.

The following elements can be modified:

• Admin IP Address

• Admin LAN subnet mask

• Device name

• Use of AMPP

• Location

• Type Information

• Auto-configuration for the network device

• Group ID

• SNMP Information

• Login Information

• Monitoring Information

• Web Management Window URL

• VFAB information

• Port Information and S-TAG ID

If defining multiple elements, they will be modified at the same time.
When performing batch modification, ensure the admin IP address is defined to identify the target resources for modification. Specify "modify" for Registration Mode (the Mode element).

The XML definition for modification of each element is shown below.

Example

• Changing the admin IP address, device name, and use of AMPP

  <Netdevice ip="New Admin IP Address" name="New Device Name" portprofile="New value for the use of the AMPP">
  ...
  </Netdevice>

• Modifying a location:

  <Location>Modified Location</Location>

• Modifying the type information:

  <Types>
    <Type>Modified Type</Type>
  </Types>

• Modifying auto-configuration for network device (when changing the value to "true")

  <AutoConfiguration>true</AutoConfiguration>

• Modifying a Group ID:

  <Redundancy group_id="Modified Group ID"></Redundancy>

• Modifying the SNMP information:

  <Snmps>
    <ReadCommunity>Modified Community Name</ReadCommunity>
  </Snmps>

• Modifying the login information:

  <LoginInfo="Modified protocol" auth_type="Modified Management Method of Authentication Information" authority="Modified Administrator Authority" check="Modified Account Confirmation">
    <IpAddress>Modified Destination IP Address</IpAddress>
    <Port>Modified Destination Port Number</Port>
    <Tenant>Modified Tenant Name</Tenant>
    <User>Modified User Account for Connection</User>
    <Password>Modified Password for Connection</Password>
    <PrivilegedPassword>Modified Administrator Password</PrivilegedPassword>
    <PasswordEncryption>Presence or absence of password encryption after modification</PasswordEncryption>
  </LoginInfo>

• Modifying the monitoring information:

  <Monitoring>
    <Methods>
      <Method>Monitoring Method After Modification</Method>
    </Methods>
    <Interval>Modified Monitoring Interval</Interval>
    <RetryCount>Modified Retry Count</RetryCount>
    <Timeout>Modified Timeout</Timeout>
  </Monitoring>

• Modifying the Web management window URL:

  <MgmtURL>Modified Web Management Window URL</MgmtURL>

• Modifying the VFAB information:

  <Vfabs>
    <Mode>VFAB Registration Mode</Mode>
    <Vfab vfabid="VFAB ID" name="VFAB name after modification" mode="Operation mode after modification" vfabauto="Auto-configuration of VFABs">
      <Tenants>
        <Tenant>Modified Tenant Name</Tenant>
        <Tenant>Modified Tenant Name</Tenant>
        ......
      </Tenants>
      <Dot1adPorts>
        <Dot1adPort name="Sending and Receiving Port of the IEEE802.1ad Frame after Modification"></Dot1adPort>
      </Dot1adPorts>
      <CirPorts>
        <CirPort name="CIR port name or CIR Link Aggregation Port Identifier Information after Modification"></CirPort>
      </CirPorts>
    </Vfab>
    ......
  </Vfabs>

• Modifying the port information and S-TAG ID

  <Ports>
    <Port name="Port Name">
      <StagId>New S-TAG ID</StagId>
    </Port>
  </Ports>

Information

• Type information cannot be modified when the target network device for modification is already registered in a network pool.
  When changing the type information of a registered network device, unregister the device from the network pool.

• Type information cannot be modified when the target network device for modification has been registered as "Fabric" or "ManagementHost".
  In order to change the type information of the target network device from "Fabric" or "ManagementHost" to something else, unregister the network device and then re-register it.

• Type information of network devices which are already registered cannot be changed to "Fabric" or "ManagementHost".
  In order to change the type information of the target network device to "Fabric" or "ManagementHost", unregister the network device first and then re-register it.

• Redundancy configuration information cannot be modified when there is a firewall or server load balancer deployed for the network device to be modified.

• When modifying login information, all existing login information is replaced.
  All registered login information is deleted.

• The content of VFAB information modification differs depending on the value specified for the VFAB registration mode.
  "replace", "add", "modify", or "delete" can be specified.
  When omitted, "replace" is specified. The operation performed for each specified mode is as follows.

  • When "replace" is specified for the VFAB registration mode

    All existing VFAB information is replaced.
    It is necessary to describe all VFAB information, even that which has not been modified.
    If there is no specification, VFAB information will be deleted.

  • When "add" is specified for the VFAB registration mode

    Specified VFABs are added.

  • When "modify" is specified for the VFAB registration mode

    Specified VFAB information is modified.

  • When "delete" is specified for the VFAB registration mode

    Specified VFABs are deleted.

• When modifying port information, all existing port information is replaced.
  If there is nothing specified, port information will be deleted.
  However, the port information obtained from devices will not be modified even if there is nothing specified.