===================
Updating Repository
===================


CAUTION: You must have a tested backup of your installation
before starting the update process. If updating more than one version,
all updates must be performed in sequential order.

Your support representative can provide you with a download URL for
an updated Repository installer.

To update to the latest Repository release::

  curl '$INSTALLER_URL' > anaconda_repository.sh
  bash anaconda_repository.sh -u
  anaconda-server-db-setup --execute
  supervisorctl stop all
  supervisorctl reload
  supervisorctl start all

NOTE: To use a Repository version from 2.33.3 through 2.33.10 and Anaconda Enterprise
Notebooks with single sign-on (SSO), you must set
``USE_SERVER_BASED_SESSIONS: false`` in the Repository configuration. This
setting affects the network security properties of AEN and Repository.
Specifically, if ``USE_SERVER_BASED_SESSIONS`` is set to ``false``, and if a
new cross-site scripting (XSS) vulnerability is discovered, it could expose an
additional server fixation vulnerability. Please discuss this with your
Anaconda representative and be sure the feature is compatible with your network
requirements before setting ``USE_SERVER_BASED_SESSIONS: false``.

NOTE: As of Repository 2.33.8, the ``fs_storage_root`` configuration setting is
mandatory for local filesystem storage and the Repository server will not run
without it. You can set it with this command::

  anaconda-server-config --set fs_storage_root /opt/anaconda-server/package-storage

You may replace ``/opt/anaconda-server/package-storage`` with any location owned
by the ``anaconda-server`` user.

Please contact your Professional Support Team contact or sales person
if you have any questions or problems regarding the update.

Updating to current and previous versions
=========================================

Updating to 2.33::

    curl '$INSTALLER_URL' > anaconda_repository.sh
    bash anaconda_repository.sh -u
    anaconda-server-db-setup --execute
    supervisorctl stop all
    supervisorctl reload
    supervisorctl start all

NOTE: To use a Repository version from 2.33.3 through 2.33.10 and Anaconda Enterprise
Notebooks with single sign-on (SSO), you must set
``USE_SERVER_BASED_SESSIONS: false`` in the Repository configuration. This
setting affects the network security properties of AEN and Repository.
Specifically, if ``USE_SERVER_BASED_SESSIONS`` is set to ``false``, and if a
new cross-site scripting (XSS) vulnerability is discovered, it could expose an
additional server fixation vulnerability. Please discuss this with your
Anaconda representative and be sure the feature is compatible with your network
requirements before setting ``USE_SERVER_BASED_SESSIONS: false``.

NOTE: As of Repository 2.33.8, the ``fs_storage_root`` configuration setting is
mandatory for local filesystem storage and the Repository server will not run
without it. You can set it with this command::

  anaconda-server-config --set fs_storage_root /opt/anaconda-server/package-storage

You may replace ``/opt/anaconda-server/package-storage`` with any location owned
by the ``anaconda-server`` user.

Updating to 2.32::

    curl '$INSTALLER_URL' > anaconda_repository.sh
    bash anaconda_repository.sh -u
    anaconda-server-db-setup --execute
    supervisorctl stop all
    supervisorctl reload
    supervisorctl start all

Updating to 2.31::

    curl '$INSTALLER_URL' > anaconda_repository.sh
    bash anaconda_repository.sh -u
    anaconda-server-db-setup --execute
    supervisorctl stop all
    supervisorctl reload
    supervisorctl start all

Updating to 2.30::

    curl '$INSTALLER_URL' > anaconda_repository.sh
    bash anaconda_repository.sh -u
    anaconda-server-db-setup --execute
    supervisorctl stop all
    supervisorctl reload
    supervisorctl start all

Updating to 2.29::

    curl '$INSTALLER_URL' > anaconda_repository.sh
    bash anaconda_repository.sh -u
    anaconda-server-db-setup --execute
    supervisorctl stop all
    supervisorctl reload
    supervisorctl start all

Updating to 2.28::

    curl '$INSTALLER_URL' > anaconda_repository.sh
    bash anaconda_repository.sh -u
    anaconda-server-db-setup --execute
    supervisorctl stop all
    supervisorctl reload
    supervisorctl start all

