chore: initial commit with the configurations files

README.md

@@ -1 +1,114 @@
-# migration-tool-openstack-kolla
+# Migration Tool – OVS to OVN (Kolla OpenStack)
+
+## Overview
+
+This repository provides an **Ansible-based migration tool** to migrate an OpenStack environment from **Neutron Open vSwitch (OVS)** to **Neutron OVN**, specifically designed for **Kolla**.
+
+The migration process is based on existing community approaches, with adaptations to better fit the Kolla architecture. While the tool has been tested in several scenarios, it may still require adjustments depending on the target environment.
+
+>  **Important:** Before running this migration, it is **strongly recommended** to create a **full backup** of your OpenStack environment.
+https://docs.openstack.org/kolla-ansible/latest/admin/mariadb-backup-and-restore.html
+---
+
+## Scope and Assumptions
+
+- OpenStack deployed using **Kolla**
+- Migration path: **Neutron OVS → Neutron OVN**
+- Open vSwitch is **not removed** during the migration
+- Networking control is transferred from OVS to OVN
+
+---
+
+## Migration Workflow
+
+The migration is executed through an **Ansible playbook** and is divided into three main steps.
+
+---
+
+### Step 1 – Stop OVS Services and Clean OVS State
+
+The playbook performs the following actions:
+
+- Stops systemd services related to **Neutron OVS**
+- Stops the **Neutron service**
+- Removes existing **Open vSwitch flows**
+- Cleans the **`br-tun` bridge**
+
+#### Why this step is required
+
+- `br-tun` is **not used by OVN**
+- Existing OVS flows may conflict with OVN rules
+- Ensures a clean transition to OVN
+
+> ℹ️ **Note:** OVS remains installed after this step, but it is no longer managed by Neutron.
+
+---
+
+### Step 2 – Switch Neutron Plugin and Deploy OVN
+
+This step updates the OpenStack configuration to use OVN:
+
+- Updates the Neutron plugin in `globals.yml`
+- Deploys **OVN services**
+- Adds required **OVN configuration options** to Neutron configuration files
+- Reconfigures Neutron to apply OVN settings
+
+After this step, Neutron is fully configured to operate with OVN.
+
+---
+
+### Step 3 – Database Adjustment
+
+A small but critical database change is performed:
+
+- Updates the `providerresourceassociations` table
+- Removes legacy **OVS-related entries**
+- Ensures the provider information reflects **OVN**
+
+#### Why this step is necessary
+
+Without this adjustment, the system may appear functional but will fail after:
+
+- Neutron service restarts
+- Host reboots
+
+Neutron will attempt to register OVN as the provider, but the table will already be populated with OVS data, causing network failures.
+
+Once this step is completed, the migration is considered **finalized**.
+
+---
+
+## Important Notes
+
+-  **Always back up your environment before running the migration**
+-  Tested in limited environments; additional tuning may be required
+-  **Octavia compatibility**
+
+>  **This migration has NOT been tested with Octavia (Load Balancer as a Service).**  
+> Environments using Octavia may encounter unexpected behavior.  
+> Thorough testing in a staging environment is strongly recommended.
+
+---
+
+## Migration Status
+
+- [x] Neutron OVS to OVN migration
+- [x] Kolla-specific workflow
+- [x] Tested with Octavia with Amphora driver
+- [x] Tested with Octavia with OVN driver
+
+---
+
+## About Octavia
+
+In tests using the tool, Octavia with the Amphora driver did not show any errors or critical issues. However, in the UI, the provisioning status remains in an error state even though the load balancer continues to work correctly. You can fix this by running a simple **openstack loadbalancer failover <loadbalancer-id>**. Using Octavia with the OVN driver has not been tested yet.
+
+---
+
+## Disclaimer
+
+This tool modifies core networking components and database entries in OpenStack.  
+Use it at your own risk and **never run directly in production without prior validation**.
+
+
+

init_migration.yml

@@ -0,0 +1,7 @@
+---
+  - name: migration OVS plugin to OVN
+    hosts: control
+    gather_facts: yes
+    become: true
+    roles:
+      - role: migration

migration/tasks/main.yml

