Ctrlk
For the complete documentation index, see llms.txt. This page is also available as Markdown.

Host Management Console

Use the Host Management Console on a Platform9 OS host to connect it to a Private Cloud Director Management Plane and review its local status.

Overview

Every Platform9 OS host ships with a local Host Management Console for host administration. You reach it at https://<host-ip>:9090 after first boot (see Option 2: Host Management Console), logging in with the host's root account. This page assumes you have already completed the install wizard and are logging in for the first time.

In this guide, you will learn about each page in the Host Management Console and use it to connect the host to a Private Cloud Director Management Plane.

Prerequisites

  • A Platform9 OS host that has completed installation and first boot.

  • The root password set during install.

  • For the connection step: a reachable Private Cloud Director Management Plane URL, a username and password, and the target region and tenant.

Available Pages

The Host Management Console presents the following pages. PCD Connection is the landing page after login; there is no separate overview or system-summary page.

  • PCD Connection: connect this host to a Private Cloud Director Management Plane. See Connect the Host to a Management Plane below.

  • Host Readiness: reports whether the host meets the prerequisites to run PCD workloads.

  • Storage: reviews the host's disks and storage configuration.

  • Networking: reviews and configures the host's network interfaces. See Networking Page below.

  • PCD Logs: reviews host agent and connection logs.

  • OS Hardening: reports the host's CIS compliance status. See Platform9 OS CIS Hardening.

  • Terminal: an in-browser shell session on the host.

Connect the Host to a Management Plane

On the PCD Connection page, fill in the connection form:

  • Management Plane URL

  • Username

  • Password

  • Region

  • Tenant

  • Proxy URL (optional)

Submitting the form runs pcdctl prep-node on the host. This installs the prerequisite OS packages, then the PCD host agent packages (pf9-hostagent and pf9-comms), while the page shows a live scrolling log of the process.

When the process finishes, the page reports Connected to PCD Management Plane and shows a services table listing Network, Hostagent, Comms, and Sidekick, each with its current status and controls to restart the service or view its logs.

Once connected, the host appears in the Management Plane's Infrastructure > Cluster Hosts list with status Online. Its role status shows Unauthorized until an operator assigns the host a role and cluster from the Management Plane.

Networking Page

The Networking page manages the host's network configuration (backed by nmcli):

  • Physical Interfaces: lists each interface's device name, MAC address, link speed, link state, LLDP neighbor (if available), and IP/CIDR, with a Configure action per interface.

  • Bonds: lists existing bonds, with Create bond to define a new bond in either 802.3ad/LACP mode or active-backup mode.

  • VLAN Interfaces: lists existing VLAN interfaces, with Create VLAN to define a new VLAN interface on a parent interface and VLAN ID.

  • Outbound Proxy: configures the proxy URL and a no-proxy bypass list used for outbound connections from the host.

Related Pages

PreviousPlatform9 OS
NextNetwork Boot (PXE)

Last updated

Was this helpful?