Updating to 2.27::

    curl '$INSTALLER_URL' > anaconda_repository.sh
    bash anaconda_repository.sh -u
    anaconda-server-db-setup --execute
    supervisorctl stop all
    supervisorctl reload
    supervisorctl start all

Updating to 2.26.6:

The logging configuration can be removed.
Logs have been moved to ``$PREFIX/var/log/anaconda-server/``::

    curl '$INSTALLER_URL' > anaconda_repository.sh
    bash anaconda_repository.sh -u
    anaconda-server-db-setup --execute
    anaconda-server-config --remove LOGGING
    supervisorctl stop all
    supervisorctl start all

Updating to 2.26::

    curl '$INSTALLER_URL' > anaconda_repository.sh
    bash anaconda_repository.sh -u
    anaconda-server-db-setup --execute
    supervisorctl stop all
    supervisorctl reload
    supervisorctl start all

Updating to 2.25::

    curl '$INSTALLER_URL' > anaconda_repository.sh
    bash anaconda_repository.sh -u
    anaconda-server-db-setup --execute
    supervisorctl stop all
    supervisorctl reload
    supervisorctl start all

Updating to 2.24::

    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

Updating to 2.23::

    conda update binstar-server binstar-static anaconda-client
    anaconda-server-db-setup --execute
    supervisorctl stop all
    supervisorctl reload
    supervisorctl start all

Updating to 2.22::

    conda update binstar-server binstar-static anaconda-client
    anaconda-server-db-setup --execute
    supervisorctl stop all
    supervisorctl reload
    supervisorctl start all

Updating to 2.21::

    conda update binstar-server binstar-static anaconda-client
    anaconda-server-db-setup --execute
    supervisorctl stop all
    supervisorctl reload
    supervisorctl start all

Updating to 2.20::

    conda update binstar-server binstar-static anaconda-client
    anaconda-server-db-setup --execute
    supervisorctl stop all
    supervisorctl reload
    supervisorctl start all

Updating to 2.19::

    conda update binstar-server anaconda-client anaconda-build
    anaconda-server-db-setup --execute
    supervisorctl stop all
    supervisorctl reload
    supervisorctl start all

Updating to 2.18::

    conda update binstar-server anaconda-client anaconda-build
    anaconda-server-db-setup --execute
    supervisorctl stop
    supervisorctl reload
    supervisorctl start all

Updating to 2.17::

    conda update binstar-server anaconda-client anaconda-build
    anaconda-server-db-setup --execute
    supervisorctl stop
    supervisorctl reload
    supervisorctl start all

Updating to 2.16::

    conda update binstar-server anaconda-client anaconda-build
    anaconda-server-db-setup --execute
    supervisorctl restart all

Updating to 2.15::

    conda update binstar-server anaconda-client anaconda-build
    anaconda-server-db-setup --execute
    supervisorctl restart all

Updating to 2.14::

    conda update binstar-server anaconda-client anaconda-build
    anaconda-server-db-setup --execute
    supervisorctl restart all

Updating to 2.13::

    conda update binstar-server anaconda-client anaconda-build
    anaconda-server-db-setup --execute
    anaconda-server-config --config-file /etc/binstar/config.yaml --set LABEL_NAME "'channel'"
    supervisorctl restart all

Updating to 2.12::

    conda update binstar-server anaconda-client anaconda-build
    anaconda-server-db-setup --execute
    supervisorctl restart all

Updating to 2.9::

    conda update binstar-static binstar-server cas-mirror
    anaconda-server-db-setup --execute
    supervisorctl restart all

Updating to 2.8::

    conda update binstar-static binstar-server cas-mirror
    anaconda-server-db-setup --execute
    supervisorctl restart all

Updating to 2.6.0::

    conda update binstar-server
    conda install cas-mirror

Updating to 2.5.1::

    conda update binstar-server

Updating to 2.3::

    conda update binstar-server
    conda install cas-mirror

Updating to 2.2::

    conda update binstar-server
