Upgrade
=======

To upgrade, download the official release from the `Enterprise Steam download page <https://s3.amazonaws.com/steam-release/enterprise-steam/latest-stable.html>`__.

Backup
------

Backing up your Enterprise Steam installation before an upgrade is optional but highly recommended. Please backup the ``/opt/h2oai/steam/data`` folder. To revert to a previous version, reinstall that version and restore the backup.

Upgrade Enterprise Steam service
--------------------------------

1. Install the Enterprise Steam package.
 
 .. tabs::

    .. group-tab:: RPM

	 .. substitution-code-block:: bash

		yum install steam-|version|.x86_64.el6.rpm

    .. group-tab:: DEB 

	 .. substitution-code-block:: bash

		sudo dpkg -i steam-|version|.x86_64.deb

 **Note**: There is no need to stop the service before upgrading or restart the service after upgrading. Enterprise Steam will restart automatically.

2. Validate that the Enterprise Steam service is running.

 .. tabs::
   .. group-tab:: RHEL 6/CentOS 6

	.. code-block:: bash

		sudo /etc/init.d/steam status

   .. group-tab:: RHEL 7/CentOS 7

	.. code-block:: bash

		sudo systemctl status steam

   .. group-tab:: Ubuntu

	.. code-block:: bash

		sudo service steam status

For troubleshooting, please review the logs (``cat /opt/h2oai/steam/log/steam.log``).

Upgrade Python/R clients
------------------------

After upgrading Enterprise Steam, users of Python and R need to upgrade their Steam API clients. See the `Enterprise Steam download page <https://s3.amazonaws.com/steam-release/enterprise-steam/latest-stable.html>`__.

.. tabs::
   .. group-tab:: Python

	.. substitution-code-block:: bash

		pip install h2osteam-|version|-py2.py3-none-any.whl

   .. group-tab:: Conda Python 2.7 

	.. substitution-code-block:: bash

		conda install h2osteam-|version|-py2.py27_0.tar.bz2

   .. group-tab:: Conda Python 3.6 

	.. substitution-code-block:: bash

		conda install h2osteam-|version|-py2.py36_0.tar.bz2

   .. group-tab:: Conda Python 3.7 

	.. substitution-code-block:: bash

		conda install h2osteam-|version|-py2.py37_0.tar.bz2

   .. group-tab:: R

	.. substitution-code-block:: bash

		R CMD INSTALL h2osteam_|version|.tar.gz