On the Targets page you decide where your backups go. Here you set up targets, test the connection, check the backups at a target and find backups again that are stored at a target but are not in the list of backups.
A target type is the technology: local folder, FTP, SFTP, WebDAV, S3, Google Drive or Dropbox. A target is a configured storage location of a target type with its own name and its own settings. You can set up several targets of the same type, for example three FTP servers.
The plugin does not create a target on its own
As long as no target is usable, Back up now takes you to this page. Add plan leads here as long as there is no target yet. A local folder is also a target like any other: you can rename and remove it.
The page at a glance
- Targets is the menu item of the page, in the WordPress menu under cloneworx.
- The status tile shows with colour and text whether all targets are usable. Below it you see the number of targets and the time of the last transfer.
- Add target opens the selection of the target types.
- Configured targets is the list of your targets. Every row shows a coloured dot for the state, the symbol of the target type, the name, the target type and the location.
- More … opens the menu of a target with all actions.
- Extended switches to the view with all details. The choice applies to all pages of the plugin.
Messages about an action appear below the status tile. A green message closes by itself; yellow and red ones stay until you close them. More on this: Progress, messages and log.
The status tile
The tile always shows the most important state. If more than one state applies, the tile shows the one that is higher up in the table. Add target is always in the tile, except after a loading error. The table lists the button that is added for each state.
| State | Meaning | Button added |
|---|---|---|
|
red The targets could not be loaded: … |
The page did not get the targets from the server. The message names the cause. | Reload |
|
yellow The storage target “…” is disconnected. |
The plugin can no longer use the stored credentials. Until you enter them again, backups skip this target. A target with a sign-in at Google or Dropbox has no credentials to enter: you connect it again instead. How it works: Renew the credentials of a target. | Renew credentials; for a target with a sign-in at Google or Dropbox Connect again |
|
yellow Fingerprint conflict at “…” |
The catalog at the target belongs to another installation of this website. Nothing is written and nothing is deleted there until you decide. How it works: The website has moved or is a copy. | This website moved and This is a copy |
|
yellow Not ready yet: … |
Plans and backups use a target only after a successful connection test. | Test connection |
|
grey No target is set up yet. |
Backups need at least one target. | none |
|
grey All targets lie inside the website. |
Backups stored on the same server inside the website are lost when the website is lost. They can also be reached from the web if the folder protection fails. Add a target outside the website or on another server. | none |
|
green All targets are connected. |
Every target has passed its last connection test. | none |
If a state concerns several targets, the tile names all of them. The button then acts on the first of these targets.
Add a target
- The available target types: Local folder, FTP / FTPS, SFTP, WebDAV, Amazon S3, S3-compatible, Google Drive and Dropbox.
- Dismiss closes the tile without creating anything.
The line directly above the target types is the note External targets are all targets that are not on this server. “This server” means the server of your website. The line with the asterisk below the selection is the note on names and logos of third parties.
If your server lacks something that a target type needs, you cannot choose that target type. In the picture this is FTP / FTPS:
- Not available on this server is shown on a target type for which the server lacks something. The target type is greyed out.
- The line below the selection names the target type and the reason. Here, the web server lacks the FTP extension of PHP.
Which target type suits you is shown in Which target suits you?
The form of a target
The fields depend on the target type. The picture shows FTP / FTPS.
- Name is your name for the target. The plugin suggests one, for example “FTP / FTPS 1”. You can use any name of up to 100 characters that is not yet in use; upper and lower case are not distinguished.
- Server is the host name or the IP address, without ftp://.
- User name
- Password
- Folder on the FTP server may stay empty: the plugin then uses the folder you land in after logging in. The plugin creates missing folders.
- Location states whether the target is at the same location as the website: not specified, Same location as the website or Another location (another data centre or another provider). The setting counts for the 3-2-1 rule of the plans.
- Save saves the target and tests the connection right away.
- Test connection checks the entered values without saving.
- Cancel closes the form.
The tooltip on the term Location reads: Is this target in a different building from the website? The 3-2-1 data backup rule (known as the “gold standard”) requires, amongst other things, a copy to be stored at a different location: another data centre or, at the very least, a physically separate building. The plugin cannot detect this automatically, so manual input is required here. The term has a dotted underline. The field is available for FTP, SFTP, WebDAV and S3-compatible storage. A local folder is always at the location of the website; Amazon S3, Google Drive and Dropbox are always elsewhere. What the setting counts for: The 3-2-1 rule - the gold standard for backups.
Fields with a red asterisk are required. In the Extended view the form shows further fields:
- Encryption is set to FTPS with TLS by default. Without encryption, the password and the data can be read in transit; the form then shows a warning below the field.
- Transfer mode is set to Passive by default. Active only works if the FTP server may open a connection to your web server on its own.
- Port may stay empty: the plugin then uses 21.
- Connection timeout (seconds) accepts values from 3 to 60; the default is 10.
A field of the Extended view also appears in the Compact view as long as it contains an error. If a value is not valid, the error is shown at the field, for example This name is already in use. or This value is not valid.
Passwords and keys stay on the server
The plugin stores them encrypted and never gives them back to the browser. When editing, the field therefore only reads stored, leave empty to keep. If you change the server, the user or the login of the target, this no longer applies: the field becomes a required field.
Every target type has its own article, for example Store backups on an FTP server (FTP / FTPS).
A target of the type Google Drive or Dropbox has no credentials in the form: you sign in with the provider and give your consent there. Instead of Save, the form has the button Connect with Google or Connect with Dropbox. The steps are shown in Store backups in Google Drive and Store backups in Dropbox.
Save and test
A target is usable only when its last connection test succeeded. The test writes a small file to the target, reads it back, compares it and deletes it again.
- The cause in plain language, for example: The target refused the login.
- Show global log opens the global log, which contains the details of the test.
- The original messages. Message from the target is the last answer of the target, that is of the server, the service or the provider behind it. Message from the client is the message of the software through which the plugin talks to the target: for SFTP the SSH library, for WebDAV, S3, Google Drive and Dropbox cURL. Neither is translated; credentials, folders and server names are masked in them.
After Save the form closes, and the page reports the result of the test:
- green “…” saved and connected.
- yellow “…” saved, but the connection test failed: … The target is saved, but not usable yet. Show global log in the message leads to the details.
Messages of the connection test and the targets
If the test or an action at a target fails, the message names the reason. The articles on the target types explain the common cases; here are the messages at a glance.
Test and save
| Message | Meaning |
|---|---|
| “…” is connected. | The connection test of a target succeeded. |
|
“…”: the connection test failed: … The connection test failed: … |
The test failed; the reason follows the colon. |
|
The target could not be set up on this server. This target type is not available on this server. |
The target type cannot work on this server. |
|
The PHP extension “…” is missing. The PHP function “…” is disabled. cURL on this web server cannot do …. |
The reason why a target type is not available. |
| Secrets cannot be stored: there is no readable key (Settings → Key). | The plugin cannot encrypt passwords right now. More about this: The “Settings” page. |
| The settings do not fit this server. | The settings of the target are incomplete or wrong, or its folder is not available. |
|
The test file came back changed. The checksum at the target differs from the local file. |
What the target returns does not match what the plugin sent. |
| The server refused a protection file. The backups are stored all the same. | A note after the connection test, not an error. |
| The connection is encrypted, but the certificate of the FTP server is not checked: the FTP extension of PHP cannot do that. | A note after the connection test of an FTP target with FTPS: the FTP extension of PHP does not check certificates. |
| New address: …. Enter it as the address of the folder if it is the right one. | The server redirects. More about this: Store backups via WebDAV. |
What the target must be able to do
| Message | Meaning |
|---|---|
|
The target does not allow …. The plugin needs this to check, continue and clean up backups. reading a file back listing a folder deleting a file reading a file from a position telling how far an upload has come |
The test found that the target does not allow something the plugin needs. What is missing follows the colon. |
|
listing the bucket (s3:ListBucket) reading objects (s3:GetObject) writing objects (s3:PutObject) deleting objects (s3:DeleteObject) listing the parts of an upload (s3:ListMultipartUploadParts) listing unfinished uploads (s3:ListBucketMultipartUploads) aborting an upload (s3:AbortMultipartUpload) |
With Amazon S3 and S3-compatible services the message names the permissions the access key lacks. More about this: Store backups in Amazon S3. |
Certificate and server key
| Message | Meaning |
|---|---|
|
Issued for: … Issued by: … Valid until: … If you accept this certificate, the plugin trusts exactly this key from now on and no longer checks who issued it. Nobody has confirmed that this is the right server: compare the fingerprint with the one your provider names. |
The details of the certificate and the note before you accept the certificate. |
|
The check failed; the reason is not known. The list of trusted authorities cannot be read on this web server. |
Reasons why the verification of the certificate fails. |
|
This website connects to this server for the first time. Nobody has confirmed that it is the right server: compare the fingerprint with the one your provider names, and accept the key only if both are the same. A changed key can mean that the server was set up anew. It can also mean that someone sits between this website and the server. Accept the new key only if you know why it changed. Confirmed so far: … The server no longer offers the kind of key you confirmed. |
The notes on the key of an SFTP server. More about this: Store backups on an SFTP server. |
|
The server offers no kind of key that the plugin can check. The server offers no key exchange that the plugin can use to read the key. The server did not answer the way an SSH server does. |
Reasons why the plugin cannot read the key of an SFTP server. |
|
This key is protected by a passphrase. Only keys without a passphrase are accepted. This key is in PuTTY format. Export it in PuTTYgen as an OpenSSH key (menu Conversions) and paste that text. This is a public key. The private key belongs here. The server does not accept this key for this user. The public part of the key must be stored on the server. |
Errors with the private key of an SFTP target. More about this: Store backups on an SFTP server. |
Account and service
| Message | Meaning |
|---|---|
|
Not connected to an account yet. The target is not connected to an account. |
A target in Google Drive or Dropbox is not connected to an account. The first message appears in the form, the second gives the reason for an error. |
| The sign-in worked, but the target could not be saved. | After the return from the provider, the plugin could not save the target. |
| The provider cannot be reached by the sign-in service or reports an error. | The sign-in service cannot reach Google or Dropbox, or the provider reports an error to it. |
|
The daily limit of the service is reached. Try again tomorrow. The account has reached a limit for the number of files or folders. |
A limit of the provider, not of the plugin. |
| The stored credentials can no longer be read. | The target is disconnected. More about this: Renew the credentials of a target. |
|
This server takes every file only in one request. Test the connection of the target again to measure the upload rate. The service demands larger parts of an upload than the plugin sends. |
Reasons why a transfer to a target fails. |
What the plugin does after the successful test
After Save and the successful test, the plugin looks at the location of the target to see whether backups are stored there that are missing from the list of backups. For a target of the type Google Drive or Dropbox, this happens after you return from the sign-in with the provider.
- Backups in the plugin’s own folder: the plugin adds them to the list on its own, for example when you have removed a target and set it up again at the same location. Adding them runs as a job, and instead of the message about saving you see the message shown in the picture.
- For the folder of another installation, for example an earlier installation of the plugin on this website, the tile Backups found at “…” appears with the button This is my website: take it over.
- If the plugin finds nothing, the message about saving remains.
The plugin never adds backups that this website does not know by itself: a dialog window names their number, and you confirm them as correct or cancel. More about this: Find backups again after a reinstallation.
- The message Backups found at “…”: … are being added to the list. names the target and the number of backups.
- The progress of the job names Finding backups, the entries read and the remaining time.
- Abort search stops the job at the next step.
The plugin adds these backups on its own only under two conditions: no other job is running, and the catalog in the plugin’s own folder belongs to this installation or no readable catalog is stored there. Otherwise the tile Backups found at “…” shows the number of these backups and the button Add them to the list. If the catalog belongs to another website, the tile also shows a yellow note, and after the click the dialog window Did this website move here? appears. All cases are described in Find backups again after a reinstallation.
The list of targets
The dot at the start of the row shows the state. A target that is not usable has a label after its name:
| Label | Dot | Meaning |
|---|---|---|
| none | green | The last connection test succeeded. The target is usable. |
| not tested yet | grey | Saved, but without a connection test since the last change of the settings. |
| test failed | red | The last connection test failed. |
| Disconnected | yellow | The plugin can no longer use the stored credentials, or the provider, Google or Dropbox, no longer accepts the stored consent. |
| conflict | as without conflict | The catalog at the target belongs to another installation. The plugin writes and deletes nothing there. |
| Not available on this server | grey | The server lacks something that the target type needs. |
| removed | grey | Removed. The entry stays until you delete it permanently. Visible only in the Extended view. |
If a local folder is inside the website, a label is shown after its location:
- inside the website is shown after the location of the target, here for the second local folder.
If the list is too narrow for all columns, it hides the location first, then the column with backups and space, and finally the target type.
The “More …” menu
- Test connection tests the saved target. The result appears as a message below the status tile.
- Check the backups at this target reads every backup at this target, the newest first. Afterwards, the list of backups shows damaged or incomplete backups with a red cross. The entry appears only if backups are stored at the target.
- Clean up leftovers at this target removes folders that an aborted job left behind and that will never become a backup. The cleanup never touches what is in the list of backups. The entry appears for target types that can list their files.
- Find backups at this target looks at the location of the target. While the plugin is looking, the page shows Looking at “…” … The plugin adds backups in its own folder that are missing from the list of backups to the list on its own, as it does after saving. For the folder of another installation, the tile Backups found at “…” appears. If the plugin finds nothing, the tile reports that nothing was found. The entry appears only for a usable target.
- Edit opens the form with the saved values.
- Remove removes the target after a confirmation prompt.
Checking, cleaning up and adding found backups run as a job: the progress display appears below the status tile, and at the end a message with the result. Only one job runs at a time; if one is already running, the page reports A job is already running.
The steps in detail: Check backups at a target and clean up leftovers and Find backups again after a reinstallation.
Remove a target
- With the checkbox ticked, the plugin first deletes all backups at this target and then removes the target. Without the tick, the backups stay where they are. The checkbox is only there if backups are stored at the target.
- Cancel
- Remove
- If locked backups are stored at the target, the checkbox is missing. Unlock them first, or remove the target without its backups.
- If backups in the list still refer to the target, its entry stays as removed, without settings and without credentials. In the Extended view you delete it with Delete permanently, even if backups still refer to it: these backups then lose the reference, and backups that were stored only at this target disappear from the list. Nothing is deleted at the target. If locked backups refer to the target, unlock them first.
- For a target in Dropbox, the plugin asks Dropbox to revoke the access when you remove the target. If that does not succeed, for example because Dropbox cannot be reached, the plugin removes the target anyway; the access then stays valid at Dropbox until you disconnect the app in your Dropbox account.
- For a target in Google Drive, the plugin revokes nothing: it only deletes the access data from the database of your website; at Google the previous access stays valid. The consent stays listed in your Google account until you remove it there.
- A removed target is taken out of every backup plan. A plan without a target is paused. It can only be switched on again once you give it a target.
Step by step: Remove a target.
The Extended view
- The column shows for each target when a backup last went there. The status tile shows the most recent of these times after Last transfer.
- The number of backups at the target and the space they take.
- removed marks a removed target; its name is struck through. Only this view shows it. Its menu offers only Delete permanently.
- Targets and space shows for each target the backups, the used and the free space, and for each backup plan the number of backups in relation to Max. backups. The tile knows the free space only for local folders; otherwise it shows a dash.
- Compact switches back.
The tile Targets and space is collapsed when you open the page. A click on its title row expands it and collapses it again. For backups whose Plan column in the list of backups shows imported or reclaimed, the tile uses the same word. For these backups there is a dash in place of Max. backups, because the plugin never deletes them automatically. How the plugin counts is explained in Define how many backups are kept.
See also
- Which target suits you?
- Renew the credentials of a target
- Remove a target
- The website has moved or is a copy
- Manage targets with WP-CLI
On the command line
WP-CLI not set up yet? How to install WP-CLI.
Everything this page can do also works with WP-CLI. There you refer to a target by its ID (local-1, ftp-2) or its name. The command line does not accept passwords and keys, because every value would appear in the list of processes and in the history of the shell. You therefore set up targets with credentials on this page, and likewise a target of the type Google Drive or Dropbox. The command line does not add backups to the list on its own: rebuild is there for that.
# Show targets with ID and state wp cloneworx-backup target list # Create a local folder as a target wp cloneworx-backup target add local --name="Archiv" --set-path=/var/backups # Change the name of a target wp cloneworx-backup target edit local-1 --name="Archiv 2" # Test the connection wp cloneworx-backup target test local-1 # Check the backups at a target wp cloneworx-backup target check local-1 # Clean up leftovers at a target wp cloneworx-backup target cleanup local-1 # Show what is stored at the target's location wp cloneworx-backup target sites local-1 # Add backups from the plugin’s own folder to the list wp cloneworx-backup target rebuild local-1 # Remove a target; the backups there are kept wp cloneworx-backup target remove local-1