Upgrading MapD Core Database¶

To upgrade MapD Core Database, stop the servers, expand the tar file to replace the MapD application, rename the file, then restart the servers.

As a best practice, MapD recommends that you create an installs directory where you keep each version of MapD as you upgrade. Create a symbolic link to the current version, and update the definition with each upgrade. This way, should you need to revert to an earlier release for any reason, you only have to change the link.

In a terminal window, go to your $MAPD_PATH directory.

Stop the mapd_web_server and mapd_server.

sudo systemctl stop mapd_web_server
sudo systemctl stop mapd_server

Go to the installs directory. (If this is your first upgrade, create the installs directory and move the current MapD directory into the installs directory.)
Download the MapD TAR file to the installs directory.
Expand the archive of the new version of MapD Core Database.
```
tar -xvf <file-name>.tar.gz
```
Replacing <file-name> with the name of the archive file.
In your home folder, define (or redefine) the symbolic link mapd to point to the new version. For example, if the new version directory were named mapd-ee-3.1.0-20170615-b95a40e-Linux-x86_64-render you would use this command to create the symbolic link.
```
ln -s /installs/mapd-ee-3.1.0-20170615-b95a40e-Linux-x86_64-render mapd
```
If necessary, update your $MAPD_PATH environment variable to point to the mapd symbolic link. If you set the variable in a location such as .bashrc, update it there, as well.
```
export MAPD_PATH=~/mapd
```

Go to your $MAPD_PATH directory and start the servers.

cd $MAPD_PATH
sudo systemctl start mapd_server
sudo systemctl start mapd_web_server