Those templates have been developed using the infra-as-code principles and crafted from production ones. The structure somehow diverges from the standard TripleO/OSPd baseline adding deterministic and reproducible environment limiting at the minimum the randomness. Knowledge about how those have been developed can be found in the Red Hat OpenStack Platform Advanced Configuration chapter
To deploy a platform, the undercloud must be installed. No wrapper is provided for this scope. The undercloud configuration is under versioning control. Then moving into the script folder, in numerical order all must be executed.
Simply re-execute the 005-deploy.sh wrapper.
Usually changes between clouds can be found in the following files
- The
004-create_update_docker_osp_images.shand005-deploy.sh-> To include the right templates - 10-commons-parameters.yaml -> For the root password and cloud name
- 20-network-environment.yaml -> Network details (VLAN, Subnets, allocation ranges, etc)
- 40-fencing.yaml -> MAC addreses and IPMI details
- 60-openstack-neutron-custom-configs.yaml -> Neutron Bridge Mapping, DHCP, and other Neutron-related configuration
- 70-ovs-dpdk-sriov.yaml -> Compute role types configuration (CPU-Partitioning, Kernel Args, PMD Design, SR-IOV Design etc)
├── deployment_wrappers => Wrapper directory including NFVi deployment and initialization scripts (e.g. Docker images, import baremetal environment, etc)
├── hci => Folder with script to run HCI node on RHEL
├── hci-esxi => Folder with Readme, VMX and script to run HCI node on VMware ESXi
├── overcloud => Overcloud main directory for custom templates and environment configuration
│ ├── environments => Templates and configurations for the platform (network, SSL, storage, tuning, and extraconfig hooks mapping)
│ ├── extraconfig => Pre and post-puppet customization hooks templates and scripts
│ │ ├── post-config => Post-puppet templates (e.g. configure Heat caching)
│ │ └── pre-config => Pre-puppet (e.g. Real-Time KVM Tuning)
│ ├── firstboot => Very first boot cutomization template (e.g. SSH root password)
│ └── nic-configs => Per role physical NIC mapping to bonds, vlan tags, subnets, and routes
├── scripts => Script directory including some various tools
├── undercloud => Undercloud directory including undercloud configuration and baremetal environment
└── validation => Script directory including basic validation script to funcionally verify the platform once deployed/updated
├── README.md => This Readme
├── deployment_wrappers
│ ├── 001-create_update_images.sh => Wrapper to create and update the overcloud RHEL images
│ ├── 002-create_update_realtime_image.sh => Wrapper to create and update the overcloud RealTime RHEL images
│ ├── 003-import_instackenv_nodes.sh => Wrapper to import/update the virtual/physical server into Ironic
│ ├── 004-create_update_docker_osp_images.sh => Wrapper to download and update the container images from the Red Hat DCN - active subscription required
│ └── 005-deploy.sh => Wrapper to deploy the platform and also to apply incremental changes
├── overcloud
│ ├── environments => Main environment folder with all the templates describing the deployment
│ │ ├── 10-commons-parameters.yaml => Common environment parameters (e.g. TimeZone, root password, SSH config, and DNS cloud name)
│ │ ├── 20-network-environment.yaml => Network configuration file defining subnets, vlans, allocation rangies, bonding setup, fixed IPs, Virtual IPs, etc
│ │ ├── 30-storage-environment.yaml => Storage configuration file for all the services
│ │ ├── 40-fencing.yaml => Hash with server Ethernet MAC address, IPMI credential, and fencing mechanism
│ │ ├── 50-keystone-admin-endpoint.yaml => Expose Keystone Admin API over external network
│ │ ├── 60-openstack-neutron-custom-configs.yaml => Specific Neutron configuration such as MTU size, bridge mapping, security group firewall driver etc
│ │ ├── 60-openstack-nova-custom-configs.yaml => Specific Nova configuration such as Multipathd, scheduler filters etc
│ │ ├── 60-openstack-glance-custom-configs.yaml => Specific Glance configuration such as Image Auto Conversion
│ │ ├── 70-ovs-dpdk-sriov.yaml => SR-IOV and OVS-DPDK Compute configuration such as Tuned profile, CPU Partitioning, Huge Pages, kernel args etc
│ │ ├── 99-extraconfig.yaml => Puppet Extra configuration for Pre and Post deployment hooks, tuning (oslo, memcached, rabbit, haproxy, mysql) etc
│ │ └── 99-server-blacklist.yaml => Blacklist nodes useful for upgrade purpose
│ ├── extraconfig
│ │ ├── post-config => Post deployment template folder currently only used by controller role to enable Heat cache
│ │ │ ├── controller.yaml
│ │ │ └── scripts
│ │ │ └── heatcache.sh
│ │ └── pre-config => Pre deployment template folder currently only used by Compute RT roles for specific KVM tuning
│ │ ├── compute_deterministic.yaml
│ │ └── scripts
│ │ └── nx_huge_pages_recovery_ratio.sh
│ ├── firstboot
│ │ └── first-boot.yaml => First boot template for root SSH password and Disk Wipe (used by Ceph, not required here)
│ ├── nic-configs
│ │ ├── compute-dual-ovsdpdk.yaml => Compute with OVS-DPDK with NICs on both NUMA nodes
│ │ ├── compute-dual-sriov.yaml => Compute with SR-IOV with NICs on both NUMA nodes
│ │ ├── compute-ovsdpdk-sriov.yaml => Compute with OVS-DPDK NIC on NUMA0 and SR-IOV NIC on NUMA1
│ │ ├── compute-ovsdpdk.yaml => Compute with OVS-DPDK NIC only on NUMA0
│ │ ├── compute-sriov.yaml => Compute with SR-IOV NIC only on NUMA0
│ │ └── controller.yaml => Controller NIC Mapping
│ ├── nodes-info.yaml => Node info such as quantity per node
│ ├── overcloud_images.yaml => Docker images for the Overcloud
│ └── roles-data.yaml => Roles template used to define additional compute roles
├── scripts
│ ├── token_perf.sh => Generate Keystone tokens in a while true loop to measure the Keystone Token issue API response time
│ └── token_perf_uc.sh => Same as above only this one is for the Undercloud
├── undercloud
│ ├── custom_hieradata.yaml => Undercloud Puppet's Hieradata overwrite to improve for API responvness
│ ├── db_tuning.sh => Undercloud MariaDB tuning script - Must be executed after any `openstack undercloud [install|upgrade]`
│ ├── instackenv.json => Physical and Virtual Hardware definition
│ └── undercloud.conf => Undercloud main configuration file
└── validation
├── basic_ovs-dpdk
│ ├── create_gre.sh => Create simple validation virtual environment with GRE tenant networks
│ ├── create_vxlan.sh => Create simple validation virtual environment with VXLAN tenant networks
│ └── teardown.sh => Virtual environment teardown
├── basic_ovs-dpdk-and-sriov
│ ├── create.sh => Create simple validation virtual environment with VIRTIO and SR-IOV
│ └── teardown.sh => Virtual environment teardown
├── basic_sriov
│ ├── create_pf.sh => Create simple validation virtual environment with SR-IOV PF (also called PCI-Passthrough)
│ ├── create_vf.sh => Create simple validation virtual environment with SR-IOV VF
│ └── teardown.sh => Virtual environment teardown
├── nfvbench_l3_env
│ ├── README.md => README
│ ├── create.sh => Create virtual environment for L3 traffic with two VM, NFVBench using SR-IOV PF anf VPP using VIRTIO on OVS-DPDK
│ ├── nfvbench
│ │ ├── nfvbench.cfg => NFVBench configuration file
│ │ └── run.sh => NFVBench wrapper
│ ├── prepare_nfvbench.sh => Script to prepare the NFVBench VM
│ ├── prepare_vpp.sh => Script to prepare the VPP VM
│ ├── run_nfvbench.md => README about NFVBench
│ ├── run_vpp.md => README about VPP
│ ├── teardown.sh => Virtual environment teardown
│ ├── traffic_flow.png => Traffic Flow PNG
│ └── traffic_flow.svg => Traffic Flow source in SVG
└── trex_l2_env
├── README.md => README
├── create.sh => Create virtual environment for L2 traffic with two VM, TRex using SR-IOV VF anf TestPMD using VIRTIO on OVS-DPDK
├── prepare_testpmd.sh => Script to prepare the TestPMD VM
├── prepare_trex.sh => Script to prepare the TRex VM
├── run_testpmd.md => README about TestPMD
├── run_trex.md => README about TRex
└── teardown.sh => Virtual environment teardown
- Configure Docker to use a proxy with or without authentication
- Misalignment Nova Placement API
- How to configure HTTP Proxy for Red Hat Subscription Management
- Ironic node using dracclient goes to clean failed with "Unfinished config jobs found"
- Nova instance provision fails with host is not mapped to any cell in Red Hat OpenStack Platform
- Starting 2nd VM on same NUMA socket is causing huge latency during startup of second VM
- Provisioning with LACP configuration is incomplete
- OVS-DPDK bridges should be DOWN
- [RHOSP13.0.6][OVS-DPDK] CPU steal in PMD thread imapcting physical Rxq performance
- 8 vCPU guest need max latency < 20 us with stress
- <stats period='10'/> of memballoon device cause high latency spike for KVM-RT guest
- [RFE] Performance Monitoring Unit management for real time guest
- spurious ktimersoftd wake ups increases latency (rhel-rt 7)
- add compiler optimization option to openvswitch rpm package for better ovs-dpdk performance
- [RHOSP10][NFV][SRIOV][ISOLCPUS] High SoftIRQ interrupt in guest vcpu0 / Isolated KVM Core in NFVi
- dropped packets noticed in dpctl/show in balance-slb with passive lacp bonds
- IRQs silently spilling over onto isolated cores
- do not raise timer softirq unconditionally
- 8 vCPU guest need max latency < 20 us with stress
- kvm nx_huge_pages_recovery_ratio=0 is needed to meet KVM-RT low
- [RFE] KVM-RT guest with 10 vCPUs hangs on reboot
- Nova: Disable USB/graphics/tablet via image props/extra specs
- Disable timer_migration on cpu-partitioning profile
- OVS causing high pings and latency inside guest VM when an active DPDK port fails
- OVS packet re-ordering due to upcalls