BackWPup 文档

How to convert bzip2 file to zip file

How to convert bzip2 file to zip file
Previous versions of BackWPup were shipped with support for bzip2 (bz2), a common algorithm used to compress files and directories. This means that in previous versions it was possible to create bz2 backup archives. In this documentation we want to explain how to convert bzip2 to zip file to make a restore with BackWPup.
The reason why the bz2 format is not anymore supported is because even if php supports this algorithm, its implementation doesn』t give the possibility to decompress large backup archives in a manner that allows us to extract the archive by chunk. So it is not possible to open the archive, extract the files and then open again the archive and extract other files. Everytime we open the archive we must read it from the beginning.
Hence we stopped to support such a format.
For this and other reasons we discourage you to use bz2 compression.
Convert bzip2 file to zip before restoring the backup
Anyway, if you have created a backup using bz2 with a previous plugin version you must convert it to .zip or .tar.gz or .gz before you start to restore it.
We suggest you to convert to .zip that is the most supported algorithm unless you don』t have ZipArchive in your server. In that case a .tar.gz could be the best solution.
To convert the bz2 file into a zip one you can use an application such as 7zip for windows or a service like cloudconvert. If you are running macOs or a linux you can take advantage of the built in support of these systems.
After you have converted the backup go to BackWPup → Restore page within the WordPress backend and upload the file.
The restore will take care of the rest.
If you need more help on this topic, don』t hesitate to contact us on wordpress.org for free support or on backwpup.com/support if you bought the Pro version.

How to install BackWPup Pro and activate your licence

How to install BackWPup Pro and activate your licence
The installation of BackWPup works just like any other WordPress plugin. You can install it via the WordPress backend or upload the files via FTP.

Table of Contents

Installing BackWPup ProDownload BackWPup ProInstallation via WordPress admin areaInstallation via FTPHow to activate your BackWPup Pro licence?
1. Installing BackWPup Pro
1.1. Download BackWPup Pro
First, get the BackWPup Pro zip file and download it to your computer.
You can buy the Pro version on BackWPup.com. After the purchase, you can find the zip file in your BackWPup account:

Log in to BackWPup.com with the credentials you got via email.
In the upper right corner, click on My Account . You can find the plugin zip file in the API Downloads section.
Download BackWPup Pro to your computer.

Important: If you want to upgrade the free version to BackWPup Pro, please have a look at our guide 「How do I upgrade BackWPup Free to BackWPup Pro?「, so you don』t lose your plugin settings.
1.2. Installation via WordPress admin area

Log in to your WordPress installation.
Go to Plugins → Add new.
Click the Upload Plugin button and upload the BackWPup Pro zip file from your computer.
Click on Install now and wait until WordPress says the plugin was installed successfully.
You can activate the plugin immediately with clicking on Activate now on the success page. If you want to activate it later, you can do so via Plugins → Installed Plugins.
In section 2 we show you how to activate your BackWPup Pro licence.

1.3. Installation via FTP
Do you have trouble installing BackWPup Pro via the WordPress admin area? Then try it via FTP. For this you need an FTP program, like Filezilla.

Unzip the BackWPup Pro zip file on your computer.
Connect to your web server via the FTP program.
Upload the unzipped BackWPup Pro folder to the /wp-content/plugins folder of your WordPress.
Installation via FTP
Log in to WordPress and activate BackWPup Pro via Plugins → Installed Plugins.

2. How to activate your BackWPup Pro licence?
In the BackWPup Pro admin menu click on Settings and then select the License tab: you will be redirected to the activation page, where you can enter your Master API Key and Product Id.
If your BackWPup version is minor or equal to 3.7.0, the info here reported cannot be applied. Please instead refer to this doc: BackWPup License Update.
To get your licence data, please log in to your account on backwpup.com  and visit the My Account page. Master API Key and Product Id are listed on the My Account Dashboard.

What do I need to get BackWPup running smoothly?

What do I need to get BackWPup running smoothly?
To have BackWPup running smoothly on your website, it should meet the following requirements:

At least WordPress 3.9
At least PHP 5.6
To get the full functionality of this plugin:

PHP 5.6
mysqli
FTP
gz
ZipArchive
curl

Even if your website doesn』t offer the features listed under 3., BackWPup can be used. In this case the features which use these requirements will be not available.

