|
|
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:
- After a short while you will be presented with a license agreement
screen. You must agree with the license agreement to continue.
- 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".
- 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.
- 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.
- 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.
- 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)
- Download the FIPA-OS distribution (Java
2 version
).
- After downloading,
the distribution file should be extracted using an archive tool such
as WinZip.
- 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.)
- 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.
- 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.
- 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.
- 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
- 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.
|
|
|
|