Steps to upgrade from V7.9 to V7.10

To be safe in case of any problems during the update, back up your database and the stages folder before the upgrade.
If the backup is running automated - please check whether the backup was created successfully.

Please also backup your cacerts file from your JDK8 installation. (<JavaHome>/jre/lib/security/cacerts)

Linux: execute sudo stages stop

Windows: stop the Stages and Stages Search Windows services

• Download a Java 17 JDK Installer for Windows (Links can be found under System Requirements for Stages 7.11)
• Execute the installer as an administrator
  • If the Installer offers to update the JAVA_HOME variable it is recommended to do so.
  • If not please update the JAVA_HOME variable manually.
• Proceed with Execute Manual Actions, Run Upgrade Installer and Restart Stages (see chapters below)
• Insert the cacerts file in <JavaHome>/lib/security from your backup if necessary.

We recommend doing all of the following as root in Linux shell.

Backup your cacerts file from your JDK8 installation. (<JavaHome>/jre/lib/security/cacerts), if not done already.

• Uninstall Java 8
  • execute the following

yum remove java-1.8.0-openjdk-headless.x86_64
yum remove java

• Install Java 17
  • execute the following

yum install java-17-openjdk-devel.x86_64

• Insert the cacerts file in <JavaHome>/lib/security from your backup if necessary.
• Proceed with Execute Manual Actions, Run Stages Upgrade Installer and Restart Stages

• We recommend doing all of the following as root in Linux shell.
  • Stop stages service

stages stop

• Uninstall java JDK 8
  • execute the following

yum remove java-1.8.0-openjdk-headless.x86_64
yum remove java

• Install Java JDK 17
  • e.g. with Adoptium Temurin OpenJDK, execute the following
    • Install instructions are copied from official Adoptium documentation

## Create repo file
touch /etc/yum.repos.d/adoptium.repo

## Fill repo with information
## # Uncomment and change the distribution name if you are not using CentOS/RHEL/Fedora
# DISTRIBUTION_NAME=centos
cat <<EOF> /etc/yum.repos.d/adoptium.repo
[Adoptium]
name=Adoptium
baseurl=https://packages.adoptium.net/artifactory/rpm/${DISTRIBUTION_NAME:-$(. /etc/os-release; echo $ID)}/\$releasever/\$basearch
enabled=1
gpgcheck=1
gpgkey=https://packages.adoptium.net/artifactory/api/gpg/key/public
EOF

# Install JDK17
yum install temurin-17-jdk

• Set JAVA_HOME & PATH variable when system is restarting

Insert the following into a new file “/etc/profile.d/java_home.sh”

export JAVA_HOME=$(readlink -f /usr/bin/java | sed "s:/bin/java::")
export PATH=$PATH:$JAVA_HOME/bin

• Restart the Server

• Insert the cacerts file in <JavaHome>/lib/security from your backup if necessary.

• Proceed with Execute Manuel Actions, Run Stages Upgrade Installer and Restart Stages.

(Manual Actions have to be done before running Upgrade Installer, make sure stages and StagesSearch service is stopped before executing )

• Reset the Stages Search index by deleting content of folder: <stages_install_folder>/stages/elasticsearch/data
• Reset Elasticsearch options by deleting/rename file: <stages_install_folder>/stages/elasticsearch/config/jvm.options
• Set the JAVA_HOME environment variable to the location where JDK 17 is installed.
  • On Windows: JAVA_HOME must be be changed in: <stages_install_folder>/stages/config.bat
  • On Linux: CONF_JAVA_HOME needs to be set in: <stages_install_folder>/stages/bin/rc.conf

* On Linux you will get the path if installed via yum by executing:

readlink -f /usr/bin/java | sed "s:/bin/java::"

Linux: execute sudo rpm -Uvh stages-…rpm or sudo yum localinstall stages-…rpm, depending on your Linux flavor

Windows: execute Stages V7.10 Windows installer in an administrative command prompt and follow the assistant steps

Linux: execute stages reload

Windows: verify that Stages and Stages Search Windows services are running