How do I create a Dropbox account?

How do I create a Dropbox account?
To use Dropbox as destination to store backups, you only need a free Dropbox account, if the available space of 2 GB is enough for you.
If you already have a Dropbox account, you can of course use it for the backups.
To create a new Dropbox account, do the following steps:

Visit dropbox.com and register with your full name, e-mail address and password.
Visit dropbox.com and register
Check the I agree to Dropbox terms box. Click on Sign up.
You got an email confirming the registration. Follow the instructions there to finish the registration.
You got an email for confirming the registration
Now you can access your Dropbox Dashboard, where you can store, manage and share files.
Now you can access your Dropbox Dashboard
In the browser you will get a link to the paid version for a trial period or, if you want to use the free basic plan, you can click on the related link. This way you could download and install the Dropbox app into your computer selecting the version that fits your Operative System.

How do I activate my BackWPup Pro license?

How do I activate my BackWPup Pro license?
If your BackWPup version is minor or equal to 3.7.0, the info here reported cannot be applied. Please instead refer to BackWPup License Update .
If instead your version is above 3.7.0, you can follow the instructions reported here below.

Please log in to your BackWPup customer account. You will find your license on the page My account  in the section Dashboard or API key. Copy the license (Master API Key) to the clipboard.
Log in to WordPress and go to BackWPup Pro → Settings and select the License tab.
Paste the license key from the clipboard into the field Master API Key.
Go back and copy the Product ID as well and paste it into the field Product ID.
Save your changes.

In your customer account, go to the section Dashboard or API Keys or otherwise have a look at BackWPup Pro → Settings via the backend in the License tab to see if your license was activated successfully.
How do I activate my BackWPup Pro license?
I get error message 「Exceeded maximum number of activations」
You can only activate BackWPup on as many WordPress Installations as you have licences available.  If you get this error message, you already activated all licences you bought. You need to delete an activation via your backwpup.com account or via your WordPress backend before you can activate again.
Troubleshooting: If you have troubles activating or deleting your licence via your WordPress backend, please check your account dashboard at backwpup.com to ensure the licence is not active in the shop on the same domain.
If you see the licence activated, delete the activation via your my account and try to activate again via your WordPress backend.

What does BackWPup do?

What does BackWPup do?
To save your site from a crash, you should back up your WordPress website regularly. There are many reasons for data loss, for example when your website is hacked or you deleted content accidentally. In this case you need to recover your website before these things happened – a backup previously done before can help you with that.
There are many tools, that can create backups and restore them. For databases, you can use phpMyAdmin or the WordPress plugin Adminer. For files, you can use the FTP program FileZilla.
You need some experience on these things. It also takes you some time to get everything together and you will not do it regularly. You don』t need to struggle with all that, as there are automated solutions, like BackWPup! After a one time setup, backups are done regularly by the WordPress system and you can sleep well at night.

Table of Contents

Automated Backup for WordPress with BackWPupBackWPup Pro Features
1. Automated Backup for WordPress with BackWPup
The backup plugin BackWPup can be used to save your complete installation including /wp-content/ and push them to an external Backup Service, like Dropbox, S3, FTP and many more, see list below. With a single backup .zip file you are able to easily restore an installation.
BackWPup is available as a free version as well as a paid Pro version.
Please note: the free version offers not the same support as the BackWPup Pro Version. With our Pro version, you get first-class support and more features. A comparison of the free and Pro version can be found at the article 「What is the difference between BackWPup Free and BackWPup Pro」 in our documentation.
2. BackWPup Pro Features
An overview of the most important features of BackWPup:

Database Backup (needs mysqli)
WordPress XML Export
Generate a file with installed plugins
Optimize Database
Check and repair Database
File backup
Backups in zip, tar, tar.gz format (needs gz, ZipArchive)
Store backup to directory
Store backup to FTP server (needs ftp)
Store backup to Dropbox (needs curl)
Store backup to S3 services (needs PHP 5.6, needs curl)
Store backup to Microsoft Azure (Blob) (needs PHP 5.6, curl)
Store backup to RackSpaceCloud (needs PHP 5.6, curl)
Store backup to SugarSync (needs curl)
PRO: Store backup to Amazon Glacier (needs PHP 5.6, curl)
PRO: Store backup to Google Drive (needs PHP 5.6, curl)
PRO: Store backup to HiDrive (needs PHP 5.6, curl)
PRO: Store backup to OneDrive (needs PHP 5.6, curl)
PRO: Complete Automatic Restore (needs PHP 5.6, curl)
PRO: Standalone App for Emergency Restore (needs PHP 5.6, curl)
PRO: Encrypt Backup Archives (needs PHP 5.6, curl)
PRO: Restore Encrypted Backups (needs PHP 5.6, curl)
Send logs and backups by email
Multi-site support only as network admin
Pro version and support available – BackWPup Pro

