[Index]
To access the latest documentation, go to Documentation and Resources at: https://voss.portalshape.com
You can build a repository of IOS commands to be run when certain events, such as adding an IOS device, occur. Each set of IOS commands and associated event is known as a Command Builder.
For a list of events with default set of IOS commands and available variables, see Local Break Out and Analog Gateway Events, IOS Commands, and Variables.
The default Command Builders exist at the sys.hcs hierarchy level.
You can define customized Command Builders at any hierarchy node. When an event occurs, Command Builders nearest (at or above) the hierarchy node of the event are checked first. For instance, if an event occurs at a customer hierarchy level, Command Builders at the customer level are checked before Command Builders at the provider or sys.hcs level. Command Builders at a higher level are checked only if no builders match at a nearer hierarchy level. If no customized Command Builders are defined, the default Command Builders at sys.hcs are checked. Multiple Command Builders may be run for the same event at the same hierarchy node.
Set up a Command Builder
This procedure sets up a Command Builder that contains an IOS Commands template for an event.
Note
One event can trigger multiple Command Builders.
To set up a Command Builder:
Field | Description |
---|---|
Name | Enter a unique name for the builder. This field is mandatory. |
Event Name | Select the event that triggers the builder. This field is mandatory |
Description | Enter a description for the builder. |
Command Template | Enter the IOS Commands template for the event, one command per line. You can use macros in the IOS Commands template for variable substitution. |
Enabled | Clear the Enabled check box to create a builder but not have it available to run. |
Applicable Device Type | Select the device type that the commands can run on. This field is mandatory. |
Clone a Command Builder
This procedure clones a Command Builder that contains an IOS Commands template for an event. For instance, use this procedure to modify one of the default Command Builders to suit your needs.
Note
One event can trigger multiple Command Builders.
To clone a command builder:
Field | Description |
---|---|
Name | Enter a unique name for the builder. This field is mandatory. |
Event Name | Select the event that triggers the builder. This field is mandatory |
Description | Enter a description for the builder. |
Command Template | Enter the IOS Commands template for the event, one command per line. You can use macros in the IOS Commands template for variable substitution. |
Enabled | Clear the Enabled check box to create a builder but not have it available to run. |
Applicable Device Type | Select the device type that the commands can run on. This field is mandatory. |
View IOS Commands Log
Using the IOS Commands log, an administrator can see a list of command sets that were triggered by different events. An administrator can copy the IOS Commands template and paste it into the IOS device CLI to be executed.
By default, the command sets are listed with the most recent at the top.
Note
Deleting a hierarchy node, such as a site, deletes all IOS Command Builders and associated IOS Commands templates configured at the hierarchy node.
Perform these steps:
Column | Description |
---|---|
Timestamp | The time of the event that triggered the Command Builder. |
Device Name | The IOS device associated with the event that fired the Command Builder. |
Gateway Name | The SIP Local Gateway or Analog Gateway associated with the event that fired the Command Builder. |
Command Builder | The name of the Command Builder that was triggered. To view the IOS Commands template associated with a Command Builder, click the Command Builder name. The Command Builder configuration is displayed, including the IOS Commands template. |
Description | The description of the Command Builder that was triggered. |
Device Deleted | Select this check box if the associated device has been deleted. |
Hierarchy | The hierarchy level of the event that triggered the Command Builder. |
Consolidate IOS Commands
To copy IOS commands to an IOS device CLI that is generated by multiple events, follow these steps:
To copy IOS commands:
Log in as provider, reseller, or customer administrator.
Set the hierarchy path to the customer or site for which you want to consolidate IOS commands.
Choose Apps Management > IOS > Consolidate Commands.
Click Add.
On the Consolidate Commands screen, complete at minimum, the mandatory Consolidate Commands Fields.
Click the required command templates listed in the Available list, and click Select to move them to the Selected list.
Click Remove to unselect a command template.
Note
You can change the order of the command templates by clicking Move Up and Move Down. However, the consolidated commands are generated in chronological order regardless of the order of the selected command templates.
Click Save. The new command consolidation instance appears in the list.
Click the command consolidation instance you created.
In the Command Template field, all the commands from the command templates you selected appear in one window. Comments are used to separate and identify the source command templates. You can edit the consolidated commands.
Any modifications to the Command consolidation, displays the entire list of commands in a single instance. The commands present earlier to the modification cannot be viewed separately as the commands from the earlier events are treated as a single instance.
Next Steps
After you have consolidated the IOS commands you want, copy them from the Commands Template field to the IOS device CLI.
Field | Description |
---|---|
Name * | Enter a unique name for the command consolidation. This field is mandatory. |
Description | Enter an optional description for the command consolidation. |
IOS Device * | Choose the IOS device from which you want to consolidate commands. |
Device Type * | Choose the device types for which you want to consolidate commands. IOS Device Choose this to get commands for the IOS device and any SIP Local Gateway or Analog Gateway hosted on that device. SIP Local Gateway Choose this to get commands only for the SIP Local Gateway. Analog Gateway Choose this to get commands only for the Analog Gateway. You do not get commands for devices that have been deleted. Note: If you select site hierarchy, only specific commands such as IOS Device or SIP Local gateway are displayed. To view both the IOS and Analog gateway commands, choose the customer hierarchy path. |
Regenerate IOS Commands
This procedure regenerates IOS commands for events that occurred for the selected device, and removes all old IOS commands for the selected device.
Because the variables that are used in generating IOS commands may change, you may want to regenerate IOS commands with the latest configuration. IOS commands can be regenerated for the following devices:
Regenerating commands for an IOS Device also regenerates commands for any SIP Local gateway or Analog Gateway hosted on the IOS Device.
To regenerate IOS commands:
Log in as provider, reseller, or customer administrator.
Choose one of the following depending on the device for which you want to regenerate IOS commands:
Click the device for which you want to regenerate commands.
Choose Action > Regenerate IOS Commands.
IOS commands for the events that had occurred for the selected device are regenerated. All old IOS commands for the selected device are removed.
Next Steps
HcsIOSConsolidatedCommandDAT
Title | Description | Details | |||||||||||||||||||||||||||||||||||||||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
Name * | Command Name |
|
|||||||||||||||||||||||||||||||||||||||||||||||
Description | A description for the command set |
|
|||||||||||||||||||||||||||||||||||||||||||||||
IOS Device * | IOS Device the gateway runs on |
|
|||||||||||||||||||||||||||||||||||||||||||||||
Device Type * | Applicable Device Type |
|
|||||||||||||||||||||||||||||||||||||||||||||||
Commands |
|
||||||||||||||||||||||||||||||||||||||||||||||||
Command Template | Command template triggered by the event |
|
|||||||||||||||||||||||||||||||||||||||||||||||
Timestamp | Indicates when the event occured |
|