.. _install-port:

Alternative Upgrade Option
--------------------------

This option installs a new instance of |RCEE| and the ports a previous
setup into the new instance.

If want to install a clean version of |RCEE|, and then port the details of
your previous instance into the new setup, use the following instructions.

* :ref:`rce-cli-install-ref`
* :ref:`prod-ini-port`
* :ref:`prod-port-fix`
* :ref:`restart-rcm`
* :ref:`post-up-tasks`

.. _prod-ini-port:

Identify your ``production.ini``
^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^

The two components you need for porting an older version into |RCEE| are
the :file:`production.ini` file, and your |RCEE| database. The
:file:`production.ini` file should already be pointing to your database. This
file contains all the details of your setup. These are the details you will
need to configure a new installation to work like a previous one.

The default location for older |RCEE| versions is
:file:`/home/{user}/rhodecode/data/production.ini`

.. _prod-port-fix:

Configure the ``rhodecode.ini``
^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^

The :file:`rhodecode.ini` file is the equivalent configuration file for newer
versions, |RCEE| 3.0 and above. To configure this file with your old settings,
use the following steps.

.. note::

   Do not copy/paste the entire :file:`production.ini` file and over-write
   the new :file:`rhodecode.ini` as the newer file contains additional
   configuration settings.

1. Open the :file:`/home/{user}/.rccontrol/{instance-id}/rhodecode.ini` file
   and configure it with the following settings from your old
   :file:`production.ini` file.
2. Change the UUID of your new installation so that it matches your older
   version.

.. code-block:: bash

   # Change this setting to match your old instance ID
   ## change this to unique ID for security
   app_instance_uuid = d152ec7bf5ee4851a6dfca654783e772

3. Set the database connection string to point to your database

.. code-block:: bash

   #########################################################
   ### DB CONFIGS - EACH DB WILL HAVE IT'S OWN CONFIG    ###
   #########################################################
   sqlalchemy.db1.url = sqlite:////home/user/.rccontrol/instance-id/rhodecode.db

   # Do not use localhost with MySQL DBs
   sqlalchemy.db1.url = mysql://root:qweqwe@127.0.0.1/rhodecode

4. Make further changes to the :file:`rhodecode.ini` file if needed,
   for example email setup, or Celery configuration. For more information,
   see |Post Installation Tasks|.

5. Upgrade your database settings so that they match the |RCEE| 3.0 database
   setup. Use the following command:

.. code-block:: bash

   # This makes minor changes to the database settings for older versions
   # so that they behave as expected for 3.0
   .rccontrol/enterprise-1/profile/bin/paster upgrade-db /path/to/ini_file --force-yes

.. _restart-rcm:

Restart |RCEE|
^^^^^^^^^^^^^^

Restart the |RCEE| instance so that it picks up the changes.

.. code-block:: bash

   # Restart the instance you configured with changes
   rccontrol restart enterprise-1

.. _post-up-tasks:

Post-update Tasks
^^^^^^^^^^^^^^^^^

1. Once restarted, you will need to apply your new license token,
   see |Licence Management|.

2. To make |RCEE| pick up the repositories you imported,
   run |remap and rescan|.


.. |Post Installation Tasks| raw:: html

   <a href="https://docs.rhodecode.com/RhodeCode-Enterprise/install/install-steps.html" target="_blank">Post Installation Tasks</a>

.. |remap and rescan| raw:: html

   <a href="https://docs.rhodecode.com/RhodeCode-Enterprise/admin/system-admin.html#remap-and-rescan-repositories" target="_blank">remap and rescan</a>

.. |rhodecode.com| raw:: html

   <a href="https://rhodecode.com/" target="_blank">rhodecode.com</a>


.. |Licence Management| raw:: html

   <a href="https://docs.rhodecode.com/RhodeCode-Enterprise/admin/system-admin.html#licence-key-management" target="_blank">Licence Management</a>