<page xmlns="http://projectmallard.org/1.0/"
      type="topic" style="task"
      id="install-prof" xml:lang="fr">

<info>
  <desc>Mise en production.</desc>
  <link type="guide" xref="install"/>
  <title type="sort">3 - prod</title>
</info>

<title>Passage en production</title>

<links type="section" />

<section id="config">
<title>Configuration de l'application</title>
<p>La configuration de l'application se fait dans <code>/etc/polynum/local_settings.py</code></p>

<p>Un fichier d'exemple <code>local_settings.py.example</code> est fourni avec
Polynum, c'est un modèle pour la création de
<code>/etc/polynum/local_settings.py</code> : il contient la liste des
paramétrages possibles avec explications et exemples.</p>

<p>Si vous avez installé Polynum à partir du paquet, le modèle est placé
dans <code>/usr/share/doc/polynum/</code>, il vous suffit donc de faire :</p>

<screen>
<output style="prompt"># </output><input>cd /etc/polynum</input>
<output style="prompt"># </output><input>cp /usr/share/doc/polynum/local_settings.py.example local_settings.py</input>
<output style="prompt"># </output><input>vi local_settings.py</input>
</screen>

</section>

<section id="installation-sql">
<title>Installation de la base de données</title>
<p>TODO : config + syncdb + migrate</p>
<p>TODO : ne pas oublier les index</p>
</section>

<section id="installation-init">
<title>Mise en place des données initiales</title>
<p>TODO : loaddata + loadentities</p>
</section>

<section id="installation-auth">
<title>Configuration de l'authentification</title>
<p>Polynum peut authentifier les utilisateurs via CAS et LDAP. Dans
<code>/etc/polynum/local_settings.py</code> adapter les paramètres suivants
:</p>

<code>

(... extrait de /etc/polynum/local_settings.py ...)

CAS_SERVER_URL = "https://cas.univ.fr/" # CAS server URL
LDAP_URL = "ldaps://ldap.univ.fr"       # LDAP server URL
LDAP_BIND_DN = "uid=...,ou=...,dc=..."  # DN to authenticate to the LDAP server
LDAP_BIND_PASSWORD = "..."              # password
LDAP_USER_QUERY = "supannAliasLogin=%s" # query to retrieve user, %s is CAS username
LDAP_BASE = "dc=univ,dc=fr"             # base DN for the query
</code>

</section>

<section id="installation-init.d">
<title>Lancement de l'application au démarrage du système</title>
<p>TODO : sysvinit et /etc/default/polynum</p>
</section>

<section id="installation-debug">
<title>Retrait du mode <em>debug</em>, collectstatic</title>
<p>TODO : DEBUG = False</p>
</section>

<section id="installation-reverseproxy">
<title>Mise en production derrière un reverse-proxy</title>
<p>TODO : collectstatic</p>
<p>TODO : config gunicorn + nginx</p>
</section>

</page>

