Manual Upgrade Steps

When using Lab Management is not possible, you may manually upgrade AIQ, but must take care to maintain your setting files.

  1. Remote into your Appvance IQ Controller (or Test Node)

  2. Stop the Appvance IQ services

    1. Mac

      1. Look for the running Appvance processes

        ps -ef | grep java

      2. Note the return process IDs related to AIQ and use sudo kill to stop the processes. For example:

        sudo kill 23221 20563 20236

      3. If you run the ps command again, the Appvance processes should no longer exist

    2. Windows

      1. Using Task Scheduler: If using Task Scheduler to launch the process, you may also stop the processes using Task Scheduler

      2. Using Task Manager: Locate three parent java processes running AIQ, right-click and kill each process

      3. Using Process Explorer: Locate the parent most java process running AIQ, right-click and kill the selected and all child progresses

  3. Create a backup of the following files your current aiq_distribution folder

    1. aiq_distribution/Appvance.properties

    2. aiq_distribution/Tests.properties

    3. aiq_distribution/TestNode/etc/realm.properties

    4. aiq_distribution/TestNode/etc/appvance.jks

    5. aiq_distribution/<licenseFile>

  4. Download and extract the AIQ zip archive.

  5. Replace the aiq_distribution folder with the extracted aiq_distribution folder

  6. Replace the backed up files above in the newly updated aiq_distribution folder

  7. Download extract the Java 11-based zip of GraalVM 21.0.3 Community Edition (unless already installed) from

    1. Mac

      https://github.com/graalvm/graalvm-ce-builds/releases/download/vm-21.3.0/graalvm-ce-java11-darwin-amd64-21.3.0.tar.gz

    2. Windows

      https://github.com/graalvm/graalvm-ce-builds/releases/download/vm-21.3.0/graalvm-ce-java11-windows-amd64-21.3.0.zip

  8. Move the extracted graalvm-ce-java11-21.3.0 folder to the following path and ensure the JAVA_HOME environment variable points to the proper path.
    Need exact steps? Install and Configure GraalVM 11

    For example:

    1. Mac

      echo $JAVA_HOME
/Library/Java/JavaVirtualMachines/graalvm-ce-java11-21.3.0/Contents/Home

    2. Windows

      echo %JAVA_HOME%
C:\Program Files\graalvm\graalvm-ce-java11-21.3.0

  9. Confirm the PATH environment variable does not contain paths for any OpenJDK other than that of GraalVM 11. If missing from PATH, add the GraalVM bin folder to the PATH environment variable.
    For example:

    1. Mac

      /Library/Java/JavaVirtualMachines/graalvm-ce-java11-21.3.0/Contents/Home/bin

    2. Windows

      C:\Program Files\graalvm\graalvm-ce-java11-21.3.0\bin

  10. You may now start Appvance IQ