runtime/faq/backup file name

From JumpBox Documentation Wiki

Jump to: navigation, search

Can I change the backup file name?

At this point, you should not change the name of the backup file. If you do so, or something else changes it, you will likely get errors from the restore process. The precise error will depend on exactly what was changed. The format of the backup file name is important and the format is as follows:

 jb-NAME-VERSION-HOSTNAME-LONGUNIQUEID-TIMESTAMP.tgz

an example of a valid filename is:

 jb-moodle-1.1.12-mymoodle-f41a68a471c911deae46000c29921241-20090831182424.tgz

Possible Problems

We have seen cases of the following things rename or cause problems with the backup files:

  • Users deliberately changed the backup filename.
  • Browser or OS automatically uncompresses or untars a backup file.
  • Browser removes the .tgz extension.

Possible Solutions

Renamed File

If your file was simply renamed, then it is fairly easy to manually name it back to something that will work. The only two things that are critical is that you get the JumpBox name and version correct. The version can be found in the name of the zipfile you downloaded, the info page of the running JumpBox or by default it is the name of the directory that the JumpBox unzips into (assuming you aren't using ESX or something). This is the JumpBox version we are talking about too, so it will be something like 1.1.??. Once you know the version, you rename the file using the following name, just substituting the ?? with the correct version:

 jb-moodle-1.1.??-mymoodle-f41a68a471c911deae46000c29921241-20090831182424.tgz

The HOSTNAME, LONGUNIQUEID, and TIMESTAMP don't matter as far as the actual restore is concerned. They are only used for display purposes.

Uncompressed or Untarred File

This is a little tougher since it is a little harder for users to understand what has happened. If the file has simply been uncompressed, then you will simply need to re-compress it with gzip and ensure the name is OK. If it has been untarred then you need to tar the contents back up and then compress it and ensure that the name is OK.

Views
Personal tools