Installation

There are two types of download available from the FIPA-OS website:

• Self-extracting JAR file containing FIPA-OS (recommended)
  
  
• ZIP or TAR/GZ archive of FIPA-OS

It is recommended that the self-extracting JAR file be used if you are unfamiliar with WinZIP, tar, or FIPA-OS.

NOTE: Patches for the currently release of FIPA-OS can be found here - please check for patches after installing FIPA-OS.

Self-extracting JAR (not available for JDK1.1 version)

The self-extracting JAR file (downloadable here - Java 2 only) contains Java classes that take care of the process of installing FIPA-OS on your system, and starting the Configurator. There are two mechanisms for starting the installation process:

• Double-click the JAR file (Windows only) - this will only work if the default file-type created by the JRE installer is unchanged
  
  
• Type java -jar FIPA_OSv2_2_0_Installer.jar at a command prompt (All operating systems)

In either case you should follow these steps:

1. After a short while you will be presented with a license agreement screen. You must agree with the license agreement to continue.
   
   
2. The installer will then prompt you for an installation location. You may either select an existing directory, or create a new directory. In the later case, you should click the "Create New Folder" button and then rename the new folder as you wish. In order to select a directory it must be highlighted within the dialog box when you click "Open".
   
   
3. If the selected directory already existed, you will be prompted if you wish to backup its contents - the FIPA-OS installer will completely remove the directory's contents before unpacking the FIPA-OS distribution into this directory. If you select "Yes", the contents of the directory will be placed into a JAR file in its parent directory.
   
   
4. If there are any problems removing the directory or files it contains, the install process will abort. In this case simply remove the directory manually, and restart the installer.
   
   
5. Once FIPA-OS has completed installation, the Configuration Wizard will be automatically started. In the event that it fails to start after successful installation, please follow the instructions in the ZIP/GZ Archive section of this page for starting the Wizard/Configurator.
   
   
6. On Unix/Linux systems, the following step may need to be carried out in order to ensure that the SH scripts provide are executable:

   The permissions of the files in the 'bat' directory should be set so they are treated as executable files. This can be achieved by typing: chmod -R 755 bat/* at a command prompt in the FIPA-OS installation directory.

ZIP/GZ Archive

It is recommended that FIPA-OS is NOT installed on top of an older version, since this may lead to unforeseen compatibility issues between the two versions.

These archives should simply be extracted into the desired installation directory. The Wizard/Configurator should then be used to correctly configure FIPA-OS (see Distribution Notes). The following are step-by-step guides for various operating systems:

Windows (e.g Windows 95, 98, NT and 2000)

1. Download the FIPA-OS distribution (Java 2 version ).
   
   
2. After downloading, the distribution file should be extracted using an archive tool such as WinZip.
   
   
3. Once the contents of the distribution file has been extracted invoke the StartWizard.bat file which is located in the 'bat' sub-folder of the installation directory to launch the Configuration Wizard.

UNIX (e.g. Linux, Solaris, etc.)

1. Download the FIPA-OS distribution (Java 2 version). You will need to right-click this link and select "Save Link As..." or "Save Target As...", depending on your browser, and then select a destination in which to save the file.
   
   
2. Open a shell and 'cd' to the directory where you downloaded the distribution file. To extract the contents of the FIPA-OS distribution file type tar -xvz -fFIPA_OSv2_2_0.tar.gz. Note, the contents of the distribution file will be expanded in your current directory.
   
   
3. The permissions of the files in the 'bat' directory should be set so they are treated as executable files. This can be achieved by typing: chmod -R 755 bat/* at a command prompt in the FIPA-OS installation directory.
   
   
4. The Java 1.2 runtime must be in your path in order to complete the installation. You can add this information to your system PATH variable (if it is not already present) using the 'export' command. For example, if the JDK was installed in '/opt/software/jdk1.2.2' then typing the following command at the prompt will add this information to your PATH: export PATH=/opt/software/jdk1.2.2/bin:$PATH
   
   
5. At the prompt, navigate to the 'bat' sub-folder of the installation directory and type: sh ./StartWizard to start the Configuration Wizard. Alternatively type: sh ./StartConfig to start the Configurator and follow the instructions included in the Using the FIPA-OS Configuration Tool (Configurator) section of the Distribution Notes.