@@ -0,0 +1,17 @@
+---
+
+- name: Stop Neutron service
+  ansible.builtin.import_tasks: prepare_neutron.yml
+  tags:
+    - stop-neutron
+
+- name: Deploy OVN plugin
+  ansible.builtin.import_tasks: ovn_deploy.yml
+  tags:
+    - deploy-ovn
+
+- name: Clean the database and finish the migration
+  ansible.builtin.import_tasks: post_migration.yml
+  tags:
+    - cleaning-bd
+

migration/tasks/ovn_deploy.yml

@@ -0,0 +1,43 @@
+---
+
+- name: Replace ML2 plugin from OVS to OVN
+  ansible.builtin.replace:
+    path: /etc/kolla/globals.yml
+    regexp: '^neutron_plugin_agent: "openvswitch"'
+    replace: 'neutron_plugin_agent: "ovn"'
+
+- name: Deploy OVN service
+  shell: kolla-ansible deploy -i {{ path_to_hosts }} -t ovn
+
+- name: Get file stats
+  stat:
+    path: /etc/kolla/config/neutron/ml2_conf.ini
+  register: ml2_conf_file
+
+- name: Ensure neutron config directory and ml2_conf.ini exist
+  file:
+    path: "{{ item.path }}"
+    state: "{{ item.state }}"
+    mode: "{{ item.mode }}"
+  loop:
+    - { path: /etc/kolla/config/neutron, state: directory, mode: '0755' }
+    - { path: /etc/kolla/config/neutron/ml2_conf.ini, state: touch, mode: '0644' }
+
+- name: Set OVN options in ml2_conf.ini
+  ini_file:
+    path: /etc/kolla/config/neutron/ml2_conf.ini
+    section: ovn
+    option: "{{ item.option }}"
+    value: "{{ item.value }}"
+  loop:
+    - { option: neutron_sync_mode, value: repair }
+    - { option: ovn_l3_mode, value: "True" }
+    - { option: vif_type, value: ovs }
+
+- name: Reconfigure the neutron service
+  shell: kolla-ansible reconfigure -i {{ path_to_hosts }} -t neutron
+
+- name: Sync existing data
+  shell: docker exec neutron_server neutron-ovn-db-sync-util --config-file /etc/neutron/neutron.conf --config-file /etc/neutron/plugins/ml2/ml2_conf.ini
+  register: sync_result
+  failed_when: sync_result.rc != 0 and "Deprecated" not in sync_result.stderr

migration/tasks/post_migration.yml

@@ -0,0 +1,16 @@
+---
+
+- name: Delete rows via Docker Exec module
+  community.docker.docker_container_exec:
+    container: mariadb
+    command: >
+      mysql -h {{ vip_address }} 
+      -u {{ mariadb_user }} 
+      -p{{ mariadb_password }}
+      -e "DELETE FROM providerresourceassociations;"
+      neutron
+  register: result
+
+- name: Reconfigure OVS to get OVN configurations
+  shell: kolla-ansible reconfigure -i {{ path_to_hosts }} -t openvswitch
+

migration/tasks/prepare_neutron.yml

@@ -0,0 +1,21 @@
+---
+
+- name: Stoping neutron OVS services on systemd
+  shell: systemctl disable {{ item }}
+  loop:
+    - kolla-neutron_metadata_agent-container.service 
+    - kolla-neutron_l3_agent-container.service
+    - kolla-neutron_openvswitch_agent-container.service
+
+- name: Stoping neutron to aplication configurations
+  shell: kolla-ansible stop -i {{ path_to_hosts }} -t neutron --yes-i-really-really-mean-it
+
+- name: Configure OVS container
+  command: docker exec openvswitch_vswitchd {{ item }}
+  loop:
+    - ovs-vsctl del-br br-tun
+    - ovs-vsctl set Bridge br-ex protocols=[]
+    - ovs-vsctl set Bridge br-int protocols=[]
+
+- name: Clean network namespaces
+  shell: ip -all netns delete

migration/vars/main.yml

@@ -0,0 +1,5 @@
+---
+mariadb_user: 
+mariadb_password:
+path_to_hosts: 
+vip_address: