Configure Devices

This chapter describes the tasks related to device configuration in Cisco Optical Site Manager.

Figure 1. Configure Devices

Manage authorization groups

Authorization groups are used to manage user and group attributes for authentication and authorization processes.

Follow these steps to create, edit, or delete authorization groups for devices.

Before you begin

Log into Cisco Optical Site Manager

Procedure

Step 1

Click Devices in the left panel.

The Device Configuration page appears.

Step 2

In the Devices section, click the Authorization Group section to expand it.

The table lists all the available groups.

Step 3

Perform these steps, as needed:

To perform these steps
Create a new authorization group

  1. Click the Add Auth Group button.

    The Add Authorization Group dialog box appears.

  2. Enter the Auth Group Name, Remote User Name, and Remote Password in their respective fields.

  3. Click Add.

    The new auth group is added to the table.
Edit an authorization group

  1. Click the Add Auth Group button.

    The Add Authorization Group dialog box appears.

  2. Enter the Auth Group Name, Remote User Name, and Remote Password in their respective fields.

  3. Click Add.

    The authorization group is added to the table.
Delete an authorization group

  1. Select the check box next to the authorization group you want to edit.

  2. Click the Delete Auth Group button.

    A confirmation message appears.

  3. Click OK.

    The authorization group is deleted from the table.

Add a device

Cisco Optical Site Manager automatically detects and onboards directly connected peer devices on the network. However, if you've added a new device after configuring Cisco Optical Site Manager, you can manually add the device for management using the application.

Figure 2. Add a Device

Follow these steps to add an NCS 1000 or NCS 2000 device to Cisco Optical Site Manager.

Before you begin

Log into Cisco Optical Site Manager

Procedure

Step 1

Click Devices in the left panel.

The Device Configuration page appears.

Step 2

In the Devices tab, click the Devices section to expand it.

A table appears that lists all the devices that are configured.

Step 3

Click the Add Device icon.

The Add Device dialog box appears.

Step 4

Select the Device Type from the drop-down list.

Select

to

ncs1000

add a NCS 1000 device.

ncs2000

add a NCS 2000 device.
unmanaged-network-element

add a device that is not actively managed by NCS 1000 or NCS 2000.

Step 5

Enter the Netconf Port.

Note

 
This field is displayed only if ncs1000 is selected in the Device Type drop-down list.

Step 6

Enter the Device Name and IP Address.

Step 7

Enter the UID.

Note

 
This field is displayed only if ncs1000 or ncs2000 is selected in the Device Type drop-down list.

Step 8

Select an authorization group from the Auth Group drop-down list.

Step 9

Click Add.

The device is added to Cisco Optical Site Manager and displayed in the Devices section.

Manage a device using IOS XR CLI

Table 1. Feature History

Feature Name

Release Information

Description

Direct CLI Access for Managed Devices

Cisco IOS XR Release 25.1.1

You can now directly access the Cisco IOS XR CLI for managed devices from the Devices section.

Cisco Optical Site Manager provides direct access to the Cisco IOS XR CLI for managed devices through the Devices section.

Figure 3. Manage a Device Using IOS XR CLI

Follow these steps to access and manage the device using the IOS XR CLI interface.

Before you begin

Log into Cisco Optical Site Manager

Procedure

Step 1

Click Devices in the left panel.

The Device Configuration page appears.

Step 2

In the Devices tab, click the Devices section to expand it.

A table appears that lists all the devices that are configured.

Step 3

Click the terminal icon next to the device under the Terminal column.

The terminal window is displayed, and the system prompts you to enter the username.

Step 4

Type the username and press Enter.

The system prompts you to enter the password.

Step 5

Type the password and press Enter.

Add unmanaged devices

Table 2. Feature History

Feature Name

Release Information

Description

Add Unmanaged Devices

Cisco IOS XR Release 24.3.1

The Add Device dialog box now includes the unmanaged-network-element option, allowing the addition of unmanaged devices.

This enhancement allows you to add and configure passive devices on the network.

Unmanaged devices are those not actively managed by NCS 1000 or NCS 2000. Add an unmanaged device to Cisco Optical Site Manager. Examples include switches, LAN controllers, and passive optical devices.

Follow these steps to add an unmanaged device.

Before you begin

Log into Cisco Optical Site Manager

Procedure

Step 1

Click Devices in the left panel.

The Device Configuration page appears.

Step 2

In the Devices tab, click the Devices section to expand it.

The table lists all the configured devices.

Step 3

Click the Add Device icon.

The Add Device dialog box appears.

Step 4

