Solido Installation System

All products available from Solido are primarily distributed in the form of our jar-based installation system. For installations where this isn't suited, a raw distribution of the files needed for an installation will be available for some products. The purpose of this document is to provide a general introduction to the usage of the jar-based installation system. For information about manual installations using the raw distribution, please see the documentation for the specific product that you wish to install.

Getting Ready to Install

In order to install a product from Solido using the jar-based installer, you need to have a working Java installation present. If you don't already have this, you can download one for free for most platforms directly from Sun. We currently recommend using the latest JDK 1.6 installation, which you can find at java.sun.com.

Installing Software

Once you have a Java installation in place, download the jar-based installer for the product you wish to install from the download page at solidosystems.com. Open a terminal and change your location to the folder where the jar installer is located. Start the installation by typing java -jar productinstaller.jar. Let's have a look at a full example. In this example, I have downloaded the installer for the solido smtpproxy to /home/kasper/. I cd into that folder, ensure that the installer is there, and then start the process using sudo. Not all products need to be installed using root privileges, but most will place their files in /usr/local/usr/ which will most likely require root privileges.

> cd /home/kapper/
> ls
smtpproxy-installer-v5.0-b11.23.jar
> sudo java -jar smtpproxy-installer-v5.0-b11.23.jar

At this point, the installation process has been started. The installer will first show you the license agreement for the specific software package and require you to accept it by typing yes. Then it will ask for your license key. If the license key is correct, it will proceed to the next step where it gathers all the information it needs to execute the installation. Before it actually installs everything, it will let you know where it intends to install files and ask you to accept before proceeding. The following is an example of what the full installation process can look like.

Solido Systems // Software Installer v1.0
Please read and accept the following license to continue.

SOLIDO SYSTEMS A/S
SOFTWARE LICENSE AGREEMENT FOR Solido Smtp Proxy

THIS LICENSE AGREEMENT (EULA) IS A LEGAL AGREEMENT BETWEEN YOU AND SOLIDO
SYSTEMS A/S. PLEASE READ AND AGREE TO THE TERMS OF THIS LICENSE BEFORE USING
THE SOFTWARE.

1. LICENSE GRANTS

    * Solido Systems A/S grants you the non-exclusive right to use the
      software.
    * Solido Systems A/S grants you the right to take as many backups of
      the software as you may need on any medium of your choice.

2. LICENSE RESTRICTIONS

    * You may not distribute copies of the software or your license key for
      it to third parties.
    * As the owner of the license key, you are responsible for keeping the
      key secret.
    * You may not rent, lease or lend the software to any third parties.
    * You may permanently transfer your rights under this license to another
      user as long the recipient agrees to all terms and conditions of this
      EULA.
    * Solido Systems A/S reserves all rights not explicitly granted by this
      license.

3. DISCLAIMER OF WARRANTY AND LIABILITY

    * The software is provided "as is", without warranty of any kind either
      expressed or implied.
    * Solido Systems A/S do not make any claims as to the fitness of this
      software for any particular purpose.
    * In no event shall Solido Systems A/S be liable for any special,
      incidental, indirect or consequential damages whatsoever including
      without limitation, damages for loss of business profits, business
      interruption, loss of business information or any other pecuniary loss
      arising out of the use or inability to use the software.

    I have read and agree to the above license agreement [yes/no]: yes

    Performing preinstall check OK
    Please enter the license key for the product : ACSC4F-332323-232223-222222-292BT4

    Ready to install with the following parameters
      + Package Solido Smtp Proxy
      + Version v5.0 build 11.d23
      + License Key ACSC4F-332323-232223-222222-292BT4
      + Install targets
        - Jar files     /usr/local/solido/smtpproxy/jar/
        - Configuration /usr/local/solido/smtpproxy/etc/
        - Scripts       /usr/local/bin/
        - Documentation /usr/local/solido/smtpproxy/doc/
      + Log file        /var/log/smtpproxy.log
      + Proces id file  /var/run/smtpproxy.pid
      + Java command    /usr/bin/java

    Do you wish to continue with the installation? [yes/no]: yes
    The installation was completed successfully!

At this point the software will be ready to use. Please see the administrator's guide for the individual products for further information regarding their usage.

Updating Software

You can use exactly the same procedure to update existing installations. However, be aware that the installer looks for existing installations only where it initially placed them. If you have moved things around, the installer might not be able to recognize that it is supposed to update an installation instead of installing a new one. If this happens, it might overwrite configuration files with their defaults from the installer! So read the questions it's asking you carefully if you were intending to update a software package and it's asking you to perform an installation—don't just say yes! If it has detected your existing installation, it will specifically ask you if it should perform an upgrade!

Installation Log

Every time you run a jar-based installer from Solido Systems, it will write an installation log in the folder it's being run from. This file contains a log of everything it has done during the installation. If you need to know exactly what it has done, look in this file. Also, if you run into problems during the installation, this log will typically contain the information you need to solve the problem.

The following example is the log which was created under the installation shown above. You should generally see PASS on every line, except the very first. This is the check that was done to see if the software had already been installed. If that had passed, the installer would suggest an update instead of an installation.

FAIL : Looking for folder '/usr/local/solido/smtpproxy/jar/'
PASS : Looking for file '/usr/bin/java'
PASS : Folder created '/usr/local/solido/smtpproxy/jar/'
PASS : File installed '/usr/local/solido/smtpproxy/jar/solidoutil.jar'
PASS : File installed '/usr/local/solido/smtpproxy/jar/solidoemail.jar'
PASS : Folder already exists '/usr/local/bin/'
PASS : File installed '/usr/local/bin/smtpproxyctrl'
PASS : File chmod executed '/usr/local/bin/smtpproxyctrl'
PASS : Folder created '/usr/local/solido/smtpproxy/etc/'
PASS : File installed '/usr/local/solido/smtpproxy/etc/proxy.config'
PASS : File inst