3. Community, Standard, and Professional Editions

To install Poseidon for UML, you can choose any one of the following installation procedures:

A complete installation guide is available at http://www.gentleware.com/index.php?id=instguides

3.1. Install Using InstallAnywhere

The easiest way to install Poseidon for UML is to use the InstallAnywhere installer for your platform. If you already have a recent Java version installed, you can download the installer for your platform that does not include Java. If you do not have Java installed or if you are not sure of the version, download the installer that includes Java.

You will be asked to specify an installation folder and a location for shortcuts. Free disk space of about 20 MB is required.

3.1.1. Windows

The Windows installer functions similarly to other installation applications. It is an exe file that will prompt you through the entire process.

Following installation, start Poseidon for UML by selecting the icon placed in the 'Start' menu by the installer.

3.1.2. *NIX

The InstallAnywhere installer is known to run on RedHat, Caldera, TurboLinux, and SuSe. It will not work on Mandrake. If you are using Mandrake (or another *NIX flavor that appears not to like the installer), you should use the compressed file installation process.

Ensure that your installation file executable with:

chmod u+x <your-poseidon-installer>.bin

Then execute the file. If '.' is not in your path you should use:

./PoseidonCE_2_1_1Installer.bin to start the file.

3.2. Install Through Java Web Start (Community Edition Only)

Java Web Start is a mechanism provided by Sun Microsystems to automatically install and start applications from the internet. After Java Web Start is installed, double-click the provided link. The required files are then automatically loaded to a cache on your local disk and the program is started. The first time this may take a little while, but the second time around most information is taken from the local cache.

Web Start provides a big advantage in that the new version will start automatically as soon as the program is updated on the server. The program also works when you are not online - in this case, the local copy from the cache is used.

First, Java Web Start needs to be installed. If you are using JDK 1.4, Web Start may already have been installed along with the JDK. If not, follow these steps:

  1. Download the Java Web Start installation file. You can get it from Sun at http://java.sun.com/products/javawebstart/

    You will automatically be provided with a self-installing file for your platform.

  2. Close all your browser windows

  3. Execute the downloaded file.

  4. Open your browser again, then go to http://www.gentleware.org/webstart2/Poseidon.jnlp for Java Web Start. After a few moments, the latest release version of Poseidon for UML (Community Edition) will start up automatically.

3.3. Install from a ZIP File

If you prefer to install Poseidon for UML without an installer, you can download and install a platform independent zip file. Installation is very simple. In short, download the file, unzip it, open the created folder and run the start script. Follow these steps:

  1. To locally install Poseidon, you first need to download the corresponding file over the internet. Make sure that you are connected to the internet, then open your favorite internet browser and go to http://www.gentleware.com/index.php?id=114.

  2. Follow the download instructions. You will then have a single file stored on your local hard drive in the location you have indicated.

    • The file is compressed using zip format. Move this file to the folder where you would like to install Poseidon for UML. Then, to decompress it, call the zip program used on your platform. Here are some examples:

    • On Linux or Unix, open a command shell, go to the folder where the downloaded file is stored (using the cd command), and call unzip PoseidonPE-##.##.zip. The file may be named differently, depending on the edition you downloaded.

    • On Windows, start your Zip program. The Zip program should automatically start if you double-click on the downloaded file. Then extract the file to a folder of your choice by selecting extract and following the instructions.

  3. All Poseidon files are extracted into a folder PoseidonForUML_XX_##.##.

  4. Switch to the /bin subfolder.

  5. Run the start script provided authentificationfor your platform:

    • On Linux or Unix, open a command shell, enter the poseidon.sh command, and press return.

    • On Windows, open the file explorer and double-click the start script poseidon.bat.

3.4. Silent Installation

Silent installation is a convenient way to install Poseidon without having to interact with the dialogs of the standard installation. There are a few differences based on the operating system in use: on Windows, the initial progress indicator and final 'clean up' screen will be visible during launch; and on Mac OS X supports silent mode only when running a UNIX installer. All default values except the installation directory are used in this mode.

You can perform a silent install via the regular installer using an Installer Properties file or the command line.

3.4.1. Installer Properties File

In order to install Poseidon in silent mode, you must first create a properties file. This file should be placed in the same directory as the installer, and given the same name as the installer with the file extension .properties. For example, if the downloaded installer is named PoseidonPE_2_2Installer.exe, then the properties file within the same directory should be named PoseidonPE_2_2Installer.properties.

Within this file, you can declare the installation directory and the installation mode through the variables USER_INSTALL_DIR and INSTALLER_UI.

Here are the contents of a sample properties file:

USER_INSTALL_DIR=/programs/PoseidonPE2/
INSTALLER_UI=silent

3.4.2. Command Line Parameter

To use the installer in silent mode from the command line, type:


                            installername -i silent
                        

It is also possible to use the Properties file from the command line:


                            installername -f <properties file>
                        

3.4.3. Uninstallation

When silent mode using a properties file has been used to install Poseidon and this file still exists, uninstallation is also completed silently.

3.5. Uninstallation

The Poseidon installer places an uninstall utility within the program directory. You can uninstall Poseidon by running this utility.

From Windows, you have the additional option of uninstalling Poseidon from the Software section of the Control Panel.

Once the uninstaller starts, follow the prompts to remove Poseidon from your system.

If you are planning to re-install Poseidon, you should copy your Poseidon settings directory to another location before starting the uninstall procedure in order to avoid losing your keys and registration data. In general, the Poseidon settings directory is located under your user's home directory in .poseidon/< poseidon edition>, where < poseidon edition> is the abbreviation for the Edition. Below, the user 'homer' has moved his Professional Edition directory to a temporary location before proceeding with the uninstallation.