Skip to main content
Version: v1.7

Operator Reference

This is the reference sheet for Phoenix, an end-to-end solution to operate private, multi-tenant AI factories. Operators will find below an overview of the materials, infrastructure, and other requirements, and an entry point to the procedure to provision and configure the system.

Please contact support@midokura.com for more information.

System requirements​

Note: documentation files referenced here are provided in a downloadable artefact included in the environment setup section.

  • Before proceeding, operators are expected to ensure that the underlying infrastructure meets the system requirements listed below.
  • Operating system requirements for the OpenStack control nodes are available in OS_REQUIREMENTS
  • Operators are expected to set up their hardware according to our official Blueprint, specifically with regard to network configuration, port and interface assignment.
    • Base Operating System for OSt controllers should be ubuntu-24.04
  • Storage. Operators are expected to provide a Ceph cluster, integrated in the infrastructure as defined in the blueprint. See more details in the Environment setup
  • Set up a new Google Application that will be used as an SSO provider for the IaaS service. To follow this process, consult the GOOGLE_SSO_SETUP.
  • Set up credentials for the private registry at ghcr.io/midokura. We will provide you with this token via secure means, and it will be required during the control plane installation process. More info at GHCR_AUTHENTICATION.

Overview​

The sections below provide references to materials required to proceed with the provisioning process, which takes place from the Bastion node shown in the blueprint. On a high level, the process is based on a bundle of Ansible playbooks that will install and configure all components in the control plane.

Environment setup​

To install the Phoenix cluster, the Operator will work from the bastion node reflected in the blueprint. The materials below must be available in the node before proceeding with the installation.

  1. Create a new directory ./phoenix. This will serve to store artefacts and playbooks. All commands and paths in this document are relative to this directory.
  2. Download and extract the Documentation bundle. We will refer to documentation files from different sections of this document.

Control plane installation​

  • Prepare the Ceph cluster by following the steps explained in CEPH_SETUP
  • Download and extract Ansible playbooks
  • Use the included inventory.example.yml as the base to input the configuration specific to your cluster
  • Execute them following the instructions in DEPLOYMENT
  • To configure switches, follow the instructions in NETWORK_CONTROL_NODE_SETUP starting step 4

IaaS Console - Tenant and User configuration​

To create additional admin users, register tenants and tenant users, please refer to the instructions in IAAS_CONSOLE_CONFIGURATION.