Docs Menu
Docs Home
/ /
MongoDB Command Line Interface
/ / / /

mongocli ops-manager admin backup filesystem update

On this page

  • Syntax
  • Arguments
  • Options
  • Output
  • Examples

Note

The admin backup filesystem update command updates one backup file system store configuration. You can also update the configuration using the UI and the API.

mongocli ops-manager|om admin backup filesystem|fileSystem update <file-system-ID>
[ --assignment ]
[ --encryptedCredentials ]
[ --label <tags> ]
[ --loadFactor <number-of-backup-jobs> ]
[ --mmapv1CompressionSetting <NONE|GZIP> ]
[ --output|-o <output-format> ]
[ --profile|-P <profile-name> ]
--storePath <path-to-backups>
[ --wtCompressionSetting <NONE|GZIP> ]

Note

Use -h or --help to view the command-line help for this command.

Option
Type
Description
Required?
<file-system-ID>
string
Unique name for this file system store configuration.
yes
Option
Type
Description
Required?
--assignment
Flag that indicates whether this file system store can be assigned backup jobs.
no
--encryptedCredentials
Flag that indicates whether the username and password for this file system store were encrypted using the credentialstool.
no
--label
array of strings
Array of tags that specify which backup jobs Ops Manager can assign to which file system store. If omitted, this file system store can only process the backup jobs for projects that do not use labels to filter their jobs.
no
--loadFactor
number

Required if more than one snapshot store is in use.

Number of backup work this snapshot store should perform compared to another snapshot store. Value must be a positive, non-zero integer.

no
--mmapv1CompressionSetting
string

Compression setting if you use the MMAPv1 storage engine for your snapshots. Ops Manager accepts NONE or GZIP.

If your snapshots don't use the MMAPv1 storage engine, this value must be NONE.

yes
--output, -o
string

Command output format. Valid values are:

  • json for output in JSON format

  • go-template for custom output using the Go template

  • go-template-file for custom output specified using Go template file

If omitted, the command returns output in the default format.

no
--profile, -P
string
Name of the profile where the public and private keys for the project are saved. If omitted, uses the default profile. To learn more about creating a profile, see Configure the MongoDB CLI.
no
--storePath
string
Location where file system-based backups are stored on the file system store host.
yes
--wtCompressionSetting
string

Compression setting if you use the WiredTiger storage engine for your snapshots. Ops Manager accepts NONE or GZIP.

If your snapshots don't use the WiredTiger storage engine, this value must be NONE.

yes

If the command succeeds, it returns the following message in the default format. If the command returns errors, see Troubleshooting for recommended solutions.

File System configuration '<file-system-ID>' updated.

If you request output in JSON format, the command returns the fields described in the API reference.

The following mongocli om admin backup filesystem update command updates the test file system store using the default profile, which contains the credentials for accessing Ops Manager.

mongocli om admin backup filesystem update test --assignment --storePath /data/backup --mmapv1CompressionSetting NONE --wtCompressionSetting GZIP

The previous command returns the following:

File System configuration 'test' updated.
mongocli om admin backup filesystem update test --assignment --storePath /data/backup --mmapv1CompressionSetting NONE --wtCompressionSetting GZIP --output json

The previous command returns the following:

{
"id" : "test",
"assignmentEnabled" : true,
"loadFactor" : 1,
"mmapv1CompressionSetting" : "NONE",
"storePath" : "/data/backup",
"wtCompressionSetting" : "GZIP"
}

Back

Get One File System Store Configuration