Scope: Prime Mover Pro

IMPORTANT : If you are using Prime Mover Pro for the first-time , please read this get started guide first.

Background: Why use Remote URL feature ?

It’s the fastest way to restore a site using Prime Mover. The default restoration method of Prime Mover is via browser uploads (available in free version and Pro version also). Browser uploads is slow because its subjected to a lot of factors (latency, Internet upload speed, server upload limitations, etc., browser limitations (can upload up to 4 Gigabyte only).

If you use browser upload, restoration is possible but takes a lot of time. Say your origin site is abc.com and your target site is xyz.com. Using browser uploads:

  • Generate Prime Mover package in abc.com.
  • After export, you download this to your computer (your local desktop or laptop for example). Downloading can take time, depending on your Internet download speed.
  • Then you restore it to xyz.com via Prime Mover restore via uploads method. This is usually slow depending factors discussed previously.

Using remote URL, you can bypass downloading/uploading to your desktop (which is time-consuming) and let two sites communicate each other directly using WordPress HTTP API. This is how it works (available in Pro version only):

  • Generate Prime Mover package in abc.com and save it to your export directory (don’t download it to your desktop).
  • Configure xyz.com to download/fetch Prime Mover package from abc.com by using authorization keys (for security so only authorized sites can do this): https://codexonics.com/prime_mover/prime-mover/how-to-add-and-use-authorization-keys-in-migrations/
  • Restore package using remote URL. This is very fast since it uses the hosting server connection speed (usually last seconds to fetch packages). xyz.com will fetch package directly from abc.com. This is not limited to package size(unlike browser uploads) and even if your package more than 4 Gigabytes, it can still be fetched.

First step: Generate Export Package at Origin Site

  • In a site using Prime Mover Pro, go to Prime Mover Control Panel.
  • Click Go to Migration Tools button.
  • Click Export button. The Export Options dialog will pop-up.
  • Select Export database, media files, plugins and themes – this will export everything.
  • Checked Export LocationExport zip to this blog Prime Mover backup directory so it can be restored immediately . This will export the package zip to your defined custom backup directory, somewhere secure in your server. This is checked by default.
  • [OPTIONAL -not recommended for very big sites] Checked Data EncryptionEncrypt database & media files with industry standard AES-256 encryption. This will encrypt the database and media files. This is also checked by default if supported. On very large sites, this can slow the export process so use this with caution.
  • Set Export type (whether you want to export single site or multisite). If exporting to multisite , please input the target sub-site blog ID.
  • Finally click Export now.
  • It can take time to export the entire package depending on the size of your website.
  • When its completed, you will see Export saved notice.
  • Click Copy URL to Clipboard. A confirmation dialog will show that the URL is successfully copied to clipboard. Click OK to confirm.

Second step: Restore Package at Target Site

  • At target site, go to Tools – Migration Tools.
  • Click Import button.
  • Select Restore backup zip from a remote URL.
  • In the input text box, paste the URL from the clipboard. This is how it looks like:

Tips: There are several types of remote URLs to the package that you can use. The first and original (as shown in the screenshot) is the standard Prime Mover remote API URL. The format of this URL is: https://yourtestsite.test?prime_mover_export_hash=2cf24dba5fb0a30e26e83b2ac5b9e29e1b161e5c1fa7425e73043362938b9824&prime_mover_blogid=1

This taken from the source site (where the Prime Mover export package is created or originated) by clicking “Copy URL to clipboard” see screenshot after creating the export package:

Or you can get the Prime Mover remote API URL from Tools -> Migration Tools -> click “Import” button -> click Restore files from this site backup directory at the source site. You should able to see the list of packages created. There is a copy to clipboard button to copy the remote API URL for each of these packages, see screenshot (clicking on it will automatically the API Restoration URL to clipboard so you can paste it on the import end):

Take note that packages will appear in the list only after they are successfully created (via Exporting packages) and not corrupted.

Another type of remote URL is any publicly accessible URL that points to a valid Prime Mover zip package. For example, say you have Prime Mover package you uploaded manually to your WordPress root named as myprimemoverzippackage.zip . Then this URL is https://mytest.site/myprimemoverzippackage.zip . Then use this URL as your remote URL to import package.

Also any URL pointing to a valid Prime Mover zip package hosted in any Cloud solutions can be used. Say for example, you have a Prime Mover zip package uploaded in DropBox and this is the URL: (you can get this by clicking Share -> Create Link in Dropbox) : https://www.dropbox.com/s/abcdefgdxsfdfds/mypackagezip.zip?dl=0

Make sure to set dl=1 as the parameter so it will be a direct download to the zip.

Therefore this is the URL to download the Prime Mover package from the DropBox:

https://www.dropbox.com/s/abcdefgdxsfdfds/mypackagezip.zip?dl=1

Use this URL as your remote URL to restore the site.

  • Finally once you have remote URL set and pasted, Click Import button. If you see “Unauthorized” error, you need to set authorization keys. Please read this guide for details: https://codexonics.com/prime_mover/prime-mover/how-to-add-and-use-authorization-keys-in-migrations/ . Basically, you create authorization key in the source site and copy that source site authorization key to the target site. This will ensure that target site is now authorized to fetched/download or copy package from source site. This security feature prevents any site or anyone from fetching or downloading your package.
  • Tip: Prime Mover validates any URL entered. It will verify if the package is a valid Prime Mover package (which is of zip format), it will reject any URLs that is invalid and you should see errors.
  • After starting the import, wait until you see Import is done. It will show progress to each step being processed. This process can take some time depending on the size of your packages.
  • Refresh the page.
  • Settings – Permalinks. Re-save permalinks.
  • Everything should be restored at this point. You can check the front end and back end of the site.
Was this article helpful?
YesNo