On-Premises Private

Upgrading CARTO LDS

Pre-upgrade

You can check which release of CARTO LDS is installed using this command:

1
2
3
4
5
6
7
8
/opt/carto/tools/bin/cartoctl config -cr

+---------------------------------------+
|                 ROLES                 |
+---------------------------------------+
| dataservices                          |
|   release:                            |
|     version = 4.0.0                   |

You can check the upgrade pack version in the dataservices installer file name:

1
carto-dataservices-<version>-rhel-7-x86_64.tar.gz

Upgrade

The CARTO installer artifact can be used to upgrade from a previous compatible running version.

1) Unpack the tar.gz file of the LDS installer

1
tar xfz carto-dataservices-<version>-rhel-7-x86_64.tar.gz

Where version is the version of the file provided.

2) Import upgrade tasks, corresponding to the version we are going to upgrade to:

1
2
cd carto-dataservices-<version>-rhel-7-x86_64
sudo ./cartoctl tasks import tasks/upgrade/<version>

3) In order to upgrade, run the installer (as root):

1
2
cd carto-dataservices-<version>-rhel-7-x86_64
sudo ./cartoctl nodes upgrade

Post-upgrade

If you are upgrading to a new version of LDS, it is very likely that you would need to load a new dump of some of the databases that certain LDS functionalities make use of (internal geocoding, data observatory, etc..).

1.0.x -> 1.1.x

This version introduces an update for some extensions that Postgres uses in order to do data observatory analysis.

If you have been using Data Observatory, you will probably want to load a new dump of the DO databases in order to fully take advantage of the improvements included in this release. For instructions on how to load a new DO dump, kindly refer to the lds_do section.

1.x.0 -> 2.0.0

To do an upgrade between these versions, it is mandatory to uninstall the current LDS installation and then perform a fresh installation:

1) Uninstall the current LDS installation using carto-dataservices-uninstall.sh tool. 2) Install the new version following the instructions at lds_installation. 3) Configure you dataservices providers following the instructions at lds_providers_lds. 4) Load LDS geocoding database following the instructions at lds_geocoding. 5) In case you are using Data Observatory, please enable and load it following the instructions at lds_do.

1.x.0 -> 2.1.0

To do an upgrade between these versions, it is mandatory to uninstall the current LDS installation and then perform a fresh installation:

1) Uninstall the current LDS installation using carto-dataservices-uninstall.sh tool. 2) Migrate configuration and install

1
2
3
cd carto-dataservices-<version>-rhel-7-x86_64
sudo ./cartoctl init -l license.lic
vi ~/carto/.config.yml

Update the config file as it is explained in lds_installation.

1
sudo ./cartoctl nodes install

3) Configure you dataservices providers following the instructions at lds_providers_lds. 4) Load LDS geocoding database following the instructions at lds_geocoding. 5) In case you are using Data Observatory, please enable and load it following the instructions at lds_do.

2.1.0 -> 2.1.1

CARTO 2.1.0 onpremises version can be upgraded to 2.1.1 version.

1
2
3
4
tar xfz carto-dataservices-2.1.1-rhel-7-x86_64.tar.gz
cd carto-dataservices-2.1.1-rhel-7-x86_64
sudo ./cartoctl tasks import tasks/upgrade/2.1.1
sudo ./cartoctl nodes upgrade

2.1.1 -> 2.1.2

CARTO 2.1.1 onpremises version can be upgraded to 2.1.2 version.

1
2
3
4
tar xfz carto-dataservices-2.1.2-rhel-7-x86_64.tar.gz
cd carto-dataservices-2.1.2-rhel-7-x86_64
sudo ./cartoctl tasks import tasks/upgrade/2.1.2
sudo ./cartoctl nodes upgrade