Actions

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

From LimeSurvey Manual

(Updating to match new version of source page)
No edit summary
Line 1: Line 1:
<languages />
<languages />


== Introduction ==
== Introduzione ==
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'''.
Quando si eseguono installazioni automatiche (ad es. in una configurazione di macchina virtuale), è possibile utilizzare la CLI (command-line interface) di LimeSurvey (v2.x a cui si fa riferimento qui) con buoni risultati. I file utilizzati a tale scopo (e anche per reimpostare le password) si trovano nella cartella '''WEBROOT/application/commands''', quella che qui interessa è '''console.php'''.


== Pre-requisites ==
<div class="mw-translate-fuzzy">
* PHP CLI should be available
==Pre-Requisiti==
* '''WEBROOT/application/config/config.php''' should be available and populated with the parameters provided by the automated installation process.
* PHP Client, deve essere disponibile.
* The availablity of the PHP Modules permissions should match the needs of '''LimeSurvey'''.
* '''WEBROOT/application/config/config.php''', deve essere disponibile e deve contenere i parametri settati automaticamente nell'installazione.
* An empty MySQL database should be created and the user should have the proper privileges in order to use it.
* I permessi sulla cartella Moduli PHP devono corrispondere a quelli richiesti da LimeSurvey.
*Deve essere creato un database MySQL vuoto e l'utente che lo utilizza dovrebbe essere in possesso dei privilegi per poterlo fare.
</div>


== Usage ==
<div class="mw-translate-fuzzy">
For illustration purposes, we assume in our example the '''WEBROOT''' to be '''/var/www/limesurvey'''.
==Utilizzo==
A scopo illustrativo, assumiamo che la '''WEBROOT''' sia '''/var/ww/limesurvey'''
</div>


<source lang="bash">
<source lang="bash">
Line 31: Line 35:
- webapp
- webapp


To see the individual command help, use the following:
<div class="mw-translate-fuzzy">
  console.php help <command-name>
Per visualizzare l'help dei singoli comandi utilizzare:
  console.php help <command-name>
</pre>
</pre>
</div>


==Sintassi==
==Sintassi==
Line 40: Line 46:
</pre>
</pre>


* The Full Name and Password are enclosed in double quotes if they contain spaces or other special characters.
<div class="mw-translate-fuzzy">
* 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.
* il "Full Name" e la "Password" devono essere racchiusi tra " " (virgolette) nel caso in cui contengano spazi o altri caratteri speciali.
* The script should be executed from and in the '''WEBROOT/application/commands''' folder only.
* 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.
* Lo script deve dovrebbe essere eseguito unicamente da e all'interno della cartella '''WEBROOT/application/commands'''.
</div>


==Esempio==
==Esempio==
Line 50: Line 58:
</source>
</source>


outputs the following text:
<div class="mw-translate-fuzzy">
Il risultato sarà il seguente testo:
<pre>
<pre>
/var/www/limesurvey/installer/sql/create-mysql.sql
/var/www/limesurvey/installer/sql/create-mysql.sql
</pre>
</pre>
and the database should be properly installed at the moment.
e il database dovrebbe essere installato correttamente.
</div>

Revision as of 08:03, 3 August 2023

Introduzione

Quando si eseguono installazioni automatiche (ad es. in una configurazione di macchina virtuale), è possibile utilizzare la CLI (command-line interface) di LimeSurvey (v2.x a cui si fa riferimento qui) con buoni risultati. I file utilizzati a tale scopo (e anche per reimpostare le password) si trovano nella cartella WEBROOT/application/commands, quella che qui interessa è console.php.

Pre-Requisiti

  • PHP Client, deve essere disponibile.
  • WEBROOT/application/config/config.php, deve essere disponibile e deve contenere i parametri settati automaticamente nell'installazione.
  • I permessi sulla cartella Moduli PHP devono corrispondere a quelli richiesti da LimeSurvey.
  • Deve essere creato un database MySQL vuoto e l'utente che lo utilizza dovrebbe essere in possesso dei privilegi per poterlo fare.

Utilizzo

A scopo illustrativo, assumiamo che la WEBROOT sia /var/ww/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

<div class="mw-translate-fuzzy">
Per visualizzare l'help dei singoli comandi utilizzare:
  console.php help <command-name>

Sintassi

php console.php <Admin User Name> <Admin User Password> <Full Name> <EMail ID>
  • il "Full Name" e la "Password" devono essere racchiusi tra " " (virgolette) nel caso in cui contengano spazi o altri caratteri speciali.
  • 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.
  • Lo script deve dovrebbe essere eseguito unicamente da e all'interno della cartella WEBROOT/application/commands.

Esempio

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

Il risultato sarà il seguente testo:

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

e il database dovrebbe essere installato correttamente.