If the default command template that applies to the type of device being configured does not work, the administrator can use the onbdtemplate utility to test a new device against another command template. If needed, onbdtemplate can also be used to create a customized template to make command changes that might make it possible to communicate with an SP whose firmware is slightly different from the tested version.
A template can be configured to keep repeating commands to achieve a goal such as reading output from multiple classes of sensors on an RSA II device or reading multiple event log files one by one until no more log files exist on an iLO-type service processor. Commands may be repeated until a string, such as No more entries, is returned. When commands are repeated, an escape sequence can be used to autoincrement the number in the command, which is needed, for example, when checking event log files.
Selecting New from the Action menu brings up an editor with a template file open for you to configure.
Selecting View,
Edit,
Copy,
Test or
Rename from the Action menu brings up a menu of templates like the one shown in the following screen example
If Test is selected, after the administrator selects a template, a list of devices that use the selected template appears, like the list shown in the following screen example
The first time you select any action to test, you are prompted to enter a username and password. If local authentication is specified for the device, enter the username and password that you entered to access the OnBoard. If another authentication method is specified for the device, use the appropriate username and password for the specified authentication method. The test command uses the same authentication and authorization processes that the OnBoard uses in its normal operation, as explained in
OnBoard Appliance Authentication Options and
OnBoard User and Group Configuration Options.
Each set of commands may be tested in any order after the login test is performed. Errors are generated if a command is entered out of logical order; for example, if the Reset command is issued for a server that is not powered on. After any test you can return to the editor to make changes.
While using the editor to Edit, Copy or create a New template, you can edit or delete fields and add comments. When the file is saved, error checking is performed. If an error is found, you are prompted either to enter the editor again to fix the error, or to discard the changes.
You cannot change templates whose name ends with .default. onbdtemplate warns about this restriction if you try to edit or rename these templates, and it requests confirmation before allowing you to create a new template with a .default suffix through the New, Rename or Copy functions.