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>