Upgrade
=======

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

Upgrade on Hadoop
-----------------

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:`yum install steam-|version|.x86_64.el6.rpm`

    .. group-tab:: DEB 

	 :substitution-code:`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.

    .. code-block:: bash

        sudo systemctl status steam


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:`pip install h2osteam-|version|-py2.py3-none-any.whl`

   .. group-tab:: Conda Python 2.7 

	:substitution-code:`conda install h2osteam-|version|-py2.py27_0.tar.bz2`

   .. group-tab:: Conda Python 3.6 

	:substitution-code:`conda install h2osteam-|version|-py2.py36_0.tar.bz2`

   .. group-tab:: Conda Python 3.7 

	:substitution-code:`conda install h2osteam-|version|-py2.py37_0.tar.bz2`

   .. group-tab:: R

	:substitution-code:`R CMD INSTALL h2osteam_|version|.tar.gz`

Upgrade on Kubernetes
---------------------

Find the Enterprise Steam Deployment name. Make sure to search in the correct namespace.
In this example we are using the ``default`` namespace.

 .. code-block:: bash
    :substitutions:

    kubectl get deployments --namespace default

We can see that the deployment name is ``enterprise-steam``

 .. code-block:: bash
    :substitutions:

    NAME                                  READY   UP-TO-DATE   AVAILABLE   AGE
    enterprise-steam                      1/1     1            1           55d

Now set the new Docker image. In this case we upgrade to release |version|.

 .. code-block:: bash
    :substitutions:

    kubectl set image deployment/enterprise-steam enterprise-steam=h2oai/enterprise-steam:|version| --namespace default

This should trigger a restart. If the deployment did not restart, you may do so manually.

 .. code-block:: bash
    :substitutions:

    kubectl scale --replicas=0 deployment/enterprise-steam --namespace default
    kubectl scale --replicas=1 deployment/enterprise-steam --namespace default

You can then monitor the deployment status here:

 .. code-block:: bash
    :substitutions:

    kubectl get deployment/enterprise-steam -o wide --namespace default