Updating indi allsky - aaronwmorris/indi-allsky GitHub Wiki

General

indi-allsky upgrades are rolling releases. You should be able to upgrade to the latest release of indi-allsky from any previous release.

Note: Upgrading INDI is not necessary when upgrading indi-allsky

Unattended Upgrade

indi-allsky now has an unattended upgrade option that can perform a code upgrade with no interaction from the user.

Navigate to System -> Utilities [tab] and select Upgrade indi-allsky. The upgrade may require up to 5 minutes to complete. During the upgrade, the indi-allsky capture process will be shutdown and restarted (if it was running) once the upgrade is complete. A notification will be shown in the web interface once the upgrade has completed.

The unattended upgrade runs as an out-of-band systemd service unit which allows it to function outside the indi-allsky system processes.

  • Notes
    • The unattended upgrade will only function when a non-authenticated GitHub checkout has been used (https://).
    • The upgrade will only proceed if you are on the main branch.
    • Any code modifications prevent the unattended upgrade from running.

Manual Unattended Upgrade

You may run the unattended upgrade manually if the GitHub checkout requires an SSH key for authentication or you just want to monitor the process.

./misc/unattended_upgrade.sh

Normal upgrade

  1. Navigate to the current git clone

     cd indi-allsky
    
  2. Stop indi-allsky & gunicorn

     systemctl --user stop indi-allsky
    
  3. Pull the latest changes via git

     git pull origin main
    
  4. Re-run setup.sh to configure system. This step is not always required, the indi-allsky service will usually indicate when it is necessary.

     ./setup.sh
    
    • If you get a message about repositories not being valid, you may have to re-enable NTP time sync

        sudo timedatectl set-ntp true
      
  5. Restart indi-allsky

     systemctl --user start indi-allsky
    

Manual upgrade

Note: This does not upgrade Python modules. If you have problems with modules, recommend using the setup.sh script.

  1. Navigate to the current git clone

     cd indi-allsky
    
  2. Stop indi-allsky & gunicorn

     systemctl --user stop indi-allsky
     systemctl --user stop gunicorn-indi-allsky
    
  3. Pull the latest changes via git

     git pull origin main
    
  4. Upgrade the database schema

     flask db revision --autogenerate
     flask db upgrade head
    
  5. Increment the config version level

     ./config.py edit
     (save the config with no changes)
    
  6. Restart indi-allsky

     systemctl --user start indi-allsky
    

Web-only upgrade

  1. Navigate to the current git clone

     cd indi-allsky
    
  2. Pull the latest changes via git

     git pull origin main
    
  3. Re-run web_only_setup.sh to configure system

     ./misc/web_only_setup.sh
    

Docker upgrade path

https://github.com/aaronwmorris/indi-allsky/wiki/Docker#updating-indi-allsky

Rename master branch to main

The master branch was renamed to main on Feb 17, 2023. The following commands may be used to rename the branch on your local clone.

git branch -m master main
git fetch origin
git branch -u origin/main main
git remote set-head origin -a