Migration to 4.8.x (Nexeed IAS 2025.02.00.x)

Migration of deviation notifications (limitation: version 4.5.0 was not deployed on the system before)

To create Hit of Event rules from Deviation Notifications, set the rs_create_rule_from_deviations_tenant_ids variable with the relevant tenant IDs before migration. This step is only necessary if version 4.5.x, 4.6.x or 4.7.x was not previously deployed on the system. If version 4.5.x, 4.6.x or 4.7.x was already deployed, the Hit of Event rules have already been created.

Enable forwarding of machine messages as deviation

To enable forwarding machine messages as deviation set the cm_core_deviation_forward_machine_messages_tenant_ids variable with the relevant tenant IDs. Attention: If version 4.5.x, 4.6.x or 4.7.x was previously deployed on the system Hit of event rules are already existing for some machine messages. Activating the forwarding could lead to multiple deviations created by one machine message.

Migration of RabbitMQ classic queues to quorum queues to be compatible with RabbitMQ 4

Condition Monitoring services automatically migrate RabbitMQ classic queues to quorum queues during startup. After starting the services, verify the migration status by filtering q.cm in the queues tab of the RabbitMQ Management UI. If some queues are not migrated, review the service logs and try restarting a pod. Note: Due to a bug in the Spring RabbitMQ client, some auto-delete classic queues without consumers may still appear in the RabbitMQ Management UI after migration. These queues are no longer used by Condition Monitoring services and can be deleted manually.

The migration tool requires the RabbitMQ management URL (managementUrl) and port (adminPort). In a Radium environment, you can provide these settings as shown below:

global:
  serverInstances:
    externalRabbit:
      host: xref:operations:06_setup_and_configuration/_shared_variables/common-rabbitmq-shared-variables.adoc#rabbitmq_host[rabbitmq_host]
      port: xref:operations:06_setup_and_configuration/_shared_variables/common-rabbitmq-shared-variables.adoc#rabbitmq_port[rabbitmq_port]
      tls: xref:operations:06_setup_and_configuration/_shared_variables/common-rabbitmq-shared-variables.adoc#rabbitmq_tls_enabled[rabbitmq_tls_enabled]
      type: RABBITMQ
      default: true
      adminPort: <<management_port>>
      managementUrl: <<management_url>>