mongocli ops-manager admin backup sync create

On this page

Syntax

Options
Output
Example

This version of the documentation is archived and no longer supported. View the current documentation to learn how to upgrade your version of MongoCLI.

Note

You must be a Global Owner to run admin commands.

The admin backup sync create command creates a new sync store. You can also create a sync store using the API.

Syntax

mongocli ops-manager|om admin backup sync create
     [ --assignment ]
     [ --encryptedCredentials ]
     [ --label <tags> ]
     [ --loadFactor <number-of-backup-jobs> ]
     [ --maxCapacityGB <amount-of-data> ]
     --name <sync-store-name>
     [ --output|-o <output-format> ]
     [ --profile|-P <profile-name> ]
     [ --ssl ]
     --uri <hosts>
     [ --writeConcern <write-concern> ]

Note

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

Options

Option	Type	Description	Required?
`--assignment`		Flag that indicates whether this sync store can be assigned backup jobs.	no
`--encryptedCredentials`		Flag that indicates whether the username and password for this sync 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 sync stores. If omitted, this sync store can only process the backup jobs for projects that don't use labels to filter their jobs.	no
`--loadFactor`	number	Required if more than one snapshot store is in use. Number that expresses how much backup work this snapshot store should perform compared to another snapshot store. Value must be a positive, non-zero integer.	no
`--maxCapacityGB`	number	Maximum amount of data in GB that this sync store can store.	no
`--name`	string	Unique name for this sync store. This is also the sync store ID.	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
`--ssl`		Flag that indicates whether this sync store only accepts connections encrypted using TLS.	no
`--uri`	string	Comma-separated list of hosts in the `<hostname:port>` format to use to access this sync store.	yes
`--writeConcern`	string	Write concern to use for this sync store. Valid values are: `ACKNOWLEDGED` `W2` `JOURNALED` `MAJORITY`	no

Output

The command prints the following fields in the specified format to the terminal if the command succeeds. If the command prints an error, see Troubleshooting for recommended solutions.

Sync store '<name>' created

The default output contains a subset of the fields returned by this command. For the complete list of JSON fields returned by the command, see the API reference.

Example

The following mongocli om admin backup sync create command creates the Sync store named test. The command uses the default profile, which contains the credentials for accessing Ops Manager.

mongocli om admin backup sync create --name test
--uri mongodb://localhost:27017

The previous command returns the following:

Sync configuration 'test' created.

mongocli om admin backup sync create --name
test --uri mongodb://localhost:27017 --output json

The previous command returns the following:

 {
  "name": "test",
  "uri": "mongodb://localhost:27017",
  "ssl": false,
  "loadFactor": 1
}

Back

List Backup Sync Configurations

Describe One Backup Sync Configuration