pleskbackup Commands and Options Reference

 

pleskbackup Commands and Options Reference

http://download1.parallels.com/Plesk/PPP9/Doc/en-US/plesk-9.0-backup-cli-guide/

Location

  • Plesk for Linux/Unix: /usr/local/psa/bin/pleskbackup
  • Plesk for Windows: %plesk_dir%\bin\pleskbackup
    where %plesk_dir% is environment variable for Plesk installation directory. By default, it is "C:\Program Files\Parallels\Plesk".

 

Usage

pleskbackup <command> [<arguments>] [<options>]

 

Commands

 

Command

Argument

Description

--server

 

Backs up whole Plesk server.

--resellers-name

[<login-1> <login-2> <...> <login-n>]

Backs up all data for the resellers specified by logins.

Logins should be separated by spaces, and, if on Windows, enclosed in quotes.

Can be used with the --from-file option. In such case, resellers specified in the file are backed up and resellers specified as command arguments are ignored.

If no logins are specified and the -f option is not used, all resellers are backed up.

--resellers-id

[<ID1> <ID2> <...> <IDn>]

Backs up all data for the resellers specified by IDs.

IDs should be separated by spaces, and, if on Windows, enclosed in quotes.

Can be used with the --from-file option. In such case, resellers specified in the file are backed up and resellers specified as command arguments are ignored.

If no IDs are specified and the -f option is not used, all resellers are backed up.

--clients-name

[<login-1> <login-2> <...> <login-n>]

Backs up all data for the clients specified by logins.

Logins should be separated by spaces, and, if on Windows, enclosed in quotes.

Can be used with the --from-file option. In such case, clients specified in the file are backed up and clients specified as command arguments are ignored.

If no logins are specified and the -f option is not used, all clients are backed up.

--clients-id

[<ID1> <ID2> <...> <IDn>]

Backs up all data for the clients specified by IDs.

IDs should be separated by spaces, and, if on Windows, enclosed in quotes.

Can be used with the --from-file option. In such case, clients specified in the file are backed up and clients specified as command arguments are ignored.

If no IDs are specified and the -f option is not used, all clients are backed up.

--domains-name

[<name-1> <name-2> <...> <name-n>]

Backs up all data for the domains specified by names.

Names should be separated by spaces, and, if on Windows, enclosed in quotes.

Can be used with the --from-file option. In such case, domains specified in the file are backed up and domains specified as command arguments are ignored.

If no names are specified and the -f option is not used, all domains are backed up.

--domains-id

[<ID1> <ID2> <...> <IDn>]

Backs up all data for the domains specified by IDs.

IDs should be separated by spaces, and, if on Windows, enclosed in quotes.

Can be used with the --from-file option. In such case, domains specified in the file are backed up and domains specified as command arguments are ignored.

If no IDs are specified and the -f option is not used, all domains are backed up.

--help

 

Displays help on the utility usage.

 

Exclude Options

Option

Description

--exclude-reseller[=<login1>,<login2>,...]

Skips resellers with the specified logins during backup.

--exclude-reseller-file[=<file>]

Skips resellers listed in the specified file during backup.

--exclude-client=[<login1>,<login2>,...]

Skips clients with the specified logins during backup.

--exclude-client-file=<file>

Skips clients listed in the specified file during backup.

--exclude-domain[=<name1>,<name2>,...]

Skips domain with the specified names during backup.

--exclude-domain-file=<file>

Skips domains listed in the specified file during backup.

 

General Options

 

Option

Description

-v|--verbose

Shows more information about backup process. Multiple -voptions increase verbosity, for the maximum verbosity level, define 5 options.

-c|--configuration

Backs up only configurations of Plesk objects, excluding their content.

-s|--split[=<integer>[K|M|G]]

Splits the backup files into parts of the specified size. The parts are numbered by appending numerical suffixes starting with.1.

Size is specified in Kbytes, Mbytes or Gbytes. If none is defined, then interpreted as being in bytes.

If no argument is specified, default value of 2 Gbytes is used.

-z|--no-gzip

Sets that objects content is archived without compressing.

--only-mail

Backs up only mail configuration and content.

When used with the resellers|clients|domains-login|id commands, backs up configuration of domain-level mail system, and content and configuration of mail accounts.

When used with the server command, backs up also server-wide mail configuration.

Cannot be used together with the --only-hosting option.

--only-hosting

Backs up only physical hosting configuration and Web site content, including site applications, databases and subdomains.

Cannot be used together with the --only-mail option.

--suspend

Suspends domains during backup operation.

-f| --from-file=<file>

Backs up resellers|clients|domains listed in the specified file, ignoring those specified in the command line as arguments.

The file should be in plain text format and should contain a list of resellers|clients|domains, one per line.

Used only with the resellers-nameresellers-id,clients-nameclients-id, domains-name,domains-id commands.

Depending on the command, resellers|clients|domains are listed in the file by either logins or IDs.

--skip-logs

Sets that log files are not saved to backup.

--prefix=<string>

Adds specified prefix to the backup files names.

Used to customize backup file name which is created with thebackup prefix by default.

 

FTP Options

 

Option

Description

--ftp-login=<ftp_login>

Specifies FTP login that will be used for uploading backup file to the FTP server.

--ftp-password=<ftp_password>

Specifies password that will be used for uploading backup file to the FTP server.

 

Output File Option

 

Option

Description

--output-file

Exports backup as a single file to stdoutand removes backup from Plesk repository.

--output-file=<fullpath/filename>

Exports backup as a single file with the specified name to a local file system and removes backup from Plesk repository.

--output-file=<ftp://[<login>[:<password>]@]<server>/<filepath>>

Exports backup as a single file to the specified FTP server and removes backup from Plesk repository.

The FTP_PASSWORDenvironment variable can be used for setting password.

The --ftp-login and--ftp-password FTP options can be used for setting login and password.

Leave a comment