.. _offline-installer-ref:

Offline Installation and Upgrades
=================================

This guide is intended for the first time offline installation of |RCC|, |RCEE|
and the |VCS|.  If you are already in an offline environment and want to
upgrade to the latest releases first see :ref:`rcc-upgrade`.

Offline Steps
-------------

1. Download the |RCC| installer for your platform.

   * :ref:`rcc-linux-ref`
   * :ref:`rcc-windows-ref`


2. Transfer the |RCC| installer, package to the machine you'll run the offline commands.

3. Install |RCC| on the offline machine.

   * :ref:`rcc-linux-ref`
   * :ref:`rcc-windows-ref`

4. Run installation with --offline flag to show which file needs to be
   downloaded into cache storage, follow up with instructions on how to put
   the download files into the cache storage.

.. code-block:: bash

    $ rccontrol install VCSServer --offline

    Offline mode enabled. Using files from the local cache.

    File /home/ubuntu/.rccontrol/cache/RhodeCodeVCSServer-4.6.1+x86_64-linux_build20170213_1900.tar.bz2 not found.
    Please manually download file from the link below and store it inside /home/ubuntu/.rccontrol/cache directory.
    https://dls.rhodecode.com/linux/RhodeCodeVCSServer-4.6.1+x86_64-linux_build20170213_1900.tar.bz2

    $ rccontrol install Enterprise --offline

    Offline mode enabled. Using files from the local cache.

    File /home/ubuntu/.rccontrol/cache/RhodeCodeEnterprise-4.6.1+x86_64-linux_build20170213_1900.tar.bz2 not found.
    Please manually download file from the link below and store it inside /home/ubuntu/.rccontrol/cache directory.
    https://dls.rhodecode.com/linux/RhodeCodeEnterprise-4.6.1+x86_64-linux_build20170213_1900.tar.bz2

.. note::

   For |RCEE| 2.x you do not need a |VCS|. It is only required for 3.x and above.


5. Run the appropriate commands again with ``--version`` and ``--offline``. E.g.

.. code-block:: bash

    $ rccontrol install VCSServer --version 4.6.1 --offline

   * See the examples below or :ref:`rcc-cli` for more details.

.. important::

    If you do not specify the ``--version`` argument |RCC| assumes the latest
    version which may not be in your cache and result in the command failing.

    Be aware that failure may also be caused by placing packages into the cache
    that have the correct version but wrong system architecture!

Examples
--------

Importing your existing older instance to be managed by |RCC|.

.. code-block:: bash

    $ rccontrol import Enterprise <path to INI> --version 2.2.7 --offline

Installing a |VCS| and |RCEE| instance.

.. code-block:: bash

    $ rccontrol install VCSServer --version 3.3.3 --offline
    $ rccontrol install Enterprise --version 3.3.3 --offline

Upgrading an existing |VCS| and |RCEE| instance.

.. code-block:: bash

    $ rccontrol upgrade vcsserver-1 --version 4.3.3 --offline
    $ rccontrol upgrade enterprise-1 --version 4.3.3 --offline