Manager
Stable release
Always read the release notes first to learn what has changed and what adjustments are necessary. Read the release notes even if you are only updating from e.g. 7.0.2 to 7.0.5.
In the example, OSISM release 7.0.5 is used.
-
Set the new manager version in the configuration repository.
MANAGER_VERSION=7.0.5
sed -i -e "s/manager_version: .*/manager_version: ${MANAGER_VERSION}/g" environments/manager/configuration.yml -
If
openstack_version
orceph_version
are set inenvironments/manager/configuration.yml
(or anywhere else), they must be removed. If these are set, the stable release is not used for these components. -
Sync the image versions in the configuration repository.
- OSISM >= 7.0.0
- OSISM < 7.0.0
make sync
If Gilt is not installed via the
requirements.txt
of the manager environment it is important to use a version smaller v2. The v2 of Gilt is not yet usable.gilt overlay # you have to do this 2x, this is not a copy & paste error
gilt overlayOptionally, this is normally not necessary, it is possible to reference a specific tag of the osism/cfg-generics repository. To do this, first check which version of osism/cfg-generics is used in a particular release. The version is defined in
generics_version
in thebase.yml
file in theosism/release
repository. For OSISM 6.0.0, for example, this is version v0.20230919.0. This version is then added to the filegilt.yml
in the configuration repository instead ofmain
atversion
. This change must be made again after each execution ofgilt overlay
as it is overwritten by the call ofgilt overlay
. This cannot be realized differently in the current implementation of Gilt. -
Commit and push changes in the configuration repository. Since everyone here has their own workflows for changes to the configuration repository, only a generic example for Git.
git commit -a -s -m "manager: use OSISM version 7.0.5"
git push -
The upgrade is described in the Manager Upgrade Guide.
OpenSearch integration
With the command osism log opensearch
it is possible to send SQL queries
to the OpenSearch service. For the command to be functional, the OpenSearch
integration must be activated in the manager environment and the OpenSearch
address and port must be set.
manager_opensearch_enable: true
manager_opensearch_address: api-int.testbed.osism.xyz
manager_opensearch_port: 9200
manager_opensearch_protocol: https
The integration can also be enabled later. osism update manager
is then
executed after the configuration has been changed.
OpenStack broker integration
If the Baremetal Service Integration in OSISM is used, the OpenStack Broker integration is
required. The integration itself is activated by setting the parameter enable_listener
to true
.
The hosts in the manager_listener_broker_hosts
list are the control nodes of OpenStack.
The user is set via manager_listener_broker_username
. On OpenStack's RabbitMQ broker, the user openstack
is present by default.
enable_listener: true
manager_listener_broker_hosts:
- 192.168.16.10
- 192.168.16.11
- 192.168.16.12
manager_listener_broker_username: openstack
manager_listener_broker_uri: "{% for host in manager_listener_broker_hosts %}amqp://{{ manager_listener_broker_username }}:{{ manager_listener_broker_password }}@{{ host }}:5672/{% if not loop.last %};{% endif %}{% endfor %}"
The password used when using the openstack
user is rabbitmq_password
from environments/kolla/secrets.yml
.
manager_listener_broker_password: RABBITMQ_PASSWORD