Install Unified Console

Brief overview of UC installation

Management Console installation includes Unified Console by default. Unified Console requires no separate installation.

Overview of UC installation

This section explains how to install, set up, validate, connect to, begin using UC, and how to reinstall UC if required.

Set up and get started with UC

Complete the following tasks to ensure that UC is installed correctly and ready for use:

Expected Result

You can access Management Console, open Unified Console successfully, and begin managing your environment.

Reinstall Unified Console

Reinstall UC only if UC is unavailable, corrupted, or not functioning correctly after installation or upgrade. Preserve your existing UC configuration before reinstalling UC.

When to Reinstall UC

UC does not start after installation or upgrade.
UC files are corrupted or missing.
Troubleshooting steps do not resolve the issue.

Step 1: Back up the UC configuration

This step preserves your existing UC configuration so that you can restore it after reinstallation.

Run

cp -r /opt/vconsole/uc/config/dbconfigs /tmp/uc_backup

Expected result

The backup directory is created successfully and contains the UC configuration files.

Success: Configuration files are copied to /tmp/uc_backup.

Failure: The command returns a permission or file-not-found error.

Step 2: Reinstall MC

UC is installed as part of MC. Reinstall MC to reinstall UC. For information about installing MC, see Install MC.

Expected result

MC and UC are reinstalled successfully.

Success: Installation completes without errors.

Failure: Installation stops or reports errors.

Step 3: Restore the UC configuration

Restore the saved configuration after reinstallation completes.

Run:

cp -r /tmp/uc_backup/* /opt/vconsole/uc/config/dbconfigs/

Expected result

The previous UC configuration is restored.

Success: Configuration files are available in the UC configuration directory.

Failure: Restore command returns errors or configuration files are missing.