Managing Plesk Backups

Operator: <backup-manager>

XML Schema: backup.xsd

Plesk version: 9.0

API RPC version: 1.6.0.0

Plesk user: Plesk Administrator, Plesk reseller, Plesk client

Description

Important: This operator has no backward compatibility. The current version of the operator described in this section requires Plesk 9 and API RPC 1.6.0.0 (or later versions). To see the description of the earlier operator version compatible with Plesk 8.4 - 8.6, refer to http://download1.parallels.com/Plesk/Plesk8.6/Doc/en-US/plesk-8.6-api-rpc/index.htm

Backup is a file containing a copy of data that is used to restore the original. In Plesk API RPC, you can manage backups of Plesk accounts or entire Plesk server by the backup-manager operator. One backup may be divided into two or more files. You can use Plesk repository (local storage) or remote FTP servers to store backup files. Protocols other than FTP are not supported in the current realization.

Backups are divided into four groups:

• Domain-level backup. It includes the following:
  • Domain-related content
  • Domain account configuration (limits and permissions on resources, domain administrator personal data, etc.)

• Client-level backup. It includes the following:
  • Domain-level backups of all domains owned by a client
  • Client-level configuration which includes configuration of the client account its subordinary domain accounts

• Reseller-level backup. It includes the following:
  • Client-level backups of all clients owned by a reseller
  • Reseller-level configuration which includes configuration of the reseller account and client-level configurations of all its subordinary client accounts

• Server-level backup. It includes content of all domain accounts on the server and server-level configuration - configuration of Plesk server and all user accounts.

To back up Plesk data, you need to create an instance of the process called backup task with appropriate arguments defining what will be included into backup. If a backup task is successfully completed, the corresponding backup is created. You can monitor the status of backup tasks or cancel them.

Supported operations

• GET-REMOTE-STORAGE-SETTINGS retrieves settings of a remote FTP storage
• SET-REMOTE-STORAGE-SETTINGS changes settings of a remote FTP storage
• BACKUP-DOMAIN creates a domain-level backup task
• BACKUP-CLIENT creates a client-level backup task
• BACKUP-RESELLER creates a reseller-level backup task
• BACKUP-SERVER creates a server-level backup task
• GET-TASKS-INFO retrieves the status of a certain backup task
• GET-LOCAL-BACKUP-LIST retrieves a list of backups stored in a local repository
• IMPORT-FILE moves backups from a temporary directory on Plesk server to a local repository
• DOWNLOAD-FILE downloads a backup from the server
• GET-SUPPORTED-PROTOCOLS retrieves transport protocols supported by the backup-manager operator
• STOP-BACKUP cancels a certain backup task
• REMOVE-FILE removes a specified backup from a repository