# CHI-in-a-box ## CHI-in-a-box - [What is CHI-in-a-Box?](https://chameleoncloud.gitbook.io/chi-in-a-box/readme.md) - [Assumed Knowledge](https://chameleoncloud.gitbook.io/chi-in-a-box/before-you-begin/upstream-docs.md) - [Hosts and Services](https://chameleoncloud.gitbook.io/chi-in-a-box/before-you-begin/hosts-and-services.md) - [Network Overview](https://chameleoncloud.gitbook.io/chi-in-a-box/before-you-begin/openstack-architecture.md): Where all the moving parts are - [CC-Ansible](https://chameleoncloud.gitbook.io/chi-in-a-box/before-you-begin/command-line-interface.md) - [The site configuration](https://chameleoncloud.gitbook.io/chi-in-a-box/before-you-begin/the-site-configuration.md) - [inventory](https://chameleoncloud.gitbook.io/chi-in-a-box/before-you-begin/the-site-configuration/inventory.md) - [defaults.yml](https://chameleoncloud.gitbook.io/chi-in-a-box/before-you-begin/the-site-configuration/defaults.yml.md) - [passwords.yml](https://chameleoncloud.gitbook.io/chi-in-a-box/before-you-begin/the-site-configuration/passwords.yml.md) - [certificates/](https://chameleoncloud.gitbook.io/chi-in-a-box/before-you-begin/the-site-configuration/certificates.md) - [node\_custom\_config/ (optional)](https://chameleoncloud.gitbook.io/chi-in-a-box/before-you-begin/the-site-configuration/node_custom_config.md) - [post-deploy.yml (optional)](https://chameleoncloud.gitbook.io/chi-in-a-box/before-you-begin/the-site-configuration/post-deploy.yml.md) - [How Deployment Works](https://chameleoncloud.gitbook.io/chi-in-a-box/before-you-begin/how-deployment-works.md) - [Security considerations](https://chameleoncloud.gitbook.io/chi-in-a-box/before-you-begin/security-considerations.md) - [Evaluation Site](https://chameleoncloud.gitbook.io/chi-in-a-box/setup-guides/evaluation-site.md): Bringing up a minimal site to kick the tires - [Bring up the Control Plane](https://chameleoncloud.gitbook.io/chi-in-a-box/setup-guides/evaluation-site/bring-up-the-control-plane.md): Bringing up only the control plane - [Production Baremetal](https://chameleoncloud.gitbook.io/chi-in-a-box/setup-guides/production-baremetal.md) - [Baremetal QuickStart](https://chameleoncloud.gitbook.io/chi-in-a-box/setup-guides/production-baremetal/quickstart.md) - [Host Networking Configuration](https://chameleoncloud.gitbook.io/chi-in-a-box/setup-guides/production-baremetal/hostnetworking.md) - [Troubleshooting](https://chameleoncloud.gitbook.io/chi-in-a-box/setup-guides/troubleshooting.md) - [Networking](https://chameleoncloud.gitbook.io/chi-in-a-box/setup-guides/troubleshooting/networking.md) - [Verification Checklist](https://chameleoncloud.gitbook.io/chi-in-a-box/setup-guides/verification-checklist.md): A list of operations you can test to ensure your site is in working order. - [Dev-in-a-Box](https://chameleoncloud.gitbook.io/chi-in-a-box/setup-guides/dev-in-a-box.md): Minimal evaluation site with no compute services - [Edge-in-a-Box](https://chameleoncloud.gitbook.io/chi-in-a-box/setup-guides/edge-in-a-box.md): Guide to setting up an edge device testbed site such as CHI@Edge - [Chameleon Identity Federation](https://chameleoncloud.gitbook.io/chi-in-a-box/reference/chameleon-identity-federation.md) - [Ironic Flat Networking](https://chameleoncloud.gitbook.io/chi-in-a-box/reference/ironic-flat-networking.md) - [Ironic Multi-Tenant Networking](https://chameleoncloud.gitbook.io/chi-in-a-box/reference/multi-tenant-networking.md) - [Glance Image Storage](https://chameleoncloud.gitbook.io/chi-in-a-box/reference/glance-image-storage.md) - [Resource Reservation](https://chameleoncloud.gitbook.io/chi-in-a-box/reference/resource-reservation.md) - [Default Resource Properties](https://chameleoncloud.gitbook.io/chi-in-a-box/reference/resource-reservation/default-resource-properties.md) - [Monitoring](https://chameleoncloud.gitbook.io/chi-in-a-box/reference/monitoring.md) - [IPMI Metrics](https://chameleoncloud.gitbook.io/chi-in-a-box/reference/monitoring/ipmi-metrics.md) - [SNMP Metrics](https://chameleoncloud.gitbook.io/chi-in-a-box/reference/monitoring/snmp-metrics.md) - [ARM/x86 mixed architecture](https://chameleoncloud.gitbook.io/chi-in-a-box/example-deployments/arm-and-x86-mixed-architecture.md) - [Edge computing/container testbed](https://chameleoncloud.gitbook.io/chi-in-a-box/example-deployments/edge-computing-container-testbed.md) - [Hardware management](https://chameleoncloud.gitbook.io/chi-in-a-box/operations/hardware-management.md) - [Certificate management](https://chameleoncloud.gitbook.io/chi-in-a-box/operations/certificate-management.md) - [Chameleon tools](https://chameleoncloud.gitbook.io/chi-in-a-box/operations/chameleon-tools.md) - [Hammers 🔨](https://chameleoncloud.gitbook.io/chi-in-a-box/operations/chameleon-tools/hammers.md): Percussive maintenance - [maintenance\_reservation](https://chameleoncloud.gitbook.io/chi-in-a-box/operations/chameleon-tools/hammers/maintenance_reservation.md) - [Disk image subscription](https://chameleoncloud.gitbook.io/chi-in-a-box/operations/chameleon-tools/image-tools.md) - [Usage reporting](https://chameleoncloud.gitbook.io/chi-in-a-box/operations/chameleon-tools/usage-reporting.md) - [Troubleshooting](https://chameleoncloud.gitbook.io/chi-in-a-box/operations/troubleshooting.md) - [Known issues](https://chameleoncloud.gitbook.io/chi-in-a-box/operations/troubleshooting/known-issues.md) - [Neutron (networking)](https://chameleoncloud.gitbook.io/chi-in-a-box/operations/troubleshooting/known-issues/neutron-networking.md) - [Nova (KVM)](https://chameleoncloud.gitbook.io/chi-in-a-box/operations/troubleshooting/known-issues/nova-kvm.md) - [Ironic (bare metal)](https://chameleoncloud.gitbook.io/chi-in-a-box/operations/troubleshooting/known-issues/ironic-bare-metal.md) - [Instance networking diagnostics](https://chameleoncloud.gitbook.io/chi-in-a-box/operations/troubleshooting/instance-networking-diagnostics.md) - [Security incident triage](https://chameleoncloud.gitbook.io/chi-in-a-box/operations/troubleshooting/security-incident-triage.md) - [Troublesome Hardware](https://chameleoncloud.gitbook.io/chi-in-a-box/operations/troubleshooting/troublesome-hardware.md): An exciting menu of footguns - [Alert runbooks](https://chameleoncloud.gitbook.io/chi-in-a-box/operations/runbooks.md) - [Cron Job No Recent Success](https://chameleoncloud.gitbook.io/chi-in-a-box/operations/runbooks/cronjobnorecentsuccess.md) - [Instance Failure](https://chameleoncloud.gitbook.io/chi-in-a-box/operations/runbooks/instance-failure.md) - [Image Cache Space](https://chameleoncloud.gitbook.io/chi-in-a-box/operations/runbooks/ironiclowimagecachespace.md) - [Ironic Node Error State](https://chameleoncloud.gitbook.io/chi-in-a-box/operations/runbooks/ironicnodeinerrorstate.md) - [Jupyter Server Launch Failure](https://chameleoncloud.gitbook.io/chi-in-a-box/operations/runbooks/jupyterserverlaunchfailure.md) - [MySQL Host Down](https://chameleoncloud.gitbook.io/chi-in-a-box/operations/runbooks/mysqlhostdown.md) - [MySQL Replication Error](https://chameleoncloud.gitbook.io/chi-in-a-box/operations/runbooks/mysqlreplicationerror.md) - [Node Exporter Down](https://chameleoncloud.gitbook.io/chi-in-a-box/operations/runbooks/nodeexporterdown.md) - [Node Network Bridge Down](https://chameleoncloud.gitbook.io/chi-in-a-box/operations/runbooks/nodenetworkbridgedown.md) - [Node Network Bridge Low Traffic](https://chameleoncloud.gitbook.io/chi-in-a-box/operations/runbooks/nodenetworkbridgelowtraffic.md) - [Nova Ironic Instance Launch Failure](https://chameleoncloud.gitbook.io/chi-in-a-box/operations/runbooks/novaironicinstancelaunchfailure.md) - [OpenStack API Down](https://chameleoncloud.gitbook.io/chi-in-a-box/operations/runbooks/openstackapidown.md) - [PeriodicTask No Recent Success](https://chameleoncloud.gitbook.io/chi-in-a-box/operations/runbooks/periodictasknorecentsuccess.md) - [Portal Down](https://chameleoncloud.gitbook.io/chi-in-a-box/operations/runbooks/portaldown.md) - [Precis Parsed Events Low](https://chameleoncloud.gitbook.io/chi-in-a-box/operations/runbooks/precisparsedeventslow.md) - [Provider Conflict](https://chameleoncloud.gitbook.io/chi-in-a-box/operations/runbooks/provider-conflict.md) - [Runbook Template](https://chameleoncloud.gitbook.io/chi-in-a-box/operations/runbooks/template.md) - [User support guide](https://chameleoncloud.gitbook.io/chi-in-a-box/operations/user-support-guide.md) - [Upgrading to a new Release](https://chameleoncloud.gitbook.io/chi-in-a-box/operations/upgrading-to-a-new-release.md) - [Developing OpenStack Services](https://chameleoncloud.gitbook.io/chi-in-a-box/development/developing-openstack-services.md) - [Dev-in-a-box](https://chameleoncloud.gitbook.io/chi-in-a-box/development/dev-in-a-box.md) --- # Agent Instructions This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com. ## Querying This Documentation If you need additional information, you can query the documentation dynamically by asking a question. Perform an HTTP GET request on a page URL with the `ask` query parameter: ``` GET https://chameleoncloud.gitbook.io/chi-in-a-box/readme.md?ask= ``` The question should be specific, self-contained, and written in natural language. The response will contain a direct answer to the question and relevant excerpts and sources from the documentation. Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.