Modify the configuration or upgrade to a newer version of the SystemLink Enterprise application.

Before updating SystemLink Enterprise, ensure you have all configuration files. If part of the configuration is missing, upgrading might result in application failures and resource deletions from the cluster.

Refer to the release notes for the SystemLink Enterprise version to which you want to upgrade. Check that the SystemLink Enterprise version supports a version of RabbitMQ that is no more than one minor version from your current RabbitMQ version. If your current RabbitMQ version is too far behind, upgrade to a version of SystemLink Enterprise that includes the next minor RabbitMQ version. Repeat the upgrade until you reach the version of RabbitMQ you want.

Required Kubernetes Permissions

A user with one of the following privileges must complete the SystemLink Admin update:

  • A cluster administrator with full access rights.
  • A user with a cluster role that includes privileges to create CustomResourceDefinitions, ClusterRoles, and ClusterRoleBindings.

Refer to Required Kubernetes Permissions for more details.

Updating SystemLink Admin Prerequisites

Update the prerequisites in the systemlink-admin namespace using your configuration files:

helm upgrade <admin-release> oci://downloads.artifacts.ni.com/ni-docker/ni/helm-charts/systemlinkadmin --install --version <version> --namespace <admin-namespace> --values systemlink-admin-values.yaml --values systemlink-values.yaml --values systemlink-secrets.yaml --wait --timeout 10m0s
Table 18. Admin Prerequisites
Parameter Description
admin-release The release name used for installing the SystemLink Admin Helm chart.
downloads.artifacts.ni.com/ni-docker The URL of the registry. If using a local mirror, replace this URL with the URL of the mirror registry.
version The specific version of the software to install.
admin-namespace The namespace created for the SystemLink Admin Helm chart.

This command waits for up to the configured timeout for the update to complete and for all resources to enter a ready state.

Updating SystemLink Enterprise

Update the application using your configuration files:

helm upgrade <release> oci://downloads.artifacts.ni.com/ni-docker/ni/helm-charts/systemlink --install --version <version> --namespace <namespace> --values systemlink-values.yaml --values systemlink-secrets.yaml --set-file database.postgresCertificate=postgres.pem
Table 19. Update Parameters
Parameter Description
release The name Helm assigns to the installed collection of software.
downloads.artifacts.ni.com/ni-docker The URL of the registry. If using a local mirror, replace this URL with the URL of the mirror registry.
version The specific version of the software to install.
namespace The namespace created for the application.

The update command applies any changes you made to the values in your files since installing. Containers are updated to the specified version. Changes are applied using a rolling update strategy to avoid downtime.

Updating SystemLink Elasticsearch

If you deployed a SystemLink Elasticsearch instance, update it using your configuration files:

helm upgrade <elasticsearch-release> oci://downloads.artifacts.ni.com/ni-docker/ni/helm-charts/systemlinkelasticsearch --install --version <version> --namespace <namespace> --values elasticsearch-values.yaml --values elasticsearch-secrets.yaml
Table 20. Elasticsearch Update Parameters
Parameter Description
elasticsearch-release The release name used for installing the SystemLink Elasticsearch Helm chart.
downloads.artifacts.ni.com/ni-docker The URL of the registry. If using a local mirror, replace this URL with the URL of the mirror registry.
version The specific version of the software to install.
namespace The namespace created for the Elasticsearch instance.