Hostsharing Wiki - Benutzerbeiträge [de]

Contao Installieren

2017-08-11T12:45:35Z

Hsh-michaelhierweck:

<pre>
0. HSAdmin
Domain-Admin, Domain(s), MySQL-Benutzer und -Datenbank anlegen

1. Shell:
$ mkdir contao
$ composer create-project --no-dev contao/managed-edition contao

2. Symlinken
DocumentRoot(s) nach contao/web symlinken

3. Installtool aufrufen
Installtool via /contao/install aufrufen
</pre>

TYPO3 Neos installieren

2017-08-11T12:45:00Z

Hsh-michaelhierweck: /* Notwendige Schritte zur Installation */

{{Baustelle}}

Teile der Installation von TYPO3 Neos sind aus dem [http://www.typovision.de/fileadmin/slides/TYPO3-Neos-Das-Kompendium-Patrick-Lobacher-typovision-20130818.pdf Neos-Kompendium] von Patrick Lobacher (Typovision GmbH) entnommen und wurden auf die Besonderheiten bei Hostsharing angepasst.

Beschrieben wird hier in erster Linie die Installation in einem Shared Hosting Paket. Auf Hostsharing Systemen läuft für die Shared Hosting Pakete ein zentraler Apache, der standardmäßig die Anfragen für die in den Paketen aufgeschalteten Domains verarbeitet und die Webseiten ausliefert. Durch ein zentrales Template wird für jede aufgeschaltete Domain im Apache automatisch (von hsadmin) ein Virtual Host eingerichtet. Die Konfiguration lässt sich lediglich durch einige der [https://wiki.hostsharing.net/index.php?title=Hsadmin/Domainoptionen HSAdmin-Domain-Options] beeinflussen.

'''''TODO: Andere Installationsarten (eigener Serverdienst, root-Server) sind am Ende des Artikels beschrieben.'''''

== Systemvoraussetzungen ==

Das TYPO3 Neos Kompendium nennt die folgenden Systemvoraussetzungen.
Bei Hostsharing erfüllen alle Shared Hosting Pakete im '''Auslieferungszustand''' diese Systemvoraussetzungen mit wenigen notwendigen manuellen Nacharbeiten:

*''' Webserver (empfohlen ist Apache 2.x mit aktiviertem [[mod_rewrite]] Modul) = HS Shared Hosting default'''
* [[PHP]] 5.3.7 - 5.4.x (minimal wäre PHP 5.3.2 - dort kann es zu Problemen kommen)
*''' Folgende Funktionen müssen in PHP aktiviert sein (= HS Shared Hosting default):'''
**''' system()'''
**''' shell_exec()'''
**''' escapeshellcmd()'''
**''' escapeshellarg()'''
**''' proc_open()'''
**''' exec()'''
* [[PHP#Anpassung_der_PHP_Grundkonfiguration|php.ini]]: memory_limit = 256M oder höher
* [[PHP#Anpassung_der_PHP_Grundkonfiguration|php.ini]]: xdebug.max_nesting_level = 500 (sofern xdebug verwendet wird)
* [[PHP#Anpassung_der_PHP_Grundkonfiguration|php.ini]]: Fügen sie die folgende Optionen ans Ende hinzu: detect_unicode = Off
* [[PHP#Anpassung_der_PHP_Grundkonfiguration|php.ini]]: Zudem muss Magic_Quotes ausgeschaltet werden: magic_quotes_gpc = Off
* [[PHP#Anpassung_der_PHP_Grundkonfiguration|php.ini]]: Die Kommandozeile von Flow benötigt ferner noch eine Zeitzoneneinstellung: date.timezone= "Europe/Berlin"
*''' [[MySQL]] 5.1.50 - 5.x.x (zum Beispiel - grundsätzlich kann jede zum Doctrine DBAL kompatible Datenbank verwendet werden) = HS Shared Hosting default'''
*''' [[Login_mit_SSH|Zugang zur Konsole]] (shell-User) = HS Shared Hosting default'''

=== Bemerkung zu bereitstehenden PHP Versionen ===

Die PHP-Kommandozeilenversion (PHP-CLI) erfüllt die geforderte Versionsnummer von 5.3.7: Installiert ist PHP 5.4.4-14+deb7u11 (cli)

Die Versionsnummer von PHP-CLI kann mit dem folgenden Befehl in der Kommandozeile überprüft werden:

php --version

=== Umsetzung der Einstellungen für php.ini ===

Die php.ini für PHP via FastCGI muss in diesem Verzeichnis liegen:
/home/doms/example.org/fastcgi
(existiert dort keine php.ini, kann sie manuell leer angelegt werden und anschließend mit einem Editor (z.B. nano) bearbeitet werden):

touch php.ini
nano php.ini

Alternativ kann man auch eine Muster-php.ini dorthin kopieren. Siehe hierzu: [[PHP#Beispiel_muster.example.com|Beispiel muster.example.com]]

Die nötigen Einstellungen für TYPO3 Neos hier gesammelt als Block für copy&paste an das Ende der php.ini

memory_limit = 256M ; default ist 128M
xdebug.max_nesting_level = 500 ; Einkommentieren sofern xdebug verwendet wird
detect_unicode = Off
date.timezone = "Europe/Berlin"
magic_quotes_gpc = Off

Zum Erzwingen einer direkten Übernahme der Änderungen an der php.ini bei FastCGI müssen die PHP Prozesse des Users neu gestartet werden. Es ist im Folgenden keine Ersetzung von $USER nötig:

killall php -u $USER

== Notwendige Schritte zur Installation ==

Es ist nicht erforderlich TYPO3 CMS zu installieren, da TYPO3 CMS und TYPO3 Neos keinerlei technische Gemeinsamkeiten besitzen.

Die Installation besteht im Wesentlichen aus diesen Schritten:

# [[TYPO3_Neos_installieren#TYPO3_Neos_und_Abh.C3.A4ngigkeiten_herunterladen_und_installieren|TYPO3 Neos und Abhängigkeiten herunterladen, installieren]]
# [[TYPO3_Neos_installieren#Inhalte_des_Verzeichnisses_Web_in_DocumentRoot_kopieren|Inhalte des Verzeichnisses Web in DocumentRoot kopieren]]
# [[TYPO3_Neos_installieren#Anpassen_der_.htaccess-Datei|Anpassen der .htaccess-Datei]]
# [[TYPO3_Neos_installieren#Anpassen_der_index.php-Datei|Anpassen der index.php-Datei]]
# [[TYPO3_Neos_installieren#TYPO3_Flow_Konfiguration:_Datenbank-Setup|FLOW Konfiguration: Datenbank-Setup]]
# [[TYPO3_Neos_installieren#TYPO3_Flow_Konfiguration:_PHP-Umgebung|FLOW Konfiguration: PHP-Umgebung]]
# [[TYPO3_Neos_installieren#TYPO3_Neos_Setup|TYPO3 Neos Setup]]

== TYPO3 Neos und Abhängigkeiten herunterladen und installieren ==

Composer sorgt für das Herunterladen von TYPO3 Neos und TYPO3 Flow mitsamt der benötigten Module (z.B. Doctrine 2, Aloha, ...). Hierzu ist dieser Befehl nötig (alles in einer Zeile):

composer create-project typo3/neos-base-distribution /home/doms/example.org/TYPO3-Neos

Während der Installation erscheinen mehrere dieser Warnungen:

''Class TYPO3\Flow\Composer\InstallerScripts is not autoloadable, can not call post-package-install script''

'''Diese Warnungen können ignoriert werden''', siehe http://forum.typo3.org/index.php/t/200300/

Wird die VCS-Historie (Version Control System, Versionsverwaltung) nicht benötigt, kann man die folgende Frage mit "Y" bestätigen:

Do you want to remove the existing VCS (.git, .svn..) history? [Y,n]?

Nun existiert ein Verzeichnis TYPO3-Neos (etwa 200 MB) im Webroot unter

/home/doms/example.org/TYPO3-Neos

Dieses Verzeichnis enthält alle Dateien von TYPO3 Neos.

Anschließend sollte composer alle Pakete nochmal auf verfügbare Updates prüfen und diese dann auch installieren:

cd /home/doms/example.org/TYPO3-Neos/
'''composer update'''

=== Inhalte des Verzeichnisses Web in DocumentRoot kopieren ===

Der Installationsordner TYPO3-Neos liegt oberhalb des DocumentRoot. Damit der Webserver dennoch auf die Installation zugreifen kann, muss man nun den Inhalt des Verzeichnisses /home/doms/example.org/TYPO3-Neos/Web in das Verzeichnis /home/doms/example.org/htdocs kopieren:

cp /home/doms/example.org/TYPO3-Neos/Web * /home/doms/example.org/htdocs

=== Anpassen der .htaccess-Datei ===

Die .htaccess-Datei im Pfad

/home/doms/example.org/htdocs

muss im folgenden Absatz für die Umgebungsvariable '''FLOW_ROOTPATH''' mit dem Pfad zu TYPO3 Flow versehen werden:

# If the root path is not the parent of the Web directory,
# TYPO3 Flow's root path must be specified manually:
# SetEnv FLOW_ROOTPATH /var/www/myapp/
'''SetEnv FLOW_ROOTPATH /home/doms/example.org/TYPO3-Neos/'''

Weiterhin ist die Anpassung dieses Absatzes nötig

# You will have to change the path in the following option if you
# experience problems while your installation is located in a subdirectory
# of the website root.
# RewriteBase /TYPO3-Neos/Web/
'''RewriteBase /'''

Bei Hostsharing ist die Webserver-Option "MultiViews" per default ausgeschaltet. Im Shared Hosting kann man zudem - abgesehen von [https://wiki.hostsharing.net/index.php?title=Hsadmin/Domainoptionen HSAdmin-Domain-Options] - keine eigenen Webserver-Optionen nutzen. Die Angabe der Option -MultiViews in der .htaccess-Datei würde zu einem Fehler im Weblog führen! Daher ist im folgenden Abschnitt eine Zeile auzukommentieren:

# prevents Apache's automatic file negotiation, it breaks resource URLs
'''#Options -MultiViews'''

=== Anpassen der index.php-Datei ===

Die Datei index.php im Pfad

/home/doms/example.org/htdocs

muss zu Beginn (Zeilen 2 und 3 direkt nach Zeile "<?php") mit den Umgebungsvariablen '''FLOW_REWRITEURLS''' und '''FLOW_CONTEXT''' versehen werden:

<?php
'''putenv ("FLOW_REWRITEURLS=1");'''
'''putenv ("FLOW_CONTEXT=Production");'''
/*
* This script belongs to the TYPO3 Flow framework. *

'''Anmerkung:'''

Die Verwendung der Umgebungsvariable '''FLOW_REWRITEURLS=1''' ist nötig, da es sonst zu einem Problem führt, dass bei Hostsharing '''Apache mit SuExec''' betrieben wird. '''''(TODO: Nicht 100% sicher, ob dies bei Hostsharing nötig ist...)'''''

Genauere Beschreibung: http://forge.typo3.org/issues/54451

=== TYPO3 Flow Konfiguration: Datenbank-Setup ===

Eine Datenbank (z.B. MySQL) und einen entsprechenden user sollte man sich zuvor schon per [[HSAdmin]] leer angelegt haben.

Das browserbasierte Setup bricht mit einem Fehler ab, sofern nicht die Datenbankeinstellungen in der Datei Settings.yaml angepasst wurden:

cd /home/doms/example.org/TYPO3-Neos/Configuration
cp Settings.yaml.example Settings.yaml
nano Settings.yaml

Folgende Einstellungen müssen vorgenommen werden

TYPO3:
Flow:
persistence:
# It is good practice to not specify user name and password of the database
# connection in this global Settings.yaml file. Rather specify them in the
# settings of the respective context (Production / Development ...).
backendOptions:
driver: 'pdo_mysql' # Datenbanktyp (DB-Treiber)
dbname: 'DBNAME' # an DB-Namen anpassen
user: 'DBUSER' # an DB-User anpassen
password: 'PASSWORT' # an DB-Passwort anpassen
host: 'localhost' # an DB-Host anpassen (bei HS: localhost)

'''Die Einzüge von exakt 2 Leerzeichen pro Ebene gehören zum Syntax! Siehe auch:''' [http://docs.typo3.org/flow/TYPO3FlowDocumentation/Quickstart/Index.html#database-setup Details zum DB-Setup für Flow]

[http://docs.typo3.org/flow/TYPO3FlowDocumentation/TheDefinitiveGuide/PartII/Installation.html Dokumentation zur Installation von Flow]

[http://docs.typo3.org/flow/TYPO3FlowDocumentation/TheDefinitiveGuide/PartIII/Configuration.html Dokumentation zur Konfiguration von Flow]

=== TYPO3 Flow Konfiguration: PHP-Umgebung ===

Die Datei Settings.yaml muss erneut angepasst werden:

cd /home/doms/example.org/TYPO3-Neos/Configuration
cp Settings.yaml.example Settings.yaml
nano Settings.yaml

Folgende Einstellungen müssen vorgenommen werden

TYPO3:
Flow:
core:
# Path and filename of the PHP binary
# The constant PHP_BINDIR usually contains the path, but on Windows this doesn't work reliably
phpBinaryPathAndFilename: '/usr/bin/php'
######################################################################################
# Set which php.ini file should be used for the CLI sub requests.
# If not set (that is value equals NULL) the php.ini file of the executing process (usually the web server's) is used.
# If set to a path and filename, the specified php.ini file is loaded.
# If set to boolean FALSE, Flow does not try to specify any php.ini file to the sub process.
subRequestPhpIniPathAndFilename: '/home/doms/example.org/php-cli.ini'

'''Die Einzüge von exakt 2 Leerzeichen pro Ebene gehören zum Syntax! Siehe auch:''' [http://docs.typo3.org/flow/TYPO3FlowDocumentation/Quickstart/Index.html#database-setup Details zum DB-Setup für Flow]

== TYPO3 Neos Setup ==

Die Setup-Routine von TYPO3 Neos läuft menügeführt über einen Browser ab. Der URL zum Aufruf lautet:

http://example.org/setup/

=== Setup-Passwort ===
Eine Passwortabfrage schützt die Setup-Routine. Das benötigte initiale Passwort wird beim Starten der Setup-Routine in einer temporären Textdatei auf dem Webserver gespeichert. Diese Datei kann man nur über die Konsole öffnen. Der Pfad zum Ablageort der Datei wird im Bildschirmdialog angezeigt:

Initial Password: The initial password for accessing the setup can be found in the file
/home/pacs/xyz00/users/username/doms/example.org/TYPO3-Neos/Data/SetupPassword.txt

==== Wiederherstellung des Setup-Passwortes ====

Nach der erstmaligen Eingabe des Setup-Passwortes wird die temporäre Textdatei in der es enthalten ist gelöscht.
Hat man das Passwort vergessen, muss man für ein weiteres Aufrufen des Setups die Datei SetupKey löschen:

rm /home/doms/example.org/TYPO3-Neos/Data/Persistent/FileBasedSimpleKeyService/SetupKey

und anschließend die Setup-Routine wie oben beschrieben erneut aufrufen.

=== Administrator anlegen ===

Das Anlegen des Administrators wird per GUI-Backend erledigt.

Weitere User lassen sich nach der Installation in der Userverwaltung des GUI-Backends ergänzen.

Alternativ lassen sich User auch in der Konsole anlegen per:

cd /home/doms/example.org/TYPO3-Neos/
./flow typo3.neos:user:create <Username> <Passwort> <Vorname> <Nachname>

(Achtung: Das so eingegebene Passwort könnte im Freitext lesbar in der Prozessliste und logdateien auftauchen! '''''TODO: Prüfen!''''')

Die Adminrolle lässt sich einem User ebenfalls in der Konsole vergeben:

cd /home/doms/example.org/TYPO3-Neos/
./flow typo3.neos:user:addrole <Username> Administrator

=== Abschluss des Setups ===

Zum Schluss kann man entweder eine Demo-Site importieren oder unter Angabe eines "Package Name" und eines "Site Name" eine leere Webseite anlegen lassen.

==== Site mit Domain verknüpfen ====

Im TYPO3 Neos Backend sollte zunächst die neu angelegte Site mit einer Domain verknüpft werden. Dies wird im "Sites Management" erledigt:

Klickpfad dorthin: '''3 waagerechte weiße Streifen''' (oben links) -> "'''Sites Management'''"

In der Zeile mit der Site das '''Bleistift-Symbol''' anklicken -> rechte Seite "'''Add domain'''" (hellblauer Button) anklicken -> '''Domainname eintragen''' -> Radiobutton "'''Active'''" anklicken -> "'''Create'''" (hellblauer Button) anklicken

'''Save''' (hellblauer Button) anklicken

=== Weitere Einstellungen ===

==== URI Suffix ändern ====

Das URI-Suffix ist standardmäßig auf ".html" eingestellt. Man kann dieses Suffix zentral ändern und auch ganz entfernen:

nano /home/doms/example.org/TYPO3-Neos/Configuration/Routes.yaml

Der Eintrag für defaultUriSuffix kann hierzu geändert werden:

# TYPO3 Neos subroutes
-
name: 'TYPO3 Neos'
uriPattern: '<TYPO3NeosSubroutes>'
subRoutes:
'TYPO3NeosSubroutes':
package: 'TYPO3.Neos'
variables:
'defaultUriSuffix': <nowiki>''</nowiki>

'''Die Einzüge von exakt 2 Leerzeichen pro Ebene gehören zum Syntax! Siehe auch:''' [http://docs.typo3.org/flow/TYPO3FlowDocumentation/Quickstart/Index.html#database-setup Details zum DB-Setup für Flow]

Anschließend müssen die [https://wiki.hostsharing.net/index.php?title=TYPO3_Neos_installieren#Cache_eines_TYPO3_Flow-Kontextes_l.C3.B6schen Caches der Flow-Kontexte gelöscht werden].

Quelle: https://review.typo3.org/#/c/25746

== Zugang zur Installation ==

Nach erfolgreichem Abschluss des Setups sind die zentralen Elemente von TYPO3 Neos über einen Browser erreichbar:

'''Setup:''' http://example.org/setup/

'''Frontend:''' http://example.org/

'''Backend:''' http://example.org/neos/

== Wichtige Pfade und Dateien ==

{| class="wikitable"
|-
| '''Pfad''' (mit Präfix /home/doms/example.org/TYPO3-Neos/)
| '''Beschreibung des Inhalts'''
|-
| Configuration/Settings.yaml
| '''Konfigurationsdatei für TYPO3 Flow''' (u.a. für Datenbank-Zugangsdaten)
|-
| Data/Logs/Security_Development.log
| Logdatei analog zu '''Security.log''' (s.u.), allerdings für den '''Development-Kontext'''.
|-
| Data/Logs/Security.log
| Logdatei, die '''Loginversuche im Production-Kontext''' protokolliert.
|-
| Data/Logs/System_Development.log
| Logdatei analog zu '''System.log''' (s.u.), allerdings für den '''Development-Kontext'''.
|-
| Data/Logs/Sytem.log
| '''System-Logdatei im Production-Kontext''' (enthält auch Hinweise auf Fehler oder Exceptions, siehe "CRITICAL").
|-
| Data/Logs/Exceptions/
| Zu jeder '''Fehlermeldung (Exception)''' liegt hier eine *.txt-Datei, die Tag und Uhrzeit im Dateinamen trägt. In den Textdateien findet man die Fehlermeldung und einen Trace.
|-
| Data/Persistent/FileBasedSimpleKeyService/SetupKey
| Datei, die gelöscht werden muss, falls man sein [https://wiki.hostsharing.net/index.php?title=TYPO3_Neos_installieren#Wiederherstellung_des_Setup-Passwortes '''Setup-Passwort vergessen'''] hat.
|-
| Packages/Application/TYPO3.Neos/Resources/Private/Templates/TypoScriptObjects/
| Ablageort für '''Fluid-Templates von TYPO3 Neos''' im Auslieferungszustand
|-
| Packages/Sites/Abc.Xyz/Configuration/
| '''Konfigurationsdateien des Paketes''' (= der Site)
|-
| Packages/Sites/Abc.Xyz/Configuration/NodeTypes.yaml
| Ablageort für '''eigene TYPO3-Flow Inhaltselemente'''
|-
| Packages/Sites/Abc.Xyz/Resources/Public
| Ablageort für alle '''öffentlich zugänglichen Dateien''' wie z.B. CSS- oder JS-Dateien
|-
| Packages/Sites/Abc.Xyz/Resources/Private
| Ablageort für alle internen Dateien
|-
| Packages/Sites/Abc.Xyz/Resources/Private/Templates/Page/Default.html
| '''Fluid-Template''' mit dem Default-Layout der Webseite; an den durch f:section-ViewHelper markierten Stellen rendert Neos Seiteninhalte in die Webseite hinein
|-
| Packages/Sites/Abc.Xyz/Resources/Private/Templates/TypoScriptObjects/
| Ablageort für alle eigenen TypoScript-Objekte
|-
| Packages/Sites/Abc.Xyz/Resources/Private/TypoScripts/Library/
| Ablageort für alle TypoScript-Dateien
|-
| Packages/Sites/Abc.Xyz/Resources/Private/TypoScripts/Library/Root.ts2
| Root-Template der gesamten Site; auch "main typoscript configuration"; Wird durch den site-kickstarter angelegt
|-
|}

== Upgrade von TYPO3 Neos... ==

Es kann entweder auf eine bestimmte Version aktualisiert werden oder auf die neueste Version (= "Development Master").

'''In beiden Fällen''' müssen anschließend die [https://wiki.hostsharing.net/index.php?title=TYPO3_Neos_installieren#Cache_eines_TYPO3_Flow-Kontextes_l.C3.B6schen Caches der Flow-Kontexte gelöscht werden] und eine [https://wiki.hostsharing.net/index.php?title=TYPO3_Neos_installieren#Migration_der_Doctrine-Datenbank Migration der Doctrine-Datenbank] durchgeführt werden.

Vor jedem Update sollte man prüfen, ob composer selbst ein Update benötigt:

composer self-update

=== ...auf eine bestimmte TYPO3 Neos Version ===

(Statt <version> z.B. 1.0.*)

cd /home/doms/example.org/TYPO3-Neos/
composer require "typo3/neos:<version>"
composer require "typo3/neos-nodetypes:<version>"
composer require "typo3/neosdemotypo3org:<version>"
composer require "typo3/sitekickstarter:<version>"

=== ...auf den Development Master (neueste Version) ===

'''Einmalig''' ist zuvor in der composer.json (siehe TYPO3-Neos Rootverzeichnis) statt "1.0.*" der Eintrag "dev-master" zu hinterlegen:

cd /home/doms/example.org/TYPO3-Neos/
nano composer.json

dort sind die vorhandenen Einträge wiefolgt zu ändern (Die Leerzeichen zu Beginn sind wichtig, da sie zum Syntax gehören!):

"require": {
"typo3/neos": "dev-master",
"typo3/neos-nodetypes": "dev-master",
"typo3/neosdemotypo3org": "dev-master",
"typo3/neos-kickstarter": "dev-master",
"doctrine/migrations": "@dev"
}

Anschließend kann das Update jedes Mal durch composer angestoßen werden:

cd /home/doms/example.org/TYPO3-Neos/
composer update

=== Cache eines TYPO3 Flow-Kontextes löschen ===

Jeder der drei Flow-Kontexte (Development, Testing und Production) besitzt einen eigenen Cache, der separat gelöscht werden kann.

Löschen des Standard-Flow-CLI-Kontextes "Development":

cd /home/doms/example.org/TYPO3-Neos/
./flow flow:cache:flush --force

Ein anderer Kontext muss dem Kommandozeilentool flow explizit mitgegeben werden [https://wiki.hostsharing.net/index.php?title=TYPO3_Neos_installieren#Setzen_eines_Flow-Kontextes Setzen eines Flow Kontextes] (s.u.).

Es ist ein [https://wiki.hostsharing.net/index.php?title=TYPO3_Neos_installieren#Workaround_falls_Einstellungen_einer_eigenen_php-cli.ini_nicht_von_Flow_ber.C3.BCcksichtigt_werden Workaround] (s.u.) nötig, falls beim Löschen des Caches Fehlermeldungen wie diese auftreten:

''Flow requires the PHP setting "magic_quotes_gpc" set to Off. (Error #1224003190)''

=== Migration der Doctrine-Datenbank ===

./flow core:migrate
./flow doctrine:migrationgenerate
./flow doctrine:migrate

=== Setzen eines Flow-Kontextes ===

Das '''Kommandozeilentool flow''' arbeitet ohne weitere Angabe '''standardmäßig im Development-Kontext'''.

Ein anderer Kontext muss dem Kommandozeilentool flow explizit mitgegeben werden (z.B. "Production"):

FLOW_CONTEXT=Production ./flow ''...weitere Parameter...''

Alternativ kann man den Kontext auch über '''Umgebungsvariablen der Kommandozeile''' definieren:

Bei einem '''eigenen Apache-Server''' wird der Production-Kontext normalerweise wiefolgt konfiguriert:

SetEnv FLOW_CONTEXT Production

Im '''Shared Hosting''' ist dies nicht möglich. Stattdessen wird der Kontext über den '''putenv-Befehl''' in einem PHP-Skript gesetzt:

putenv ("FLOW_CONTEXT=Production");

=== Workaround falls Einstellungen einer eigenen php-cli.ini nicht von Flow berücksichtigt werden ===

Abändern der Shebang-Zeile des Skriptes "flow" innerhalb des Verzeichnisses "TYPO3-Neos" in:
#!/usr/bin/php '''-c/home/doms/example.org/php-cli.ini'''

'''Detaillierte Erklärung:''' Bei Debian darf die Shebang Zeile nur 127 Zeichen (byte) lang sein und maximal 1 Leerzeichen enthalten. Es hängt dann vom Binary ab, ob es das darüber hinaus "am Stück" und ohne weitere Leerzeichen Übergebene versteht. PHP kann es offensichtlich nicht.
Die Lösung besteht darin, die nötigen PHP-Direktiven in einer eigenen php-cli.ini abzulegen und diese durch Anhängen des Parameters -c an die Shebang-Zeile dem PHP-CLI-binary mitzugeben.

Die besondere Feinheit ist dabei allerdings, zwischen -c und dem Pfad kein Leerzeichen zu lassen und den Pfad auch nicht in Anführungszeichen einzuschließen, sondern direkt mit /pfad/zur/php-cli.ini anzuschließen!

'''Eine entsprechende php-cli.ini muss natürlich angelegt worden sein. Dies könnte beispielsweise eine Kopie der php.ini sein oder ein Symlink dorthin.'''

=== Prüfen, welche Paketversionen installiert sind ===

Mit composer kann man auf der Kommandozeile prüfen, welchen Versionsstand die installierten Pakete haben:

composer show -i

Mehr Details unter http://getcomposer.org/doc/03-cli.md#show

== Fehlerbehebung während und nach der Installation ==

=== Fehlermeldung im Webserverlog - File does not exist: icons ===

Nach dem Aufruf des URL

http://www.example.org/

erscheint im Weblog des Apachen (siehe Datei des Paketadmins /home/pacs/xyz00/var/web.err) diese Fehlermeldung

File does not exist: /home/doms/example.org/htdocs/icons, referer [...]

==== Lösung ====

'''''TODO: Lösung beschreiben'''''

=== Fehlermeldung im Webserverlog - File does not exist: favicon.ico ===

Nach dem Aufruf des URL

http://www.example.org/

erscheint im Weblog des Apachen (siehe Datei des Paketadmins /home/pacs/xyz00/var/web.err) diese Fehlermeldung

File does not exist: /home/doms/example.org/htdocs/favicon.ico, referer [...]

==== Lösung ====

Es muss eine Datei namens favicon.ico in das Webroot der Neos-Installation gelegt werden.

=== Fehlermeldung im Webserverlog - Options not allowed here ===

Nach dem Aufruf des URL

http://www.example.org/

erscheint im Weblog des Apachen (siehe Datei des Paketadmins /home/pacs/xyz00/var/web.err) diese Fehlermeldung

/home/doms/example.org/htdocs/TYPO3-Neos/Web/.htaccess: Options not allowed here, referer [...]

==== Lösung ====

Siehe Konfigurationsschritt '''''TODO: Referenz verankern'''''

=== Fehlermeldung bei Aufruf von example.org (ohne vorangestelltes www) ===

Ruft man den URL http://example.org (= ohne vorangestelltes "www") auf, so erhält man folgende Fehlermeldung im Browser
Exception while rendering
page<TYPO3.Neos:Page>/
body<TYPO3.TypoScript:Template>/
parts/
mainMenu:
Invalid paths: path of starting point must first part of end point path.

==== Lösung ====

Dieser Fehler wird mit Lösungsvorschlägen auch hier beschrieben:

[http://forum.typo3.org/index.php/t/200456/ http://forum.typo3.org/index.php/t/200456/]

=== Fehlermeldung bei Aufruf von www.example.org ===

Ruft man den URL http://www.example.org auf, so erhält man folgende Fehlermeldung im Browser
Exception while rendering
landingPage:
No "landingPage" TypoScript object found. Please make sure to define one in your TypoScript configuration. (20131223204230d197e0)

==== Lösung ====

Dieser Fehler wird mit Lösungsvorschlägen auch hier beschrieben:

[http://forum.typo3.org/index.php/t/200456/ http://forum.typo3.org/index.php/t/200456/]

== Installation mit eigenem Serverdienst/root-Server ==

Für die Installation mit der Option "Eigener Serverdienst" sind '''zusätzlich''' weitere Schritte notwendig bzw. empfehlenswert.

Die in den folgenden Abschnitten beschriebenen Konfigurationen sind im Falle eines Shared Hosting Paketes '''nicht''' erforderlich!

=== Optional: Virtuellen Host einrichten ===

Das Neos Kompendium empfiehlt die Einrichtung eines eigenen virtuellen Hosts in seiner Apache-Konfiguration.
Dies ist bei Hostsharing nur dann manuell erforderlich wenn ein Rootserver gebucht wurde oder auf einem lokalen Apache (kostenpflichtige Option "Betrieb eines eigenen Serverdienstes") entwickelt wird.

==== Notwendigkeit der Paket-Option "Betrieb eines eigenen Serverdienstes" ====

Mit der Paket-Option "Betrieb eines eigenen Serverdienstes" lässt sich ein eigener Apache (oder nginx, oder ...) betreiben und nach eigenen Vorstellungen frei konfigurieren. Dies ist allerdings nur erforderlich wenn

# TYPO3 Neos mit der Hostsharing Standard-Konfiguration nicht funktioniert oder
# die Performance von PHP über FastCGI für eine Seite mit hohem Traffic nicht ausreicht.

Die Installation eines eigenen Apache ist im HS-Wiki unter [[Apache_installieren|Apache installieren]] beschrieben.

==== Ohne Paket-Option "Betrieb eines eigenen Serverdienstes" ====

Auf Hostsharing Systemen läuft für die Shared Hosting Pakete ein zentraler Apache, der standardmäßig die Anfragen für die in den Paketen aufgeschalteten Domains verarbeitet und die Webseiten ausliefert.

Durch ein zentrales Template wird für jede aufgeschaltete Domain im Apache automatisch (von hsadmin) ein Virtual Host eingerichtet. Die Konfiguration lässt sich lediglich durch einige der [https://wiki.hostsharing.net/index.php?title=Hsadmin/Domainoptionen HSAdmin-Domain-Options] beeinflussen.

==== Zentrales Template des Virtual Hosts für Shared Hosting Pakete ====

Als Template-"Sprache" kommt [http://velocity.apache.org/ velocity] zum Einsatz.
Template des Virtual Hosts so wie es beim Apachen über PHP via FastCGI bei HS betrieben wird:

TODO: Hier Template des Virtual Hosts einfügen

=== Dateirechte für TYPO3 Flow setzen ===

Zum Setzen der benötigten Dateirechte gibt man diese Befehlsfolge in die Konsole ein:

cd /home/doms/example.org/TYPO3-Neos
sudo ./flow flow:core:setfilepermissions <shelluser> <wwwuser> <wwwgroup>

'''wobei:'''

<shelluser> ::= User mit dem man in der Konsole eingeloggt ist (Befehl "whoami" eingeben; bei Hostsharing ist dies der Paketadmin der Form '''xyz00''' oder ein User der Form '''xyz00-username''')

<wwwuser> ::= User, unter dem der Webserver läuft (steht in der Datei httpd.conf; bei Hostsharing ist dies für Shared Hosting Pakete (PHP via FastCGI) der Domain-User der Form '''xyz00-username''' '''''TODO: Prüfen!''''')

<wwwgroup> ::= Gruppe, unter der der Webserver läuft (steht in der Datei httpd.conf; bei Hostsharing ist dies für Shared Hosting Pakete (PHP via FastCGI) die Gruppe des Paketes (zu dem die Domain gehört) der Form '''xyz00''' '''''TODO: Prüfen!''''')

Siehe auch: [http://docs.typo3.org/flow/TYPO3FlowDocumentation/TheDefinitiveGuide/PartII/Installation.html#file-permissions Weitergehende Informationen zum Setzen der Dateirechte für TYPO3 Neos]

'''''TODO: Hier entsprechende Ergänzungen für "non-Shared Hosting" machen...'''''

== Weiterführende Links ==

http://neos.typo3.org/

http://docs.typo3.org/neos/TYPO3NeosDocumentation/Appendixes/ChangeLogs/101.html

https://twitter.com/TYPO3Neos

[[Kategorie:HSDoku]]
[[Kategorie:Installationsanleitungen]]
[[Kategorie:Software]]

TYPO3 Neos installieren

2017-08-11T12:44:24Z

Hsh-michaelhierweck: Composer ist vorinstalliert.

{{Baustelle}}

Teile der Installation von TYPO3 Neos sind aus dem [http://www.typovision.de/fileadmin/slides/TYPO3-Neos-Das-Kompendium-Patrick-Lobacher-typovision-20130818.pdf Neos-Kompendium] von Patrick Lobacher (Typovision GmbH) entnommen und wurden auf die Besonderheiten bei Hostsharing angepasst.

Beschrieben wird hier in erster Linie die Installation in einem Shared Hosting Paket. Auf Hostsharing Systemen läuft für die Shared Hosting Pakete ein zentraler Apache, der standardmäßig die Anfragen für die in den Paketen aufgeschalteten Domains verarbeitet und die Webseiten ausliefert. Durch ein zentrales Template wird für jede aufgeschaltete Domain im Apache automatisch (von hsadmin) ein Virtual Host eingerichtet. Die Konfiguration lässt sich lediglich durch einige der [https://wiki.hostsharing.net/index.php?title=Hsadmin/Domainoptionen HSAdmin-Domain-Options] beeinflussen.

'''''TODO: Andere Installationsarten (eigener Serverdienst, root-Server) sind am Ende des Artikels beschrieben.'''''

== Systemvoraussetzungen ==

Das TYPO3 Neos Kompendium nennt die folgenden Systemvoraussetzungen.
Bei Hostsharing erfüllen alle Shared Hosting Pakete im '''Auslieferungszustand''' diese Systemvoraussetzungen mit wenigen notwendigen manuellen Nacharbeiten:

*''' Webserver (empfohlen ist Apache 2.x mit aktiviertem [[mod_rewrite]] Modul) = HS Shared Hosting default'''
* [[PHP]] 5.3.7 - 5.4.x (minimal wäre PHP 5.3.2 - dort kann es zu Problemen kommen)
*''' Folgende Funktionen müssen in PHP aktiviert sein (= HS Shared Hosting default):'''
**''' system()'''
**''' shell_exec()'''
**''' escapeshellcmd()'''
**''' escapeshellarg()'''
**''' proc_open()'''
**''' exec()'''
* [[PHP#Anpassung_der_PHP_Grundkonfiguration|php.ini]]: memory_limit = 256M oder höher
* [[PHP#Anpassung_der_PHP_Grundkonfiguration|php.ini]]: xdebug.max_nesting_level = 500 (sofern xdebug verwendet wird)
* [[PHP#Anpassung_der_PHP_Grundkonfiguration|php.ini]]: Fügen sie die folgende Optionen ans Ende hinzu: detect_unicode = Off
* [[PHP#Anpassung_der_PHP_Grundkonfiguration|php.ini]]: Zudem muss Magic_Quotes ausgeschaltet werden: magic_quotes_gpc = Off
* [[PHP#Anpassung_der_PHP_Grundkonfiguration|php.ini]]: Die Kommandozeile von Flow benötigt ferner noch eine Zeitzoneneinstellung: date.timezone= "Europe/Berlin"
*''' [[MySQL]] 5.1.50 - 5.x.x (zum Beispiel - grundsätzlich kann jede zum Doctrine DBAL kompatible Datenbank verwendet werden) = HS Shared Hosting default'''
*''' [[Login_mit_SSH|Zugang zur Konsole]] (shell-User) = HS Shared Hosting default'''

=== Bemerkung zu bereitstehenden PHP Versionen ===

Die PHP-Kommandozeilenversion (PHP-CLI) erfüllt die geforderte Versionsnummer von 5.3.7: Installiert ist PHP 5.4.4-14+deb7u11 (cli)

Die Versionsnummer von PHP-CLI kann mit dem folgenden Befehl in der Kommandozeile überprüft werden:

php --version

=== Umsetzung der Einstellungen für php.ini ===

Die php.ini für PHP via FastCGI muss in diesem Verzeichnis liegen:
/home/doms/example.org/fastcgi
(existiert dort keine php.ini, kann sie manuell leer angelegt werden und anschließend mit einem Editor (z.B. nano) bearbeitet werden):

touch php.ini
nano php.ini

Alternativ kann man auch eine Muster-php.ini dorthin kopieren. Siehe hierzu: [[PHP#Beispiel_muster.example.com|Beispiel muster.example.com]]

Die nötigen Einstellungen für TYPO3 Neos hier gesammelt als Block für copy&paste an das Ende der php.ini

memory_limit = 256M ; default ist 128M
xdebug.max_nesting_level = 500 ; Einkommentieren sofern xdebug verwendet wird
detect_unicode = Off
date.timezone = "Europe/Berlin"
magic_quotes_gpc = Off

Zum Erzwingen einer direkten Übernahme der Änderungen an der php.ini bei FastCGI müssen die PHP Prozesse des Users neu gestartet werden. Es ist im Folgenden keine Ersetzung von $USER nötig:

killall php -u $USER

== Notwendige Schritte zur Installation ==

Es ist nicht erforderlich TYPO3 CMS zu installieren, da TYPO3 CMS und TYPO3 Neos keinerlei technische Gemeinsamkeiten besitzen.

Die Installation besteht im Wesentlichen aus diesen Schritten:

# [[TYPO3_Neos_installieren#Composer_herunterladen_und_installieren|Composer herunterladen und installieren]]
# [[TYPO3_Neos_installieren#TYPO3_Neos_und_Abh.C3.A4ngigkeiten_herunterladen_und_installieren|TYPO3 Neos und Abhängigkeiten herunterladen, installieren]]
# [[TYPO3_Neos_installieren#Inhalte_des_Verzeichnisses_Web_in_DocumentRoot_kopieren|Inhalte des Verzeichnisses Web in DocumentRoot kopieren]]
# [[TYPO3_Neos_installieren#Anpassen_der_.htaccess-Datei|Anpassen der .htaccess-Datei]]
# [[TYPO3_Neos_installieren#Anpassen_der_index.php-Datei|Anpassen der index.php-Datei]]
# [[TYPO3_Neos_installieren#TYPO3_Flow_Konfiguration:_Datenbank-Setup|FLOW Konfiguration: Datenbank-Setup]]
# [[TYPO3_Neos_installieren#TYPO3_Flow_Konfiguration:_PHP-Umgebung|FLOW Konfiguration: PHP-Umgebung]]
# [[TYPO3_Neos_installieren#TYPO3_Neos_Setup|TYPO3 Neos Setup]]

== TYPO3 Neos und Abhängigkeiten herunterladen und installieren ==

Composer sorgt für das Herunterladen von TYPO3 Neos und TYPO3 Flow mitsamt der benötigten Module (z.B. Doctrine 2, Aloha, ...). Hierzu ist dieser Befehl nötig (alles in einer Zeile):

composer create-project typo3/neos-base-distribution /home/doms/example.org/TYPO3-Neos

Während der Installation erscheinen mehrere dieser Warnungen:

''Class TYPO3\Flow\Composer\InstallerScripts is not autoloadable, can not call post-package-install script''

'''Diese Warnungen können ignoriert werden''', siehe http://forum.typo3.org/index.php/t/200300/

Wird die VCS-Historie (Version Control System, Versionsverwaltung) nicht benötigt, kann man die folgende Frage mit "Y" bestätigen:

Do you want to remove the existing VCS (.git, .svn..) history? [Y,n]?

Nun existiert ein Verzeichnis TYPO3-Neos (etwa 200 MB) im Webroot unter

/home/doms/example.org/TYPO3-Neos

Dieses Verzeichnis enthält alle Dateien von TYPO3 Neos.

Anschließend sollte composer alle Pakete nochmal auf verfügbare Updates prüfen und diese dann auch installieren:

cd /home/doms/example.org/TYPO3-Neos/
'''composer update'''

=== Inhalte des Verzeichnisses Web in DocumentRoot kopieren ===

Der Installationsordner TYPO3-Neos liegt oberhalb des DocumentRoot. Damit der Webserver dennoch auf die Installation zugreifen kann, muss man nun den Inhalt des Verzeichnisses /home/doms/example.org/TYPO3-Neos/Web in das Verzeichnis /home/doms/example.org/htdocs kopieren:

cp /home/doms/example.org/TYPO3-Neos/Web * /home/doms/example.org/htdocs

=== Anpassen der .htaccess-Datei ===

Die .htaccess-Datei im Pfad

/home/doms/example.org/htdocs

muss im folgenden Absatz für die Umgebungsvariable '''FLOW_ROOTPATH''' mit dem Pfad zu TYPO3 Flow versehen werden:

# If the root path is not the parent of the Web directory,
# TYPO3 Flow's root path must be specified manually:
# SetEnv FLOW_ROOTPATH /var/www/myapp/
'''SetEnv FLOW_ROOTPATH /home/doms/example.org/TYPO3-Neos/'''

Weiterhin ist die Anpassung dieses Absatzes nötig

# You will have to change the path in the following option if you
# experience problems while your installation is located in a subdirectory
# of the website root.
# RewriteBase /TYPO3-Neos/Web/
'''RewriteBase /'''

Bei Hostsharing ist die Webserver-Option "MultiViews" per default ausgeschaltet. Im Shared Hosting kann man zudem - abgesehen von [https://wiki.hostsharing.net/index.php?title=Hsadmin/Domainoptionen HSAdmin-Domain-Options] - keine eigenen Webserver-Optionen nutzen. Die Angabe der Option -MultiViews in der .htaccess-Datei würde zu einem Fehler im Weblog führen! Daher ist im folgenden Abschnitt eine Zeile auzukommentieren:

# prevents Apache's automatic file negotiation, it breaks resource URLs
'''#Options -MultiViews'''

=== Anpassen der index.php-Datei ===

Die Datei index.php im Pfad

/home/doms/example.org/htdocs

muss zu Beginn (Zeilen 2 und 3 direkt nach Zeile "<?php") mit den Umgebungsvariablen '''FLOW_REWRITEURLS''' und '''FLOW_CONTEXT''' versehen werden:

<?php
'''putenv ("FLOW_REWRITEURLS=1");'''
'''putenv ("FLOW_CONTEXT=Production");'''
/*
* This script belongs to the TYPO3 Flow framework. *

'''Anmerkung:'''

Die Verwendung der Umgebungsvariable '''FLOW_REWRITEURLS=1''' ist nötig, da es sonst zu einem Problem führt, dass bei Hostsharing '''Apache mit SuExec''' betrieben wird. '''''(TODO: Nicht 100% sicher, ob dies bei Hostsharing nötig ist...)'''''

Genauere Beschreibung: http://forge.typo3.org/issues/54451

=== TYPO3 Flow Konfiguration: Datenbank-Setup ===

Eine Datenbank (z.B. MySQL) und einen entsprechenden user sollte man sich zuvor schon per [[HSAdmin]] leer angelegt haben.

Das browserbasierte Setup bricht mit einem Fehler ab, sofern nicht die Datenbankeinstellungen in der Datei Settings.yaml angepasst wurden:

cd /home/doms/example.org/TYPO3-Neos/Configuration
cp Settings.yaml.example Settings.yaml
nano Settings.yaml

Folgende Einstellungen müssen vorgenommen werden

TYPO3:
Flow:
persistence:
# It is good practice to not specify user name and password of the database
# connection in this global Settings.yaml file. Rather specify them in the
# settings of the respective context (Production / Development ...).
backendOptions:
driver: 'pdo_mysql' # Datenbanktyp (DB-Treiber)
dbname: 'DBNAME' # an DB-Namen anpassen
user: 'DBUSER' # an DB-User anpassen
password: 'PASSWORT' # an DB-Passwort anpassen
host: 'localhost' # an DB-Host anpassen (bei HS: localhost)

'''Die Einzüge von exakt 2 Leerzeichen pro Ebene gehören zum Syntax! Siehe auch:''' [http://docs.typo3.org/flow/TYPO3FlowDocumentation/Quickstart/Index.html#database-setup Details zum DB-Setup für Flow]

[http://docs.typo3.org/flow/TYPO3FlowDocumentation/TheDefinitiveGuide/PartII/Installation.html Dokumentation zur Installation von Flow]

[http://docs.typo3.org/flow/TYPO3FlowDocumentation/TheDefinitiveGuide/PartIII/Configuration.html Dokumentation zur Konfiguration von Flow]

=== TYPO3 Flow Konfiguration: PHP-Umgebung ===

Die Datei Settings.yaml muss erneut angepasst werden:

cd /home/doms/example.org/TYPO3-Neos/Configuration
cp Settings.yaml.example Settings.yaml
nano Settings.yaml

Folgende Einstellungen müssen vorgenommen werden

TYPO3:
Flow:
core:
# Path and filename of the PHP binary
# The constant PHP_BINDIR usually contains the path, but on Windows this doesn't work reliably
phpBinaryPathAndFilename: '/usr/bin/php'
######################################################################################
# Set which php.ini file should be used for the CLI sub requests.
# If not set (that is value equals NULL) the php.ini file of the executing process (usually the web server's) is used.
# If set to a path and filename, the specified php.ini file is loaded.
# If set to boolean FALSE, Flow does not try to specify any php.ini file to the sub process.
subRequestPhpIniPathAndFilename: '/home/doms/example.org/php-cli.ini'

'''Die Einzüge von exakt 2 Leerzeichen pro Ebene gehören zum Syntax! Siehe auch:''' [http://docs.typo3.org/flow/TYPO3FlowDocumentation/Quickstart/Index.html#database-setup Details zum DB-Setup für Flow]

== TYPO3 Neos Setup ==

Die Setup-Routine von TYPO3 Neos läuft menügeführt über einen Browser ab. Der URL zum Aufruf lautet:

http://example.org/setup/

=== Setup-Passwort ===
Eine Passwortabfrage schützt die Setup-Routine. Das benötigte initiale Passwort wird beim Starten der Setup-Routine in einer temporären Textdatei auf dem Webserver gespeichert. Diese Datei kann man nur über die Konsole öffnen. Der Pfad zum Ablageort der Datei wird im Bildschirmdialog angezeigt:

Initial Password: The initial password for accessing the setup can be found in the file
/home/pacs/xyz00/users/username/doms/example.org/TYPO3-Neos/Data/SetupPassword.txt

==== Wiederherstellung des Setup-Passwortes ====

Nach der erstmaligen Eingabe des Setup-Passwortes wird die temporäre Textdatei in der es enthalten ist gelöscht.
Hat man das Passwort vergessen, muss man für ein weiteres Aufrufen des Setups die Datei SetupKey löschen:

rm /home/doms/example.org/TYPO3-Neos/Data/Persistent/FileBasedSimpleKeyService/SetupKey

und anschließend die Setup-Routine wie oben beschrieben erneut aufrufen.

=== Administrator anlegen ===

Das Anlegen des Administrators wird per GUI-Backend erledigt.

Weitere User lassen sich nach der Installation in der Userverwaltung des GUI-Backends ergänzen.

Alternativ lassen sich User auch in der Konsole anlegen per:

cd /home/doms/example.org/TYPO3-Neos/
./flow typo3.neos:user:create <Username> <Passwort> <Vorname> <Nachname>

(Achtung: Das so eingegebene Passwort könnte im Freitext lesbar in der Prozessliste und logdateien auftauchen! '''''TODO: Prüfen!''''')

Die Adminrolle lässt sich einem User ebenfalls in der Konsole vergeben:

cd /home/doms/example.org/TYPO3-Neos/
./flow typo3.neos:user:addrole <Username> Administrator

=== Abschluss des Setups ===

Zum Schluss kann man entweder eine Demo-Site importieren oder unter Angabe eines "Package Name" und eines "Site Name" eine leere Webseite anlegen lassen.

==== Site mit Domain verknüpfen ====

Im TYPO3 Neos Backend sollte zunächst die neu angelegte Site mit einer Domain verknüpft werden. Dies wird im "Sites Management" erledigt:

Klickpfad dorthin: '''3 waagerechte weiße Streifen''' (oben links) -> "'''Sites Management'''"

In der Zeile mit der Site das '''Bleistift-Symbol''' anklicken -> rechte Seite "'''Add domain'''" (hellblauer Button) anklicken -> '''Domainname eintragen''' -> Radiobutton "'''Active'''" anklicken -> "'''Create'''" (hellblauer Button) anklicken

'''Save''' (hellblauer Button) anklicken

=== Weitere Einstellungen ===

==== URI Suffix ändern ====

Das URI-Suffix ist standardmäßig auf ".html" eingestellt. Man kann dieses Suffix zentral ändern und auch ganz entfernen:

nano /home/doms/example.org/TYPO3-Neos/Configuration/Routes.yaml

Der Eintrag für defaultUriSuffix kann hierzu geändert werden:

# TYPO3 Neos subroutes
-
name: 'TYPO3 Neos'
uriPattern: '<TYPO3NeosSubroutes>'
subRoutes:
'TYPO3NeosSubroutes':
package: 'TYPO3.Neos'
variables:
'defaultUriSuffix': <nowiki>''</nowiki>

'''Die Einzüge von exakt 2 Leerzeichen pro Ebene gehören zum Syntax! Siehe auch:''' [http://docs.typo3.org/flow/TYPO3FlowDocumentation/Quickstart/Index.html#database-setup Details zum DB-Setup für Flow]

Anschließend müssen die [https://wiki.hostsharing.net/index.php?title=TYPO3_Neos_installieren#Cache_eines_TYPO3_Flow-Kontextes_l.C3.B6schen Caches der Flow-Kontexte gelöscht werden].

Quelle: https://review.typo3.org/#/c/25746

== Zugang zur Installation ==

Nach erfolgreichem Abschluss des Setups sind die zentralen Elemente von TYPO3 Neos über einen Browser erreichbar:

'''Setup:''' http://example.org/setup/

'''Frontend:''' http://example.org/

'''Backend:''' http://example.org/neos/

== Wichtige Pfade und Dateien ==

{| class="wikitable"
|-
| '''Pfad''' (mit Präfix /home/doms/example.org/TYPO3-Neos/)
| '''Beschreibung des Inhalts'''
|-
| Configuration/Settings.yaml
| '''Konfigurationsdatei für TYPO3 Flow''' (u.a. für Datenbank-Zugangsdaten)
|-
| Data/Logs/Security_Development.log
| Logdatei analog zu '''Security.log''' (s.u.), allerdings für den '''Development-Kontext'''.
|-
| Data/Logs/Security.log
| Logdatei, die '''Loginversuche im Production-Kontext''' protokolliert.
|-
| Data/Logs/System_Development.log
| Logdatei analog zu '''System.log''' (s.u.), allerdings für den '''Development-Kontext'''.
|-
| Data/Logs/Sytem.log
| '''System-Logdatei im Production-Kontext''' (enthält auch Hinweise auf Fehler oder Exceptions, siehe "CRITICAL").
|-
| Data/Logs/Exceptions/
| Zu jeder '''Fehlermeldung (Exception)''' liegt hier eine *.txt-Datei, die Tag und Uhrzeit im Dateinamen trägt. In den Textdateien findet man die Fehlermeldung und einen Trace.
|-
| Data/Persistent/FileBasedSimpleKeyService/SetupKey
| Datei, die gelöscht werden muss, falls man sein [https://wiki.hostsharing.net/index.php?title=TYPO3_Neos_installieren#Wiederherstellung_des_Setup-Passwortes '''Setup-Passwort vergessen'''] hat.
|-
| Packages/Application/TYPO3.Neos/Resources/Private/Templates/TypoScriptObjects/
| Ablageort für '''Fluid-Templates von TYPO3 Neos''' im Auslieferungszustand
|-
| Packages/Sites/Abc.Xyz/Configuration/
| '''Konfigurationsdateien des Paketes''' (= der Site)
|-
| Packages/Sites/Abc.Xyz/Configuration/NodeTypes.yaml
| Ablageort für '''eigene TYPO3-Flow Inhaltselemente'''
|-
| Packages/Sites/Abc.Xyz/Resources/Public
| Ablageort für alle '''öffentlich zugänglichen Dateien''' wie z.B. CSS- oder JS-Dateien
|-
| Packages/Sites/Abc.Xyz/Resources/Private
| Ablageort für alle internen Dateien
|-
| Packages/Sites/Abc.Xyz/Resources/Private/Templates/Page/Default.html
| '''Fluid-Template''' mit dem Default-Layout der Webseite; an den durch f:section-ViewHelper markierten Stellen rendert Neos Seiteninhalte in die Webseite hinein
|-
| Packages/Sites/Abc.Xyz/Resources/Private/Templates/TypoScriptObjects/
| Ablageort für alle eigenen TypoScript-Objekte
|-
| Packages/Sites/Abc.Xyz/Resources/Private/TypoScripts/Library/
| Ablageort für alle TypoScript-Dateien
|-
| Packages/Sites/Abc.Xyz/Resources/Private/TypoScripts/Library/Root.ts2
| Root-Template der gesamten Site; auch "main typoscript configuration"; Wird durch den site-kickstarter angelegt
|-
|}

== Upgrade von TYPO3 Neos... ==

Es kann entweder auf eine bestimmte Version aktualisiert werden oder auf die neueste Version (= "Development Master").

'''In beiden Fällen''' müssen anschließend die [https://wiki.hostsharing.net/index.php?title=TYPO3_Neos_installieren#Cache_eines_TYPO3_Flow-Kontextes_l.C3.B6schen Caches der Flow-Kontexte gelöscht werden] und eine [https://wiki.hostsharing.net/index.php?title=TYPO3_Neos_installieren#Migration_der_Doctrine-Datenbank Migration der Doctrine-Datenbank] durchgeführt werden.

Vor jedem Update sollte man prüfen, ob composer selbst ein Update benötigt:

composer self-update

=== ...auf eine bestimmte TYPO3 Neos Version ===

(Statt <version> z.B. 1.0.*)

cd /home/doms/example.org/TYPO3-Neos/
composer require "typo3/neos:<version>"
composer require "typo3/neos-nodetypes:<version>"
composer require "typo3/neosdemotypo3org:<version>"
composer require "typo3/sitekickstarter:<version>"

=== ...auf den Development Master (neueste Version) ===

'''Einmalig''' ist zuvor in der composer.json (siehe TYPO3-Neos Rootverzeichnis) statt "1.0.*" der Eintrag "dev-master" zu hinterlegen:

cd /home/doms/example.org/TYPO3-Neos/
nano composer.json

dort sind die vorhandenen Einträge wiefolgt zu ändern (Die Leerzeichen zu Beginn sind wichtig, da sie zum Syntax gehören!):

"require": {
"typo3/neos": "dev-master",
"typo3/neos-nodetypes": "dev-master",
"typo3/neosdemotypo3org": "dev-master",
"typo3/neos-kickstarter": "dev-master",
"doctrine/migrations": "@dev"
}

Anschließend kann das Update jedes Mal durch composer angestoßen werden:

cd /home/doms/example.org/TYPO3-Neos/
composer update

=== Cache eines TYPO3 Flow-Kontextes löschen ===

Jeder der drei Flow-Kontexte (Development, Testing und Production) besitzt einen eigenen Cache, der separat gelöscht werden kann.

Löschen des Standard-Flow-CLI-Kontextes "Development":

cd /home/doms/example.org/TYPO3-Neos/
./flow flow:cache:flush --force

Ein anderer Kontext muss dem Kommandozeilentool flow explizit mitgegeben werden [https://wiki.hostsharing.net/index.php?title=TYPO3_Neos_installieren#Setzen_eines_Flow-Kontextes Setzen eines Flow Kontextes] (s.u.).

Es ist ein [https://wiki.hostsharing.net/index.php?title=TYPO3_Neos_installieren#Workaround_falls_Einstellungen_einer_eigenen_php-cli.ini_nicht_von_Flow_ber.C3.BCcksichtigt_werden Workaround] (s.u.) nötig, falls beim Löschen des Caches Fehlermeldungen wie diese auftreten:

''Flow requires the PHP setting "magic_quotes_gpc" set to Off. (Error #1224003190)''

=== Migration der Doctrine-Datenbank ===

./flow core:migrate
./flow doctrine:migrationgenerate
./flow doctrine:migrate

=== Setzen eines Flow-Kontextes ===

Das '''Kommandozeilentool flow''' arbeitet ohne weitere Angabe '''standardmäßig im Development-Kontext'''.

Ein anderer Kontext muss dem Kommandozeilentool flow explizit mitgegeben werden (z.B. "Production"):

FLOW_CONTEXT=Production ./flow ''...weitere Parameter...''

Alternativ kann man den Kontext auch über '''Umgebungsvariablen der Kommandozeile''' definieren:

Bei einem '''eigenen Apache-Server''' wird der Production-Kontext normalerweise wiefolgt konfiguriert:

SetEnv FLOW_CONTEXT Production

Im '''Shared Hosting''' ist dies nicht möglich. Stattdessen wird der Kontext über den '''putenv-Befehl''' in einem PHP-Skript gesetzt:

putenv ("FLOW_CONTEXT=Production");

=== Workaround falls Einstellungen einer eigenen php-cli.ini nicht von Flow berücksichtigt werden ===

Abändern der Shebang-Zeile des Skriptes "flow" innerhalb des Verzeichnisses "TYPO3-Neos" in:
#!/usr/bin/php '''-c/home/doms/example.org/php-cli.ini'''

'''Detaillierte Erklärung:''' Bei Debian darf die Shebang Zeile nur 127 Zeichen (byte) lang sein und maximal 1 Leerzeichen enthalten. Es hängt dann vom Binary ab, ob es das darüber hinaus "am Stück" und ohne weitere Leerzeichen Übergebene versteht. PHP kann es offensichtlich nicht.
Die Lösung besteht darin, die nötigen PHP-Direktiven in einer eigenen php-cli.ini abzulegen und diese durch Anhängen des Parameters -c an die Shebang-Zeile dem PHP-CLI-binary mitzugeben.

Die besondere Feinheit ist dabei allerdings, zwischen -c und dem Pfad kein Leerzeichen zu lassen und den Pfad auch nicht in Anführungszeichen einzuschließen, sondern direkt mit /pfad/zur/php-cli.ini anzuschließen!

'''Eine entsprechende php-cli.ini muss natürlich angelegt worden sein. Dies könnte beispielsweise eine Kopie der php.ini sein oder ein Symlink dorthin.'''

=== Prüfen, welche Paketversionen installiert sind ===

Mit composer kann man auf der Kommandozeile prüfen, welchen Versionsstand die installierten Pakete haben:

composer show -i

Mehr Details unter http://getcomposer.org/doc/03-cli.md#show

== Fehlerbehebung während und nach der Installation ==

=== Fehlermeldung im Webserverlog - File does not exist: icons ===

Nach dem Aufruf des URL

http://www.example.org/

erscheint im Weblog des Apachen (siehe Datei des Paketadmins /home/pacs/xyz00/var/web.err) diese Fehlermeldung

File does not exist: /home/doms/example.org/htdocs/icons, referer [...]

==== Lösung ====

'''''TODO: Lösung beschreiben'''''

=== Fehlermeldung im Webserverlog - File does not exist: favicon.ico ===

Nach dem Aufruf des URL

http://www.example.org/

erscheint im Weblog des Apachen (siehe Datei des Paketadmins /home/pacs/xyz00/var/web.err) diese Fehlermeldung

File does not exist: /home/doms/example.org/htdocs/favicon.ico, referer [...]

==== Lösung ====

Es muss eine Datei namens favicon.ico in das Webroot der Neos-Installation gelegt werden.

=== Fehlermeldung im Webserverlog - Options not allowed here ===

Nach dem Aufruf des URL

http://www.example.org/

erscheint im Weblog des Apachen (siehe Datei des Paketadmins /home/pacs/xyz00/var/web.err) diese Fehlermeldung

/home/doms/example.org/htdocs/TYPO3-Neos/Web/.htaccess: Options not allowed here, referer [...]

==== Lösung ====

Siehe Konfigurationsschritt '''''TODO: Referenz verankern'''''

=== Fehlermeldung bei Aufruf von example.org (ohne vorangestelltes www) ===

Ruft man den URL http://example.org (= ohne vorangestelltes "www") auf, so erhält man folgende Fehlermeldung im Browser
Exception while rendering
page<TYPO3.Neos:Page>/
body<TYPO3.TypoScript:Template>/
parts/
mainMenu:
Invalid paths: path of starting point must first part of end point path.

==== Lösung ====

Dieser Fehler wird mit Lösungsvorschlägen auch hier beschrieben:

[http://forum.typo3.org/index.php/t/200456/ http://forum.typo3.org/index.php/t/200456/]

=== Fehlermeldung bei Aufruf von www.example.org ===

Ruft man den URL http://www.example.org auf, so erhält man folgende Fehlermeldung im Browser
Exception while rendering
landingPage:
No "landingPage" TypoScript object found. Please make sure to define one in your TypoScript configuration. (20131223204230d197e0)

==== Lösung ====

Dieser Fehler wird mit Lösungsvorschlägen auch hier beschrieben:

[http://forum.typo3.org/index.php/t/200456/ http://forum.typo3.org/index.php/t/200456/]

== Installation mit eigenem Serverdienst/root-Server ==

Für die Installation mit der Option "Eigener Serverdienst" sind '''zusätzlich''' weitere Schritte notwendig bzw. empfehlenswert.

Die in den folgenden Abschnitten beschriebenen Konfigurationen sind im Falle eines Shared Hosting Paketes '''nicht''' erforderlich!

=== Optional: Virtuellen Host einrichten ===

Das Neos Kompendium empfiehlt die Einrichtung eines eigenen virtuellen Hosts in seiner Apache-Konfiguration.
Dies ist bei Hostsharing nur dann manuell erforderlich wenn ein Rootserver gebucht wurde oder auf einem lokalen Apache (kostenpflichtige Option "Betrieb eines eigenen Serverdienstes") entwickelt wird.

==== Notwendigkeit der Paket-Option "Betrieb eines eigenen Serverdienstes" ====

Mit der Paket-Option "Betrieb eines eigenen Serverdienstes" lässt sich ein eigener Apache (oder nginx, oder ...) betreiben und nach eigenen Vorstellungen frei konfigurieren. Dies ist allerdings nur erforderlich wenn

# TYPO3 Neos mit der Hostsharing Standard-Konfiguration nicht funktioniert oder
# die Performance von PHP über FastCGI für eine Seite mit hohem Traffic nicht ausreicht.

Die Installation eines eigenen Apache ist im HS-Wiki unter [[Apache_installieren|Apache installieren]] beschrieben.

==== Ohne Paket-Option "Betrieb eines eigenen Serverdienstes" ====

Auf Hostsharing Systemen läuft für die Shared Hosting Pakete ein zentraler Apache, der standardmäßig die Anfragen für die in den Paketen aufgeschalteten Domains verarbeitet und die Webseiten ausliefert.

Durch ein zentrales Template wird für jede aufgeschaltete Domain im Apache automatisch (von hsadmin) ein Virtual Host eingerichtet. Die Konfiguration lässt sich lediglich durch einige der [https://wiki.hostsharing.net/index.php?title=Hsadmin/Domainoptionen HSAdmin-Domain-Options] beeinflussen.

==== Zentrales Template des Virtual Hosts für Shared Hosting Pakete ====

Als Template-"Sprache" kommt [http://velocity.apache.org/ velocity] zum Einsatz.
Template des Virtual Hosts so wie es beim Apachen über PHP via FastCGI bei HS betrieben wird:

TODO: Hier Template des Virtual Hosts einfügen

=== Dateirechte für TYPO3 Flow setzen ===

Zum Setzen der benötigten Dateirechte gibt man diese Befehlsfolge in die Konsole ein:

cd /home/doms/example.org/TYPO3-Neos
sudo ./flow flow:core:setfilepermissions <shelluser> <wwwuser> <wwwgroup>

'''wobei:'''

<shelluser> ::= User mit dem man in der Konsole eingeloggt ist (Befehl "whoami" eingeben; bei Hostsharing ist dies der Paketadmin der Form '''xyz00''' oder ein User der Form '''xyz00-username''')

<wwwuser> ::= User, unter dem der Webserver läuft (steht in der Datei httpd.conf; bei Hostsharing ist dies für Shared Hosting Pakete (PHP via FastCGI) der Domain-User der Form '''xyz00-username''' '''''TODO: Prüfen!''''')

<wwwgroup> ::= Gruppe, unter der der Webserver läuft (steht in der Datei httpd.conf; bei Hostsharing ist dies für Shared Hosting Pakete (PHP via FastCGI) die Gruppe des Paketes (zu dem die Domain gehört) der Form '''xyz00''' '''''TODO: Prüfen!''''')

Siehe auch: [http://docs.typo3.org/flow/TYPO3FlowDocumentation/TheDefinitiveGuide/PartII/Installation.html#file-permissions Weitergehende Informationen zum Setzen der Dateirechte für TYPO3 Neos]

'''''TODO: Hier entsprechende Ergänzungen für "non-Shared Hosting" machen...'''''

== Weiterführende Links ==

http://neos.typo3.org/

http://docs.typo3.org/neos/TYPO3NeosDocumentation/Appendixes/ChangeLogs/101.html

https://twitter.com/TYPO3Neos

[[Kategorie:HSDoku]]
[[Kategorie:Installationsanleitungen]]
[[Kategorie:Software]]

Contao Installieren

2017-08-02T12:02:02Z

Hsh-michaelhierweck:

<pre>
0. HSAdmin
Domain-Admin, Domain(s), MySQL-Benutzer und -Datenbank anlegen

1. Shell:
$ mkdir contao
$ curl -sS https://getcomposer.org/installer | php
$ php composer.phar composer create-project --no-dev contao/managed-edition contao

2. Symlinken
DocumentRoot(s) nach contao/web symlinken

3. Installtool aufrufen
Installtool via /contao/install aufrufen
</pre>

Contao Installieren

2017-08-02T11:42:08Z

Hsh-michaelhierweck: Skizze

Diskussion:Etherpad Installieren

2017-07-28T06:09:23Z

Hsh-michaelhierweck: Die Seite wurde neu angelegt: „Bei der Installationsanleitung geht es offenbar um Etherpad Lite, während das ursprüngliche Etherpad auf Scala basiert. https://en.wikipedia.org/wiki/Etherpa…“

Bei der Installationsanleitung geht es offenbar um Etherpad Lite, während das ursprüngliche Etherpad auf Scala basiert.
https://en.wikipedia.org/wiki/Etherpad#Etherpad_Lite

Etherpad Lite unterstützt als Datenbank auch PostgreSQL.
https://github.com/ether/etherpad-lite/wiki/How-to-use-Etherpad-Lite-with-PostgreSQL

--[[Benutzer:Hsh-michaelhierweck|Hsh-michaelhierweck]] ([[Benutzer Diskussion:Hsh-michaelhierweck|Diskussion]]) 08:09, 28. Jul. 2017 (CEST)

Drupal installieren

2017-06-23T17:06:23Z

Hsh-michaelhierweck: Herunterladen und Auspacken vereinfacht

= Drupal bei HS =

== Vorbereitungen ==

In ''hsadmin'', zum Beispiel mit ''hsscript'':

''hsadmin''-Shell starten mit:

hsscript -u xyz00 -i
Password: ********

Dann nacheinander anlegen:

* Linux User als Domain-Administrator
* Subdomain ''drupal.hs-example.de''
* MySQL-User
* MySQL Datenbank

xyz00@hsadmin> user.add({set:{name:'xyz00-drupal',password:'geheim',comment:'Drupal CMS'}})
xyz00@hsadmin> domain.add({set:{name:'drupal.hs-example.de',user:'xyz00-drupal'}})
xyz00@hsadmin> mysqluser.add({set:{name:'xyz00_drupaluser',password:'geheim'}})
xyz00@hsadmin> mysqldb.add({set:{name:'xyz00_drupaldb',owner:'xyz00_drupaluser'}})

== Drupal installieren ==

Anmelden als Linux-User ''xyz00-drupal'':

ssh -l xyz00-drupal xyz00.hostsharing.net

Und dann Drupal herunterladen und in den Webspace entpacken:

cd doms/drupal.hs-example.de/htdocs
wget -O - https://ftp.drupal.org/files/projects/drupal-8.3.4.tar.gz |tar -xz

== Drupal für HS anpassen ==

cd doms/drupal.hs-example.de/htdocs
vi .htaccess

# If your site is running in a VirtualDocumentRoot at http://example.com/,
# uncomment the following line:
# RewriteBase /

wird zu

# If your site is running in a VirtualDocumentRoot at http://example.com/,
# uncomment the following line:
RewriteBase /

== Drupal konfigurieren ==

Im Browser auf die Seite
http://drupal.hs-example.de gehen und den Anweisungen folgen.

== Drupal template default für HS konfigurieren ==

cd sites/default/files/php/twig
chmod 644 .htaccess
vi .htaccess

in der Zeile 11 den Eintrag "-ExecCGI" löschen

Options -Indexes -ExecCGI -Includes -MultiViews

und dann noch eine .htaccess

cd ../..

chmod 644 .htaccess
vi .htaccess

in der Zeile 2 den Eintrag "-ExecCGI" löschen

Options -Indexes -ExecCGI -Includes -MultiViews

Seite im Browser neu Laden !

----
[[Kategorie:HSDoku]]
[[Kategorie:Installationsanleitungen]]
[[Kategorie:Software]]
[[Kategorie:Blog]]
[[Kategorie:CMS]]

TLS / SSL

2016-12-09T19:27:27Z

Hsh-michaelhierweck: StartSSL entfernt wg. unklarer Zukunft.

== SSL wird zu TLS ==

Transport Layer Security (TLS) ist eine Weiterentwicklung des Secure Socket Layers (SSL) durch die Internet Engineering Task Force (IETF), die das SSL-Protokoll 1999 in Transport Layer Security umbenannte. Der aktuelle Standard ist in RFC 5246 beschrieben und ist von 2008.

== Standardkonfiguration ==

Neu aufgeschaltete Domains haben standardmäßig für die Verzeichnisse htdocs, subs, cgi und fastcgi getrennte *-ssl Ordner. Damit sind SSL-Inhalte sauber und sicher von Nicht-SSL Inhalten getrennt.

Bei Domains, die schon vor der Einführung des SSL Features bestanden, sind die Verzeichnisse subs-ssl, cgi-ssl und fastcgi-ssl standardmäßig als symbolische Links auf die entsprechenden nicht-ssl Verzeichnisse angelegt worden. Diese Symlinks stellen die Kompatibilität mit der früheren SSL Option her. Damals gab es nur einen Ordner für http und https.

Wer SSL und Nicht-SSL nun sauber trennen möchte oder ganz andere Inhalte anbieten möchte kann die Symlinks löschen und durch Verzeichnisse ersetzen. Bei der Paketdomain ist dabei zu beachten, dass die Rechte neu angelegter Verzeichnisse noch anzupassen sind, wenn die SSL Verzeichnisse nicht für alle User zugänglich sein sollen.

Wer hingegen SSL und Nicht-SSL Seiten innerhalb eines Verzeichnisbaums verwalten möchte, kann umgekehrt die SSL Verzeichnisse löschen und (ggf. auch nur selektiv für einige Unterverzeichnisse) Symlinks auf die Nicht-SSL Verzeichnisse anlegen.

Die Symlinks erlauben es die Seiten sowohl mit als auch ohne SSL abzurufen. Konfigurations- bzw. Administrationsseiten z.B. lassen sich dadurch sehr einfach manuell auch per https:// erreichen.

Möchte man den Zugriff auf bestimmte Seiten nur mit SSL erlauben und automatisch auf SSL umschalten, muss dies noch durch entsprechende [[.htaccess]] Dateien für die betroffenen Verzeichnisse konfiguriert werden.

== Eigene SSL Zertifikate ==

=== Grundsätzliche Schritte um ein TLS / SSL Zertifikat zu bekommen ===

# es muss je aufgeschaltet (sub)Domain ein Zertifikat bereit gestellt werden
# es muss je eine example.com.key Datei erzeugt werden
# mit der example.com.key Datei wird die example.com.csr erstellt
# Die example.com.csr wird an die Zertifizierungstelle gesendet
# zurück bekommt man
## eine example.com.crt Datei
## ggf eine example.com.chain oder sub.class1.server.ca.pem Datei
# die example.com.crt, example.com.key und ggf die example.com.chain oder sub.class1.server.ca.pem Datei werden ins Paket ~/etc Verzeichnis kopiert
# zur Aktivierung info an service@hostsharing.net senden

=== per script Zertifikat erstellen ===

Möchte man, dass eine eigene Domain ohne Fehlermeldungen per SSL erreichbar ist, benötigt man ein eigenes Zertifikat von einer Zertifizierungsstelle, die von den Browsern standardmäßig anerkannt wird.

Zunächst muss man als Paket-Admin einen Private Key erzeugen und dann einen CSR (Certificate Signing Request - mit dem Private Key erzeugte Anforderung für ein Zertifikat). Wie das genau funktioniert, ist meistens von Seiten der Zertifizierungsstelle beschrieben.

Man kann aber auch ein kleines Skript nutzen, das Michael Hierweck aufgrund von einer Anleitung von Michaels Hönnig zur Erzeugung von Zertifikaten geschrieben hat:

<pre><nowiki>
#! /bin/sh

#Nur Zugriffe für den Owner erlauben
umask u=rwx,g=,o=

#Zertifikat erzeugen
openssl req -new -x509 -keyout ~/etc/cakey.pem -out ~/etc/careq.pem $*
openssl rsa <~/etc/cakey.pem >~/etc/https.new
cat ~/etc/careq.pem >>~/etc/https.new

#Temporäre Dateien löschen
rm ~/etc/cakey.pem
rm ~/etc/careq.pem

#Altes Zertifikat sichern
cp ~/etc/https.pem ~/etc/https.old
</nowiki></pre>

Es können weitere Parameter angeben werden, z.B. -days 370.

Die Domain oder Wildcard (*.domain.TLD) für die das Zertifikat gilt, wird auf die Frage als Common Name angegeben.

Anschließend wird der Zertifizierungsstelle der csr übermittelt. Die Datei, die man dann von der Zertifizierungsstelle erhält, muss in das Verzeichnis /etc des Paketadmins kopiert werden. Das neue Zertifikat muss dann noch manuell aktiviert werden, d.h. in https.pem umbenannt werden. Damit kann man dies zu einem beliebigen späteren Zeitpunkt tun und das Zertifikat vorher prüfen.

''' Per Auftrag an service@ muss um Aktivierung des neuen Zertifikats gebeten werden. '''

=== Automatisierte SSL-Zertifikate von Let’s Encrypt ===

Auf Github findet man die Buildout-Konfiguration für den Certbot, einen Installer / Updater für Let's Encrypt Zertifikate "userland-certbot". Mithilfe dieses Projekts von Michael Hierweck und Veit Schiele lassen sich
tatsächlich automatisiert Let's encrypt Zertifikate automatisiert installieren und erneuern. Hier wird beschrieben, wie man diese Konfiguration in einer Hostsharing-Umgebung einsetzen kann.
Dazu wird im Home-Verzeichnis des Domain-Admin eine virtuelle Python-Umgebung mit virtualenv erzeugt. In der Umgebung wird Buildout installiert und mit buildout lässt sich der Certbot installieren.
<pre>
xyz00-doms@myhive:~$ virtualenv certbot
Running virtualenv with interpreter /usr/bin/python2
New python executable in certbot/bin/python2
Also creating executable in certbot/bin/python
Installing setuptools, pip...done.

xyz00-doms@myhive:~$ cd certbot/
xyz00-doms@myhive:~/certbot$ . bin/activate
(certbot)xyz00-doms@myhive:~/certbot$
(certbot)xyz00-doms@myhive:~/certbot$ pip install zc.buildout
Downloading/unpacking zc.buildout
Downloading zc.buildout-2.5.2-py2.py3-none-any.whl (262kB): 262kB downloaded
Downloading/unpacking setuptools>=8.0 (from zc.buildout)
Downloading setuptools-25.2.0-py2.py3-none-any.whl (442kB): 442kB downloaded
Installing collected packages: zc.buildout, setuptools
Found existing installation: setuptools 5.5.1
Uninstalling setuptools:
Successfully uninstalled setuptools
Successfully installed zc.buildout setuptools
Cleaning up...

(certbot)xyz00-doms@myhive:~/certbot$ git clone https://github.com/veit/userland-certbot.git
Cloning into 'userland-certbot'...
remote: Counting objects: 55, done.
remote: Total 55 (delta 0), reused 0 (delta 0), pack-reused 55
Unpacking objects: 100% (55/55), done.
Checking connectivity... done.

(certbot)xyz00-doms@myhive:~/certbot$ cd userland-certbot/
(certbot)xyz00-doms@myhive:~/certbot/userland-certbot$ buildout
Creating directory '/home/pacs/xyz00/users/doms/certbot/userland-certbot/bin'.
Creating directory '/home/pacs/xyz00/users/doms/certbot/userland-certbot/parts'.
Creating directory '/home/pacs/xyz00/users/doms/certbot/userland-certbot/develop-eggs'.
Installing certbot.
Generated script '/home/pacs/xyz00/users/doms/certbot/userland-certbot/bin/certbot'.
Installing certbot-directories.
certbot-directories: created path: /home/pacs/xyz00/users/doms/certbot/userland-certbot/parts/certbot
certbot-directories: created path: /home/pacs/xyz00/users/doms/certbot/userland-certbot/parts/certbot/bin
certbot-directories: created path: /home/pacs/xyz00/users/doms/certbot/userland-certbot/parts/certbot/etc
certbot-directories: created path: /home/pacs/xyz00/users/doms/certbot/userland-certbot/parts/certbot/lib
certbot-directories: created path: /home/pacs/xyz00/users/doms/certbot/userland-certbot/parts/certbot/log
certbot-directories: created path: /home/pacs/xyz00/users/doms/certbot/userland-certbot/parts/certbot/web
Installing certbot-runner.
Installing certbot-crontab.
</pre>

Als nächstes muss man sich bei Let's Encrypt registrieren. Eine Kontakt-Adresse wird erfragt und man muss den Nutzungsbedingungen zustimmen. Dabei wird ein Let's Encrypt Konto erzeugt, dass die angegebene Email-Adresse mit der Certbot-Installation in Relation setzt.
Die Kontoinformationen werden im Verzeichnis /home/pacs/xyz00/users/doms/certbot/userland-certbot/parts/certbot/etc gespeichert und es wird empfohlen diese Daten zu sichern.

<pre>
(certbot)xyz00-doms@myhive:~/certbot/userland-certbot$ bin/certbot-register
Enter email address (used for urgent notices and lost key recovery) (Enter 'c'
to cancel):webmaster@example.org

-------------------------------------------------------------------------------
Please read the Terms of Service at
https://letsencrypt.org/documents/LE-SA-v1.1.1-August-1-2016.pdf. You must agree
in order to register with the ACME server at
https://acme-v01.api.letsencrypt.org/directory
-------------------------------------------------------------------------------
(A)gree/(C)ancel: A

IMPORTANT NOTES:
- If you lose your account credentials, you can recover through
e-mails sent to webmaster@example.org.
- Your account credentials have been saved in your Certbot
configuration directory at
/home/pacs/pxyz00/users/doms/certbot/userland-certbot/parts/certbot/etc.
You should make a secure backup of this folder now. This
configuration directory will also contain certificates and private
keys obtained by Certbot so making regular backups of this folder
is ideal.
</pre>

Der Certbot legt während der Zertifikatserstellung eine geheime Datei im Verzeichnis /home/pacs/xyz00/users/pronto/certbot/userland-certbot/parts/certbot/web/.well-known ab, die Let's Encrypt über den Webserver erreichen muss, um sicherzustellen,
dass der Domain-Admin die erforderlichen Berechtigungen hat. Im hier dokumentierten Fall wird das Standard-Setup bei Hostsharing, also der vorinstallierte Apache als Webserver genutzt.
Dazu wird ein Symlink zum obengenannten Verzeichnis im Apache Webverzeichnis angelegt. (Evtl. muss das Verzeichnis .well-known vorher angelegt werden.)

<pre>
(certbot)xyz00-doms@myhive:~/certbot/userland-certbot$ cd ~/doms/example.org/subs/www/
(certbot)xyz00-doms@myhive:~/doms/example.org/subs/www$ mkdir ~/certbot/userland-certbot/parts/certbot/web/.well-known
(certbot)xyz00-doms@myhive:~/doms/example.org/subs/www$ ln -s ~/certbot/userland-certbot/parts/certbot/web/.well-known .well-known
</pre>

Das Zertifikat wird folgendermaßen erzeugt. (Achtung: Hier sollten alle Domains des Domain-Admins angegeben werden, die evtl. abgesichert werden sollen. Und natürlich muss auch eine Verlinkung zu .wellknown im Apache Webverzeichnis einer jeden Domain angelegt werden. Also z. B. example.org und www.example.org. Sollte im Webverzeichnis eine RewriteRule o. ä. aktiv sein, so muss diese natürlich vorher deaktiviert werden.):

<pre>
(certbot)xyz00-doms@myhive:~/certbot/userland-certbot$ bin/certbot-runner certonly -d example.org -d www.example.org
2016-08-16 14:12:19,526:WARNING:certbot.client:Non-standard path(s), might not work with crontab installed by your operating system package manager

IMPORTANT NOTES:
- Congratulations! Your certificate and chain have been saved at
/home/pacs/xyz00/users/doms/certbot/userland-certbot/parts/certbot/etc/live/example.org/fullchain.pem.
Your cert will expire on 2016-11-14. To obtain a new or tweaked
version of this certificate in the future, simply run certbot
again. To non-interactively renew *all* of your certificates, run
"certbot renew"
- If you like Certbot, please consider supporting our work by:

Donating to ISRG / Let's Encrypt: https://letsencrypt.org/donate
Donating to EFF: https://eff.org/donate-le

</pre>

Nun ist es so, dass Zertifikate bei Hostsharing durch eine E-Mail an service@hostsharing.net aktiviert werden. Dieser Vorgang muss zur Zeit noch "per Hand" initiert werden.
Außerdem wird von Hostsharing erwartet, einer gewisse Namenskonvention bei der Benennung der Zertifikate und Schlüssel zu folgen. Deshalb Kopiert man die Symlinks ins Verzeichnis "etc" der Domain und bennent die Endungen entsprechend um.

<pre>
cd ~/doms/example.org/etc
cp ~/certbot/userland-certbot/parts/certbot/etc/live/example.org/cert.pem example.org.crt
cp ~/certbot/userland-certbot/parts/certbot/etc/live/example.org/chain.pem example.org.chain
cp ~/certbot/userland-certbot/parts/certbot/etc/live/example.org/privkey.pem example.org.key
</pre>

und schickt eine Mail mit der Bitte um Aktivierung des Zertifikats unter Angabe des Verzeichnisses ~/doms/example.org/etc an service@hostsharing.net.

=== Automatisierte Verlängerung der Let’s Encrypt Zertifikate ===

Let’s Encrypt Zertifikate haben eine Gültigkeit von 3 Monaten. Das ist nicht viel. Wenn die Verlängerungsprozedur automatisiert ist, dann muss man sich auf absehbare Zeit gar nicht mehr kümmern. Buildout ist so konfiguriert, dass ein Cronjob zur Zertifikatserneuerung angelegt wird, der täglich ausgeführt wird. Vor Ablauf des Zertifikats wird ein neues Zertifikat erstellt und ersetzt das alte. Außerdem wird eine Mail an die registrierte Adresse gesendet. Theoretisch sollte man diese Mail an service@hostsharing.net weiterleiten können, um das erneuerte Zertifikat ersetzen zu können. Eine Möglichkeit lässt sich mittels einer Cronjob gesteuerten E-Mail realisieren. Dazu legt man eine Textdatei (z.B. mail.txt) mit ähnlichem Inhalt z. B. im Verzeichnis ~/etc an.

<pre>
Hallo Hostsharing Service

Ich bitte um die Neuinstallation des Zertifikats für die Domain example.org.

Es liegt im Verzeichnis
/home/pacs/xyz00/users/doms/certbot/userland-certbot/parts/certbot/etc/live/example.org/

(automatisierte mail)

Gruß
Euer Cronjob
</pre>

Der Cronjob wird beispielsweise folgendermaßen im crontab eingetragen:

<pre>
# email to service@hostsharing.net for installing new cert of domain example.org
17 7 8 1,4,7,10 * cat /home/pacs/xyz00/users/doms/etc/email.txt | mail -s"Erneuern von Zertifikat" service@hostsharing.net
</pre>

Der Cronjob soll viermal im Jahr laufen, und sinnvollerweise ca. 2 Wochen vor Ablauf des alten Zertifikats ausgeführt werden.

----
[[Kategorie:HSDoku]]
[[Kategorie:WWW]]
[[Kategorie:Glossar]]