Troubleshooting OOTP on Linux
Posted by - NA -, Last modified by Gary Breckenridge on 01 December 2014 06:48 AM
Here are a few ideas on troubleshooting OOTP installations on Linux:
First off, the Terminal window is your friend. Don't be afraid of the CLI (command-line interface). If you don't trust yourself to run commands at the command-line, then you may want to reconsider Linux as your choice of operating systems!
By default, OOTP wants to install into the directory that the install binary file resides. One suggestion is to create the directory that you actually want to install OOTP into before running the installer, and move the installer into that directory before running it.
After downloading the Linux version of OOTP, you will have a gzipped tar file (ootp12linuxinstall.tar.gz) that you will need to first unzip using gunzip before extracting with the tar utility. After extracting the file, you will find the installer that may or may not be executable due to permissions. Use the "chmod" command to make it so. Example: "chmod 755 installerfilename" (without the quotes).
From the directory that contains the downloaded installer file, kick off the install by issuing this command: "./installerfilename". Make sure to replace installerfilename with the actual filename of the installer. The installer should start.
If the installer does not start, you most likely have a library issue. That means that libraries required by the installer may be missing from your Linux system. This is usually only an issue if you are trying to install OOTP on a 64-bit Linux system, as OOTP is a 32-bit application. If you encounter library issues while running a 32-bit version of Linux, there may be a problem with your Linux installation, and you may need to reinstall it correctly. To see if you are missing necessary libraries, issue this command: "ldd installerfilename". Analyze the output looking for any "Not Found" messages. Install the missing libraries and try the installer again. Alternately, you could consider installing a 32-bit version of Linux for the purpose of running OOTP.
If the installer starts, make sure that you instruct the installer to install in your preferred directory. You can accept the default location, but it is suggested that you create a new directory under your "home" directory and install there. The installer will create and install all sub-directories needed by OOTP underneath the install directory. All data and saved games will be located under the install directory. The installer also installs configuration files in a hidden directory located in the installing user's home directory.
The installer will (as long as you did not uncheck the boxes) attempt to install a desktop icon and a menu item to run the game. You should always end up with a desktop icon. The menu items are more problematic due to the many different window managers that could be in use with your particular Linux distribution. Most common Linux distributions will have proper menu items created. Don't fret if you don't see a menu item -- you don't need it. The desktop icon should meet your needs just fine. Another suggestions is to make sure that you have a value set for $BROWSER. That is the environment variable that contains the path and filename of your favorite web browser. You can add this command to the end of the .bashrc file located in your user home directory: "export BROWSER=/usr/bin/firefox". This for example sets the default browser to be Firefox. Set this variable to reflect your browser of choice.
Run OOTP for the first time from the command-line. This way, you can see any error messages that may be generated if the game does not fire up correctly. Make sure that you are sitting in the directory in which the game was installed. There should be an shell script named "ootp(x).sh" (where (x) is the version of the game you have, such as "ootp12.sh". Start the game by issuing this command: "./ootp(x).sh". The game should start. If it does not, make note of any errors displayed on the screen. Make sure that all required libraries are installed and available. Do this in the same manner that you did for the installer file. The command is "ldd ootp(x)". Make note that you should run ldd on the actual executable file and not the shell script. If any libraries are missing, correct and restart the game. If the game starts up, your troubleshooting work is done. Please note: The installer places a library named libchilkat-9.2.0.so in the game directory. The shell script that launches the game makes sure that the library is accessible during launch, so ignore the not found message related to that library when using ldd during your troubleshooting.
You should be able to start the game using the desktop icon for all subsequent sessions. Enjoy the Linux version of OOTP!