Note
Before running a command, make sure to log on to the CommServe computer using the qlogin command. Use the qlogout command to log off from the CommServe computer.
Available Commands
The following section provides a list of commands that can be used by the Exchange Public Folder Agent.
qcreate
For more information, see the following sections on this page:
- "Qcreate Backupset"
- "Qcreate Subclient"
qinfo
For more information, see the following sections on this page:
- "Qinfo Backupset"
- "Qinfo Subclient"
qlist
For more information, see the following sections on this page:
- "Qlist Backupset"
- "Qlist Subclient"
qmodify
For more information, see the "Qmodify Subclient" section on this page.
qdelete
For more information, see the following sections on this page:
- "Qdelete Client"
- "Qdelete Datagent"
- "Qdelete Backupset"
- "Qdelete Subclient"
Qcreate Backupset
Description
This command creates a new backup set under the given client and agent.
The qcreate backupset command also allows the user to create default backup sets and on-demand backup sets. The default subclient created under the backup set can also be associated with a storage policy. If a storage policy name is not included, the subclient remains unassigned.
Upon successful completion, qcreate backupset displays the message "Created backupset successfully" on the command prompt. In case of an error, an error code and description are displayed as: "backupset: Error errorcode: errordescription"
Usage
qcreate backupset -c client -a dataagenttype -i instance -n backupset [-sp storagepolicy] [-t NORMAL|DEFAULT|ONDEMAND] [-tf tokenfile] [-tk token] [-af Argument Filepath] [-h]
Options
-c |
Client computer name |
-a |
Agent type that is located on the client computer (see Argument Values - Agent Types) |
-i |
Instance name, required for certain agents |
-n |
Name of the backup set to be created |
-t |
Type of backup set (NORMAL, DEFAULT, or ONDEMAND) |
-sp |
Storage policy name with which default subclients are to be associated |
-tf |
Reads token from a file |
-tk |
Token string |
-af |
Reads arguments from a file |
-h |
Displays help |
Argument File
client |
Client computer name |
dataagent |
Agent type that is located on client computer (see Argument Values - Agent Types) |
backupset |
Backup set name to be created |
sp |
Storage policy name to be associated with all subclients in the backup set |
backupsettype |
Backup set type (NORMAL, DEFAULT, or ONDEMAND) |
compressionat |
Compression at client or MediaAgent (CLIENT|MA) |
networkagents |
Number of network agents |
prebackup |
Prebackup command name |
postbackup |
Postbackup command name |
prescan |
Prescan command name |
postscan |
Postscan command name |
Diagnostics
Possible exit status values are:
0 - Successful completion.
1 - CLI usage failures, due to the use of an unsupported option or missing argument.
2 - Any other failure.
Examples
Create a backup set with name bs1 under client client1 and Agent EX_PB_FOLDER.
qcreate backupset -c client1 -a EX_PB_FOLDER -n bs1
Qcreate Subclient
Description
This command creates a new subclient under a specified client and agent. The instance name and backup set name are required for certain agents, and should be specified when applicable.
The new subclient will be associated with the specified storage policy and content. If you want to enable deduplication, create the [singleinst] section in the Argument file and specify whether deduplication should be performed in the MediaAgent or the Client.
Upon successful completion, the qcreate subclient command displays the message "Created subclient successfully" on the command prompt. In case of an error, an error code and description are displayed as: "subclient: Error errorcode: errordescription"
Usage
qcreate subclient -c client -a dataagenttype -b backupset -i instance -n subclient -sp storagepolicy -f content1 [-f content2 -f content3 ..] [-wc y|n] [-tf tokenfile] [-tk token] [-af argsfilepath] [-h]
Options
-c |
Client computer name |
-a |
Agent type that is located on the client computer (see Argument Values - Agent Types) |
-b |
Backup set name, required for certain agents |
-i |
Instance name, required for certain agents |
-n |
Name of the subclient to be created |
-sp |
Name of the storage policy to be associated with the subclient |
-f |
File or directory path to be included as content in the new subclient. See syntax to specify multiple content. |
-wc |
Do the file or directory paths have wildcards (y|n) |
-tf |
Reads token from a file |
-tk |
Token string |
-af |
Reads arguments from a file |
-h |
Displays help |
Argument File
client |
Client computer name |
dataagent |
Agent type type that is located on client computer (see Argument Values - Agent Types) |
backupset |
Backup set name |
subclient |
Subclient name to be created |
datareaders |
Number of data readers |
sp |
Storage policy name to be associated with the subclient. |
content |
Subclient content (list of files/directories). |
compressionat |
Compression at client or MediaAgent (CLIENT|MA) |
networkagents |
Number of Network Agents |
prebackup |
PreBackup command name |
postbackup |
PostBackup command name |
prescan |
Prescan command name |
postscan |
PostScan command name |
wildcard |
Wildcard characters |
singleinst |
MediaAgent or Client |
description |
User-defined description |
Diagnostics
Possible exit status values are:
0 - Successful completion.
1 - CLI usage failures, due to the use of an unsupported option or missing argument.
2 - Any other failure.
Examples
Create a subclient with name sc1 under client client1, iDataAgent EX_PB_FOLDER and backup set bs1 with content c:\ and storage policy sp1.
qcreate subclient -c client1 -a EX_PB_FOLDER -b bs1 -n sc1 -f "c:\" -sp sp1
Qinfo Backupset
Description
This command displays information about a given backup set. If the agent supports instances above backup sets, only the backup sets under the specified instance are listed.
In case of an error, an error code and description are displayed as: "backupset: Error errorcode: errordescription"
Usage
qinfo backupset -c client -a dataagenttype -i instance -b backupset [-desc] [-tf tokenfile] [-tk token] [-h]
Options
-c |
Client computer name |
-a |
Agent type that is located on the client computer (see Argument Values - Agent Types) |
-i |
Instance name, required for a few agents |
-b |
Backup set name |
desc |
Displays description provided by the user Note To display the entire user description for the backup set without any other information, be sure to include the -desc option when you run the command. Otherwise, all the requested information along with only a partial description will be displayed. |
-tf |
Reads token from a file |
-tk |
Token string |
-h |
Displays help |
Diagnostics
Possible exit status values are:
0 - Successful completion.
1 - CLI usage failures, due to the use of an unsupported option or missing argument.
2 - Any other failure.
Examples
Display information about a backup set defaultBackupSet in client client1 and Agent EX_PB_FOLDER.
qinfo backupset -c client1 -a EX_PB_FOLDER -b defaultBackupSet
Name |
defaultBackupSet |
Default |
Yes |
Ondemand |
No |
Description |
Backup Set description |
Qinfo Subclient
Description
This command displays information about a subclient under a specified client, agent, and instance/backup set. The backup set name and instance name should be specified based on the agent, as certain agents place subclients under backup sets, and others place them under the instance.
In case of an error, an error code and description are displayed as: "subclient: Error errorcode: errordescription"
Usage
qinfo subclient -c client -a dataagenttype -i instance -b backupset -s subclient [-desc] [-tf tokenfile] [-tk token] [-h]
Options
-c |
Client computer name |
-a |
Agent type that is located on the client computer (see Argument Values - Agent Types) |
-i |
Instance name, required for a few agents |
-b |
Backup set name, required for a few agents |
-s |
Subclient name |
desc |
Displays description provided by the user Note To display the entire user description for the backup set without any other information, be sure to include the -desc option when you run the command. Otherwise, all the requested information along with only a partial description will be displayed. |
-tf |
Reads token from a file |
-tk |
Token string |
-h |
Displays help |
Diagnostics
Possible exit status values are:
0 - Successful completion.
1 - CLI usage failures, due to the use of an unsupported option or missing argument.
2 - Any other failure.
Examples
Display information about a subclient sc1 in the client client1 Agent EX_PB_FOLDER and backup set bs1
qinfo subclient -c client1 -a EX_PB_FOLDER -b bs1 -s sc1
Name |
sc1 |
Default |
Yes |
Storage Policy |
battra_t(battra)-DP(2) |
Description |
Subclient description |
Qlist Backupset
Description
This command lists the names of all the backup sets in the specified client and agent. If the agent supports instances above the backup set level, then only the backup sets under the specified instance are listed. Whenever more than one backup set is found, each backup set is listed in its own line on the command prompt. No message is displayed whenever backup sets are not found.
In case of an error, an error code and description are displayed as: "backupset: Error errorcode: errordescription"
Usage
qlist backupset -c client -a dataagenttype -i instance [-tf tokenfile][-tk token] [-h]
Options
-c |
Client computer name |
-a |
Agent type that is located on the client computer (see Argument Values - Agent Types) |
-i |
Instance name, required for certain agents |
-tf |
Reads token from a file |
-tk |
Token string |
-h |
Displays help |
Diagnostics
Possible exit status values are:
0 - Successful completion.
1 - CLI usage failures, due to the use of an unsupported option or missing argument.
2 - Any other failure.
Example
List all the Backup sets in the client client1, agent MyDataAgent.
qlist backupset -c client1 -a MyDataAgent
The output for the qlist backupset command is:
defaultBackupSet
bs1
Qlist Subclient
Description
This command lists the names of all the subclients in a specified client, agent, and instance/backup set. Whenever more than one subclient is found, each subclient is listed in its own line on the command prompt. No message is displayed whenever subclients are not found.
In case of an error, an error code and description are displayed as: "subclient: Error errorcode: errordescription"
Usage
qlist subclient -c client -a dataagenttype -i instance -b backupset [-tf tokenfile] [-tk token] [-h]
Options
-c |
Client computer name |
-a |
Agent type that is located on the client computer (see Argument Values - Agent Types) |
-i |
Instance name, required for certain agents |
-b |
Backup set name, required for certain agents |
-tf |
Reads token from a file |
-tk |
Token string |
-h |
Displays help |
Diagnostics
Possible exit status values are:
0 - Successful completion.
1 - CLI usage failures, due to the use of an unsupported option or missing argument.
2 - Any other failure.
Examples
List all the Subclients in the client client1, Agent EX_PB_FOLDER and backup set bs1.
qlist subclient -c client1 EX_PB_FOLDER -b bs1 default sc1
The output for the qlist command is:
default
sc1
Qmodify Subclient
Description
This command modifies the storage policy, content, or user-defined description of a given subclient.
Upon successful completion, the qmodify subclient command displays the message "Modified subclient successfully" on the command prompt. In case of an error, an error code and description are displayed as: "subclient: Error errorcode: errordescription"
Note
To use this command, you must ensure that the QCMD_SUPPORT_MODIFY_SUBCLIENT additional setting is set to 1.
Usage
qmodify subclient -c client -a dataagenttype -i instance -b backupset -s subclient -sp storagepolicy -f content [-ow overwrite] [-drs datareaders] [-wc y|n] [-af ArgumentFilepath] [-tf tokenfile] [-tk token] [-h]
Options
-c |
Client computer name |
-a |
Agent type that is located on the client computer (see Argument Values - Agent Types) |
-i |
Instance name, required for a few agents |
-b |
Backup set name, required for a few agents |
-s |
Name of the subclient to be modified |
-sp |
Name of the storage policy to be associated with the subclient |
-f |
File/Directory Path to be added to the existing content Note When using the -f content option, you must verify that the subclient content is in the correct format path. This command does not enforce the content format, and any path (including an incorrect path) can be specified. This may result in incorrect content being assigned to a file system subclient and a "pending" subclient scan. |
-wc |
Do file or directory paths have wildcards (y|n) |
-ow |
If the contents needs to be overwritten (0:1) |
-drs |
Number of data readers |
-af |
Input file containing arguments |
-tf |
Reads token from a file |
-tk |
Token string |
-h |
Displays help |
Argument File
client |
Client computer name |
dataagent |
Agent type that is located on source client computer (see Argument Values - Agent Types) |
instance |
Instance name to which the subclient belongs, required for certain agents |
backupset |
Backup set name to which the subclient belongs, required for certain agents |
subclient |
Name of the subclient to be modified |
sp |
New storage policy for the subclient |
content |
List of files/directories to be added to the existing content Note The content option is supported for file system agents. Although, changing the storage policy association of a subclient is supported for all agents. |
datareaders |
Number of data readers |
wildcard |
Do file/directory paths have wildcards (y|n) |
description |
User-defined description |
Diagnostics
Possible exit status values are:
0 - Successful completion.
1 - CLI usage failures, due to the use of an unsupported option or missing argument.
2 - Any other failure.
Examples
Modify a subclient with name sc1 under client client1 and Agent EX_PB_FOLDER and backup set bs1 by changing its storage policy to sp2.
qmodify subclient -c client1 -a EX_PB_FOLDER -b bs1 -s sc1 -sp sp2
Qdelete Client
Description
This command can be used to deconfigure and/or delete a client, along with its agents.
By default, the qdelete client command asks for confirmation before deleting the client. You can skip the confirmation prompt with the -y option.
Upon successful completion, qdelete client displays the message "Deleted the client successfully" on the command prompt. In case of an error, an error code and description are displayed as: "client: Error errorcode: errordescription"
Usage
qdelete client [-cs <commserve_host_name>] -c <client> [-deconfigure] [-y] [-tf <tokenfile>] [-tk <token>] [-af <clientfile>] [-h]
Options
-cs |
CommServe host name |
-c |
Client computer name |
-deconfigure |
Deconfigures a client without deleting it |
-y |
Delete without confirmation |
-tf |
Reads token from a file |
-tk |
Token string |
-af |
Reads client name from a file |
-h |
Displays help |
Diagnostics
Possible exit status values are:
0 - Successful completion.
1 - CLI usage failures, due to the use of an unsupported option or missing argument.
2 - Any other failure.
Examples
-
Delete a client with name client1.
qdelete client -c client1 This command deconfigures and deletes a client, do you want to continue (y/n)? [n]
-
Deconfigure, but do not delete, a client with name client1
qdelete client -c client1 -deconfigure -y
-
Delete a set of clients specified in an argument file.
qdelete client -af "E:\clients.txt"
In this example, clients.txt is a text file containing a list of client names. Ensure that the file is in the following format:
[client] Client01 Client02 ClientXX
Note
You can mass-delete clients with or without their associated MediaAgents using the qdelete client command. You can include this command (along with the qdelete mediaagent command, if required) in a script. Mass deletion of these items is useful if you want to remove the items after you split a CommCell. To mass delete items where the CommCell is not split, be sure to run the script from the install location of the CommServe.
Qdelete dataagent
Description
This command deconfigures or deletes the specified agent.
By default, the qdelete dataagent command asks for confirmation before deletion. You can skip the confirmation prompt using the "-y" option.
Upon completion, qdelete dataagent displays a message that the agent was successfully deleted on the command prompt. In case of an error, an error code and description are displayed as: "dataagent: Error errorcode: errordescription"
Usage
qdelete dataagent -c client -a agent [-deconfigure] [-y] [-tf tokenfile] [-tk token] [-h]
Options
-c |
Client computer name |
-a |
The agent to be deleted (see Argument Values - Agent Types) |
-d |
Deconfigures the agent without deleting it |
-y |
Delete without confirmation |
-tf |
Reads token from a file |
-tk |
Token string |
-h |
Displays help |
Diagnostics
Possible exit status values are:
0 - Successful completion.
1 - CLI usage failures, due to the use of an unsupported option or missing argument.
2 - Any other failure.
Examples
-
Delete an agent named MyDataAgent under client client1.
qdelete dataagent -c client1 -a MyDataAgent This command deconfigures and deletes an agent, do you want to configure (y/n)
-
Deconfigure an agent named MyDataAgent under client client1 without any confirmation.
qdelete client -c client1 -a MyDataAgent -deconfigure - y
Qdelete Backupset
Description
This command deletes a given backup set.
When the backup set to be deleted contains archived data, the command asks the user to confirm the deletion. This prevents the user from accidentally removing backup sets that may have archive jobs. If you want to skip the confirmation prompt, you can use the "-skc" option.
Upon successful completion, the qdelete backupset command displays the message "Deleted backupset successfully" on the command prompt. In case of an error, an error code and description are displayed as: "backupset: Error errorcode: errordescription"
Usage
qdelete backupset -c client -a dataagenttype -b backupset [-skc] [-tf tokenfile] [-tk token] [-af ArgumentFilepath] [-h]
Options
-c |
Client computer name |
-a |
Agent type that is located on the client computer (see Argument Values - Agent Types) |
-b |
Name of the backup set to be deleted |
-skc |
Skips the confirmation prompt to delete the backup set if archived data is found on the backup set. |
-tf |
Reads token from a file |
-tk |
Token string |
-af |
Reads arguments from a file |
-h |
Displays help |
Argument File
client |
Client computer name |
dataagent |
Agent type that is located on client computer (see Argument Values - Agent Types) |
backupset |
Backup set name to be deleted |
Diagnostics
Possible exit status values are:
0 - Successful completion.
1 - CLI usage failures, due to the use of an unsupported option or missing argument.
2 - Any other failure.
Example
Delete a backupset with name bs1 under client client1 and Agent MyDataAgent.
qdelete backupset -c client1 -a MyDataAgent -b bs1
Qdelete Subclient
Description
This command deletes a given subclient.
Upon successful completion, the qdelete subclient command displays the message "Deleted subclient successfully" on the command prompt. In case of an error, an error code and description are displayed as: "subclient: Error errorcode: errordescription"
Usage
qdelete subclient -c client -a dataagenttype -b backupset -s subclient [-tf tokenfile] [-tk token] [-af ArgumentFilepath] [-h]
Options
-c |
Client computer name |
-a |
Agent type that is located on the client computer (see Argument Values - Agent Types) |
-b |
Name of the backup set |
-s |
Name of the subclient to be deleted |
-af |
Reads arguments from a file |
-tf |
Reads token from a file |
-tk |
Token string |
-h |
Displays help |
Argument File
client |
Client computer name |
dataagent |
Agent type that is located on client computer (see Argument Values - Agent Types) |
backupset |
Backup set name |
subclient |
Subclient name to be deleted |
Diagnostics
Possible exit status values are:
0 - Successful completion.
1 - CLI usage failures, due to the use of an unsupported option or missing argument.
2 - Any other failure.
Example
Delete a subclient with name sc1 under client client1 and Agent EX_PB_FOLDER and backupset bs1.
qdelete subclient -c client1 -a EX_PB_FOLDER -b bs1 -s sc1