TYPO3 Version 4.3.0 installieren: Unterschied zwischen den Versionen

Aus Hostsharing Wiki
Zur Navigation springen Zur Suche springen
(Änderung 2046 von Chg00-hsdoku (Diskussion) wurde rückgängig gemacht.)
 
(7 dazwischenliegende Versionen von 3 Benutzern werden nicht angezeigt)
Zeile 18: Zeile 18:
Im htdocs-Verzeichnis der Domain eine .htaccess-Datei mit folgendem Inhalt anlegen:  
Im htdocs-Verzeichnis der Domain eine .htaccess-Datei mit folgendem Inhalt anlegen:  
   
   
RewriteEngine On
<syntaxhighlight lang="apache" line>
RewriteBase /
RewriteEngine On
RewriteRule ^typo3$ - [L]
RewriteBase /
RewriteRule ^typo3/.*$ - [L]
RewriteRule ^typo3$ - [L]
RewriteCond %{REQUEST_FILENAME} !-f
RewriteRule ^typo3/.*$ - [L]
RewriteCond %{REQUEST_FILENAME} !-d
RewriteCond %{REQUEST_FILENAME} !-f
RewriteCond %{REQUEST_FILENAME} !-l
RewriteCond %{REQUEST_FILENAME} !-d
RewriteRule .* index.php
RewriteCond %{REQUEST_FILENAME} !-l
RewriteRule .* index.php
</syntaxhighlight>


== TYPO3 einrichten ==  
== TYPO3 einrichten ==  
Zeile 42: Zeile 44:
Zuerst kopiert man mit wget denn Quellcode in ein Verzeichnis des Domain-Admins. In dieser Anleitung wird der Quellcode im Stammverzeichnis des Domain-Admins installiert.
Zuerst kopiert man mit wget denn Quellcode in ein Verzeichnis des Domain-Admins. In dieser Anleitung wird der Quellcode im Stammverzeichnis des Domain-Admins installiert.


# ins Stammverzeichnis wechseln
<syntaxhighlight lang="bash">
cd  
# ins Stammverzeichnis wechseln
# TYPO3 Quellcode 4.3.0 kopieren
cd  
wget http://prdownloads.sourceforge.net/typo3/typo3_src-4.3.0.tar.gz?download  
# TYPO3 Quellcode 4.3.0 kopieren
# Quellcode auspacken
wget http://prdownloads.sourceforge.net/typo3/typo3_src-4.3.0.tar.gz?download  
tar -xvzf typo3_src-4.3.0.tar.gz
# Quellcode auspacken
tar -xvzf typo3_src-4.3.0.tar.gz
</syntaxhighlight>


Wenn man einen Link auf dieses neue Verzeichnis legt, wird später ein Update leichter möglich sein:
Wenn man einen Link auf dieses neue Verzeichnis legt, wird später ein Update leichter möglich sein:


ln -s typo3_src-4.3.0 typo3_src
<syntaxhighlight lang="bash">
ln -s typo3_src-4.3.0 typo3_src
</syntaxhighlight>


Ein 'ls -al' im Stamm-Verzeichnis sollte jetzt u.a. folgende Zeilen:
Ein 'ls -al' im Stamm-Verzeichnis sollte jetzt u.a. folgende Zeilen:
 
<syntaxhighlight lang="bash">
lrwxrwxrwx 1 xyz00 xyz00 15 Mar 3 18:56 typo3_src -> typo3_src-4.3.0
lrwxrwxrwx 1 xyz00 xyz00 15 Mar 3 18:56 typo3_src -> typo3_src-4.3.0
drwxr-xr-x 6 xyz00 xyz00 4096 Jan 30 17:23 typo3_src-4.3.0
drwxr-xr-x 6 xyz00 xyz00 4096 Jan 30 17:23 typo3_src-4.3.0
 
</syntaxhighlight>


=== TYPO3 Dummy-Package kopieren und entpacken ===
=== TYPO3 Dummy-Package kopieren und entpacken ===
Zeile 63: Zeile 69:
Dann kopiert man mit wget das Dummy-Paket in das Verzeichnis 'subs'.  
Dann kopiert man mit wget das Dummy-Paket in das Verzeichnis 'subs'.  


