Upgrading MapD¶

How you upgrade MapD depends on how you installed MapD.

Upgrading MapD Using Docker

Upgrading MapD Using Yum

Upgrading MapD Using Apt

Upgrading MapD Using a Tarball

Upgrading MapD Using Docker¶

To upgrade MapD in place in Docker, stop the current Docker container and run the MapD Docker install command.

To upgrade MapD in Docker:

You need the Docker Container ID. In a terminal window, enter the following command.

docker container ls

You receive output similar to the following. The first entry is the container ID. In this example, it is 9e01e520c30c.

CONTAINER ID        IMAGE               COMMAND                  CREATED             STATUS              PORTS                                            NAMES
9e01e520c30c        mapd/mapd-ce-cpu    "/bin/sh -c '/mapd..."   3 days ago          Up 3 days           0.0.0.0:9090-9092->9090-9092/tcp                 confident_neumann

Stop the MapD Docker container. For example:
```
docker container stop 9e01e520c30c
```
Optionally, remove the MapD Docker container. This will avoid leaving unused Docker containers on your system, which use disk space. For example:
```
docker container rm 9e01e520c30c
```
To see all containers, both running and stopped, use the following command:
```
docker container ls -a
```
Download the latest version of Docker.

For Community Edition Without GPUs:
```
docker pull mapd/mapd-ce-cpu
```
For Community Edition With GPUs:
```
docker pull mapd/mapd-ce-cuda
```

Run the Docker Install command.

For Community Edition Without GPUs:

docker run -d -v $HOME/mapd-docker-storage:/mapd-storage -p 9090-9092:9090-9092 mapd/mapd-ce-cpu

For Community Edition With GPUs:

nvidia-docker run -d -v $HOME/mapd-docker-storage:/mapd-storage -p 9090-9092:9090-9092 -v /usr/share/glvnd/egl_vendor.d:/usr/share/glvnd/egl_vendor.d mapd/mapd-ce-cuda

When the installation is complete, MapD server and MapD web server start automatically.

You can optionally add --rm to the Docker run command so that the container is removed when it is stopped.

Upgrading MapD Using Yum¶

To upgrade an existing system installed with Yum to the latest version, you re-run the install command. MapD is upgraded in place without disturbing your configuration or stored data.

To Upgrade MapD Using Yum:

Stop the MapD servers.

sudo systemctl stop mapd_web_server
sudo systemctl stop mapd_server

Run the Yum install command.
```
sudo yum install mapd
```

When installation is complete, restart the MapD servers.

sudo systemctl start mapd_server
sudo systemctl start mapd_web_server

Upgrading MapD Using Apt¶

To upgrade an existing system installed with Apt to the latest version, you re-run the install command. MapD is upgraded in place without disturbing your configuration or stored data.

To Upgrade MapD Using Apt:

Stop the MapD servers.

sudo systemctl stop mapd_web_server
sudo systemctl stop mapd_server

Run the Apt update command.
```
sudo apt update
```
Run the Apt install command.
```
sudo apt install mapd
```

When installation is complete, restart the MapD servers.

sudo systemctl start mapd_server
sudo systemctl start mapd_web_server

Upgrading MapD Using a Tarball¶

To upgrade MapD, stop the servers, expand the tar file to replace the MapD application, change the symbolic link, 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.
```
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