Author 詩語

Install BackWPup Restore stand-alone App

Install BackWPup Restore stand-alone App
This article shows how to install the stand-alone restore app. We created this BackWPup Restore stand-alone app out of several reasons. For example in case your whole WordPress installation isn』t available anymore and you want to restore.

To install the BackWPup restore stand-alone app, you will need

FTP access to your web server

Table of Contents

InstallationTroubleshootingStartUp script forwards but I see only a white page
1. Installation

Download BackWPup Pro in your account and extract the zip-file. Now you have a folder backwpup-pro. This folder contains another zip-file backwpup-restore-app-xxx.zip
Extract the zip-file backwpup-restore-app-xxx.zip.
You will find two files in the folder,restore.phar and StartUp.php. Upload these two files to your web server. You can use a FTP Client of your choice to upload the files. The files should be placed in the same folder as your WordPress installation. I.e. restore.phar and StartUp.php should be in the same folder like wp-config.php and wp-content/.
Now we can start the restore app. Let』s assume your WordPress site is available at http://example.com/. Go to http://example.com/StartUp.php. The startup script will extract all necessary files and forward you to the restore app. The app looks like the following.

You are now ready to use the restore app. Simply upload your backup and follow the described steps. Check out the article how do I use the BackWPup restore feature to get more information.

2. Troubleshooting
2.1. StartUp script forwards but I see only a white page
This can happen in different situations:
The startup script might not be able to unpack restore.phar correctly. Take a look into the directory where StartUp.php and restore.phar are localized. Is there also a new restore/ folder? If no, then the script was not able to unpack the app correctly.
Make sure that both files have the following file permissions: 644.
If the startup script was able to create a restore/ folder, take a look into it and see if there exists a file in restore/src/App/index.php.

View the log of a backup job

View the log of a backup job
For every backup job that is running, BackWPup creates a log file, where every step of the job is documented. Advanced users can take a look and identify problems themselves. If you need help from our support, the log files are necessary to identify the problem and provide you a solution to it.
Please have a look at our article Sending in log files for the support, if you need help from our support.
At BackWPup → Logs you can find a list of the recent backup job log files. The number and type of the logs can be set under BackWPup → Settings, under the tab Logs (see Settings for log files).
BackWPup → Settings, under the tab Logs
The table shows you:

Time – when did the backup job run.
Job – name of the backup job.
Status – O.K., if the job was successful, ERROR and/or WARNING, if problems occurred.
Type – what has been saved.
Size – size of the backup file.
Runtime – how long did the backup job need to run.

If you hover the mouse over a job name, a list of links will appear to view, delete or download the log file.

I created a list of my plugins, but it』s hard to read

I created a list of my plugins, but it』s hard to read
A backup with BackWPup cannot only consist of the WordPress filesystem and the database, but also a list of plugins (see BackWPup → Add a new job → General). If you haven』t created a full backup, you can tell which plugins were installed by exactly this list of plugins. After restoring your backup to your WordPress installation, you』re able to install all plugins now manually.
You can find the list of plugins in the folder of your backup in a file like BackWPup.pluginlist..txt.
When you open the file, in some cases there won』t be line breaks and that will make the list of plugins hard to read. Try to open the txt-file in a text editor like Notepad++ (Windows OS), TextMate (Mac OS) or Sublime (any OS). The result should look like on the following screenshot. The screenshot was made using Sublime.
BackWPup.pluginlist

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.

How much memory does BackWPup need?

How much memory does BackWPup need?
BackWPup has no specific requirements with regards to RAM, but as the whole WordPress installation』s storage requirement depends from many other factors, one cannot generally say how much RAM is sufficient.
The following factors may have, amongst others, an influence on the storage requirement:

Plugins
Themes
Cron jobs
Many users on the same page
And a lot more

How big should the RAM for BackWPup be?
BackWPup carries out extensive operations with crons, and when performing cron jobs while many users visit the website and while the server needs to deal with many other tasks, it is possible that 512 MB RAM reach its limits.

Job has started, but not responded for 10 seconds

Job has started, but not responded for 10 seconds
Everytime a backup job is started, BackWPup checks if the job was started within 10 seconds. If not, the following error message will be displayed:
Job „%s「 has started, but not responded for 10 seconds.
In this case go to BackWPup → Settings → Information. There you can find the entry Server self connect with more details, which are relevant to this error message.
If you don』t know what to do with this, copy all information on this page and contact the BackWPup Support. For the Free Version use the support forums on wordpress.org. If you have purchased the Pro Version, you can use the BackWPup Premium Support.
Server self connect

Table of Contents

Error messages and possible solutionsNot expected HTTP response: WP Http Error:  Failure when receiving data from the peerNot expected HTTP response: Status-Code: 500
1. Error messages and possible solutions
Here is a list of error messages, which can appear under Server Self connect.
1.1. Not expected HTTP response: WP Http Error:  Failure when receiving data from the peer
In this case your host is probably blocking the access to the wp-cron.php file. Please contact your host and check if this is the case and if it is possible to change. Apart from that you can try a workaround for BackWPup: Activate alternative Cron by adding the following line to your wp-config.php:
define( 'ALTERNATE_WP_CRON', true );

1.2. Not expected HTTP response: Status-Code: 500

Check if your blog is in maintenance mode. The maintenance mode blocks the plugin』s ability to access the WordPress files and folders.

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.

Backwpup directory cannot be created or read

Backwpup directory cannot be created or read
Sometimes, while restoring a backup, you may encounter problems with file permissions. You may get information such as: Impossible to read the directory or Permission denied.
How to solve the BackWPup Issue Impossible to read the directory or Permission denied.
When this occurs, the simplest way to solve the issue is to set the directory or the parent directory permissions to 775.
Also, there are circumstances when changing the permissions isn』t enough. This is because owner:group for the directory is set incorrectly. Therefore WordPress isn』t able to change or read the directory content.
In that case you must change the owner:group of the directory by using the correct ones.
If you don』t know what the correct settings are, you can ask your host for more informations.

Job restarts due to inactivity for more than 5 minutes

Job restarts due to inactivity for more than 5 minutes
This error message appears when BackWPup notices that the job status has not changed for more than five minutes. This often happens if a monitoring process quits the backup script as it is running too long or uses too many resources.
Usually, this problem can be solved by setting the Maximum script execution time option under Settings → Jobs. BackWPup tries to restart the script before it reaches the maximum execution time. Its advantage is the definied restart, which prevents data failure in the backup files.
You may have to experiment with the Maximum script execution time until you found a good setting on your server. A value that frequently works is 25 seconds.
A value that frequently works is 25

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.