WordPress.org

Ready to get started?Download WordPress

Plugin Directory

DreamObjects Connection

Backup your WordPress site to DreamHost's DreamObjects.

General Questions

What does it do?

DreamObjects Connection connects your WordPress site to your DreamObjects cloud storage, allowing you to automatically store backups of your content.

Do you work for DreamHost?

Yes, but this isn't an official DreamHost plugin at this time. It just works.

Do I have to host my website on DreamHost?

No, but using it anywhere else is unsupported. You have to use DreamObjects, which belongs to DreamHost. This plugin was built on and specifically for DreamHost servers, so I can give you no assurance it'll work on other hosts. BotoRsync, for example, and WP-CLI are installed on DreamHost servers. I can't vouch for any others.

Can I use this on a Windows Server?

This is unsupported. You can try, and let me know how it goes. I built this for DreamHost, so it has only been tested on Linux boxes.

Can I use this on Multisite?

Not at this time. Backups for Multisite are a little messier, and I'm not sure how I want to handle that yet.

What does it backup?

Your database and your wp-content folder.

In a perfect world it would also backup your wp-config.php and .htaccess, but those are harder to grab since there aren't constant locations.

How big a site can this back up?

The hard limit is 2G. I've personally tested up to 250MB without any issues.

Why does my backup run but not back anything up?

In pre 3.1 versions, that happened because of size. A quick way to test if this is happeneing still is by trying to only backup the SQL. If that works, then it's the size of your total backup.

Wait, you said it could back up 2G! What gives?

There are a few things at play here:

  1. The size of your backup
  2. The file upload limit size in your PHP
  3. The amount of server memory
  4. The amount of available CPU

In a perfect world, you have enough to cope with all that. When you have a very large site, however, not so much. You can try increasing your PHP filesize upload limit, or if your site really is that big, consider a VPS. Remember you're using WordPress to run backups here, so you're at the mercy of a middle-man. The DreamObjects itself can handle 2G, PHP may not make it.

I have, personally, verified a 250MB zip file, with no timeouts, no server thrashing, and no PHP errors, so if this is still happening, turn on debugging and check the log. If the log stalls on creating the zip, then you've hit the memory wall. It's possible to increase your memory limit via PHP, however doing this on a shared server means you're probably getting too big for this sort of backup solution in the first place. If your site is over 500megs and you're still on shared, you need to seriously think about your future. This will be much less of an issue on VPS and dedi boxes, where you don't have the same limits.

Where's the Database in the zip?

I admit, it's in a weird spot: /wp-content/upgrade/dreamobject-db-backup.sql

Why there? Security. It's a safer spot, though safest would be a non-web-accessible folder. Maybe in the future.

My backup is small, but it won't back up!

Did you use defines for your HOME_URL and/or SITE_URL?

For some reason, PHP gets bibbeldy about that. I'm working on a solution!

Using the Plugin

How often can I schedule backups?

You can schedule them daily, weekly, or monthly.

Can I force a backup to run now?

Yep! It actually sets it to run in 60 seconds, but works out the same.

I disabled wp-cron. Will this work?

Yes, provided you still call cron via a grownup cron job (i.e. 'curl http://domain.com/wp-cron.php'). That will call your regular backups. ASAP backup, however, will need you to manually visit the cron page.

I kicked off an ASAP backup, but it says don't refresh the page. How do I know it's done?

By revisiting the page, but not pressing refresh. Refresh is a funny thing. It re-runs what you last did, so you might accidently kick off another backup. You probably don't want that. The list isn't dynamically generated either, so just sitting on the page waiting won't do anything except entertain you as much as watching paint dry.

My suggestions: Visit another part of your site and go get a cup of coffee, or something else that will kill time for about two minutes. Then come back to the backups page. Just click on it from the admin sidebar. You'll see your backup is done.

(Yes, I want to make a better notification about that, I have to master AJAX.)

How long does it keep backups?

Since you get charged on space used for DreamObjects, the default is to retain the last 15 backups. If you need more, you can save up to 90 backups, however that's rarely needed.

Can I keep them forever?

If you chose 'all' then yes, however this is not recommended. DreamObjects (like most S3/cloud platforms) charges you based on space and bandwidth, so if you have a large amount of files stored, you will be charged more money.

Who can upload files?

Anyone who can upload media can upload files, so this generally covers Authors and up. Only the Administrators can set the upload bucket, however.

How do I use the CLI?

If you have wp-cli installed on your server (which DreamHost servers do), you can use the following commands:

wp dreamobjects backup

That runs an immediate backup and is great if you're going to, say, upgrade WP. Then you backup, upgrade your site, and everything is happy!

Why doesn't it have a CDN?

Because we went with a slightly different feature with the CDN, and as such it's best as a separate plugin. Don't worry, they'll play nice!

Where did the uploader go!?

Away. It was never really used well and the CDN plugin will handle this much better. WP's just not the best tool for the job there.

Errors

It's reporting page not found when I access the pages

Upgrade to version 3.2 and tell PHP it's drunk.

Can I see a log of what happens?

You can enable logging on the main DreamObjects screen. This is intended to be temporary (i.e. for debugging weird issues) rather than something you leave on forever. If you turn off logging, the log wipes itself for your protection.

Why don't my buckets list?

Do you see an error like this?

Fatal error:  Call to undefined method SimpleXMLIterator::__toString() in /wp-content/plugins/dreamobjects/AWSSDKforPHP/utilities/simplexml.class.php on line 164

If so, you're on PHP 5.2 and you need to upgrade to 5.3 or higher. AWSSDK dropped support for 5.2 when it added 5.4, so it was either support 5.2 and 5.3 OR 5.3 and 5.4. I went with the future.

What's this S3::listBuckets() error?

Any time you see an error like this, it means the plugin can't talk to your DreamObjects buckets:

"warning: S3::listBuckets(): [403] 
Unexpected HTTP status in /wp-content/plugins/dreamobjects/lib/S3.php on line 249"

Reasons why include the key/secretkey pair aren't actually setup correctly, the bucket was deleted after adding it to the plugin, or your DreamObjects account is disabled. Double check that your keys are correct and the bucket exists.

My backups don't work, and when I turned on debugging, I see a 'failed' message

Example error:

[2013/01/22 08:58:17] File failed to create /home/name/domain.com/wp-content/upgrade/dreamobject-backups.zip 
in DreamObjects as domain.com/2013-01-22-085817.zip. Status: .

This means the file was zipped up, but could not copy up to the server.

Turn on debug mode, and then turn on verbose debugging.

Then, via command line, run the backup wp dreamobjects backup

That will output a whole mess of code. Save that output and post in the forums that this is happening. I'll get in touch with you so you can email me the output privately.

The automated backup is set to run at 3am but it didn't run till 8am!

That's actually not an error. WordPress kicks off cron jobs when someone visits your site, so if no one visted the site from 3am to 8am, then the job to backup wouldn't run until then.

Why is nothing happening when I press the backup ASAP button?

First turn on logging, then run it again. If it gives output, then it's running, so read the log to see what the error is. If it just 'stops', then it's a bug. If it says it can't upload the file to DreamObjects, it's probably size.

Then log in via SSH and run 'wp dreamobjects backup' to see if that works.

Requires: 3.4 or higher
Compatible up to: 3.9.1
Last Updated: 2014-5-1
Downloads: 9,760

Ratings

4 stars
4.8 out of 5 stars

Support

1 of 2 support threads in the last two months have been resolved.

Got something to say? Need help?

Compatibility

+
=
Broken :(

1 person says it works.
6 people say it's broken.

100,1,1 100,1,1 100,2,2
0,1,0
14,7,1