diff --git a/docs_dev/assemblies/development_environment.adoc b/docs_dev/assemblies/development_environment.adoc index d7a49973c..6a56804ee 100644 --- a/docs_dev/assemblies/development_environment.adoc +++ b/docs_dev/assemblies/development_environment.adoc @@ -145,8 +145,9 @@ To use Wallaby content instead, run the following: [,bash] ---- cd ~/install_yamls/devsetup -make standalone +EDPM_CONFIGURE_HUGEPAGES=false make standalone <1> ---- +<1> To configure the host for a simplistic hugepages setup, set `EDPM_CONFIGURE_HUGEPAGES=true`. To deploy using TLS everywhere enabled, instead run: @@ -231,12 +232,14 @@ Create a test VM instance with a test volume attachement: cd ~/data-plane-adoption export CINDER_VOLUME_BACKEND_CONFIGURED=true <1> export CINDER_BACKUP_BACKEND_CONFIGURED=true +export EDPM_CONFIGURE_HUGEPAGES=false <2> export OPENSTACK_COMMAND="ssh -i ~/install_yamls/out/edpm/ansibleee-ssh-key-id_rsa root@192.168.122.100 OS_CLOUD=standalone openstack" OS_CLOUD_IP=192.168.122.100 OS_CLOUD_NAME=standalone \ bash tests/roles/development_environment/files/pre_launch.bash ---- <1> Use `CINDER_*_BACKEND_CONFIGURED=false`, if Cinder Volume or Backup services' storage backends have been not configured for the source cloud, or won't be configured for the target cloud. That might be a valid case for some developement setups, but not for a production scenarios. +<2> To configure a flavor with hugepages set `EDPM_CONFIGURE_HUGEPAGES=true`. You will need to reboot the standalone host firstly, to apply kernel args. This also creates a test Cinder volume, a backup from it, and a snapshot of it. diff --git a/docs_user/modules/proc_adopting-compute-services-to-the-data-plane.adoc b/docs_user/modules/proc_adopting-compute-services-to-the-data-plane.adoc index 100ff15eb..c83f0f2b4 100644 --- a/docs_user/modules/proc_adopting-compute-services-to-the-data-plane.adoc +++ b/docs_user/modules/proc_adopting-compute-services-to-the-data-plane.adoc @@ -407,12 +407,21 @@ endif::[] # Do not attempt OVS major upgrades here edpm_ovs_packages: - openvswitch3.1 + edpm_default_mounts: | <4> + [{ + "path": "/dev/hugepages2M", + "opts": "pagesize=2M", + "fstype": "hugetlbfs", + "group": "hugetlbfs" + }], + EOF ---- + <1> If TLS Everywhere is enabled, change `spec:tlsEnabled` to `true`. <2> If your deployment has a custom DNS Domain, modify the `spec:nodes:[NODE NAME]:hostName` to use fqdn for the node. <3> Replace `` with the value of the bridge mappings in your configuration, for example, `"datacentre:br-ctlplane"`. +<4> Omit that, if hugepages does not need to be configured. Note that the mount points must match the source cloud configuration. . Ensure that you use the same `ovn-controller` settings in the `OpenStackDataPlaneNodeSet` CR that you used in the {compute_service} nodes before adoption. This configuration is stored in the `external_ids` column in the `Open_vSwitch` table in the Open vSwitch database: + diff --git a/tests/roles/dataplane_adoption/defaults/main.yaml b/tests/roles/dataplane_adoption/defaults/main.yaml index 17a887729..d8df48740 100644 --- a/tests/roles/dataplane_adoption/defaults/main.yaml +++ b/tests/roles/dataplane_adoption/defaults/main.yaml @@ -265,6 +265,16 @@ dataplane_cr: | edpm_ovs_packages: - openvswitch3.1 + {% if use_hugepages|bool +%} + edpm_default_mounts: | + [{ + "path": "/dev/hugepages2M", + "opts": "pagesize=2M", + "fstype": "hugetlbfs", + "group": "hugetlbfs" + }], + {%+ endif +%} + # ovn-controller settings edpm_ovn_bridge_mappings: ["datacentre:{{ neutron_physical_bridge_name }}"] edpm_ovn_bridge: br-int diff --git a/tests/roles/development_environment/defaults/main.yaml b/tests/roles/development_environment/defaults/main.yaml index 2c5ca2fb9..fa8e63d08 100644 --- a/tests/roles/development_environment/defaults/main.yaml +++ b/tests/roles/development_environment/defaults/main.yaml @@ -4,6 +4,7 @@ edpm_privatekey_path: ~/install_yamls/out/edpm/ansibleee-ssh-key-id_rsa run_pre_adoption_validation: true os_cloud_name: standalone source_osp_ssh_user: root +use_hugepages: false # Supported storage backends for Cinder of the source cloud # must match those configured for the target cloud supported_volume_backends: [] diff --git a/tests/roles/development_environment/files/pre_launch.bash b/tests/roles/development_environment/files/pre_launch.bash index 6e1b9a1e3..508147a9a 100755 --- a/tests/roles/development_environment/files/pre_launch.bash +++ b/tests/roles/development_environment/files/pre_launch.bash @@ -72,6 +72,9 @@ ${BASH_ALIASES[openstack]} image show cirros || \ # Create flavor ${BASH_ALIASES[openstack]} flavor show m1.small || \ ${BASH_ALIASES[openstack]} flavor create --ram 512 --vcpus 1 --disk 1 --ephemeral 1 m1.small +if [ "${EDPM_CONFIGURE_HUGEPAGES:-false}" = "true" ] ; then + ${BASH_ALIASES[openstack]} flavor set m1.small --property hw:mem_page_size=2MB +fi # Create networks ${BASH_ALIASES[openstack]} network show private || ${BASH_ALIASES[openstack]} network create private --share diff --git a/tests/roles/development_environment/tasks/main.yaml b/tests/roles/development_environment/tasks/main.yaml index 4796ff488..1db4aa0a3 100644 --- a/tests/roles/development_environment/tasks/main.yaml +++ b/tests/roles/development_environment/tasks/main.yaml @@ -1,3 +1,20 @@ +- name: pre-launch test VM instance + no_log: "{{ use_no_log }}" + when: + - use_hugepages|bool + - prelaunch_test_instance|bool + block: + - name: Reboot to apply kernel args + become: true + ansible.builtin.reboot: + post_reboot_delay: 60 + reboot_timeout: 600 + + - name: Wait for connection + ansible.builtin.wait_for_connection: + delay: 10 + timeout: 600 + - name: pre-launch test VM instance no_log: "{{ use_no_log }}" when: prelaunch_test_instance|bool @@ -8,6 +25,7 @@ cmd: | {{ shell_header }} export OPENSTACK_COMMAND="{{ openstack_command }}" + export EDPM_CONFIGURE_HUGEPAGES={{ use_hugepages | string | lower }} export CINDER_VOLUME_BACKEND_CONFIGURED={{ cinder_volume_backend_configured | string | lower }} export CINDER_BACKUP_BACKEND_CONFIGURED={{ cinder_backup_backend_configured | string | lower }} {{ lookup('ansible.builtin.file', prelaunch_test_instance_script) }} diff --git a/tests/vars.sample.yaml b/tests/vars.sample.yaml index 0067d220b..9a119e40d 100644 --- a/tests/vars.sample.yaml +++ b/tests/vars.sample.yaml @@ -71,6 +71,7 @@ supported_backup_backends: #CUSTOMIZE_THIS # Whether the adopted node will host compute services compute_adoption: true +use_hugepages: false # Where perform or not telemetry installation during adoption telemetry_adoption: true