IBM Support

MongoDB database backup and restore requirements: IBM Spectrum Protect Plus V10.1.7

Preventive Service Planning


Abstract

This document details the MongoDB database backup and restore requirements for IBM Spectrum Protect Plus Version 10.1.7.

Content

This document is divided into linked sections for ease of navigation. Use the following links to navigate to the section of the document that you require:


General

Beginning with IBM Spectrum Protect Plus V10.1.3, support was added for backing up and restoring of MongoDB database data.

Before you register a MongoDB database with IBM Spectrum Protect Plus, ensure that the system environment meets the following requirements.



 


Configuration

Application versions

Table 1. Coverage matrix for application levels supported by IBM Spectrum Protect Plus
IBM Spectrum Protect Plus MongoDB V3.6*
Community Server and Enterprise Server editions		 MongoDB V4.0*
Community Server and Enterprise Server editions		 MongoDB V4.2*
Community Server and Enterprise Server editions		 MongoDB V4.4*
Community Server and Enterprise Server editions
V10.1.3 -- --
V10.1.4 -- --
V10.1.5 -- --
V10.1.6 --
V10.1.7

 * The base release and later maintenance and modification levels are supported.



 

Operating systems

Table 2. Coverage matrix for supported Linux® x86_64 operating systems
IBM Spectrum Protect Plus RHEL 6.8* RHEL 7.0* RHEL 8.0* CentOS 6.8* CentOS 7.0* CentOS 8.0* SLES 12 SP1* SLES 15*
 V10.1.3 -- -- --
V10.1.4 -- -- --
 V10.1.5 -- -- --
 V10.1.6 -- -- --
 V10.1.7

* The base release and later maintenance and modification levels are supported.



 

Table 3. Coverage matrix for supported operating systems on Linux on Power Systems (little endian)
IBM Spectrum Protect Plus RHEL 7.1* RHEL 8.0* CentOS 7.0* CentOS 8.0*
V10.1.4 -- --
 V10.1.5 -- --
 V10.1.6 -- --
 V10.1.7

* The base release and later maintenance and modification levels are supported.

IBM Spectrum Protect Plus protect also the MongoDB application server installed on a VMware or Kernel-based Virtual Machine (KVM) virtual machine when MongoDB is running on a supported operating system.


 

Restrictions

  • On Linux on Power Systems (little endian), only the MongoDB Enterprise Server Edition is supported.
  • MongoDB shared cluster configurations are detected when you run an inventory, but these resources are not eligible for backup or restore operations.
  • On MongoDB, Secure Sockets Layer (SSL)-based encryption and certificate-based authentication are not supported.
  • Ensure that your MongoDB setup does not include nested mount points.



 


Software

  • The bash and sudo packages must be installed. Sudo must be at version 1.7.6p2 or later. Run sudo -V to check the version.
    Tip: The required bash and sudo packages are included in the supported Linux x86_64 and Linux on Power Systems (little endian) operating system installation packages.
  • Install the most recent MongoDB patches and updates in your environment.
  • Ensure that a supported version of Linux x86_64 or Linux on Power Systems (little endian) is installed with the most recent patches and updates.
  • The International Components for Unicode (libicu) RPM package corresponding to the operating system must be installed.
  • Ensure that the user limit value ulimit -f is set to unlimited, for the IBM Spectrum Protect Plus agent user and the MongoDB instance user. Alternatively, set a sufficiently high value to support copying of the largest database files in your backup and restore jobs. If you change the ulimit setting, restart the MongoDB instance to finalize the configuration.
  • In a Linux environment, depending on your version or distribution, ensure that the Linux utility package util-linux-ng or util-linux is current.
  • RHEL and CentOS 6 users: To ensure that the util-linux-ng or util-linux package is current, run the following command: 
        yum update package_name
    where package_name is the name of the Linux utility package.
  • RHEL and CentOS 6 users: If the MongoDB application server is running on RHEL 6 or CentOS 6, ensure that the openssl package is at version 1.0.1e-57 or later. To update the version, run the following command: 
        yum update openssl



 


Connectivity

Ensure that your system environment meets the following connectivity requirements:

  • The secure file transfer protocol (SFTP) subsystem for Secure Shell (SSH) is enabled.
  • The Secure Shell (SSH) service is running on port 22 on the MongoDB server.
  • Firewalls are configured to allow IBM Spectrum Protect Plus to connect to the proxy host server by using SSH.
  • IBM Spectrum Protect Plus uses the Network File System (NFS) protocol to mount storage volumes for backup and restore operations. Ensure that the native Linux NFS client is installed on the proxy host server.
  • All servers, proxies, applications, and hypervisors that are added to the IBM Spectrum Protect Plus environment must be registered by using a Domain Name System (DNS) name or Internet Protocol (IP) address.
  • If DNS names are used, they must be resolvable over the network by the IBM Spectrum Protect Plus server and the vSnap server. All IBM Spectrum Protect Plus components must also be resolvable by their DNS names.
  • If DNS is not available, you must add the server to the /etc/hosts file on the IBM Spectrum Protect Plus server by using the command line.



 


Authentication and privileges

Authentication

  • The MongoDB server must be registered with IBM Spectrum Protect Plus by using an operating system user that exists on the MongoDB server. The user is then referred to as the IBM Spectrum Protect Plus agent user.
  • Ensure that the root user password is correctly configured and that the user can log in without facing any other prompts, such as prompts to reset the password.
  • With the MongoDB Enterprise Server Edition, only the encrypted storage engine is supported.


 

