Instructions d'installation

Cette documentation est générique, d'autres documents livrés avec le logiciel (comme un fichier INSTALL ou README) peuvent être plus adaptés. En général, l'installation des programmes est simple et nécessite peu de connaissances et peu de droits sur l'ordinateur qui sera l'hote du programme. Plusieurs "fichiers" peuvent être installés :

Les executables

Les procédures sont très differentes en fonction du système :

Sous Linux/Unix/Cygwin :

Quel exécutable ? système, machine, statique vs dynamique

Avant d'installer un executable il faut choisir le bon. Pour connaitre votre système utilisez les commandes uname et file.

La commande uname
uname -a
  permet de connaitre :
Sous certains systèmes Unix/Linux :  uname -o donne le système et uname -m l'architecture de votre machine.
Exemples :

uname -a
>SunOS paris2 5.10 Generic_118833-17 sun4u sparc SUNW,Ultra-5_10
Le système est SunOS sur une architecture sparc.

uname -a
>Linux ccdl55 2.6.18-5-686 #1 SMP Wed Oct 3 00:12:50 UTC 2007 i686 GNU/Linux
Le système est Linux sur un architecture pentium (i686)

La commande file
Une autre façon de déterminer l'executable à installer  consiste à examiner un executable fonctionnant déjà sur  votre machine avec la commande file : par exemple la commande ls.

file /usr/bin/ls
>/usr/bin/ls:    ELF 32-bit MSB executable SPARC Version 1, dynamically linked, stripped


file /bin/ls
>/bin/ls: ELF 32-bit LSB executable, Intel 80386, version 1 (SYSV), for GNU/Linux 2.4.1, dynamically linked (uses shared libs), for GNU/Linux 2.4.1, stripped

Il faut télécharger l'executable qui a les mêmes caractéristiques. Par exemple pour le programme delos_lnx :

file delos_lnx
>delos_lnx:      ELF 32-bit LSB executable 80386 Version 1, dynamically linked, not stripped

32 bits versus 64 bits
Un exécutable 32 bits fonctionnera sur une machine 64 mais la réciproque n'est pas vraie.

Executable statique versus dynamique
Un exécutable "statique" contient les librairies qui lui sont nécessaires : il est plus portable mais plus volumineux (en taille).
Un exécutable "classique" fera appel à des librairies dynamiques au moment de l'execution. Elles doivent être présentes sur l'ordinateur sinon un message d'erreur apparaît au lancement.
Les librairies nécessaires sont usuelles et généralement présentes sur tous les ordinateurs, néanmoins les versions "statiques" sont proposées et peuvent être téléchargées.

file delos_lnx_static
>
delos_lnx_static: ELF 32-bit LSB executable, Intel 80386, version 1 (SYSV), for GNU/Linux 2.2.5, statically linked, for GNU/Linux 2.2.5, not stripped

Les librairies dynamiques nécessaires à l'execution d'un binaire peuvent être déterminées avec la commande ldd.

Installation

L'installation est ensuite très simple et tout à fait classique. Nous donnons ici un exemple pour un "shell" de type csh ou tcsh. Notons "nomprog" le nom du programme à installer et "chemprog" le chemin complet du repertoire où vous avez copié le programme et l'aide en ligne.

  1. tcsh (si vous n'êtes pas dans le mode tcsh)
  2. chmod u+x  nomprog (pour rendre le fichier executable),
  3. set path=( $path  chemprog)
  4. setenv MANPATH $MANPATH:chemprog

Installation définitive

Si vous souhaitez éviter de retaper les 2 dernières lignes de commande dans chaque nouvelle fenêtre,  vous pouvez les ajouter dans le fichier .tcshrc (si votre shell de login est tcsh) dans votre répertoire d'accueil (Home directory).

Une autre technique consiste simplement à déplacez les fichiers (exécutables et aide en ligne) dans des répertoires appropriés (mais il faut avoir les droits pour ecriré dans ces répertoires). Par exemple :
  1. mv     nomprog     /usr/local/bin/
  2. mv    man/cat1/nomprog.1  /usr/share/man/cat1/
pour choisir les bons répertoires,  demandez la liste :
echo $path
echo $MANPATH

Sous Windows (95, 98, 2000, XP):

Plusieurs installations sont possibles en fonction du mode d'utilisation que vous souhaitez :

Notons "nomprog" le nom du programme à installer et "chemprog" le chemin complet du repertoire où vous avez copié le programme.

Utilisation sous "DOS"

Vous souhaitez utiliser l'interpreteur de commande "cmd" (en W2000,XP ou "commands" W95) et lancer les programmes en ligne de commande.

  1. Du menu "Démarrer" de windows, lancer "Exécuter" avec comme nom de programme "cmd".
  2. Placez-vous sous le repertoire contenant vos données à l'aide de la commande CD et lancez les executions en ligne de commande.
  3. Si vous avez un message d'erreur du type : "nomprog" n'est pas reconnu en tant que commande interne, il vous suffit de tapez la commande :  set PATH=%PATH%:chemprog  et de relancer le programme.

De même que pour Unix, si vous souhaitez éviter la ligne de commande "set PATH=%PATH%:chemprog" à chaque fois que vous lancez l'interpreteur "cmd" il suffit de modifier les variables dans Windows.
  1. Dans le menu "Demarrer", choisir "Panneau de configuration", puis "Systeme", ensuite selectionnez l'onglet "Avancé" puis enfin "variables d'environnement...". 
  2. Accédez aux "variables système" et "modifier" : "Path" en ajoutant en début "chemprog;" ou en fin  ";chemprog". ATTENTION à ne pas éffacer le reste de la variable !
Une autre technique consiste simplement à déplacez les fichiers (exécutables) dans des répertoires appropriés (mais il faut avoir les droits pour ecriré dans ces répertoires). Par exemple :

    move     nomprog     C:\WINNT\

pour choisir les bons répertoires,  demandez la liste :

    echo %PATH%

Utilisation sous windows

Vous souhaitez cliquez directement sur les fichiers de données pour lancer les executions. Vous pouvez associer plusieurs executables pour une extension donnée (fichier avec un suffixe .txt par exemple). Dans ce cas il faudra LE sélectionner par un clic droit de la souris. Dans le cas d'une association unique un double clic suffit. Donc si l'extension des fichiers n'est pas imposée, choisissez une extension qui n'est pas déjà prise !
Pour associer le programme à l'extension du fichier :
  1. Nommer le fichier de données avec l'extension choisie (si elle n'est pas imposée) puis cliquez dessus.
  2. Si une application s'ouvre c'est que l'extension est déjà prise :-(. Essayez-en une autre...
  3. Sinon Windows vous demande d'associer une programme (fenêtre "Ouvrir avec"),
  4. Choisissez "Autre..." puis parcourrez les repertoires jusqu'à retrouver "nomprog"

Les exemples

Rien n'est a priori nécessaire pour utiliser les exemples si ce n'est d'avoir installé le logiciel comme décrit dans l'une des rubriques précédentes.

La documentation

Les manuels et autres documents peuvent être lus à l'aide d' acrobat reader (généralement encapsulé dans votre navigateur) et qui peut être téléchargé -si nécessaire- à l'adresse suivante : http://www.adobe.fr

Les sources

A moins d'une indication contraire, le ou les fichiers source peuvent être simplement compilés avec les compilateurs GNU que l'on trouve pour Linux/Unix mais aussi sous windows sous forme minimaliste (mingw) ou avec cygwin. Les sources fortran doivent être compilés avec g77 , les sources C avec gcc, les sources C++ avec g++.