Update#

Periodically, updates to the Inrupt Enterprise Solid Server (ESS) components are released. Follow the instructions below to update.

Procedure#

You can use the installer scripts to update. If you have not already, download the installer scripts.

  1. Go to your ESS directory.

  2. If you have not already, download the installer scripts.

    curl -O https://download.software.inrupt.com/<TOKEN>/release/raw/names/ESS-Scripts/versions/<VERSION>/ess-reference-scripts.zip

  3. Once downloaded, unzip the file:

    unzip ess-reference-scripts.zip

  4. Go into the deployment directory:

    cd deployment

  5. Create the <environment>.config, where <environment> is your environment value (such as dev, testing, etc.):

    Tip

    If the <environment>.config already exists (i.e., your current ESS deployment was installed using the scripts), you can just modify the ESS_VERSION in the file.

    If the <environment>.config file does not exist (or you wish to recreate the file), run the following command, substituting your environment (such as dev, testing, etc.) for <environment>:

    ./scripts/installer.sh -p minikube -c init -e <environment>

    When prompted, enter the appropriate values for your deployment.

  6. Download and build your ESS configuration file, substituting your environment (such as dev, testing, etc.) for <environment>. The operation also creates a backup of your current deployment in the .backup directory.

    ./scripts/installer.sh  -e <environment> -p minikube -s ess -c build

  7. Upgrade to the new version, substituting your environment (such as dev, testing, etc.) for <environment>:

    ./scripts/installer.sh -e <environment> -p minikube -s ess -c install

Rollback#

When upgrading, the installer.sh creates a backup of your current deployment in the .backup directory.

If you need to rollback the update to the previous state, you can run the ess-rollback.sh script to restore to the backup version:

./scripts/common/ess-rollback.sh <environment> .backup/<ess-backup-filename>