[en] Before you start, make sure that you've:
[en] Completed the steps to install Acrolinx for 2021.05 and saved the
acrolinx.yamlfile that you configured for that installation.
[en] Installed all releases after 2021.05 consecutively.
[en] Backed up your Analytics and Terminology databases and your configuration directory
[en] If you want to update your Standard Stack installation, you'll first need to identify which platform version you want to use. Here’s a list of available Acrolinx Helm charts.
[en] The platform chart names follow the pattern
acrolinx-platform-<operator version>+<platform version>.tgz. For example:
acrolinx-platform-1.0.5+2021.05.tgz acrolinx-platform-1.1.3+2021.07.tgz acrolinx-platform-1.1.4+2021.07.tgz
[en] Before you can update your Standard Stack installation to 2022.06, you'll need to upgrade to K3s version
v1.22.8+k3s1. Learn how to do this under Upgrade Basics in the K3s docs.
[en] You'll also need to delete the Traefik v1 configuration before you upgrade.
[en] To delete your Traefik v1 configuration, run the following commands:
kubectl -n kube-system delete helmchart traefik traefik-crd kubectl -n kube-system delete helmchartconfig traefik
[en] To update to a new platform version, do the following:
[en] Choose your preferred platform version. If you see multiple operator versions, pick the one with the higher version number. For example, if you want to install platform version 2021.07, and you see both
[en] Open your
acrolinx.yamlfile and update the configuration:
[en] Update the
versionfield with the operator and platform version that you chose in step 1. This might look like the following:
spec: # ... version: x.x.x+xxxx.xx
[en] Replace the old guidance package name and version with the version and name of the guidance package that you'd like to use instead. Learn more about where to find your available guidance package versions.
[en] Your container image for your guidance package starts with the prefix
acrolinx/guidance. The name appears after
acrolinx/guidance/. For example,
[en] Be sure to use a colon to separate the name and build number. For example:
spec: set: ### [...] platform.spec.guidance: "targets-starter-en-stasta:xxxx.xx-xxxxx"
[en] After you update the configuration in your
acrolinx.yamlfile, you can upgrade the Acrolinx version in your Kubernetes cluster. To apply the upgrade, use the following:
kubectl apply -f acrolinx.yaml
[en] Wait for the installation to complete.
[en] Optional: You can use the following to wait for the
kubectl wait -n acrolinx coreplatform acrolinx --for condition=Ready --timeout=15m
[en] When the status is
Ready, you'll see the message "condition met". If you don't see the status
Readyafter 15 minutes, the command will time out.
[en] Check your installation.
kubectl describe coreplatform acrolinx -n acrolinx
[en] When your installation is ready, you’ll see the following in the output and the Acrolinx Platform will become available on port 80 of the target machine.
Status: # [...] Summary: Version: xxxx.xx Platform Status: Ready