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

Latest 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

Будет показано:

Yii command runner (based on Yii v1.1.14)
Применение: console.php <command-name> [parameters...]

Доступны следующие команды:
 - install
 - message
 - migrate
 - plugin
 - resetpassword
 - shell
 - webapp

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

Синтаксис

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.

Пример

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 />
-==Введение==
+== Introduction ==
-При выполнении автоматизированной установки, как при настройке виртуальной машины, мы можем использовать использовать Limesurvey (имеется ввиду v2.x) CLI (интерфейс командной строки). Файлы, используемые для этой цели (и для сброса паролей, а) находятся в папке '''WEBROOT/application/commands''',а один из интересующих нас файлов - '''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-requisites ==
-*Доступность PHP CLI
+* PHP CLI should be available
-*Доступность файла '''WEBROOT/application/config/config.php''' с параметрами автоматической установки.
+* '''WEBROOT/application/config/config.php''' should be available and populated with the parameters provided by the automated installation process.
-*Разрешения на папку с PHP модулями должны совпадать с требованиями '''LimeSurvey'''
+* The availablity of the PHP Modules permissions should match the needs of '''LimeSurvey'''.
-*Должна быть создана пустая база данных MySQL и пользоваться данной базой должен пользователь с соответствующими на нее правами.
+* An empty MySQL database should be created and the user should have the proper privileges in order to use it.
 == Usage ==
-For illustration purposes here we assume the '''WEBROOT''' to be '''/var/www/limesurvey'''
+For illustration purposes, we assume in our example the '''WEBROOT''' to be '''/var/www/limesurvey'''.
 <source lang="bash">
@@ Line 17: / Line 17: @@
 php console.php
 </source>
-This will show:
+Будет показано:
 <pre>
 Yii command runner (based on Yii v1.1.14)
-Usage: console.php <command-name> [parameters...]
+Применение: console.php <command-name> [parameters...]
-The following commands are available:
+Доступны следующие команды:
   - install
   - message
@@ Line 31: / Line 31: @@
   - webapp
-To see individual command help, use the following:
+To see the individual command help, use the following:
     console.php help <command-name>
 </pre>
-== Syntax ==
+==Синтаксис==
 <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.
+* The Full Name and Password are enclosed in double quotes if they contain spaces or other special characters.
-* All other parameters like DB Name, DB Type, DB User, DB Password, etc are to be populated in the '''config.php''' file before script execution.
+* 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 ==
+==Пример==
 <source lang="bash">
 cd /var/www/limesurvey/application/commands
@@ Line 54: / Line 54: @@
 /var/www/limesurvey/installer/sql/create-mysql.sql
 </pre>
-and the database should be properly installed.
+and the database should be properly installed at the moment.