BackWPup 文档

What is FTP passive mode, when and how to use it with BackWPup?

What is FTP passive mode, when and how to use it with BackWPup?
BackWPup gives you the option of connecting to your FTP server using passive mode. But what is passive mode and when should you use it?
An FTP connection is made up of two channels: the command channel and the data channel. In active mode, the client connects to the server to establish the command channel, but the server connects back to the client to establish the data channel. The issue is that if the client is behind a firewall, remote connections may be blocked. In such a case, passive mode can be useful.
Passive mode allows the client to establish both channels, so the firewall won』t block the FTP connection. The problem in this case is that the server may also be behind some firewall. If so, passive mode may not be feasible.

Table of Contents

How to Know Which Mode to UseHow to Enable/Disable Passive ModeHow to Know Passive Mode is Enabled in Your Debug Log
1. How to Know Which Mode to Use
Generally the host your FTP server is on should tell you whether to use passive mode or not. If they don』t say, you can usually default to active mode.
However, it may also take a bit of trial and error. If you try active mode and the connection fails, you can try enabling passive mode. The inverse is true as well: if you have passive mode enabled and it』s not working, try disabling it.
2. How to Enable/Disable Passive Mode
When you select FTP as a destination for one of your backup jobs, there will be an option to enable passive mode. If you check that box, then passive mode will be enabled.
How to Enable/Disable Passive Mode
3. How to Know Passive Mode is Enabled in Your Debug Log
If passive mode is enabled, you』ll see something like this in your debug log:
[...] FTP client command: PASV
[...] FTP server reply: Entering passive mode

If you start seeing errors soon after these lines, then you might want to disable passive mode.

Can I quit a running backup job via FTP, if it doesn』t work in the admin area?

Can I quit a running backup job via FTP, if it doesn』t work in the admin area?
Generally, you can quit a running backup job via the admin area by clicking on the Abort button below the progress bar.
Abort button below the progress bar
If this is not working you can quit the job via FTP. You need an FTP program for this, like Filezilla.

Connect to your web server via the FTP program.
Go to the root directory of your WordPress installation and from there, go to /wp-content/uploads. There you can find a folder named backwpup-xyz-temp, where xyz identifies the job.
Delete this folder. If you find multiple temp folders, delete them all.

Please note: If you have changed the location of the temporary folders in your wp-config.php, you have to switch to the folder you chose in step 2.

Where do I get Support for BackWPup ?

Where do I get Support for BackWPup ?
You need help with BackWPup, have a question, want to report a bug or request a new feature? We gladly help you and appreciate it if you help us to improve our product.
We have two places for the support, depending on which version you are using: BackWPup Pro or BackWPup Free.

Table of Contents

Individual BackWPup Premium SupportSupport for the Free Version on wordpress.org
1. Individual BackWPup Premium Support
If you have purchased BackWPup Pro, you can use our individual Premium Support. The development team is ready to offer you help and advice with any problem you may encounter.
You can find the Premium Support under backwpup.com/support. Once you have logged into your account, you can open a support ticket.
If you don』t have an account there yet, please purchase a BackWPup licence.
Please do understand that we can not offer free Premium Support.
If you have questions before purchasing a licence, please use our contact form.
Individual BackWPup Premium Support
2. Support for the Free Version on wordpress.org
If you are using the Free Version of BackWPup, please post your support request in the plugin forum on wordpress.org. Our general support takes place normally on Tuesdays and Thursdays for 2 hours.

Where do I find my database connection settings for BackWPup restore?

Where do I find my database connection settings for BackWPup restore?
When you want to use our feature to restore backups, you need a connection to your database. BackWPup can overwrite the current database with the one in the backup only with a working connection. BackWPup is going to ask for these data in step 3 of the restore process.
Here you need to enter the database settings.
You need to enter the following data:

Host
Database name
Database user
Password

