Appendices : Device Configuration : Assigning a command template to a new device

Assigning a command template to a new device
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:
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.
See To find out if an existing command template works with a new device: for how to perform the above-listed steps.
To find out if an existing command template works with a new device:
1.
a.
b.
c.
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.
b.
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.
7.
a.
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.
10.
To use the onbdtemplate utility to create a new template:
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.
1.
2.
Select New from the menu.
3.
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.
5.
6.
7.
8.
9.
10.
11.
12.
13.
14.
15.
16.
17.
18.
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.
19.
20.
21.
22.
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.
23.
To use the onbdtemplate utility to test a template:
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.
2.
Select Test from the menu.
3.
4.
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.
6.
7.
8.