Cisco Connected Grid Device Manager Installation and User Guide, Release 3.1

Enabling Feature on Router

The following commands must be entered on the CGR 1000 to support communication between the Device Manager and the router when Work Authorization is in use:

Downloading Work Authorizations

To download the latest work orders from CG-NMS and upload new status of the work orders to CG-NMS, click Synchronize on the Work Authorization page.

Viewing Work Details

The Work Number in the Work Details section (right pane) corresponds to an existing work order within a Utility management or operations system that the technician can access to get additional details on the work order.

Generally, a technician synchronizes with the CG-NMS at the beginning of the day to download work orders before heading to the field and then again at the end of the day when back at the office to update CG-NMS with the changes.

To view work order details, do the following:

Step 1 On the Work Authorization page, click a work order (left pane).

Step 2 Using the Work Number that appears (left pane), locate the specific work details from the appropriate system and then do one of the following:

• When you complete the work order, select Complete from the Work Status drop-down menu.
• When you are not able to complete the work order, select Incomplete from the Work Status drop-down menu.

The work order (left pane) reflects the status change.

Step 3 When connected to CG-NMS, click Synchronize to update the CG-NMS.

After synchronization with the CG-NMS, all Completed, Incomplete, and Expired work orders are removed from the Device Manager display.

Updating Work Details

A work order has four possible states: New (N), Complete (C), Incomplete (I), or Expired (E).

To update the status of a work order, do the following:

Step 1 On the Work Authorization page, select the Work Status drop-down menu (right pane).

Step 2 Select the current state of the work order.

The Work Authorization page reflects the new state of the work order (left pane).

Step 3 To update the CG-NMS database with this change, click Synchronize.

Test Connectivity

The Test Connectivity task allows you to confirm connectivity to a device from the CGR 1000.

Tip Before you can check a device connection or route to a CGR 1000, you must add the IPv4 or IPv6 address of the device to the Device Manager.

This section covers the following topics:

• Add a Device IP Address
• Ping a Device IP Address
• Trace Route a Device IP Address
• Remove a Device IP Address

Add a Device IP Address

Follow these steps to add a device IP address:

Step 1 From the At a Glance page, click Test Connectivity.

The Test Connectivity page displays the defined sample devices and/or target addresses.

Step 2 Click Add to create a target IP address.

Step 3 In the Target Description field, enter a description for the device.

Step 4 In the Target IP Address field, enter the IP address (IPv4 or IPv6) of the device.

Step 5 Click OK.

You can now test the connectivity to the device you just added to the Device Manager.

Ping a Device IP Address

The Ping feature allows you to verify connectivity to a device by querying the target IP address.

Follow these steps to test connectivity between the CGR 1000 and the device:

Step 1 On the Test Connectivity page, click on a target IP address from the listing on the page (left pane).

Step 2 Click Ping Target.

The In Progress dialog box appears.

When the system successfully pings the device, the Target Reached dialog box appears.

If the system does not successfully ping a device, refer to Failed Ping.

Step 3 Click Details to view details or click Exit to close the window.

Failed Ping

Follow these steps if the ping of the target IP address is unsuccessful:

Step 1 In the Failed to Reach dialog box, click Details to view the reason the system could not reach the IP address.

Step 2 In the Target Error dialog box, click Exit after reviewing the reason for the error.

Proceed to Trace Route a Device IP Address.

Trace Route a Device IP Address

When an IP address cannot be reached using Ping, you can use the Trace Route feature to check the route taken to reach the device IP address.

Follow these steps to trace the route of the IP address:

Step 1 On the Test Connectivity page, select the device IP address from the list.

Step 2 Click Trace Route :

• If the trace route is successful, click Exit in the Trace Route dialog box.
• If the trace route is unsuccessful, proceed to Remove a Device IP Address.

Remove a Device IP Address

After you have tested a target IP address and verified its connectivity, you can remove the device entry from the Device Manager. You can also remove an IP address that the application identifies as incorrect during failed pings and trace route attempts.

Follow these steps to remove a target IP address:

Step 1 On the Test Connectivity page, select the target IP address from the list.

