Configuration d'une instance

============================

� la cr�ation d'une instance, un fichier de configuration est g�n�r� dans ::

   $(CW_REGISTRY)/<instance>/<nom configuration>.conf

par exemple ::

   /etc/cubicweb.d/jpl/all-in-one.conf

C'est un simple fichier texte au format INI. Dans la description suivante,

chaque nom d'option est pr�fix� de sa section et suivi de sa valeur par d�faut

le cas �ch�ant, e.g. "`<section>.<option>` [valeur]".

Configuration du serveur web

----------------------------

:`web.auth-mode` [cookie]: 

   mode d'authentification, cookie ou http

:`web.realm`: 

   realm de l'application en mode d'authentification http

:`web.http-session-time` [0]:

   d�lai d'inactivit� d'une session HTTP avant sa fermeture automatique. Dur�e

   en secondes, 0 signifiant pas d'expiration (ou plus exactement lors de la

   fermeture du navigateur du client)

:`main.anonymous-user`, `main.anonymous-password`:

   login et mot de passe � utiliser pour se connecter au serveur RQL lors des

   connexions HTTP anonymes. Il faut que le compte CWUser associ� existe.

:`main.base-url`:

   url de base du site, � utiliser pour g�n�rer les urls des pages web

Configuration https

```````````````````

Il est possible de rendre un site accessible en http pour les connections 

anonymes et en https pour les utilisateurs authentifi�. Il faut pour cela

utiliser apache (par ex.) pour la redirection et la variable `main.https-url` du

fichier de configuration.

:Exemple:

  pour une redirection apache d'un site accessible via `http://localhost/demo`

  et `https://localhost/demo` et qui tourne en r�alit� sur le port 8080, il 

  faut avoir pour la version http : ::

    RewriteCond %{REQUEST_URI} ^/demo

    RewriteRule ^/demo$ /demo/

    RewriteRule ^/demo/(.*) http://127.0.0.1:8080/$1 [L,P]

  et pour la version https : ::

    RewriteCond %{REQUEST_URI} ^/demo

    RewriteRule ^/demo$ /demo/

    RewriteRule ^/demo/(.*) http://127.0.0.1:8080/https/$1 [L,P]

  et on aura dans le fichier all-in-one.conf de l'instance : ::

    base-url = http://localhost/demo

    https-url = `https://localhost/demo`

Configuration de l'interface web

--------------------------------

:`web.embed-allowed`:

   expression r�guli�re correspondant aux sites pouvant �tre "incorpor�" dans

   le site (controleur 'embed')

:`web.submit-url`:

   url � laquelle les bugs rencontr�s dans l'application peuvent �tre post�

Configuration du serveur RQL

----------------------------

:`main.host`:

   nom de l'h�te s'il ne peut �tre d�tecter correctement

:`main.pid-file`:

   fichier o� sera �crit le pid du serveur

:`main.uid`:

   compte utilisateur � utiliser pour le lancement du serveur quand il est

   lanc� en root par init

:`main.session-time [30*60]`:

   temps d'expiration d'une session RQL

:`main.query-log-file`:

   fichier dans lequel �crire toutes les requ�tes RQL �x�cut�es par le serveur

Configuration Pyro pour l'instance

-----------------------------------

Cot� serveur web :

:`pyro-client.pyro-application-id`: 

   identifiant pyro du serveur RQL (e.g. le nom de l'instance)

Cot� serveur RQL :

:`pyro-server.pyro-port`:

   num�ro de port pyro. Si aucune valeur n'est sp�cifi�e, un port est attribu�

   automatiquement.

Cot� serveur RQL et serveur web :

:`pyro-name-server.pyro-ns-host`:

   nom de l'h�te h�bergeant le serveur de nom pyro. Si aucune valeur n'est

   sp�cifi�, il est localis� par une requ�te de broadcast

:`pyro-name-server.pyro-ns-group` [cubicweb]:

   groupe pyro sous lequel enregistrer l'application

Configuration courriel

----------------------

Cot� serveur RQL et serveur web :

:`email.mangle-emails [no]`:

   indique si les adresses email doivent �tre affich�es telle quelle ou

   transform�e

Cot� serveur RQL :

:`email.smtp-host [mail]`:

   nom de l'h�te h�bergeant le serveur SMTP � utiliser pour le courriel sortant

:`email.smtp-port [25]`:

   port du serveur SMTP � utiliser pour le courriel sortant

:`email.sender-name`:

   nom � utiliser pour les courriels sortant de l'application

:`email.sender-addr`:

   adresse � utiliser pour les courriels sortant de l'application

:`email.default-dest-addrs`:

   adresses de destination par d�faut, si utilis� par la configuration de la 

   diffusion du mod�le (s�par�es par des virgules)

:`email.supervising-addrs`:

   addresses de destination des courriels de supervision (s�par�es par des 

   virgules)

Configuration journalisation

----------------------------

:`main.log-threshold`:

   niveau de filtrage des messages (DEBUG, INFO, WARNING, ERROR)

:`main.log-file`:

   fichier dans lequel �crire les messages

Configuration Eproperties

-------------------------

D'autres param�tres de configuration sont sous la forme d'entit�s `CWProperty`

dans la base de donn�es. Il faut donc les �diter via l'interface web ou par des

requ�tes rql.

:`ui.encoding`:

   encodage de caract�res � utiliser pour l'interface web

:`navigation.short-line-size`: # XXX should be in ui

   nombre de caract�res maximum pour les affichages "courts"

:`navigation.page-size`:

   nombre d'entit�s maximum � afficher par page de r�sultat

:`navigation.related-limit`:

   nombre d'entit�s li�es maximum � afficher sur la vue primaire d'une entit�

:`navigation.combobox-limit`:

   nombre d'entit�s non li�es maximum � afficher sur les listes d�roulantes de

   la vue d'�dition d'une entit