Remember: The most expensive backup is the one you never did! And please test your backups!

How can I renew my BackWPup licence?

How can I renew my BackWPup licence?
If you have purchased BackWPup Pro via backwpup.de or backwpup.com, you don』t have to do anything for the licence renewal. At the purchase a subscription is created, which automatically renews your licence so you don』t have to take care of this every year.
Of course, you may cancel your subscription at any time at the end of the billing period in your account.
You can find an overview of your orders and subscriptions on the My Account page with a link to a detailed view.
If you have any questions regarding the licences or subscriptions, please contact us via our contact form. After the purchase, you can open a support ticket at the support site.

Download and delete backups

Download and delete backups
You can find all existing backup archives, except for the ones with the backup destination Email, on the BackWPup → Backups page. Over here, you can download and delete the backup archives, without going to the actual backup destination.
Choose a destination from the drop down next to the button Change destination, to select all available archives for this destination. The links for download and deletion of the archive appear below the archive name when you hover over a row with your mouse.
BackWPup → Backups page

Create a WordPress full backup: Database and files

Create a WordPress full backup: Database and files
BackWPup not only allows you to automatically back up your WordPress website, but also to make detailed decisions about exactly what you want to back up. The simplest way – which we recommend to BackWPup novices – is to set up a WordPress Full Backup , i.e. of the entire database and all files.
It means that if something goes wrong, you still have everything in your backup and don』t have to reinstall anything manually – as would be the case if you exclude your plugins to save disk space.
Back up WordPress completely
Once you have installed  BackWPup, create a new job by going to BackWPup Pro → Add New job via the backend.

Create a name for your backup job in the tab 「General」.
Under Job details, select all checkboxes or at least the first two: Database Backup and File Backup. Here』s what the individual points mean:

Database Backup – backs up the database of your WordPress installation. That is where information specific to your installation is stored: users, posts and pages, products, orders etc. A backup of this database is vital, as this information cannot be found anywhere else.
File Backup – backs up the files of your WordPress installation. These include WordPress files, themes and plugins, as well as your uploaded images.
WordPress XML export – exports some information from your database to an XML file, which can then be loaded into another installation via Tools →  Import Files. It allows you, for example, to transfer your blog entries and pages to another blog. For beginners, using an XML file is a lot easier than going via the database.
Installed plugins list – this is simply a list of the plugins installed in the blog; if things go wrong, it shows you which plugins you will have to reinstall manually. You won』t need the list if you do a complete backup of the database and files.
Check database tables – the system checks for corrupt data during the backup process and repairs them, depending on your settings in the tab Database Check.

Under Job details, select all checkboxes or at least the first two: Database Backup and File Backup
Select the backup destination in the section Job Destination. More information about backup destinations can be found in the category Backup Destinations.All other settings in the tab General can be left as they are.The settings you have configured now should be sufficient for creating a full backup. Each of the tabs contains more detailed settings and if you aren』t ready to back up all files as yet, you can exclude specific directories or files in the tab Files.
To start your backup job, please follow our guide Starting a backup job – immediately or scheduled.

How do I use the BackWPup Restore feature?

How do I use the BackWPup Restore feature?
The BackWPup restore feature allows the simple restore of your WordPress backup in only a few steps. The restore functionality is only integrated into the BackWPup PRO version of our backup plugin. In this documentation we explain how you restore your WordPress backup with the BackWPup restore feature.
Attention: Only backups made with BackWPup are restorable with the BackWPup restore feature.
There are two different ways how to use the BackWPup restore feature. On the one hand you can go to the menu point Backups and then use the link Restore which is directly displayed below the backups. On the other hand you can upload and restore a backup by using the menu link Restore. In this documentation we will present both ways. Moreover we will explain the functionality of a couple of useful files and directories.

