SingSurf

Instalation

The SingSurf program can be run in a number of different ways:

Running as a standalone Java application

Just click on the SingSurf.bat file.

By default this program uses the Microsoft Java virtual machine which comes preinstalled on releases of windows before 2003. If you do not have this virtual machine then you will need to download and install the Java virtual machine from Sun this can be found at www.javasoft.com. The last two lines of the SingSurf.bat file will need to be changed if you wish to use the Sun virtual machine.

You may find that a message "out of environment space" is displayed. If the happens please read the section below.

Running as a Java Applet in a web-browser window

A number of steps are needed to configure the program
  1. The directory where the server programs are found needs to be changed in two html files. To do this edit the files SSapplet.html and SingSurfPro.html find the lines
    <PARAM NAME = "ExecDir" VALUE="C:\temp\SingSurf\bin\">
    and
    ExecDir ="C:/temp/SingSurf/bin/"
    and change the directory in each line. A total of four lines will need to be changed (two in each file).
  2. When the applet is run for the first time yu may be asked to download the Sun Java plugin. This should happen automatically.
  3. As the applet requires additional preivilages (running the servers which actually produce the models) it has been digitally signed. The first time you run the applet you will be asked to grant these permisions. The program will only run if these permisions are granted.

Running as a Java Applet in a web-browser window and a web server

If you have a web server running then the applet can be run in a client server fashion. To set this up you will to unpack the archive somewhere in the web directory for the server. You will need to copy all the files in the bin directory to your cgi-bin or scripts directory of your webserver.

The SSapplet.html and SingSurfPro.html files will need to be edited to set the URL for the servers. Replace the lines

<PARAM NAME = "ExecDir" VALUE="C:\temp\SingSurf\bin\">
<PARAM NAME = "ExecExtension" VALUE=".exe">
to
<PARAM NAME = "ServerDir" VALUE="http://localhost/scripts/SingSurf/">
<PARAM NAME = "ServerExtension" VALUE=".exe">
and change the lines
ExecDir ="C:\temp\SingSurf\bin\"
ExecExtension =".exe"
to
ServerDir="http://localhost/scripts/SingSurf/"
ServerExtension=".exe"

Once this has been done you can view the applet through a URL like http://localhost/SingSurf/SingSurf.html.

Out of Environment Space

If you get the above message when running the down loaded programs on a windows machine you can fix it with either of the two options

  1. Right-click the MS-DOS Prompt shortcut (or the SingSurf.bat) file, and then click Properties. Click the Memory tab. In the Initial Environment box, set the initial environment size you want (from 256 to 4,096 bytes, in 256-byte increments). Click OK.
  2. To increase the default environment space for all MS-DOS programs running in Windows, edit the Shell command in the Config.sys file. To do this, follow these steps:
    1. Click Start, and then click Run.
    2. In the Open box, type sysedit, and then click OK.
    3. Click the Config.sys window.
    4. At the beginning of the Shell= line, type REM, and then press the SPACEBAR.
    5. If the Shell= line does not exist, proceed to the next step.
    6. Press the HOME key.
    7. Type the following line to create a new Shell= line, and then press ENTER: SHELL=C:\COMMAND.COM /E:4096 /P
    8. On the File menu, click Save.
    9. On the File menu, click Exit.
    10. Restart the computer.