Preparation required in advance to manage network devices as resources is explained in this section.
The infrastructure administrator creates network configuration information (XML definition files) for registering network devices based on the network device information (admin IP address, account information, connection information) obtained from the network device administrator.
About the information to be confirmed beforehand
When specifying the ifName for a network device as the "unit connection port name" of link information
Check the ifname of a network device using the snmpwalk command.
Example
snmpwalk -v 1 -c [SNMP_community_name] [IP_address] ifName
If the information is available from the manual or vendor of the destination device, obtain it from there.
When connection information is already registered
When link information is already registered, if you register several network devices at once with link information defined in network configuration information, already registered link information is processed according to the mode of the link information registration.
When "add" is specified
The same link information is not overwritten.
When "modify" is specified
Already registered link information is deleted, and then defined link information is registered.
Already registered connection information can be retrieved using the rcxadm netconfig export command.
When registering network devices as network devices before installing them
When a network device is registered as a network device, the monitoring function starts monitoring of state that device. To avoid unnecessary monitoring, specify "true" for the Maintenance element when registering devices.
This setting enables the maintenance mode, excluding that device from monitored devices. After installing a network device and making it a monitoring target, release the maintenance mode.
The Maintenance element can be specified on individual network devices (individual Netdevice elements) to be registered.
When checking account information on registration or modification of a network device as a network device
When performing network device automatic configuration, Resource Orchestrator logs in to the network device using the registered account information. For this reason, if incorrect account information is specified, automatic configuration of the network device cannot be performed.
To check in advance whether the specified account information is correct, specify "check=true" for the LoginInfo element. This allows the login process to be performed using the specified account to check that login is possible.
The LoginInfo element can be specified on individual network devices (individual Netdevice tags) to be registered.
When "telnet" has been specified in the protocol element, only account information for network devices satisfying the following conditions can be confirmed.
Vendor | Unit Name | Prompt Type | Prompt Character |
|---|---|---|---|
Fujitsu | SR-X | Login prompt | Login: |
Password prompt | Password: | ||
Command prompt (*1) | Arbitrary string# | ||
Arbitrary string> | |||
Cisco | Catalyst | Login prompt | Username: |
Password prompt | Password: | ||
Command prompt (*1) | Arbitrary string# | ||
Arbitrary string> | |||
Nexus | Login prompt | login: | |
Password prompt | Password: | ||
Command prompt (*1) | Arbitrary string# | ||
Arbitrary string> | |||
Brocade | VDX | Login prompt | Login: |
Password prompt | Password: | ||
Command prompt (*1) | Arbitrary string# | ||
Arbitrary string> | |||
F5 Networks | BIG-IP (*2) | Login prompt | There are no restrictions. |
*1: The "#" or ">" following arbitrary string is used as a prompt character for the command prompt.
*2: The model name for the BIG-IP LTM series is handled as "BIG-IP".
When registering a network device that provides a Web interface for management
When a problem occurs on the system, sometimes investigation may be performed using the Web interface provided by the network device. In such cases, it was necessary to start the web interface of the network device from another Web browser. However, specifying a URL for opening the web interface of the network device for the MgmtURL element when registering the network device makes it be possible to quickly open the web interface of the network device from the ROR console.
The MgmtURL element can be specified on individual network devices (individual Netdevice tags) to be registered.
When registering redundant network devices as network devices
Network devices that have the same "vendor name" and "device name" can be registered for redundant configurations. When registering a network device that has the same vendor name and device name, specify the same value as the registered network device for "Group_ID" of the Redundancy group_id element to treat that device as being in a redundant configuration.
For the "vendor name" and "device name" of a network device, collect MIB information from the network device when registering it, and confirm that the "vendor name" and "device name" are same as the ones of the registered device.
When registering information about connections with rack mount servers
When using a rack mount server with Resource Orchestrator, it is necessary to align the NIC number of the rack mount server with the subscript of the interface name of the server OS in advance. Also, use NIC1 and NIC2 for the admin LAN.
As NIC numbers used for the public LAN are 3 or a higher number, be careful when specifying connection information.
Example
[Windows]
NIC number = the subscript of the OS interface name
The first NIC: Local Area Connection 1
The second NIC: Local Area Connection 2
[Linux]
NIC number -1 = the subscript of the OS interface name
The first NIC: eth0
The second NIC: eth1
When registering an L2 switch
When registering an L2 switch as a network device, omit the Tenant element.
When registering models other than those with model definitions for network devices
Add the model of the network device to be registered to the model definition for network devices, and register the network device after updating the model definition file.
When regularly monitoring network devices registered as network device resources
When the workload of the network or network devices is temporarily increased, the response to the communication of regular monitoring may be delayed. When this delay exceeds the time-out period, the communication for regular monitoring will be executed again.
Therefore, if the monitoring interval (Interval element) or timeout period (Timeout element) specified during registration is short, the number of communications for regular monitoring may increase. It is recommended to use the default values in order to avoid increasing the load on the network and network devices.
When register connection information of BIG-IP
When register connection information of BIG-IP, please register in the following order.
Registering network configuration information that is excepted connection information.
Please confirm port information is displayed in screen for resource details of registered BIG-IP in ROR console.
Registering network configuration information that is included connection information.
In that case, please omit or specify "add" to registration mode of network device (value of Mode tag under the Netdevices tag)
Information
Necessary definitions based on the number of devices to be registered.
When registering each network device individually
The Netdevice element must be the first.
When registering all network devices at once
Starting with the Netconfig element, define the settings for each network device under the Netdevices element.
When registering multiple network devices at once, connection information can be also defined under the Links element.
See
For details on network configuration information (XML definitions), refer to "14.6 Network Configuration Information" in the "Reference Guide (Command/XML) CE".
For details on the rcxadm netconfig command, refer to "3.7 rcxadm netconfig" in the "Reference Guide (Command/XML) CE".
For details on releasing maintenance mode, refer to "22.1 Switchover of Maintenance Mode" in the "User's Guide for Infrastructure Administrators (Resource Management) CE".
For details on model definitions for network devices, refer to "14.13 Network Device Model Definitions" in the "Reference Guide (Command/XML) CE".
Preparation required beforehand to use network device file management function is explained in this section.
Configure definitions of the network device file management function
When using network device file management function, it is necessary to configure the function to be used and the number of generation files in the definition file beforehand.
For details on the configuration of network device management function, refer to "9.4.8.3 Network Device Management Function Definition File".
Register external FTP servers
When managing network device files, for network devices without FTP server function, an external FTP server is necessary.
Backup the network device file
Transfer the backed up the network device file to admin server as the manager
Transfer the backed up the network device file from admin server as the manager
Restore the network device file transferred from admin server to target network device
Excute the rcxadm netconfig import command and register external ftp server.
For details on the rcxadm netconfig command, refer to "3.7 rcxadm netconfig" in the "Reference Guide (Command/XML) CE".
Point
When using Nexus 5000 series, it is necessary to set the following settings for external ftp server in advance.
Set the change route.
Change the route directory("/") of account to home directory.
Set the login information of network device
When registering or changing network device, register the login information in the network configuration information(XML definition).
Case of "SR-X series"
LoginInfo protocol: ftp
User: Need to specify
Password: Need to specify
Tenant: Do not specify
Case of "BIG-IP Local Traffic Manager series"
LoginInfo protocol: ssh
LoginInfo authority: admin
User: Need to specify
Password: Need to specify
Tenant: Do not specify
Case of "Nexus 5000 series"
LoginInfo protocol: telnet
LoginInfo authority: admin
User: Need to specify
Password: Need to specify
Tenant: Do not specify
Case of the other support device
LoginInfo protocol: telnet
LoginInfo authority: user
User: Need to specify
Password: Need to specify
PrivilegedPassword: Need to specify
Tenant: Do not specify
Note
Explains points to keep in mind when using this function.
When using "IPCOM EX series"
When restoring the network device file without initializing the authentication information
Excute the rcxadm netdevice cfexport command and export the network device environment file in advance, and then configure IPCOM EX manually.
For details on configuration, refer to the IPCOM EX manuals.
When deleting, changing or deleting the account information registered in this product
Excute the rcxadm netdevice cfbackup command and backup the network device configuration file.
When restoring without backing up, due to account information inconsistency restore may fail.
When using automatic updating function of the authentication information
When excuting the rcxadm netdevice cfrestore command and restoring the network device environment file, authentication information may initialize.
Point
The automatic updating function as follows.
When "skey" in accout authentication type is specifyed
When the authentication in SSL-VPN client or L2TP/IPsec client is performed "local database operation"
When using "BIG-IP Local Traffic Manager series"
The user specified in login information must operate the network device with tmsh immediately after login.
Do not create the following files.
/var/local/ucs/environment.ucs
/var/local/scf/config.scf
When using "Nexus 5000 series"
When restoring "Nexus 5000 series", perform the following.
When not connecting Nexus 2000 series
(1) Log in to the target Nexus, and confirm the management IP address and SNMP community name.
(2) Clear startup-config using write erase command.
(3) Restart the target Nexus.
(4) After restarting, log in to the target Nexus again.
(5) Set the management IP address and SNMP community name which confirmed in (1).
(6) After log out of the target Nexus, performed to restore.
When connecting Nexus 2000 series
(1) Log in to the target Nexus, and confirm the management IP address and SNMP community name.
(2) Clear startup-config using write erase command.
(3) Restart the target Nexus.
(4) After restarting, log in to the target Nexus again.
(5) Set the FEX.
(6) Set the management IP address and SNMP community name which confirmed in (1).
(7) After log out of the target Nexus, performed to restore.
When using "Cisco ASA 5500 series"
When using redundancy configurations and only one device is fault, do not need to excute the rcxadm netdevice cfrestore command.
By the function in "Cisco ASA 5500 series", reflect the configurations from the network device in active status automatically.
For details, refer to "Cisco ASA 5500 series" manuals.
When using "Catalyst series"
If executing restoration to "Catalyst series", please export network device file in rcxadm netdevice cfexport command and log in directly to network device to execute restoration manually.
For logging in to network device and restoration order, please refer to manual of network devices.
When executing restoration using rcxadm netdevice cfrestore command, the command may fail.
When message is displayed with code "08" after rcxadm netdevice cfrestore command failed displaying 62786 message, please execute deal that is described in "Messages".
The definition of the configuration management of the network device can be changed by setting the value to the following definition files beforehand.
[Windows Manager]
Installation_folder\SVROR\Manager\etc\customize_data
[Linux Manager]
/etc/opt/FJSVrcvmr/customize_data
unm_mon.rcxprop
Specify variables in the definition file in the following format.
Parameter =Value |
Specify variables for network device configuration file management.
Parameter | Meaning and Value |
CONFIG_BACKUP | Specify whether to enable network device file management function.
If left blank, "true" is specified. |
CONFIG_AUTO_MASTER | Specify whether to collect a master configuration file when registering a network device as a resource.
If left blank, "false" is set. |
CONFIG_AUTO_BACKUP | Specify whether to back up configuration files when network device auto-configuration is performed.
If left blank, "false" is set. |
CONFIG_RETRY_COUNT | Specify the retry count using a value between 0 and 10 for the network device connection when configuration backup is performed. If left blank, "3" is set. |
CONFIG_TIMEOUT | Specify the time out value using a value between 10 and 60 for the network device connection when configuration backup is performed. If left blank, "30" is set. |
CONFIG_NOTIFY_COMMAND | Specify whether to output a notification message if a change is detected in the backed up configuration when the rcxadm netdeivce cfbackup command is executed (On demand collection).
If left blank, "false" is set. |
CONFIG_NOTIFY_AUTO | Specify whether to output a notification message if a change is detected in the backed up network device configuration file when network device autoconfiguration is performed.
If left blank, "false" is specified. |
Example
CONFIG_BACKUP=true
CONFIG_AUTO_MASTER=true
CONFIG_AUTO_BACKUP=true
CONFIG_RETRY_COUNT=3
CONFIG_TIMEOUT=30
CONFIG_NOTIFY_COMMAND=true
CONFIG_NOTIFY_AUTO=false
