l3.cas-d-astre/doc/installation.tex

\section{Pré-requis}

\subsection{Machine serveur}
D'Astre.Net nécessite, pour fonctionner :
\begin{itemize}
\item{un serveur web,}
\item{un interpréteur PHP 4.2,}
\item{un serveur de base de donnée relationnelle compatible SQL,}
\item{une connexion réseau permettant au serveur de communiquer avec 
  les machines clientes.}
\end{itemize}

\subsection{Machines clientes}
\par Au niveau utilisateur, il est nécessaire d'avoir:
\begin{itemize}
\item{une connexion réseau permettant de contacter le serveur hébergeant
	D'Astre.Net}
\item{un navigateur web supportant pleinement les normes du W3C: 
	XHTML 1.0 et CSS 2, ainsi que le langage JavaScript normalisé ECMA.}
\end{itemize}~

\par Nous conseillons l'utilisation d'un navigateur tel que 
Mozilla 1.5\footnote{\url{http://www.frenchmozilla.org}},
Mozilla-FireFox 0.7\footnote{\url{http://www.frenchmozilla.org}}, 
Opera 6\footnote{\url{http://www.opera.com}}, 
Safari 1.1\footnote{\url{http://www.apple.com/fr/}} ou versions supérieures.
\par Microsoft Internet Explorer 6 ne supportant complètement ni CSS 1,
 ni CSS 2 nous ne pouvons garantir avec ce logiciel une parfaite navigation
 sur les pages de D'Astre.Net.

\section{Déploiement du logiciel}

\subsection{Téléchargement}

\par Vous pouvez vous procurer D'Astre.Net via
%TODO: (compléter)

ou le télécharger sur le CVS :
%TODO: (compléter)


\subsection{Décompression du package}

\par Une fois l'archive de D'Astre.Net récupérée, 
il vous faudra
choisir un répertoire d'installation (désigné
par "\verb+/le/repertoire/d_installation+"
ici), faire en sorte qu'il soit accessible en lecture, 
et y mettre le contenu de l'archive.

\par Dans votre terminal, tapez :

\lstset{language=csh}
\begin{lstlisting}
$ mkdir /le/repertoire/d_installation
$ chmod 755 /le/repertoire/d_installation
$ tar -xzvf archive.tar.gz 
$ mv dastrenet/* /le/repertoire/d_installation
\end{lstlisting}


\subsection{Mise en place de la base de donnée}

\subsubsection{Création de la base}

\par Dans une console, connectez vous en tant qu'administrateur 
sur la base donnée :
\lstset{language=csh}
\begin{lstlisting}
$ cd /le/repertoire/d_installation
$ mysql -u root -p
Enter password:  (password)
[...]

mysql>
\end{lstlisting}

Ajoutez une nouvelle base nommée (nommée ici "\verb+dastre_base+")
à votre base de donnée :
\lstset{language=SQL,morekeywords={DATABASE}}
\begin{lstlisting}
mysql> CREATE DATABASE dastre_base;
Query OK, 1 row affected (0.07 sec)
\end{lstlisting}


\subsubsection{Création de l'utilisateur}

\par Vous devez ensuite choisir un nouveau nom d'utilisateur 
(et le mot de passe associé) qui serviront à accéder à la base
de D'Astre.Net.
On choisira pour la suite \verb+dastre_username+ pour représenter
l'identifiant de l'utilisateur et \verb+dastre_userpass+ pour son mot
de passe.

\par Dans le shell de votre base de données (ouvert en tant qu'administrateur), tapez :
\lstset{language=SQL,%
  morekeywords={DATABASE,DELETE,FLUSH,GRANT,UPDATE,TO,IDENTIFIED}%
  }
\begin{lstlisting}
mysql> GRANT SELECT,INSERT,UPDATE,
    ->     DELETE,CREATE,ALTER,DROP
    ->     ON dastre_base.*
    ->     TO dastre_username@'serveur.domaine'
    ->     IDENTIFIED BY 'userpass';
Query OK, 0 rows affected (1.16 sec)

mysql> FLUSH privileges;
Query OK, 0 rows affected (0.36)
\end{lstlisting}


\subsection{Configuration du serveur web}

\par Ensuite, il convient de configurer le serveur
web afin qu'il permette l'accès au logiciel sur le serveur \verb+serveur.domaine+, 
via un nom DNS simple, par exemple \verb+dastre_url.serveur.domaine+.
Il faut pour cela, ajouter (ou modifier) un \verb+VirtualHost+ dans
la configuration du serveur web.

\par Par exemple, pour un serveur Apache, on ajoutera les lignes 
suivantes au fichier \verb+/etc/apache/httpd.conf+ (ou \verb+/etc/httpd/httpd.conf+).
\lstset{language=HTTPD}
\begin{lstlisting}
<VirtualHost dastre_url.serveur.domaine>
  DocumentRoot /le/repertoire/d_installation
  ServerName dastre_url.serveur.domaine
</VirtualHost>
\end{lstlisting}


\subsection{Configuration du logiciel}

Dans l'arborescence de D'Astre.Net, éditer le fichier 
\verb+/config/db.conf.php+ qui fixe la configuration 
du logiciel, et ajoutez ou remplacer-y les valeurs suivantes :

\begin{itemize}
\item{ le nom du serveur \verb+SQL_SERVER+, }
\item{ le nom de la base de données \verb+SQL_BASE+,}
\item{ le nom de l'utilisateur \verb+SQL_USER+, }
\item{ le mot de passe de l'utilisateur \verb+SQL_PASSWD+. }
\end{itemize}
\par \lstset{language=PHP}
\begin{lstlisting}
define(SQL_SERVER,"serveur.domaine");  
define(SQL_BASE,"dastre_base"); 
define(SQL_USER,"dastre_username"); 
define(SQL_PASSWD,"dastre_userpass"); 
\end{lstlisting}

\subsection{Création des tables de la base}

\par Une fois le logiciel installé, et les divers serveurs correctement
configurés, il convient de créer les tables utiles à D'Astre.Net dans 
la base \verb+dastre_base+.
Pour cela, ouvrez un navigateur web, et connectez-vous sur : 
\url{http://dastre\_url.serveur.domaine/sql/install.php}.

\par Si toutes les requêtes sont executées avec succès, il ne reste plus
qu'a changer les droits d'accès au répertoire \verb+/sql+ de l'arborescence 
de D'Astre.Net afin d'éviter qu'un utilisateur réinitialise la base.
\lstset{language=csh}
\begin{lstlisting}
$ cd /le/repertoire/d_installation
$ chmod 400 sql
\end{lstlisting}

\par Normalement, à ce stade, D'Astre.Net est prêt à être utilisé.

\subsection{En cas de problèmes}

Si jamais il s'est produit une erreur durant de la création 
des tables, vous pouvez à tout moment effacer ces dernières
et recommencer en suivant la démarche suivante : ouvrez un
navigateur web, et connectez-vous sur : 
\url{http://dastre\_url.serveur.domaine/sql/drop.php}.