application_servers

Fully Qualified Domain Name (FQDN), or hostname, or short name and the port number of the primary configuration server and mongod and mongos port in the following format:

clientFQDN_OR_hostname_OR_shortname:portnumber

Ensure that application_server matches with the hostname value that is used in the MongoDB environment and verified using the db.hostInfo() command.

For example, the hostname value that is displayed by db.hostInfo():

"hostname" : "<hostname_value>:<port>"

alternate_config_server

Fully Qualified Domain Name (FQDN), or hostname, or short name and the port number of the secondary or the alternate configuration server. You can add only one alternate configuration server for one cluster.

Use the following format for the value:

clientFQDN_OR_hostname_OR_shortname:portnumber

Ensure that alternate_config_server matches with the hostname value that is used in the MongoDB environment and verified using the db.hostInfo() command.

For example, the hostname value that is displayed by db.hostInfo():

"hostname" : "<hostname_value>:<port>"

If a connection to the primary configuration server fails, the first, active alternate configuration server is used.

For sharded MongoDB clusters, both the mongod and mongos processes must be running on the alternate config server.

You must enter the value of the alternate_config_server separately for every application_servers entry.

cleanup_time_in_min

Specify the time in minutes to clean up the stale snapshots or oplogstore that are created because of canceled jobs.

The value must be an integer.

free_space_percentage_snapshot

Specifies the percentage of the free space on a volume group that can be used to create a snapshot. This option is used only in case of full backups.

The default value (if not specified) is 20%. The value must be between 0 and 100. Do not use the percentage symbol (%).

For example, run the vgdisplay command to verify the value for the "Free PE / Size" field. The free_space_percentage_snapshot value is the percentage of Free PE / Size of the volume group where the data path resides.

Adjust the free_space_percentage_snapshot value based on the data change rate of the MongoDB instance during the backup operation and the free space that is available on the volume group.

For example, when:

Then specify the minimum value of free_space_percentage_snapshot as 25%.

Keeping the free space snapshot percentage value too low can result in snapshot (and subsequent backup) failure.

Keeping the free space snapshot percentage value too high can reduce the amount of available space on the volume group.

For more information and standard practices, refer to the Linux man page for the lvcreate command.

data_channel_tls

Use this parameter to disable or enable the data channel encryption between the MongoDB cluster and the backup host.

For example, use "data_channel_tls": false to disable the data channel encryption.

By default, all the traffic between the NetBackup backup host and the thin client (mdbserver) is over a TLS channel. You can disable this TLS for data movement from thin client (mdbserver) to the backup host to improve the performance.

logdir

Location where the thin client (mdbserver) logs are generated on the MongoDB nodes.

Default location is /tmp. If the directory path is mentioned, but the directory does not exist on the server, NetBackup creates a directory.

loglevel

Specify the logging level.

Default value is 3.

Refer to the following options for logging level values:

max_log_mbsize

Specify the maximum file size in MB for the NetBackup thin client log file.

The default size is 10 MB. A new log file is created every day or if the existing log file exceeds the maximum size. The log file creation does not affect an ongoing job and the log roll-over happens during the next job that is performed by mdbserver.

The logs are cleaned up after 30 days.

max_streams

Defines the number of parallel data streams per backup host. The minimum value is 32.

If max_streams is not defined, the default value is 32 parallel data streams per backup host.

Add the following entry to the mongodb.conf file:

max_streams:
      {
       "global_default":<set_value>,
       "<backup_host>":<set_value>
      }

mdb_progress_loglevel

Lets you print the progress logging information about the files that are restored to the activity monitor.

Default value is 0 (off).

To enable set "mdb_progress_loglevel": 1.

mdbserver_location

Specify a location to copy the thin client (mdbserver) binaries on the MongoDB nodes that are required for the MongoDB backup and restore operation.

The files are copied to the servers that contain the data that needs to be protected and are removed once the backup operation completes.

Default location to copy the files is /tmp.

mdbserver_port

Port that is used by the backup host to connect with the NetBackup thin client (mdbserver) that is running on the MongoDB node.

Default value is "11000".

This value is a string.

mdbserver_port_range

Use this parameter when multiple mongod instances are running on a single MongoDB node.

This option lets you use the next available port within the range for the backup and restore operation if the existing port is in use.

This option lets you run multiple backup jobs simultaneously on different ports by deploying multiple NetBackup thin clients (mdbserver).

Enter the value as "mdbserver_port_range":range_value, where the range_value is an integer to define the range of port numbers that can be used. For example, if you add the range_value as 10 and the mdbserver_port is defined 12000, the port range is used from 12000 to 12009.

The default value is 10.

Change this value based on the number of mongod instances on a MongoDB host that are backed up simultaneously.

mdbserver_timeout_min

Defines the time in minutes to wait before a NetBackup thin client (mdbserver) process is killed.

The default value is 300 (minutes).

Set the value higher than 300 minutes if your backup window requires more time.

Ideally, mdbserver is killed after the plug-in terminates or the backup is complete.

mongos_port

Port that the mongos process uses for communication.

This is a mandatory parameter for sharded MongoDB clusters.

You must specify this value for each of the application_servers or alternate_config_server entry

This value is a string.

oplog_location

For differential incremental backups, specify a custom directory to store the MongoDB oplog file.

The location is stored in the backup image.

Default location is /tmp/oplogstore.

Ensure that there is enough free space at this location for the oplog data of the incremental backups.

snapshot_mount_path

Specify the path on the MongoDB nodes for mounting LVM snapshots during full backups.

Default path is /tmp.