.. _consolidate_ios_commands:


.. rst-class:: chapter-with-expand

Consolidate IOS Commands
------------------------

To copy IOS commands to an IOS device CLI that is generated by multiple events,
follow these steps:


**Procedure**

1. 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
   :ref:`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.
   

**What to Do Next**

After you have consolidated the IOS commands you want, copy them from the
Commands Template field to the IOS device CLI.


.. _consolidate_commands_fields:

Consolidate Commands Fields
...........................

.. tabularcolumns:: |p{3.5cm}|p{12cm}|

+---------------+----------------------------------------------------+
| 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.                              |
+---------------+----------------------------------------------------+
|               | Choose the device types for which you want to      |
|               | consolidate commands.                              |
|               |                                                    |
|               | **IOS Device**                                     |
|               |                                                    |
|               | Choose this to get commands for the IOS device     |
| Device Type \*| 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.                                              |
+---------------+----------------------------------------------------+