scheduled-backup: Managing Scheduled Backup Tasks
The scheduled-backup utility is used for managing scheduled backup tasks on a Plesk server.
Usage
scheduled-backup <command> [<arguments>] [<options>]
Example
The following command configures creating weekly backups of the Plesk server every Friday:
plesk bin scheduled-backup --configure weekly -backup-weekday friday
Commands
Command |
Argument |
Description |
Example |
|---|---|---|---|
|
|
Enables the specified scheduled backup task. |
To enable the daily scheduled backup task on the Plesk server: plesk bin scheduled-backup --enable daily |
|
|
Disables the specified scheduled backup task. |
To disable the monthly scheduled backup task on the Plesk server: plesk bin scheduled-backup --disable monthly |
|
|
Configures the specified scheduled backup task. |
To configure running of the weekly scheduled backup task on the Plesk server at 01:15 a.m.: plesk bin scheduled-backup --configure weekly -backup-time 01:15 |
|
|
Runs the specified scheduled backup task. |
To run the hourly scheduled backup task on the Plesk server: plesk bin scheduled-backup --run hourly |
|
Shows the list of scheduled backup tasks. |
To see the list of scheduled backup tasks on the Plesk server: plesk bin scheduled-backup --list -server |
|
|
|
Displays the help reference for the utility. |
To see the utility help: plesk bin scheduled-backup --help |
Options
Option |
Parameter |
Description |
Example |
|---|---|---|---|
|
Specifies a server-level scheduled backup task. This is the default option. Used only with the |
To enable the monthly scheduled backup task for the whole Plesk server: plesk bin scheduled-backup --enable monthly -server |
|
|
|
Specifies the reseller whose scheduled backup tasks will be affected by the command. Used only with the |
To run the hourly scheduled backup task of the reseller John Doe: plesk bin scheduled-backup --run hourly -reseller jdoe |
|
|
Specifies the customer whose scheduled backup tasks will be affected by the command. Used only with the |
To disable the weekly scheduled backup task of the customer John Doe: plesk bin scheduled-backup --disable weekly -customer jdoe |
|
|
Specifies the domain's subscription whose scheduled backup tasks will be affected by the command. Used only with the |
To enable the monthly scheduled backup task of the domain “example.com”: plesk bin scheduled-backup --enable monthly -subscription example.com |
|
Specifies all scheduled backup tasks of the Plesk server. Used only with the |
To see the list of all scheduled backup task on the Plesk server: plesk bin scheduled-backup --list -all |
|
|
|
Specifies where backup files will be stored. Used only with the |
To store daily backup files on the Plesk server: plesk bin scheduled-backup --configure daily -storage server |
|
|
Enables/disables storing of backup files both on the Plesk server and the remote storage. Used only with the |
To enable storing daily backup files both on the Plesk server and the remote storage: plesk bin scheduled-backup --configure daily -keep-in-server-storage true |
|
|
Specifies the frequency (in hours) of creating hourly scheduled backups. Used only with the |
To make Plesk create an hourly backup every 3 hours: plesk bin scheduled-backup --configure hourly -backup-hourly-period 3 |
|
|
Specifies the exact time of the day for creating a scheduled daily, weekly, or monthly backup. Used only with the |
To make the Plesk server create daily backups at 5:30 a.m.: plesk bin scheduled-backup --configure daily -backup-time 05:30 |
|
|
Specifies the day of the week for creating a scheduled weekly backup. Used only with the |
To make the Plesk server create weekly backups on Saturdays: plesk bin scheduled-backup --configure weekly -backup-weekday saturday |
|
|
Specifies the day of the month for creating a scheduled monthly backup. Used only with the |
To make the Plesk server create monthly backups on the last day of the month: plesk bin scheduled-backup --configure monthly -backup-day last |
|
|
Enables/disables creating scheduled incremental backups. Used only with the |
To disable creating scheduled daily incremental backups on the Plesk server: plesk bin scheduled-backup --configure daily -incremental false |
|
|
Specifies the frequency of creating a scheduled full server backup. Used only with the |
To make the Plesk server create full server backups every month: plesk bin scheduled-backup --configure daily -full-frequency monthly |
|
|
Specifies the number of periods, during which a full server backup is stored. A period is the time between creating scheduled full server backups. For example, if a full server backup is created every week and the specified option value is 4, then the full server backup will be removed after 4 weeks. Note To disable automatic removal of full server backups, leave the option value empty. Used only with the |
To store full server backups created on a monthly basis for 3 months: plesk bin scheduled-backup --configure monthly -full-retention 3 |
|
|
Enables/disables backing up of emails during scheduled backup tasks. Used only with the |
To disable backing up of emails on a daily basis: plesk bin scheduled-backup --configure daily -exclude-mail true |
|
|
Enables/disables backing up of user files during scheduled backup tasks. Used only with the |
To disable backing up of user files on a daily basis: plesk bin scheduled-backup --configure daily -exclude-user-files true |
|
|
Enables/disables backing up of databases during scheduled backup tasks. Used only with the |
To disable backing up of databases on a weekly basis: plesk bin scheduled-backup --configure weekly -exclude-databases true |
|
|
Enables/disables backing up of log files during scheduled backup tasks. Used only with the |
To disable backing up of log files on a daily basis: plesk bin scheduled-backup --configure daily -exclude-log-file true |
|
|
Specifies the list of files that must not be backed up during scheduled backup tasks. Used only with the |
To prevent temporary files and draft documents from being backed up during daily scheduled backup tasks: plesk bin scheduled-backup --configure daily -subscription example.com -exclude-files-list tmp,docs/draft* |
|
|
Enables/disables splitting backups stored on remote storage into multiple volumes. Used only with the |
To enable splitting daily backups on remote storage into multiple volumes: plesk bin scheduled-backup --configure daily -multivolume true |
|
|
Specifies the size of each multi-volume backup file in megabytes. Used only with the |
To set the volume size of daily backups to 1024 megabytes: plesk bin scheduled-backup --configure monthly -volume-size 1024 |
|
|
Enables/disables sending email notifications about errors during execution of scheduled backup tasks. Used only with the |
To enable sending emails about errors during execution of scheduled daily backup tasks: plesk bin scheduled-backup --configure daily -send-email-on-errors true -email jdoe@mail.com |
|
|
Specifies the email address to which notifications about errors during execution of scheduled backup tasks must be sent. Used only with the |
To send emails about errors that occurred in scheduled daily backup tasks to jdoe@mail.com: plesk bin scheduled-backup --configure daily -send-email-on-errors true -email jdoe@mail.com |
|
Displays the output in the JSON format (if true) or in plain text format (if false). Used only with the |
To display the list of scheduled backup tasks in the JSON format: plesk bin scheduled-backup --list -json |