📦
CHI-in-a-box
  • What is CHI-in-a-Box?
  • Before You Begin
    • Assumed Knowledge
    • Hosts and Services
    • Network Overview
    • CC-Ansible
    • The site configuration
      • inventory
      • defaults.yml
      • passwords.yml
      • certificates/
      • node_custom_config/ (optional)
      • post-deploy.yml (optional)
    • How Deployment Works
    • Security considerations
  • Setup Guides
    • Evaluation Site
      • Bring up the Control Plane
    • Production Baremetal
      • Baremetal QuickStart
      • Host Networking Configuration
    • Troubleshooting
      • Networking
    • Verification Checklist
    • Dev-in-a-Box
    • Edge-in-a-Box
  • Reference
    • Chameleon Identity Federation
    • Ironic Flat Networking
    • Ironic Multi-Tenant Networking
    • Glance Image Storage
    • Resource Reservation
      • Default Resource Properties
    • Monitoring
      • IPMI Metrics
      • SNMP Metrics
  • Example Deployments
    • ARM/x86 mixed architecture
    • Edge computing/container testbed
  • Operations
    • Hardware management
    • Certificate management
    • Chameleon tools
      • Hammers 🔨
        • maintenance_reservation
      • Disk image subscription
      • Usage reporting
    • Troubleshooting
      • Known issues
        • Neutron (networking)
        • Nova (KVM)
        • Ironic (bare metal)
      • Instance networking diagnostics
      • Security incident triage
      • Troublesome Hardware
    • Alert runbooks
      • Cron Job No Recent Success
      • Instance Failure
      • Image Cache Space
      • Ironic Node Error State
      • Jupyter Server Launch Failure
      • MySQL Host Down
      • MySQL Replication Error
      • Node Exporter Down
      • Node Network Bridge Down
      • Node Network Bridge Low Traffic
      • Nova Ironic Instance Launch Failure
      • OpenStack API Down
      • PeriodicTask No Recent Success
      • Portal Down
      • Precis Parsed Events Low
      • Provider Conflict
      • Runbook Template
    • User support guide
    • Upgrading to a new Release
  • Development
    • Developing OpenStack Services
    • Dev-in-a-box
Powered by GitBook
On this page
Edit on GitHub
  1. Before You Begin

Assumed Knowledge

PreviousWhat is CHI-in-a-Box?NextHosts and Services

Last updated 2 years ago

Deploying and Operating a CHI-in-a-Box site will be challenging without familiarity with the following concepts.

Linux systems

In particular, using a shell, privilege escalation, user and group management, linux networking, and mounts and filesystems. Specific linux networking knowledge includes network namespaces and virtual ethernet devices (veths)

Basic network administration

You'll need to know about vlans, and how to log into a switch using SSH and use its commandline for configuration, in particular configuring vlan trunks and access ports. While the concepts are fairly universal, the specifics will depend on the manufacturer and model for your switches.

Ansible

CHI-in-a-box leverages the Ansible and Kolla-Ansible projects, so basic familiarity will be very helpful. In particular, what an Ansible "Inventory" is, how to use host and group variables, and how to invoke a playbook and read the output.

Docker

Only basic knowledge is needed, as all CHI-in-a-Box services are deployed in Docker containers. On occasion, inspecting the environment inside a container or volume can be helpful for debugging purposes. See for more detail.

OpenStack

This is a deep well, and where we've placed the most effort in abstracting the most complex parts.

You will need to install and use the OpenStack CLI tools, and broadly know which services to look at when things go wrong, e.g. reading the logs, listing user instances or networks, and so on.

For issues, or available options for a particular service, e.g. Identity, Image storage, or Networking, see OpenStack's documentation for each service.

CHI-in-a-Box leverages Kolla-Ansible to generate configurations for each enabled OpenStack service, and then to deploy said services. In the case of issues or failures during deployment itself, .

Ansible Inventory Basics
Host and Group Variables
Ansible CLI Reference
Using Ansible Playbooks
Docker's getting started guide
you may find their deployment guide a helpful reference
Installation guides, per-service
Configuration and Administration Guides, per-service