MIRC Installation on Macintosh

MIRC is running on Macintosh computers in multiple institutions, but the MIRC development team does not have Macintosh computers on which to test the installation process. These instructions for installing the MIRC site software on Mac OSX have been contributed by several Mac users (J. Kevin Smith and Allison Zwingenberger)

Java

Verify that your system has Java 5.5 installed.

Java is located on the Macintosh hard drive in:

/system/library/frameworks/JavaVM.framework/versions

If you need to update to 5.5, use the autoupdater in:

system/preferences/autoupdate

Tomcat

Download the Tomcat 5.5 installer from http://tomcat.apache.org.

Run the installer and put Tomcat in username/.

JAI ImageIO

Download the Java Advanced Imaging ImageIO Tools from:

http://download.java.net/media/jai-imageio/builds/release/1_0_01/jai_imageio-1_0_01-lib-linux-i586.tar.gz

Unpack and place the files from the lib folder into /System/Library/Java/Extensions

Catalina.sh

Open /username/apache-tomcat-5.5.15/bin/catalina.sh in a text editor.

Paste the two lines below into the file just after the instruction section and then save the file.

JAVA_OPTS='-Xms256m -Xmx512m'
JAVA_HOME=/System/Library/Frameworks/JavaVM.framework/Versions/1.5/Home

Start Tomcat.

Go to applications/utilities/terminal.

Enter:

cd ~/apache-tomcat-5.5.17/bin
./startup.sh 

Test Tomcat

Open a web browser and enter http://127.0.0.1:8080.

If the Tomcat logo is displayed, Tomcat is running.

Stop Tomcat

Go to applications/utilities/terminal.

Enter:

./shutdown.sh

More information on Tomcat and Macintosh is available on the Apache wiki:

http://wiki.apache.org/tomcat/TomcatOnMacOS

MIRC

Download and run the MIRC site installer.

Adobe SVG

To be able to annotate images, client machines must have an SVG viewer installed.

Firefox now has a native SVG viewer, so nothing else is required.

Problems have been reported using the Adobe SVG viewer with Safari.