The following is a list of solutions for problems I can envisage you may encounter. If you have any other problems installing or running SimSoup then please contact me at the email address given on the Home page.
SimSoup 0.4
I have installed the binary package, but it doesn't run
Check that your system has the packages mentioned in the `Dependencies' section of the Installation notes. To get information on what is missing, you can run SimSoup from the console; if a required library is missing the library name will be reported.
For example, if gsl is missing you should get a message like
./simsoup: error while loading shared libraries: libgsl.so.0: cannot open shared object file: No such file or directory
I have installed the binary package and checked the dependencies, but SimSoup still doesn't run
Try installing from source. It may be that the file expected by the SimSoup binary does not exactly match the one included in the package on your system. I hit this problem on the eeePC; SimSoup wants the file libcairomm-1.0.so.1, but my eeePC 701 has libcairomm-1.0.so, libcairomm-1.0.so.0 and libcairomm-1.0.so.0.0.6.
Incidentally, you shouldn't need to install Cairo. If you don't already have it, then your distribution's installer should have pulled it in when gtkmm was installed.
I cannot install from source. The configure script says something like "C++ compiler cannot create executables"
Check that you have a compiler installed! Although the wording of the message implies that a compiler is installed but is not working, the message is also generated if no compiler is installed. Perhaps the wording of the message dates from a time when source packages were only installed by seasoned Unix techies.
I cannot install from source. The configure script generates various messages, but they look a bit technical"
Check the dependencies section in the Installation notes to ensure that you have all the required packages installed. The ./configure script will generate a user friendly message if gsl or gtkmm is missing, but remember that you also need
pkg-config and
make.
SimSoup 0.3
I can start the SimSoup Simulation, but there is no way to stop it
When you select the Simulation->Run Simulation menu item, SimSoup enters its
main loop and opens a 'Stop Simulation' window. This window should appear at
the top left of the screen, and should just show a large 'Stop Simulation' button.
Check that the Stop Simulation button has not become minimised or hidden behind
another window.
When I try to run SimSoup from a bash prompt, it reports a missing library
Try the binaries in the other tar.gz file.
SimSoup 0.2
I can start the SimSoup Simulation, but there is no way to stop it
When you select the Simulation->Run Simulation menu item, SimSoup enters its main loop and opens a 'Stop Simulation' window. This window should appear at the top left of the screen, and should just show a large 'Stop Simulation' button. Check that the Stop Simulation button has not become minimised or hidden behind another window.
I added an Action Request, but it was not executed and there was no entry in the Simulation Log
If you added the Action Request after the simulation had already been running for a while, make sure that the time you entered for the Action Request was later than the simulation time.
SimSoup 0.1 Prototype
If you find that the Windows program will not start and a message about OLEAUT32.DLL is displayed, the reason is that SimSoup requires you to be running a later version of OLE Automation (i.e. OLEAUT32.DLL). You are only likely to encounter this problem if you are running Windows 95 or 98 and a relatively old version of Internet Explorer. The problem can be easily fixed by updating your DCOM software or installing the latest version of Internet Explorer. For details look
here.
If you have any other problems installing or running SimSoup, please contact
me at the Email address given on my home page.