Skip to main content

HAP Microservices Upgrade

Notes

  • Additional Operation Check: Before upgrading, be sure to carefully review the Version Release History page. If any versions marked “Includes Additional Operations” exist between your current version and the target version, follow the corresponding guidance to complete the required operations.

  • Authorization Validity Check: Ensure that your license key remains within the “Upgrade Service” validity period. If the release date of the target major version is later than your license expiration date, forcing an upgrade will trigger system restriction prompts and cause your license to automatically downgrade to the free edition. It is recommended to confirm the compatibility between the version release date and license validity before proceeding with the upgrade.

1. Pulling the Image​

Pull the microservice application image of the target version on your server based on its architecture (Offline Package Download).

docker pull registry.cn-hangzhou.aliyuncs.com/mdpublic/mingdaoyun-hap:7.2.4

2. Modify Configuration​

Edit the configuration file /data/mingdao/script/docker-compose.yaml, and update the image version tag for the hap service to the target version:

# Example configuration snippet
image: registry.cn-hangzhou.aliyuncs.com/mdpublic/mingdaoyun-hap:7.2.4

3. Restarting Services​

Execute the script below from the root directory of the manager to restart services (if upgrading multiple services simultaneously, you may execute this command once after modifying all configurations).

bash ./service.sh restartall
If you forget the path to the service.sh file, click to view the search command
find / -path /proc -prune -o -name "service.sh" -print

Wait for the command to complete execution. Once all services are ready, the upgrade process is complete.