Installing solomon

Requirements

You must have the following in order to run solomon:

  • You must have JDK 1.6.0 installed and set up.
  • Please note that solomn will NOT work with JDK 1.6.0 until Update 4 due to a bug in the Sun XML libraries that solomon uses. You MUST configure solomon to use JDK 1.6.0 Update 4 upwards.*
  • Your browser must have Javascript enabled.

Installing solomon

Windows

  1. Download solomon and store it somewhere you can find it easily.

  2. Extract the contents of the zip file to your desired location (C:\ drive, desktop, etc).

  3. If you want to use an external database with solomon, rather than the default embedded HSQLDB database, implement the steps described below before proceeding. If you want to use the built-in HSQLDB (because you are trying solomon) or are happy using the embedded database, just skip to Step 4.
    We strongly recommend you use MySQL to ensure a reliable and stable database that is not prone to data corruption Instructions for installing solomon using MySQL

  4. Essential Step: Edit the solomon-application.properties file found inside solomon/WEB-INF/classes/ and set the solomon.home property to an absolute path on your system where you want solomon data to be stored. Please make sure this outside your installation directory to prevent data loss when upgrading/patching solomon.

  5. Run startup.bat located in the bin folder.

  6. Go to http://localhost:9001 to get started with solomon.

Mac OS X / Unix / Linux

Ubuntu/Linux users - Please note that solomon requires the JDK provided by Sun. Although it will run under Open JDK, image attachments require some Sun specific classes. To install the Sun-specific JDK, update your /etc/apt/sources.list to include multiverse and install sun-java6-jdk.

  1. Download solomon and store it somewhere you can find it easily.

  2. Extract the contents of the zip file to your desired location.

  3. If you want to use an external database with solomon, rather than the default embedded HSQLDB database, implement the steps described below before proceeding. If you want to use the built-in HSQLDB (because you are trying solomon) or are happy using the embedded database, just skip to Step 4.
    We strongly recommend you use MySQL to ensure a reliable and stable database that is not prone to data corruption Instructions for installing solomon using MySQL

  4. Essential Step: Edit the solomon-application.properties file found inside solomon/WEB-INF/classes/ and set the solomon.home property to an absolute path on your system where you want solomon data to be stored. Please make sure this outside your installation directory to prevent data loss when upgrading/patching solomon.

  5. Make the shell scripts in the bin folder of the solomon installation executable, by running chmod +x *.sh in bin.

  6. Change directory to the bin folder. Run startup.sh.

  7. Go to http://localhost:9001 to get started.