correction de la documentation et de bugs mineurs
[ansible.git] / montreal / gestionmateriel / docs / index.rst
index 32db4bc..bfdcbe3 100644 (file)
@@ -11,21 +11,35 @@ Notez que ce site est en version Beta et est sujet à changement.
 Dépendances
 -----------
 
-Veuillez installer les dépendances avec la commande suivante::
+Veuillez installer les dépendances avec les commandes suivantes::
 
-  apt-get install python-virtualenv python-pip python-sqlite
+Sur Ubuntu:
 
+  sudo apt-get install software-properties-common
+  sudo apt-add-repository ppa:ansible/ansible
+  sudo apt-get update
+  sudo apt-get install ansible
+  sudo apt-get install python-virtualenv python-pip python-sqlite redis-server python-mysqldb python-crypto
+
+
+Sur Debian::
+
+  sudo apt-get install python-virtualenv python-pip python-sqlite redis-server python-mysqldb python-crypto
+  sudo pip install ansible
 
 Installation
 ------------
 
 ::
 
-  virtualenv .
+  virtualenv --system-site-packages .
   source bin/activate
   pip install -r requirements.txt
   ./manage.py syncdb
   ./manage.py migrate
+
+Si vous n'avez pas encore créé un utilisateur vous pouvez le faire avec la commande::
+
   ./manage.py createsuperuser
 
 Vous devez ensuite modifier le fichier `maj.yml` selon vos besoins.
@@ -47,7 +61,7 @@ Pour utiliser l'interface web vous devez d'abord vous autentifier:
 
 puis visiter la page suivante:
 
-  http://localhost:8000/admin/maj/machine/
+  http://localhost:8000/admin/materiel/machine/
 
 Ligne de commande
 ^^^^^^^^^^^^^^^^^
@@ -62,6 +76,29 @@ Rouler un module Ansible sur toutes les machines d'une catégorie::
 
   bin/ansible -i inventory.py -m ping categorie
 
+Tâches planifiées
+-----------------
+
+Pour utiliser les tâches planifiées vous devez rouler la commande suivante::
+
+  bin/python manage.py rqscheduler
+
+FAQ
+---
+
+Problème:
+
+  Mes commandes n'exécute pas
+
+Solution:
+
+  * Vérifier que vous avez bien démarrer la commande `bin/python manage.py qworker`
+  * Vérifier que votre commande ssh ne demande pas d'ajouter un fingerprint.
+  * Vérifier que votre commande ssh ne demande pas de phrase secrète.
+  * Vérifier que le port de connexion est bien 22.
+  * Vérifier que l'utilisateur distant est bien root.
+
+
 Aides et supports
 -----------------