Backing up the S3 configuration data

The S3 configuration data can be backed up automatically or manually.

Automatic backup of the S3 configuration data

IBM Storage Scale S3 service supports periodic or automatic backup of the S3 configuration data from CES share root directory to the clustered configuration repository (CCR) periodically. On CES nodes where S3 is enabled, the configuration data is backed up every 10 minutes . The S3 configuration data is backed up only on one CES node at a time.

  1. To list a backup file of the tar.bz2 S3 configuration on the CCR, issue the following command:

    # mmccr flist | grep _s3
    A sample output is as follows:
    37  _s3-config-backup.tar.bz2
  2. To get a local copy of the tar.bz2 backup file from the CCR, issue the following command:

    # mmccr fget _s3-config-backup.tar.bz2 /tmp/s3-config.tar.bz2
    A sample output is as follows:
    fget:37
  3. To list the information of the local backup file, issue the following command:
    # ls -ltr /tmp/s3-config.tar.bz2
    A sample output is as follows:
    -rw-------. 1 root root 537 Mar 18 20:34 /tmp/s3-config.tar.bz2

Manual backup of the S3 configuration data

The S3 configuration can be backed up by using the mms3 config backup command. The mms3 config backup command archives all the files and directories at the <cesSharedRoot path>/ces/s3-config directory, into a single tar.bz2 file, and saves the file to the specified backup_directory path. For more information, see mms3 command.
  1. To know the syntax of the mms3 config backup command, run the following command:
    # mms3 config backup --help
    The information about the mms3 command is as follows:
    Backup the IBM Storage Scale S3 configuration.
    
    Usage:
    
      mms3 config backup <backup_directory> [flags]
    
    Flags:
    
      -h, --help   help for backup
    
    Global Flags:
    
      -d, --debug   verbose logging
    
    
  2. To back up the S3 configuration data manually, issue the below command:

    Example,

    # mms3 config backup /tmp/demo-backup
    The sample output is as follows:
    Backup of IBM Storage Scale S3 configuration <backup_directory>/s3ConfigBackup.20240709-063551.tar.bz2 successful.

    After the S3 configuration data is backed up successfully, a file name, such as s3ConfigBackup.date-time.tar.bz2, is created in the specified backup_directory.