This guide details how to back up the data from your folders and nodes Jelastic Cloud via the OpenStack Swift protocol on Swiss Backup, the backup solution in an independent Swiss cloud.

Preamble

• To back up the data, an extension for Virtuozzo (Jelastic Cloud) is available in the node addons.
  • Learn more about the extension (add-on) on Github.
  • Do not look for the extension in the Marketplace, it is not there.
• The various services offered by Infomaniak are all compatible with the corresponding standard protocols (S3/Swift for storage, for example), therefore if you encounter a problem with third-party software, contact its publisher or a Partner and consult the support policy as well as article 11.9 of the Infomaniak TOS.

Configure the Swiss Backup extension on Jelastic Cloud

Prerequisites

• Use Jelastic Cloud (at least one Jelastic environment must be active with the extension installed for your backups to be visible).
• Have a Swiss Backup Infomaniak space with a quota of available devices (minimum 1) for a Cloud backup.
• Add 1 device of type Cloud to obtain the OpenStack Swift parameters.

To add the extension useful to Swiss Backup on Jelastic Cloud:

1. Log in to the Jelastic Cloud Dashboard of your server.
2. Go to the node addons section:
   
3. Search for and install the Backup / Restoration extension:
   
    

Two types of backups are then possible and detailed below:

1. Back up specific folders.
2. Create a snapshot of an entire node.

Back up specific folders

To back up specific directories:

1. Enter the username and password according to the information specific to your device.
2. Check Backup your data.
3. Check Backup specific folders
4. Enter the absolute path of the folders to back up in the Folders to backup field; it is possible to specify multiple folders by separating each path with a comma, for example: /root/admin/, /home/user1/, /jelastic/containers/ (in this example, 3 folders have been specified)…
   ‍

Next, you need to define the frequency of backups (read more below).

Back up an entire node

To back up an entire node:

1. Enter the username and password of your Swift device on Swiss Backup.
2. Check Backup your data.
3. Check Backup all files to back up the entire file system of a node; some files are automatically excluded:
   • the folders /dev,/proc, /sys, /run
   • unmounted file systems as part of the root partition, including virtual file systems
     

Next, you need to define the frequency of backups.

Define backup frequency and retention policy

Two options are available to perform the backup:

1. daily (at 20h UTC)
2. every hour (at the start of the hour, for example at 13h, 14h, etc.)

You can define the retention period of your backups in years, months, days, and hours. To keep your backups indefinitely, simply set the parameters to 0.

If, for example, you perform backups every hour and set a retention policy of 1 year, 2 months, 4 days, 2 hours, this means that each backup will be available for a period of 1 year, 2 months, 4 days, 2 hours (=10322 backups). Note that backups are deleted every Sunday at 22h30 (UTC).

Restore backups

Restore data from a node

1. Log in to your server's Jelastic Dashboard.
2. Once the extension is added and the username and password of your Swift device on Swiss Backup are provided, check Restore your data.
3. Select the node containing the backup to restore:
   
4. Select the backup to restore and the restore folder.
5. Click the Restore button:
   

Restore specific folders from a snapshot (CLI)

Each backup corresponds to a unique ID. You can include and exclude folders from your snapshots during a restore. To view your snapshots:

1. . /home/.config/swissbackup/openrc.sh
2. restic snapshots
   
3. Use --exclude and --include to restrict the restore to a subset of files in the snapshot. For example, to restore a single file: restore 79766175 --target /tmp/restore-work --include /work/foo

There are case-insensitive variants of --exclude and --include called --iexclude and --iinclude. These options work the same way but ignore the case of the paths.

Modify the backup configuration

To do this:

1. Log in to your server's Jelastic Dashboard.
2. Once the extension is added and the username and password of your Swift device on Swiss Backup are provided, modify the configuration as desired.

The backup schedule is set by a cron job, and backups are performed using the restic tool.

To manually modify the backup schedule (CLI), as a root user, run the command crontab -l to display the current times:

• The line containing retention-all.sh corresponds to the backup task
• The line containing purge.sh corresponds to the backup retention task

Example:

Modify the schedule using the command crontab -e.

You can modify the line composed of the script retention-all.sh or retention.sh, these scripts correspond to the launch of your backups. Warning: the crons have been designed to avoid issues between backups and multiple deletions. Be mindful of the time required for backups and deletions…

• Learn more about cronjobs: crontab.guru
• Learn more about restic: restic.net

Manually delete backups (CLI)

To do this:

1. Source the configuration file:
   . /home/.config/swissbackup/openrc.sh
2. Display available backups:
   restic snapshots
3. Delete the desired backup:
   restic forget IdBackup --prune
4. Delete all backups of a file except one:
   restic forget --tag folders --keep-last 1 --prune

Delete backup scheduling

This button allows you to delete the scheduling of your backup:

Uninstall the Swiss Backup extension

It is necessary to delete the backup scheduling (see above) before being able to delete the Swiss Backup extension: