Upgrading from 7.0.0 to 7.1.0

Introduction

This document describes the necessary steps when upgrading Infinite Scale from release 7.0.0 to 7.1.0.

Read the important notes in the Upgrading Infinite Scale documentation before you start.
Check below, if you are affected by breaking changes and prepare all steps mentioned before you start the upgrade.

Upgrade Steps

  1. Download and install Infinite Scale
    Do not start it after downloading the binary or image!

  2. Shut down the Infinite Scale instance

  3. We strongly recommend doing a backup

  4. Reconfigure the deployment

  5. Manage Breaking Changes

  6. Start Infinite Scale

1. Download and Install Infinite Scale

Download and install Infinite Scale via:

1.1. Binary

Follow the Installation section of the bare metal deployment example.

1.2. Image Based Deployments

  • Issue the following command to download the new image:

    docker pull owncloud/ocis:7.1.0

2. Shut Down the Infinite Scale Instance

Depending how you deployed Infinite Scale, you need to shut it down differently.

  • Binary
    For binary deployments, do a graceful shutdown as described in Stopping Infinite Scale.

  • docker run
    For depoyments using docker run do a graceful shutdown as described in Stop a Running Container.

  • docker compose
    For deployments using docker compose do a graceful shutdown as described in Stop the Deployment.

  • Any other image based deployment
    For any other image based deployment, shut down Infinite Scale according the vendors deployment description.

3. Backup of Infinite Scale

See the Backup Considerations and the Backup documentation for more details.

4. Reconfigure the Deployment

Reconfigure the deployment to use the new image:

  • For binary, nothing extra needs to be done

  • When using docker run

    • Update the image version used in the docker run command.

  • When using docker compose

    • Update every compose file where the ocis image is referenced accordingly.

    • If you have used the deployment examples either for Local Production Setup or Deployment on Hetzner, read the Updating and Upgrading section of those pages carefully.

5. Manage Breaking Changes

  • There are no breaking changes in Infinite Scale 7.1

6. Reconfigure web Office Document Deployments

The following steps are based on the Local Production Setup deployment example. The steps are identical for the Deployment on Hetzner.

  • Backup the the base folder containing the existing deployment example by renaming it.
    You will need your configuration details with the new example.

  • Follow the Download and Transfer Example to get the new deployment and extract it as described in the following section of the guide.

  • Reconfigure the new .env file based on settings made in the .env file of the backup.

7. Start Infinite Scale

When you have finished upgrading, you now can start Infinite Scale as usual.

For any deployment used, you now can delete/remove old binaries or images/containers.

Changed or Added CLI Commands

See the Changed or Added CLI Commands document for details.