Installation Instructions

Back to the GeomSS Wiki Home Page.

GeomSS requires Java version 11 (JRE or JDK) or later. Everything else that it needs to run is bundled with the program.

If you encounter any problems with this installation process, leave a message in the Support Request forum. I will try to get back to you if I can.

Table of Contents

• Table of Contents
• MacOS X
  • Installing GeomSS on MacOS X
• Microsoft Windows
  • Installing GeomSS on Windows
• Linux & Solaris
  • Installing GeomSS on Linux

MacOS X

GeomSS should work well on MacOS 11.3 or later. It comes with a Java 11 JRE bundled with the application, so you do not need to have Java installed to run GeomSS.

Installing GeomSS on MacOS X

1. Download the latest version of GeomSS from: http://sourceforge.net/projects/geomss/files/.
2. Double-click on the downloaded "dmg" file and a disk image icon will appear on your desktop. Open the disk image and you will find the GeomSS program file, a "README" file and some license information.
3. Drag the GeomSS program icon to any convenient location on your computer (typically the "/Applications" folder, but you can put it anywhere you like).
4. Dismount the disk image file by dragging it's icon off the desktop onto the "Eject" icon on the dock.

You should now be able to run GeomSS by double-clicking on the application bundle, however, Apple's security system will prevent you from being able to run GeomSS since it was downloaded from the internet and does not have an Apple Developer ID signature (I am not an “identified developer”). You will need to do the following:
1. Open System Preferences
2. Open Security & Privacy
3. Scroll down to "Security"
4. Find a message saying that GeomSS was prevented from running because it is from an unknown developer and click the "Run Anyway" button.

Then you should be able to run GeomSS from then on.

Microsoft Windows

GeomSS should work well on Windows 10 or later.

GeomSS requires Java3D version 1.5.2 or later and is bundled with Java3D 1.7. Therefore you do not have to install Java3D to run GeomSS. If you have Java3D 1.3 installed, it will need to be removed before you can run GeomSS. If you have Java3D 1.5 installed, GeomSS will pick that up and use it, but that shouldn't cause any problems.

Installing GeomSS on Windows

1. Download the latest version of GeomSS from: http://sourceforge.net/projects/geomss/files/.
2. You should have downloaded a zip archive. Decompress it into a convenient folder. You should get a double-clickable jar file named "GeomSS.jar" a folder named "geomss_lib" and a "README" file and license information.
3. You can place the jar file along with the geomss_lib directory anyplace that is convenient to you as long as they remain side-by-side. The "geomss_lib" directory contains some native libraries that must be present to run GeomSS with the bundled version of Java3D.

You are done. You run GeomSS by double-clicking on the GeomSS.jar file.

Linux & Solaris

GeomSS comes bundled with Java3D 1.7, so you do not need to install Java3D separately. However, if you have Java3D installed on your system, that's fine as long as it is newer than Java3D 1.5.0. In particular, if you have Java3D 1.3 installed, you need to uninstall it before running GeomSS.

Installing GeomSS on Linux

1. Download the latest version of GeomSS from: http://sourceforge.net/projects/geomss/files/.
2. You should have downloaded a tgz archive. Decompress it into a convenient folder. You should get a double-clickable jar file named "GeomSS.jar" a directory named "geomss_lib" and a "README" file and license information.
3. You can place the jar file along with the geomss_lib directory anyplace that is convenient to you as long as they remain side-by-side. The "geomss_lib" directory contains some native libraries that must be present to run GeomSS with the bundled version of Java3D.

You are done. You can run GeomSS by double-clicking on the jar file or you can run the jar file from the command line with:

java -Xmx1gb -jar GeomSS.jar