Skip to content

Installing Awanio Cockpit ​

This guide walks you through deploying Awanio Cockpit—the centralized management platform for your virtualization environment—using the Cockpit Installation Wizard.


1. Prerequisites & Checklist ​

Before starting the installation, ensure you have gathered the following credentials and network configurations:

Software & Access ​

  • Cockpit Installer Package: Downloaded from the Awanio Enterprise Portal.
  • PaperHost Hypervisor Access: IP address, target port, and administrator credentials for the host where Cockpit will be deployed.
  • Active Directory / Domain Admin Credentials: Username and password with administrative privileges for enterprise domain integration.

Network & Storage Requirements ​

  • Target Storage Pool: An existing storage pool on the target PaperHost with sufficient capacity to house the Cockpit VM instance.
  • Reserved IP Addresses: Ensure three distinct, static IP addresses are allocated on your management network:
IP Address TypeDescription & Purpose
VM Instance IPStatic IP directly assigned to the local Cockpit Virtual Machine.
Floating IPVirtual IP assigned dynamically to the active/primary Cockpit node.
Internal HA IPDedicated IP used for internal node-to-node communication in High Availability (HA) clusters.

2. Step-by-Step Installation ​

Step 1: Launch the Installer ​

  1. Run the Cockpit Installer package downloaded from the Enterprise Portal.
  2. Follow the on-screen installation wizard setup.

Step 2: Configure Target PaperHost ​

  1. Enter the Host Connection Information (IP address, Port, Username, and Password).
  2. Select the target Storage Pool on the PaperHost where the Cockpit Virtual Machine will be stored.

Step 3: Configure Administrative & Domain Credentials ​

  1. Management Admin Account: Set the primary username and password for the Cockpit Management UI.

    Note: The management password configured here is also used to authenticate SSH access to the underlying Cockpit VM.

  2. Domain Integration: Enter the Domain Admin User and Password required to join Cockpit to your enterprise directory.

Step 4: Configure Network Settings ​

Enter the three pre-allocated IP addresses into the network configuration step:

  • VM Instance IP
  • Floating IP
  • Internal HA IP

Step 5: Review & Deploy ​

  1. Review all parameters on the Preview summary screen.
  2. Verify that network IPs, credentials, and target storage locations are correct.
  3. Click Deploy to begin the automated setup.

3. Launch & Verification ​

  1. Once the deployment process completes successfully, click Launch Cockpit.
  2. Open your web browser and navigate to the assigned Floating IP address:
    text
    https://<FLOATING_IP>:<PORT>