Step 2 Click Remove.

Manage Interfaces

You can bring up or shut down an interface on the Manage Interfaces page. You can also view details about a module’s activity and reload a module from the Manage Interfaces page.

• When an interface is up (appears as green), the line protocol is currently active. When an interface is down (appears as red), it means the line protocol is not active.
• When an interface is administratively down (appears as gray), the line interface was taken down by the administrator.

All interfaces installed within the CGR 1000 display automatically.

This section covers the following topics:

• Bring Up an Interface
• Shut Down an Interface
• View Details for an Interface
• Reload a Module

Bring Up an Interface

When an interface is shut down for any reason, you can attempt to bring up the interface by doing the following:

Step 1 From the At a Glance page, click Manage Interfaces.

Step 2 On the Manage Interfaces page, select an interface and then click Bring Up Interface.

The In Progress message appears. When the interface is up, the Interface Up dialog box appears.

Shut Down an Interface

Caution Do not shut down the interface on which the Device Manager communicates with the CGR 1000 or the connection will be lost.

---

Follow these steps to shut down an interface:

Step 1 From the At a Glance page, click Manage Interfaces.

Step 2 On the Manage Interfaces page, select an interface and then click Shut Down.

The In Progress message appears. When the process completes, the Interface Down dialog box appears.

View Details for an Interface

The View Details feature allows you to display information for the selected interface and related module, including interface status, model number, MAC and IP addresses, and dynamic statistics. The information is updated every 10 seconds.

Note In this release, details are available for the WiMAX module only.

Follow these steps to view details for a module:

Step 1 From the At a Glance page, click Manage Interfaces.

Step 2 On the Manage Interfaces page, select an interface and then click View Details.

The Module Activity page appears.

WiMAX Details

The following information is displayed for the WiMAX module:

• Slot in which module is inserted
• Model number
• MAC address
• IP address
• Physical layer state (indicates Connected, Disconnected, Scanning, or Authenticating)
• BSID (ID of the base station to which the WiMAX module is connected)
• Frequency of transmission of the WiMAX module
• Channel bandwidth (bandwidth supported by the WiMAX module)
• RSSI (Received Signal Strength Indication measured in dBm)
• CINR (Carrier to Interference Noise Ratio measured in dB. A higher value indicates better signal strength)
• Packets in (number of incoming packets)
• Packets out (number of outgoing packets)
• DL Bad CRC Packets (number of bad packets during download - ideally 0)
• Hardware version
• Board version

Reload a Module

Reloading a module shuts off power to the module then powers it on again.

Note In this release, the Reload Module feature is available for the WiMAX module only.

Follow these steps to reload a module:

Step 1 From the At a Glance page, click Manage Interfaces.

Step 2 On the Manage Interfaces page, select an interface and then click View Details.

The Module Activity page appears.

Step 3 Click Reload Module.

The message Reloading module... appears in the Updates area (bottom of left pane). When reloading is complete, the message Module reloaded successfully appears in the Updates area, and it takes 3-4 minutes for WiMAX module base station connectivity to be reestablished.

Change Configuration

The Change Configuration task allows you to upload a configuration file to the Device Manager and then use that file to update the configuration of the CGR 1000. The configuration file information must include version, username and password, Ethernet and WiFi interfaces, and Device Manager (CGDM) and IP HTTPS configurations.

Note The configuration file must be a complete and valid CGR 1000 configuration. When the configuration file contains missing fields, the Device Manager stops the file upload and warns that the configuration file is incomplete. When you receive an error while updating the configuration file, check the configuration file for missing information.

This section covers the following topics:

• Add a Configuration File
• Update Configuration
• Correct a Configuration File
• Remove Configuration File

Add a Configuration File

Follow these steps to add a configuration file to the Device Manager:

Step 1 From the At a Glance page, click Change Configuration.

Step 2 Click Add.

Step 3 In the Add Configuration dialog box:

a. Enter a file description for the configuration file that you are going to upload.

b. Click Browse to navigate to the configuration file location and select the file.

c. Click Save.

Update Configuration

After uploading the configuration file to Device Manager, you can use the file to update the CGR 1000 configuration.