Database connection settings for BackWPup restore: Check out the wp-config
You can find all relevant data in the wp-config.php file, which can be found in the main directory of your WordPress installation. You need the following entries:
// ** MySQL settings - You can get this info from your web host ** //
/** The name of the database for WordPress */
define('DB_NAME', 'database_name_here');

/** MySQL database username */
define('DB_USER', 'username_here');

/** MySQL database password */
define('DB_PASSWORD', 'password_here');

/** MySQL hostname */
define('DB_HOST', 'localhost');
You can also ask your hoster to give all relevant data. Or check out the wp-config.php of your backup.

BackWPup, Backups and GDPR

BackWPup, Backups and GDPR
Dear BackWPup user, you surely also already heard something about the EU General Data Protection Regulation (GDPR) and you somehow have to deal with this topic – so do we. In this documentation we want to give you some information about what we already did to comply with the new data protection regulations, and we want to answer your questions about BackWPup, backups and GDPR.

Table of Contents

What is the General Data Protection Regulation?What We do to Protect Your DataWhat you should take care of as BackWPup userDoes BackWPup handle with personal data?In this way BackWPup helps to create a GDPR compliant backupDo you need an Data Processing Agreement (DPA) with us?What do you have to consider in a support case?
1. What is the General Data Protection Regulation?
The General Data Protection Regulation (GDPR) is a new law which regulates data protection for the whole EU. It』s the law』s aim to standardise processes where personal data are used. Furthermore, the law focuses on the protection of the rights natural persons have regarding their personal data. It』s going to be in force on May 25th, 2018, after two years of transition period.
All companies using personal data of EU citizens, no matter the size, are affected by this new law. Website owners not being totally private are affected, too. Maybe you』re one of the affected?
Companies being affected by the GDPR now have extensive documentation obligations about the handling process of personal data. The GDPR grants affected persons – those whose data are processed – the following rights:
The right to

information
deletion
correction
contradiction
migration

of stored personal data.
In case you want to know more about it, we collected some useful links.
Related Links

https://gdpr-info.eu/
https://raidboxes.io/dsgvo-wordpress-technical-measures/
https://www.codeinwp.com/blog/complete-wordpress-gdpr-guide/
2. What We do to Protect Your Data
Since the beginning of this year, we work in the background to make our services and products GDPR compliant. We already dealt intensely with this complex topic where a lot has been unclear in the beginning.
Now we implemented quite some things in our shops and in our support. For example, we made an audit of personal data for all plugins we use, we modified our contact forms and updated our privacy policy.
Of course, we will work continuously to fulfil the data protection regulations, as the topic data protection and the rights of our users are very important to us.
3. What you should take care of as BackWPup user
3.1. Does BackWPup handle with personal data?
BackWPup doesn』t send any personal data to us. However, BackWPup stores the personal data on your website in a backup. Make the backup GDPR compliant is the responsibility of the website owner. Further below you can read how BackWPup supports to make your backup GDPR compliant.
3.2. In this way BackWPup helps to create a GDPR compliant backup
On blog.ebertlang.com und datenschutz-praxis.de (german) you find interesting blog posts with an overview what a GDPR compliant backup is about and how a backup tool does support the GDPR compliance of your website. We also summarized it here for you:

The backup functionality is automatable and can run in the background – you can set this both with BackWPup FREE and PRO
Fast restore of data – since BackWPup PRO version 3.5 we implemented the brand new restore feature which allows you to restore backups in an emergency case.
Selection of data to be backed up is possible – With BackWPup you can decide which data you want to store in your backup and which not. You can choose both database tables and data.
User administration with privilege system available – BackWPup provides a special user role 「BackWPup admin」. A user with this role only has access to the BackWPup setting pages – in case you need support and need to give access to your website or in case an employee shall only be responsible for that.
The backup tool creates logs about the backups – possible both with BackWPup PRO and FREE
The website owner is informed when there are backup problems – possible both with BackWPup PRO and FREE
Encryption of backups – server-side encryption available for Amazon S3 in FREE and PRO version of BackWPup. Symmetric (AES-256) or asymmetric (RSA) encryption for backups in BackWPup Pro starting with version 3.6.
Changes of data to be backed up need to be confirmed – Confirmation happens by clicking the save button on BackWPup settings page.

