Version-Specific Upgrades

Warning

The upgrade script must be executed from within the install directory. Running ./install.sh -u from any other location will result in a failed upgrade.

cd install
./install.sh -u

Tip

If the cluster has been intentionally stopped before the upgrade, you can bypass the index compatibility check by passing the --skip-check flag:

./install.sh -u --skip-check

Use this only when you have already verified that all cluster indices are compatible with the target version.

Upgrade from Version 7.9.0

Standard upgrade path with no special migration steps.

./install.sh -u

Post-upgrade verification:

  • Verify all services are running:

systemctl status logserver logserver-gui logstash intelligence intelligence-scheduler alert license-service skimmer e-doc --no-pager

  • Test new features accessibility

  • Check log processing continuity

Upgrade from Version 7.8.0

Preferred Upgrade Steps for 7.8.0

  1. Run upgrade script:

./install.sh -u

Required Post Upgrade from Version 7.8.0

Breaking and major changes

  • Keystore migration: The default password store has been renamed from passstore to logserver.keystore. Run the password utility to migrate:

/usr/share/elasticsearch/utils/logserver-password-util.sh update_services --yes --no-restart --quiet

  • Java update: OpenJDK 17 is now required. The upgrade script sets the correct Java version automatically. Verify after upgrade:

java -version

  • Backup scope expanded: The configuration-backup.sh script now includes additional configuration files for license-service, intelligence, and logserver-store. Run a post-upgrade backup to capture the full scope:

bash /usr/share/elasticsearch/utils/configuration-backup.sh

Post-upgrade verification:

systemctl status logserver logserver-gui logstash intelligence intelligence-scheduler alert license-service skimmer e-doc --no-pager

Upgrade from Version 7.7.0

Standard upgrade path with minimal changes.

./install.sh -u

Post-upgrade verification:

  • Test new features accessibility

  • Verify all services functionality

  • Check log processing continuity

Upgrade from Version 7.6.0

Preferred Upgrade Steps for 7.6.0

  1. Run upgrade script:

./install.sh -u

Required Post Upgrade from Version 7.6.0

Breaking and major changes

  • Archive: Changed the default archives location to /usr/share/logserver-gui/data/archive/archives/ - please adjust external storage resource to this path [if used]. To customize the archive.archivefolderpath directive edit the /etc/logserver-gui/logserver-gui.yml file and restart the logserver-gui service.

sed -i 's|archive.archivefolderpath:.*|archive.archivefolderpath: "/usr/share/logserver-gui/data/archive/archives/"|' /etc/logserver-gui/logserver-gui.yml

systemctl restart logserver-gui

  • Network-Probe: Move required directives from /opt/license-service/license-service.conf to /opt/license-service/license-service.conf.rpmnew and replace license-service.conf then restart the license-service.

Upgrade from Version 7.5.0

Preferred Upgrade Steps for 7.5.0

  1. Run upgrade script:

./install.sh -u

Required Post Upgrade from Version 7.5.0

Breaking and major changes

  • User “logserver” will no longer be able to log into GUI. Use “admin” user instead. The update process will print the generated password for this new user. In case you have missed it you can run the following command on your main client node to recover the password:

/usr/share/elasticsearch/utils/logserver-password-util.sh get_password -u admin -q

Upgrade from Version 7.4.2 / 7.4.3

Preferred Upgrade Steps for 7.4.2 / 7.4.3

  1. Run upgrade script:

./install.sh -u

Required Post Upgrade from Version 7.4.2 / 7.4.3

Breaking and major changes

  • Network-Probe replaces Logserver-Probe: follow the steps below.

LOGSERVER-PROBE:

  • Backup /etc/logserver-probe

cp -r /etc/logserver-probe /backup/logserver-probe-7.4-backup/

  • Uninstall old version:

Warning

This command permanently removes Network Probe configuration and data. Ensure you have a backup before proceeding.

yum versionlock delete logserver-probe-oss-7.17.11-1
yum remove logserver-probe-oss
rm -rf /etc/logserver-probe /var/lib/logserver-probe /usr/share/logserver-probe

  • Install the current Input Layer from scratch using sudo ./install.sh -i - Network-Probe Section

  • Restore from backup custom pipelines to /etc/logserver-probe/conf.d/

