|Note: This applies to Athena 9.3 and 9.4 only.|
Athena copies some locker software to the local machine to make it run faster. At the moment, this software is Acrobat Reader and OpenOffice. Network errors or disk problems can cause this process to fail, leaving users with broken copies of the locker software. For the most part, the software will crash or refuse to load, but in some cases it can be harder to track down. In at least one instance, the user was left with a copy of Acrobat that did everything except print.
Here is how to fix broken locker software. Note that this is done as root and uses the "rm" command, and typos can leave a workstation unusable. Be sure the user is aware of these concerns and has backed up
any data stored on the local workstation.
- Close all programs (Firefox, Acrobat, OpenOffice, etc).
- Look at the directories in /var/athena/local:
In this example, there are two lockers copied locally, acro_v8.1.2 and ooffice_v2.4.1
Because it takes a while to copy a locker locally, we only want to remove the one that's causing the problem. For this example, let's say it's acrobat.
- Detach the locker that you want to remove:
- Become root
- Delete the directory:
Note: Typos here can cause problems. Never give clients an "rm -rf" command that involves a wildcard (*)
- Delete the validated symlink:
- Exit the root shell
- Explicitly run the software out of AFS either with athrun:
or the traditional way
Note: This will run much more slowly than the user is accustomed to because it is running out of AFS. If the user logs out and leaves his machine running overnight, the local copy should re-appear after a day or two.