Restore: Difference between revisions

From kJams Wiki
Jump to navigation Jump to search
← Older edit
No edit summary
No edit summary
 
(7 intermediate revisions by the same user not shown)
Line 1: Line 1:
If kJams has directed you here, it means that, unfortunately, you've run into a particularly nasty bug requiring that you restore from a previous backup.
If you have been directed here, it means that, unfortunately, you've run into a particularly nasty bug requiring that you restore from a previous backup. (i'm trying to fix this bug!)


The good news is that kJams keeps automatic backups of the index ("Songs.ktd") file, so that if you run into trouble of some kind, you easily can restore from one of your backups.
The good news is that kJams keeps automatic backups of the index ("Songs.ktd" and/or "Songs.ksql") file, so that if you run into trouble of some kind, you easily can restore from one of your backups. (note: anywhere you see ".ktd", do the same thing if you ALSO see a ".ksql" file. In other words, if you see a file with .ksql, you delete that one too!)


Currently, there's no bulit-in way to do this, so here's how you do it manually.
# Quit kJams
# hold down these keys: Mac: command-opt-shift, Win: ctrl-alt-shift
# while holding all those keys, launch the kJams app
# Keep holding until you see the backup selection dialog. If you do not see the dialog, it means you don't have backups. Be sure to manually make backups (File menu) or turn on "Make Automatic backups" in the general prefs


# Quit kJams
That's it!
# go to the "kJams Library" folder.  it is located here:<br> /Users/<you>/Music/kJams/kJams Library/...
 
# inside that folder, do you see a sub-folder called "Songs.ktd [Backups]", and it's not empty?
Now select a backup, then press OK. If kJams launches and you determine that this is the good backup, you're done! Otherwise, repeat the process and pick a different one, until you find a backup that is GOOD! Interesting things to note about backups: the date, and the SIZE! (Bigger size means more song files are indexed)
## YES: I see the folder called "Songs.ktd [Backups]" (and it is NOT empty)
### NEXT to (not INSIDE of) that folder, you will see a file called "Songs.ktd".  Delete it.  DO NOT DELETE the folder called "Songs.ktd [Backups]" (OMG!)
### now go into the "Songs.ktd [Backups]" folder, sort by DATE, with the latest one at the top
### find the most recent date when things were GOOD (ie: before the time when things went bad)
### drag that file out one level, into the "kJams Library" folder
### rename the file so that it says "Songs.ktd".  ie: if it was "Songs 73.ktd", remove the space and the 73 by renaming the file
### now run kJams, you should be back in business
### if you are NOT back in business, try an earlier backup
### if you ARE back in business, you may delete all backups except for the most recent, to save space
## NO: I do NOT see any folder called "Songs.ktd [Backups]", or i see it but it's EMTPY
### you were unfortunately running a version of kJams that is too old
### the only way out is to restore from a backup that YOU made: manually restore from your own backup.
### If you haven't ever made any backups, the only thing you can do is [[Rebuild|rebuild your library]]

Latest revision as of 17:44, 8 September 2023

If you have been directed here, it means that, unfortunately, you've run into a particularly nasty bug requiring that you restore from a previous backup. (i'm trying to fix this bug!)

The good news is that kJams keeps automatic backups of the index ("Songs.ktd" and/or "Songs.ksql") file, so that if you run into trouble of some kind, you easily can restore from one of your backups. (note: anywhere you see ".ktd", do the same thing if you ALSO see a ".ksql" file. In other words, if you see a file with .ksql, you delete that one too!)

  1. Quit kJams
  2. hold down these keys: Mac: command-opt-shift, Win: ctrl-alt-shift
  3. while holding all those keys, launch the kJams app
  4. Keep holding until you see the backup selection dialog. If you do not see the dialog, it means you don't have backups. Be sure to manually make backups (File menu) or turn on "Make Automatic backups" in the general prefs

That's it!

Now select a backup, then press OK. If kJams launches and you determine that this is the good backup, you're done! Otherwise, repeat the process and pick a different one, until you find a backup that is GOOD! Interesting things to note about backups: the date, and the SIZE! (Bigger size means more song files are indexed)

Retrieved from "https://karaoke.kjams.com/w/index.php?title=Restore&oldid=13212"