Upgrading the S3 Gateway

This topic provides instructions for manually updating the Object Store version 2.0.x to 2.1.x on an edge node or server node that is running core software. When you upgrade, Object Store configurations are automatically migrated. If LDAP integration is enabled, verify that the policies and configurations are correct after migration.

Edge Node Upgrade

About this task

Before you upgrade, stop the S3 Gateway services on the node, as described in Pre-Upgrade Steps for S3 Gateway.

Use the following steps to upgrade the Object Store with S3-Compatible API on an edge node:

Procedure

Upgrade the mapr-objectstore-client package:

Red Hat / CentOS:
```
sudo yum update install mapr-objectstore-client
```

Ubuntu:

sudo apt-get install mapr-objectstore-client

SLES

sudo zypper update install mapr-objectstore-client

Run the objectstore configure.sh script, as shown, to configure the Object Store:

sudo /opt/mapr/objectstore-client/objectstore-client-<version>/bin/configure.sh -c -u <userName> -g <groupName> --path /path/to/filesystem/

In this command:

`-c`	is the client node of the `mapr-objectstore-client`
`-u (--user)`	is the user admin for working with the `mapr-objectstore-client`
`-g (--group)`	is the group
`-p (--path)`	is the path for mounting the filesystem

Example:

sudo /opt/mapr/objectstore-client/objectstore-client-2.1.0/bin/configure.sh -c -u mapr -g mapr --path /mapr/my.cluster.com/objectstore

Run the objectstore.sh script to start the Object Store:

sudo /opt/mapr/objectstore-client/objectstore-client-<version>/bin/objectstore.sh start

Verify that the Object Store process is running:
```
sudo /opt/mapr/objectstore-client/objectstore-client-<version>/bin/objectstore.sh status
```
When the process is running, the system prints the following message:
```
Minio is running
```
Configure the Object Store. For details, see Configuring S3 Gateway.

Server Node Upgrade

About this task

Before you upgrade, stop the S3 Gateway services on the node, as described in Pre-Upgrade Steps for S3 Gateway.

Use the following steps to upgrade the Object Store with S3-Compatible API on a server node:

Procedure

Upgrade the mapr-objectstore-gateway and mapr-objectstore-client packages:

Red Hat / CentOS:

sudo yum update mapr-objectstore-client mapr-objectstore-gateway

Ubuntu:

sudo apt-get install mapr-objectstore-client mapr-objectstore-gateway

SLES

sudo zypper update mapr-objectstore-client mapr-objectstore-gateway

Set the accessKey and secretKey in /opt/mapr/objectstore-client/objectstore-client-<version>/conf/minio.json.
To configure Warden, use configure.sh on the first run:
```
sudo /opt/mapr/server/configure.sh -R
```
Verify that the Object Store process is running:
```
sudo /opt/mapr/objectstore-client/objectstore-client-<version>/bin/objectstore.sh status
```
When the process is running, the system prints the following message:
```
Minio is running
```
Configure the Object Store. For details, see Configuring S3 Gateway.

For More Information

About this task

To use the Object Store, see these topics:

For more information about S3 commands, see the Amazon S3 Documentation.