Orchestration Node Config

The central orchestration node in Mesh Hypervisor is configured primarily via /host0/ on its flash drive, with static defaults in /etc/pxen/host0.conf. This section details /host0/ structure and mentions tweakable options in host0.conf. For usage, see Configuring Nodes.

Primary Config: /host0/

/host0/ drives PXE booting, DHCP, package mirroring, and node setups. Changes require mesh system configure to rebuild APKOVLs, applied on node reboot.

Directory Structure

• /host0/machines/: Node-specific configs.
  • Subfolders (e.g., my-server, default) named arbitrarily.
  • Files:
    • UUID (Required): Node’s 8-char UUID (e.g., 10eff964) or default.
    • manifest (Required): File actions (see Manifest Syntax).
    • groups (Optional): List of group folders (e.g., baseline).
    • packages (Optional): Alpine packages (e.g., chrony).
    • SKIP (Optional): Empty; skips APKOVL build.
• /host0/groups/: Reusable configs for multiple nodes.
  • Subfolders (e.g., timezone-est).
  • Files:
    • manifest (Required): File actions.
    • packages (Optional): Alpine packages.
• /host0/network/: VXLAN configs.
  • Files (e.g., manage.conf): Network settings (see Network Config).
• /host0/packages: Top-level package list for the offline mirror (e.g., mdadm).

Example Configs

• Machine: /host0/machines/my-server/
  • UUID:

    10eff964
    

  • groups:

    baseline
    timezone-est
    

  • manifest:

    O MODE=root:root:0644 SRC=/host0/machines/my-server/hostname TGT=/etc/hostname
    

  • hostname:

    node1
    

• Group: /host0/groups/timezone-est/
  • manifest:

    L SRC=/usr/share/zoneinfo/EST TGT=/etc/localtime
    

• Top-Level: /host0/packages

  chrony
  bridge
  

Static Config: /etc/pxen/host0.conf

/etc/pxen/host0.conf sets static defaults for the central node—paths, DHCP, and networking. It’s rarely edited; comments in the file explain options. Key tweakable settings include:

• Subnet Pools: subnet_pool (e.g., "10.11.0.0/16" "192.168.0.0/23")—defines DHCP auto-assigned ranges.
• Default Subnet Size: default_subnet_size (e.g., "25")—sets subnet mask for new networks.
• Manual Subnets: manual_subnets (e.g., { {demo9} {10.0.43.0/25} })—assigns fixed subnets by interface or MAC.
• DHCP Retries: dhcp_retries (e.g., "5") and dhcp_retry_pause (e.g., "3")—tunes DHCP request attempts.
• DNS Settings: dns_servers (e.g., "1.1.1.1" "8.8.8.8") and host0_dns_hostname (e.g., "host0")—configures DNS behavior.

Edit with caution—defaults are optimized for most setups.

Notes

/host0/machines/default/ and /host0/machines/initramfs/ are special—see Configuring Nodes. Group manifests apply first, machine manifests override. Backup /host0/ before changes—see Upgrading the System. For node control, see Managing Nodes; for manifest details, see Manifest Syntax.

Next, explore Workload Config.