### Start and Enable Libvirtd Service on CentOS Source: https://github.com/openstack/kolla-ansible/blob/master/doc/source/contributor/vagrant-dev-env.md Starts the libvirtd service and enables it to start on boot for CentOS systems. ```bash sudo systemctl start libvirtd sudo systemctl enable libvirtd ``` -------------------------------- ### Install Diskimage-Builder Source: https://github.com/openstack/kolla-ansible/blob/master/doc/source/reference/networking/octavia.md Install `diskimage-builder` within a virtual environment for creating the Amphora image. Activate the virtual environment before installation. ```bash python3 -m venv dib-venv source dib-venv/bin/activate pip install diskimage-builder ``` -------------------------------- ### Install Python Tacker Client Source: https://github.com/openstack/kolla-ansible/blob/master/doc/source/reference/orchestration-and-nfv/tacker-guide.md Install the python-tackerclient using pip to interact with the Tacker service from your client. ```bash $ pip install python-tackerclient ``` -------------------------------- ### Install tox Source: https://github.com/openstack/kolla-ansible/blob/master/doc/source/contributor/running-tests.md Install the tox tool using pip. This is a prerequisite for running the test suite. ```console pip install tox ``` -------------------------------- ### Bootstrap and Install Bifrost Services Source: https://github.com/openstack/kolla-ansible/blob/master/doc/source/reference/deployment-and-bootstrapping/bifrost.md Installs and bootstraps Bifrost services using Ansible playbooks. This command configures RabbitMQ, sets the OS_CLOUD environment variable, and runs the main installation playbook with specific configurations. ```console cd /bifrost ./scripts/env-setup.sh export OS_CLOUD=bifrost cat > /etc/rabbitmq/rabbitmq-env.conf << EOF HOME=/var/lib/rabbitmq EOF ansible-playbook -vvvv \ -i /bifrost/playbooks/inventory/target \ /bifrost/playbooks/install.yaml \ -e @/etc/bifrost/bifrost.yml \ -e @/etc/bifrost/dib.yml \ -e skip_package_install=true ``` -------------------------------- ### Example HNAS Route Configuration Source: https://github.com/openstack/kolla-ansible/blob/master/doc/source/reference/storage/manila-hnas-guide.md Example of adding a route in HNAS for a specific EVS to a tenant network. ```bash $ console-context --evs 3 route-net-add --gateway 192.168.1.1 \ 10.0.0.0/24 ``` -------------------------------- ### Install Dependencies for Amphora Image Build (Ubuntu) Source: https://github.com/openstack/kolla-ansible/blob/master/doc/source/reference/networking/octavia.md Install necessary packages on Ubuntu for building the Octavia Amphora image. ```bash sudo apt -y install debootstrap qemu-utils git kpartx ``` -------------------------------- ### Start Default All-in-One Vagrant Environment Source: https://github.com/openstack/kolla-ansible/blob/master/doc/source/contributor/vagrant-dev-env.md Navigates to the Vagrant configuration directory and starts the default all-in-one CentOS 7-based development environment. ```bash cd kolla-ansible/contrib/dev/vagrant && vagrant up ``` -------------------------------- ### Install Kolla-Ansible from Local Git Repository Source: https://github.com/openstack/kolla-ansible/blob/master/doc/source/train.md If the git repository is in the current directory, use this command to install the package and avoid fetching from PyPI. ```bash pip install ./kolla-ansible ``` -------------------------------- ### Boot Bare Metal Instance Source: https://github.com/openstack/kolla-ansible/blob/master/doc/source/reference/bare-metal/ironic-guide.md Launch a server instance on the provisioned bare metal hardware using the previously created flavor and network. Adapt image, flavor, key, network, and instance name as needed. ```bash openstack server create --image cirros --flavor my-baremetal-flavor \ --key-name mykey --network public1 demo1 ``` -------------------------------- ### Install Vagrant Vbguest Plugin Source: https://github.com/openstack/kolla-ansible/blob/master/doc/source/contributor/vagrant-dev-env.md Installs the vagrant-vbguest plugin to ensure VirtualBox Guest Additions are installed in the VM. ```bash vagrant plugin install vagrant-vbguest ``` -------------------------------- ### Create Instance with Network Source: https://github.com/openstack/kolla-ansible/blob/master/doc/source/reference/networking/designate-guide.md Starts a new instance with specified image, flavor, key pair, and network. Ensure NETWORK_ID is set. ```bash openstack server create \ --image cirros \ --flavor m1.tiny \ --key-name mykey \ --nic net-id=${NETWORK_ID} \ my-vm ``` -------------------------------- ### Initialize Demo Resources with init-runonce Script Source: https://github.com/openstack/kolla-ansible/blob/master/doc/source/user/quickstart-development.md An optional script for demo purposes that creates example networks and images. Use with caution as it may conflict with custom configurations. ```console kolla-ansible/tools/init-runonce ``` -------------------------------- ### Install Kolla-Ansible from Source Source: https://github.com/openstack/kolla-ansible/blob/master/deploy-guide/source/train.md When installing kolla-ansible from source, ensure the kolla_ansible python module is installed. Use this command if the git repository is in the current directory. ```bash pip install /path/to/kolla-ansible ``` ```bash pip install ./kolla-ansible ``` -------------------------------- ### Run Init Scripts for VPNaaS Demo Source: https://github.com/openstack/kolla-ansible/blob/master/doc/source/reference/networking/neutron-extensions.md These scripts can be used for demo purposes to set up and verify VPN services. They are optional and may require customisation. ```bash tools/init-runonce tools/init-vpn ``` -------------------------------- ### Initialize Demo Resources with init-runonce Source: https://github.com/openstack/kolla-ansible/blob/master/deploy-guide/source/quickstart.md Execute the `init-runonce` script for demo purposes to create example networks and images. Note that this script is optional and may require adjustments based on your custom OpenStack configuration. ```bash /path/to/venv/share/kolla-ansible/init-runonce ``` -------------------------------- ### Install Kolla-Ansible Source: https://github.com/openstack/kolla-ansible/blob/master/deploy-guide/source/quickstart.md Install kolla-ansible and its dependencies using pip from a Git repository. ```console pip install git+https://opendev.org/openstack/kolla-ansible@|KOLLA_BRANCH_NAME| ``` -------------------------------- ### Install Ansible Galaxy Requirements Source: https://github.com/openstack/kolla-ansible/blob/master/deploy-guide/source/quickstart.md Install Ansible Galaxy dependencies required by Kolla-Ansible. ```console kolla-ansible install-deps ``` -------------------------------- ### Prepare Full Backup for Restore (Container) Source: https://github.com/openstack/kolla-ansible/blob/master/doc/source/admin/mariadb-backup-and-restore.md Start a container from the Mariabackup image to prepare a full backup. This involves extracting the backup data and preparing it for restoration. ```bash docker run --rm -it --volumes-from mariadb --name dbrestore \ --volume mariadb_backup:/backup \ quay.io/openstack.kolla/mariadb-server:master-rocky-10 \ /bin/bash (dbrestore) $ cd /backup (dbrestore) $ rm -rf /backup/restore (dbrestore) $ mkdir -p /backup/restore/full (dbrestore) $ gunzip mysqlbackup-04-10-2018.qp.xbc.xbs.gz (dbrestore) $ mbstream -x -C /backup/restore/full/ < mysqlbackup-04-10-2018.qp.xbc.xbs (dbrestore) $ mariabackup --prepare --target-dir /backup/restore/full ``` -------------------------------- ### Install OpenStack CLI Client Source: https://github.com/openstack/kolla-ansible/blob/master/doc/source/user/quickstart-development.md Installs the python-openstackclient using pip, with constraints for the master branch. ```console pip install python-openstackclient -c https://releases.openstack.org/constraints/upper/master ``` -------------------------------- ### Initialize and Deploy Tacker Demo Source: https://github.com/openstack/kolla-ansible/blob/master/doc/source/reference/orchestration-and-nfv/tacker-guide.md Execute these scripts from the kolla-ansible git repository to initialize the demo VNF creation process. The init-runonce script sets up necessary components, and deploy-tacker-demo registers a VIM, creates a VNFD, and deploys a VNF. ```bash ./tools/init-runonce ./contrib/demos/tacker/deploy-tacker-demo ``` -------------------------------- ### Install Dependencies for Ubuntu Source: https://github.com/openstack/kolla-ansible/blob/master/doc/source/contributor/vagrant-dev-env.md Installs required packages for Vagrant development on Ubuntu 16.04 or later. ```bash sudo apt install vagrant ruby-dev ruby-libvirt python-libvirt \ qemu-utils qemu-kvm libvirt-dev nfs-kernel-server zlib1g-dev libpng12-dev \ gcc git ``` -------------------------------- ### Prepare New Controller Hosts Source: https://github.com/openstack/kolla-ansible/blob/master/doc/source/user/adding-and-removing-hosts.md Use the `bootstrap-servers` command to prepare new controller hosts. This command adds entries to `/etc/hosts` which is required by some services like RabbitMQ. Ensure all controllers are included if using `--limit`. ```bash kolla-ansible bootstrap-servers -i [ --limit ] ``` -------------------------------- ### Install Kolla-Ansible Source: https://github.com/openstack/kolla-ansible/blob/master/doc/source/user/quickstart.md Install Kolla-Ansible and its dependencies from source using pip within the activated virtual environment. ```console pip install git+https://opendev.org/openstack/kolla-ansible@master ``` -------------------------------- ### Install Telnet Client Source: https://github.com/openstack/kolla-ansible/blob/master/doc/source/admin/password-rotation.md Install the telnet client utility, which is required for flushing Memcached data. Use the appropriate package manager for your distribution (apt or dnf). ```bash apt/dnf install telnet ``` -------------------------------- ### Create a New Release Note Source: https://github.com/openstack/kolla-ansible/blob/master/doc/source/contributor/release-notes.md Use this command to generate a new release note scaffold. Replace '' with a descriptive summary. ```console tox -e venv -- reno new ``` -------------------------------- ### Install Python Build Dependencies (Debian/Ubuntu) Source: https://github.com/openstack/kolla-ansible/blob/master/deploy-guide/source/quickstart.md Install necessary build dependencies for Python on Debian or Ubuntu. ```console sudo apt install git python3-dev libffi-dev gcc libssl-dev libdbus-glib-1-dev ``` -------------------------------- ### Run Basic Bootstrap Command Source: https://github.com/openstack/kolla-ansible/blob/master/doc/source/reference/deployment-and-bootstrapping/bootstrap-servers.md The fundamental command to initiate the server bootstrapping process. Replace `INVENTORY` with your Ansible inventory file path. ```console kolla-ansible bootstrap-servers -i INVENTORY ``` -------------------------------- ### Start NFS Service Source: https://github.com/openstack/kolla-ansible/blob/master/doc/source/reference/storage/cinder-guide.md Start the NFS service on the storage node to make the configured exports available. ```bash systemctl start nfs ``` -------------------------------- ### Copy All-in-One Inventory File Source: https://github.com/openstack/kolla-ansible/blob/master/deploy-guide/source/quickstart.md Copy the 'all-in-one' example inventory file to the current directory for single-node deployments. ```console cp /path/to/venv/share/kolla-ansible/ansible/inventory/all-in-one . ``` -------------------------------- ### Prometheus Pushgateway URL Example Source: https://github.com/openstack/kolla-ansible/blob/master/deploy-guide/source/zed.md Example of a resulting URL for the Prometheus Pushgateway based on configuration options. ```text prometheus://127.0.0.1:9091/ \ metrics/job/openstack-telemetry/?timeout=180&verify_ssl=True ``` -------------------------------- ### Copy Kolla Configuration Files Source: https://github.com/openstack/kolla-ansible/blob/master/deploy-guide/source/quickstart.md Copy the example Kolla configuration files (globals.yml, passwords.yml) to the /etc/kolla directory. ```console cp -r /path/to/venv/share/kolla-ansible/etc_examples/kolla/* /etc/kolla ```