3.3. Do you need an Data Processing Agreement (DPA) with us?
As BackWPup user you don』t need a DPA with us, because we don』t handle any of your data. BackWPup only creates backups of your website, the plugin doesn』t send any personal data to us.
However, if you upload a backup to a cloud provider (GDrive, Dropbox, etc.) with BackWPup, you transmit personal data to that provider. Therefore you need a Data Processing Agreement with that provider. In the following we provide the links to GDPR information and Data Processing Agreements of all BackWPup backup destination providers:

Google Drive

For GSuite: https://support.google.com/a/answer/2888485?hl=en

Dropbox

https://www.dropbox.com/security/GDPR
https://assets.dropbox.com/documents/en/legal/data-processing-agreement-dfb-013118.pdf

Amazon Glacier and Amazon S3

https://aws.amazon.com/compliance/gdpr-center/?nc1=h_ls
http://aws-de-media.s3.amazonaws.com/images/TransformationDay/TDay_Slides/Data%20Protection_AWS.pdf
https://eu-west-1.console.aws.amazon.com/console/dpa/document

Microsoft Azure

https://www.microsoft.com/en-us/trustcenter/default.aspx
http://www.microsoftvolumelicensing.com/Downloader.aspx?DocumentId=8532

Rackspace Cloud Files

https://www.rackspace.com/sites/default/files/legal/rackspace_dpa.pdf

Sugarsync – We will add this link soon

3.4. What do you have to consider in a support case?
As BackWPup FREE user, please ask your questions on wordpress.org. We offer personal support only to our PRO users. Although we answered support tickets of FREE users in the past, we will, with GDPR in force, only deal with support requests of PRO users in our support system. Please understand that the implementation of GDPR in support tickets requires a great deal of time and effort.
In case you need to give us access to your website to solve a support problem:

please set up a new user for our support team and delete the user when your support ticket is solved. We will also delete the access data you gave us.
please ensure we do not get access to personal data of your customers or users. Best practice is to set up a user with BackWPup Admin role when we need to access your site. In this case we do not get acces to the whole site but only to the BackWPup settings pages. Please also ensure we do not get access to backups containing personal data of your customers or users.

Do you have further questions we didn』t answer yet? Please use our contact form.
We will inform you as soon as there are any news about GDPR being in relation to BackWPup.

Please understand that this article isn』t a legal advice. We cannot take responsibility on the accuracy of the statements.

Can I choose the location of the temporary directories?

Can I choose the location of the temporary directories?
In the folder /wp-content/uploads of your WordPress installation, BackWPup creates temporary directories for files, which are only needed while a job is running. You can choose another folder for the temporary directories.
For this, you need write access to your wp-config.php, which can generally be found in the root directory of your WordPress installation.

Open the wp-config.php file and search for the line if ( !defined('ABSPATH') ).
Add this line before the one of step 1: define( 'WP_TEMP_DIR', '/absolute/path/to/wp/your/temp-dir' );
Replace /absolute/path/to/wp/ with the absolute path of your WordPress installation and your/temp-dir with the path to your new temp folder.
Save the file.

What placeholders can I use in archive names and what do they mean?

What placeholders can I use in archive names and what do they mean?
At some settings in BackWPup you need to choose a file name. For example, you can create a name for the archive of a job, which can consist characters and placeholders. Here is a list of available placeholders and their meaning:

