View source for Installation using a command line interface (CLI)

<languages />
<translate>

== Introduction == <!--T:1-->
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 == <!--T:2-->
* 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 == <!--T:3-->
For illustration purposes, we assume in our example the '''WEBROOT''' to be '''/var/www/limesurvey'''.

<!--T:4-->
<source lang="bash">
cd /var/www/limesurvey/application/commands
php console.php
</source>
This will show:
<pre>
Yii command runner (based on Yii v1.1.14)
Usage: console.php <command-name> [parameters...]

<!--T:5-->
The following commands are available:
 - install
 - message
 - migrate
 - plugin
 - resetpassword
 - shell
 - webapp

<!--T:6-->
To see the individual command help, use the following:
   console.php help <command-name>
</pre>

== Syntax == <!--T:7-->
<pre>
php console.php <Admin User Name> <Admin User Password> <Full Name> <EMail ID>
</pre>

<!--T:8-->
* 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.

== Example == <!--T:9-->
<source lang="bash">
cd /var/www/limesurvey/application/commands
php console.php install limeadmin pwd123 Admin admin@mydomain.com
</source>

<!--T:10-->
outputs the following text:
<pre>
/var/www/limesurvey/installer/sql/create-mysql.sql
</pre>
and the database should be properly installed at the moment.
</translate>