Troubleshoot the Deployment

Troubleshooting Tasks

When troubleshooting issues with the appliance's configuration, you will normally perform the following tasks:

  1. If you are currently using the Cisco DNA Center GUI: Log Out.

  2. To reconfigure the appliance's hardware, log in to and use the Cisco IMC GUI, as explained in Steps 12 and 13 of Enable Browser Access to Cisco Integrated Management Controller.

  3. To change the appliance configuration, launch and use the Maglev Configuration wizard, as explained in Reconfigure the Appliance Using the Configuration Wizard.

  4. Power-cycle the appliance so that your changes are active: Power-Cycle the Appliance.

For more information about the appliance's network adapters, see the Managing Adapters section of the Cisco UCS C-Series Servers Integrated Management Controller CLI Configuration Guide, Release 3.1. As noted elsewhere, never attempt to manage the appliance hardware through the Linux CLI. Use only the Cisco IMC GUI or the Maglev Configuration wizard to change appliance settings.

Log Out

Follow the steps below to log out of the Cisco DNA Center GUI.

For security reasons, we recommend that you log out after you complete a work session. If you do not log out yourself, you will be logged out automatically after 30 minutes of inactivity.

Procedure

Step 1

Click the Menu icon ().
Step 2

Click Sign out.

This ends your session and logs you out.

Reconfigure the Appliance Using the Configuration Wizard

To reconfigure an appliance, you must use the Configuration wizard to update the appliance settings. You cannot use the Linux CLI to do this. The normal Linux administration procedures that you might use to update configuration settings on a standard Linux server will not work and should not be attempted.

After the appliance is configured, you cannot use the Configuration wizard to change all of the appliance settings. Changes are restricted to the following settings only:

  • Host IP address of the appliance

  • DNS server IP addresses

  • Default gateway IP address

  • NTP server IP addresses

  • Cluster Virtual IP address

  • Static routes

  • Proxy server IP address

  • Maglev user password

  • Admin user password

Before you begin

You will need the following:

  • Secure Shell (SSH) client software.

  • The IP address that you configured for the Enterprise port on the appliance that needs reconfiguration. To identify this port, see the rear-panel figure in Front and Rear Panels. Log into the appliance at this address, on port 2222.

  • The Linux user name (maglev ) and password that are currently configured on the target appliance.

Procedure

Step 1

Using a Secure Shell (SSH) client, log in to the IP address of the Enterprise port of the appliance that needs to be reconfigured, on port 2222:

ssh maglev@Enterprise-port's-IP-address -p 2222

Step 2

When prompted, enter the Linux password.

Step 3

Enter the following command to access the Configuration wizard.

sudo maglev-config update

If you are prompted for the Linux password, enter it again.
Step 4

The Configuration wizard presents an abbreviated version of the same series of screens shown in, for example, Configure Add-On Nodes. Make changes to the settings presented, if required. After you finish making changes on each screen, choose [Next], as needed, to proceed through the Configuration wizard.

Step 5

At the end of the configuration process, a message appears, stating that the Configuration wizard is now ready to apply your changes. The following options are available:

  • [back]: Review and verify your changes.

  • [cancel]: Discard your changes and exit the Configuration wizard.

  • [proceed]: Save your changes and begin applying them.

Choose proceed>> to complete the installation. The Configuration wizard applies the changes you made.

At the end of the configuration process, a CONFIGURATION SUCCEEDED! message appears.

What to do next

Ensure your changes are applied and active by power-cycling the appliance. See Power-Cycle the Appliance.


Note

If you have updated the DNS Server IP addresses, we recommend that you perform a cold boot when power-cycling the appliance. This ensures that your DNS changes are applied.

Power-Cycle the Appliance

Complete the following procedure on your Cisco DNA Center appliance to either halt it or perform a warm restart. You can halt the appliance before you make hardware repairs, or you can initiate a warm restart after you have corrected software issues. Any hardware changes you make using Cisco IMC will be applied after the appliance reboots.

Note that it is also possible to power-cycle an appliance from the Cisco IMC GUI and the KVM console that is accessible from the Cisco IMC GUI. For details, see Steps 1 through 3 in either Configure the Primary Node or Configure Add-On Nodes.


Caution

Power-cycling your appliance from the Cisco IMC GUI can result in the corruption or loss of data. Only do so if your appliance is completely unresponsive to SSH, the Cisco IMC console, or the physical console.

Before you begin

You will need the following:

  • Secure Shell (SSH) client software.

  • The IP address that you configured for the 10-Gbps Enterprise port on the appliance that needs reconfiguration. To identify this port, see the rear-panel figure in Front and Rear Panels. Log in to the appliance at this address, on port 2222.

  • The Linux user name (maglev ) and the password that is currently configured on the target appliance.

Procedure

Step 1

Using a Secure Shell (SSH) client, log in to the IP address of the Enterprise port of the appliance that needs to be reconfigured, on port 2222:

ssh maglev@Enterprise-port's-IP-address -p 2222

Step 2

When prompted, enter the Linux password.

Step 3

Enter the command that is appropriate for the task you want to perform:

  • To halt the appliance, enter: sudo shutdown -h now

  • To initiate a warm restart, enter: sudo shutdown -r now

    If you are prompted for the Linux password, enter it again.
Step 4

Review the command output that is displayed as the host shuts down.
Step 5

If you halted your appliance, power up the Maglev root process by turning the appliance back on, using the front-panel power button.