# Wechsel ins Verzeichnis subs
<syntaxhighlight lang="bash">
cd ~/doms/example.com/subs
# Wechsel ins Verzeichnis subs
# Kopieren des Dummypakets vom TYPO3-website
cd ~/doms/example.com/subs
~/doms/example.de/subs$ wget http://prdownloads.sourceforge.net/typo3/dummy-4.3.0.tar.gz?download
# Kopieren des Dummypakets vom TYPO3-website
# Auspacken
~/doms/example.de/subs$ wget http://prdownloads.sourceforge.net/typo3/dummy-4.3.0.tar.gz?download
~/doms/example.de/subs$ tar -xvzf dummy-4.3.0.tar.gz
# Auspacken
# alle Dateien im Ordner dummy-4.3.0 nach htdocs verschieben
~/doms/example.de/subs$ tar -xvzf dummy-4.3.0.tar.gz
mv dummy-4.3.0/* ../htdocs
# alle Dateien im Ordner dummy-4.3.0 nach htdocs verschieben
# das Archiv dummy-4.3.0.tar.gz löschen  
mv dummy-4.3.0/* ../htdocs
~/doms/example.de/subs$ rmdir dummy-4.3.0
# das Archiv dummy-4.3.0.tar.gz löschen  
~/doms/example.de/subs$ rm dummy-4.3.0.tar.gz
~/doms/example.de/subs$ rmdir dummy-4.3.0
~/doms/example.de/subs$ rm dummy-4.3.0.tar.gz
</syntaxhighlight>


Jetzt muss noch ein SymLink im Verzeichnis www geändert werden, sodass es auf die TYPO3-Installation weist. Dabei kann man direkt auf die Version (hier: 4.3.0) verlinken, oder auf den link ~/typo3_src. Letztere Variante ermöglicht ein schnelles/gleichzeitiges Update von mehreren TYPO3-Installationen in verschiedenen Domänen, indem man einfach im Stammverzeichnis den link '~/typo3_src' löscht und auf eine nächste Version verlinkt. (Diese Vorgangsweise ist mit Vorsicht zu genießen; Wenn man die Folgen nicht überblickt, ist es besser direkt auf bestimmte Versionen zu verlinken und bei Upgrades die Installationen einzeln zu aktualisieren).  
Jetzt muss noch ein SymLink im Verzeichnis htdocs geändert werden, sodass es auf die TYPO3-Installation weist. Dabei gibt kann man direkt auf die Version (hier: 4.3.0) verlinken, oder auf den link ~/typo3_src. Letztere Variante ermöglicht ein schnelles/gleichzeitiges Update von mehreren TYPO3-Installationen in verschiedenen Domänen, indem man einfach im Stammverzeichnis den link '~/typo3_src' löscht und auf eine nächste Version verlinkt. (Diese Vorgangsweise ist mit Vorsicht zu genießen; Wenn man die Folgen nicht überblickt, ist es besser direkt auf bestimmte Versionen zu verlinken und bei Upgrades die Installationen einzeln zu aktualisieren).  


# Wechsel ins Verzeichnis www
<syntaxhighlight lang="bash">
cd ~/doms/example.de/htdocs$  
# Wechsel ins Verzeichnis htdocs
rm typo3_src
cd ~/doms/example.de/htdocs$  
# link auf die aktuelle Version
rm typo3_src
ln -s ~/typo3_src-4.3.0 typo3_src
# link auf die aktuelle Version
oder
ln -s ~/typo3_src-4.3.0 typo3_src
# link auf den link für gleichzeitiges updaten mehrere TYPO3-Installationen
oder
ln -s ~/typo3_src typo3_src
# link auf den link für gleichzeitiges updaten mehrere TYPO3-Installationen
ln -s ~/typo3_src typo3_src
</syntaxhighlight>


Typo3 ist nun unter www.example.com erreichbar.  
Typo3 ist nun unter example.com erreichbar.


== Typo3 konfigurieren ==
== Typo3 konfigurieren ==
=== Datenbank einrichten ===
=== Datenbank einrichten ===
Um das Browser-gestütze Install-Tool von TYPO3 nutzen zu können, muss man noch eine Datei im Verzeichnis www/typo3conf/ anlegen, die nach dem Installieren wieder zu löschen ist:  
Um das Browser-gestütze Install-Tool von TYPO3 nutzen zu können, muss man noch eine Datei im Verzeichnis htdocs/typo3conf/ anlegen, die nach dem Installieren wieder zu löschen ist:  


touch ~/doms/example.com/www/typo3_conf/ENABLE_INSTALL_TOOL
<syntaxhighlight lang="bash">
touch ~/doms/example.com/htdocs/typo3_conf/ENABLE_INSTALL_TOOL
</syntaxhighlight>


Im Browser ruft man die Seite http://www.example.com/ auf. Es erscheint das TYPO3-Install-Tool, das einen in 3 Schritten durch die Konfiguration leitet.  
Im Browser ruft man die Seite http://example.com/ auf. Es erscheint das TYPO3-Install-Tool, das einen in 3 Schritten durch die Konfiguration leitet.  


# Datenbankparameter eingeben: <br/>Username: hier ist der Mysql-User 'xyz00_meinname' einzugeben, der die Datenbank verwaltet.<br/>Password: Passwort des Mysql-Users <br/>host: 'localhost'
# Datenbankparameter eingeben: <br/>Username: hier ist der Mysql-User 'xyz00_meinname' einzugeben, der die Datenbank verwaltet.<br/>Password: Passwort des Mysql-Users <br/>host: 'localhost'
Zeile 102: Zeile 113:


Über den link 'Continue to configure TYPO3' gelangt man danach automatisch zu einem Formular, über das das Install-Tool-Passwort geändert werden kann.
Über den link 'Continue to configure TYPO3' gelangt man danach automatisch zu einem Formular, über das das Install-Tool-Passwort geändert werden kann.


=== Weitergehende Einstellungen ===
=== Weitergehende Einstellungen ===
Zeile 114: Zeile 124:
Wählen Sie im Install-Tool das Menu '5: All Configuration'
Wählen Sie im Install-Tool das Menu '5: All Configuration'


TTFdpi = 96
<syntaxhighlight lang="ini" line>
gdlib_2 = 1
TTFdpi = 96
im_version_5 = 6
gdlib_2 = 1
im_negate_mask = 1
im_version_5 = 6
im_imvMaskState = 1
im_negate_mask = 1
im_combine_filename = composite
im_imvMaskState = 1
im_v5effects = 1
im_combine_filename = composite
<!-- im_path_lzw = ''
im_v5effects = 1
Gibt's bei uns eine version von convert mit LZW Unterstüzung??
-->


# im_path_lzw = ''
# Gibt's bei uns eine version von convert mit LZW Unterstüzung??
</syntaxhighlight>


==== Ergänzende Hinweise ====
==== Ergänzende Hinweise ====
   
   
# Wenn Extensions global installiert werden sollen  
<syntaxhighlight lang="ini" line>
allowGlobalInstall = 0
# Wenn Extensions global installiert werden sollen  
# Für mehrsprachige Sites kann empfehlenswert sein:  
allowGlobalInstall = 0
forceCharset = utf-8
# Für mehrsprachige Sites kann empfehlenswert sein:  
# Name der Installation (=Text neben dem Weltkugelsymbol)  
forceCharset = utf-8
sitename = 'New TYPO3 site' durch eine treffende Bezeichnung ersetzen  
# Name der Installation (=Text neben dem Weltkugelsymbol)  
 
sitename = 'New TYPO3 site' durch eine treffende Bezeichnung ersetzen  
</syntaxhighlight>


=== Aufräumen ===
=== Aufräumen ===
Zeile 148: Zeile 160:
[[Kategorie:Installationsanleitungen]]
[[Kategorie:Installationsanleitungen]]
[[Kategorie:Software]]
[[Kategorie:Software]]
[[Kategorie:CMS]]

Aktuelle Version vom 17. Juni 2024, 11:55 Uhr

Vorbemerkungen

Diese Installationsanleitung von TYPO3 bezieht sich auf die derzeit aktuelle Version 4.3.0. Folgende Schritte sind notwendig, um eine TYPO3-Installation zum Laufen zu bringen.

  1. Mysql-Datenbank anlegen
  2. php via fcgi kontrollieren ob im fastcgi-Verzeichnis der Domain Datei "phpstub" vorhanden ist
  3. php.ini anpassen (es muss keine php.ini Datei geben)
  4. TYPO3-Packages auspacken
  5. '.htaccess'-Datei anpassen
  6. TYPO3 installieren
  7. TYPO3 konfigurieren

Vorbereitungen

Mysql-Datenbank anlegen

Für eine neue TYPO3-Website benötigt man eine MYSQL-Datenbank. Eine Anleitung findet sich unter MySQL


.htaccess anpassen

Im htdocs-Verzeichnis der Domain eine .htaccess-Datei mit folgendem Inhalt anlegen:

RewriteEngine On
RewriteBase /
RewriteRule ^typo3$ - [L]
RewriteRule ^typo3/.*$ - [L]
RewriteCond %{REQUEST_FILENAME} !-f
RewriteCond %{REQUEST_FILENAME} !-d
RewriteCond %{REQUEST_FILENAME} !-l
RewriteRule .* index.php

TYPO3 einrichten

Benötigte Dateien

Für eine lauffähige TYPO3-Installation benötigt man zwei Pakete:

  1. Source_tar.gz, das ist der eigentliche TYPO3-Quellcode.
  2. Dummy_tar.gz: Dummy ist eine komplette, leere Umgebung, sozusagen das Grundgerüst für eine neue Website (Ordnerstruktur, Konfigurationsdateien usw).

Die aktuelle Version von TYPO3 ist im Download-Verzeichnis von www.typo3.org zu finden. Für die Installation auf den Hostsharing-Servern sind die tar.gz Packages zu verwenden.


TYPO3 Quellen kopieren und entpacken

Zuerst kopiert man mit wget denn Quellcode in ein Verzeichnis des Domain-Admins. In dieser Anleitung wird der Quellcode im Stammverzeichnis des Domain-Admins installiert.

# ins Stammverzeichnis wechseln
cd 
# TYPO3 Quellcode 4.3.0 kopieren
wget http://prdownloads.sourceforge.net/typo3/typo3_src-4.3.0.tar.gz?download 
# Quellcode auspacken
tar -xvzf typo3_src-4.3.0.tar.gz

Wenn man einen Link auf dieses neue Verzeichnis legt, wird später ein Update leichter möglich sein:

ln -s typo3_src-4.3.0 typo3_src

Ein 'ls -al' im Stamm-Verzeichnis sollte jetzt u.a. folgende Zeilen:

lrwxrwxrwx 1 xyz00 xyz00 15 Mar 3 18:56 typo3_src -> typo3_src-4.3.0
drwxr-xr-x 6 xyz00 xyz00 4096 Jan 30 17:23 typo3_src-4.3.0

TYPO3 Dummy-Package kopieren und entpacken

Dann kopiert man mit wget das Dummy-Paket in das Verzeichnis 'subs'.

# Wechsel ins Verzeichnis subs
cd ~/doms/example.com/subs
# Kopieren des Dummypakets vom TYPO3-website
~/doms/example.de/subs$ wget http://prdownloads.sourceforge.net/typo3/dummy-4.3.0.tar.gz?download
# Auspacken
~/doms/example.de/subs$ tar -xvzf dummy-4.3.0.tar.gz
# alle Dateien im Ordner dummy-4.3.0 nach htdocs verschieben
mv dummy-4.3.0/* ../htdocs
# das Archiv dummy-4.3.0.tar.gz löschen 
~/doms/example.de/subs$ rmdir dummy-4.3.0
~/doms/example.de/subs$ rm dummy-4.3.0.tar.gz

Jetzt muss noch ein SymLink im Verzeichnis htdocs geändert werden, sodass es auf die TYPO3-Installation weist. Dabei gibt kann man direkt auf die Version (hier: 4.3.0) verlinken, oder auf den link ~/typo3_src. Letztere Variante ermöglicht ein schnelles/gleichzeitiges Update von mehreren TYPO3-Installationen in verschiedenen Domänen, indem man einfach im Stammverzeichnis den link '~/typo3_src' löscht und auf eine nächste Version verlinkt. (Diese Vorgangsweise ist mit Vorsicht zu genießen; Wenn man die Folgen nicht überblickt, ist es besser direkt auf bestimmte Versionen zu verlinken und bei Upgrades die Installationen einzeln zu aktualisieren).

# Wechsel ins Verzeichnis htdocs
cd ~/doms/example.de/htdocs$ 
rm typo3_src
# link auf die aktuelle Version
ln -s ~/typo3_src-4.3.0 typo3_src
oder
# link auf den link für gleichzeitiges updaten mehrere TYPO3-Installationen
ln -s ~/typo3_src typo3_src

Typo3 ist nun unter example.com erreichbar.

Typo3 konfigurieren

Datenbank einrichten

Um das Browser-gestütze Install-Tool von TYPO3 nutzen zu können, muss man noch eine Datei im Verzeichnis htdocs/typo3conf/ anlegen, die nach dem Installieren wieder zu löschen ist:

touch ~/doms/example.com/htdocs/typo3_conf/ENABLE_INSTALL_TOOL

Im Browser ruft man die Seite http://example.com/ auf. Es erscheint das TYPO3-Install-Tool, das einen in 3 Schritten durch die Konfiguration leitet.

  1. Datenbankparameter eingeben:
    Username: hier ist der Mysql-User 'xyz00_meinname' einzugeben, der die Datenbank verwaltet.
    Password: Passwort des Mysql-Users
    host: 'localhost'
  2. Datenbank auswählen
    Unter 'Select an existing EMPTY database' die Datenbank auswählen.
    Option 2: Create new database (recommended), das Erzeugen einer Datenbank, ist auf den hostsharing-Servern nicht möglich.
  3. TYPO3 Datenbank-SQL-Datei mit einem importieren

Über den link 'Continue to configure TYPO3' gelangt man danach automatisch zu einem Formular, über das das Install-Tool-Passwort geändert werden kann.

Weitergehende Einstellungen

Install-Tool-Passwort ändern

Wählen Sie im Install-Tool das Menu '10: About'. Das Standardpasswort ist 'joh316' und muss unbedingt durch ein eigenes ersetzt werden.


Einstellungen für Grafikverarbeitung

TYPO3 verwendet für graphische Menüs und für Bildbearbeitung (z. B. Skalieren) GDlib und ImageMagick. Beides, die Library wie das Graphikpaket ImageMagick ist auf unseren Servern installiert. Zur Konfiguration sind folgende Einstellungen notwendig:

Wählen Sie im Install-Tool das Menu '5: All Configuration'

TTFdpi = 96
gdlib_2 = 1
im_version_5 = 6
im_negate_mask = 1
im_imvMaskState = 1
im_combine_filename = composite
im_v5effects = 1

# im_path_lzw = '' 
# Gibt's bei uns eine version von convert mit LZW Unterstüzung??

Ergänzende Hinweise

# Wenn Extensions global installiert werden sollen 
allowGlobalInstall = 0
# Für mehrsprachige Sites kann empfehlenswert sein: 
forceCharset = utf-8
# Name der Installation (=Text neben dem Weltkugelsymbol) 
sitename = 'New TYPO3 site' durch eine treffende Bezeichnung ersetzen

Aufräumen

Zuletzt müssen im Backend von TYPO3 noch ein paar Vorkehrungen getroffen werden, die der Sicherheit dienen. Das Backend erreicht man unter 'www.example.com/typo3/'. Loggen Sie sich als User 'admin' mit dem Passwort 'password' ein. Das Backende empfängt einen mit einer Sicherheitswarnung 'Important Notice' im gelber Kasten.

  1. admin Passwort ändern
    Folgen Sie dem link und ändern Sie das Passwort
    Wenn man das Speichern-und-Schließen-Symbol anklickt, landet man wieder auf der Eingangsseite mit der 'Important Notice'.
  2. Install-Tool deaktivieren
    Wenn man auf den link 'Click to remove the file now!' klickt, wird die Datei 'ENABLE_INSTALL_TOOL' gelöscht, sodass das Install-Tool nicht mehr erreichbar ist. Wenn es später wieder verwenden wollen, erzeugen legen Sie wieder eine Datei mit dem Namen www/typo3conf/ENABLE_INSTALL_TOOL' an.
  3. Reference-Index-Update vornehmen
    Der Link im gelben Kasten führt einen ins 'Admin Tools Modul'. Ein Klick auf den 'update'-Button baut den Referenzenindex auf.

Ein Reload führt einen wieder auf die Eingangsseite, von der der gelbe Kasten mit der 'Important Notice' verschwunden sein sollte.