Known bugs and limitations¶
The implementation limitations and bugs found in Kolla-Ansible ussuri-eol, by area, with the evidence and the status
of each row. Where a Status cell adds NOT AVAILABLE, it names what the sources do not establish about the issue.
Note
Key answers
- Implementation limitations and bugs of
ussuri-eol, by area: CLI,site.yml,kolla_docker, the kolla images and individual roles (table below).
| Area | Issue | Evidence | Status |
|---|---|---|---|
| CLI | -e kolla_serial=N is overridden by ANSIBLE_SERIAL (default 0) for reconfigure/upgrade; it is not passed for deploy |
tools/ |
CODE |
| CLI | --ask-vault-pass overwrites VERBOSITY with a copy of EXTRA_OPTS |
tools/ |
CODE |
| CLI | --include-dev: declared with an argument but used as a flag; the command line is executed unquoted |
tools/ |
CODE fact sheet E |
| site.yml | cyborg play uses serial instead of kolla_serial |
site.yml:1028 |
CODE |
| site.yml | placement haproxy include lacks when: enable_placement |
site.yml:289-292 |
CODE |
| kolla_docker | graceful_timeout/client_timeout from docker_common_options ignored (F3); restart_policy never compared (FIXME :21) |
kolla_docker.py:21, |
CODE |
| kolla images | kolla_set_configs --check compares only config_files entries (F14): changes confined to config.json (command, permissions; all of memcached's settings) are never detected, so neither genconfig + deploy-containers nor a later run applies them until the container restarts for another reason; a newly added optional file makes it exit 2 and fails check-containers unless an entry listed before it differs (then 1); preserve_properties entries (prometheus extras) and directory sources with subdirectories report drift on every run; a restart never removes files whose entry was dropped |
kolla docker/; kolla_docker.py:566-578 |
CODE |
| common | -t common no-op (F2) |
roles/; Tags §2.1 |
CODE |
| haproxy | Restart instead of reload; stale services.d files never removed; keepalived priority from inventory order; upgrade "Stopping all slave keepalived" without an enable_keepalived guard and with raw interface names |
fact sheet A §1.8 | CODE; effect of the upgrade bugs NOT AVAILABLE |
| openvswitch | Set system-id always reports changed |
roles/ (a command task with no changed_when; command always returns changed, ansible 2.9.27 lib/) |
CODE |
| neutron | upgrade with the default neutron_enable_rolling_upgrade: "yes" expands/contracts only neutron, neutron-fwaas and neutron-vpnaas: neutron-dynamic-routing, which the KOLLA_BOOTSTRAP container migrates on deploy, is never migrated by upgrade, and the image's rolling neutron-db-manage calls pass no --config-file. has_offline_migrations runs on the first neutron-server host with ignore_errors; any non-zero rc (a failed docker exec included) stops neutron_server on every neutron-server host in the play until the handler flush after the contract container |
roles/; roles/; roles/; roles/; kolla docker/ |
CODE; impact on the Neutron API NOT AVAILABLE |
| ovs-dpdk | pull looks up a non-existent ovs_services variable; the NIC mapping file is written once; the 300 s wait handler has no port |
fact sheet A §6 | CODE |
| rabbitmq | outward RabbitMQ pull looks up outward_rabbitmq_services |
fact sheet B §2.8 (item 6); site.yml:563 (project_name: outward_rabbitmq), roles/, roles/; ansible 2.9.27 lib/ |
CODE: with outward RabbitMQ enabled, that variable is not defined anywhere, the vars lookup raises an undefined-variable error and "Pull images" fails on the outward-rabbitmq hosts |
| rabbitmq | the image writes .erlang.cookie only in the bootstrap container (new volume); a cookie change recreates the brokers (env compare) but they keep the old cookie, while kolla_toolbox gets the new one |
kolla docker/; roles/; roles/ |
CODE; consequences NOT AVAILABLE |
| mariadb | the restart waves have no any_errors_fatal; recovery stops healthy nodes; clustercheck started even when disabled |
fact sheet B §1.5, §1.8 (items 5–6); roles/; ansible 2.9.27 lib/ |
CODE: a node that fails its WSREP wait marks only its own host failed, and the next wave still restarts its nodes (R9); whether the failed node is then still joining, and how large the quorum and availability risk is, NOT AVAILABLE |
| keystone | fernet cron generator hour calculation; precheck vs generator expiry limits; push script stops at the first unreachable peer | fact sheet B §3.9 (items 3–5); roles/, roles/ |
CODE |
| glance | global log_bin_trust_function_creators toggle on every deploy/reconfigure; file backend = single host; backend switches silently when Swift/Ceph is enabled |
fact sheet C §1 | CODE |
| cinder | no host/backend_host/cluster; etcd coordination uses only the first etcd host; Ceph backup driver default without a Ceph config |
fact sheet C §3 | CODE |
| heat | bootstrap_heat creates heat_user_domain/heat_domain_admin only when the domain is absent: a changed heat_domain_admin_password reaches heat.conf but never Keystone |
kolla docker/; roles/ |
CODE; impact NOT AVAILABLE |
| swift | no handlers are notified (deploy does not apply config/ring changes); stop.yml wrong container name; precheck probes rsync port 873 vs 10873 |
fact sheet D | CODE; runtime effects NOT AVAILABLE |
| octavia | upgrade removes the octavia admin role on admin without re-registering; no amphora resources are created |
fact sheet D | CODE |
| masakari | instancemonitor uses qemu+tcp without SASL while nova-libvirt enables SASL |
fact sheet D; roles/, roles/, roles/ |
CODE; effect on the instancemonitor NOT AVAILABLE |
| baremetal | Docker restarted on daemon.json change on all hosts at once; docker_custom_option changes are never applied; Docker masked during re-runs on Debian/Ubuntu; /etc/hosts lists every baremetal host (O(N²) templating, stale with --limit) |
fact sheet E §1–5 | CODE; runtime effects NOT AVAILABLE |
| certificates | test CA only; certs never renewed; new backend hosts not added | fact sheet A §8, E | CODE |
Related¶
- Troubleshooting — the symptom index, which points to these rows by what an operator sees
- Findings — the headline findings; the rows
kolla_docker,kolla imagesandcommoncite F3, F14 and F2 - Per-role fact sheets — the fact sheets that the role rows cite as evidence, and their corrections
- Fact sheet D §7 — the consolidated bugs and oddities of the roles of fact sheet D
- Kolla images §3 — what
kolla_set_configs --checkcompares and what it never compares (rowkolla images) - What is not known — the effects that the Status column marks NOT AVAILABLE, by topic
- Open questions — the open questions Q1 to Q14
To remember
Lumo: if you keep only 5 things from this page, keep these.
-e kolla_serial=Nis overridden byANSIBLE_SERIAL(default 0) forreconfigure/upgrade; it is not passed fordeploy. CODEkolla_set_configs --checkcompares onlyconfig_filesentries: changes confined toconfig.jsonare not applied until the container restarts for another reason. CODEgraceful_timeout/client_timeoutfromdocker_common_optionsare ignored, andrestart_policyis never compared. CODE- A changed
heat_domain_admin_passwordreachesheat.confbut never Keystone. CODE - Certificates: test CA only, certs never renewed, new backend hosts not added. CODE
Check yourself
Lumo: 3 quick questions to check the main ideas of this page. Choose an answer to see the explanation and the section that gives the evidence. Your score counts your first choices and stays in this browser only.
Lumo: ready for the next step? Take your time: you can come back to this page whenever you need it.
Lumo: nicely done! One more page on your journey.