| Installation | Utilisation des shells | Complément d'installation | En cas d'ennuis |

Installation de Melina à partir d'un fichier melina.tgz

Auteur : D.Martin
Dernière modification : D.Martin (1 juillet 2011)

Ce fichier html est tape pour etre lu comme fichier README au format texte (unwrapped, sans accents et sur 80 colonnes et sans images), ou bien avec un navigateur, il n'est donc pas tres jojo.

Ce fichier correspond a la derniere version de Melina (2_5). Si vous installez une version plus ancienne, consultez le fichier README-install-html qui l'accompagne.

La structure de la distribution de Melina correspondant a cette version peut avoir ete modifiee, cette version complete ne doit donc pas etre installee par dessus une version anterieure.

Avant l'installation

Se placer dans le directory contenant l'installation ou creer un tel directory et s'y placer, il sera note dans toute la suite $melina, par defaut
$melina = /Library/Melina sous Mac OS X,
$melina = /usr/local/melina sous les autres systemes Unix L'archive contenant la distribution usuelle de Melina contient plusieurs directories.

Installation

Decomprimer melina.tgz en l'archive melina.tar et de-archiver melina.tar dans le directory $melina

> tar zxf melina.tgz
ou
> gunzip melina.tgz
> tar xf melina.tar

Le directory $melina doit contenir les directories
READMEs, bin, etc, exemples, make, maillages, melina_tex, sources, utils
et, eventuellement, sinon ils seront crees a l'installation, les directories
binutils, lib, var

Mise a jour des 'paths' dans les 'shells'

Pour installer melina, il faut modifier les fichiers :

mewhereis, melocate du directory $melina/bin,
makefile, makelib, makefile_mome, makefile_mevisu, makefile_utilisateur et makelib_utilisateur du directory $melina/make

et indiquer les 'paths' de l'installation.

Pour cela, se placer dans le directory $melina/bin et lancer le shell me_chpath (le PATH de l'installateur *doit* contenir './' !)

> me_chpath

et suivre les instructions.

Finalisationnementation.

On peut alors commencer l'installation de melina en tapant (toujours dans le directory $melina/bin)

> me_install (creation des directories binutils, lib, var installation du directory var et des liens dans les librairies)

> me_compilall (compilation complete et archivage des librairies)

Le fichier 'me-install-*' du directory $melina/var/log relate les actions d'installation (creation de directories et fichiers, archives creees, ...)

En cas d'ennuis voir les indications a la fin de ce fichier.

Utilisation des shells

Pour utiliser les shells et makefiles de Melina, il est conseille de rajouter le path du directory bin de melina dans la variable PATH; par exemple, si melina est dans le directory /usr/local/melina (c'est-a-dire $melina = /usr/local/melina)

> setenv PATH "${PATH}:/usr/local/melina/bin" > export PATH=${PATH}:/usr/local/melina/bin
ou encore
> set path = ($path /usr/local/melina/bin)
(fichier de configuration .login, .xsession, .[ba/c/tc]shrc, etc.) ... et lire la documentation en ligne.
Tester la variable PATH et le shell mewhereis en tapant
> mewhereis mewhereis
qui doit retourner le path du shell mewhereis.

Complement d'installation

Traducteur Melina - Modulef : mome

Pour installer mome, il est necessaire de disposer des libraries de modulef : nopo, utii, utsd et u_xxx (xxx depend de l'OS), et d'indiquer leur path. Pour cela lancer le shell (directory $melina/bin).

> me_chpath mome

Pour creer l'executable de mome, il suffit alors de se placer dans le directory mome de melina et le lancer le makefile

> cd `mewhereis mome` ; make

Installation de PGPLOT

L'installation de mevisu et grame necessite l'installation prealable de la librairie graphique PGPLOT.

Visualisation de fichiers de maillage Melina : mevisu

L'installation de PGPLOT etant faite il suffit de se placer dans le directory de mevisu et

> cd `mewhereis mevisu` ; make

Pour configurer mevisu, lire READMEs/ALIRE_mevisu.txt

Representation graphique : grame

L'installation de PGPLOT etant faite il suffit de se placer dans le directory de grame et

> cd `mewhereis grame` ; make ; make install ; make clean

Pour utiliser grame, lire le fichier READMEs/ALIRE_grame.txt

Quelques explications en cas de probleme d'installation

Quelques ennuis previsibles dans la phase d'installation.

La liste des machines sur lesquelles Melina est installe et fonctionne est obtenu en tapant :

> options_machine --machine

Si votre machine/OS figure dans la liste, tout devrait etre OK (en supposant que les parametres d'installation retenus sont coherents avec l'installation de l'OS et des compilateurs).

La liste des parametres est obtenue en tapant :

> options_machine --help

La valeur retenue pour chacun de ces parametres est obtenue en tapant :

> options_machine --list

Si ces valeurs ne conviennent pas, le fichier options_machine doit etre adapte.

Quelques ennuis previsibles avec 'make'.

L'installation et la compilation utilise le programme 'make' de maniere recursive sous la forme du 'gnumake' ou du make installe dans l'OS ... selon l'OS ou le shell et le PATH de l'utilisateur.
Lorsque plusieurs 'make' coexistent dans le systeme (cas courant), il est de la responsabilite de l'utilisateur de verifier que les 'appels recursifs' se font toujours avec le meme programme 'make'.

Une des sources d'ennui rencontree est celle d'un alias du type

> alias make gnumake

qui 'actionne gnumake' lors de l'appel de plus haut niveau puis l'autre 'make' dans les appels recursifs (le 'makefile' utilise le Bourne shell et ignore les aliases).