Tutor upgradation

I want to upgrade. tutor to latest version numeg(v14) from juniper(v10).
As regisb. suggested first I need to upgrade to lialc(v12).

But i am not sure which upgradation method i need use.

   pip install --upgrade "tutor[full]==12.0.0"
   tutor local quickstart
   and 
   pip install --upgrade "tutor[full]==14.0.0"
   tutor local quickstart

Or

   pip install --upgrade "tutor[full]==12.0.0"
   tutor local upgrade --from juniper
   tutor local quickstart
   and 
   pip install --upgrade "tutor[full]==14.0.0"
   tutor local upgrade --from lilac
   tutor local quickstart

Hi @chethan4046,

Upgrading from previous versions isn’t so simple. You have to upgrade incrementally. Also, I seem to recall seeing a note that you have to upgrade using the installation method you used the first time (curl or pip). Since you have Juniper, you most likely used curl.

I wrote a set of instructions for my team starting at version 12 that will provide a starting point.

  • You’ll have to use the same process to go from version 10 to 11 to 12.
  • You will want to read the archived Tutor discuss site if you run into problems upgrading from version 10 to 11. Any problem you encounter will probably be documented.
  • I recommend making incremental backups in case the upgrade fails (prevents you from having to start back at version 10).

See upgrade instructions here: https://docs.tutor.overhang.io/install.html#upgrading

  1. Get the Tutor version and make a backup. We’ll start with version 12.

    This example uses version 12.1.6:

    sysadmin@edx:~$ tutor --version
    tutor, version 12.1.6
    

    Create the backup

    VERSION=12.1.6
    tutor local stop
    sudo mkdir -p /var/tutor-backup/$VERSION
    sudo rsync -ar "$(tutor config printroot)"/ /var/tutor-backup/$VERSION
    

    Download and upgrade to the most recent Tutor version 12 (Lilac).

    • Find the version on GitHub to get the Open edX.
      https://github.com/overhangio/tutor/releases?q=v12.1&expanded=true

    • For version 12, it is 12.2.0.

      sudo curl -L "https://github.com/overhangio/tutor/releases/download/v12.2.0/tutor-$(uname -s)_$(uname -m)" -o /usr/local/bin/tutor
      sudo chmod 0755 /usr/local/bin/tutor
      
      
    • Process the upgrade normally (no need to rebuild images now)

      tutor local stop
      tutor local quickstart # for local installations
      
    • Login to verify that the platform works as expected.

    • Back up the instance for version 12.2.0.

      VERSION=12.2.0
      tutor local stop
      sudo mkdir -p /var/tutor-backup/$VERSION
      sudo rsync -ar "$(tutor config printroot)"/ /var/tutor-backup/$VERSION
      
      
  2. Download and upgrade Tutor version 13 (Maple)

    • Download the most recent Tutor version for Maple

      sudo curl -L "https://github.com/overhangio/tutor/releases/download/v13.3.1/tutor-$(uname -s)_$(uname -m)" -o /usr/local/bin/tutor
      sudo chmod 0755 /usr/local/bin/tutor
      
    • Process the upgrade from Lilac to Maple normally

      tutor local stop
      tutor local quickstart # for local installations
      
      • If the process does not automatically detect the new version (perhaps because you ran tutor config save), then you have to to the system process the upgrade manually

        tutor local stop
        tutor config save
        tutor local upgrade --from=lilac
        tutor local quickstart
        
    • Login to verify the site loads (some features will not work without MFE). Then, load the MFE.

      tutor plugins enable mfe
      tutor plugins enable forum
      tutor config save
      tutor local quickstart
      

      Back up the instance if the upgrade was processed normally.

      VERSION=13.3.1
      tutor local stop
      sudo mkdir -p /var/tutor-backup/$VERSION
      sudo rsync -ar "$(tutor config printroot)"/ /var/tutor-backup/$VERSION
      
  3. Download and upgrade to Tutor version 14 (Nutmeg)

  4. Enable the custom-settings.yml plugin and fix any problems

  5. (optional) Clean up all build caches and old images.

    This command removes all previous images and build caches. Ensure that Tutor is running so that version 14 images are not also removed.

    tutor local start -d
    docker system prune --all
    tutor local stop
    tutor local start -d
    
    
  6. Lastly, rebuild the images for the latest version of Tutor to include the XBlocks

    tutor config save
    tutor images build all
    tutor local quickstart
    
    
  7. Save the current instance if everything works

    • Create a temporary backup of the instance if the upgrade was processed normally.

      VERSION=14.0.1
      tutor local stop
      sudo mkdir -p /var/tutor-backup/$VERSION
      sudo rsync -ar "$(tutor config printroot)"/ /var/tutor-backup/$VERSION