Upgrading the Object Store with S3-Compatible API

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.

Parent topic: Upgrading the Ecosystem Pack Without the Installer

Edge Node Upgrade

Before you upgrade, stop the Object Store with S3-Compatible API services on the node, as described in Pre-Upgrade Steps for Object Store with S3-Compatible API.

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

  1. Upgrade the mapr-objectstore-client package:
    • Red Hat / CentOS:
      sudo yum update install mapr-objectstore-client
    • Ubuntu:
      sudo apt-get install mapr-objectstore-client
    • SUSE
      sudo zypper update install mapr-objectstore-client
  2. 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
  3. Run the objectstore.sh script to start the Object Store: 
    sudo /opt/mapr/objectstore-client/objectstore-client-<version>/bin/objectstore.sh start
  4. 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
  5. Configure the Object Store. For details, see Configuring Object Store with S3-Compatible API.

Server Node Upgrade

Before you upgrade, stop the Object Store with S3-Compatible API services on the node, as described in Pre-Upgrade Steps for Object Store with S3-Compatible API.

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

  1. 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
    • SUSE
      sudo zypper update mapr-objectstore-client mapr-objectstore-gateway
  2. Set the accessKey and secretKey in /opt/mapr/objectstore-client/objectstore-client-<version>/conf/minio.json.
  3. To configure Warden, use configure.sh on the first run: 
    sudo /opt/mapr/server/configure.sh -R
  4. 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
  5. Configure the Object Store. For details, see Configuring Object Store with S3-Compatible API.

For More Information

To use the Object Store, see these topics:

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