cp /backup/logserver-probe-7.4-backup/conf.d/* /etc/logserver-probe/conf.d/

ENERGYLOGSERVER

  • ./install.sh checks indexes compatibility before upgrading. If any problems exist, please contact product support to guide you through the upgrade process.

  • Move required directives from /etc/logserver/logserver.yml to /etc/logserver/logserver.yml.rpmnew and replace logserver.yml.

mv /etc/logserver/logserver.yml /etc/logserver/logserver.yml.backup
mv /etc/logserver/logserver.yml.rpmnew /etc/logserver/logserver.yml

LOGSERVER-GUI

  • Move required directives from /etc/logserver-gui/logserver-gui.yml to /etc/logserver-gui/logserver-gui.yml.rpmnew and replace logserver-gui.yml.

mv /etc/logserver-gui/logserver-gui.yml /etc/logserver-gui/logserver-gui.yml.backup
mv /etc/logserver-gui/logserver-gui.yml.rpmnew /etc/logserver-gui/logserver-gui.yml

  • Clear browser cache on client side.

LICENSE-SERVICE

  • If required, configure logserver_connection in /opt/license-service/license-service.conf.

  • Old configuration should be in /opt/license-service/license-service.conf.rpmsave. Do not replace license-service.conf with license-service.conf.rpmsave

EMPOWERED-AI (7.4.3 only)

  • Backup .intelligence_models, .intelligence_rule_configuration indices - if needed

  • Stop services:

systemctl stop empowered-ai

  • Delete old indices:

curl -XDELETE '127.0.0.1:9200/.intelligence_rule_configuration,.intelligence_models,.intelligence_results' -u $USER:$PASSWORD

  • Start services:

systemctl start empowered-ai

Upgrade from Version 7.4.1

Preferred Upgrade Steps for 7.4.1

  1. Run upgrade script:

./install.sh -u

No additional post-upgrade steps are required for this version.

Upgrade from Version 7.4.0

Preferred Upgrade Steps for 7.4.0

  1. Run upgrade script:

./install.sh -u

No additional post-upgrade steps are required for this version.

Upgrade from Version 7.3.0

Preferred Upgrade Steps for 7.3.0

  1. Run upgrade script:

./install.sh -u

Required Post Upgrade from Version 7.3.0

ENERGYLOGSERVER

  • ./install.sh checks indexes compatibility before upgrading. If any problems exist, please contact product support to guide you through the upgrade process.

  • Move required directives from /etc/logserver/logserver.yml to /etc/logserver/logserver.yml.rpmnew and replace logserver.yml.

LOGSERVER-GUI

  • Move required directives from /etc/logserver-gui/logserver-gui.yml to /etc/logserver-gui/logserver-gui.yml.rpmnew and replace logserver-gui.yml.

  • Clear browser cache on client side.

LOGSERVER-PROBE

  • Backup /etc/logserver-probe

  • Uninstall old version:

yum versionlock delete logserver-probe-oss-7.17.11-1
yum remove logserver-probe-oss
rm -rf /etc/logserver-probe /var/lib/logserver-probe /usr/share/logserver-probe

  • Install the current Input Layer from scratch using sudo ./install.sh -i - Network-Probe Section.

  • Restore from backup custom pipelines to /etc/logserver-probe/conf.d/

LICENSE-SERVICE

  • If required, configure logserver_connection in /opt/license-service/license-service.conf.

  • Old configuration should be in /opt/license-service/license-service.conf.rpmsave. Do not replace license-service.conf with license-service.conf.rpmsave

EMPOWERED-AI Migration (7.3.0 only):

curl -X POST "localhost:9200/_snapshot/backup_repo/intelligence_backup" -H 'Content-Type: application/json' -u $USER:$PASSWORD -d'
{
  "indices": ".intelligence_models,.intelligence_rule_configuration"
}'

systemctl stop empowered-ai
yum remove empowered-ai

./install.sh -u