Settings
General Settings
Debug Active
Error Reporting
Workspace Directory
/usr/local/jetapps/usr/jetbackup5/workspace ]Download Directory
/usr/local/jetapps/usr/jetbackup5/downloads ]Delete orphan backups older than
Downloads TTL
Set the preferred number of days to store downloads generated in JetBackup. [ default: 0 days (Don't delete) ]
Days to keep logs history
Days to keep alerts
Manual Backups Retain
Manual Backups TTL
Performance
Concurrent Restore / Download / Reindex Tasks
Set the maximum concurrent account restores, downloads, or destination reindex tasks that can run simultaneously. Please note that for each account restored/downloaded or destination reindexed, JetBackup will open a fork on the server. (Maximum 10 accounts)
Concurrent Backup / Clone Tasks
Set the maximum concurrent account backups or account clone tasks that can run simultaneously. Please note that for each account, JetBackup will open a fork on the server. (Maximum 10 accounts)
Important: Each fork created for concurrent restores/downloads/backups can use up to 100% CPU usage per core.
Backup Fork TTL
Set the maximum time a Backup Fork can run in hours. The fork will automatically abort once it reaches the specified TTL, regardless of its current status.
Only enable this setting if you know how long the largest account on your server takes to complete its backup. Setting this too low may potentially result in some account backups being aborted prematurely.
Limit Accounts Downloads
Select the number of downloads that you permit to keep for each account.
Queue Priority Groups
NOTE: JetBackup prioritizes restores by the account type out of the box along with the Queue Priority Groups setting that controls backup, restore and download priority. For more Information regarding JetBackup 5's priority systems, please CLICK HERE.
To add a new queue priority group, click "+Create New Queue Priority". On the subsequent page, specify a unique queue priority group name and corresponding priority value (the lower the value, the higher the priority) then hit "Save"
For more information on how to set the queue priority for each account(s), please visit Manage Account.
Queue Priority Settings
Manage Queue Priority
Delete Queue Priority
Make sure that the queue priority group is not assigned to any account(s) and is not set as the default priority group in order to delete it.
Set as Default
Directory Queue Priority Group
Set the queue priority group for directory-based tasks in relation to accounts queue priority groups.
MySQL Settings
MySQL Dump max allowed packet
MySQL Dump force flag
MySQL Dump opt flag
MySQL Dump skip lock table flag
Continue even if we get a lock table error.
Resource
Set server resource limits of JetBackup processes using CGROUPS Please note that 100% is one core. For more information on analyzing your current server load please visit Load WIKI
CPU Limit
Limit the CPU Usage of JetBackup Processes. [ min: 5%, default: unlimited ]
IO Read Limit
Limit the IO Read Usage of JetBackup Processes. [ default: unlimited ]
IO Write Limit
Limit the IO Write Usage of JetBackup Processes. [ default: unlimited ]
Restore
Restore Conditions
To create new restore condition, click on "Manage Restore Conditions" and click "Create New Restore Condition" on the following page.
File Permissions
To create new File Permissions, click on "Manage File Permissions" and click "Create New File Permission" on the following page.
Privacy & Security
Server Master Encryption Key
JetBackup uses an encryption key to secure valuable data. This key is required during Disaster Recovery to successfully decrypt and import JB Config backups. Please be advised, there is no way to restore from DR without this key and it's important to keep this key on a secure remote location.
User Agreement
Privacy Policy
Account Encryption Selection
With this option disabled, Encrypted Backups for each account will have their associated Encryption Key stored locally.
The right to be forgotten
Panel
Panel Options
Panel options may vary based on the control panel you're using. See the "Control Panels" column for the Panels a setting applies to.
To create API Access Tokens for the Linux Panel, see API Access Tokens (Linux).
| Setting Name | Description | Category | Control Panel(s) | Default Value | ||||||||||||
|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
| Default Package | Specify the default package JetBackup will assign when restoring an account if the package information on the account's backup is not found on the panel. | cPanel/WHM, DirectAdmin | None | |||||||||||||
| Default IP Address | Specify the default IP address JetBackup will assign when restoring an account if the IP address information on the account's backup is not found on the panel. | cPanel/WHM, DirectAdmin | None | |||||||||||||
| Default Owner | Specify the default owner JetBackup will assign when restoring an account if the owner information on the account's backup is not found on the panel. | cPanel/WHM, DirectAdmin | None | |||||||||||||
| API Timeout | Specify the default API timeout for DirectAdmin API calls. | DirectAdmin | 30 Seconds | |||||||||||||
| Default Databases Backup Account | Specify the default account to backup ALL unassigned databases to. See Manage Databases documentation to auto-assign or manually assign databases to accounts. | Settings | Linux | None | ||||||||||||
| MySQL Authentication Details | Specify your MySQL Authentication credentials to backup MySQL Databases. | Databases Auth | Linux |
|
||||||||||||
| MongoDB Authentication Details | Specify your MongoDB Authentication credentials to backup MongoDB Databases. Be sure to specify the Auth Database where the specified Username has been created. | Databases Auth | Linux |
|
||||||||||||
| PostgreSQL Authentication Details | Specify your PostgreSQL Authentication credentials to backup PostgreSQL Databases. | Databases Auth | Linux |
|
API Access Tokens (Linux)
In order to communicate with the JetBackup API on Linux (Standalone) servers, you must first create an API Access Token. After creating the Token, you can pass it in the request header to authenticate and run API commands on your server.
API Access Tokens can be created in the following configurations:
- Any user allowed from defined IP address.
- Any user allowed from any IP Address.
- Specific user allowed from any IP address.
- Specific user allowed from defined IP address.
Running an API command as a certain user will use their set permissions. Please refer to Permissions to assign to modify permissions assigned to an account. Please use caution when creating an unrestricted token, and keep the token saved in a secure location. For security, we recommend restricting by account and IP address.
curl -kv -H "Authorization: Bearer user1:oXBbdPuFmEtJZGYV6XQlLaxGdWm4InOQ" "https://HOST_NAME:3035/?api=1&function=getMyAccount"
NOTE: Failed/Invalid authentication will return HTTP status code 401 Unauthorized.
Create New Access Token
Description:
Enter a description for the Access Token. Used internally for your convenience. (Required)
IP Address:
Enter an IP Address to restrict token use to that IP address. Leave blank to allow all IP addresses to access the API using this token.
Account:
Restrict the Access Token to a specific Account. (Can be root)
If blank, allows you to use that token to run API commands as the user using that accounts permissions.
Please refer to Permissions to assign or modify permissions assigned to an account.
Access Token Details
Delete Access Token
Remove the selected access token.
Manage Access Token
Modify the selected Access Token Details.
Created
The date/time the token was created.
Token
The access token used to authenticate remote API calls, and a short description. This will only be displayed once when creating the token.
IP Address
The IP of the machine the user will be doing remote API calls from.
Account
The account the API token is restricted to perfoming remote API calls as.
Last Access
The most recent time and IP address from when the token was used.
Backup on Demand
Backup on Demand gives your users the ability to create a point-in-time full account snapshot of their account(s). On-demand backups are useful right before making any changes to a user's site, email, databases, etc. If necessary, they can conveniently roll back to the recent on-demand backup instead of restoring the last scheduled backup.
The following settings control the global Backup on Demand settings.
Backup Job
Choose the backup job to use for backups on demand. The backup job must be enabled to be selected.
Maximum Backups per Account
The global maximum On Demand backups allowed for each account. [Max: 99]
You can adjust Account specific Backup on Demand settings under Manage Account.
How Long Keep Snapshots
Set the amount of days to keep backup on demands on destinatons.
Automatically disable backup on demand in the following cases
JetBackup will disable the option of creating snapshots for Users and Resellers if they meet the conditions specified in this section.
Please Note: The first condition that hits will trigger the disable.
- Disk Space: If an account is greater than or equal to the set Disk Space limit, they will not be able to generate a Backup on Demand.
- Inodes: If an account has more inodes than the set limit, they will not be able to generate a Backup on Demand.
Please ensure your server is able to report Disk Space Usage, and Inodes for each account. For JetBackup 5 Linux users, please see: Disk Usage/Inode Usage N/A on JetBackup 5 for Linux. Panel versions of JetBackup will gather the details from the Panel API.
Notification
Click on "+ Create New Notification Integration" to set up your notifications. Under Integration Type, you can select the Notification Plugin you would like to use to send JetBackup alerts. JetBackup comes with the Email Notification Integration installed by default. Below is a sample setup of an Email Integation:
Create New Notification Integration (Email)
Integration Type
The Type of Notification Integration you would like to set up.
Integration Name
Owner
Alert Levels
Recipients
Email Server
SMTP Settings:
SMTP From Email - Reply-to email address.
SMTP Host - SMTP email server hostname.
SMTP Port - SMTP email server port.
SMTP Username - SMTP username.
SMTP Password - SMTP password.
SMTP Secure - SMTP encryption protocol. (None/SSL/TLS)
- Verify SSL - SSL verification on SMTP connection.
SMTP Timeout - Authentication connection timeout in seconds.
Notification Plugins
On top of email notifications, you also have the option to install and activate additional notification plugins to integrate with JetBackup. Click Here for a list of notification plugins available by default and instructions on how to setup each.
Binary Locations
