Installation using a command line interface (CLI)/fr: Difference between revisions

Latest revision as of 13:39, 25 June 2018

Other languages:

Introduction

Pour des installations automatisées (pour des images de machines virtuelles par exemple), nous pouvons, depuis LS v2.x, utiliser l'interface en ligne de commande (CLI) de LimeSurvey. Tous les fichiers nécessaires (et pour réinitialiser les mots de passe aussi) sont dans le répertoire WEBROOT/application/commands, le plus important étant console.php.

Les pré-requis

PHP CLI doit être disponible;
WEBROOT/application/config/config.php doit être accessible et alimenté par le processus d'installation automatique avec les bons paramètres;
Les permissions sur les modules PHP doivent respecter les conditions nécessaires pour LimeSurvey;
Une base MySQL dédiée doit être créée et l'utilisateur doit avoir les privilèges nécessaires pour l'utiliser.

Utilisation

Pour ces exemples d'illustration, nous considérerons que le répertoire WEBROOT sera /var/www/limesurvey.

cd /var/www/limesurvey/application/commands
php console.php

Ce qui aura en sortie :

Yii command runner (based on Yii v1.1.14)
Usage: console.php <command-name> [parameters...]

Les commandes suivantes sont disponibles :
 - install
 - message
 - migrate
 - plugin
 - resetpassword
 - shell
 - webapp

Pour avoir l'aide individuelle de chaque commande tapez :
   console.php help <command-name>

Syntaxe

php console.php <Admin User Name> <Admin User Password> <Full Name> <EMail ID>

Le nom complet et la mot de passe sont entre guillemets s'ils contiennent des espaces ou bien d'autres caractères spéciaux;
les autres paramètres, tels que le nom de la base de données, son type, son utilisateur, son mot de passe, etc, doivent être renseignés dans le fichier config.php avant l'exécution du script;
le script doit être exécuté seulement depuis le répertoire WEBROOT/application/commands.

Exemple

cd /var/www/limesurvey/application/commands
php console.php install limeadmin pwd123 Admin admin@mydomain.com

aura pour sortie :

/var/www/limesurvey/installer/sql/create-mysql.sql

et la base de données sera alors créée ensuite.

@@ Line 2: / Line 2: @@
 == Introduction ==
-When doing automated installs (e.g. in a virtual machine setup), we can use LimeSurvey's (v2.x referred to here) CLI (command-line interface) to good effect. The files used for this purpose (and for resetting passwords as well) are in the '''WEBROOT/application/commands''' folder, the one of interest here being '''console.php'''.
+Pour des installations automatisées (pour des images de machines virtuelles par exemple), nous pouvons, depuis LS v2.x, utiliser l'interface en ligne de commande (CLI) de LimeSurvey. Tous les fichiers nécessaires (et pour réinitialiser les mots de passe aussi) sont dans le répertoire '''WEBROOT/application/commands''', le plus important étant '''console.php'''.
-== Pre-requisites ==
+== Les pré-requis ==
-* PHP CLI should be available
+* PHP CLI doit être disponible;
-* '''WEBROOT/application/config/config.php''' should be available and populated with the parameters provided by the automated installation process.
+* '''WEBROOT/application/config/config.php''' doit être accessible et alimenté par le processus d'installation automatique avec les bons paramètres;
-* The availablity of the PHP Modules permissions should match the needs of '''LimeSurvey'''.
+* Les permissions sur les modules PHP doivent respecter les conditions nécessaires pour '''LimeSurvey''';
-* An empty MySQL database should be created and the user should have the proper privileges in order to use it.
+* Une base MySQL dédiée doit être créée et l'utilisateur doit avoir les privilèges nécessaires pour l'utiliser.
-== Usage ==
+== Utilisation ==
-For illustration purposes, we assume in our example the '''WEBROOT''' to be '''/var/www/limesurvey'''.
+Pour ces exemples d'illustration, nous considérerons que le répertoire '''WEBROOT''' sera '''/var/www/limesurvey'''.
 <source lang="bash">
@@ Line 17: / Line 17: @@
 php console.php
 </source>
-This will show:
+Ce qui aura en sortie :
 <pre>
 Yii command runner (based on Yii v1.1.14)
 Usage: console.php <command-name> [parameters...]
-The following commands are available:
+Les commandes suivantes sont disponibles :
   - install
   - message
@@ Line 31: / Line 31: @@
   - webapp
-To see the individual command help, use the following:
+Pour avoir l'aide individuelle de chaque commande tapez :
     console.php help <command-name>
 </pre>
-== Syntax ==
+== Syntaxe ==
 <pre>
 php console.php <Admin User Name> <Admin User Password> <Full Name> <EMail ID>
 </pre>
-* The Full Name and Password are enclosed in double quotes if they contain spaces or other special characters.
+* Le nom complet et la mot de passe sont entre guillemets s'ils contiennent des espaces ou bien d'autres caractères spéciaux;
-* All the other parameters like DB Name, DB Type, DB User, DB Password etc. are to be populated in the '''config.php''' file before script execution.
+* les autres paramètres, tels que le nom de la base de données, son type, son utilisateur, son mot de passe, etc, doivent être renseignés dans le fichier '''config.php'''  avant l'exécution du script;
-* The script should be executed from and in the '''WEBROOT/application/commands''' folder only.
+* le script doit être exécuté seulement depuis le répertoire '''WEBROOT/application/commands'''.
-== Example ==
+== Exemple ==
 <source lang="bash">
 cd /var/www/limesurvey/application/commands
@@ Line 50: / Line 50: @@
 </source>
-outputs the following text:
+aura pour sortie :
 <pre>
 /var/www/limesurvey/installer/sql/create-mysql.sql
 </pre>
-and the database should be properly installed at the moment.
+et la base de données sera alors créée ensuite.