Skip to content

Standalone Environment Version Upgrade

In a standalone environment, the version upgrade process generally follows the flow of stopping the old version service -> installing the new version -> updating dependencies -> starting the new version service. Detailed upgrade steps are as follows:

  1. Obtain the new version installation package and extract it to the installation device.

  2. Stop the old version service.
    Switch to the runtime user and execute the stop service command in the installation directory. Refer to the example below, where the runtime username is hengshi and the old version installation path is /opt/hengshi.

sh
sudo su - hengshi                 # Switch to the runtime user
cd /opt/hengshi                   # Navigate to the installation target directory
bin/hengshi-sense-bin stop all    # Stop the old version service
  1. Install the new version. Execute the new version installation command in the extracted package directory. Refer to the example below for operation.
sh
sudo su - hengshi  # Switch to the runtime user
cd ~/pkgs/hengshi-sense-[version] # Navigate to the extracted target directory

# Install the new version. The script will automatically back up the data from the previous version. 
# In special cases where backup is not required, confirm with HENGSHI technical support and use the parameter -s t to skip the backup.
./hs_install -p /opt/hengshi

The following message indicates that the new version has been successfully installed:

sh
SUCCESSED! installed to xxxxx

Note

If you are not using HENGSHI's metadb, ensure that the variable export HS_PG_IF_EXTERNAL=false is set to true. You can modify this in the configuration file conf/hengshi-sense-env.sh. During the upgrade process, stopping this service will not be required.

  1. Update system dependencies. This operation requires the user to have sudo permissions during execution. Once successful, sudo permissions can be revoked. Refer to the example below for operation.
sh
sudo su - hengshi             # Switch to the runtime user
cd /opt/hengshi               # Navigate to the installation target directory
bin/hengshi-sense-bin init-os all  # Initialize OS

Note

For offline environments, use bin/hengshi-sense-bin init-os all-offline to skip online dependency updates.

  1. Start the new version service. Execute the new version start command in the installation directory.
sh
sudo su - hengshi             # Switch to the runtime user
cd /opt/hengshi               # Navigate to the installation target directory
bin/hengshi-sense-bin start all   # Start the new version service

When the service starts successfully, the following message will be displayed, and the module status will be IS ACTIVE:

shell
 IS ACTIVE! : [metadb] @127.0.0.1:5301/hengshi
 IS ACTIVE! : [engine] @localhost:5302/hengshi
 IS ACTIVE! : [minio] minio server /opt/hengshi/minio-data
 IS ACTIVE! : [redis] 127.0.0.1@5307
 IS ACTIVE! : [syslog] syslog-ng --no-caps --module-path=/opt/hengshi/lib/syslog-ng/lib/syslog-ng -f /opt/hengshi/conf/syslog-ng.conf -p /opt/hengshi/logs/syslog-ng.pid -R /opt/hengshi/logs/syslog-ng.persist -c /opt/hengshi/logs/syslog-ng.ctl
 IS ACTIVE! : [apmserver] /opt/hengshi/lib/apm-server/apm-server -c /opt/hengshi/conf/apm-server.yaml
 IS ACTIVE! : [hengshi] jar /opt/hengshi/lib/bootstrap-6.0.0.jar
 IS ACTIVE! : [monit] /opt/hengshi/lib/monit/bin/monit -c /opt/hengshi/conf/monitrc
  1. Upgrade complete. Access the service address via a browser to use the HENGSHI SENSE service.

Rollback

The main operation of decompression rollback is to restore the contents of the most recent backup archive in the backup directory to the deployment location (including: program, configuration, data).

  1. Prepare rollback files
    First, navigate to the backup directory and select the most recent archive for decompression. Be sure to confirm the timestamp of the archive. In the example, the archive in the hengshi-20210819163228 directory is selected for decompression, with a timestamp of 2021-08-19_16:32:28.

  2. Rollback program and data

shell
cd /opt/hengshi
bin/hengshi-sense-bin stop all
tar -xf backup/hengshi-20210819163228/bin_conf_lib.tar.gz
mv pg_data pg_data.bak
bin/hengshi-sense-bin init metadb  
bin/hengshi-sense-bin start metadb  
bin/dbrestore.sh -m metadb -l ${PWD}/backup/hengshi-20210819163228 -t metadb_backup.2021-08-19_16-33-14[.tar.gz]  
bin/hengshi-sense-bin stop metadb
bin/hengshi-sense-bin start all
  1. Clean up old data
    After rollback, and upon confirming no issues through business checks, execute the following cleanup operations:
shell
cd /opt/hengshi
rm pg_data.bak -rf
cd backup/hengshi-20210819163228 && rm metadb_backup.2021-08-19_16-33-14 -rf

User Manual for Hengshi Analysis Platform