%d = Day of month, two digits with leading zero
%j = Day of month, without leading zero
%m = Month number, with leading zero
%n = Month number, without leading zero
%Y = year, four digits
%y = year, two digits
%a = lowercase ante meridiem (am) and post meridiem (pm)
%A = uppercase ante meridiem (AM) and post meridiem (PM)
%B = Swatch Internet Time
%g = Hour in 12 hour format, without leading zero
%G = Hour in 24 hour format, without leading zero
%h = Hour in 12 hour format, with leading zero
%H = Hour in 24 hour format, with leading zero
%i = Minute, two digits, with leading zero
%s = Second, two digits, with leading zero

The placeholders allow you to create individual file names for the backup files.
Example: backwpup_611506_%Y-%m-%d_%H-%i-%s creates, if the job runs on 17th June of 2016 at 13:11:10, the archive with the name backwpup_611506_2016-06-17_13-11-10.zip.

Error: Dropbox-API: (6) couldn』t resolve content.dropboxapi.com

Error: Dropbox-API: (6) couldn』t resolve content.dropboxapi.com
BackWPup says ERROR: Dropbox-API: (6)? In case you chose Dropbox as backup target, you might get the following error message when uploading the backup to Dropbox:
ERROR: Dropbox API: (6) Couldn't resolve host 'content.dropboxapi.com'
According to Dropbox this is a DNS error – read: https://www.dropboxforum.com/t5/API-support/Error-Dropbox-API-6/m-p/193010. Due to that, the domain content.dropboxapi.com cannot be resolved correctly.
In this case you should contact the hoster as the network and internet connection of the web server needs to be checked. On the other hand, the error might have occured due to a temporary internet outage while uploading the file.
In case the upload to Dropbox displays this error message after a couple of tries, you should definitely contact the hoster.

Archive Path and/or Restore Path is not set

Archive Path and/or Restore Path is not set
While copying files during the restore process, following error message may occur:
Error message:
Archive Path and/or Restore Path is not set; Archive Path: %1$s; Restore Path: %2$s
BackWPup Issue Archive Path Restore Path not set – The Solution:

The problem in this case is that the decompressed archive directory and/or the restore directory (where to copy the files) are not set in the registry. This error leads to partial restoring. Instead of a complete restore, you only get a database restore.  At first, please check whether the file 「wp-content/uploads/backwpup-restore/restore.dat」 contains all required info. If this is not the case, or if the file doesn』t exist, please try to set the permission for the directory to 755 or 664 and try again.

Cannot connect to MySQL database

Cannot connect to MySQL database

While restoring a database with BackWPup, you need to successfully set up a database connection. If you enter wrong access data, following error messages may occur:
Error messages:
1) Cannot connect to MySQL database 1045: Access denied for user 」@』localhost』 (using password: NO)
2) Cannot connect to MySQL database 1049: Unknown database 『databasename』
3) Cannot connect to MySQL database 1045: Access denied for user 『a』@』localhost』 (using password: YES)
BackWPup Issue Restore cannot connect Mysql Database – The Solution:
Please check your database connection settings in the file wp-config.php of your WordPress installation. Then copy the credentials in the form at step3 and try again.
If you don』t have access to this file, contact your hoster to provide you the database credentials.

Note:
The issue may be caused also by an invalid charset for the database, in that case you will be prompted for the correct one.
You can find that information in the file wp-config.php.,While restoring a database with BackWPup, you need to successfully set up a database connection. If you enter wrong access data, following error messages may occur:
Error messages:
1) Cannot connect to MySQL database 1045: Access denied for user 」@』localhost』 (using password: NO)
2) Cannot connect to MySQL database 1049: Unknown database 『databasename』
3) Cannot connect to MySQL database 1045: Access denied for user 『a』@』localhost』 (using password: YES)
BackWPup Issue Restore cannot connect Mysql Database – The Solution:
Please check your database connection settings in the file wp-config.php of your WordPress installation. Then copy the credentials in the form at step3 and try again.
If you don』t have access to this file, contact your hoster to provide you the database credentials.