Troubleshooting

This section contains the following topics:

Troubleshooting

You can troubleshoot a Cisco Crosswork Data Gateway instance directly from the VM. Cisco Crosswork Data Gateway provides logs of errors, requests to the server, and changes made to the VM and reports any process failures/outages.

To access Troubleshooting menu, select 5 Troubleshooting from the Main Menu and click OK, as shown in the following figure:



Cisco Crosswork Data Gateway opens the Troubleshooting menu that provides you the following options to troubleshoot your Cisco Crosswork Data Gateway instance:


Note

The following figure shows the Troubleshooting Menu corresponding to dg-admin user. Few of these options are not available to dg-oper user. See Table Table 1.



This section contains the following topics:

Ping a Host

To aid troubleshooting, Cisco Crosswork Data Gateway provides you Ping utility that can be used to check reachability to any IP address.

Procedure

Step 1

From Troubleshooting menu, select 1 Ping a Host and click OK.

Step 2

Enter the ping destination.
Step 3

Click OK.

Cisco Crosswork Data Gateway displays the result of the ping operation.



Traceroute to a Host

Cisco Crosswork Data Gateway provides Traceroute to a Host option to help troubleshoot latency issues. Using this option provides you a rough time estimate for the Cisco Crosswork Data Gateway to reach the controller application.

Procedure

Step 1

From Troubleshooting menu, select 2 Traceroute to a Host and click OK.

Step 2

Enter the traceroute destination.
Step 3

Click OK.

Check NTP Status

Use this option to check the status of the NTP server.

Procedure

Step 1

From Troubleshooting menu, select 3 NTP Status.

Step 2

Click OK. The Cisco Crosswork Data Gateway displays the NTP server status.



Check System Uptime

Use this option to check system uptime.

Procedure

Step 1

From Troubleshooting menu, select 4 System Uptime.

Step 2

Click OK. The Crosswork Data Gateway displays the system uptime.



Run show-tech

Cisco Crosswork Data Gateway provides the option show_tech to export its log files to a user-defined SCP destination.

The collected data includes the following:

  • Logs of all the Data Gateway components running on docker containers

  • VM Vitals

It creates a tarball in the directory where it is executed. The output is a tarball named CDG-<CDG-version>-year-month-day--hour-minute-second-*.tar.bz2

The execution of this command may take several minutes depending on the state of Crosswork Data Gateway.

Procedure

Step 1

From Troubleshooting menu, select 5 Show-tech and click OK.

Step 2

Enter the destination to save the tarball containing logs and vitals.
Step 3

Enter your SCP passphrase and click OK.

Reboot Cisco Crosswork Data Gateway VM


Note

  • You can also reboot Cisco Crosswork Data Gateway from Crosswork Cloud.

  • This task can only be performed by dg-admin user.

Cisco Crosswork Data Gateway gives you two options to reboot the VM:



  • Remove All Collectors and Reboot VM: Select this option from the Troubleshooting menu if you want to remove all the collectors (functional images) and reboot VM.

  • Reboot VM: Select this option from the Troubleshooting menu for a normal reboot.