Privileges

To use a MongoDB database, an IBM Spectrum Protect Plus agent user must have the following permissions:

  • Privileges to run commands as the root user and as a MongoDB software owner user by using sudo. IBM Spectrum Protect Plus requires these privileges for various tasks such as discovering storage layouts, mounting and unmounting disks, and managing databases.
    • The sudoers configuration must allow the IBM Spectrum Protect Plus agent user to run commands without a password.
    • The !requiretty setting must be specified, as described in Setting sudo privileges
  • Privileges to read the standard MongoDB server module /usr/local/bin/mongod. IBM Spectrum Protect Plus requires these privileges to use the PyMongo application programming interface (API) to connect to the MongoDB servers by using theDNS name that is assigned to the instance or the IP address and port number. This mechanism is used to gather information about MongoDB instances and databases.
  • If the MongoDB server is protected by role-based authentication, you must set up the appropriate privileges, as described in Roles for MongoDB



 


Prerequisites and operations

Prerequisites

Ensure that the Software, Connectivity, and Authentication and privileges requirements are met.

The following prerequisites must be met before you start protecting your resources.

  • The MongoDB is configured as a stand-alone instance or replica set. Backup operations for MongoDB sharded cluster instances are not supported. A backup job always includes all databases in the instance.
  • The MongoDB instance is configured to use the WiredTiger Storage Engine.
  • Each MongoDB instance to be protected must be registered with IBM Spectrum Protect Plus. After the instances are registered, IBM Spectrum Protect Plus runs an inventory to detect MongoDB resources. Ensure that all instances that you want to protect are detected and listed correctly.
  • The user who is registered with IBM Spectrum Protect Plus for the MongoDB application server must be able to retrieve server information and status from the MongoDB admin database.
  • Ensure that you have enough free space on the target and source hosts, and in the vSnap repository. Extra space is required to store temporary Logical Volume Manager (LVM) backups of logical volumes where the MongoDB data is located. These temporary backups, known as LVM snapshots, are created automatically by the MongoDB agent. For each LVM snapshot logical volume, at least 10% of free space must be allocated in the volume group. Ifthe volume group has enough free space, the IBM Spectrum Protect Plus MongoDB agent reserves up to 25% of the source logical volume size for the snapshot logical volume. For more information, see Space requirements for MongoDB
  • Ensure that enough disk space is allocated at the target server for restore operations.
  • Logical volumes of MongoDB data and log paths are managed by Linux Logical Volume Manager (LVM2). LVM2 is used to create temporary volume snapshots. The database files and the journal must be on a single volume. The logical volume grows in size with data as the data changes on the source volume while the snapshot exists. For more information, see LVM2


 

Operations

Before you start a backup or restore operation, take the following actions:

  • Add the application servers that you want to back up.
  • Configure a service level agreement (SLA) policy.
  • Assign appropriate roles and resource groups to users who will be running backup and restore operations. Grant users access to resources and roles by using the Accounts pane.

Review the following information about creating backup and restore jobs:

  • To regularly back up your data, define a backup job that includes an SLA policy. For instructions, see Backing up MongoDB data
  • To restore data, define a job that restores data to the latest backup or select an earlier backup copy. You can restore data to the original instance or to an alternative instance on a different machine, creating a cloned copy. Define and save the restore job to run as an ad hoc operation, or to run regularly as a scheduled job. For instructions, see Restoring MongoDB data

For an overview about protecting MongoDB databases with IBM Spectrum Protect Plus, see Protecting MongoDB



 


Ports

The following ports are used by IBM Spectrum Protect Plus agent users.

Table 4. Communication ports when the target is an IBM Spectrum Protect Plus agent
Port Protocol Initiator Target Description
22 Transmission Control Protocol (TCP) IBM Spectrum Protect Plus server MongoDB Provides access to troubleshoot and maintain remote proxy host servers running guest application components by using the SSH protocol


 

Table 5. Communication ports when the initiator is the IBM Spectrum Protect Plus agent
Port Protocol Initiator Target Description
111 TCP MongoDB vSnap server Used for NFS data transfer to and from file systems mounted from vSnap servers during backup and restore operations
2049 TCP MongoDB vSnap server Used for NFS data transfer to and from file systems mounted from vSnap servers during backup and restore operations
20048 TCP MongoDB vSnap server Used for NFS data transfer to and from file systems mounted from vSnap servers during backup and restore operations



 


Hardware

Table 6. Minimum hardware requirements
System Disk space
Compatible hardware that is supported by the operating system and MongoDB A minimum of 500 MB of disk space is required for product installation



 

[{"Type":"MASTER","Line of Business":{"code":"LOB26","label":"Storage"},"Business Unit":{"code":"BU058","label":"IBM Infrastructure w\/TPS"},"Product":{"code":"SSNQFQ","label":"IBM Spectrum Protect Plus"},"ARM Category":[{"code":"a8m3p000000h9Z4AAI","label":"HW\/SW Requirements"}],"ARM Case Number":"","Platform":[{"code":"PF016","label":"Linux"},{"code":"PF033","label":"Windows"}],"Version":"10.1.7"}]

Document Information

Modified date:
22 June 2021

UID

ibm16325257

Page Feedback