.. _upgrade-to-latest:

Upgrade |RCEE| 3.X, 4.X Versions
--------------------------------

.. note::

    As of 3.3.0 the |RCEE| and |VCS| versions are synchronized. You should ensure
    that your instances are using the same version to avoid potential problems.

To upgrade |RCEE| to the latest version, use the following steps:

1. Upgrade |RCC| to the latest version. This will download latest MANIFEST
file with package definitions.

.. code-block:: bash

    $ rccontrol self-update

2. Check your |RCEE| and |VCS| instances.

.. code-block:: bash

    $ rccontrol status

     - NAME: enterprise-1
     - STATUS: RUNNING
     - TYPE: Enterprise
     - VERSION: 3.1.0
     - URL: http://127.0.0.1:10001

     - NAME: vcsserver-1
     - STATUS: RUNNING
     - TYPE: VCSServer
     - VERSION: 3.1.0
     - URL: http://127.0.0.1:10002

3. Upgrade your |VCS| to the latest version if it was installed.

.. code-block:: bash

    $ rccontrol upgrade vcsserver-1

    Checking for available update for vcsserver-1 @ 1.2.0
    Stopped vcsserver-1
    Initiating upgrade to version 3.5.0
    Upgrade of RhodeCode VCS Server successful.
    Auto starting vcsserver-1

4. Upgrade |RCEE| to the same version as the |VCS| if applicable.

.. code-block:: bash

    # If a VCS Server is installed upgrade to the same version
    $ rccontrol upgrade enterprise-1 --version 3.5.0

    # Otherwise upgrade to the latest version
    $ rccontrol upgrade enterprise-1

    Checking for available update for enterprise-1 @ 3.1.0
    Stopped enterprise-1
    Initiating upgrade to version 3.5.0
    ...
    ****************************************
    *** UPGRADE TO VERSION 45 SUCCESSFUL ***
    ****************************************
    Upgrade of RhodeCode Enterprise successful.
    Auto starting enterprise-1


.. note::

    For convenience, your installation can be updated and upgraded in a single
    command::

        rccontrol self-update && rccontrol upgrade '*'