Caution Updating the configuration causes the router to reboot. All connections to the router are lost during the update. After this task starts, there is no way to cancel the event. Be careful when using this feature.

---

Follow these steps to update the configuration file on the CGR 1000:

Step 1 On the Change Configuration page, select the desired configuration file (left pane).

Step 2 Click Update Configuration.

• If a confirmation dialog box appears, click Confirm to verify that you would like to change the router configuration.
• If an error message appears, the file did not upload to the CGR 1000.

Proceed to Correct a Configuration File.

Correct a Configuration File

A configuration file upload fails because the configuration file has missing fields such as version, username and password, Ethernet and WiFi interfaces, and Device Manager (CGDM) and IP HTTPS details.

To correct a configuration file error:

Step 1 Check the configuration file for errors. If errors or missing information exist, make corrections.

Step 2 Remove the current configuration file from the Device Manager. (See Remove Configuration File.)

Step 3 Add the updated configuration file to Device Manager. (See Add a Configuration File.)

Step 4 Update the configuration file. (See Update Configuration.)

Remove Configuration File

After you update the CGR 1000 with the new configuration file, you can remove the file from Device Manager. You can also use this function to remove unwanted or duplicate configuration files.

Follow these steps to remove a configuration file:

Step 1 On the Change Configuration page, select the configuration file you want to remove from the list.

Step 2 Click Remove.

Update Image

The CGR 1000 image bundle contains information that the router uses when starting up and operating. The information in the image contains information on FPGA, 3G, wireless drivers, and so on. The only acceptable file format for the Cisco CGR 1000 image file is a zip bundle, which contains a manifest file with information on versioning and files. Any missing files in the zip bundle cancels the update. You can find the official Cisco CGR 1000 zip bundle on Cisco.com.

This section covers the following topics:

• Upload Image
• Replace Image
• Remove Image

Upload Image

Before you can update an image on the CGR 1000, you must upload the image to the Device Manager.

The Upload Image option allows you to upload and store a copy of a software image on the CGR 1000 without initiating an immediate image install. This capability allows operations personnel to use CG-NMS or a Utility management tool to install and reboot the CGR 1000 when network conditions allow.

Follow these steps to upload a image:

Step 1 From the At a Glance page, click Update Image.

Step 2 On the Update Image page, select the CGR 1000 software image that you want to upload.

Note If the software image that you want to install on the CGR 1000 is not listed, click Add and browse to the image, and then click OK to upload the image.

Step 3 Click Upload Image.

The new image is stored on the CGR 1000 router until you are ready to replace the image on the router. (See Replace Image.)

Replace Image

Caution Be careful when using this feature. After this tasks starts, there is no way to cancel the event. Updating the CGR 1000 software image might take awhile to complete and requires a reboot. All connections to the router will be unavailable during the image update.

---

Follow these steps to replace an image:

Step 1 On the Update Image page, select an CGR 1000 image.

Step 2 Click Replace Image.

A confirmation dialog box appears.

Step 3 To begin the replace image process, click Confirm.

Step 4 After the router software update completes, the router restarts.

Remove Image

After you update an image, you can remove the image file from the Device Manager. You can also use the Remove image option to remove a image file you added mistakenly.

Follow these steps to remove an image:

Step 1 On the Update Image page, select an CGR 1000 image.

Step 2 Click the Remove button (bottom of page).

Retrieve Report

You can retrieve real-time reports of log events from the CGR 1000 and view them on the Retrieve Report page or save the information to a .txt file.

• You can specify that you want to retrieve and view all CGR 1000 log events (Retrieve All) or view a specified number of log events (200 or 1000)
• You can specify that you want to save a copy of the log events that display on the Retrieve Report page to your laptop (Save Report)

Retrieve and Save Reports

Follow these steps to retrieve real-time reports from the CGR 1000:

Step 1 From the At a Glance page, click Retrieve Report.

Step 2 On the Retrieve Report page, click the type of report that you want to view or save:

