Actions

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

From LimeSurvey Manual

(Created page with "Installation über Kommandozeile (CLI)")
 
No edit summary
 
(13 intermediate revisions by 2 users not shown)
Line 1: Line 1:
<languages />  
<languages />
== Introduction ==
When doing automated installs like in a Virtual Machine setup, we can use 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 ==
== Einführung ==
* PHP CLI should be available
Bei automatisierten Installationen (z. B. bei der Einrichtung einer virtuellen Maschine) können wir die CLI (Befehlszeilenschnittstelle) von LimeSurvey (v2.x, auf die hier Bezug genommen wird) mit gutem Erfolg nutzen. Die zu diesem Zweck (und auch zum Zurücksetzen von Passwörtern) verwendeten Dateien befinden sich im Ordner '''WEBROOT/application/commands'', die hier interessante Datei ist '''console.php''.
* '''WEBROOT/application/config/config.php''' should be available and populated with the automated install's parameters.
* Folder permissions PHP Modules availability should match '''LimeSurvey''' needs
* Empty MySQL database should be created and the database use user should be properly privileged for it.


== Usage ==
== Voraussetzungen ==
For illustration purposes here we assume the '''WEBROOT''' to be '''/var/www/limesurvey'''
* PHP CLI sollte verfügbar sein.
* '''WEBROOT/application/config/config.php''' sollte verfügbar sein und mit den vom automatisierten Installationsprozess bereitgestellten Parametern gefüllt sein.
* Die Verfügbarkeit der PHP-Modulberechtigungen sollte den Anforderungen von „LimeSurvey“ entsprechen.
* Eine leere MySQL-Datenbank sollte erstellt werden und der Benutzer sollte über die entsprechenden Berechtigungen verfügen, um sie zu verwenden.
 
== Verwendung ==
Zur Veranschaulichung gehen wir in unserem Beispiel davon aus, dass „WEBROOT“ „/var/www/limesurvey“ ist.


<source lang="bash">
<source lang="bash">
cd /var/www/limesurvey/application/commands
cd /var/www/limesurvey/application/commands
php console.php
php console.php
</source>
</source>  
This will show:
Dies wird zeigen:
<pre>
<pre>  
Yii command runner (based on Yii v1.1.14)
Yii-Befehlsläufer (basierend auf Yii v1.1.14)
Usage: console.php <command-name> [parameters...]
Verwendung: console.php<command-name> [Parameter...]


The following commands are available:
Folgende Befehle stehen zur Verfügung:
  - install
  - installieren
  - message
  - Nachricht
  - migrate
  - migrieren
  - plugin
  - Plugin
  - resetpassword
  - Passwort zurücksetzen
  - shell
  - Shell
  - webapp
  - Web-App


To see individual command help, use the following:
Um die einzelnen Befehlshilfen anzuzeigen, verwenden Sie Folgendes:
  console.php help <command-name>
console.php-Hilfe<command-name>  
</pre>
</pre>


== Syntax ==
== Syntax ==
<pre>
<pre>  
php console.php <Admin User Name> <Admin User Password> <Full Name> <EMail ID>
php console.php<Admin User Name><Admin User Password><Full Name><EMail ID>  
</pre>
</pre>


* The Full Name and password are enclosed in double quotes if they contain spaces or other special characters.
* Der vollständige Name und das Passwort werden in doppelte Anführungszeichen gesetzt, wenn sie Leerzeichen oder andere Sonderzeichen enthalten.
* 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.
* Alle anderen Parameter wie DB-Name, DB-Typ, DB-Benutzer, DB-Passwort usw. müssen im Feld '' ausgefüllt werden. Datei „config.php“ vor der Skriptausführung.
* The script should be executed from and in the '''WEBROOT/application/commands''' folder only.
* Das Skript sollte nur aus und im Ordner „WEBROOT/application/commands“ ausgeführt werden.


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


outputs the following text:
gibt den folgenden Text aus:
<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.
und die Datenbank sollte jetzt ordnungsgemäß installiert sein.

Latest revision as of 09:16, 26 March 2024

Einführung

Bei automatisierten Installationen (z. B. bei der Einrichtung einer virtuellen Maschine) können wir die CLI (Befehlszeilenschnittstelle) von LimeSurvey (v2.x, auf die hier Bezug genommen wird) mit gutem Erfolg nutzen. Die zu diesem Zweck (und auch zum Zurücksetzen von Passwörtern) verwendeten Dateien befinden sich im Ordner WEBROOT/application/commands, die hier interessante Datei ist console.php.

Voraussetzungen

  • PHP CLI sollte verfügbar sein.
  • WEBROOT/application/config/config.php sollte verfügbar sein und mit den vom automatisierten Installationsprozess bereitgestellten Parametern gefüllt sein.
  • Die Verfügbarkeit der PHP-Modulberechtigungen sollte den Anforderungen von „LimeSurvey“ entsprechen.
  • Eine leere MySQL-Datenbank sollte erstellt werden und der Benutzer sollte über die entsprechenden Berechtigungen verfügen, um sie zu verwenden.

Verwendung

Zur Veranschaulichung gehen wir in unserem Beispiel davon aus, dass „WEBROOT“ „/var/www/limesurvey“ ist.

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

Dies wird zeigen:

 
Yii-Befehlsläufer (basierend auf Yii v1.1.14)
Verwendung: console.php<command-name> [Parameter...]

Folgende Befehle stehen zur Verfügung:
 - installieren
 - Nachricht
 - migrieren
 - Plugin
 - Passwort zurücksetzen
 - Shell
 - Web-App

Um die einzelnen Befehlshilfen anzuzeigen, verwenden Sie Folgendes:
 console.php-Hilfe<command-name> 

Syntax

 
php console.php<Admin User Name><Admin User Password><Full Name><EMail ID> 
  • Der vollständige Name und das Passwort werden in doppelte Anführungszeichen gesetzt, wenn sie Leerzeichen oder andere Sonderzeichen enthalten.
  • Alle anderen Parameter wie DB-Name, DB-Typ, DB-Benutzer, DB-Passwort usw. müssen im Feld ausgefüllt werden. Datei „config.php“ vor der Skriptausführung.
  • Das Skript sollte nur aus und im Ordner „WEBROOT/application/commands“ ausgeführt werden.

Beispiel

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

gibt den folgenden Text aus:

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

und die Datenbank sollte jetzt ordnungsgemäß installiert sein.