Upgrade versions older or equal to 25

Owned by Anton Teroshyn
Last updated: Sept 10, 2024 by Michael Litner
2 min read

Download release installer:

https://accelarioapp.s3.eu-central-1.amazonaws.com/release-installer/release-installer.zip

It only supports upgrading to versions starting from 27+.

Prepare current app to update

In case the version is less or equal to 25 you need to ensure that the repository db version is defined properly.

  1. Check the Current Repository Database Version:

    • Navigate to the Swagger interface app_url/api/swagger

    • Use the GET /settings/properties/db_version endpoint to retrieve the current repository database version.

  2. Conditionally Add the Database Version:

    • If the GET request for db_version returns no value (i.e., the parameter is not set or is empty), you'll need to add this parameter manually.

    • Make a POST request to /v1/settings/properties/db_version with the required value for the database version. Ensure that the payload for this POST request correctly specifies the new repository database version value.

  3. Verify the Parameter is Set:

    • After setting the parameter, verify that db_version has been correctly added by making another GET /settings/properties/db_version request.

    • Confirm that the returned value matches the repository database version you just set.

  4. Proceed with the Update:

    • Once the repository database version parameter is confirmed, shut down the server.

    • Continue with the subsequent steps of your installation or upgrade process.

Upgrade to the new Release

  1. Before install new release stop all running instances manually using command  
    sudo kill -9 $(pgrep -f java)

  2. Determine the location of the acc-server-1.0-SNAPSHOT.jar directory:
    Locate the directory where the acc-server-1.0-SNAPSHOT.jar file is stored and is being executed - this directory will be called APP directory.
    A parent directory of the APP directory will be called ROOT directory

  3. Rename the APP directory to current

  4. Copy the release-installer.jar and the new release ZIP file into the ROOT directory

  5. Ensure your ROOT directory tree looks like this:

    any_name_for_root_directory/ ├─ release-installer.jar ├─ virtualization-Release_27_0.zip ├─ current/ └─ archive/ (optional)

  6. Run the upgrade process

    • Execute the commands
      sudo chmod +x release-installer.jar
      sudo java -jar release-installer.jar

    • If there are multiple ZIP files under the ROOT directory then you need to define which one exactly you would like to install
      sudo java -jar release-installer.jar virtualization-Release_27_0.zip