* [[developpement:activites:integration:|Intégration]]

====== Installation de Gaussian sous Debian Squeeze (et Ubuntu) ======

<note important>Cette documentation s'applique à Gaussian 09 version A01.</note>
===== Introduction =====

[[http://www.gaussian.com/|Gaussian]] est un outil largement utilisé par la communauté scientifique des chimistes, ce malgré la large contreverse concernant une licence effroyablement restrictive d'utilisation. Pour en juger, il suffit de se renseigner sur la communauté [[http://www.bannedbygaussian.org/|Banned By Gaussian]], toujours croissante.

Malgré cela, comme certains ne peuvent manifestement pas se passer de cet outil, pourquoi ne pas tenter de l'offrir dans les conditions les plus "ouvertes" possibles, c'est à dire sur le socle logiciel le plus OpenSource possible : une distribution GNU/Linux avec des outils de compilation libres.

Gaussian précise des [[http://www.gaussian.com/g09_plat.htm|conditions de compilation très restrictives]], exigeant l'usage du compilateur PGI (sur plate-forme AMD64), lequel consitue un coût caché dont nos institutions pourraient se passer si d'aventure Gaussian "compilait" avec GFortran et surtout "fonctionnait" ensuite.

Tout individu s'étant risqué dans la compilation de Gaussian sait ce que signifie le compiler et le faire fonctionner : un rude chemin de croix où chaque arrêt équivaut à un virage dissimulant le virage suivant, de longues et multiples compilations pour en arriver à des exécutions, qui, parfois, fonctionnent : il arrive que "Gaussian" tombe en marche pour le chanceux débutant...

Les notes qui vont suivre permettent pas à pas, moyennant des opérations assez lourdes (patcher un code propriétaire directement n'est pas une étape anodine), de récupérer un Gaussian fonctionnel...

<note important>En construction : pour l'instant, seule la version 64 bits (soit amd64 chez Debian) a été validée. Elle semble opérationnelle pour les versions Debian Lenny et Squeeze et les versions 10.04 et 10.10 de Ubuntu.</note>

Pour son utilisation, vous pouvez consulter le [[http://www.cbp.ens-lyon.fr/emmanuel.quemener/dokuwiki/doku.php?id=tools4test|"pied à l'étrier"]] rédigé pour les applications scientifiques installées dans le cadre de la formation Atosim.

  - Installation de quelques paquets Debian et leurs dépendances :<code>
# Installation du compilateur, des libraries OpenMP, Atlas/BLAS, tcsh
sudo apt-get install gfortran libgomp1 libatlas-base-dev tcsh patch
</code>
  - Configuration de l'environnement des sources à compiler :
    * il est supposé que le CDROM des sources de Gaussian09 est monté sur ''/media/cdrom''
    * le répertoire d'installation par défaut est ''/opt''
    * les sources sont extraites du fichier TGZ
    * par défaut, il vaut mieux utiliser le CSH pour la compilation :<code>
tcsh
setenv basedir "/media/cdrom/"
setenv g09root "/opt"
cd $g09root
gunzip -c $basedir/tar/*.tgz | tar xvf -
</code>
  - Récupération du //patch// et son application pour compiler avec GFortran :<code>
cd g09
# pour une distribution Debian Squeeze sous 64 bits : 
wget http://www.cbp.ens-lyon.fr/emmanuel.quemener/software/Gaussian/g09.squeeze64
# pour une distribution Ubuntu 10.04 sous 64 bits : 
# wget http://www.cbp.ens-lyon.fr/emmanuel.quemener/software/Gaussian/g09.ubuntu64-1004
# pour une distribution Ubuntu 10.10 sous 64 bits : 
# wget http://www.cbp.ens-lyon.fr/emmanuel.quemener/software/Gaussian/g09.ubuntu64-1010

# pour une distribution Debian Squeeze sous 32 bits (nouveau !) : 
wget http://www.cbp.ens-lyon.fr/emmanuel.quemener/software/Gaussian/g09.squeeze32

# La ligne suivante s'applique a la version pour la Debian Squeeze 64 bits
patch -p 1 -i ./g09.squeeze64
</code>
    * La sortie doit présenter les lignes suivantes :<code>
patching file bsd/i386.make
patching file bsd/mdutil.c
patching file bsd/mdutil.F
patching file bsd/set-mflags
</code>
  - Préparation de la compilation et lancement :<code>
./bsd/install
source $g09root/g09/bsd/g09.login
bsd/bldg09
</code>
  - Positionnement des droits pour toute l'arborescence (ici, tous les utilisateurs du groupe ''users'' ont accès) : <code>
chown -R root.users .
</code>



===== Test des compilations =====

Par défaut, le source de Gaussian comprend les résultats de tests sur architecture IA64 dans le dossier ''$g09root/g09/tests/ia64''.

Pour exécuter tous les tests, voici la commande <code>
# A rajouter à la fin de son .bashrc
export g09root=/opt
export GAUSS_SCRDIR=/tmp
. $g09root/g09/bsd/g09.profile</code>

Lancement de tous les tests :<code>
mkdir $HOME/Gaussian
cp $g09root/g09/tests/com/test*[0-9][0-9].com $HOME/Gaussian
cd $HOME/Gaussian
i=0
while [ $i -le 919 ]
do
  if [ -f test$(printf "%03d" $i).com ]; then
     time g09 test$(printf "%03d" $i).com 2> test$(printf "%03d" $i).time
  fi
  i=$(($i+1))
done
</code>

===== Commandes annexes =====

Pour établir les patchs à appliquer par rapport à l'archive de sources originelle, la commande suivante a été utilisée :<code>diff -crB g09 g09.work > g09.squeeze64</code>