Restore: Difference between revisions

From kJams Wiki
Jump to navigation Jump to search
← Older edit
No edit summary
No edit summary
 
(2 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/...<br>That means, go into your startup drive (mac: "Macintosh HD", windows: "C:\", then in there go into the folder called "Users", then in there go into YOUR user's folder, the folder with the NAME of your user. From there, go into Music (or "My Music"), etc.  get it?
 
# inside that folder ("kJams Library"), 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 inside it is NOT empty)
### do NOT go inside that folder! stay in the folder "kJams Library", do the following:
#### Find the file called "Songs.ktd", in the folder "kJams Library", it is at the SAME LEVEL as the folder called "Songs.ktd [Backups]"
#### DO NOT DELETE the '''folder''' called "Songs.ktd [Backups]" (OMG!)
#### DO NOT GO INSIDE the '''folder''' called "Songs.ktd [Backups]"!! If you delete something in there, YOU WILL LOSE YOUR BACKUPS!
#### This file:<br><img src="https://karaoke.kjams.com/screenshots/restore/mac.png" width="341pix"><br>
#### Delete that one file "Songs.ktd"
### now run kJams, it will present a list you can choose from
### choose the most recent one from BEFORE the problems started, click OK
### you should be back in business
### if you are NOT back in business, try an earlier backup (start again from the top)
## '''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"