Troubleshoot the Deployment

Troubleshooting tasks

When troubleshooting issues with the appliance configuration, follow these steps:

  1. If you are currently using the Catalyst Center GUI,Log out.

  2. To reconfigure the appliance hardware, log in to the CIMC GUI, as explained in Steps 12 and 13 of Enable browser access to the 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.

For more information about the appliance 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 CIMC GUI or the Maglev Configuration wizard to change appliance settings.

Log out

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.

To log out of the Catalyst Center GUI, from the top-right corner, click your displayed username and select Log Out.

This ends your session and logs you out.

Reconfigure the appliance using the Configuration wizard

To reconfigure an appliance and update its settings, you must use the Configuration wizard. 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 configuring the appliance, use the Configuration wizard only to change this limited set of appliance setting:

  • Host IP address of the appliance

  • DNS server IP addresses

  • Default gateway IP address

  • NTP server IP addresses

  • Cluster Virtual IP address

  • Cluster hostname (FQDN)

  • Static routes

  • Proxy server IP address

  • Maglev user password

  • Admin user password

  • NIC bonding enablement

Before you begin

You need the Linux username (maglev ) and password that are currently configured on the target appliance.

Procedure

Step 1

Point your browser to the Cisco IMC IP address set during the Cisco IMC GUI configuration and log in to the Cisco IMC GUI as the Cisco IMC user (see Enable browser access to the Cisco Integrated Management Controller).

After you log in, the appliance shows the Cisco Integrated Management Controller Chassis Summary window.

Step 2

In the hyperlinked menu at the top of the window, select Launch KVM and then select HTML based KVM.

The KVM console opens in a separate window or tab automatically. Use it to monitor the progress of the configuration and respond to the Maglev Configuration wizard prompts.

Step 3

When prompted, enter the Linux password.

Step 4

Enter this command to access the Configuration wizard.

sudo maglev-config update

In Catalyst Center 2.3.7.7 onwards:

  • Change the maglev user password by specifying a new one in the Linux Password and Re-enter Linux Password fields. Ensure that this password complies with the requirements described in Password requirements. Leave these fields blank to continue using the current password.

  • You can make the other configuration setting changes without entering the maglev user password.

Step 5

The Configuration wizard provides an abbreviated version of the series of screens shown in, for example, Configure a secondary node using the Maglev wizard. Make changes to the settings provided, if required. After you finish making changes on each screen, select [Next], as needed, to continue through the Configuration wizard.

Step 6

At the end of the configuration process, a message appears, stating that the Configuration wizard is now ready to apply your changes. These 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.

Select proceed>> to complete the installation. The Configuration wizard applies your changes.

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

Power cycle the appliance

Complete one of these procedures on your Catalyst Center appliance to either stop it or start a warm restart. You can stop the appliance before you make hardware repairs, or you can initiate a warm restart after you have corrected software issues.

Using the Cisco IMC GUI

To halt your appliance or do a warm restart using the Cisco IMC GUI, complete these steps.

Before you begin


Note

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

  • Any hardware changes you make using the Cisco IMC GUI apply after the appliance reboots.

Caution

To prevent data loss, only power-cycle your appliance from the Cisco IMC GUI when it is unresponsive to SSH, the Cisco IMC console, or the physical console.

Procedure

Step 1

Point your browser to the Cisco IMC IP address you set during the Cisco IMC GUI configuration, and log in to the Cisco IMC GUI as the Cisco IMC user. (see Enable browser access to the Cisco Integrated Management Controller).

After you log in, the appliance shows the Cisco Integrated Management Controller Chassis Summary window with a hyperlinked menu at the top of the window.

Step 2

Reboot the appliance by choosing Host Power > Power Cycle.

If prompted to confirm rebooting the appliance, click OK.

Step 3

When prompted, enter the Linux password.

Using SSH

To use SSH for halting your appliance or doing a warm restart, complete these steps:

Before you begin

The prerequisites for this procedure include:

  • Secure Shell (SSH) client software.

  • The IP address that you configured for the 10 Gbps Enterprise port on the appliance that needs reconfiguration. Log in to the appliance at this address on port 2222.

    You can identify the Enterprise port by looking at the rear-panel figures in Front and Rear Panels.

  • 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:

  • 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 appears 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.