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

\section{Pr<EFBFBD>-requis}

\subsection{Machine serveur}
D'Astre.Net n<>cessite, pour fonctionner :
\begin{itemize}
\item{un serveur web,}
\item{un interpr<70>teur PHP 4.2,}
\item{un serveur de base de donn<6E>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<69> 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<75>rieures.
\par Microsoft Internet Explorer 6 ne supportant compl<70>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<EFBFBD>ploiement du logiciel}

\subsection{T<EFBFBD>l<EFBFBD>chargement}

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

ou le t<>l<EFBFBD>charger sur le CVS :
%TODO: (compl<70>ter)


\subsection{D<EFBFBD>compression du package}

\par Une fois l'archive de D'Astre.Net r<>cup<75>r<EFBFBD>e, 
il vous faudra
choisir un r<>pertoire d'installation (d<>sign<67>
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<6E>e}

\subsubsection{Cr<EFBFBD>ation de la base}

\par Dans une console, connectez vous en tant qu'administrateur 
sur la base donn<6E>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<6D>e (nomm<6D>e ici "\verb+dastre_base+")
<EFBFBD> votre base de donn<6E>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<EFBFBD>ation de l'utilisateur}

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

\par Dans le shell de votre base de donn<6E>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<63>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, <20>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<6E>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<EFBFBD>ation des tables de la base}

\par Une fois le logiciel install<6C>, et les divers serveurs correctement
configur<EFBFBD>s, il convient de cr<63>er les tables utiles <20> 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<71>tes sont execut<75>es avec succ<63>s, il ne reste plus
qu'a changer les droits d'acc<63>s au r<>pertoire \verb+/sql+ de l'arborescence 
de D'Astre.Net afin d'<27>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, <20> ce stade, D'Astre.Net est pr<70>t <20> <20>tre utilis<69>.

\subsection{En cas de probl<62>mes}

Si jamais il s'est produit une erreur durant de la cr<63>ation 
des tables, vous pouvez <20> tout moment effacer ces derni<6E>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}.