In the Add Device dialog box, perform these steps.

  1. Select unmanaged-network-element from the Device Type drop-down list.

  2. Click Add.

    The new device is added to Cisco Optical Site Manager and displayed in the Devices section.

Step 5

In the rack view, perform these steps.

  1. Right-click an empty rack unit and select Add a Passive Unit

    The Add Passive Unit in Ru Position dialog box is displayed.

  2. Select the unmanaged device from the Select Device drop-down list.

  3. Select the passive type, slot and passive UID from the respective drop-down lists.

  4. Click Provision.

A confirmation message is displayed.

Step 6

Click OK.

The device is added to Cisco Optical Site Manager and displayed in the Devices section.

Delete devices

Delete devices that are no longer used in the network.

Follow these steps to delete an NCS 1000, NCS 2000, passive device, or an external controller.

Before you begin

Log into Cisco Optical Site Manager

Procedure

Step 1

Click Devices in the left panel.

The Device Configuration page appears.

Step 2

Click the Devices section to expand it.

The table lists all the configured devices.

Step 3

Select the check box next to the devices you want to delete.

Step 4

Click the Delete Device(s) button to delete the selected devices.

A confirmation message appears.

Step 5

Click Yes.

Retrieve device diagnostics

Retrieve, download, and review diagnostics on the Diagnostics page.

Follow these steps to retrieve and download the device diagnostics:

Before you begin

Log into Cisco Optical Site Manager

Procedure

Step 1

Click Devices in the left panel.

Step 2

In the Devices tab, click the Diagnostics section to expand it.

The configured devices are listed in a table.

Step 3

Select the Node Diagnostics check box next to the device for which you want to retrieve the diagnostics.

Step 4

Click Retrieve.

A confirmation message appears.

Step 5

Click Yes to proceed.

A Request Accepted message appears.

Step 6

Click OK.

A message appears when the diagnostic action is completed.

Step 7

Select the check box next to the device for which you want to download the diagnostics and click Download.

The system downloads a zip file containing the logs.

The downloaded ZIP file contains diagnostic logs, which can be reviewed for troubleshooting, performance monitoring, or compliance purposes.

SOCKS Proxy

Socket Secure (SOCKS) is a standard proxy protocol for IP-based applications developed by IETF. SOCKS Proxy feature allows the Cisco Optical Site Manager node to access remote NCS 2000 nodes using SOCKS Proxy server. You can set the SOCKS proxy server as an External Network Element (ENE) or a Gateway Network Element (GNE).

Benefits

  • SOCKS Proxy is used when the Cisco Optical Site Manager node cannot connect directly to the remote NCS 2000 node through DCN.

  • OSPF need not be enabled to propagate the routes as routing to the remote node is done by the SOCKS Proxy server.

  • SOCKS Proxy allows the Cisco Optical Site Manager node to connect to remote nodes behind the firewall of a GNE.

Limitations

  • A SOCKS Proxy server must be used only to connect to small remote nodes (OLA nodes).

  • A SOCKS Proxy server must serve only up to five NCS 2000 nodes.

Change the Cooling Profile Control

Use this task to change the cooling profile control of the NCS 2006 node from automatic to manual or the other way round.

Before you begin

Log into Cisco Optical Site Manager

Procedure

Step 1

Click the hamburger icon at the top-left of the page, and select Device Configuration.

Step 2

Click the Configuration > Device Settings tabs.

Step 3

Choose the control from the Cooling Profile Control drop-down list.

Step 4

Click Apply.

A confirmation message appears.

Step 5

Click Yes.

SVO-LC device onboard in R25.1.1

Each Cisco Optical Site Manager instance created in the SVO-LC supports on boarding both NCS 2000 and NCS 1000 devices. Communication with these devices is through the bridge interface (br-devices) as output interface.

SVO-LC utilizes a SOCKS server to facilitate communication with NCS 2000 devices. For NCS 1000 devices, communication is handled through a local bridge integrated into the SVO-LC, which serves as a gateway with the IP address 192.168.254.65/26. This address should be configured as the Gateway IP when adding a new route to access the NCS 1000 device.

Configure additional route for NCS 1000 device

Use this task to establish communication with the NCS 1000 device.

Before you begin

Procedure

Step 1

Click Devices in the left panel.

The Device Configuration page appears.

Step 2

Click the Networking tab.

Step 3

Click the Add Devices Gateway icon under Devices Gateway.

The Add Devices Gateway dialog box appears.

Step 4

Enter the Subnet and Gateway IP address, and click Apply.

The default Gateway IP address is 192.168.254.65

The SVO-LC establishes connection with the NCS 1000 device.
Figure 4. Add Devices Gateway