Support

Site Restoration

#18646 Restoring Amazon back-up when there are multiple files

Posted in ‘Site restoration’
This is a public ticket

Everybody will be able to see its contents. Do not include usernames, passwords or any other sensitive information.

Environment Information

PHP version
n/a
CMS Type
Other
CMS Version
n/a
Backup Tool Version
n/a
Kickstart version
n/a

Latest post by nicholas on Monday, 30 December 2013 10:30 CST

user80258
I am testing how a back-up restoration will work with our site. The issue I am having is that our Amazon S3 back-up is done in segments; part #1, part #2, part #3... part#12. When trying to do a single file or just restoring I was not able to find documentation on how to handle this.

When I tried to use the extract wizard with one "part" I received an error.

What is the best way to handle this?

tampe125
Akeeba Staff
Hello Dan,

what do you mean by "done in segments"? Akeeba Backup is creating an archive splitted in several files?

Did you read the documentation about Kickstart professional (which is required in order to import archives from Amazon S3)?

Which kind of error are you receiving?

Davide Tampellini

Developer and Support Staff

🇮🇹Italian: native 🇬🇧English: good • 🕐 My time zone is Europe / Rome (UTC +1)
Please keep in mind my timezone and cultural differences when reading my replies. Thank you!

nicholas
Akeeba Staff
Manager
If you are downloading the files manually and use Kickstart or Akeeba eXtract Wizard: Download all part files. Then when you try to restore the main part (.jpa, .jps or .zip) all part files are read automatically.

If you are using the integrated restoration, in Akeeba Backup's back-end: just tell it to download the backup archive from the Manage Remote Files popup of the backup record in the Manage Backups page. Then use the integrated restoration and it will read all part files automatically to restore your site.

If you are using Kickstart Professional: Tell it to download the main part (.jpa, .jps or .zip). It will automatically download all part files. Then when you to restore the main part it will automatically read all part files.


Remember that it doesn't matter where you store a multi-part backup archive. In order to restore it you have to remember:
- The backup archive is NOT complete unless all of its parts are present
- You only need to start restoring the main part. The rest of the parts are read automatically as they are technically parts of the same backup archive.

Think of the backup archive as a very big work of literature, let's say War and Peace. War and Peace is 1440 pages. You can't have it as one HUGE book. It would be impossible to hold in your hand to begin with. You can, however, take it and split it to four Volumes (bound books). If you only read the first book you have only read about a quarter of the story and there's clearly more than what you have already read (i.e. you have an incomplete copy). If you try reading only the third book you will not understand a thing, as you've got no idea what happened in the first two books, let alone how the story ends (i.e. you have a corrupt copy). You need all four books and read them in sequence: book 1, book 2, book 3 and finally book 4. This is how split archives work. Book One is actually the .j01 file. Book Two is the .j02 file. And so on and so on... until you get to the last Book which is the .jpa file.

If you are downloading the files manually and use Kickstart or Akeeba eXtract Wizard: Download all part files. Then when you try to restore the main part (.jpa, .jps or .zip) all part files are read automatically.

If you are using the integrated restoration, in Akeeba Backup's back-end: just tell it to download the backup archive from the Manage Remote Files popup of the backup record in the Manage Backups page. Then use the integrated restoration and it will read all part files automatically to restore your site.

If you are using Kickstart Professional: Tell it to download the main part (.jpa, .jps or .zip). It will automatically download all part files. Then when you to restore the main part it will automatically read all part files.


Remember that it doesn't matter where you store a multi-part backup archive. In order to restore it you have to remember:
- The backup archive is NOT complete unless all of its parts are present
- You only need to start restoring the main part. The rest of the parts are read automatically as they are technically parts of the same backup archive.

Think of the backup archive as a very big work of literature, let's say War and Peace. War and Peace is 1440 pages. You can't have it as one HUGE book. It would be impossible to hold in your hand to begin with. You can, however, take it and split it to four Volumes (bound books). If you only read the first book you have only read about a quarter of the story and there's clearly more than what you have already read (i.e. you have an incomplete copy). If you try reading only the third book you will not understand a thing, as you've got no idea what happened in the first two books, let alone how the story ends (i.e. you have a corrupt copy). You need all four books and read them in sequence: book 1, book 2, book 3 and finally book 4. This is how split archives work. Book One is actually the .j01 file. Book Two is the .j02 file. And so on and so on... until you get to the last Book which is the .jpa file.

If you tell someone to read an arbitrary book and only that book they will either:
  • Try to read the first book, go to the last page and realise the story is incomplete and protest. Our software does the same, telling you the archive is corrupt or incomplete.
  • Try to read from any other book, which will immediately cause them to protest that it makes no sense. Our software does the same, telling you the archive is corrupt or incomplete.


Our software knows that so it will try to a. get all parts from remote storage and b. read all parts and in the correct order to make sure that what is being restored makes sense.

And now the behaviour of our software suddenly makes sense, right? :)

Nicholas K. Dionysopoulos

Lead Developer and Director

🇬🇷Greek: native 🇬🇧English: excellent 🇫🇷French: basic • 🕐 My time zone is Europe / Athens
Please keep in mind my timezone and cultural differences when reading my replies. Thank you!

Support Information

Working hours: We are open Monday to Friday, 9am to 7pm Cyprus timezone (EET / EEST). Support is provided by the same developers writing the software, all of which live in Europe. You can still file tickets outside of our working hours, but we cannot respond to them until we're back at the office.

Support policy: We would like to kindly inform you that when using our support you have already agreed to the Support Policy which is part of our Terms of Service. Thank you for your understanding and for helping us help you!