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.

    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):

    ./scripts/installer.sh -p minikube -c init
    

    When prompted, enter the appropriate values for your deployment.

    If the <environment>.config file does not exist (or you wish to recreate the file):

    ./scripts/installer.sh -p aws -c init
    

    When prompted, enter the appropriate values for your deployment.

  6. Download and build your ESS AWS configuration file. The operation creates a backup of your current deployment in the .backup directory.

    ./scripts/installer.sh -e dev -p minikube -s ess -c build
    
    ./scripts/installer.sh -e <environment> -p aws -s ess -c build
    
  7. Upgrade to the new version:

    ./scripts/installer.sh -e dev -p minikube -s ess -c install
    
    ./scripts/installer.sh -e <environment> -p aws -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>