CARTO can be installed on a local server, or set of servers, either directly or using our commercial installer.

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.

Warning
upgrading from 1.x.0 (or lower) to 2.0.0 (or higher) is not supported, please uninstall and reinstall LDS as explained in the Post-upgrade section.

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.

Note
When upgrading, the installer artifact's configuration parameters won't get applied to the existing configuration in order to not interfere with existing customizations.

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
Warning
CARTO services will be restarted during the upgrade process.

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.

Note
2.0.0 version requires a new Data Observatory dump `obs_2018_04_18_e0da59b211`, so make sure to load it in step number 5.

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:

Warning
2.1.0 version deprecates the configuration file `/etc/carto-dataservices.conf` in favor of `~/.carto/config.yml`.
Warning
2.1.0 version deprecates `carto-setup.sh` installer, in favor of `cartoctl`.
Warning
2.1.0 version required at least RHEL7/CentOS 7 linux distribution.

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

Note
For reference about how the new configuration file `~/.carto/config.yml` looks like, please check the lds\_installation section.
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
Warning
CARTO services will be restarted during the upgrade process.

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
Warning
CARTO services will be restarted during the upgrade process.