When updating from older versions, each version must be installed in order, without skipping any interim releases. Skipping a version during upgrade will prevent Anaconda Repository from working.
NOTE: Anaconda Repository, Anaconda Server and Binstar Server are the same product under different names as name changes occurred with different versions. The current name is Anaconda Repository.
CAUTION: You must have a verified backup before you start.
For versions prior to 2.18:
If your binstar-server version is below 2.18, run:
conda update binstar-server binstar-static
conda install cas-mirror anaconda-client anaconda-build
anaconda-server-db-setup --execute
anaconda-server-config --config-file /etc/binstar/config.yaml --set LABEL_NAME "'channel'"
anaconda-server-install-supervisord-config.sh
supervisorctl stop all
supervisorctl reload
supervisorctl start all
If you encounter the error unix:///tmp/supervisor.sock no such file when running the supervisorctl commands you need to specify the supervisord.conf file:
supervisord -c /home/binstar/miniconda/etc/supervisord.conf
NOTE: Newer license version is needed for binstar-server version prior to 2.18. Please contact support@anaconda.com to generate the new license.
For version 2.18 to 2.24:
1.Run:
conda update binstar-server binstar-static anaconda-client
anaconda-server-db-setup --execute
anaconda-server-install-supervisord-config.sh
supervisorctl stop all
supervisorctl reload
supervisorctl start all
If you encounter the error unix:///tmp/supervisor.sock no such file when running the supervisorctl commands you will need to specify the supervisord.conf file:
supervisord -c /home/anaconda-server/miniconda/etc/supervisord.conf
2. Now, you can follow the steps in Update using the new anaconda_repository.sh installer section.
Update using the new anaconda_repository.sh installer:
1. After completing the above steps for your upgrade, you can now download the new installer, please contact support@anaconda.com for the most recent installer URL:
curl '$INSTALLER_URL' > anaconda_repository.sh
2. Stop the services running under miniconda so that they can be switched to the new installation path. This is necessary only when switching from the old installer to the new shell installer:
supervisorctl stop all
3. Then remove the entire export PATH from your /home/binstar/.bashrc file. It should look like export PATH='/home/binstar/miniconda/bin:$PATH'.
4. If you want to remove the @reboot line in the crontab referring to the miniconda path, the new path will be added after the installer is run.
crontab -e
5. Now run the shell installer script:
anaconda_repository.sh
anaconda-server-db-setup --execute
anaconda-server-install-supervisord-config.sh
supervisorctl stop all
supervisorctl reload
supervisorctl start all
NOTE: If you get bash: conda: command not found, make sure the path is exported, export PATH='/home/binstar/repo/bin:$PATH' and run source .bashrc.
6. If you encounter the error unix:///tmp/supervisor.sock no such file when running the supervisorctl commands you need to specify the supervisord.conf file which has moved from the previous steps:
supervisord -c /home/anaconda-server/repo/etc/supervisord.conf
7. Now, you can test that your update is successful by going to the Repository UI and navigating to Admin -> Deployment. You should see the new version listed.
8. If the update is successful, you can remove the old miniconda directory:
rm -rf /home/anaconda-server/miniconda
Or:
rm -rf /home/binstar/miniconda