Firmware 1.1.3 migration guide

Subforum for discussion and help with ScummVM's iPhone port

Moderator: ScummVM Team

Locked
User avatar
Vinterstum
ScummVM Developer
Posts: 580
Joined: Sun Oct 16, 2005 6:59 am

Firmware 1.1.3 migration guide

Post by Vinterstum »

Firmware 1.1.3 changes a few things on the iPhone / iPod Touch, which means that migrating up to it can break a few apps, ScummVM included.

If you haven't upgraded to 1.1.3 already, it might be a good idea to wait until more apps are updated. In either case, take a backup of all your ScummVM savegames (and everything else you might need). The savegames are located in /var/root/.scummvm. In fact, you should probably backup everything under /var/root (there's 3rd party tools that can do this automatically).


Now here comes the tricky part! Depending on whether or not you preserved some of your data/settings on the device when you upgraded to 1.1.3, there's a few manual steps you may have to do. ScummVM (starting with version 0.11.1) will try to migrate all your savegames and settings over to the new 1.1.3 directory structure, but not the games themselves.

So!

* If your music is gone, it means all your data was wiped when you upgraded, and you'll have to upload your games again. If you have a backup of your ScummVM savegames, upload them to /var/mobile/Library/ScummVM/Savegames (IMPORTANT: Don't create this directory yourself. Run ScummVM at least once first, so it can create the directory itself with the right ownership and permissions).

* If your music is there, and you had installed your games under /var/root/Media somewhere previously, your games will now have moved to the new 1.1.3 directory structure. This means you'll have to remove and readd all games from ScummVM (your savegames should still be there, however). They should now be under /var/mobile/Media somewhere.

* If your music is there, and you did NOT keep your games under /var/root/Media or /var/root/Library, ScummVM will still know where your games are. However, since all applications on your device will now run as a different user, ScummVM may not have permissions to access them anymore! This depends on what method you used to upload your games. If you can't start your games, SSH to your phone and do 'chmod -R 755 /path/to/your/games'. The same applies if you upload some new games using the root login, and they won't start.
Locked