CARAIBES V3.3 – Installation guide

Document Sample
CARAIBES V3.3 – Installation guide Powered By Docstoc
					           Note d'information
    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.
Pre-required
      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 :
         /usr/X11R6/bin/nedit

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 :


1
    Only on Solaris 2.8 plateform
2
    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 :
         /home/services_sv/logiciels/gmt/bin
      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-
      ROM mounting.
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 :
         $ cib_inst.sh
      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 :

3
 A size can be given to Netscape windows by entering, during the installation
<access path>/netscape –geometry 800x900.
4
    Only in Linux environment.



                                                                                       2
         $ 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
        --- POSIX.
  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
  site (http://www.ifremer.fr/caraibes).

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
        ~/Caraibes/V3.2/SYS/DAT/CIB_UserProcessPalette.
   3.    Processing flows editor / « Drag&drop » of files on processing
         input/output files
        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 :
        ~/Caraibes/V3.2/SYS/DAT/CIB_ImageryContext/Analim_Context.cfg.



                                                                                         3
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.




                                                                            4