• Retrieve Last 200–Displays the last 200 log events of the CGR 1000.
• Retrieve Last 1000–Displays the last 1000 log events of the CGR 1000.
• Retrieve All–Displays all current log events of the CGR 1000.
• Save Report–Saves a copy of the retrieved log events (displayed on the page) to a default file, systemlog.txt. By default, the application saves this file in the Documents folder. However, you can specify the destination for the file. See SYSTEMLOG.TXT SAMPLE for example output.

Manage Modules

The Manage Modules page provides a wizard that guides you through the process of adding or removing 3G and WiMAX modules.

The Device Manager updates the configuration file and reloads the CGR 1000 after you add or remove a module.

The plus sign (+) indicates an available slot.

The minus sign (-) indicates an occupied slot.

This section covers the following topics:

• Add a Module
• Remove a Module

Tip • For details on opening the chassis door of the CGR 1240, please refer to the “Opening the Router Chassis” chapter in the Cisco 1240 Connected Grid Router Hardware Installation Guide at:
www.cisco.com/go/cgr1000-docs

• For details on installing a specific module, refer to the Installation and Configuration Guide for that module at: www.cisco.com/go/cgr1000-docs

Add a Module

Note You cannot run any other operations when adding the module.

To add a module, do the following:

Step 1 On the Manage Modules page, click on a plus (+) sign in the router diagram (left pane) to get started.

A blue outline appears around the slot in the router diagram to confirm selection, and a Please wait... message appears on the page. Do not install the module until this message disappears from the page.

Step 2 After the Please wait... message disappears, insert the module into the physical slot of the router.

Step 3 Click Finish.

The following message appears on the page to indicate an update to the configuration file is in process:

Inserting module into slot. This process will take several minutes. Please wait.

A green line appears around the slot within the router diagram when the module is active.

Step 4 After you successfully insert the module, click Refresh icon (lower-right corner).

A minus (-) sign appears in the slot where you added the module.

Remove a Module

Note Before starting the removal process, ensure that no traffic is active or destined for the module. You cannot run any other operations when removing a module.

To remove a module, do the following:

Step 1 On the Manage Modules page, click on a module slot within the Info area (right pane) that corresponds to the location of the module that you want to remove. Populated slots display a minus sign (-).

A blue outline appears around the slot in the router diagram to confirm selection, and a Warning message appears stating that you are about to remove a module.

Step 2 To continue the removal, click Confirm.

The following message appears on the page:

Preparing slot for removal. Please wait.

Caution Do not physically remove the module until a message prompts you to do so.

---

Step 3 When the Removing Module message appears, remove the module from the physical slot of the router.

Step 4 Click Finish.

The following message appears on the page to indicate an update to the configuration file is in process:

Removing module from slot. This process will take several minutes. Please wait.

Step 5 When the configuration update completes, a success message appears.

A plus (+) sign now appears in the slot where you physically removed the module indicating an empty slot.

Advanced Command

The Advanced Command task provides access to the CGR 1000 to fine-tune or troubleshoot the router. You must be familiar with Cisco CG-OS commands. For details on supported commands, refer to the CGR 1000 software configuration guides at: www.cisco.com/go/cgr1000-docs

Note Not all interactive commands are supported. Configuration commands must be concatenated together, as follows: configuration terminal ; interface ethernet2/1 ; shutdown ; end

Step 1 From the At a Glance page, click Advanced Command. In addition to the advance console, you have the following choices:

• Click System Time to display the current setting of the system clock for the router.
• Click Show Configuration to display the current configuration of the router.
• Click Save Configuration to save the current router configuration to startup-config file.
• Click File Directory to display the router file directory.
• Click Upload to upload a new image file to the router.
• Click Reboot to reboot the router.
• Click Save Output to save the output displayed on the page to a file, windowslog.txt.
  By default, the application saves the windowslog.txt file to the Documents folder.
  (See WINDOWSLOG.TXT SAMPLE.)

WINDOWSLOG.TXT SAMPLE

The following example represents typical content that might be found in the windowslog.txt file generated from the Advanced Command page.

SYSTEMLOG.TXT SAMPLE

The following example represents typical content that might be found in a systemlog.txt file generated from the Retrieve Reports page.