Référence : DOP/CB/NSE/ILE/2006-321 15/01/07
CARAIBES V3.3 – Installation guide
Only for Solaris 2.8 and Linux RedHat operating systems
This guide will help you to install CARAIBES software on platforms SUN
Solaris 2.8 and LINUX RedHat 7.2, 8.0, 9.0 and Entreeprise 3.
To install CARAIBES software with the CD-ROM, you must have the access
rights to the installation directory, that’s mean be able to create it and write on it.
With some systems, mount the CD-ROM requires to know the root password.
CARAIBES software requires a disk space of 1.6 giga-bytes. Then, the
CARAIBES installation directory have to receive this amount of data.
Before to start the installation procedure, take the installation key delivered with
the CD-ROM (CARAIBES V3.3 – Installation key).
Step 1. Identify your plateform
Check that the station where CARAIBES will be installed has SUN Solaris 2.8
or LINUX ReadHat as operating system : the command as follows will display
the name and version of your operating system :
$ uname –sr
Step 2. Establish the path to your favorite text editor
This editor will be used to print Ascii files in window. Its full pathname will be
asked yourself during the installation procedure. The command as follows will
display this path :
$ which <name of your text editor>
If you use vi, the path input during the installation must be :
/usr/openwin/bin/cmdtool –e <path to vi>
If you use textedit1, the path input during the installation must be :
/usr/openwin/bin/textedit –geometry 800x400
If you use nedit2, the path input during the installation must be :
Step 3. Establish the path to Netscape/Mozilla
The Netscape/Mozilla viewer is used to display the on-line help. Its full
pathname will be asked yourself during the installation procedure. The command
as follows will display this path :
Only on Solaris 2.8 plateform
Only on Red Hat plateform
IFREMER – Centre de Brest
Département Navires et Systèmes Embarqués (DOP/CB/NSE)
BP 70 – 29280 PLOUZANE – Téléphone : 02 98 22 41 83 – Télécopie : 02 98 22 45 46 1
$ which netscape3
$ which mozilla4
Step 4. Establish the path to GMT
This allows yourself to import in CARAIBES GMT grids or to export to GMT or
ArcView DTM from CARAIBES. The full pathname to GMT commands will be
asked yourself during the installation procedure ; it is necessary to include in it
the bin directory if it follows the gmt directory. Example :
Do Return if you don’t have access to GMT. Note : New CARAIBES version
supports GMT 3.4
Step 5. Mount the CD-ROM on your file system
Put the CD-ROM in the device. If your system uses a « volume manager », the
CD-ROM is automatically mounted. Contact your system administrator to know
the mounting directory. Otherwise, you have to mount manually your CD-ROM.
To do that, connect yourself with the name root. If there isn’t CD-ROM
mounting directory, create it ; the example as follows use /cdrom directory :
$ mkdir /cdrom
Then, hit the command for mounting :
$ mount -F hsfs -o ro /dev/sr0 /cdrom
If this command fails, contact your system administrator for more help on CD-
Step 6. Go to the CARAIBES directory
$ cd /cdrom/caraibes_v3.3 (if automatic mounting)
or $ cd /cdrom (if manual mounting)
Step 7. Install CARAIBES
Execute the installation script, and answer to the questions :
The installation key is requested and checked. If it doesn’t correspond to the one
expected, the installation is stopped. To make easier the input of the key, it is
include in the file license.txt located on the CD-ROM.
Then, what doing ?
This procedure has installed CARAIBES. Then, you have to configure the users
environments. To do that, every new user has to execute the configuration script
of his environment (only the first time) :
$ <CARAIBES directory>/CIB_User
Note that <CARAIBES directory> is <Installation directory>/Caraibes_V3.3.
The CIB_User script will create in the user home directory a new directory
Caraibes, containing his environment, and a script to run the software with a
french or english interface :
A size can be given to Netscape windows by entering, during the installation
<access path>/netscape –geometry 800x900.
Only in Linux environment.
$ caraibes to start the software in french,
$ caraibes uk to start the software in english.
Note that this procedure must be executed too by users of CARAIBES previous
version; default processing parameters, initialized with this version, will be kept.
Precautions for use of CARAIBES
Language of station configuration must be english :
• environment variable LANG must be set on C,
• if it is not the case, in the CDE/OpenWindows session connection panel,
use the menu Options/Language/C to es_BO and set the choice to C
Keyboard keys Caps Lock and Num Lock have not to be active.
Patches of 3.3 version of CARAIBES
It is advised to install regularly the patches located on the CARAIBES internet
Some keys to have a good start with CARAIBES
<user> is noted as the username and ~ his home directory.
1. Hardware environment / Temporary disk space used by CARAIBES
CARAIBES uses teporary disk space as ante-memory for processing data.
The needed disk space can be important in particular for imagery data which
mosaics often reach several tenth of mega-bytes. The disk space used is
located per default on /tmp file system of the station where CARAIBES is
executed. You ensure that this space is sufficient (about 500 Mb). This point
is especially important for user processing imagery.
Nota : it is possible to configure the location of this temporary directory in
the Configuration panel called in the menu of the Supervision.
2. Processing flows editor / Initial default values of CARAIBES
The default initial values of CARAIBES modules can get into errors of
execution when first use of these modules.
If the message « Don’t know how to make target
/home/data/CARAIBES/… » is displayed, then the error comes from
filenames defined per default and not found in your file system. To solve this
problem, it is enough to search the corresponding filename in the interface
panel and to replace it by the name of an existing file.
If others errors occurs, the solution is to remove the file containing the
default values ; example : if the module is « Module », then the file to
remove is Module.val on the directory
3. Processing flows editor / « Drag&drop » of files on processing
This operation is refused if the file extension doesn’t correspond to the
default CARAIBES extension. However, if the file is valid, open the
processing parameters panel and do the same operation on the associated
input field. There is no control of the extension at this level.
4. Processing flows editor / Analim module
When first use, it is necessary to modify the « Context file » in the
parameters panel ; the file to inform already exists in the user environment :
5. Processing flows editor / View3d-Anim3d modules
Use of these modules requires to install first the library OpenGL™,
downloadable from Sun internet site. Libraries must be located in
/usr/openwin/lib directory or in e directory included in LD_LIBRARY_PATH.