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

Revision as of 13:25, 19 October 2017

Other languages:

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.

Pre-requisites

PHP CLI should be available
WEBROOT/application/config/config.php should be available and populated with the parameters provided by the automated installation process.
The availablity of the PHP Modules permissions should match the needs of LimeSurvey.
An empty MySQL database should be created and the user should have the proper privileges in order to use it.

Usage

For illustration purposes, we assume in our example the WEBROOT to be /var/www/limesurvey.

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

Il risultato di ciò sarà:

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

Sono disponibili i seguenti comandi:
- install
- message
- migrate
- plugin
- resetpassword
- shell
- webapp

To see the individual command help, use the following:
   console.php help <command-name>

Sintassi

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

The Full Name and Password are enclosed in double quotes if they contain spaces or other special characters.
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.
The script should be executed from and in the WEBROOT/application/commands folder only.

Esempio

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

outputs the following text:

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

and the database should be properly installed at the moment.

@@ Line 1: / Line 1: @@
 <languages />
-==Introduzione==
+== Introduction ==
-Quando si compiono delle installazioni automatizzate come durante l'installazione di una macchina virtuale, possiamo utilizzare la CLI (Command Line Interface - Interfaccia a Linea di Comanda) di LimeSurvey (qui si fa riferimento alla v2.X) per ottenere un buon risultato. I file utilizzati a questo scopo (così come per il reset della password) sono contenuti nella cartella '''WEBROOT/application/commands'''; in particolare, quello che ci interessa qui è '''console.php'''.
+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'''.
-==Pre-Requisiti==
+== Pre-requisites ==
-* PHP Client, deve essere disponibile.
+* PHP CLI should be available
-* '''WEBROOT/application/config/config.php''', deve essere disponibile e deve contenere i parametri settati automaticamente nell'installazione.
+* '''WEBROOT/application/config/config.php''' should be available and populated with the parameters provided by the automated installation process.
-* I permessi sulla cartella Moduli PHP devono corrispondere a quelli richiesti da LimeSurvey.
+* The availablity of the PHP Modules permissions should match the needs of '''LimeSurvey'''.
-*Deve essere creato un database MySQL vuoto e l'utente che lo utilizza dovrebbe essere in possesso dei privilegi per poterlo fare.
+* An empty MySQL database should be created and the user should have the proper privileges in order to use it.
-==Utilizzo==
+== Usage ==
-A scopo illustrativo, assumiamo che la '''WEBROOT''' sia '''/var/ww/limesurvey'''
+For illustration purposes, we assume in our example the '''WEBROOT''' to be '''/var/www/limesurvey'''.
 <source lang="bash">
@@ Line 31: / Line 31: @@
 - webapp
-Per visualizzare l'help dei singoli comandi utilizzare:
+To see the individual command help, use the following:
-  console.php help <command-name>
+   console.php help <command-name>
 </pre>
@@ Line 40: / Line 40: @@
 </pre>
-* il "Full Name" e la "Password" devono essere racchiusi tra " " (virgolette) nel caso in cui contengano spazi o altri caratteri speciali.
+* The Full Name and Password are enclosed in double quotes if they contain spaces or other special characters.
-* Tutti gli altri parametri come DB Name, DB Type, DB User, DB Password, etc. devono essere inseriti nel file config.php prima dell'esecuzione dello script.
+* 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.
-* Lo script deve dovrebbe essere eseguito unicamente da e all'interno della cartella '''WEBROOT/application/commands'''.
+* The script should be executed from and in the '''WEBROOT/application/commands''' folder only.
 ==Esempio==
@@ Line 50: / Line 50: @@
 </source>
-Il risultato sarà il seguente testo:
+outputs the following text:
 <pre>
 /var/www/limesurvey/installer/sql/create-mysql.sql
 </pre>
-e il database dovrebbe essere installato correttamente.
+and the database should be properly installed at the moment.