Actions

Difference between revisions of "Documentation en français/Installation de Mahara"

From Mahara Wiki

< Documentation en français
(Created page with "'''<span><font color="rgb(255, 0, 0)">Traduction non complète ... avis aux amateurs !</font></span>''' <span><font size="larger">'''<span style="background-color: rgb(192, 192,…")
 
Line 1: Line 1:
'''<span><font color="rgb(255, 0, 0)">Traduction non complète ... avis aux amateurs !</font></span>'''
+
'''<font color="rgb(255, 0, 0)">Traduction non complète ... avis aux amateurs !</font>'''
  
<span><font size="larger">'''<span style="background-color: rgb(192, 192, 192)">Article proche:</span>'''<span style="background-color: rgb(192, 192, 192)"> [[System Administrator's Guide/Upgrading Mahara|Upgrading Mahara]]</span></font></span>
+
<font size="larger">'''<span style="background-color: rgb(192, 192, 192)">Article proche:</span>'''<span style="background-color: rgb(192, 192, 192)"> [[System Administrator's Guide/Upgrading Mahara|Upgrading Mahara]]</span></font>
  
 
Installer Mahara nécessite quelques connaissances basiques du fonctionnement d'une application web. Ce manuel nécessite donc que vous compreniez les bases de la gestion de serveurs web et de bases de données.
 
Installer Mahara nécessite quelques connaissances basiques du fonctionnement d'une application web. Ce manuel nécessite donc que vous compreniez les bases de la gestion de serveurs web et de bases de données.
Line 11: Line 11:
 
<div id="section_1">
 
<div id="section_1">
  
== 1. Configuration requise ==
+
==1. Configuration requise==
  
 
<div id="section_2">
 
<div id="section_2">
  
=== Environement de travail de base ===
+
===Environement de travail de base===
  
 
* Linux
 
* Linux
Line 26: Line 26:
 
</div><div id="section_3">
 
</div><div id="section_3">
  
=== Les extensions PHP ===
+
===Les extensions PHP===
  
 
* gd
 
* gd
Line 41: Line 41:
 
</div><div id="section_4">
 
</div><div id="section_4">
  
=== Puis-je utiliser un système d'exploitation Windows pour héberger Mahara ? ===
+
===Puis-je utiliser un système d'exploitation Windows pour héberger Mahara ?===
  
 
Les utilisateurs peuvent accéder à Mahara avec un navigateur web standard. Pour l'hébergement, Mahara à été conçu pour Linux, Apache, PHP et les bases de donnée SQL. Très peu d'experimentations ont, à ce jour, été faites dans un environnement Windows. Mahara 1.1 et au delà devraient toutefois pour être installés sous Windows.
 
Les utilisateurs peuvent accéder à Mahara avec un navigateur web standard. Pour l'hébergement, Mahara à été conçu pour Linux, Apache, PHP et les bases de donnée SQL. Très peu d'experimentations ont, à ce jour, été faites dans un environnement Windows. Mahara 1.1 et au delà devraient toutefois pour être installés sous Windows.
Line 49: Line 49:
 
</div><div id="section_5">
 
</div><div id="section_5">
  
=== Windows serat-il supporté dans le futur ? ===
+
===Windows serat-il supporté dans le futur ?===
  
 
Nous avons dès à présent entendu parlé d'installations fonctionnelles sous Windows. Vous devriez donc être à même de faire fonctionner Mahara sous Windows sans trop de diffuculté, mais nous ne prenons pas en charge officiellement le support de Mahara sous Windows et ne seront pas en mesure de vous assister en cas de problème.
 
Nous avons dès à présent entendu parlé d'installations fonctionnelles sous Windows. Vous devriez donc être à même de faire fonctionner Mahara sous Windows sans trop de diffuculté, mais nous ne prenons pas en charge officiellement le support de Mahara sous Windows et ne seront pas en mesure de vous assister en cas de problème.
Line 55: Line 55:
 
</div><div id="section_6">
 
</div><div id="section_6">
  
=== Et sous un environnement Solaris, Mac, BSD ou autre ? ===
+
===Et sous un environnement Solaris, Mac, BSD ou autre ?===
  
 
Les développeurs n'ont pas testé explicitement ces systèmes d'exploitation. Bien que cela puisse fonctionner correctement, vous pourriez rencontrer des problèmes que les développeurs ne pourraient vous aider à résoudre. Si tel est le cas et que vous en identifiez la cause, songez à le publier dans un forum ou ouvrir un rapport d'erreur afin que les autres puissent en profiter !
 
Les développeurs n'ont pas testé explicitement ces systèmes d'exploitation. Bien que cela puisse fonctionner correctement, vous pourriez rencontrer des problèmes que les développeurs ne pourraient vous aider à résoudre. Si tel est le cas et que vous en identifiez la cause, songez à le publier dans un forum ou ouvrir un rapport d'erreur afin que les autres puissent en profiter !
Line 61: Line 61:
 
</div><div id="section_7">
 
</div><div id="section_7">
  
=== Et avec un autre serveur web / une autre base de données / un autre PHP ? ===
+
===Et avec un autre serveur web / une autre base de données / un autre PHP ?===
  
 
Aucun autre serveur web n'a été testé, à vous de voir. Veuillez contacter l'équipe de développement sur #mahara ou sur les forums si vous êtes intéressé pour implémenter le support d'autres bases de données. PHP 5.1+ est requis, toutes les versions postérieures devraient fonctionner.
 
Aucun autre serveur web n'a été testé, à vous de voir. Veuillez contacter l'équipe de développement sur #mahara ou sur les forums si vous êtes intéressé pour implémenter le support d'autres bases de données. PHP 5.1+ est requis, toutes les versions postérieures devraient fonctionner.
Line 67: Line 67:
 
</div><div id="section_8">
 
</div><div id="section_8">
  
=== Puis-je utiliser un hébergement partagé ? ===
+
===Puis-je utiliser un hébergement partagé ?===
  
 
Peut-être. Cela dépend devotre hébergeur, certains désactivent certaines fonctions ou utilisent "safe mode", ce qui peut affecter serieusement le fonctionnement de Mahara. '''Mahara n'est pas spécifiquement conçu pour les hébergement partagés '''- toujours étant, nous gardons cela à l'esprit et acceptons la création de correctifs dans cette intention mais''' l'hébergement partagé, par nature, limite votre champ d'action'''. Il est donc conseillé de travailler sur un Serveur Privé Virtuel (VPS,'' Virtual Private Server'') ou sur un serveur dédié tant que possible.
 
Peut-être. Cela dépend devotre hébergeur, certains désactivent certaines fonctions ou utilisent "safe mode", ce qui peut affecter serieusement le fonctionnement de Mahara. '''Mahara n'est pas spécifiquement conçu pour les hébergement partagés '''- toujours étant, nous gardons cela à l'esprit et acceptons la création de correctifs dans cette intention mais''' l'hébergement partagé, par nature, limite votre champ d'action'''. Il est donc conseillé de travailler sur un Serveur Privé Virtuel (VPS,'' Virtual Private Server'') ou sur un serveur dédié tant que possible.
Line 77: Line 77:
 
</div></div><div id="section_9">
 
</div></div><div id="section_9">
  
== 2. Obtenir Mahara. ==
+
==2. Obtenir Mahara.==
  
 
Vous pouvez [[Download Mahara|télécharger une distribution standard de Mahara]], ou obtenir le projet depuis un depot GIT si vous savez comment fonctionne ce dernier :
 
Vous pouvez [[Download Mahara|télécharger une distribution standard de Mahara]], ou obtenir le projet depuis un depot GIT si vous savez comment fonctionne ce dernier :
Line 92: Line 92:
 
</div><div id="section_10">
 
</div><div id="section_10">
  
== 3. Créer la base de données ==
+
==3. Créer la base de données==
  
 
Vous devez créer une base de données pour Mahara et vous assurer que le serveur web est en mesure de s'y connecter. Les instruction pour la création de cette derniere suivent, si vous avez acces à CPanel ou à un logiciel similaire, vous avez la possibilité de créer la base par l'intermédiaire de celui-ci.
 
Vous devez créer une base de données pour Mahara et vous assurer que le serveur web est en mesure de s'y connecter. Les instruction pour la création de cette derniere suivent, si vous avez acces à CPanel ou à un logiciel similaire, vous avez la possibilité de créer la base par l'intermédiaire de celui-ci.
Line 115: Line 115:
 
<div id="section_11">
 
<div id="section_11">
  
=== Quel type de base de données dois-je choisir en priorité ? ===
+
===Quel type de base de données dois-je choisir en priorité ?===
  
 
Les développeurs recommandent PostgreSQL pour une stabilité maximum et le respet de l'intégrité des données. Convenablement configuré, PostgreSQL fournira de meilleures performances que MySQL.
 
Les développeurs recommandent PostgreSQL pour une stabilité maximum et le respet de l'intégrité des données. Convenablement configuré, PostgreSQL fournira de meilleures performances que MySQL.
  
<span><font color="rgb(51, 51, 153)">''<span class="Apple-style-span" style="line-height: normal">'''<font size="19px"><font face="Tahoma"><span class="Apple-style-span" style="font-weight: normal; line-height: 21px"><font size="14px"><font face="Verdana"><span class="Apple-style-span">''<nowiki>=== Partie non traduite ===</nowiki>''</span></font></font></span></font></font>'''</span>''</font></span>
+
<font color="rgb(51, 51, 153)">''<span class="Apple-style-span" style="line-height: normal">'''<font size="19px"><font face="Tahoma"><span class="Apple-style-span" style="font-weight: normal; line-height: 21px"><font size="14px"><font face="Verdana"><span class="Apple-style-span">''<nowiki>=== Partie non traduite ===</nowiki>''</span></font></font></span></font></font>'''</span>''</font>
  
<div><span><font color="rgb(51, 51, 153)">''Furthermore, PostgreSQL can do DDL in transactions - that is to say <code>BEGIN; CREATE TABLE foo(bar int); ROLLBACK;</code> actually works how you would expect. This makes the upgrade process a lot safer, if the upgrade fails you know you won't have left your database schema in a mess that can't be automatically upgraded once the original problem is fixed.''</font></span></div>
+
<div><font color="rgb(51, 51, 153)">''Furthermore, PostgreSQL can do DDL in transactions - that is to say <code>BEGIN; CREATE TABLE foo(bar int); ROLLBACK;</code> actually works how you would expect. This makes the upgrade process a lot safer, if the upgrade fails you know you won't have left your database schema in a mess that can't be automatically upgraded once the original problem is fixed.''</font></div>
  
<span><font color="rgb(51, 51, 153)">''We cannot say this enough - even if you have never used PostgreSQL before, if you have the option to use it, then use it. You will save yourself a lot of hassle when your site needs upgrading, and the system will be more stable. Everyone who has used MySQL seriously is aware that sometimes MySQL corrupts tables, and performs badly under high load. PostgreSQL has none of these problems.''</font></span>
+
<font color="rgb(51, 51, 153)">''We cannot say this enough - even if you have never used PostgreSQL before, if you have the option to use it, then use it. You will save yourself a lot of hassle when your site needs upgrading, and the system will be more stable. Everyone who has used MySQL seriously is aware that sometimes MySQL corrupts tables, and performs badly under high load. PostgreSQL has none of these problems.''</font>
  
<span><font color="rgb(51, 51, 153)">''Here is a ''</font></span><span><font color="rgb(51, 51, 153)">[http://mahara.org/interaction/forum/topic.php?id=302 ''forum thread with a detailed explanation of this recommendation'']</font></span><span><font color="rgb(51, 51, 153)">'', and examples of where using Postgres is advantageous for Mahara.''</font></span>
+
<font color="rgb(51, 51, 153)">''Here is a ''</font><font color="rgb(51, 51, 153)">[http://mahara.org/interaction/forum/topic.php?id=302 ''forum thread with a detailed explanation of this recommendation'']</font><font color="rgb(51, 51, 153)">'', and examples of where using Postgres is advantageous for Mahara.''</font>
  
 
''<span class="Apple-style-span" style="line-height: normal"> </span>''
 
''<span class="Apple-style-span" style="line-height: normal"> </span>''
  
<span><font color="rgb(51, 51, 153)"><span class="Apple-style-span" style="line-height: normal">'''<font size="19px"><font face="Tahoma"><span class="Apple-style-span" style="font-weight: normal; line-height: 21px"><font size="14px"><font face="Verdana"><span class="Apple-style-span">''<nowiki>=== Partie non traduite ===</nowiki>''</span></font></font></span></font></font>'''</span></font></span>
+
<font color="rgb(51, 51, 153)"><span class="Apple-style-span" style="line-height: normal">'''<font size="19px"><font face="Tahoma"><span class="Apple-style-span" style="font-weight: normal; line-height: 21px"><font size="14px"><font face="Verdana"><span class="Apple-style-span">''<nowiki>=== Partie non traduite ===</nowiki>''</span></font></font></span></font></font>'''</span></font>
  
 
<span class="Apple-style-span" style="line-height: normal">
 
<span class="Apple-style-span" style="line-height: normal">
Line 137: Line 137:
 
</span></div></div><div id="section_12">
 
</span></div></div><div id="section_12">
  
== 4. Installation et configuration du programme. ==
+
==4. Installation et configuration du programme.==
  
 
<div id="section_13">
 
<div id="section_13">
  
=== Configuration PHP ===
+
===Configuration PHP===
  
 
Vous devez vous assurer que <code>magic_quotes_gpc</code> et <code>register_globals</code> sont à '''off'''. Mahara vous avertira de toute autre configuration représentant un risque quel qu'il soit lors de son fonctionnement.
 
Vous devez vous assurer que <code>magic_quotes_gpc</code> et <code>register_globals</code> sont à '''off'''. Mahara vous avertira de toute autre configuration représentant un risque quel qu'il soit lors de son fonctionnement.
Line 149: Line 149:
 
</div><div id="section_14">
 
</div><div id="section_14">
  
=== Installation des fichiers Mahara ===
+
===Installation des fichiers Mahara===
  
 
Copier le contenu du dossier <code>htdocs/</code> sur votre serveur web :
 
Copier le contenu du dossier <code>htdocs/</code> sur votre serveur web :
  
* Copier le répertoire en entier et le renommer dans quelque chose du genre 'mahara' - votre site apparaitra alors comme cela : <code>exemple.org/mahara/</code><nowiki>; ou</nowiki>
+
* Copier le répertoire en entier et le renommer dans quelque chose du genre 'mahara' - votre site apparaitra alors comme cela : <code>exemple.org/mahara/</code>; ou
 
* Copier le contenu du repertoire <code>htdocs/</code> au niveau superieur du répertoire public (souvent appelé <code>htdocs</code> ou <code>public_html</code>) de votre serveur web, votre site apparaitra alors comme cela : <code>example.org</code>
 
* Copier le contenu du repertoire <code>htdocs/</code> au niveau superieur du répertoire public (souvent appelé <code>htdocs</code> ou <code>public_html</code>) de votre serveur web, votre site apparaitra alors comme cela : <code>example.org</code>
  
 
</div><div id="section_15">
 
</div><div id="section_15">
  
=== Configuration de Apache ===
+
===Configuration de Apache===
  
<span><font color="rgb(51, 51, 153)">''<span class="Apple-style-span">''<nowiki>=== Partie non traduite ===</nowiki>''</span>''</font></span>
+
<font color="rgb(51, 51, 153)">''<span class="Apple-style-span">''<nowiki>=== Partie non traduite ===</nowiki>''</span>''</font>
  
<span><font color="rgb(51, 51, 153)">''If you're on shared hosting, you probably are not able to change this, so you can ignore this section.''</font></span>
+
<font color="rgb(51, 51, 153)">''If you're on shared hosting, you probably are not able to change this, so you can ignore this section.''</font>
  
<span><font color="rgb(51, 51, 153)">''For others, the simplest of Apache VirtualHost configurations will be sufficient:''</font></span>
+
<font color="rgb(51, 51, 153)">''For others, the simplest of Apache VirtualHost configurations will be sufficient:''</font>
  
  <span><font color="rgb(51, 51, 153)">''        ServerName example.org        DocumentRoot /path/to/mahara/htdocs          ErrorLog /var/log/apache2/mahara-1-1-stable.error.log        CustomLog /var/log/apache2/mahara-1-1-stable.access.log combined ''</font></span>
+
  <font color="rgb(51, 51, 153)">''        ServerName example.org        DocumentRoot /path/to/mahara/htdocs          ErrorLog /var/log/apache2/mahara-1-1-stable.error.log        CustomLog /var/log/apache2/mahara-1-1-stable.access.log combined ''</font>
  
<span><font color="rgb(51, 51, 153)">''Please note that your apache configuration should contain '''no ServerAliases'''. Mahara expects to be accessed through ONE URL. This gives certainty that cookies are set for the right domain, and also means that SSL certificates for the networking functionality can be generated for this one URL. If you use a server alias, you should expect to see problems like having to log in twice, and potentially SSO between your site and others breaking.''</font></span>
+
<font color="rgb(51, 51, 153)">''Please note that your apache configuration should contain '''no ServerAliases'''. Mahara expects to be accessed through ONE URL. This gives certainty that cookies are set for the right domain, and also means that SSL certificates for the networking functionality can be generated for this one URL. If you use a server alias, you should expect to see problems like having to log in twice, and potentially SSO between your site and others breaking.''</font>
  
<span><font color="rgb(51, 51, 153)">''However, you can still make both example.org and www.example.org work for your site, if you use another VirtualHost directive:''</font></span>
+
<font color="rgb(51, 51, 153)">''However, you can still make both example.org and www.example.org work for your site, if you use another VirtualHost directive:''</font>
  
  <span><font color="rgb(51, 51, 153)">''    ServerName www.example.org    # You can add ServerAliases here if you want more than one URL to redirect to your main site    # ServerAlias foo.example.org      Redirect Permanent / http://example.org/ ''</font></span>
+
  <font color="rgb(51, 51, 153)">''    ServerName www.example.org    # You can add ServerAliases here if you want more than one URL to redirect to your main site    # ServerAlias foo.example.org      Redirect Permanent / http://example.org/ ''</font>
  
 
</div><div id="section_16">
 
</div><div id="section_16">
  
=== <span><font color="rgb(51, 51, 153)">''<font class="Apple-style-span" size="4" face="Verdana"><span class="Apple-style-span" style="font-weight: normal; line-height: 21px"><font size="14px"><br /></font></span></font>Mahara Configuration''</font></span> ===
+
===<font color="rgb(51, 51, 153)">''<font class="Apple-style-span" size="4" face="Verdana"><span class="Apple-style-span" style="font-weight: normal; line-height: 21px"><font size="14px"><br /></font></span></font>Mahara Configuration''</font>===
  
<span><font color="rgb(51, 51, 153)">''You need to make a directory (outside the document root) and ensure the web server user has write access to it. This is where Mahara will store data like uploaded files, and is referred to as '''dataroot''' by Mahara. You also need to make sure that you can somehow write to this directory also - whether by having root access or otherwise.''</font></span>
+
<font color="rgb(51, 51, 153)">''You need to make a directory (outside the document root) and ensure the web server user has write access to it. This is where Mahara will store data like uploaded files, and is referred to as '''dataroot''' by Mahara. You also need to make sure that you can somehow write to this directory also - whether by having root access or otherwise.''</font>
  
<span><font color="rgb(51, 51, 153)">''In <code>htdocs/</code> is <code>config-dist.php</code>. You need to make a copy of this called <code>config.php</code>. You then need to go through the file and make changes where appropriate. The file is commented, and there are not many settings to change. However, take special note of the following settings:''</font></span>
+
<font color="rgb(51, 51, 153)">''In <code>htdocs/</code> is <code>config-dist.php</code>. You need to make a copy of this called <code>config.php</code>. You then need to go through the file and make changes where appropriate. The file is commented, and there are not many settings to change. However, take special note of the following settings:''</font>
  
* <span><font color="rgb(51, 51, 153)">'''''database connection details''' — ensure you include the database connection details by inserting the proper values for $cfg-&gt;dbname, $cfg-&gt;dbuser, $cfg-&gt;dbpass, $cfg-&gt;dbprefix. ''</font></span>
+
* <font color="rgb(51, 51, 153)">'''''database connection details''' — ensure you include the database connection details by inserting the proper values for $cfg-&gt;dbname, $cfg-&gt;dbuser, $cfg-&gt;dbpass, $cfg-&gt;dbprefix. ''</font>
** <span><font color="rgb(51, 51, 153)">'''''Note'''<nowiki>: You do not need to set dbprefix, unlike Moodle. Try not using it first, and see if it works. If you find you do need it, you may find it best to leave dbprefix empty and add the prefix directly to $cfg-&gt;dbname, $cfg-&gt;dbuser values.</nowiki>''</font></span>
+
** <font color="rgb(51, 51, 153)">'''''Note''': You do not need to set dbprefix, unlike Moodle. Try not using it first, and see if it works. If you find you do need it, you may find it best to leave dbprefix empty and add the prefix directly to $cfg-&gt;dbname, $cfg-&gt;dbuser values.''</font>
* <span><font color="rgb(51, 51, 153)">'''''dataroot''' - set this to the filesystem path to the directory you made that the web server user can write to. Please note this is a filesystem path, which on linux will look like <code>/path/to/your/directory</code> and on windows will look like <code>C:\path\to\your\directory</code>. This is NOT a web address such as http://example.org/maharadata<nowiki>!</nowiki>''</font></span>
+
* <font color="rgb(51, 51, 153)">'''''dataroot''' - set this to the filesystem path to the directory you made that the web server user can write to. Please note this is a filesystem path, which on linux will look like <code>/path/to/your/directory</code> and on windows will look like <code>C:\path\to\your\directory</code>. This is NOT a web address such as http://example.org/maharadata!''</font>
* <span><font color="rgb(51, 51, 153)">'''''directorypermissions''' - if you're on a server where you do not have root access, you should change this from 0700 to 0777 or similar, so that you can download your dataroot later for backup purposes, and install language packs.''</font></span>
+
* <font color="rgb(51, 51, 153)">'''''directorypermissions''' - if you're on a server where you do not have root access, you should change this from 0700 to 0777 or similar, so that you can download your dataroot later for backup purposes, and install language packs.''</font>
  
 
</div><div id="section_17">
 
</div><div id="section_17">
  
=== <span><font color="rgb(51, 51, 153)">''Cron Job''</font></span> ===
+
===<font color="rgb(51, 51, 153)">''Cron Job''</font>===
  
<span><font color="rgb(51, 51, 153)">''You will need to set up a cron job to hit <span><font face="&#39;Courier New&#39;">htdocs/lib/cron.php</font></span> every minute. Mahara implements its own cron internally, so hitting cron every minute is sufficient to make everything work.''</font></span>
+
<font color="rgb(51, 51, 153)">''You will need to set up a cron job to hit <font face="&#39;Courier New&#39;">htdocs/lib/cron.php</font> every minute. Mahara implements its own cron internally, so hitting cron every minute is sufficient to make everything work.''</font>
  
<span><font color="rgb(51, 51, 153)">''If you don't set up the cron job, you will find that RSS feeds will not update, and some email notifications won't be sent out, such as forum post notifications.''</font></span>
+
<font color="rgb(51, 51, 153)">''If you don't set up the cron job, you will find that RSS feeds will not update, and some email notifications won't be sent out, such as forum post notifications.''</font>
  
<span><font color="rgb(51, 51, 153)">''You can set it up using the command line 'php' command to run the cron script, or by using a command line web browser such as lynx or w3m.''</font></span>
+
<font color="rgb(51, 51, 153)">''You can set it up using the command line 'php' command to run the cron script, or by using a command line web browser such as lynx or w3m.''</font>
  
<span><font color="rgb(51, 51, 153)">''Something like the following in a crontab file will be sufficient:''</font></span>
+
<font color="rgb(51, 51, 153)">''Something like the following in a crontab file will be sufficient:''</font>
  
  <span><font color="rgb(51, 51, 153)">''<nowiki>* * * * * www-data php /path/to/mahara/htdocs/lib/cron.php</nowiki>''</font></span>
+
  <font color="rgb(51, 51, 153)">''<nowiki>* * * * * www-data php /path/to/mahara/htdocs/lib/cron.php</nowiki>''</font>
  
 
</div></div><div id="section_18">
 
</div></div><div id="section_18">
  
== <span><font color="rgb(51, 51, 153)">''5. Run the Web Based Installer''</font></span> ==
+
==<font color="rgb(51, 51, 153)">''5. Run the Web Based Installer''</font>==
  
<span><font color="rgb(51, 51, 153)">''Once you have set up your config.php, you should now be able to navigate to the Mahara installation using your web browser. This will pop up a page stating the conditions of using Mahara, and will ask for agreement. If you agree with the conditions, click "agree" and Mahara will install itself into your database. Click continue, and you should now be at a login screen.''</font></span>
+
<font color="rgb(51, 51, 153)">''Once you have set up your config.php, you should now be able to navigate to the Mahara installation using your web browser. This will pop up a page stating the conditions of using Mahara, and will ask for agreement. If you agree with the conditions, click "agree" and Mahara will install itself into your database. Click continue, and you should now be at a login screen.''</font>
  
<span><font color="rgb(51, 51, 153)">''Log into the system with user "'''admin'''", password "'''mahara'''". Congratulations!''</font></span>
+
<font color="rgb(51, 51, 153)">''Log into the system with user "'''admin'''", password "'''mahara'''". Congratulations!''</font>
  
 
<div id="section_19">
 
<div id="section_19">
  
=== <span><font color="rgb(51, 51, 153)">''What if the installation process breaks with an error?''</font></span> ===
+
===<font color="rgb(51, 51, 153)">''What if the installation process breaks with an error?''</font>===
  
<span><font color="rgb(51, 51, 153)">''Sometimes this can happen. Normally this is because of some misconfiguration in your system - for example, you haven't granted your database user permission to create tables, or you aren't using a high enough version of your database (see the ''</font></span>[[System Administrator's Guide/Installing Mahara#1. Dependencies|<span><font color="rgb(51, 51, 153)">''dependencies''</font></span>]]<span><font color="rgb(51, 51, 153)">''). Sometimes, it's because of a bug in the Mahara installer. In order to find out, you will need to check the error log for your webserver. Mahara dumps detailed information in there where a bug occurs.''</font></span>
+
<font color="rgb(51, 51, 153)">''Sometimes this can happen. Normally this is because of some misconfiguration in your system - for example, you haven't granted your database user permission to create tables, or you aren't using a high enough version of your database (see the ''</font>[[System Administrator's Guide/Installing Mahara#1. Dependencies|<font color="rgb(51, 51, 153)">''dependencies''</font>]]<font color="rgb(51, 51, 153)">''). Sometimes, it's because of a bug in the Mahara installer. In order to find out, you will need to check the error log for your webserver. Mahara dumps detailed information in there where a bug occurs.''</font>
  
<span><font color="rgb(51, 51, 153)">''The message might show you that the problem is with your configuration, but if it looks like a problem with Mahara, you should make a ''</font></span>[http://mahara.org/tracker <span><font color="rgb(51, 51, 153)">''bug report''</font></span>]<span><font color="rgb(51, 51, 153)">'' with the information from your logs, so we can fix it.''</font></span>
+
<font color="rgb(51, 51, 153)">''The message might show you that the problem is with your configuration, but if it looks like a problem with Mahara, you should make a ''</font>[http://mahara.org/tracker <font color="rgb(51, 51, 153)">''bug report''</font>]<font color="rgb(51, 51, 153)">'' with the information from your logs, so we can fix it.''</font>
  
<span><font color="rgb(51, 51, 153)">''If you were able to fix the problem, you might need to drop and re-create your database again, so you're starting the installation again without any of the previously installed tables in the way.''</font></span>
+
<font color="rgb(51, 51, 153)">''If you were able to fix the problem, you might need to drop and re-create your database again, so you're starting the installation again without any of the previously installed tables in the way.''</font>
  
 
</div></div><div id="section_20">
 
</div></div><div id="section_20">
  
== 6. Optionnel : installation d'autres langues ==
+
==6. Optionnel : installation d'autres langues==
  
 
Mahara est installé par défaut uniquement en anglais, mais vous pouvez ajouter le support d'autres langues. Les fichiers contenant les traductions sont à installer dans le répertoire des données, dans un dossier dénommé « langpacks ».
 
Mahara est installé par défaut uniquement en anglais, mais vous pouvez ajouter le support d'autres langues. Les fichiers contenant les traductions sont à installer dans le répertoire des données, dans un dossier dénommé « langpacks ».
Line 236: Line 236:
 
</div><div id="section_21">
 
</div><div id="section_21">
  
== <span><font color="rgb(51, 51, 153)">''Troubleshooting''</font></span> ==
+
==<font color="rgb(51, 51, 153)">''Troubleshooting''</font>==
  
<span><font color="rgb(51, 51, 153)">'' If you are having problems installing Mahara, please check out the ''</font></span>[[System Administrator's Guide/Installing Mahara/Troubleshooting|<span><font color="rgb(51, 51, 153)">''Installation Instructions Troubleshooting Page''</font></span>]]<span><font color="rgb(51, 51, 153)">'' for answers to some common problems.''</font></span>
+
<font color="rgb(51, 51, 153)">'' If you are having problems installing Mahara, please check out the ''</font>[[System Administrator's Guide/Installing Mahara/Troubleshooting|<font color="rgb(51, 51, 153)">''Installation Instructions Troubleshooting Page''</font>]]<font color="rgb(51, 51, 153)">'' for answers to some common problems.''</font>
  
 
''<span class="Apple-style-span" style="line-height: normal"> </span>''
 
''<span class="Apple-style-span" style="line-height: normal"> </span>''
Line 244: Line 244:
 
<div id="section_22">
 
<div id="section_22">
  
=== <span><font color="rgb(51, 51, 153)"><span class="Apple-style-span" style="font-weight: normal; line-height: 21px">''<font size="14px"><font face="Verdana"><nowiki>=== Partie non traduite ===</nowiki></font></font>''</span></font></span> ===
+
===<font color="rgb(51, 51, 153)"><span class="Apple-style-span" style="font-weight: normal; line-height: 21px">''<font size="14px"><font face="Verdana"><nowiki>=== Partie non traduite ===</nowiki></font></font>''</span></font>===
  
 
</div><span class="Apple-style-span" style="line-height: normal"><div id="section_23">
 
</div><span class="Apple-style-span" style="line-height: normal"><div id="section_23">
  
=== ===
+
======
  
 
</div></span></div>
 
</div></span></div>

Revision as of 16:22, 11 May 2011

Traduction non complète ... avis aux amateurs !

Article proche: Upgrading Mahara

Installer Mahara nécessite quelques connaissances basiques du fonctionnement d'une application web. Ce manuel nécessite donc que vous compreniez les bases de la gestion de serveurs web et de bases de données.

Si vous fonctionnez sous Debian/Ubuntu, sachez que bon nombre des logiciels requis peuvent être installé grâce à la commande apt-get. Si vous utilisez une distriution différente de Linux, vous devez être en mesure d'utiliser les outils d'installation spécifiques à cette dernière.

Si vous souhaitez installer Mahara dans une langue autre que l'anglais, vous pouvez installer les differents packs de langues une fois Mahara installé, les instructions relative à l'installation d'une nouvelle langue sont disponibles ci-dessous.

1. Configuration requise

Environement de travail de base

  • Linux
  • PHP 5.1.3+
  • Postgres 8.1+ (recommandé), ou MySQL 5.0.25+. Avec MySQL, les tables InnoDB seront requises ainsi qu'un système d'interclassement en UTF8.
  • Apache 2 (Apache 1 fonctionnera également si nécessaire).

Note : Votre version de MySQL doit etre au minimum la 5.0.25 - Voir http://bugs.mysql.com/bug.php?id=20519 pour un bug avec les version précedentes affectant le bon fonctionnement de Mahara.

Les extensions PHP

  • gd
  • json
  • curl (requis depuis Mahara 1.1. Auparavant nécessaire uniquement pour le support réseau)
  • libxml
  • SimpleXML
  • session
  • pgsql OU mysqli
  • Pour le support réseau : openssl et xmlrpc
  • Optionellement : imagick
  • exim, qui etait necessaire pour Mahara 1.1.0 à 1.1.4, est dorénavant optionel.

Puis-je utiliser un système d'exploitation Windows pour héberger Mahara ?

Les utilisateurs peuvent accéder à Mahara avec un navigateur web standard. Pour l'hébergement, Mahara à été conçu pour Linux, Apache, PHP et les bases de donnée SQL. Très peu d'experimentations ont, à ce jour, été faites dans un environnement Windows. Mahara 1.1 et au delà devraient toutefois pour être installés sous Windows.

Des instructions pour l'installation de Mahara avec Wampserver sont disponibles et devraient vous aider à realiser cette opération.

Windows serat-il supporté dans le futur ?

Nous avons dès à présent entendu parlé d'installations fonctionnelles sous Windows. Vous devriez donc être à même de faire fonctionner Mahara sous Windows sans trop de diffuculté, mais nous ne prenons pas en charge officiellement le support de Mahara sous Windows et ne seront pas en mesure de vous assister en cas de problème.

Et sous un environnement Solaris, Mac, BSD ou autre ?

Les développeurs n'ont pas testé explicitement ces systèmes d'exploitation. Bien que cela puisse fonctionner correctement, vous pourriez rencontrer des problèmes que les développeurs ne pourraient vous aider à résoudre. Si tel est le cas et que vous en identifiez la cause, songez à le publier dans un forum ou ouvrir un rapport d'erreur afin que les autres puissent en profiter !

Et avec un autre serveur web / une autre base de données / un autre PHP ?

Aucun autre serveur web n'a été testé, à vous de voir. Veuillez contacter l'équipe de développement sur #mahara ou sur les forums si vous êtes intéressé pour implémenter le support d'autres bases de données. PHP 5.1+ est requis, toutes les versions postérieures devraient fonctionner.

Puis-je utiliser un hébergement partagé ?

Peut-être. Cela dépend devotre hébergeur, certains désactivent certaines fonctions ou utilisent "safe mode", ce qui peut affecter serieusement le fonctionnement de Mahara. Mahara n'est pas spécifiquement conçu pour les hébergement partagés - toujours étant, nous gardons cela à l'esprit et acceptons la création de correctifs dans cette intention mais l'hébergement partagé, par nature, limite votre champ d'action. Il est donc conseillé de travailler sur un Serveur Privé Virtuel (VPS, Virtual Private Server) ou sur un serveur dédié tant que possible.

Si votre hébergeur a désactivé exec, Mahara 1.0 ne sera pas en mesure de détecter correctement les fichiers images, la génération de miniatures en sera donc affectée. Voyez ce rapport d'erreur pour de plus amples informations. Depuis Mahara 1.1, cela n'est plus un problème mais exec sera sans doute utilisé dans le futur pour d'autres fonctionnalités.

Les hébergeurs paramètrent souvent (bêtement) AllowOverride à None, ce qui a pour effet de désactiver les fichiers .htaccess. Si vous obtenez des erreurs 500 lors de l'installation de votre site, il peut s'avérer nécessaire de commenter les lignes php_flag à l'intérieur de ces fichiers, voire de retirer complètement les fichiers .htaccess en question. Ceci ne réduira pas de façon critique les fonctionnalités, mais si vous êtes forcé de retirer ces fichiers, cela rendra votre site moins performant qu'il n'aurait dû l'être. [ Note : les fichiers .htaccess peuvent être invisibles sous Mac OS X et votre serveur, la meilleure chose à faire (!) est de modifier ces fichiers depuis une machine Windows avant de les envoyer directement sur le serveur. ]

2. Obtenir Mahara.

Vous pouvez télécharger une distribution standard de Mahara, ou obtenir le projet depuis un depot GIT si vous savez comment fonctionne ce dernier :

git clone git://git.mahara.org/git/mahara.git

Si vous passez par GIT, vous pouvez obtenir la version specifique de Mahara qui vous interesse : voyez git.mahara.org pour une liste des version dans notre depot GIT. Par exemple :

git clone git://git.mahara.org/git/mahara.git
 git checkout -b 1.1_STABLE origin/1.1_STABLE

3. Créer la base de données

Vous devez créer une base de données pour Mahara et vous assurer que le serveur web est en mesure de s'y connecter. Les instruction pour la création de cette derniere suivent, si vous avez acces à CPanel ou à un logiciel similaire, vous avez la possibilité de créer la base par l'intermédiaire de celui-ci.

Votre base de données doit etre encodée en UTF8. Les commandes suivantes créent une base UTF8, si vous utilisez CPanel, vous devez vous assurer que la base de données crée est bien en UTF8.

Lignes de commandes pour Postgres:

# Si vous avez à créer un utilisateur de base de données :
  createuser -SRDP (nom d'utilisateur)
  # création de la base :
  createdb -U (nom de l'utilisateur de connection) -EUTF8 (nom de base de données)

Lignes de commandes pour MySQL:

mysql -Uroot
 [entrer un mot de passe]
 create database (nom de base de données) character set UTF8;
 grant all on (nom de base de données).* to 'nom'@'localhost' identified by 'password';

Quel type de base de données dois-je choisir en priorité ?

Les développeurs recommandent PostgreSQL pour une stabilité maximum et le respet de l'intégrité des données. Convenablement configuré, PostgreSQL fournira de meilleures performances que MySQL.

=== Partie non traduite ===

Furthermore, PostgreSQL can do DDL in transactions - that is to say BEGIN; CREATE TABLE foo(bar int); ROLLBACK; actually works how you would expect. This makes the upgrade process a lot safer, if the upgrade fails you know you won't have left your database schema in a mess that can't be automatically upgraded once the original problem is fixed.

We cannot say this enough - even if you have never used PostgreSQL before, if you have the option to use it, then use it. You will save yourself a lot of hassle when your site needs upgrading, and the system will be more stable. Everyone who has used MySQL seriously is aware that sometimes MySQL corrupts tables, and performs badly under high load. PostgreSQL has none of these problems.

Here is a forum thread with a detailed explanation of this recommendation, and examples of where using Postgres is advantageous for Mahara.

=== Partie non traduite ===


4. Installation et configuration du programme.

Configuration PHP

Vous devez vous assurer que magic_quotes_gpc et register_globals sont à off. Mahara vous avertira de toute autre configuration représentant un risque quel qu'il soit lors de son fonctionnement.

Mahara est également livré par défaut avec un fichier .htaccess qui s'assure que les mauvais paramètres soient bien désactivés.

Installation des fichiers Mahara

Copier le contenu du dossier htdocs/ sur votre serveur web :

  • Copier le répertoire en entier et le renommer dans quelque chose du genre 'mahara' - votre site apparaitra alors comme cela : exemple.org/mahara/; ou
  • Copier le contenu du repertoire htdocs/ au niveau superieur du répertoire public (souvent appelé htdocs ou public_html) de votre serveur web, votre site apparaitra alors comme cela : example.org

Configuration de Apache

=== Partie non traduite ===

If you're on shared hosting, you probably are not able to change this, so you can ignore this section.

For others, the simplest of Apache VirtualHost configurations will be sufficient:

         ServerName example.org         DocumentRoot /path/to/mahara/htdocs          ErrorLog /var/log/apache2/mahara-1-1-stable.error.log         CustomLog /var/log/apache2/mahara-1-1-stable.access.log combined 

Please note that your apache configuration should contain no ServerAliases. Mahara expects to be accessed through ONE URL. This gives certainty that cookies are set for the right domain, and also means that SSL certificates for the networking functionality can be generated for this one URL. If you use a server alias, you should expect to see problems like having to log in twice, and potentially SSO between your site and others breaking.

However, you can still make both example.org and www.example.org work for your site, if you use another VirtualHost directive:

     ServerName www.example.org     # You can add ServerAliases here if you want more than one URL to redirect to your main site     # ServerAlias foo.example.org      Redirect Permanent / http://example.org/ 


Mahara Configuration

You need to make a directory (outside the document root) and ensure the web server user has write access to it. This is where Mahara will store data like uploaded files, and is referred to as dataroot by Mahara. You also need to make sure that you can somehow write to this directory also - whether by having root access or otherwise.

In htdocs/ is config-dist.php. You need to make a copy of this called config.php. You then need to go through the file and make changes where appropriate. The file is commented, and there are not many settings to change. However, take special note of the following settings:

  • database connection details — ensure you include the database connection details by inserting the proper values for $cfg->dbname, $cfg->dbuser, $cfg->dbpass, $cfg->dbprefix.
    • Note: You do not need to set dbprefix, unlike Moodle. Try not using it first, and see if it works. If you find you do need it, you may find it best to leave dbprefix empty and add the prefix directly to $cfg->dbname, $cfg->dbuser values.
  • dataroot - set this to the filesystem path to the directory you made that the web server user can write to. Please note this is a filesystem path, which on linux will look like /path/to/your/directory and on windows will look like C:\path\to\your\directory. This is NOT a web address such as http://example.org/maharadata!
  • directorypermissions - if you're on a server where you do not have root access, you should change this from 0700 to 0777 or similar, so that you can download your dataroot later for backup purposes, and install language packs.

Cron Job

You will need to set up a cron job to hit htdocs/lib/cron.php every minute. Mahara implements its own cron internally, so hitting cron every minute is sufficient to make everything work.

If you don't set up the cron job, you will find that RSS feeds will not update, and some email notifications won't be sent out, such as forum post notifications.

You can set it up using the command line 'php' command to run the cron script, or by using a command line web browser such as lynx or w3m.

Something like the following in a crontab file will be sufficient:

* * * * * www-data php /path/to/mahara/htdocs/lib/cron.php

5. Run the Web Based Installer

Once you have set up your config.php, you should now be able to navigate to the Mahara installation using your web browser. This will pop up a page stating the conditions of using Mahara, and will ask for agreement. If you agree with the conditions, click "agree" and Mahara will install itself into your database. Click continue, and you should now be at a login screen.

Log into the system with user "admin", password "mahara". Congratulations!

What if the installation process breaks with an error?

Sometimes this can happen. Normally this is because of some misconfiguration in your system - for example, you haven't granted your database user permission to create tables, or you aren't using a high enough version of your database (see the dependencies). Sometimes, it's because of a bug in the Mahara installer. In order to find out, you will need to check the error log for your webserver. Mahara dumps detailed information in there where a bug occurs.

The message might show you that the problem is with your configuration, but if it looks like a problem with Mahara, you should make a bug report with the information from your logs, so we can fix it.

If you were able to fix the problem, you might need to drop and re-create your database again, so you're starting the installation again without any of the previously installed tables in the way.

6. Optionnel : installation d'autres langues

Mahara est installé par défaut uniquement en anglais, mais vous pouvez ajouter le support d'autres langues. Les fichiers contenant les traductions sont à installer dans le répertoire des données, dans un dossier dénommé « langpacks ».

Pour ajouter une nouvelle langue à l'interface :

  1. Vérifiez que vous ayez bien un dossier langpacks à l'intérieur de votre répertoire de données (le « dataroot »). Il a du être créé automatiquement pour vous.
  2. Téléchargez l'archive correspondant à langue que vous souhaitez installer depuis la page des packs de langue.
  3. Décompressez l'archive TGZ. Si le dossier obtenu porte un nom du type mahara-lang-xx renommez-le en xx.utf8.
  4. Déplacez le dossier ainsi obtenu dans le dossier langpacks à l'intérieur de votre répertoire de données.

Maintenant vous pouvez vous rendre sur la page d'administration de votre site Mahara pour choisir la langue à utiliser par défaut. Les utilisateurs pourront également choisir la langue de leur interface.

Troubleshooting

 If you are having problems installing Mahara, please check out the Installation Instructions Troubleshooting Page for answers to some common problems.

=== Partie non traduite ===

==