.. _set-up-an-ios-device:

Add an IOS device
--------------------

.. tip:: 

   :ref:`use-action-search-to-navigate-automate`


1. Log in as provider, reseller, or customer administrator.
2. Set the hierarchy path to the customer hierarchy node where you want
   to set up the IOS Device.
3. Go to **IOS Devices**.
4. Click the **Plus** icon (+) to add a new record.
5. Mandatory. Fill out a name for the IOS device. Optionally, you can also add a description for the IOS 
   device. 

6. In the **Network Addresses** pane, configure the SERVICE_PROVIDER_SPACE
   address space.

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

   +---------------+----------------------------------------------------+
   | Field         | Description                                        |
   +===============+====================================================+
   | Address Space | Address Space Type. SERVICE_PROVIDER_SPACE is the  |
   |               | default. This field is required.                   |
   +---------------+----------------------------------------------------+
   | IPV4 Address  | Enter the IP address of the IOS Device.            |
   +---------------+----------------------------------------------------+
   |               | The **Host Name** field is automatically populated |
   |               | with the IOS Device Name. If the IOS Device Name   |
   |               | is not the host name, you can edit this field to   |
   |               | provide the host name, or provide an IP address in |
   | Host Name     | the **IPV4 Address** field.                        |
   |               |                                                    |
   |               | Note: Either a host name or an IP address is       |
   |               | required. If both are provided, the host name is   |
   |               | used. If a host name is provided must be           |
   |               | resolvable by the IOS Device.                      |
   +---------------+----------------------------------------------------+
   | Domain        | The domain of the IOS Device.                      |
   +---------------+----------------------------------------------------+
   | Description   | An optional description for the network address    |
   +---------------+----------------------------------------------------+

7. If NAT is used, also configure an APPLICATION_SPACE network address.
8. If a double NAT is deployed, also configure a CUSTOMER_SPACE network address.

9. Optional. Expand **Credentials**, then:

   a. Add credentials for CLI, SNMP_V2, SNMP_V3 credentials types.
      Click + to add more credentials.
   b. For CLI and SNMP_V3, fill in the user ID and password that you
      configured when you installed the IOS Device. For SNMP_V2, only
      the password is required.
   c. For SNMP credentials, choose RO (Read-only) or RW (Read or Write)
      for the Access Type. The default is RO.
   d. Optionally, provide a description for the credential.

   CLI credentials are used to log in to the IOS Device.

   .. note:: 

      SNMP configuration must be done manually on the IOS Device.

10. Save your changes.