Table of Contents

Use the BackWPup restore feature with the menu link RestoreRestore a backup directlyI have no access to my WordPress installation. Well, how shall I use the BackWPup restore feature?BackWPup Pro licence key is missing after restoring the websiteBackWPup restore feature: Important files and directoriesRestore.logRestore.datUpload directoryExtract directory.htaccess.donotbackup
1. Use the BackWPup restore feature with the menu link Restore

Go to BackWPup Pro → Restore.
First, you need to upload the zip file of the backup you want to restore. You can either add it via drag & drop or use the button select archive. In case you don』t know where you can get the zip file from, read this documentation.
Upload your backup archive.
Attention: Take care of the backup that you upload. The one you restore is going to overwrite your website. So, check out whether you uploaded the correct backup.

When you uploaded the backup archive successfully, you need to decide between these two possibilities:
Choose between a full restore and a database restore.
Now you can choose whether you want to make a database restore or a full restore. When you decide to make a database restore, you are only going to restore the database dump. In case you decide to make a full restore, you are going to restore the whole installation with all files. In this documentaion we are going to make a full restore.
Next, you need to find out and indicate some database settings so that a working connection to your database can be build up.
You need to enter some database settings because BackWPup needs a working connection to your database in order to make a restore.
Enter the Database Host, the Database Name, the Database User and the Database Password. You can find all relevant database connection settings in the wp-config.php. However, you can also ask your hoster. In this documentation we take the data from the wp-config.php. You find the file in the zip file of your backup. We also wrote a documentation about the wp-config.php.
When you entered all data, click the button test connection. In case the test was successful, you get the information Connection to Database Successful.
The plugin tested the database connection successfully.
Now click the button Continue. You just reached the last step. When you want to restore your backup, click Start. BackWPup now restores your backup. This may take a few minutes in case you make a full backup.
When the restore was successful, the information below is displayed. If BackWPup had any problems during the restore process, you can download the log file directly. There, the whole restore process is documented. So the troubleshooting is much easier.
The restore was successful.

2. Restore a backup directly
Besides to the described way you can also restore a backup directly.

To do that, go to BackWPup Pro → Backups. There all your backups are listed. Choose the backup you want to restore and click the link restore.
Choose the backup you want to restore directly.
BackWPup now directs to the restore step we already described above as step 2. Choose whether you want to make a full restore or a database restore. Now we choose the database restore and click Database only.

Click the button Database only to restore the database dump.
BackWPup now directs to the step we already described above as step 3. You need to enter the database settings to connect with your database. Test the connection. If the test was successful, click Continue.
Now the BackWPup restore feature restores your database.

3. I have no access to my WordPress installation. Well, how shall I use the BackWPup restore feature?
In case you have no access at all, our BackWPup stand-alone app is your rescue. Check out this documentation to find out how you install and use this app.
4. BackWPup Pro licence key is missing after restoring the website
If the licence key is not activated after a restore or you have problems to activate it, please read the tutorial How do I activate my BackWPup Pro licence? 
5. BackWPup restore feature: Important files and directories
All readers who are interested in technical things should read the following section. That』s because we want to explain what happens in the BackWPup』s background when restoring a backup. As soon as you select the menu link Restore, the plugin installs the directory wp-content/uploads/backwpup-restore on your server.
We want to explain the functionality of some of the files which are stored in that directory:
5.1. Restore.log
This file is going to contain all information which are logged during the restore process. That』s the database import, the copied directories and some more information which are important for the debugging process. This log file is used to enable a fast support. Due to the file we can have a quick look at the restoring process.
5.2. Restore.dat
This file contains the restore process state as well as some information which are needed to know where the things shall be uncompressed, where the database dump is localized and so on.
5.3. Upload directory
That』s a directory in which the archive upload is stored. You can find the directory here: wp-content/uploads/backwpup-restore/uploads.
5.4. Extract directory
This directory is the place where the uploaded file is extracted. You can find the directory here: wp-content/uploads/backwpup-restore/extract.
5.5. .htaccess
This file is used to prevent a direct access to the restore directory.
5.6. .donotbackup
That』s a file that prevents that the plugin makes a backup of the temporary restore directory. The wp-content/uploads/backwpup-restore is a temporary directory that includes the uploads as well as all extracted archives and all other files of which the user needn』t have a backup.