![]() |
When configuring a new device, the OnBoard appliance administrator should not assign a command template when the device is either of the following two types of devices:When adding any other kind of new device, the OnBoard appliance administrator needs to do the following:
• Find out if the new device and its firmware have been tested and proven to work with the applicable default command template.
• If the new device is running untested firmware, test whether the firmware is compatible with the applicable default command template.
• If communications cannot be established with the new device using the default command template, use the onbdtemplate utility to create and test a new command template, after making any needed changes to the commands that manage communications between the device and the OnBoard appliance.
• If a new template cannot be made to work, create a custom Expect script to handle the device’s requirements.See To find out if an existing command template works with a new device: for how to perform the above-listed steps.
1. Check the release notes to see if the device is in the list of tested devices, and if the device is listed, to see if the device’s firmware level is also listed.
b. Scroll down to the section heading Firmware, then find and click the Release Notes link.
c. Locate the table of tested devices and firmware levels and check the new device’s model and firmware level against the list.
2. If the device and its firmware level are listed in the release notes as having been tested, assign the device the appropriate device type and the associated default command template for the device type and you are done.
3. If the device is listed in the release notes as a tested device, but the firmware version is not the same as the one tested or if the device is not listed at all, do the following steps:
a. Assign the device the appropriate device type and the associated default command template for the device type.
4. If the device is an RSA II type device, if you cannot run power commands on the device using the rsa.default template, assign the device the rsa.limited.default template.
5. If you can run power commands on the device, test the rest of the device management commands that are supported on the device. If they work, you are done.
6. NOTE: Even if the power management commands do not work on a new device, you can usually establish a connection to the SP’s console.
b.
8. If you can access the server but still cannot access the SP’s console, double-check the user name and password you are using against the user name and password that are configured for the device.
9. Once you have established the connection to the SP’s console, type the help command, which gives you the syntax you need to use for the commands supported by the SP.Perform this procedure after To find out if an existing command template works with a new device:, if the default templates do not work for a new device.
2. Select New from the menu.
3. Enter a template name, such as rsa.new. The editor brings up a template for a new command template and assigns it the name you specified.
4. Enter the device type in the form type = device_type. Using the syntax supported on the device, perform the following steps to fill in the commands supported by the SP. Follow the instructions in the template you are editing.NOTE: Sensors may not be supported. If any command is not supported, leave it commented out in the template.
17.
18. Enter the escape sequence used to escape from the console in the form devconsole_esc = devconsole_esc_sequence.CAUTION:You must specify the device console escape sequence to block users who are authorized for device console access from being able to escape to the SP console whether or not they are authorized.
22. Log into the Web Manager as an administrative user and select the Config-Devices menu option.When an administrative user logs in, the new template is automatically added to the /etc/onboard_templates.ini file and is included in the list of command templates that you can assign to a device.When onbdtemplate is used to test a template, extra debugging information is provided to report on commands sent to and received from the device.
1. Log into the OnBoard appliance’s console as an administrator and invoke the onbdtemplate utility.
2. Select Test from the menu.
3. At the prompt, confirm that you want to continue by entering y. A list of templates appears.
5. Select a device to test the template against. The editor runs the commands in the specified template and returns debugging information that you can record for making command changes in a new template.
7.