Jalopy comes as a compressed Jar Archive (Jar) that contains all necessary application files. The Jar is executable and provides a graphical setup wizard that lets you install the software in a few easy steps. If you're about to install Jalopy for the first time, wizard installation is highly recommended. If you install an upgrade, it is usually much simpler to perform a silent install as described in the section called "Silent Installation".
To start the setup wizard, you may type
java -jar jalopy-setup-Help_xxx.jar
at the command line. But with modern Java virtual machines it is usually much simpler to launch the setup by just double-clicking the downloaded Jar file from within your file manager.
After you've invoked the setup wizard, the welcome screen will appear shortly.
To proceed with the installation, click the button.
You can press the button at any time to abort the installation. A dialog will appear that asks for confirmation.
Press the button to exit the setup process. Press to close the dialog and continue with the setup.
The license agreement will be displayed. Read it carefully!
You need to accept the license agreement before you can proceed with the installation. Select the I accept the terms in the license agreement item and press the button to proceed.
In case an older Jalopy release could be found on your machine, the setup lets you choose whether the settings of the prior version should be imported during installation. Select the option to have your settings imported or to ignore your current settings.
Additionally, you can control whether your prior settings should be deleted or kept. Select to delete your existing settings. Or choose to leave any present settings untouched.
Please note that the settings of the Open Source version are always removed during installation. If you want to keep such settings, make a backup of the Jalopy settings directory before you start the setup routine. Detailed information about the Jalopy settings system can be found in Chapter 2, Configuration.
You will be asked whether you want to download the help system for the preferences dialog. It is recommended to let the installer handle help installation, but if you're installing on a machine without Internet access, you can download the help file separately from "http://www.triemax.com/download/jalopy-help-Help.jar" and either place it along the directory where the installer sits - it will then be picked up and installed automatically by the installer (the Download Online Help screen does not appear in such a case).
Or copy the file into the Jalopy settings directory, e.g. on a typcial Windows XP system to "C:\Documents and Settings\John Doo\.jalopy\Help\jalopy-help-Help.jar".
Lets you choose the program features that setup should install. Select any of the check boxes to have a feature installed.
All Plug-in features require you to select the installation directory where the target application resides, i.e. the root directory of the application. The setup wizard ensures that the Plug-in files will be copied into the appropriate places for each target application. When you first select a feature, a file chooser pops up that lets you select the installation directory for the specific application.
Please note that if multiple check boxes are selected at once, multiple file choosers will appear one after another. Don't be confused, just look at the title of each file chooser to see what application directory is required.
Setup will validate your selection and informs you when the selected directory does not match the anticipated application root directory.
Press the button if you want to select another directory. Otherwise, if you decide to miss out the feature, you can press the button to skip the selection process and return to the feature selection screen (or the next file selection dialog).
Only the Eclipse Plug-in differs here, in that it may be installed into a freely chooseable folder that will only be linked to the Eclipse installation. When you choose a folder that is not the root folder of your Eclipse installation, you will be asked, whether you want to use the folder as a link folder.
If the link folder can be found below the Eclipse installation directory, the wizard will automatically determine the links folder, otherwise you need to choose your Eclipse installation directory in a second step.
More information about Eclipse link files can be found on IBM's developer resources: "http://www-106.ibm.com/developerworks/opensource/library/os-ecfeat/"
You can change the installation directory for a feature at any time using the button.
After the wizard has gathered all necessary information it informs you that it is now ready to perform installation.
Press the button to start the installation. Please note that you cannot cancel the installation process afterwards!
If you think that you made a wrong choice, press the button to review your settings.
After pressing the button, installation will begin and a progress dialog will inform you about the pending installation steps.
The last screen hopefully notifies you about installation success.