Wikizone - Benutzerbeiträge [de]

E-Mail

2007-01-03T17:31:37Z

217.228.133.51:

== Mails aus Thunderbird exportieren ==
Für Updates kann man einfach die Ordnerstruktur in der die Mails liegen kopieren und wieder in der neuen Version abspeichern. Bei neueren Versionen funktioniert das Update automatisch.

===Export nach Outlook Express===
* Die betreffenden Mails als Anhang an sich selbst weiterleiten (die Mails werden dabei als *.eml Files in den Anhang gepackt.)
* Im Outlook Express die Mail herunterladen. Die Anhänge in einen beliebigen Mailordner ziehen - fertig. Die Mails enthalten alle Daten auch die Header-Daten. Wenn es Zugriffs-Probleme gibt einfach die Mails kurz auf der Festplatte zwischenspeichern, und erst danach in den Mailordner ziehen.

== Grundsätzlicher Ablauf einer Mailübertragung ==
von: http://www.lrz-muenchen.de/services/netzdienste/email/empfang/ (14.7.2006)
Um zu verstehen, was im DNS konfiguriert werden muß und weshalb, soll zuerst der Ablauf der Übertragung einer Mail beschrieben werden.

Jede Mailadresse besteht aus zwei Teilen, dem lokalen Teil links vom '@'-Zeichen und der Domain rechts davon. Die Domain bestimmt das Routing, d.h. den Weg vom Mailserver des Absenders zum Mailserver des Empfängers. Der linke Teil bestimmt, was der empfangende Mailserver mit der Mail machen soll. In der Regel wird er die Mail an eine lokal vorhandene Mailbox ausliefern.

Der sendende Mailserver muß feststellen, an welchen Rechner er die Mail schicken muß. Dies kann bereits der Zielrechner sein, auf dem sich die Mailbox befindet, oder ein erster Rechner auf dem Weg zum Zielrechner (store-and-forward-Prinzip). Die notwendige Information bekommt er entweder aus einer internen Konfiguration - für uns hier nicht weiter interessant - oder aus dem DNS.

Im DNS gibt es verschiedene Arten von Einträgen - sogenannte Resource Records -, bei denen einem Domainnamen bestimmte Informationen zugeordnet sind. Bei der Abfrage des DNS gibt man den Domainnamen und den Typ des Eintrags an und bekommt die zugehörige Information geliefert. Unter einem Domainnamen kann man verschiedene Dinge verstehen.

Beim Mailversand spielen drei Typen von Einträgen eine Rolle:

* A-Record: zu einem Domainnamen (Rechner) wird die zugehörige IP-Adresse ausgegeben. Besitzt ein Rechner mehrere IP-Adressen, so gibt es entsprechend viele A-Records zum Domainnamen.
* MX-Record: zu einem Domainnamen wird der zugehörige Mailserver ausgegeben. Meistens sind mehrere MX-Records zu einem Domainnamen konfiguriert. Zur Unterscheidung besitzt jeder MX-Record eine Priorität (kleine Zahl = große Priorität). Der MX-Record mit der höchsten Priorität ist der eigentliche Zielrechner, auf dem sich die Mailboxen befinden, die anderen MX-Records bezeichnen die Backup-Rechner für den Fall, daß der eigentliche Zielrechner nicht erreicht werden kann. Sie speichern die Mails nur temporär und versuchen periodisch die Mail an den eigentlichen Zielrechner weiterzuleiten.
* CNAME-Record: der Domainname ist ein Alias für den angegebenen Rechner. Dieser Eintrag wird für Mail kaum verwendet und daher im folgenden nicht weiter betrachtet (sollten Sie aber so einen Eintrag zum Mailempfang verwenden, wenden Sie sich bitte an Herrn Spirk, spirk@lrz.de, damit er Ihnen bei der Migration helfen kann).

Ablauf einer Mailübertragung (soweit es hier interessiert):

* Der sendende Mailserver fragt im DNS nach den MX-Records für die Domain in der Mailadresse.
* Gibt es keinen MX-Record, so wird die Existenz eines MX-Records mit Priorität 0 angenommen, der auf die nachgefragte Domain zeigt (in der Praxis heißt dies, der Domainname ist der Zielrechner, zu dem eine Verbindung aufgebaut werden muß).
* Gibt es MX-Records, so werden diese nach Priorität sortiert. Zeigt einer der MX-Records auf den anfragenden Mailserver selbst, so wird dieser MX-Record und alle anderen gleicher oder niedrigerer Priorität ignoriert und nur die MX-Records mit höherer Priorität beachtet.
* Für den Rechner aus dem MX-Record mit der höchsten Priorität wird eine Anfrage nach dem A-Record und damit nach der IP-Adresse des Rechners gestellt. Dieser A-Record muß existieren, sonst ist kein Mailaustausch möglich.
* Zu dieser IP-Adresse wird eine Verbindung aufgebaut und die Mail übertragen.
* Kann zu der IP-Adresse keine Verbindung aufgebaut werden, so wird der MX-Record mit der nächstniedrigeren Priorität genommen, der A-Record abgefragt und die Verbindung aufgebaut (Backup-Fall).
* Kommt zu keinem der Rechner aus den MX-Records eine Verbindung zustande, so bleibt die Mail am absendenden Mailserver liegen und der ganze Ablauf beginnt nach einiger Zeit von neuem.

Was bedeutet dies nun, wenn z.B. eine Mail von einem Mailserver aus dem Internet an die Mailadresse xyz@vetmed.uni-muenchen.de geschickt werden soll? Im DNS seien folgende MX- und A-Records eingetragen:

Domainname Typ Prio Wert
vetmed.uni-muenchen.de MX 10 cip-tf2.cip.vetmed.uni-muenchen.de
vetmed.uni-muenchen.de MX 20 mailrelay1.lrz-muenchen.de
vetmed.uni-muenchen.de MX 30 mailrelay2.lrz-muenchen.de

cip-tf2.cip.vetmed.uni-muenchen.de A 141.84.176.126
mailrelay1.lrz-muenchen.de A 129.187.254.101
mailrelay2.lrz-muenchen.de A 129.187.254.102

* Der sendende Mailserver bekommt auf Nachfrage im DNS diese drei MX-Records.
* Der MX-Record mit der höchsten Priorität zeigt auf cip-tf2.cip.vetmed.uni.lrz-muenchen.de. Der sendende Mailserver versucht daher zu diesem Rechner eine Verbindung aufzubauen. Da cip-tf2.cip.vetmed.uni.lrz-muenchen.de nicht zu den im MHN zugelassenen Mailrelays gehört, wird die Verbindung am Router zwischen B-WiN und MHN blockiert.
* Der MX-Record mit der nächst niedrigeren Priorität zeigt auf den Mailrelay mailrelay1.lrz-muenchen.de, der als Backup dient. Der Verbindungsaufbau kommt zustande, da mailrelay1.lrz-muenchen.de im Gegensatz zu cip-tf2.cip.vetmed.uni.lrz-muenchen.de zu den zugelassenen Mailrelays gehört, und so kann die Mail übertragen werden.
* mailrelay1.lrz-muenchen.de stellt fest, daß die Mail nicht lokal ausgeliefert, sondern an einen anderen Rechner weitergeleitet werden soll.
* Er holt sich ebenfalls die drei MX-Records.
* Da der zweite MX-Record auf ihn selbst zeigt, verwirft er diesen und - wegen der noch niedrigeren Priorität- auch den dritten und behält nur den ersten MX-Record.
* Er versucht eine Verbindung zu cip-tf2.cip.vetmed.uni.lrz-muenchen.de aufzubauen und die Mail zu übertragen. Dies gelingt, da sich die Mail bereits im MHN befindet und sich der Filter am Router nicht mehr auswirkt.

Daraus folgt, daß in Zukunft für jede Domain, für die Mail empfangen werden soll, mindestens 2 MX-Records existieren müssen. Dies gilt auch für den Mailserver, selbst wenn zur Zeit kein MX-Record für ihn definiert ist und alle E-Mails über den Domainnamen des Mailserver abgewickelt werden. Als Mailserver gelten in diesem Fall alle Rechner, auf denen sendmail oder ein ähnliches Programm zum Mailempfang/versand läuft.

Für cip-tf2.cip.vetmed.uni.lrz-muenchen.de sollten daher noch die folgenden MX-Records eingetragen werden:

Domainname Typ Prio Wert
cip-tf2.cip.vetmed.uni-muenchen.de MX 10 cip-tf2.cip.vetmed.uni-muenchen.de
cip-tf2.cip.vetmed.uni-muenchen.de MX 20 mailrelay1.lrz-muenchen.de
cip-tf2.cip.vetmed.uni-muenchen.de MX 30 mailrelay2.lrz-muenchen.de

Der MX-Record mit der höchsten Priorität zeigt auf den eigentlichen Mailserver, auf dem die Mailboxen liegen. Der MX-Record mit niedriger Priorität zeigt auf eines der Mailrelays, über den der direkte Empfang aus dem Internet abgewickelt wird. Zur Sicherheit sollte noch ein dritter MX-Record auf einen weiteren Mailrelay zeigen, damit bei Ausfall des ersten Mailrelays als Backup das zweite zur Verfügung steht.

Befinden sich die Mailboxen zu einer Domain auf dem Mailboxserver des LRZ (mailin.lrz-muenchen.de), so gibt es nur die zwei MX-Records auf die beiden Mailrelays mailrelay1.lrz-muenchen.de und mailrelay2.lrz-muenchen.de. Es darf kein MX-Record auf den Mailboxserver zeigen. E-Mails gelangen von den Mailrelays zum Mailboxserver über eine interne Kopplung. Es sind in diesem Fall also nur 2 MX-Records definiert:

Domainname Typ Prio Wert
jura.uni-muenchen.de MX 20 mailrelay1.lrz-muenchen.de
jura.uni-muenchen.de MX 30 mailrelay2.lrz-muenchen.de
Was ist also zu tun?
Es muß

1. festgelegt werden, über welche(n) Mailrelay(s) Mails empfangen werden sollen und
2. die entsprechende Konfiguration im DNS durchgeführt werden.

Daraus ergeben sich die folgenden Arbeitsschritte:

1. Überprüfung, ob es bereits MX-Records im DNS gibt:
* Stellen Sie fest, ob für Ihre Maildomain bereits MX-Records im DNS definiert sind, unter Unix z.B. mit nslookup -q=mx maildomain (s.a. nslookup auf LRZ-Nameserver)
* Zeigt einer der MX-Records bereits auf eines oder mehrere der Mailrelays (s. obige Tabelle), so sind Sie bereits fertig.
* Zeigt einer der MX-Records auf sunsrv5.lrz-muenchen.de (s. obiges Beispiel für jura.uni-muenchen.de) oder vielleicht sogar noch auf cd1.lrz-muenchen.de, so müssen diese Einträge auf die Mailrelays mailrelay1.lrz-muenchen.de und mailrelay2.lrz-muenchen.de geändert werden, s. weiter unten.
* Gibt es keinen MX-Record oder zeigt dieser nicht auf eines der Mailrelays, so muß ein Mailrelay ausgesucht werden.
2. Auswahl eines Mailrelays
* Gibt es in Ihrer Fakultät bereits ein Mailrelay, so bietet sich dieses an.
* Arbeiten Sie eng mit einer anderen Fakultät zusammen, die ein Mailrelay hat, so wäre dies eine weitere Möglichkeit.
* In jedem Fall ist es möglich, die zentralen Mailrelays des LRZ zu nutzen. Lassen Sie hierfür zwei MX-Records auf mailrelay1.lrz-muenchen.de und mailrelay2.lrz-muenchen.de eintragen, wobei die Priorität für mailrelay1.lrz-muenchen.de höher als die Priorität für mailrelay2.lrz-muenchen.de sein soll.
* Denken Sie bei der Auswahl an die Betriebsregeln des Mailrelays (neudeutsch: Policy). Hier gibt es Unterschiede, z.B. welche Mails von woher akzeptiert werden, wie sie weiterverarbeitet werden usw. So kann unter anderem die Größe der akzeptierten Mails unterschiedlich sein:
o srv.cip.physik.tu-muenchen.de akzeptiert 4 MByte große Mails
o die zentralen Relays des LRZ 20 MByte
o charly.bl.physik.tu-muenchen.de 100 MByte
o und die anderen Rechner aus obiger Liste haben bisher keine Größenbeschränkung.
Die Mail-Policy für die zentralen Mailrelays des LRZ finden sie unter http://www.lrz-muenchen.de/services/netzdienste/email/policy Vereinbarung mit dem Administrator des Mailrelays
3.
* Sprechen Sie zuerst mit dem Administrator des ausgesuchten Mailrelays, ob er bereit ist, Mails an Ihre Domain über sein Mailrelay zu leiten. Eventuell muß sein Mailrelay umkonfiguriert werden, damit er Mails für Ihre Domain auch entgegennimmt und nicht als unerwünschten Relay-Versuch ablehnt.
* Wollen Sie die Mails über die LRZ-Mailrelays leiten, so können Sie das jederzeit tun. Sie müssen nur dann mit uns Kontakt aufnehmen, wenn Ihre Maildomain keine Subdomain der von uns zur Zeit konfigurierten Domains ist, für die wir Mails akzeptieren. Mails an andere Domains werden als unerwünschter Relay-Versuch abgelehnt:

akzeptierte Domains
badw-muenchen.de
badw.de
isb.bayern.de
fh-muenchen.de
fh-weihenstephan.de
ku-eichstaett.de
lrz-muenchen.de
lrz.de
mgh.de
mhn.de
tu-muenchen.de
tum.de
uni-muenchen.de
weihenstephan.de
4. Konfiguration des DNS, Vereinbarung mit dem Administrator der DNS-Zone
* Nachdem Sie den zuständigen Mailserver festgelegt haben (und mit dem zuständigen Mailadministrator gesprochen haben), muß noch die Konfiguration im DNS erfolgen. Zuerst müssen Sie herausfinden, wer die Daten für Ihre Maildomain im DNS verwaltet, unter Unix z.B. durch nslookup -q=soa domainname. Gibt es dazu keine Antwort, müssen Sie die erste Subdomain auf der linken Seite streichen und erneut eine Abfrage stellen. Unter origin findet sich der Rechner, auf dem die DNS-Zone, d.h. die Daten für Ihre Domain verwaltet werden, und unter mail addr die Adresse des Administrators (der erste '.' muß durch ein '@' ersetzt werden).
* Nehmen Sie Kontakt mit diesem Administrator auf und lassen Sie MX-Records anhand obiger Erläuterung bzw. Beispiele eintragen, also einen auf Ihren Mailrechner und einen oder zwei auf die ausgesuchten Mailrelays. Denken Sie daran, daß sunsrv5.lrz-muenchen.de oder cd1.lrz-muenchen.de durch mailrelay1.lrz-muenchen.de und mailrelay2.lrz-muenchen.de ersetzt werden müssen.
* Werden die Daten vom DNS-Server des LRZ verwaltet, d.h.
o origin ist dfvgate.lrz-muenchen.de und
o mail addr ist hostmaster@lrz-muenchen.de und
o die MX-Records zeigen auf sunsrv5.lrz-muenchen.de,
so müssen Sie nichts tun. Wir stellen die MX-Records selbstständig auf mailrelay1.lrz-muenchen.de und mailrelay2.lrz-muenchen.de um. Im anderen Fall - also insbesondere für das erstmalige Eintragen von MX-Records - wenden Sie sich bitte an hostmaster@lrz-muenchen.de mit der Bitte eines Eintrags für Ihre Maildomain.

Typo3 - Installation

2007-01-03T14:45:08Z

217.228.133.51: /* Wichtige ToDos im Typo Backend */

== Typo3 Autoinstallation ==
Wünschenswert wäre ein Script, welches eine Typo3 Grundinstallation vollautomatisch durchführt. Als ersten Schritt einige Vorüberlegungen:
Die Installation sollte nach Angabe einer Datenbank die Typo3 Verzeichnisse hochladen, auspacken und das Konfigurationsfile mit den Datenbankwerten belegen. Weiterhin sollte die Datenbank bereits einen Admin-User einige Seiten und einige Grundtemplates enthalten. Typo3 enthält ja die Möglichkeit im DB Teil der installation ein eigenes .sql File zu benutzen, welches bereits die nötigen Werte enthält.

== Grundsätzliche Installation ==

=== Uploaden ===

# Typo3 - Dummy auf den Server laden
# Aus dem Installscript /typo3/install/index.php die die() Funktion auskommentieren
# Install Skript im Browser aufrufen (Standard Passwort ist joh316)
# Passwort ändern !! und neu einloggen (evt. Schreibrecht für /typo3/typo3conf/localconf.php setzten)

=== Basic Configuration ===

# Schreibrechte für die rot markierten Ordner ändern und den den fileadmin Ordner ebenfalls schreibbar machen.
# Datenbank Zugangsdaten eingeben. Host ist in der Regel 'localhost'
# Update localconf.php klicken dann click to continue
# Jetzt die Datenbank im neuen Dropdownfeld. Auswählen
# Encryption key: Generate Knopf klicken

=== Database Analyser ===
# Benötigte Tabellen anlegen: Compare klicken - dann write to database
# Dump static data IMPORT
# (Notwendig?) Tabellen füllen mit statischen Templates typo3conf/database.sql (1.1 M) ebenfalls Compare und write to database
# admin User erstellen damit man sich im Backend einloggen kann.

'''Hinweis:''' wenn man eine gute leere Installation hat kann man diese Daten komplett in ein sql-Standardfile exportieren und bei einer frischen Typo3 Installation komplett einspielen.

=== All Configuration ===
# [gdlib_2] auf 1 stellen Wenn GDlib Version 2 Verwendet wird
# [TTFdpi] muß auf 96 stehen wenn die Schrift im Bild bei 'Basic Configuration' nicht vollständig angezeigt wird.
# [noEdit] auf 0 stellen dann kann man vom Backend-Bereich Text-Dateien (z.B. CSS-Files) verändern.
# [warning_email_addr] setzten dann bekommt man eine Email wenn sich jemand viermal falsch einloggt

=== Wichtige ToDos im Typo Backend ===
siehe auch [[Typo3 - Grundeinstellungen]]

# Passwort für Install Tool ändern
# Ab Typo4.x DB References Updaten
# Deutsche Sprachpakete im Extension Manage laden (für 3.8 die CSH Files)
# Standard Templates TS-Templates evt. HTML Template und CSS (für TV und Automaketemplate die Extensions nicht vergessen)
# Benutzer Konfiguration bzw. Page Konfiguration (UserTS und PageTS)
# Standard Extensions installieren

== Typo3 auf Unix installieren ==
Wenn man einen Shell Zugang zum Server hat, bietet sich eine Installation mit den tar Paketen an. Das geht erstens schneller als per FTP und man hat die Möglichkeit mit Symlinks zu arbeiten, die ein späteres Update erleichtern.
So gehts:
* Evt. Shell-Zugang erlauben (z.B. mit bash Terminal. Später wieder abschalten!)
* Remote Zugang z.B. mit Putty herstellen (Session > [IP], SSH /
* Entweder per FTP die tars ('''Source und Dummy''') '''hochladen''' oder direkt mit der Shell vom Server aus laden z.B. mit
wget http://prdownloads.sourceforge.net/typo3/typo3_src-4.0.4.tar.gz?download
... (siehe Typo3 Buch)

* jetzt beide Pakete '''auspacken'''

tar xzf dummy-4.0.2.tar.gz
tar xzf typo3_src-4.0.2.tar.gz

* Es entstehen die Verzeichnisse
typo3_src-4.0.2
dummy-4.0.2

der Inhalt des Dummy Paket liegt später direkt auf dem Webspace.Der Quelltext der Source im src Verzeichnis damit man später drauf verweisen kann. Deshalb '''verschieben''' wir den Inhalt des '''Dummy Paket''' eine Ebene nach unten in das Wurzelverzeichnis (die aktuelle Ebene).

''Hinweis: Eine weitere Möglichkeit wäre die Dateien im Ordner zu belassen, ihn sinnvoll umzubenennen (z.B. cms/) und die Domain z.B. als virtual Host auf den Unterordner gehen zu lassen.''
mv dummy-4.0.2/* ./

* Jetzt machen wir einen '''Symlink''' der auf das src Verzeichnis zeigt und typo3_src heißt.
(evt. ist schon ein Symlink da der vom dummyVerzeichnis nach unten, den muß man vorher löschen oder überschreiben)

ln -s typo3_src-4.0.2 typo3_src

Wenn man im Dummy Paket das typo3_src Symlink umbiegt kann man ganz schnell ein Update ausprobieren oder eine neue source testen
* Die Archive und den leeren Dummy Ordner kann man jetzt löschen:
rm -r dummy-4.0.2
rm dummy-4.0.3.tar.gz
rm typo3_src-4.0.2.tar.gz
* Im Browser müßte jetzt schon was kommen (/typo3 oder /index.php)
* Mit dem vi Editor können wir die Die Funktion im Installer auskommentieren:
vi typo3_src-4.0.2/install/index.php
* Mit i kommt man in den Einfügemodus Esc verläßt ihn :wq! speichert und schließt den Editor.

* Jetzt kann man den Typo3 Installer starten
* Um die Rechte im Terminal anzupassen kann man den Befehl chmod benutzen
=== Beschreibung der Installation aus der Datei 'install.txt' der Typo3 4.0.2 Distribution ===

<pre>
**************************
* UNIX ARCHIVES OF TYPO3 *
**************************

INTRODUCTION
============

As you have downloaded this package you seem to know already about TYPO3.
If you don't, visit http://typo3.org/ where you can find many useful
information.

This short guide lists the important steps to install this package.

By default TYPO3 installs into the folder:
http://[your.site.name]/<this_site_name>/

Read the additional instructions to install TYPO3 in the root folder:
http://[your.site.name]/

IMPORTANT NOTE
==============

Please be aware of the fact that the file transfer protocol (FTP) does not
support Symlinks. You cannot unpack these archives locally and copy them
to your server using FTP, even if the target server actually is a Unix
server.

So if you don't have shell access, try to use a terminal emulator instead.
(PHPshell to give you an example - Google knows all of them!)

If this doesn't work you'll have to stick back to the ZIP version :-(

NEWBIE INFORMATION ABOUT THE TYPO3 FILESYSTEM STRUCTURE
=======================================================

A Unix TYPO3 installation consists of two parts:
1) The "source" package
2) The "dummy" package

The dummy package contains the skeleton directory structure for a TYPO3
installation and a symlink ('typo3_src') to the location of the source
package which contains all the PHP files, images, JavaScript files, etc.
that TYPO3 needs to run.

In other words: You can have several TYPO3 installations with just one
source package. A typical directory structure looks like this:

/var/www/typo3_src-3.8.1/ # the untared 3.8.0 source package
/var/www/typo3_src-4.0/ # the untared 4.0 source package
/var/www/installation1/ # the untared dummy package of a TYPO3
# installation running on TYPO3 3.8.1
/typo3_src --> ../typo3_src-3.8.1/ # a symlink to the 3.8.1 source
/typo3conf/
/typo3temp/
/fileadmin/
/.../
/var/www/installation2/ # the untared dummy package of a TYPO3
# installation running on TYPO3 4.0
/typo3_src --> ../typo3_src-4.0/ # a symlink to the 4.0 source
/typo3conf/
/typo3temp/
/fileadmin/
/.../

As you see, the two TYPO3-installations (possibly with different domains)
can use the same TYPO3 source package. You can even change the source
package simply be changing the symlink inside the installation directory.

STEP BY STEP
============

1 Get the TYPO3 source package and the TYPO3 dummy package.

2 Copy the archives to the web root of your server.
(Debian default is /var/www/, SuSE default is /srv/www/)

3 Unpack the archives:
$ tar xzf typo3_src-<version>.tar.gz
$ tar xfz dummy-<version>.tar.gz

4 Rename the dummy-<version> directory to fit your needs and make sure it
is accessible by your webserver (for example by creating a virtual
host). We assume you rename the directory to cms:
$ mv dummy-<version> cms

5 Set permissions (as root): There are at least two options.
These steps will make four directories writable for the webserver:
- cms/fileadmin/
- cms/typo3conf/
- cms/typo3temp/
- cms/uploads/

5.a (recommended)
Run these commands as root in the cms/ directory:
# chgrp -R <wwwserver> fileadmin typo3conf typo3temp uploads
# chmod -R g+w,o-rwx fileadmin typo3conf typo3temp uploads

... where <wwwserver> is the name of the group your webserver
is running as

5.b (insecure but easy to apply)
I repeat: This is insecure!
Do not use this method if you are working on a shared server!

Simply run this command:
$ chmod -R a+w fileadmin typo3conf typo3temp uploads

6 Check the symlink cms/typo3_src and make sure it points to the source
directory.
(See above: "Newbie information about the TYPO3 filesystem structure")

7 In your browser, visit
http://[your.site.name]/cms/

8 Follow the instructions in the 1-2-3 install tool

9 From this point, you can access the backend through
http://[your.site.name]/cms/typo3/
with the username "admin" and password "password".

That's it :-)

INSTALLING TYPO3 IN THE WEBROOT FOLDER
======================================

1 Follow the steps 1-6 above.

2 Move the files in the cms/ folder up one level.

$ cd cms
$ mv * ../
$ cd ../

3 Update the symlink

$ rm typo3_src
$ ln -s ./typo3_src-<version> typo3_src

4 Now TYPO3 runs in http://[your.site.name]/

That's it :-)

WHAT SHOULD YOU DO IF YOU HAVE A PROBLEM?
=========================================

TYPO3 is a powerful and complex professional application. When you start
out there will be many things you don´t understand, or that don't seem to
make sense. There is a widely used mailing list (more information on
typo3.com & typo3.org) where many experienced users and developers
lurk... they are always willing to help, provided you followed these steps
BEFORE you ask your question:

1 - Read all available documentation carefully

2 - Read the webserver error logfiles
(for example /var/log/apache/error.log)

3 - Read all available documentation again

4 - Search the mailing list archive carefully

5 - If you still can't figure it out - ask the list...:
- Newsgroup: news://news.netfielders.de/
- Mailing lists: http://lists.netfielders.de/

When posting to one of the lists, see the following guidelines...
- Be polite
Always include the version of used TYPO3 and server environment
(phpinfo())... note that this is available within the TYPO3
Install Tool
- Be as specific and clear as possible - questions like "my TYPO3
installation does not work - what can I do???" will be ignored.
Although English may not be your first language, if those reading
your posting can't understand it, you won't get the help you need
- If you are really having a tough time getting something working,
stay cool and don't criticise or flame. Problems are normally
caused by lack of research into the documentation, or
misunderstanding, not because of bugs. Be logical about your
troubleshooting, and you'll get there

6 - If you have identified a genuine new bug, report it at
http://bugs.typo3.org/ ...do not post to the list about it

Please be aware that if you ask questions that are answered in the
available documentation, you may not get a reply, or any help from the
developers or any experienced users!

We are aware that there is still some work to be done on the
documentation, and the platform for user support... please forgive us for
not having all these gaps filled. If you feel that some information is
missing, hard to find or just plain wrong, or you have a suggestion on
improving TYPO3 or the "support services", please let us know so that we
can do what is necessary. You could also volunteer to help with the work!

(c) Nigel Jackson, Ingmar Schlecht
Unix related additions made by Michael Stucki and some Wiki users:
http://wiki.typo3.org/index.php/Tgz-INSTALL.txt

-- Michael Stucki <michael@typo3.org> Sun, 26 Mar 2006 22:10:53 +0100
</pre>

== Image Magick über SSH Zugang auf VMWare ==
Quelle: http://www.4many.net/imagemagick_setup.html

<pre>
ImageMagick Installation on Virtual Host Account with SSH Access
Situation: Customer got virtual host with ssh access
TYPO3 was installed
no ImageMagick
after installing static linked package imagemagick-4.2.9_i386-static-1.tar.gz
TYPO3 complained that no valid version could be found
Problem: It turned out that due to the virtual setup and the setup of the Apache the environment got lost and the ImageMagick.so.9 couldn't be found during the exec()
Challenge:

1. convince the provider to change the setup
Nice try!
2. convince the provider to install ImageMagick globally
No support for third party products
3. fix it in TYPO3 to pass environment
possible solution, just no time to do so

Solution: Fixed it on script level

1. move required executable to *.bin, i.e.

mv convert convert.bin
mv combine combine.bin
mv identify identify.bin

2. create script

pico convert

3. content of the script file

#!/usr/local/bin/bash
export PATH; PATH="/home/usr203227042/ImageMagick-4.2.9/bin:$PATH"
export MAGICK_HOME="/home/usr203227042/ImageMagick-4.2.9"
export LD_LIBRARY_PATH="/home/usr203227042/ImageMagick-4.2.9/lib"
/home/usr203227042/ImageMagick-4.2.9/bin/convert.bin $*

4. make script executable

chmod 755 convert

5. repeat steps 2.-4. for combine and identify and don't forget to change convert.bin to the appropriate value
</pre>

== Trennung von Produktions und Live-Server (Bearbeitung der Seiten und Darstellung) ==
Für den Website-Betrieb sind die Verzeichnisse TSLib und T3Lib notwendig um eine Website auszuliefern.

Für die Bearbeitung von Seiten sind die Dateien im Typo3 Verzeichnis zuständig. Ohne Typo3 Verzeichnis gibt es kein Backend aber die Seiten funktionieren trotzdem. Ein gutes Mittel um die Seiten vor Angreifern zu schützen.

siehe auch [[Typo3 - Update]]

== Zentrale Typo3-Installation vs mehrere Typo3 ==

Verschiedene Gründe:
1. Es gibt aus Sicherheitsgründen keinen Remote Zugang für unseren Server. Das macht es etwas umständlicher.

2. Von Version 3.7-3.8 gab es bei manchen Extensions Probleme mit Updates, bzw. es gab Extensions die das Typo auch mal aus dem Tritt brachten. Wenn wir alle Präsenzen auf einem Typo laufen lassen würden wären bei einem Fehler alle Homepages betroffen und Nebenwirkungen unter Umständen nicht so einfach zu sehen. Mit der getrennten Installation kann man auch bei sehr experimentellen Extensions relativ sicher updaten. Auch wenn wir verschiedene Datenbanken benutzen würden. Erst ab Version 4 gibt es außerdem die Möglichkeit Seiten vernünftig zu testen bevor Sie bei Änderungen Online gehen. Das war bisher nur mit einer ziemlich umständlichen Extension möglich.

Manche würden das vielleicht als Übervorsichtig auslegen. Im Endeffekt hat es nur den Nachteil der längeren Uploadzeiten. Speicherplatz spielt im Grunde kaum eine Rolle. Der Server wird auch nicht wesentlich mehr belastet. Weil die Skripte egal ob in einer oder in mehreren Typos ja immer für jede Anfrage abgearbeitet werden.

3. Wir haben den Kunden eine komplette Installation verkauft mit der Sie machen können was Sie wollen. Dafür bekommen Sie natürlich auch eine eigene Installation.

Für die Miettypos werden wir allerdings eine einzelne Installation benutzen. Für eine Agentur bietet sich ebenfalls eine eigene Installation an auf der die betreuten Präsenzen laufen.

4. Manche Typos laufen auf anderen Servern ;-) Z.T. mit Anpassungen im Quellcode vom Typo.

=== Weitere Pro und Kontra Argumente ===

* Zeitersparnis beim Update in zentraler Installation
* Ein Backend=>Admin Account unübersichtlich

== automatische Installation ==

Überlegungen zum automatischen Installieren:

Ausgehend von einer fertigen Grundinstallation mit Benutzern und Rechten plus einigen Dummy-Seiten müßten sich per Knopfdruck Installationen anfertigen lassen.

Einzelschritte:
* Notwendige Dateien (Typo3 System, Filadmin Ordner)
* Datenbank (inkl. Benutzer und Dummy Inhalten)
* Config-Datei (automatisiert ?)

== Typo3 - Update ==
=== 3.8 auf 4.0 ===
Ordner typo3, t3lib ersetzen
misc aufspielen
index.php ersetzen (root)

Update Wizard im Install Tool ausführen

Im Database Analyzer Compare und danach die erforderlichen Updates der Datenbanktabellen ausführen.

Nicht benötigte Extensions entfernen und entsprechend Templates anpassen

Alte Sprachpakete löschen und mit dem Translation Handling im Extension Manager die benötigten Sprachen aktualisieren.

=== Kompatibilitätsmodus 3.8 für Version 4 ===
Nach Update von 3.8.x auf 4.0 läuft das Typo zunächst im Kompatibilitätsmodus.

Folgendes sollte verändert werden damit die Ausgabe auch nach umschalten wieder geht.
The following updates will be performed:

changeCompatibilityVersion
TYPO3 output is currently compatible to version 3.8. To use all the new features in the current TYPO3 version, make sure you follow the guidelines below to upgrade without problems.

Follow the steps below carefully and confirm every step!
You will see this list again after you performed the update.
CMS Frontend

*

Word separator character for simulateStaticDocument is changed from underscore (_) to hyphen (-) to make URLs more friendly for search enginesURLs that are already existing (e.g. external links to your site) will still work like before.

You can set the separator character back to an underscore by putting the following line into the Setup section of your Page TypoScript template:

config.simulateStaticDocuments_replacementChar = _
*

CSS Stylesheets and JavaScript are put into an external file by default.

Technically, that means that the default value of "config.inlineStyle2TempFile" is now set to "1" and that of "config.removeDefaultJS" to "external"

Acknowledged
CSS Styled Content: Accessibility improvements

The rendering of the following elements will change:

* tt_content.menu (used f.e. for sitemaps): Instead of div-tags, lists are used now.

* tt_content.mailform: Mailforms do not use tables anymore, instead, they use the div-tag. Besides that, mailforms are accessible now.

* The p-tag has been removed from all table cells.

* CSS based "image" and "text with image"
As the extension cron_cssstyledimgtext has been merged into the core, rendering of the content elements "image" and "text with image" has been changed to be CSS instead of table based. Read the 4.0 release notes for further information.

You will have to update your stylesheets to comply with these changes.

Acknowledged

Check all (ignore selection above)
WARNING: this might break the output of your website.
Show database queries performed

Typo3 - Grundeinstellungen

2007-01-03T14:45:00Z

217.228.133.51:

== Kompatibilitätsmodus ==
To Do...

# Passwort für Install Tool ändern
# Ab Typo4.x DB References Updaten
# Deutsche Sprachpakete im Extension Manage laden (für 3.8 die CSH Files)
# Standard Templates TS-Templates evt. HTML Template und CSS (für TV und Automaketemplate die Extensions nicht vergessen)
# Benutzer Konfiguration bzw. Page Konfiguration (UserTS und PageTS)
# Standard Extensions installieren

Typo3 - Installation

2007-01-03T14:43:28Z

217.228.133.51: /* Database Analyser */

== Typo3 Autoinstallation ==
Wünschenswert wäre ein Script, welches eine Typo3 Grundinstallation vollautomatisch durchführt. Als ersten Schritt einige Vorüberlegungen:
Die Installation sollte nach Angabe einer Datenbank die Typo3 Verzeichnisse hochladen, auspacken und das Konfigurationsfile mit den Datenbankwerten belegen. Weiterhin sollte die Datenbank bereits einen Admin-User einige Seiten und einige Grundtemplates enthalten. Typo3 enthält ja die Möglichkeit im DB Teil der installation ein eigenes .sql File zu benutzen, welches bereits die nötigen Werte enthält.

== Grundsätzliche Installation ==

=== Uploaden ===

# Typo3 - Dummy auf den Server laden
# Aus dem Installscript /typo3/install/index.php die die() Funktion auskommentieren
# Install Skript im Browser aufrufen (Standard Passwort ist joh316)
# Passwort ändern !! und neu einloggen (evt. Schreibrecht für /typo3/typo3conf/localconf.php setzten)

=== Basic Configuration ===

# Schreibrechte für die rot markierten Ordner ändern und den den fileadmin Ordner ebenfalls schreibbar machen.
# Datenbank Zugangsdaten eingeben. Host ist in der Regel 'localhost'
# Update localconf.php klicken dann click to continue
# Jetzt die Datenbank im neuen Dropdownfeld. Auswählen
# Encryption key: Generate Knopf klicken

=== Database Analyser ===
# Benötigte Tabellen anlegen: Compare klicken - dann write to database
# Dump static data IMPORT
# (Notwendig?) Tabellen füllen mit statischen Templates typo3conf/database.sql (1.1 M) ebenfalls Compare und write to database
# admin User erstellen damit man sich im Backend einloggen kann.

'''Hinweis:''' wenn man eine gute leere Installation hat kann man diese Daten komplett in ein sql-Standardfile exportieren und bei einer frischen Typo3 Installation komplett einspielen.

=== All Configuration ===
# [gdlib_2] auf 1 stellen Wenn GDlib Version 2 Verwendet wird
# [TTFdpi] muß auf 96 stehen wenn die Schrift im Bild bei 'Basic Configuration' nicht vollständig angezeigt wird.
# [noEdit] auf 0 stellen dann kann man vom Backend-Bereich Text-Dateien (z.B. CSS-Files) verändern.
# [warning_email_addr] setzten dann bekommt man eine Email wenn sich jemand viermal falsch einloggt

=== Wichtige ToDos im Typo Backend ===
# Passwort für Install Tool ändern
# Ab Typo4.x DB References Updaten
# Deutsche Sprachpakete im Extension Manage laden (für 3.8 die CSH Files)
# Standard Templates TS-Templates evt. HTML Template und CSS (für TV und Automaketemplate die Extensions nicht vergessen)
# Benutzer Konfiguration bzw. Page Konfiguration (UserTS und PageTS)
# Standard Extensions installieren

== Typo3 auf Unix installieren ==
Wenn man einen Shell Zugang zum Server hat, bietet sich eine Installation mit den tar Paketen an. Das geht erstens schneller als per FTP und man hat die Möglichkeit mit Symlinks zu arbeiten, die ein späteres Update erleichtern.
So gehts:
* Evt. Shell-Zugang erlauben (z.B. mit bash Terminal. Später wieder abschalten!)
* Remote Zugang z.B. mit Putty herstellen (Session > [IP], SSH /
* Entweder per FTP die tars ('''Source und Dummy''') '''hochladen''' oder direkt mit der Shell vom Server aus laden z.B. mit
wget http://prdownloads.sourceforge.net/typo3/typo3_src-4.0.4.tar.gz?download
... (siehe Typo3 Buch)

* jetzt beide Pakete '''auspacken'''

tar xzf dummy-4.0.2.tar.gz
tar xzf typo3_src-4.0.2.tar.gz

* Es entstehen die Verzeichnisse
typo3_src-4.0.2
dummy-4.0.2

der Inhalt des Dummy Paket liegt später direkt auf dem Webspace.Der Quelltext der Source im src Verzeichnis damit man später drauf verweisen kann. Deshalb '''verschieben''' wir den Inhalt des '''Dummy Paket''' eine Ebene nach unten in das Wurzelverzeichnis (die aktuelle Ebene).

''Hinweis: Eine weitere Möglichkeit wäre die Dateien im Ordner zu belassen, ihn sinnvoll umzubenennen (z.B. cms/) und die Domain z.B. als virtual Host auf den Unterordner gehen zu lassen.''
mv dummy-4.0.2/* ./

* Jetzt machen wir einen '''Symlink''' der auf das src Verzeichnis zeigt und typo3_src heißt.
(evt. ist schon ein Symlink da der vom dummyVerzeichnis nach unten, den muß man vorher löschen oder überschreiben)

ln -s typo3_src-4.0.2 typo3_src

Wenn man im Dummy Paket das typo3_src Symlink umbiegt kann man ganz schnell ein Update ausprobieren oder eine neue source testen
* Die Archive und den leeren Dummy Ordner kann man jetzt löschen:
rm -r dummy-4.0.2
rm dummy-4.0.3.tar.gz
rm typo3_src-4.0.2.tar.gz
* Im Browser müßte jetzt schon was kommen (/typo3 oder /index.php)
* Mit dem vi Editor können wir die Die Funktion im Installer auskommentieren:
vi typo3_src-4.0.2/install/index.php
* Mit i kommt man in den Einfügemodus Esc verläßt ihn :wq! speichert und schließt den Editor.

* Jetzt kann man den Typo3 Installer starten
* Um die Rechte im Terminal anzupassen kann man den Befehl chmod benutzen
=== Beschreibung der Installation aus der Datei 'install.txt' der Typo3 4.0.2 Distribution ===

<pre>
**************************
* UNIX ARCHIVES OF TYPO3 *
**************************

INTRODUCTION
============

As you have downloaded this package you seem to know already about TYPO3.
If you don't, visit http://typo3.org/ where you can find many useful
information.

This short guide lists the important steps to install this package.

By default TYPO3 installs into the folder:
http://[your.site.name]/<this_site_name>/

Read the additional instructions to install TYPO3 in the root folder:
http://[your.site.name]/

IMPORTANT NOTE
==============

Please be aware of the fact that the file transfer protocol (FTP) does not
support Symlinks. You cannot unpack these archives locally and copy them
to your server using FTP, even if the target server actually is a Unix
server.

So if you don't have shell access, try to use a terminal emulator instead.
(PHPshell to give you an example - Google knows all of them!)

If this doesn't work you'll have to stick back to the ZIP version :-(

NEWBIE INFORMATION ABOUT THE TYPO3 FILESYSTEM STRUCTURE
=======================================================

A Unix TYPO3 installation consists of two parts:
1) The "source" package
2) The "dummy" package

The dummy package contains the skeleton directory structure for a TYPO3
installation and a symlink ('typo3_src') to the location of the source
package which contains all the PHP files, images, JavaScript files, etc.
that TYPO3 needs to run.

In other words: You can have several TYPO3 installations with just one
source package. A typical directory structure looks like this:

/var/www/typo3_src-3.8.1/ # the untared 3.8.0 source package
/var/www/typo3_src-4.0/ # the untared 4.0 source package
/var/www/installation1/ # the untared dummy package of a TYPO3
# installation running on TYPO3 3.8.1
/typo3_src --> ../typo3_src-3.8.1/ # a symlink to the 3.8.1 source
/typo3conf/
/typo3temp/
/fileadmin/
/.../
/var/www/installation2/ # the untared dummy package of a TYPO3
# installation running on TYPO3 4.0
/typo3_src --> ../typo3_src-4.0/ # a symlink to the 4.0 source
/typo3conf/
/typo3temp/
/fileadmin/
/.../

As you see, the two TYPO3-installations (possibly with different domains)
can use the same TYPO3 source package. You can even change the source
package simply be changing the symlink inside the installation directory.

STEP BY STEP
============

1 Get the TYPO3 source package and the TYPO3 dummy package.

2 Copy the archives to the web root of your server.
(Debian default is /var/www/, SuSE default is /srv/www/)

3 Unpack the archives:
$ tar xzf typo3_src-<version>.tar.gz
$ tar xfz dummy-<version>.tar.gz

4 Rename the dummy-<version> directory to fit your needs and make sure it
is accessible by your webserver (for example by creating a virtual
host). We assume you rename the directory to cms:
$ mv dummy-<version> cms

5 Set permissions (as root): There are at least two options.
These steps will make four directories writable for the webserver:
- cms/fileadmin/
- cms/typo3conf/
- cms/typo3temp/
- cms/uploads/

5.a (recommended)
Run these commands as root in the cms/ directory:
# chgrp -R <wwwserver> fileadmin typo3conf typo3temp uploads
# chmod -R g+w,o-rwx fileadmin typo3conf typo3temp uploads

... where <wwwserver> is the name of the group your webserver
is running as

5.b (insecure but easy to apply)
I repeat: This is insecure!
Do not use this method if you are working on a shared server!

Simply run this command:
$ chmod -R a+w fileadmin typo3conf typo3temp uploads

6 Check the symlink cms/typo3_src and make sure it points to the source
directory.
(See above: "Newbie information about the TYPO3 filesystem structure")

7 In your browser, visit
http://[your.site.name]/cms/

8 Follow the instructions in the 1-2-3 install tool

9 From this point, you can access the backend through
http://[your.site.name]/cms/typo3/
with the username "admin" and password "password".

That's it :-)

INSTALLING TYPO3 IN THE WEBROOT FOLDER
======================================

1 Follow the steps 1-6 above.

2 Move the files in the cms/ folder up one level.

$ cd cms
$ mv * ../
$ cd ../

3 Update the symlink

$ rm typo3_src
$ ln -s ./typo3_src-<version> typo3_src

4 Now TYPO3 runs in http://[your.site.name]/

That's it :-)

WHAT SHOULD YOU DO IF YOU HAVE A PROBLEM?
=========================================

TYPO3 is a powerful and complex professional application. When you start
out there will be many things you don´t understand, or that don't seem to
make sense. There is a widely used mailing list (more information on
typo3.com & typo3.org) where many experienced users and developers
lurk... they are always willing to help, provided you followed these steps
BEFORE you ask your question:

1 - Read all available documentation carefully

2 - Read the webserver error logfiles
(for example /var/log/apache/error.log)

3 - Read all available documentation again

4 - Search the mailing list archive carefully

5 - If you still can't figure it out - ask the list...:
- Newsgroup: news://news.netfielders.de/
- Mailing lists: http://lists.netfielders.de/

When posting to one of the lists, see the following guidelines...
- Be polite
Always include the version of used TYPO3 and server environment
(phpinfo())... note that this is available within the TYPO3
Install Tool
- Be as specific and clear as possible - questions like "my TYPO3
installation does not work - what can I do???" will be ignored.
Although English may not be your first language, if those reading
your posting can't understand it, you won't get the help you need
- If you are really having a tough time getting something working,
stay cool and don't criticise or flame. Problems are normally
caused by lack of research into the documentation, or
misunderstanding, not because of bugs. Be logical about your
troubleshooting, and you'll get there

6 - If you have identified a genuine new bug, report it at
http://bugs.typo3.org/ ...do not post to the list about it

Please be aware that if you ask questions that are answered in the
available documentation, you may not get a reply, or any help from the
developers or any experienced users!

We are aware that there is still some work to be done on the
documentation, and the platform for user support... please forgive us for
not having all these gaps filled. If you feel that some information is
missing, hard to find or just plain wrong, or you have a suggestion on
improving TYPO3 or the "support services", please let us know so that we
can do what is necessary. You could also volunteer to help with the work!

(c) Nigel Jackson, Ingmar Schlecht
Unix related additions made by Michael Stucki and some Wiki users:
http://wiki.typo3.org/index.php/Tgz-INSTALL.txt

-- Michael Stucki <michael@typo3.org> Sun, 26 Mar 2006 22:10:53 +0100
</pre>

== Image Magick über SSH Zugang auf VMWare ==
Quelle: http://www.4many.net/imagemagick_setup.html

<pre>
ImageMagick Installation on Virtual Host Account with SSH Access
Situation: Customer got virtual host with ssh access
TYPO3 was installed
no ImageMagick
after installing static linked package imagemagick-4.2.9_i386-static-1.tar.gz
TYPO3 complained that no valid version could be found
Problem: It turned out that due to the virtual setup and the setup of the Apache the environment got lost and the ImageMagick.so.9 couldn't be found during the exec()
Challenge:

1. convince the provider to change the setup
Nice try!
2. convince the provider to install ImageMagick globally
No support for third party products
3. fix it in TYPO3 to pass environment
possible solution, just no time to do so

Solution: Fixed it on script level

1. move required executable to *.bin, i.e.

mv convert convert.bin
mv combine combine.bin
mv identify identify.bin

2. create script

pico convert

3. content of the script file

#!/usr/local/bin/bash
export PATH; PATH="/home/usr203227042/ImageMagick-4.2.9/bin:$PATH"
export MAGICK_HOME="/home/usr203227042/ImageMagick-4.2.9"
export LD_LIBRARY_PATH="/home/usr203227042/ImageMagick-4.2.9/lib"
/home/usr203227042/ImageMagick-4.2.9/bin/convert.bin $*

4. make script executable

chmod 755 convert

5. repeat steps 2.-4. for combine and identify and don't forget to change convert.bin to the appropriate value
</pre>

== Trennung von Produktions und Live-Server (Bearbeitung der Seiten und Darstellung) ==
Für den Website-Betrieb sind die Verzeichnisse TSLib und T3Lib notwendig um eine Website auszuliefern.

Für die Bearbeitung von Seiten sind die Dateien im Typo3 Verzeichnis zuständig. Ohne Typo3 Verzeichnis gibt es kein Backend aber die Seiten funktionieren trotzdem. Ein gutes Mittel um die Seiten vor Angreifern zu schützen.

siehe auch [[Typo3 - Update]]

== Zentrale Typo3-Installation vs mehrere Typo3 ==

Verschiedene Gründe:
1. Es gibt aus Sicherheitsgründen keinen Remote Zugang für unseren Server. Das macht es etwas umständlicher.

2. Von Version 3.7-3.8 gab es bei manchen Extensions Probleme mit Updates, bzw. es gab Extensions die das Typo auch mal aus dem Tritt brachten. Wenn wir alle Präsenzen auf einem Typo laufen lassen würden wären bei einem Fehler alle Homepages betroffen und Nebenwirkungen unter Umständen nicht so einfach zu sehen. Mit der getrennten Installation kann man auch bei sehr experimentellen Extensions relativ sicher updaten. Auch wenn wir verschiedene Datenbanken benutzen würden. Erst ab Version 4 gibt es außerdem die Möglichkeit Seiten vernünftig zu testen bevor Sie bei Änderungen Online gehen. Das war bisher nur mit einer ziemlich umständlichen Extension möglich.

Manche würden das vielleicht als Übervorsichtig auslegen. Im Endeffekt hat es nur den Nachteil der längeren Uploadzeiten. Speicherplatz spielt im Grunde kaum eine Rolle. Der Server wird auch nicht wesentlich mehr belastet. Weil die Skripte egal ob in einer oder in mehreren Typos ja immer für jede Anfrage abgearbeitet werden.

3. Wir haben den Kunden eine komplette Installation verkauft mit der Sie machen können was Sie wollen. Dafür bekommen Sie natürlich auch eine eigene Installation.

Für die Miettypos werden wir allerdings eine einzelne Installation benutzen. Für eine Agentur bietet sich ebenfalls eine eigene Installation an auf der die betreuten Präsenzen laufen.

4. Manche Typos laufen auf anderen Servern ;-) Z.T. mit Anpassungen im Quellcode vom Typo.

=== Weitere Pro und Kontra Argumente ===

* Zeitersparnis beim Update in zentraler Installation
* Ein Backend=>Admin Account unübersichtlich

== automatische Installation ==

Überlegungen zum automatischen Installieren:

Ausgehend von einer fertigen Grundinstallation mit Benutzern und Rechten plus einigen Dummy-Seiten müßten sich per Knopfdruck Installationen anfertigen lassen.

Einzelschritte:
* Notwendige Dateien (Typo3 System, Filadmin Ordner)
* Datenbank (inkl. Benutzer und Dummy Inhalten)
* Config-Datei (automatisiert ?)

== Typo3 - Update ==
=== 3.8 auf 4.0 ===
Ordner typo3, t3lib ersetzen
misc aufspielen
index.php ersetzen (root)

Update Wizard im Install Tool ausführen

Im Database Analyzer Compare und danach die erforderlichen Updates der Datenbanktabellen ausführen.

Nicht benötigte Extensions entfernen und entsprechend Templates anpassen

Alte Sprachpakete löschen und mit dem Translation Handling im Extension Manager die benötigten Sprachen aktualisieren.

=== Kompatibilitätsmodus 3.8 für Version 4 ===
Nach Update von 3.8.x auf 4.0 läuft das Typo zunächst im Kompatibilitätsmodus.

Folgendes sollte verändert werden damit die Ausgabe auch nach umschalten wieder geht.
The following updates will be performed:

changeCompatibilityVersion
TYPO3 output is currently compatible to version 3.8. To use all the new features in the current TYPO3 version, make sure you follow the guidelines below to upgrade without problems.

Follow the steps below carefully and confirm every step!
You will see this list again after you performed the update.
CMS Frontend

*

Word separator character for simulateStaticDocument is changed from underscore (_) to hyphen (-) to make URLs more friendly for search enginesURLs that are already existing (e.g. external links to your site) will still work like before.

You can set the separator character back to an underscore by putting the following line into the Setup section of your Page TypoScript template:

config.simulateStaticDocuments_replacementChar = _
*

CSS Stylesheets and JavaScript are put into an external file by default.

Technically, that means that the default value of "config.inlineStyle2TempFile" is now set to "1" and that of "config.removeDefaultJS" to "external"

Acknowledged
CSS Styled Content: Accessibility improvements

The rendering of the following elements will change:

* tt_content.menu (used f.e. for sitemaps): Instead of div-tags, lists are used now.

* tt_content.mailform: Mailforms do not use tables anymore, instead, they use the div-tag. Besides that, mailforms are accessible now.

* The p-tag has been removed from all table cells.

* CSS based "image" and "text with image"
As the extension cron_cssstyledimgtext has been merged into the core, rendering of the content elements "image" and "text with image" has been changed to be CSS instead of table based. Read the 4.0 release notes for further information.

You will have to update your stylesheets to comply with these changes.

Acknowledged

Check all (ignore selection above)
WARNING: this might break the output of your website.
Show database queries performed

Typo3 - Checkliste

2007-01-03T14:39:54Z

217.228.133.51: /* Pflichtenheft */

Hier findest du Checklisten zu verschiedenen Aufgaben, bzw. eine Checkliste für den kompletten Webauftritt.
== Pflichtenheft ==
* '''Benutzer Account'''
** Anlegen
** Datenbank anlegen

* Typo3 aufspielen (siehe [[Typo3 - Installation]])
** KAS-Server -> Autoinstallation über Kasserver
** Server mit Shell-Zugang -> Autoinstallation über Script (ToDo)
** Server mit Shell-Zugang -> Installation über Shell
** Server ohne Shell-Zugang -> FTP Upload (langwierig)

* Grundeinstellungen (siehe [[Typo3 - Grundeinstellungen]])
** Sprache des Backends
** TypoScript Grundeinstellungen
** Standardbenutzer

* '''HTML-Vorlage'''
** inkl. CSS und
** Menü mit den Zuständen normal hover und der Klasse on für gerade aktive Punkte
** ids für alle Bereiche die später mit dem Autoparser geparst werden anlegen. Alternativ entsprechende Marker oder Subparts anlegen.

* '''TypoScript Main-Template'''
** '''Variante 1'''
*** Marker ins HTML-Template einbinden
*** Marker im TS Anlegen
*** CSS einbinden
** '''Variante 2'''
*** Automaketemplate (Auto Template Parser konfigurieren)
*** Subparts anlegen (erst als TEXT-Objekte zum Testen)
** '''Navigation'''
** '''Inhalte formatieren (CSS, TS)'''
*** Text
*** Text mit Bild
*** Tabellen
*** Filelinks
*** Bulletlist
** '''Allgemeine Einstellungen'''
** '''Benutzer-Einstellungen (Rechte, Backend...)'''
** '''HTML-Area konfiguren'''
** '''Mehrsprachigkeit'''

* '''Extensions'''
** '''News-Plugin'''
** '''Gallerie'
** '''Weitere Plugins'''

== Allgemeine Einstellungen ==

== Mehrsprachigkeit realisieren ==

== Benutzer ==

Typo3 - Installation

2007-01-03T14:08:50Z

217.228.133.51: /* Typo3 auf Unix installieren */

== Typo3 Autoinstallation ==
Wünschenswert wäre ein Script, welches eine Typo3 Grundinstallation vollautomatisch durchführt. Als ersten Schritt einige Vorüberlegungen:
Die Installation sollte nach Angabe einer Datenbank die Typo3 Verzeichnisse hochladen, auspacken und das Konfigurationsfile mit den Datenbankwerten belegen. Weiterhin sollte die Datenbank bereits einen Admin-User einige Seiten und einige Grundtemplates enthalten. Typo3 enthält ja die Möglichkeit im DB Teil der installation ein eigenes .sql File zu benutzen, welches bereits die nötigen Werte enthält.

== Grundsätzliche Installation ==

=== Uploaden ===

# Typo3 - Dummy auf den Server laden
# Aus dem Installscript /typo3/install/index.php die die() Funktion auskommentieren
# Install Skript im Browser aufrufen (Standard Passwort ist joh316)
# Passwort ändern !! und neu einloggen (evt. Schreibrecht für /typo3/typo3conf/localconf.php setzten)

=== Basic Configuration ===

# Schreibrechte für die rot markierten Ordner ändern und den den fileadmin Ordner ebenfalls schreibbar machen.
# Datenbank Zugangsdaten eingeben. Host ist in der Regel 'localhost'
# Update localconf.php klicken dann click to continue
# Jetzt die Datenbank im neuen Dropdownfeld. Auswählen
# Encryption key: Generate Knopf klicken

=== Database Analyser ===
# Benötigte Tabellen anlegen: Compare klicken - dann write to database
# Dump static data IMPORT
# (Notwendig?) Tabellen füllen mit statischen Templates typo3conf/database.sql (1.1 M) ebenfalls Compare und write to database
# admin User erstellen damit man sich im Backend einloggen kann.

=== All Configuration ===
# [gdlib_2] auf 1 stellen Wenn GDlib Version 2 Verwendet wird
# [TTFdpi] muß auf 96 stehen wenn die Schrift im Bild bei 'Basic Configuration' nicht vollständig angezeigt wird.
# [noEdit] auf 0 stellen dann kann man vom Backend-Bereich Text-Dateien (z.B. CSS-Files) verändern.
# [warning_email_addr] setzten dann bekommt man eine Email wenn sich jemand viermal falsch einloggt

=== Wichtige ToDos im Typo Backend ===
# Passwort für Install Tool ändern
# Ab Typo4.x DB References Updaten
# Deutsche Sprachpakete im Extension Manage laden (für 3.8 die CSH Files)
# Standard Templates TS-Templates evt. HTML Template und CSS (für TV und Automaketemplate die Extensions nicht vergessen)
# Benutzer Konfiguration bzw. Page Konfiguration (UserTS und PageTS)
# Standard Extensions installieren

== Typo3 auf Unix installieren ==
Wenn man einen Shell Zugang zum Server hat, bietet sich eine Installation mit den tar Paketen an. Das geht erstens schneller als per FTP und man hat die Möglichkeit mit Symlinks zu arbeiten, die ein späteres Update erleichtern.
So gehts:
* Evt. Shell-Zugang erlauben (z.B. mit bash Terminal. Später wieder abschalten!)
* Remote Zugang z.B. mit Putty herstellen (Session > [IP], SSH /
* Entweder per FTP die tars ('''Source und Dummy''') '''hochladen''' oder direkt mit der Shell vom Server aus laden z.B. mit
wget http://prdownloads.sourceforge.net/typo3/typo3_src-4.0.4.tar.gz?download
... (siehe Typo3 Buch)

* jetzt beide Pakete '''auspacken'''

tar xzf dummy-4.0.2.tar.gz
tar xzf typo3_src-4.0.2.tar.gz

* Es entstehen die Verzeichnisse
typo3_src-4.0.2
dummy-4.0.2

der Inhalt des Dummy Paket liegt später direkt auf dem Webspace.Der Quelltext der Source im src Verzeichnis damit man später drauf verweisen kann. Deshalb '''verschieben''' wir den Inhalt des '''Dummy Paket''' eine Ebene nach unten in das Wurzelverzeichnis (die aktuelle Ebene).

''Hinweis: Eine weitere Möglichkeit wäre die Dateien im Ordner zu belassen, ihn sinnvoll umzubenennen (z.B. cms/) und die Domain z.B. als virtual Host auf den Unterordner gehen zu lassen.''
mv dummy-4.0.2/* ./

* Jetzt machen wir einen '''Symlink''' der auf das src Verzeichnis zeigt und typo3_src heißt.
(evt. ist schon ein Symlink da der vom dummyVerzeichnis nach unten, den muß man vorher löschen oder überschreiben)

ln -s typo3_src-4.0.2 typo3_src

Wenn man im Dummy Paket das typo3_src Symlink umbiegt kann man ganz schnell ein Update ausprobieren oder eine neue source testen
* Die Archive und den leeren Dummy Ordner kann man jetzt löschen:
rm -r dummy-4.0.2
rm dummy-4.0.3.tar.gz
rm typo3_src-4.0.2.tar.gz
* Im Browser müßte jetzt schon was kommen (/typo3 oder /index.php)
* Mit dem vi Editor können wir die Die Funktion im Installer auskommentieren:
vi typo3_src-4.0.2/install/index.php
* Mit i kommt man in den Einfügemodus Esc verläßt ihn :wq! speichert und schließt den Editor.

* Jetzt kann man den Typo3 Installer starten
* Um die Rechte im Terminal anzupassen kann man den Befehl chmod benutzen
=== Beschreibung der Installation aus der Datei 'install.txt' der Typo3 4.0.2 Distribution ===

<pre>
**************************
* UNIX ARCHIVES OF TYPO3 *
**************************

INTRODUCTION
============

As you have downloaded this package you seem to know already about TYPO3.
If you don't, visit http://typo3.org/ where you can find many useful
information.

This short guide lists the important steps to install this package.

By default TYPO3 installs into the folder:
http://[your.site.name]/<this_site_name>/

Read the additional instructions to install TYPO3 in the root folder:
http://[your.site.name]/

IMPORTANT NOTE
==============

Please be aware of the fact that the file transfer protocol (FTP) does not
support Symlinks. You cannot unpack these archives locally and copy them
to your server using FTP, even if the target server actually is a Unix
server.

So if you don't have shell access, try to use a terminal emulator instead.
(PHPshell to give you an example - Google knows all of them!)

If this doesn't work you'll have to stick back to the ZIP version :-(

NEWBIE INFORMATION ABOUT THE TYPO3 FILESYSTEM STRUCTURE
=======================================================

A Unix TYPO3 installation consists of two parts:
1) The "source" package
2) The "dummy" package

The dummy package contains the skeleton directory structure for a TYPO3
installation and a symlink ('typo3_src') to the location of the source
package which contains all the PHP files, images, JavaScript files, etc.
that TYPO3 needs to run.

In other words: You can have several TYPO3 installations with just one
source package. A typical directory structure looks like this:

/var/www/typo3_src-3.8.1/ # the untared 3.8.0 source package
/var/www/typo3_src-4.0/ # the untared 4.0 source package
/var/www/installation1/ # the untared dummy package of a TYPO3
# installation running on TYPO3 3.8.1
/typo3_src --> ../typo3_src-3.8.1/ # a symlink to the 3.8.1 source
/typo3conf/
/typo3temp/
/fileadmin/
/.../
/var/www/installation2/ # the untared dummy package of a TYPO3
# installation running on TYPO3 4.0
/typo3_src --> ../typo3_src-4.0/ # a symlink to the 4.0 source
/typo3conf/
/typo3temp/
/fileadmin/
/.../

As you see, the two TYPO3-installations (possibly with different domains)
can use the same TYPO3 source package. You can even change the source
package simply be changing the symlink inside the installation directory.

STEP BY STEP
============

1 Get the TYPO3 source package and the TYPO3 dummy package.

2 Copy the archives to the web root of your server.
(Debian default is /var/www/, SuSE default is /srv/www/)

3 Unpack the archives:
$ tar xzf typo3_src-<version>.tar.gz
$ tar xfz dummy-<version>.tar.gz

4 Rename the dummy-<version> directory to fit your needs and make sure it
is accessible by your webserver (for example by creating a virtual
host). We assume you rename the directory to cms:
$ mv dummy-<version> cms

5 Set permissions (as root): There are at least two options.
These steps will make four directories writable for the webserver:
- cms/fileadmin/
- cms/typo3conf/
- cms/typo3temp/
- cms/uploads/

5.a (recommended)
Run these commands as root in the cms/ directory:
# chgrp -R <wwwserver> fileadmin typo3conf typo3temp uploads
# chmod -R g+w,o-rwx fileadmin typo3conf typo3temp uploads

... where <wwwserver> is the name of the group your webserver
is running as

5.b (insecure but easy to apply)
I repeat: This is insecure!
Do not use this method if you are working on a shared server!

Simply run this command:
$ chmod -R a+w fileadmin typo3conf typo3temp uploads

6 Check the symlink cms/typo3_src and make sure it points to the source
directory.
(See above: "Newbie information about the TYPO3 filesystem structure")

7 In your browser, visit
http://[your.site.name]/cms/

8 Follow the instructions in the 1-2-3 install tool

9 From this point, you can access the backend through
http://[your.site.name]/cms/typo3/
with the username "admin" and password "password".

That's it :-)

INSTALLING TYPO3 IN THE WEBROOT FOLDER
======================================

1 Follow the steps 1-6 above.

2 Move the files in the cms/ folder up one level.

$ cd cms
$ mv * ../
$ cd ../

3 Update the symlink

$ rm typo3_src
$ ln -s ./typo3_src-<version> typo3_src

4 Now TYPO3 runs in http://[your.site.name]/

That's it :-)

WHAT SHOULD YOU DO IF YOU HAVE A PROBLEM?
=========================================

TYPO3 is a powerful and complex professional application. When you start
out there will be many things you don´t understand, or that don't seem to
make sense. There is a widely used mailing list (more information on
typo3.com & typo3.org) where many experienced users and developers
lurk... they are always willing to help, provided you followed these steps
BEFORE you ask your question:

1 - Read all available documentation carefully

2 - Read the webserver error logfiles
(for example /var/log/apache/error.log)

3 - Read all available documentation again

4 - Search the mailing list archive carefully

5 - If you still can't figure it out - ask the list...:
- Newsgroup: news://news.netfielders.de/
- Mailing lists: http://lists.netfielders.de/

When posting to one of the lists, see the following guidelines...
- Be polite
Always include the version of used TYPO3 and server environment
(phpinfo())... note that this is available within the TYPO3
Install Tool
- Be as specific and clear as possible - questions like "my TYPO3
installation does not work - what can I do???" will be ignored.
Although English may not be your first language, if those reading
your posting can't understand it, you won't get the help you need
- If you are really having a tough time getting something working,
stay cool and don't criticise or flame. Problems are normally
caused by lack of research into the documentation, or
misunderstanding, not because of bugs. Be logical about your
troubleshooting, and you'll get there

6 - If you have identified a genuine new bug, report it at
http://bugs.typo3.org/ ...do not post to the list about it

Please be aware that if you ask questions that are answered in the
available documentation, you may not get a reply, or any help from the
developers or any experienced users!

We are aware that there is still some work to be done on the
documentation, and the platform for user support... please forgive us for
not having all these gaps filled. If you feel that some information is
missing, hard to find or just plain wrong, or you have a suggestion on
improving TYPO3 or the "support services", please let us know so that we
can do what is necessary. You could also volunteer to help with the work!

(c) Nigel Jackson, Ingmar Schlecht
Unix related additions made by Michael Stucki and some Wiki users:
http://wiki.typo3.org/index.php/Tgz-INSTALL.txt

-- Michael Stucki <michael@typo3.org> Sun, 26 Mar 2006 22:10:53 +0100
</pre>

== Image Magick über SSH Zugang auf VMWare ==
Quelle: http://www.4many.net/imagemagick_setup.html

<pre>
ImageMagick Installation on Virtual Host Account with SSH Access
Situation: Customer got virtual host with ssh access
TYPO3 was installed
no ImageMagick
after installing static linked package imagemagick-4.2.9_i386-static-1.tar.gz
TYPO3 complained that no valid version could be found
Problem: It turned out that due to the virtual setup and the setup of the Apache the environment got lost and the ImageMagick.so.9 couldn't be found during the exec()
Challenge:

1. convince the provider to change the setup
Nice try!
2. convince the provider to install ImageMagick globally
No support for third party products
3. fix it in TYPO3 to pass environment
possible solution, just no time to do so

Solution: Fixed it on script level

1. move required executable to *.bin, i.e.

mv convert convert.bin
mv combine combine.bin
mv identify identify.bin

2. create script

pico convert

3. content of the script file

#!/usr/local/bin/bash
export PATH; PATH="/home/usr203227042/ImageMagick-4.2.9/bin:$PATH"
export MAGICK_HOME="/home/usr203227042/ImageMagick-4.2.9"
export LD_LIBRARY_PATH="/home/usr203227042/ImageMagick-4.2.9/lib"
/home/usr203227042/ImageMagick-4.2.9/bin/convert.bin $*

4. make script executable

chmod 755 convert

5. repeat steps 2.-4. for combine and identify and don't forget to change convert.bin to the appropriate value
</pre>

== Trennung von Produktions und Live-Server (Bearbeitung der Seiten und Darstellung) ==
Für den Website-Betrieb sind die Verzeichnisse TSLib und T3Lib notwendig um eine Website auszuliefern.

Für die Bearbeitung von Seiten sind die Dateien im Typo3 Verzeichnis zuständig. Ohne Typo3 Verzeichnis gibt es kein Backend aber die Seiten funktionieren trotzdem. Ein gutes Mittel um die Seiten vor Angreifern zu schützen.

siehe auch [[Typo3 - Update]]

== Zentrale Typo3-Installation vs mehrere Typo3 ==

Verschiedene Gründe:
1. Es gibt aus Sicherheitsgründen keinen Remote Zugang für unseren Server. Das macht es etwas umständlicher.

2. Von Version 3.7-3.8 gab es bei manchen Extensions Probleme mit Updates, bzw. es gab Extensions die das Typo auch mal aus dem Tritt brachten. Wenn wir alle Präsenzen auf einem Typo laufen lassen würden wären bei einem Fehler alle Homepages betroffen und Nebenwirkungen unter Umständen nicht so einfach zu sehen. Mit der getrennten Installation kann man auch bei sehr experimentellen Extensions relativ sicher updaten. Auch wenn wir verschiedene Datenbanken benutzen würden. Erst ab Version 4 gibt es außerdem die Möglichkeit Seiten vernünftig zu testen bevor Sie bei Änderungen Online gehen. Das war bisher nur mit einer ziemlich umständlichen Extension möglich.

Manche würden das vielleicht als Übervorsichtig auslegen. Im Endeffekt hat es nur den Nachteil der längeren Uploadzeiten. Speicherplatz spielt im Grunde kaum eine Rolle. Der Server wird auch nicht wesentlich mehr belastet. Weil die Skripte egal ob in einer oder in mehreren Typos ja immer für jede Anfrage abgearbeitet werden.

3. Wir haben den Kunden eine komplette Installation verkauft mit der Sie machen können was Sie wollen. Dafür bekommen Sie natürlich auch eine eigene Installation.

Für die Miettypos werden wir allerdings eine einzelne Installation benutzen. Für eine Agentur bietet sich ebenfalls eine eigene Installation an auf der die betreuten Präsenzen laufen.

4. Manche Typos laufen auf anderen Servern ;-) Z.T. mit Anpassungen im Quellcode vom Typo.

=== Weitere Pro und Kontra Argumente ===

* Zeitersparnis beim Update in zentraler Installation
* Ein Backend=>Admin Account unübersichtlich

== automatische Installation ==

Überlegungen zum automatischen Installieren:

Ausgehend von einer fertigen Grundinstallation mit Benutzern und Rechten plus einigen Dummy-Seiten müßten sich per Knopfdruck Installationen anfertigen lassen.

Einzelschritte:
* Notwendige Dateien (Typo3 System, Filadmin Ordner)
* Datenbank (inkl. Benutzer und Dummy Inhalten)
* Config-Datei (automatisiert ?)

== Typo3 - Update ==
=== 3.8 auf 4.0 ===
Ordner typo3, t3lib ersetzen
misc aufspielen
index.php ersetzen (root)

Update Wizard im Install Tool ausführen

Im Database Analyzer Compare und danach die erforderlichen Updates der Datenbanktabellen ausführen.

Nicht benötigte Extensions entfernen und entsprechend Templates anpassen

Alte Sprachpakete löschen und mit dem Translation Handling im Extension Manager die benötigten Sprachen aktualisieren.

=== Kompatibilitätsmodus 3.8 für Version 4 ===
Nach Update von 3.8.x auf 4.0 läuft das Typo zunächst im Kompatibilitätsmodus.

Folgendes sollte verändert werden damit die Ausgabe auch nach umschalten wieder geht.
The following updates will be performed:

changeCompatibilityVersion
TYPO3 output is currently compatible to version 3.8. To use all the new features in the current TYPO3 version, make sure you follow the guidelines below to upgrade without problems.

Follow the steps below carefully and confirm every step!
You will see this list again after you performed the update.
CMS Frontend

*

Word separator character for simulateStaticDocument is changed from underscore (_) to hyphen (-) to make URLs more friendly for search enginesURLs that are already existing (e.g. external links to your site) will still work like before.

You can set the separator character back to an underscore by putting the following line into the Setup section of your Page TypoScript template:

config.simulateStaticDocuments_replacementChar = _
*

CSS Stylesheets and JavaScript are put into an external file by default.

Technically, that means that the default value of "config.inlineStyle2TempFile" is now set to "1" and that of "config.removeDefaultJS" to "external"

Acknowledged
CSS Styled Content: Accessibility improvements

The rendering of the following elements will change:

* tt_content.menu (used f.e. for sitemaps): Instead of div-tags, lists are used now.

* tt_content.mailform: Mailforms do not use tables anymore, instead, they use the div-tag. Besides that, mailforms are accessible now.

* The p-tag has been removed from all table cells.

* CSS based "image" and "text with image"
As the extension cron_cssstyledimgtext has been merged into the core, rendering of the content elements "image" and "text with image" has been changed to be CSS instead of table based. Read the 4.0 release notes for further information.

You will have to update your stylesheets to comply with these changes.

Acknowledged

Check all (ignore selection above)
WARNING: this might break the output of your website.
Show database queries performed

Typo3 - Installation

2007-01-03T14:00:08Z

217.228.133.51: /* Typo3 auf Unix installieren */

== Typo3 Autoinstallation ==
Wünschenswert wäre ein Script, welches eine Typo3 Grundinstallation vollautomatisch durchführt. Als ersten Schritt einige Vorüberlegungen:
Die Installation sollte nach Angabe einer Datenbank die Typo3 Verzeichnisse hochladen, auspacken und das Konfigurationsfile mit den Datenbankwerten belegen. Weiterhin sollte die Datenbank bereits einen Admin-User einige Seiten und einige Grundtemplates enthalten. Typo3 enthält ja die Möglichkeit im DB Teil der installation ein eigenes .sql File zu benutzen, welches bereits die nötigen Werte enthält.

== Grundsätzliche Installation ==

=== Uploaden ===

# Typo3 - Dummy auf den Server laden
# Aus dem Installscript /typo3/install/index.php die die() Funktion auskommentieren
# Install Skript im Browser aufrufen (Standard Passwort ist joh316)
# Passwort ändern !! und neu einloggen (evt. Schreibrecht für /typo3/typo3conf/localconf.php setzten)

=== Basic Configuration ===

# Schreibrechte für die rot markierten Ordner ändern und den den fileadmin Ordner ebenfalls schreibbar machen.
# Datenbank Zugangsdaten eingeben. Host ist in der Regel 'localhost'
# Update localconf.php klicken dann click to continue
# Jetzt die Datenbank im neuen Dropdownfeld. Auswählen
# Encryption key: Generate Knopf klicken

=== Database Analyser ===
# Benötigte Tabellen anlegen: Compare klicken - dann write to database
# Dump static data IMPORT
# (Notwendig?) Tabellen füllen mit statischen Templates typo3conf/database.sql (1.1 M) ebenfalls Compare und write to database
# admin User erstellen damit man sich im Backend einloggen kann.

=== All Configuration ===
# [gdlib_2] auf 1 stellen Wenn GDlib Version 2 Verwendet wird
# [TTFdpi] muß auf 96 stehen wenn die Schrift im Bild bei 'Basic Configuration' nicht vollständig angezeigt wird.
# [noEdit] auf 0 stellen dann kann man vom Backend-Bereich Text-Dateien (z.B. CSS-Files) verändern.
# [warning_email_addr] setzten dann bekommt man eine Email wenn sich jemand viermal falsch einloggt

=== Wichtige ToDos im Typo Backend ===
# Passwort für Install Tool ändern
# Ab Typo4.x DB References Updaten
# Deutsche Sprachpakete im Extension Manage laden (für 3.8 die CSH Files)
# Standard Templates TS-Templates evt. HTML Template und CSS (für TV und Automaketemplate die Extensions nicht vergessen)
# Benutzer Konfiguration bzw. Page Konfiguration (UserTS und PageTS)
# Standard Extensions installieren

== Typo3 auf Unix installieren ==
Wenn man einen Shell Zugang zum Server hat, bietet sich eine Installation mit den tar Paketen an. Das geht erstens schneller als per FTP und man hat die Möglichkeit mit Symlinks zu arbeiten, die ein späteres Update erleichtern.
So gehts:
* Evt. Shell-Zugang erlauben (z.B. mit bash Terminal. Später wieder abschalten!)
* Remote Zugang z.B. mit Putty herstellen (Session > [IP], SSH /
* Entweder per FTP die tars ('''Source und Dummy''') '''hochladen''' oder direkt mit der Shell vom Server aus laden z.B. mit
wget http://prdownloads.sourceforge.net/typo3/typo3_src-4.0.4.tar.gz?download
... (siehe Typo3 Buch)

* jetzt beide Pakete '''auspacken'''

tar xzf dummy-4.0.2.tar.gz
tar xzf typo3_src-4.0.2.tar.gz

* Es entstehen die Verzeichnisse
typo3_src-4.0.2
dummy-4.0.2

der Inhalt des Dummy Paket liegt später direkt auf dem Webspace.Der Quelltext der Source im src Verzeichnis damit man später drauf verweisen kann. Deshalb '''verschieben''' wir den Inhalt des '''Dummy Paket''' eine Ebene nach unten in das Wurzelverzeichnis (die aktuelle Ebene).

''Hinweis: Eine weitere Möglichkeit wäre die Dateien im Ordner zu belassen, ihn sinnvoll umzubenennen (z.B. cms/) und die Domain z.B. als virtual Host auf den Unterordner gehen zu lassen.''
mv dummy-4.0.2/* ./

* Jetzt machen wir einen '''Symlink''' der auf das src Verzeichnis zeigt und typo3_src heißt.
(evt. ist schon ein Symlink da der vom dummyVerzeichnis nach unten )
ln -s typo3_src-4.0.2 typo3_src zeigt evt. kann man nämlich auch das Dummy im Unterordner lassen - ToDo)Wenn man im Dummy Paket das typo3_src Symlink umbiegt kann man ganz schnell ein Update ausprobieren oder eine neue source testen
* Die Archive und den leeren Dummy Ordner kann man jetzt löschen:
rm -r dummy-4.0.2
rm dummy-4.0.3.tar.gz
rm typo3_src-4.0.2.tar.gz
* Im Browser müßte jetzt schon was kommen (/typo3 oder /index.php)
* Mit dem vi Editor können wir die Die Funktion im Installer auskommentieren:
vi typo3_src-4.0.2/install/index.php
* Mit i kommt man in den Einfügemodus Esc verläßt ihn :wq! speichert und schließt den Editor.

* Jetzt kann man den Typo3 Installer starten
* Um die Rechte im Terminal anzupassen kann man den Befehl chmod benutzen
=== Beschreibung der Installation aus der Datei 'install.txt' der Typo3 4.0.2 Distribution ===

<pre>
**************************
* UNIX ARCHIVES OF TYPO3 *
**************************

INTRODUCTION
============

As you have downloaded this package you seem to know already about TYPO3.
If you don't, visit http://typo3.org/ where you can find many useful
information.

This short guide lists the important steps to install this package.

By default TYPO3 installs into the folder:
http://[your.site.name]/<this_site_name>/

Read the additional instructions to install TYPO3 in the root folder:
http://[your.site.name]/

IMPORTANT NOTE
==============

Please be aware of the fact that the file transfer protocol (FTP) does not
support Symlinks. You cannot unpack these archives locally and copy them
to your server using FTP, even if the target server actually is a Unix
server.

So if you don't have shell access, try to use a terminal emulator instead.
(PHPshell to give you an example - Google knows all of them!)

If this doesn't work you'll have to stick back to the ZIP version :-(

NEWBIE INFORMATION ABOUT THE TYPO3 FILESYSTEM STRUCTURE
=======================================================

A Unix TYPO3 installation consists of two parts:
1) The "source" package
2) The "dummy" package

The dummy package contains the skeleton directory structure for a TYPO3
installation and a symlink ('typo3_src') to the location of the source
package which contains all the PHP files, images, JavaScript files, etc.
that TYPO3 needs to run.

In other words: You can have several TYPO3 installations with just one
source package. A typical directory structure looks like this:

/var/www/typo3_src-3.8.1/ # the untared 3.8.0 source package
/var/www/typo3_src-4.0/ # the untared 4.0 source package
/var/www/installation1/ # the untared dummy package of a TYPO3
# installation running on TYPO3 3.8.1
/typo3_src --> ../typo3_src-3.8.1/ # a symlink to the 3.8.1 source
/typo3conf/
/typo3temp/
/fileadmin/
/.../
/var/www/installation2/ # the untared dummy package of a TYPO3
# installation running on TYPO3 4.0
/typo3_src --> ../typo3_src-4.0/ # a symlink to the 4.0 source
/typo3conf/
/typo3temp/
/fileadmin/
/.../

As you see, the two TYPO3-installations (possibly with different domains)
can use the same TYPO3 source package. You can even change the source
package simply be changing the symlink inside the installation directory.

STEP BY STEP
============

1 Get the TYPO3 source package and the TYPO3 dummy package.

2 Copy the archives to the web root of your server.
(Debian default is /var/www/, SuSE default is /srv/www/)

3 Unpack the archives:
$ tar xzf typo3_src-<version>.tar.gz
$ tar xfz dummy-<version>.tar.gz

4 Rename the dummy-<version> directory to fit your needs and make sure it
is accessible by your webserver (for example by creating a virtual
host). We assume you rename the directory to cms:
$ mv dummy-<version> cms

5 Set permissions (as root): There are at least two options.
These steps will make four directories writable for the webserver:
- cms/fileadmin/
- cms/typo3conf/
- cms/typo3temp/
- cms/uploads/

5.a (recommended)
Run these commands as root in the cms/ directory:
# chgrp -R <wwwserver> fileadmin typo3conf typo3temp uploads
# chmod -R g+w,o-rwx fileadmin typo3conf typo3temp uploads

... where <wwwserver> is the name of the group your webserver
is running as

5.b (insecure but easy to apply)
I repeat: This is insecure!
Do not use this method if you are working on a shared server!

Simply run this command:
$ chmod -R a+w fileadmin typo3conf typo3temp uploads

6 Check the symlink cms/typo3_src and make sure it points to the source
directory.
(See above: "Newbie information about the TYPO3 filesystem structure")

7 In your browser, visit
http://[your.site.name]/cms/

8 Follow the instructions in the 1-2-3 install tool

9 From this point, you can access the backend through
http://[your.site.name]/cms/typo3/
with the username "admin" and password "password".

That's it :-)

INSTALLING TYPO3 IN THE WEBROOT FOLDER
======================================

1 Follow the steps 1-6 above.

2 Move the files in the cms/ folder up one level.

$ cd cms
$ mv * ../
$ cd ../

3 Update the symlink

$ rm typo3_src
$ ln -s ./typo3_src-<version> typo3_src

4 Now TYPO3 runs in http://[your.site.name]/

That's it :-)

WHAT SHOULD YOU DO IF YOU HAVE A PROBLEM?
=========================================

TYPO3 is a powerful and complex professional application. When you start
out there will be many things you don´t understand, or that don't seem to
make sense. There is a widely used mailing list (more information on
typo3.com & typo3.org) where many experienced users and developers
lurk... they are always willing to help, provided you followed these steps
BEFORE you ask your question:

1 - Read all available documentation carefully

2 - Read the webserver error logfiles
(for example /var/log/apache/error.log)

3 - Read all available documentation again

4 - Search the mailing list archive carefully

5 - If you still can't figure it out - ask the list...:
- Newsgroup: news://news.netfielders.de/
- Mailing lists: http://lists.netfielders.de/

When posting to one of the lists, see the following guidelines...
- Be polite
Always include the version of used TYPO3 and server environment
(phpinfo())... note that this is available within the TYPO3
Install Tool
- Be as specific and clear as possible - questions like "my TYPO3
installation does not work - what can I do???" will be ignored.
Although English may not be your first language, if those reading
your posting can't understand it, you won't get the help you need
- If you are really having a tough time getting something working,
stay cool and don't criticise or flame. Problems are normally
caused by lack of research into the documentation, or
misunderstanding, not because of bugs. Be logical about your
troubleshooting, and you'll get there

6 - If you have identified a genuine new bug, report it at
http://bugs.typo3.org/ ...do not post to the list about it

Please be aware that if you ask questions that are answered in the
available documentation, you may not get a reply, or any help from the
developers or any experienced users!

We are aware that there is still some work to be done on the
documentation, and the platform for user support... please forgive us for
not having all these gaps filled. If you feel that some information is
missing, hard to find or just plain wrong, or you have a suggestion on
improving TYPO3 or the "support services", please let us know so that we
can do what is necessary. You could also volunteer to help with the work!

(c) Nigel Jackson, Ingmar Schlecht
Unix related additions made by Michael Stucki and some Wiki users:
http://wiki.typo3.org/index.php/Tgz-INSTALL.txt

-- Michael Stucki <michael@typo3.org> Sun, 26 Mar 2006 22:10:53 +0100
</pre>

== Image Magick über SSH Zugang auf VMWare ==
Quelle: http://www.4many.net/imagemagick_setup.html

<pre>
ImageMagick Installation on Virtual Host Account with SSH Access
Situation: Customer got virtual host with ssh access
TYPO3 was installed
no ImageMagick
after installing static linked package imagemagick-4.2.9_i386-static-1.tar.gz
TYPO3 complained that no valid version could be found
Problem: It turned out that due to the virtual setup and the setup of the Apache the environment got lost and the ImageMagick.so.9 couldn't be found during the exec()
Challenge:

1. convince the provider to change the setup
Nice try!
2. convince the provider to install ImageMagick globally
No support for third party products
3. fix it in TYPO3 to pass environment
possible solution, just no time to do so

Solution: Fixed it on script level

1. move required executable to *.bin, i.e.

mv convert convert.bin
mv combine combine.bin
mv identify identify.bin

2. create script

pico convert

3. content of the script file

#!/usr/local/bin/bash
export PATH; PATH="/home/usr203227042/ImageMagick-4.2.9/bin:$PATH"
export MAGICK_HOME="/home/usr203227042/ImageMagick-4.2.9"
export LD_LIBRARY_PATH="/home/usr203227042/ImageMagick-4.2.9/lib"
/home/usr203227042/ImageMagick-4.2.9/bin/convert.bin $*

4. make script executable

chmod 755 convert

5. repeat steps 2.-4. for combine and identify and don't forget to change convert.bin to the appropriate value
</pre>

== Trennung von Produktions und Live-Server (Bearbeitung der Seiten und Darstellung) ==
Für den Website-Betrieb sind die Verzeichnisse TSLib und T3Lib notwendig um eine Website auszuliefern.

Für die Bearbeitung von Seiten sind die Dateien im Typo3 Verzeichnis zuständig. Ohne Typo3 Verzeichnis gibt es kein Backend aber die Seiten funktionieren trotzdem. Ein gutes Mittel um die Seiten vor Angreifern zu schützen.

siehe auch [[Typo3 - Update]]

== Zentrale Typo3-Installation vs mehrere Typo3 ==

Verschiedene Gründe:
1. Es gibt aus Sicherheitsgründen keinen Remote Zugang für unseren Server. Das macht es etwas umständlicher.

2. Von Version 3.7-3.8 gab es bei manchen Extensions Probleme mit Updates, bzw. es gab Extensions die das Typo auch mal aus dem Tritt brachten. Wenn wir alle Präsenzen auf einem Typo laufen lassen würden wären bei einem Fehler alle Homepages betroffen und Nebenwirkungen unter Umständen nicht so einfach zu sehen. Mit der getrennten Installation kann man auch bei sehr experimentellen Extensions relativ sicher updaten. Auch wenn wir verschiedene Datenbanken benutzen würden. Erst ab Version 4 gibt es außerdem die Möglichkeit Seiten vernünftig zu testen bevor Sie bei Änderungen Online gehen. Das war bisher nur mit einer ziemlich umständlichen Extension möglich.

Manche würden das vielleicht als Übervorsichtig auslegen. Im Endeffekt hat es nur den Nachteil der längeren Uploadzeiten. Speicherplatz spielt im Grunde kaum eine Rolle. Der Server wird auch nicht wesentlich mehr belastet. Weil die Skripte egal ob in einer oder in mehreren Typos ja immer für jede Anfrage abgearbeitet werden.

3. Wir haben den Kunden eine komplette Installation verkauft mit der Sie machen können was Sie wollen. Dafür bekommen Sie natürlich auch eine eigene Installation.

Für die Miettypos werden wir allerdings eine einzelne Installation benutzen. Für eine Agentur bietet sich ebenfalls eine eigene Installation an auf der die betreuten Präsenzen laufen.

4. Manche Typos laufen auf anderen Servern ;-) Z.T. mit Anpassungen im Quellcode vom Typo.

=== Weitere Pro und Kontra Argumente ===

* Zeitersparnis beim Update in zentraler Installation
* Ein Backend=>Admin Account unübersichtlich

== automatische Installation ==

Überlegungen zum automatischen Installieren:

Ausgehend von einer fertigen Grundinstallation mit Benutzern und Rechten plus einigen Dummy-Seiten müßten sich per Knopfdruck Installationen anfertigen lassen.

Einzelschritte:
* Notwendige Dateien (Typo3 System, Filadmin Ordner)
* Datenbank (inkl. Benutzer und Dummy Inhalten)
* Config-Datei (automatisiert ?)

== Typo3 - Update ==
=== 3.8 auf 4.0 ===
Ordner typo3, t3lib ersetzen
misc aufspielen
index.php ersetzen (root)

Update Wizard im Install Tool ausführen

Im Database Analyzer Compare und danach die erforderlichen Updates der Datenbanktabellen ausführen.

Nicht benötigte Extensions entfernen und entsprechend Templates anpassen

Alte Sprachpakete löschen und mit dem Translation Handling im Extension Manager die benötigten Sprachen aktualisieren.

=== Kompatibilitätsmodus 3.8 für Version 4 ===
Nach Update von 3.8.x auf 4.0 läuft das Typo zunächst im Kompatibilitätsmodus.

Folgendes sollte verändert werden damit die Ausgabe auch nach umschalten wieder geht.
The following updates will be performed:

changeCompatibilityVersion
TYPO3 output is currently compatible to version 3.8. To use all the new features in the current TYPO3 version, make sure you follow the guidelines below to upgrade without problems.

Follow the steps below carefully and confirm every step!
You will see this list again after you performed the update.
CMS Frontend

*

Word separator character for simulateStaticDocument is changed from underscore (_) to hyphen (-) to make URLs more friendly for search enginesURLs that are already existing (e.g. external links to your site) will still work like before.

You can set the separator character back to an underscore by putting the following line into the Setup section of your Page TypoScript template:

config.simulateStaticDocuments_replacementChar = _
*

CSS Stylesheets and JavaScript are put into an external file by default.

Technically, that means that the default value of "config.inlineStyle2TempFile" is now set to "1" and that of "config.removeDefaultJS" to "external"

Acknowledged
CSS Styled Content: Accessibility improvements

The rendering of the following elements will change:

* tt_content.menu (used f.e. for sitemaps): Instead of div-tags, lists are used now.

* tt_content.mailform: Mailforms do not use tables anymore, instead, they use the div-tag. Besides that, mailforms are accessible now.

* The p-tag has been removed from all table cells.

* CSS based "image" and "text with image"
As the extension cron_cssstyledimgtext has been merged into the core, rendering of the content elements "image" and "text with image" has been changed to be CSS instead of table based. Read the 4.0 release notes for further information.

You will have to update your stylesheets to comply with these changes.

Acknowledged

Check all (ignore selection above)
WARNING: this might break the output of your website.
Show database queries performed

Typo3 - Installation

2007-01-03T13:17:44Z

217.228.133.51: /* Typo3 auf Unix installieren */

== Typo3 Autoinstallation ==
Wünschenswert wäre ein Script, welches eine Typo3 Grundinstallation vollautomatisch durchführt. Als ersten Schritt einige Vorüberlegungen:
Die Installation sollte nach Angabe einer Datenbank die Typo3 Verzeichnisse hochladen, auspacken und das Konfigurationsfile mit den Datenbankwerten belegen. Weiterhin sollte die Datenbank bereits einen Admin-User einige Seiten und einige Grundtemplates enthalten. Typo3 enthält ja die Möglichkeit im DB Teil der installation ein eigenes .sql File zu benutzen, welches bereits die nötigen Werte enthält.

== Grundsätzliche Installation ==

=== Uploaden ===

# Typo3 - Dummy auf den Server laden
# Aus dem Installscript /typo3/install/index.php die die() Funktion auskommentieren
# Install Skript im Browser aufrufen (Standard Passwort ist joh316)
# Passwort ändern !! und neu einloggen (evt. Schreibrecht für /typo3/typo3conf/localconf.php setzten)

=== Basic Configuration ===

# Schreibrechte für die rot markierten Ordner ändern und den den fileadmin Ordner ebenfalls schreibbar machen.
# Datenbank Zugangsdaten eingeben. Host ist in der Regel 'localhost'
# Update localconf.php klicken dann click to continue
# Jetzt die Datenbank im neuen Dropdownfeld. Auswählen
# Encryption key: Generate Knopf klicken

=== Database Analyser ===
# Benötigte Tabellen anlegen: Compare klicken - dann write to database
# Dump static data IMPORT
# (Notwendig?) Tabellen füllen mit statischen Templates typo3conf/database.sql (1.1 M) ebenfalls Compare und write to database
# admin User erstellen damit man sich im Backend einloggen kann.

=== All Configuration ===
# [gdlib_2] auf 1 stellen Wenn GDlib Version 2 Verwendet wird
# [TTFdpi] muß auf 96 stehen wenn die Schrift im Bild bei 'Basic Configuration' nicht vollständig angezeigt wird.
# [noEdit] auf 0 stellen dann kann man vom Backend-Bereich Text-Dateien (z.B. CSS-Files) verändern.
# [warning_email_addr] setzten dann bekommt man eine Email wenn sich jemand viermal falsch einloggt

=== Wichtige ToDos im Typo Backend ===
# Passwort für Install Tool ändern
# Ab Typo4.x DB References Updaten
# Deutsche Sprachpakete im Extension Manage laden (für 3.8 die CSH Files)
# Standard Templates TS-Templates evt. HTML Template und CSS (für TV und Automaketemplate die Extensions nicht vergessen)
# Benutzer Konfiguration bzw. Page Konfiguration (UserTS und PageTS)
# Standard Extensions installieren

== Typo3 auf Unix installieren ==
Wenn man einen Shell Zugang zum Server hat, bietet sich eine Installation mit den tar Paketen an. Das geht erstens schneller als per FTP und man hat die Möglichkeit mit Symlinks zu arbeiten, die ein späteres Update erleichtern.
So gehts:
* Evt. Shell-Zugang erlauben (z.B. mit bash Terminal. Später wieder abschalten!)
* Remote Zugang z.B. mit Putty herstellen (Session > [IP], SSH /
* Entweder per FTP die tars ('''Source und Dummy''') '''hochladen''' oder direkt mit der Shell vom Server aus laden z.B. mit
wget http://prdownloads.sourceforge.net/typo3/typo3_src-4.0.4.tar.gz?download
... (siehe Typo3 Buch)

* jetzt beide Pakete '''auspacken'''

tar xzf dummy-4.0.2.tar.gz
tar xzf typo3_src-4.0.2.tar.gz

* Es entstehen die Verzeichnisse
typo3_src-4.0.2
dummy-4.0.2

der Inhalt des Dummy Paket liegt später direkt auf dem Webspace.Der Quelltext der Source im src Verzeichnis damit man später drauf verweisen kann. Deshalb '''verschieben''' wir den Inhalt des '''Dummy Paket''' eine Ebene nach unten in das Wurzelverzeichnis (die aktuelle Ebene).

''Hinweis: Eine weitere Möglichkeit wäre die Dateien im Ordner zu belassen, ihn sinnvoll umzubenennen (z.B. cms/) und die Domain z.B. als virtual Host auf den Unterordner gehen zu lassen.''
mv dummy-4.0.2/* ./

* Jetzt machen wir einen '''Symlink''' der auf das src Verzeichnis zeigt und typo3_src heißt.
ln -s typo3_src-4.0.2 typo3_src (evt. ist schon ein Symlink da der vom dummyVerzeichnis nach unten zeigt evt. kann man nämlich auch das Dummy im Unterordner lassen - ToDo)Wenn man im Dummy Paket das typo3_src Symlink umbiegt kann man ganz schnell ein Update ausprobieren oder eine neue source testen
* Die Archive und den leeren Dummy Ordner kann man jetzt löschen:
rm -r dummy-4.0.2
rm dummy-4.0.3.tar.gz
rm typo3_src-4.0.2.tar.gz
* Im Browser müßte jetzt schon was kommen (/typo3 oder /index.php)
* Mit dem vi Editor können wir die Die Funktion im Installer auskommentieren:
vi typo3_src-4.0.2/install/index.php
* Mit i kommt man in den Einfügemodus Esc verläßt ihn :wq! speichert und schließt den Editor.

* Jetzt kann man den Typo3 Installer starten
* Um die Rechte im Terminal anzupassen kann man den Befehl chmod benutzen
=== Beschreibung der Installation aus der Datei 'install.txt' der Typo3 4.0.2 Distribution ===

<pre>
**************************
* UNIX ARCHIVES OF TYPO3 *
**************************

INTRODUCTION
============

As you have downloaded this package you seem to know already about TYPO3.
If you don't, visit http://typo3.org/ where you can find many useful
information.

This short guide lists the important steps to install this package.

By default TYPO3 installs into the folder:
http://[your.site.name]/<this_site_name>/

Read the additional instructions to install TYPO3 in the root folder:
http://[your.site.name]/

IMPORTANT NOTE
==============

Please be aware of the fact that the file transfer protocol (FTP) does not
support Symlinks. You cannot unpack these archives locally and copy them
to your server using FTP, even if the target server actually is a Unix
server.

So if you don't have shell access, try to use a terminal emulator instead.
(PHPshell to give you an example - Google knows all of them!)

If this doesn't work you'll have to stick back to the ZIP version :-(

NEWBIE INFORMATION ABOUT THE TYPO3 FILESYSTEM STRUCTURE
=======================================================

A Unix TYPO3 installation consists of two parts:
1) The "source" package
2) The "dummy" package

The dummy package contains the skeleton directory structure for a TYPO3
installation and a symlink ('typo3_src') to the location of the source
package which contains all the PHP files, images, JavaScript files, etc.
that TYPO3 needs to run.

In other words: You can have several TYPO3 installations with just one
source package. A typical directory structure looks like this:

/var/www/typo3_src-3.8.1/ # the untared 3.8.0 source package
/var/www/typo3_src-4.0/ # the untared 4.0 source package
/var/www/installation1/ # the untared dummy package of a TYPO3
# installation running on TYPO3 3.8.1
/typo3_src --> ../typo3_src-3.8.1/ # a symlink to the 3.8.1 source
/typo3conf/
/typo3temp/
/fileadmin/
/.../
/var/www/installation2/ # the untared dummy package of a TYPO3
# installation running on TYPO3 4.0
/typo3_src --> ../typo3_src-4.0/ # a symlink to the 4.0 source
/typo3conf/
/typo3temp/
/fileadmin/
/.../

As you see, the two TYPO3-installations (possibly with different domains)
can use the same TYPO3 source package. You can even change the source
package simply be changing the symlink inside the installation directory.

STEP BY STEP
============

1 Get the TYPO3 source package and the TYPO3 dummy package.

2 Copy the archives to the web root of your server.
(Debian default is /var/www/, SuSE default is /srv/www/)

3 Unpack the archives:
$ tar xzf typo3_src-<version>.tar.gz
$ tar xfz dummy-<version>.tar.gz

4 Rename the dummy-<version> directory to fit your needs and make sure it
is accessible by your webserver (for example by creating a virtual
host). We assume you rename the directory to cms:
$ mv dummy-<version> cms

5 Set permissions (as root): There are at least two options.
These steps will make four directories writable for the webserver:
- cms/fileadmin/
- cms/typo3conf/
- cms/typo3temp/
- cms/uploads/

5.a (recommended)
Run these commands as root in the cms/ directory:
# chgrp -R <wwwserver> fileadmin typo3conf typo3temp uploads
# chmod -R g+w,o-rwx fileadmin typo3conf typo3temp uploads

... where <wwwserver> is the name of the group your webserver
is running as

5.b (insecure but easy to apply)
I repeat: This is insecure!
Do not use this method if you are working on a shared server!

Simply run this command:
$ chmod -R a+w fileadmin typo3conf typo3temp uploads

6 Check the symlink cms/typo3_src and make sure it points to the source
directory.
(See above: "Newbie information about the TYPO3 filesystem structure")

7 In your browser, visit
http://[your.site.name]/cms/

8 Follow the instructions in the 1-2-3 install tool

9 From this point, you can access the backend through
http://[your.site.name]/cms/typo3/
with the username "admin" and password "password".

That's it :-)

INSTALLING TYPO3 IN THE WEBROOT FOLDER
======================================

1 Follow the steps 1-6 above.

2 Move the files in the cms/ folder up one level.

$ cd cms
$ mv * ../
$ cd ../

3 Update the symlink

$ rm typo3_src
$ ln -s ./typo3_src-<version> typo3_src

4 Now TYPO3 runs in http://[your.site.name]/

That's it :-)

WHAT SHOULD YOU DO IF YOU HAVE A PROBLEM?
=========================================

TYPO3 is a powerful and complex professional application. When you start
out there will be many things you don´t understand, or that don't seem to
make sense. There is a widely used mailing list (more information on
typo3.com & typo3.org) where many experienced users and developers
lurk... they are always willing to help, provided you followed these steps
BEFORE you ask your question:

1 - Read all available documentation carefully

2 - Read the webserver error logfiles
(for example /var/log/apache/error.log)

3 - Read all available documentation again

4 - Search the mailing list archive carefully

5 - If you still can't figure it out - ask the list...:
- Newsgroup: news://news.netfielders.de/
- Mailing lists: http://lists.netfielders.de/

When posting to one of the lists, see the following guidelines...
- Be polite
Always include the version of used TYPO3 and server environment
(phpinfo())... note that this is available within the TYPO3
Install Tool
- Be as specific and clear as possible - questions like "my TYPO3
installation does not work - what can I do???" will be ignored.
Although English may not be your first language, if those reading
your posting can't understand it, you won't get the help you need
- If you are really having a tough time getting something working,
stay cool and don't criticise or flame. Problems are normally
caused by lack of research into the documentation, or
misunderstanding, not because of bugs. Be logical about your
troubleshooting, and you'll get there

6 - If you have identified a genuine new bug, report it at
http://bugs.typo3.org/ ...do not post to the list about it

Please be aware that if you ask questions that are answered in the
available documentation, you may not get a reply, or any help from the
developers or any experienced users!

We are aware that there is still some work to be done on the
documentation, and the platform for user support... please forgive us for
not having all these gaps filled. If you feel that some information is
missing, hard to find or just plain wrong, or you have a suggestion on
improving TYPO3 or the "support services", please let us know so that we
can do what is necessary. You could also volunteer to help with the work!

(c) Nigel Jackson, Ingmar Schlecht
Unix related additions made by Michael Stucki and some Wiki users:
http://wiki.typo3.org/index.php/Tgz-INSTALL.txt

-- Michael Stucki <michael@typo3.org> Sun, 26 Mar 2006 22:10:53 +0100
</pre>

== Image Magick über SSH Zugang auf VMWare ==
Quelle: http://www.4many.net/imagemagick_setup.html

<pre>
ImageMagick Installation on Virtual Host Account with SSH Access
Situation: Customer got virtual host with ssh access
TYPO3 was installed
no ImageMagick
after installing static linked package imagemagick-4.2.9_i386-static-1.tar.gz
TYPO3 complained that no valid version could be found
Problem: It turned out that due to the virtual setup and the setup of the Apache the environment got lost and the ImageMagick.so.9 couldn't be found during the exec()
Challenge:

1. convince the provider to change the setup
Nice try!
2. convince the provider to install ImageMagick globally
No support for third party products
3. fix it in TYPO3 to pass environment
possible solution, just no time to do so

Solution: Fixed it on script level

1. move required executable to *.bin, i.e.

mv convert convert.bin
mv combine combine.bin
mv identify identify.bin

2. create script

pico convert

3. content of the script file

#!/usr/local/bin/bash
export PATH; PATH="/home/usr203227042/ImageMagick-4.2.9/bin:$PATH"
export MAGICK_HOME="/home/usr203227042/ImageMagick-4.2.9"
export LD_LIBRARY_PATH="/home/usr203227042/ImageMagick-4.2.9/lib"
/home/usr203227042/ImageMagick-4.2.9/bin/convert.bin $*

4. make script executable

chmod 755 convert

5. repeat steps 2.-4. for combine and identify and don't forget to change convert.bin to the appropriate value
</pre>

== Trennung von Produktions und Live-Server (Bearbeitung der Seiten und Darstellung) ==
Für den Website-Betrieb sind die Verzeichnisse TSLib und T3Lib notwendig um eine Website auszuliefern.

Für die Bearbeitung von Seiten sind die Dateien im Typo3 Verzeichnis zuständig. Ohne Typo3 Verzeichnis gibt es kein Backend aber die Seiten funktionieren trotzdem. Ein gutes Mittel um die Seiten vor Angreifern zu schützen.

siehe auch [[Typo3 - Update]]

== Zentrale Typo3-Installation vs mehrere Typo3 ==

Verschiedene Gründe:
1. Es gibt aus Sicherheitsgründen keinen Remote Zugang für unseren Server. Das macht es etwas umständlicher.

2. Von Version 3.7-3.8 gab es bei manchen Extensions Probleme mit Updates, bzw. es gab Extensions die das Typo auch mal aus dem Tritt brachten. Wenn wir alle Präsenzen auf einem Typo laufen lassen würden wären bei einem Fehler alle Homepages betroffen und Nebenwirkungen unter Umständen nicht so einfach zu sehen. Mit der getrennten Installation kann man auch bei sehr experimentellen Extensions relativ sicher updaten. Auch wenn wir verschiedene Datenbanken benutzen würden. Erst ab Version 4 gibt es außerdem die Möglichkeit Seiten vernünftig zu testen bevor Sie bei Änderungen Online gehen. Das war bisher nur mit einer ziemlich umständlichen Extension möglich.

Manche würden das vielleicht als Übervorsichtig auslegen. Im Endeffekt hat es nur den Nachteil der längeren Uploadzeiten. Speicherplatz spielt im Grunde kaum eine Rolle. Der Server wird auch nicht wesentlich mehr belastet. Weil die Skripte egal ob in einer oder in mehreren Typos ja immer für jede Anfrage abgearbeitet werden.

3. Wir haben den Kunden eine komplette Installation verkauft mit der Sie machen können was Sie wollen. Dafür bekommen Sie natürlich auch eine eigene Installation.

Für die Miettypos werden wir allerdings eine einzelne Installation benutzen. Für eine Agentur bietet sich ebenfalls eine eigene Installation an auf der die betreuten Präsenzen laufen.

4. Manche Typos laufen auf anderen Servern ;-) Z.T. mit Anpassungen im Quellcode vom Typo.

=== Weitere Pro und Kontra Argumente ===

* Zeitersparnis beim Update in zentraler Installation
* Ein Backend=>Admin Account unübersichtlich

== automatische Installation ==

Überlegungen zum automatischen Installieren:

Ausgehend von einer fertigen Grundinstallation mit Benutzern und Rechten plus einigen Dummy-Seiten müßten sich per Knopfdruck Installationen anfertigen lassen.

Einzelschritte:
* Notwendige Dateien (Typo3 System, Filadmin Ordner)
* Datenbank (inkl. Benutzer und Dummy Inhalten)
* Config-Datei (automatisiert ?)

== Typo3 - Update ==
=== 3.8 auf 4.0 ===
Ordner typo3, t3lib ersetzen
misc aufspielen
index.php ersetzen (root)

Update Wizard im Install Tool ausführen

Im Database Analyzer Compare und danach die erforderlichen Updates der Datenbanktabellen ausführen.

Nicht benötigte Extensions entfernen und entsprechend Templates anpassen

Alte Sprachpakete löschen und mit dem Translation Handling im Extension Manager die benötigten Sprachen aktualisieren.

=== Kompatibilitätsmodus 3.8 für Version 4 ===
Nach Update von 3.8.x auf 4.0 läuft das Typo zunächst im Kompatibilitätsmodus.

Folgendes sollte verändert werden damit die Ausgabe auch nach umschalten wieder geht.
The following updates will be performed:

changeCompatibilityVersion
TYPO3 output is currently compatible to version 3.8. To use all the new features in the current TYPO3 version, make sure you follow the guidelines below to upgrade without problems.

Follow the steps below carefully and confirm every step!
You will see this list again after you performed the update.
CMS Frontend

*

Word separator character for simulateStaticDocument is changed from underscore (_) to hyphen (-) to make URLs more friendly for search enginesURLs that are already existing (e.g. external links to your site) will still work like before.

You can set the separator character back to an underscore by putting the following line into the Setup section of your Page TypoScript template:

config.simulateStaticDocuments_replacementChar = _
*

CSS Stylesheets and JavaScript are put into an external file by default.

Technically, that means that the default value of "config.inlineStyle2TempFile" is now set to "1" and that of "config.removeDefaultJS" to "external"

Acknowledged
CSS Styled Content: Accessibility improvements

The rendering of the following elements will change:

* tt_content.menu (used f.e. for sitemaps): Instead of div-tags, lists are used now.

* tt_content.mailform: Mailforms do not use tables anymore, instead, they use the div-tag. Besides that, mailforms are accessible now.

* The p-tag has been removed from all table cells.

* CSS based "image" and "text with image"
As the extension cron_cssstyledimgtext has been merged into the core, rendering of the content elements "image" and "text with image" has been changed to be CSS instead of table based. Read the 4.0 release notes for further information.

You will have to update your stylesheets to comply with these changes.

Acknowledged

Check all (ignore selection above)
WARNING: this might break the output of your website.
Show database queries performed

Typo3 - Installation

2007-01-03T12:18:14Z

217.228.133.51: /* Typo3 auf Unix installieren */

== Typo3 Autoinstallation ==
Wünschenswert wäre ein Script, welches eine Typo3 Grundinstallation vollautomatisch durchführt. Als ersten Schritt einige Vorüberlegungen:
Die Installation sollte nach Angabe einer Datenbank die Typo3 Verzeichnisse hochladen, auspacken und das Konfigurationsfile mit den Datenbankwerten belegen. Weiterhin sollte die Datenbank bereits einen Admin-User einige Seiten und einige Grundtemplates enthalten. Typo3 enthält ja die Möglichkeit im DB Teil der installation ein eigenes .sql File zu benutzen, welches bereits die nötigen Werte enthält.

== Grundsätzliche Installation ==

=== Uploaden ===

# Typo3 - Dummy auf den Server laden
# Aus dem Installscript /typo3/install/index.php die die() Funktion auskommentieren
# Install Skript im Browser aufrufen (Standard Passwort ist joh316)
# Passwort ändern !! und neu einloggen (evt. Schreibrecht für /typo3/typo3conf/localconf.php setzten)

=== Basic Configuration ===

# Schreibrechte für die rot markierten Ordner ändern und den den fileadmin Ordner ebenfalls schreibbar machen.
# Datenbank Zugangsdaten eingeben. Host ist in der Regel 'localhost'
# Update localconf.php klicken dann click to continue
# Jetzt die Datenbank im neuen Dropdownfeld. Auswählen
# Encryption key: Generate Knopf klicken

=== Database Analyser ===
# Benötigte Tabellen anlegen: Compare klicken - dann write to database
# Dump static data IMPORT
# (Notwendig?) Tabellen füllen mit statischen Templates typo3conf/database.sql (1.1 M) ebenfalls Compare und write to database
# admin User erstellen damit man sich im Backend einloggen kann.

=== All Configuration ===
# [gdlib_2] auf 1 stellen Wenn GDlib Version 2 Verwendet wird
# [TTFdpi] muß auf 96 stehen wenn die Schrift im Bild bei 'Basic Configuration' nicht vollständig angezeigt wird.
# [noEdit] auf 0 stellen dann kann man vom Backend-Bereich Text-Dateien (z.B. CSS-Files) verändern.
# [warning_email_addr] setzten dann bekommt man eine Email wenn sich jemand viermal falsch einloggt

=== Wichtige ToDos im Typo Backend ===
# Passwort für Install Tool ändern
# Ab Typo4.x DB References Updaten
# Deutsche Sprachpakete im Extension Manage laden (für 3.8 die CSH Files)
# Standard Templates TS-Templates evt. HTML Template und CSS (für TV und Automaketemplate die Extensions nicht vergessen)
# Benutzer Konfiguration bzw. Page Konfiguration (UserTS und PageTS)
# Standard Extensions installieren

== Typo3 auf Unix installieren ==
Wenn man einen Shell Zugang zum Server hat, bietet sich eine Installation mit den tar Paketen an. Das geht erstens schneller als per FTP und man hat die Möglichkeit mit Symlinks zu arbeiten, die ein späteres Update erleichtern.
So gehts:
* Evt. Shell-Zugang erlauben (z.B. mit bash Terminal. Später wieder abschalten!)
* Remote Zugang z.B. mit Putty herstellen (Session > [IP], SSH /
* Entweder per FTP die tars ('''Source und Dummy''') '''hochladen''' oder direkt mit der Shell vom Server aus laden z.B. mit
wget http://prdownloads.sourceforge.net/typo3/typo3_src-4.0.4.tar.gz?download
... (siehe Typo3 Buch)

* jetzt beide Pakete '''auspacken'''

tar xzf dummy-4.0.2.tar.gz
tar xzf typo3_src-4.0.2.tar.gz

* Es entstehen die Verzeichnisse
typo3_src-4.0.2
dummy-4.0.2

der Inhalt des Dummy Paket liegt später direkt auf dem Webspace.Der Quelltext der Source im src Verzeichnis damit man später drauf verweisen kann. Deshalb '''verschieben''' wir den Inhalt des '''Dummy Paket''' auf die unterste (aktuelle) Ebene:
mv dummy-4.0.2/* ./

* Jetzt machen wir einen '''Symlink''' der auf das src Verzeichnis zeigt und typo3_src heißt.
ln -s typo3_src-4.0.2 typo3_src (evt. ist schon ein Symlink da der vom dummyVerzeichnis nach unten zeigt evt. kann man nämlich auch das Dummy im Unterordner lassen - ToDo)Wenn man im Dummy Paket das typo3_src Symlink umbiegt kann man ganz schnell ein Update ausprobieren oder eine neue source testen
* Die Archive und den leeren Dummy Ordner kann man jetzt löschen:
rm -r dummy-4.0.2
rm dummy-4.0.3.tar.gz
rm typo3_src-4.0.2.tar.gz
* Im Browser müßte jetzt schon was kommen (/typo3 oder /index.php)
* Mit dem vi Editor können wir die Die Funktion im Installer auskommentieren:
vi typo3_src-4.0.2/install/index.php
* Mit i kommt man in den Einfügemodus Esc verläßt ihn :wq! speichert und schließt den Editor.

* Jetzt kann man den Typo3 Installer starten
* Um die Rechte im Terminal anzupassen kann man den Befehl chmod benutzen
=== Beschreibung der Installation aus der Datei 'install.txt' der Typo3 4.0.2 Distribution ===

<pre>
**************************
* UNIX ARCHIVES OF TYPO3 *
**************************

INTRODUCTION
============

As you have downloaded this package you seem to know already about TYPO3.
If you don't, visit http://typo3.org/ where you can find many useful
information.

This short guide lists the important steps to install this package.

By default TYPO3 installs into the folder:
http://[your.site.name]/<this_site_name>/

Read the additional instructions to install TYPO3 in the root folder:
http://[your.site.name]/

IMPORTANT NOTE
==============

Please be aware of the fact that the file transfer protocol (FTP) does not
support Symlinks. You cannot unpack these archives locally and copy them
to your server using FTP, even if the target server actually is a Unix
server.

So if you don't have shell access, try to use a terminal emulator instead.
(PHPshell to give you an example - Google knows all of them!)

If this doesn't work you'll have to stick back to the ZIP version :-(

NEWBIE INFORMATION ABOUT THE TYPO3 FILESYSTEM STRUCTURE
=======================================================

A Unix TYPO3 installation consists of two parts:
1) The "source" package
2) The "dummy" package

The dummy package contains the skeleton directory structure for a TYPO3
installation and a symlink ('typo3_src') to the location of the source
package which contains all the PHP files, images, JavaScript files, etc.
that TYPO3 needs to run.

In other words: You can have several TYPO3 installations with just one
source package. A typical directory structure looks like this:

/var/www/typo3_src-3.8.1/ # the untared 3.8.0 source package
/var/www/typo3_src-4.0/ # the untared 4.0 source package
/var/www/installation1/ # the untared dummy package of a TYPO3
# installation running on TYPO3 3.8.1
/typo3_src --> ../typo3_src-3.8.1/ # a symlink to the 3.8.1 source
/typo3conf/
/typo3temp/
/fileadmin/
/.../
/var/www/installation2/ # the untared dummy package of a TYPO3
# installation running on TYPO3 4.0
/typo3_src --> ../typo3_src-4.0/ # a symlink to the 4.0 source
/typo3conf/
/typo3temp/
/fileadmin/
/.../

As you see, the two TYPO3-installations (possibly with different domains)
can use the same TYPO3 source package. You can even change the source
package simply be changing the symlink inside the installation directory.

STEP BY STEP
============

1 Get the TYPO3 source package and the TYPO3 dummy package.

2 Copy the archives to the web root of your server.
(Debian default is /var/www/, SuSE default is /srv/www/)

3 Unpack the archives:
$ tar xzf typo3_src-<version>.tar.gz
$ tar xfz dummy-<version>.tar.gz

4 Rename the dummy-<version> directory to fit your needs and make sure it
is accessible by your webserver (for example by creating a virtual
host). We assume you rename the directory to cms:
$ mv dummy-<version> cms

5 Set permissions (as root): There are at least two options.
These steps will make four directories writable for the webserver:
- cms/fileadmin/
- cms/typo3conf/
- cms/typo3temp/
- cms/uploads/

5.a (recommended)
Run these commands as root in the cms/ directory:
# chgrp -R <wwwserver> fileadmin typo3conf typo3temp uploads
# chmod -R g+w,o-rwx fileadmin typo3conf typo3temp uploads

... where <wwwserver> is the name of the group your webserver
is running as

5.b (insecure but easy to apply)
I repeat: This is insecure!
Do not use this method if you are working on a shared server!

Simply run this command:
$ chmod -R a+w fileadmin typo3conf typo3temp uploads

6 Check the symlink cms/typo3_src and make sure it points to the source
directory.
(See above: "Newbie information about the TYPO3 filesystem structure")

7 In your browser, visit
http://[your.site.name]/cms/

8 Follow the instructions in the 1-2-3 install tool

9 From this point, you can access the backend through
http://[your.site.name]/cms/typo3/
with the username "admin" and password "password".

That's it :-)

INSTALLING TYPO3 IN THE WEBROOT FOLDER
======================================

1 Follow the steps 1-6 above.

2 Move the files in the cms/ folder up one level.

$ cd cms
$ mv * ../
$ cd ../

3 Update the symlink

$ rm typo3_src
$ ln -s ./typo3_src-<version> typo3_src

4 Now TYPO3 runs in http://[your.site.name]/

That's it :-)

WHAT SHOULD YOU DO IF YOU HAVE A PROBLEM?
=========================================

TYPO3 is a powerful and complex professional application. When you start
out there will be many things you don´t understand, or that don't seem to
make sense. There is a widely used mailing list (more information on
typo3.com & typo3.org) where many experienced users and developers
lurk... they are always willing to help, provided you followed these steps
BEFORE you ask your question:

1 - Read all available documentation carefully

2 - Read the webserver error logfiles
(for example /var/log/apache/error.log)

3 - Read all available documentation again

4 - Search the mailing list archive carefully

5 - If you still can't figure it out - ask the list...:
- Newsgroup: news://news.netfielders.de/
- Mailing lists: http://lists.netfielders.de/

When posting to one of the lists, see the following guidelines...
- Be polite
Always include the version of used TYPO3 and server environment
(phpinfo())... note that this is available within the TYPO3
Install Tool
- Be as specific and clear as possible - questions like "my TYPO3
installation does not work - what can I do???" will be ignored.
Although English may not be your first language, if those reading
your posting can't understand it, you won't get the help you need
- If you are really having a tough time getting something working,
stay cool and don't criticise or flame. Problems are normally
caused by lack of research into the documentation, or
misunderstanding, not because of bugs. Be logical about your
troubleshooting, and you'll get there

6 - If you have identified a genuine new bug, report it at
http://bugs.typo3.org/ ...do not post to the list about it

Please be aware that if you ask questions that are answered in the
available documentation, you may not get a reply, or any help from the
developers or any experienced users!

We are aware that there is still some work to be done on the
documentation, and the platform for user support... please forgive us for
not having all these gaps filled. If you feel that some information is
missing, hard to find or just plain wrong, or you have a suggestion on
improving TYPO3 or the "support services", please let us know so that we
can do what is necessary. You could also volunteer to help with the work!

(c) Nigel Jackson, Ingmar Schlecht
Unix related additions made by Michael Stucki and some Wiki users:
http://wiki.typo3.org/index.php/Tgz-INSTALL.txt

-- Michael Stucki <michael@typo3.org> Sun, 26 Mar 2006 22:10:53 +0100
</pre>

== Image Magick über SSH Zugang auf VMWare ==
Quelle: http://www.4many.net/imagemagick_setup.html

<pre>
ImageMagick Installation on Virtual Host Account with SSH Access
Situation: Customer got virtual host with ssh access
TYPO3 was installed
no ImageMagick
after installing static linked package imagemagick-4.2.9_i386-static-1.tar.gz
TYPO3 complained that no valid version could be found
Problem: It turned out that due to the virtual setup and the setup of the Apache the environment got lost and the ImageMagick.so.9 couldn't be found during the exec()
Challenge:

1. convince the provider to change the setup
Nice try!
2. convince the provider to install ImageMagick globally
No support for third party products
3. fix it in TYPO3 to pass environment
possible solution, just no time to do so

Solution: Fixed it on script level

1. move required executable to *.bin, i.e.

mv convert convert.bin
mv combine combine.bin
mv identify identify.bin

2. create script

pico convert

3. content of the script file

#!/usr/local/bin/bash
export PATH; PATH="/home/usr203227042/ImageMagick-4.2.9/bin:$PATH"
export MAGICK_HOME="/home/usr203227042/ImageMagick-4.2.9"
export LD_LIBRARY_PATH="/home/usr203227042/ImageMagick-4.2.9/lib"
/home/usr203227042/ImageMagick-4.2.9/bin/convert.bin $*

4. make script executable

chmod 755 convert

5. repeat steps 2.-4. for combine and identify and don't forget to change convert.bin to the appropriate value
</pre>

== Trennung von Produktions und Live-Server (Bearbeitung der Seiten und Darstellung) ==
Für den Website-Betrieb sind die Verzeichnisse TSLib und T3Lib notwendig um eine Website auszuliefern.

Für die Bearbeitung von Seiten sind die Dateien im Typo3 Verzeichnis zuständig. Ohne Typo3 Verzeichnis gibt es kein Backend aber die Seiten funktionieren trotzdem. Ein gutes Mittel um die Seiten vor Angreifern zu schützen.

siehe auch [[Typo3 - Update]]

== Zentrale Typo3-Installation vs mehrere Typo3 ==

Verschiedene Gründe:
1. Es gibt aus Sicherheitsgründen keinen Remote Zugang für unseren Server. Das macht es etwas umständlicher.

2. Von Version 3.7-3.8 gab es bei manchen Extensions Probleme mit Updates, bzw. es gab Extensions die das Typo auch mal aus dem Tritt brachten. Wenn wir alle Präsenzen auf einem Typo laufen lassen würden wären bei einem Fehler alle Homepages betroffen und Nebenwirkungen unter Umständen nicht so einfach zu sehen. Mit der getrennten Installation kann man auch bei sehr experimentellen Extensions relativ sicher updaten. Auch wenn wir verschiedene Datenbanken benutzen würden. Erst ab Version 4 gibt es außerdem die Möglichkeit Seiten vernünftig zu testen bevor Sie bei Änderungen Online gehen. Das war bisher nur mit einer ziemlich umständlichen Extension möglich.

Manche würden das vielleicht als Übervorsichtig auslegen. Im Endeffekt hat es nur den Nachteil der längeren Uploadzeiten. Speicherplatz spielt im Grunde kaum eine Rolle. Der Server wird auch nicht wesentlich mehr belastet. Weil die Skripte egal ob in einer oder in mehreren Typos ja immer für jede Anfrage abgearbeitet werden.

3. Wir haben den Kunden eine komplette Installation verkauft mit der Sie machen können was Sie wollen. Dafür bekommen Sie natürlich auch eine eigene Installation.

Für die Miettypos werden wir allerdings eine einzelne Installation benutzen. Für eine Agentur bietet sich ebenfalls eine eigene Installation an auf der die betreuten Präsenzen laufen.

4. Manche Typos laufen auf anderen Servern ;-) Z.T. mit Anpassungen im Quellcode vom Typo.

=== Weitere Pro und Kontra Argumente ===

* Zeitersparnis beim Update in zentraler Installation
* Ein Backend=>Admin Account unübersichtlich

== automatische Installation ==

Überlegungen zum automatischen Installieren:

Ausgehend von einer fertigen Grundinstallation mit Benutzern und Rechten plus einigen Dummy-Seiten müßten sich per Knopfdruck Installationen anfertigen lassen.

Einzelschritte:
* Notwendige Dateien (Typo3 System, Filadmin Ordner)
* Datenbank (inkl. Benutzer und Dummy Inhalten)
* Config-Datei (automatisiert ?)

== Typo3 - Update ==
=== 3.8 auf 4.0 ===
Ordner typo3, t3lib ersetzen
misc aufspielen
index.php ersetzen (root)

Update Wizard im Install Tool ausführen

Im Database Analyzer Compare und danach die erforderlichen Updates der Datenbanktabellen ausführen.

Nicht benötigte Extensions entfernen und entsprechend Templates anpassen

Alte Sprachpakete löschen und mit dem Translation Handling im Extension Manager die benötigten Sprachen aktualisieren.

=== Kompatibilitätsmodus 3.8 für Version 4 ===
Nach Update von 3.8.x auf 4.0 läuft das Typo zunächst im Kompatibilitätsmodus.

Folgendes sollte verändert werden damit die Ausgabe auch nach umschalten wieder geht.
The following updates will be performed:

changeCompatibilityVersion
TYPO3 output is currently compatible to version 3.8. To use all the new features in the current TYPO3 version, make sure you follow the guidelines below to upgrade without problems.

Follow the steps below carefully and confirm every step!
You will see this list again after you performed the update.
CMS Frontend

*

Word separator character for simulateStaticDocument is changed from underscore (_) to hyphen (-) to make URLs more friendly for search enginesURLs that are already existing (e.g. external links to your site) will still work like before.

You can set the separator character back to an underscore by putting the following line into the Setup section of your Page TypoScript template:

config.simulateStaticDocuments_replacementChar = _
*

CSS Stylesheets and JavaScript are put into an external file by default.

Technically, that means that the default value of "config.inlineStyle2TempFile" is now set to "1" and that of "config.removeDefaultJS" to "external"

Acknowledged
CSS Styled Content: Accessibility improvements

The rendering of the following elements will change:

* tt_content.menu (used f.e. for sitemaps): Instead of div-tags, lists are used now.

* tt_content.mailform: Mailforms do not use tables anymore, instead, they use the div-tag. Besides that, mailforms are accessible now.

* The p-tag has been removed from all table cells.

* CSS based "image" and "text with image"
As the extension cron_cssstyledimgtext has been merged into the core, rendering of the content elements "image" and "text with image" has been changed to be CSS instead of table based. Read the 4.0 release notes for further information.

You will have to update your stylesheets to comply with these changes.

Acknowledged

Check all (ignore selection above)
WARNING: this might break the output of your website.
Show database queries performed

Linux Administration

2007-01-03T11:59:33Z

217.228.133.51: /* wichtige Linux Befehle */

== Hinweise ==
* Wenn man mit Plesk arbeitet ist es wichtig zuerst einen User Account zu haben (wird bei 1und1 gleich mit erledigt) Erst dann stimmen die Verzeichnisse (siehe Wie ist ein Suse Server organisiert)

== Zugang über SSH ==

== Wie ist ein Suse Server Organisiert ? ==
Der '''htdoc''' Ordner unter Suse befindet sich oberhalb von
/root in
/srv/www/htdocs/ .

Wenn '''Plesk''' genutzt wird und bereits eine Domain eingerichtetist,ist der aktive Ordner unterhalb von
/srv/www/vhosts/ zu finden.

== wichtige Linux Befehle ==
'''cd''' ''Verzeichnis''= Change Directory
cd Verzeichnisname
cd .. (eins hoch)

'''ls''' oder '''dir''' Auflistung des Ordnerinhalts
ls -la (auch versteckte und ausführliche Ansicht)

'''wget''' Adresse = Download v. Dateien
z.B.:
wget http://prdownloads.sourceforge.net/typo3/typo3_src-4.0.4.tar.gz?download

'''cp''' = Kopieren von Dateien

'''tar''' = Ein-/Auspacken von Archiven
tar xzfv meinVerzeichnis.tar.gz
tar xfv meinVerzeichnis.tar
tar xf meinVerzeichnis.tar

'''ln''' = Symlink bauen
ln -s typo3_src-.4.0.2 typo3_src

weitere unter: [[Die wichtigsten Linux Befehle]]

== Editoren unter Linux ==
Pico

Vim

Joe

== ImageMagick ==
[[ImageMagick installieren]]

Typo3 - Installation

2007-01-03T11:55:18Z

217.228.133.51: /* Typo3 auf Unix installieren */

== Typo3 Autoinstallation ==
Wünschenswert wäre ein Script, welches eine Typo3 Grundinstallation vollautomatisch durchführt. Als ersten Schritt einige Vorüberlegungen:
Die Installation sollte nach Angabe einer Datenbank die Typo3 Verzeichnisse hochladen, auspacken und das Konfigurationsfile mit den Datenbankwerten belegen. Weiterhin sollte die Datenbank bereits einen Admin-User einige Seiten und einige Grundtemplates enthalten. Typo3 enthält ja die Möglichkeit im DB Teil der installation ein eigenes .sql File zu benutzen, welches bereits die nötigen Werte enthält.

== Grundsätzliche Installation ==

=== Uploaden ===

# Typo3 - Dummy auf den Server laden
# Aus dem Installscript /typo3/install/index.php die die() Funktion auskommentieren
# Install Skript im Browser aufrufen (Standard Passwort ist joh316)
# Passwort ändern !! und neu einloggen (evt. Schreibrecht für /typo3/typo3conf/localconf.php setzten)

=== Basic Configuration ===

# Schreibrechte für die rot markierten Ordner ändern und den den fileadmin Ordner ebenfalls schreibbar machen.
# Datenbank Zugangsdaten eingeben. Host ist in der Regel 'localhost'
# Update localconf.php klicken dann click to continue
# Jetzt die Datenbank im neuen Dropdownfeld. Auswählen
# Encryption key: Generate Knopf klicken

=== Database Analyser ===
# Benötigte Tabellen anlegen: Compare klicken - dann write to database
# Dump static data IMPORT
# (Notwendig?) Tabellen füllen mit statischen Templates typo3conf/database.sql (1.1 M) ebenfalls Compare und write to database
# admin User erstellen damit man sich im Backend einloggen kann.

=== All Configuration ===
# [gdlib_2] auf 1 stellen Wenn GDlib Version 2 Verwendet wird
# [TTFdpi] muß auf 96 stehen wenn die Schrift im Bild bei 'Basic Configuration' nicht vollständig angezeigt wird.
# [noEdit] auf 0 stellen dann kann man vom Backend-Bereich Text-Dateien (z.B. CSS-Files) verändern.
# [warning_email_addr] setzten dann bekommt man eine Email wenn sich jemand viermal falsch einloggt

=== Wichtige ToDos im Typo Backend ===
# Passwort für Install Tool ändern
# Ab Typo4.x DB References Updaten
# Deutsche Sprachpakete im Extension Manage laden (für 3.8 die CSH Files)
# Standard Templates TS-Templates evt. HTML Template und CSS (für TV und Automaketemplate die Extensions nicht vergessen)
# Benutzer Konfiguration bzw. Page Konfiguration (UserTS und PageTS)
# Standard Extensions installieren

== Typo3 auf Unix installieren ==
Wenn man einen Shell Zugang zum Server hat, bietet sich eine Installation mit den tar Paketen an. Das geht erstens schneller als per FTP und man hat die Möglichkeit mit Symlinks zu arbeiten, die ein späteres Update erleichtern.
So gehts:
* Evt. Shell-Zugang erlauben (z.B. mit bash Terminal. Später wieder abschalten!)
* Remote Zugang z.B. mit Putty herstellen (Session > [IP], SSH /
* Entweder per FTP die tars (Source und Dummy) hochladen oder direkt mit der Shell vom Server aus laden z.B. mit
wget http://prdownloads.sourceforge.net/typo3/typo3_src-4.0.4.tar.gz?download
... (siehe Typo3 Buch)

* jetzt beide Pakete auspacken

tar xzf dummy-4.0.2.tar.gz
tar xzf typo3_src-4.0.2.tar.gz

* Es entstehen die Verzeichnisse
typo3_src-4.0.2
dummy-4.0.2

der Inhalt des Dummy Paket liegt später direkt auf dem Webspace.Der Quelltext der Source im src Verzeichnis damit man später drauf verweisen kann. Deshalb verschieben wir den Inhalt des Dummy Paket auf die unterste (aktuelle) Ebene:
mv dummy-4.0.2/* ./

* Jetzt machen wir einen Symlins der auf das src Verzeichnis zeigt und typo3_src heißt.
ln -s typo3_src-4.0.2 typo3_src (evt. ist schon ein Symlink da der vom dummyVerzeichnis nach unten zeigt evt. kann man nämlich auch das Dummy im Unterordner lassen - ToDo)Wenn man im Dummy Paket das typo3_src Symlink umbiegt kann man ganz schnell ein Update ausprobieren oder eine neue source testen
* Die Archive und den leeren Dummy Ordner kann man jetzt löschen:
rm -r dummy-4.0.2
rm dummy-4.0.3.tar.gz
rm typo3_src-4.0.2.tar.gz
* Im Browser müßte jetzt schon was kommen (/typo3 oder /index.php)
* Mit dem vi Editor können wir die Die Funktion im Installer auskommentieren:
vi typo3_src-4.0.2/install/index.php
* Mit i kommt man in den Einfügemodus Esc verläßt ihn :wq! speichert und schließt den Editor.

* Jetzt kann man den Typo3 Installer starten
* Um die Rechte im Terminal anzupassen kann man den Befehl chmod benutzen
=== Beschreibung der Installation aus der Datei 'install.txt' der Typo3 4.0.2 Distribution ===

<pre>
**************************
* UNIX ARCHIVES OF TYPO3 *
**************************

INTRODUCTION
============

As you have downloaded this package you seem to know already about TYPO3.
If you don't, visit http://typo3.org/ where you can find many useful
information.

This short guide lists the important steps to install this package.

By default TYPO3 installs into the folder:
http://[your.site.name]/<this_site_name>/

Read the additional instructions to install TYPO3 in the root folder:
http://[your.site.name]/

IMPORTANT NOTE
==============

Please be aware of the fact that the file transfer protocol (FTP) does not
support Symlinks. You cannot unpack these archives locally and copy them
to your server using FTP, even if the target server actually is a Unix
server.

So if you don't have shell access, try to use a terminal emulator instead.
(PHPshell to give you an example - Google knows all of them!)

If this doesn't work you'll have to stick back to the ZIP version :-(

NEWBIE INFORMATION ABOUT THE TYPO3 FILESYSTEM STRUCTURE
=======================================================

A Unix TYPO3 installation consists of two parts:
1) The "source" package
2) The "dummy" package

The dummy package contains the skeleton directory structure for a TYPO3
installation and a symlink ('typo3_src') to the location of the source
package which contains all the PHP files, images, JavaScript files, etc.
that TYPO3 needs to run.

In other words: You can have several TYPO3 installations with just one
source package. A typical directory structure looks like this:

/var/www/typo3_src-3.8.1/ # the untared 3.8.0 source package
/var/www/typo3_src-4.0/ # the untared 4.0 source package
/var/www/installation1/ # the untared dummy package of a TYPO3
# installation running on TYPO3 3.8.1
/typo3_src --> ../typo3_src-3.8.1/ # a symlink to the 3.8.1 source
/typo3conf/
/typo3temp/
/fileadmin/
/.../
/var/www/installation2/ # the untared dummy package of a TYPO3
# installation running on TYPO3 4.0
/typo3_src --> ../typo3_src-4.0/ # a symlink to the 4.0 source
/typo3conf/
/typo3temp/
/fileadmin/
/.../

As you see, the two TYPO3-installations (possibly with different domains)
can use the same TYPO3 source package. You can even change the source
package simply be changing the symlink inside the installation directory.

STEP BY STEP
============

1 Get the TYPO3 source package and the TYPO3 dummy package.

2 Copy the archives to the web root of your server.
(Debian default is /var/www/, SuSE default is /srv/www/)

3 Unpack the archives:
$ tar xzf typo3_src-<version>.tar.gz
$ tar xfz dummy-<version>.tar.gz

4 Rename the dummy-<version> directory to fit your needs and make sure it
is accessible by your webserver (for example by creating a virtual
host). We assume you rename the directory to cms:
$ mv dummy-<version> cms

5 Set permissions (as root): There are at least two options.
These steps will make four directories writable for the webserver:
- cms/fileadmin/
- cms/typo3conf/
- cms/typo3temp/
- cms/uploads/

5.a (recommended)
Run these commands as root in the cms/ directory:
# chgrp -R <wwwserver> fileadmin typo3conf typo3temp uploads
# chmod -R g+w,o-rwx fileadmin typo3conf typo3temp uploads

... where <wwwserver> is the name of the group your webserver
is running as

5.b (insecure but easy to apply)
I repeat: This is insecure!
Do not use this method if you are working on a shared server!

Simply run this command:
$ chmod -R a+w fileadmin typo3conf typo3temp uploads

6 Check the symlink cms/typo3_src and make sure it points to the source
directory.
(See above: "Newbie information about the TYPO3 filesystem structure")

7 In your browser, visit
http://[your.site.name]/cms/

8 Follow the instructions in the 1-2-3 install tool

9 From this point, you can access the backend through
http://[your.site.name]/cms/typo3/
with the username "admin" and password "password".

That's it :-)

INSTALLING TYPO3 IN THE WEBROOT FOLDER
======================================

1 Follow the steps 1-6 above.

2 Move the files in the cms/ folder up one level.

$ cd cms
$ mv * ../
$ cd ../

3 Update the symlink

$ rm typo3_src
$ ln -s ./typo3_src-<version> typo3_src

4 Now TYPO3 runs in http://[your.site.name]/

That's it :-)

WHAT SHOULD YOU DO IF YOU HAVE A PROBLEM?
=========================================

TYPO3 is a powerful and complex professional application. When you start
out there will be many things you don´t understand, or that don't seem to
make sense. There is a widely used mailing list (more information on
typo3.com & typo3.org) where many experienced users and developers
lurk... they are always willing to help, provided you followed these steps
BEFORE you ask your question:

1 - Read all available documentation carefully

2 - Read the webserver error logfiles
(for example /var/log/apache/error.log)

3 - Read all available documentation again

4 - Search the mailing list archive carefully

5 - If you still can't figure it out - ask the list...:
- Newsgroup: news://news.netfielders.de/
- Mailing lists: http://lists.netfielders.de/

When posting to one of the lists, see the following guidelines...
- Be polite
Always include the version of used TYPO3 and server environment
(phpinfo())... note that this is available within the TYPO3
Install Tool
- Be as specific and clear as possible - questions like "my TYPO3
installation does not work - what can I do???" will be ignored.
Although English may not be your first language, if those reading
your posting can't understand it, you won't get the help you need
- If you are really having a tough time getting something working,
stay cool and don't criticise or flame. Problems are normally
caused by lack of research into the documentation, or
misunderstanding, not because of bugs. Be logical about your
troubleshooting, and you'll get there

6 - If you have identified a genuine new bug, report it at
http://bugs.typo3.org/ ...do not post to the list about it

Please be aware that if you ask questions that are answered in the
available documentation, you may not get a reply, or any help from the
developers or any experienced users!

We are aware that there is still some work to be done on the
documentation, and the platform for user support... please forgive us for
not having all these gaps filled. If you feel that some information is
missing, hard to find or just plain wrong, or you have a suggestion on
improving TYPO3 or the "support services", please let us know so that we
can do what is necessary. You could also volunteer to help with the work!

(c) Nigel Jackson, Ingmar Schlecht
Unix related additions made by Michael Stucki and some Wiki users:
http://wiki.typo3.org/index.php/Tgz-INSTALL.txt

-- Michael Stucki <michael@typo3.org> Sun, 26 Mar 2006 22:10:53 +0100
</pre>

== Image Magick über SSH Zugang auf VMWare ==
Quelle: http://www.4many.net/imagemagick_setup.html

<pre>
ImageMagick Installation on Virtual Host Account with SSH Access
Situation: Customer got virtual host with ssh access
TYPO3 was installed
no ImageMagick
after installing static linked package imagemagick-4.2.9_i386-static-1.tar.gz
TYPO3 complained that no valid version could be found
Problem: It turned out that due to the virtual setup and the setup of the Apache the environment got lost and the ImageMagick.so.9 couldn't be found during the exec()
Challenge:

1. convince the provider to change the setup
Nice try!
2. convince the provider to install ImageMagick globally
No support for third party products
3. fix it in TYPO3 to pass environment
possible solution, just no time to do so

Solution: Fixed it on script level

1. move required executable to *.bin, i.e.

mv convert convert.bin
mv combine combine.bin
mv identify identify.bin

2. create script

pico convert

3. content of the script file

#!/usr/local/bin/bash
export PATH; PATH="/home/usr203227042/ImageMagick-4.2.9/bin:$PATH"
export MAGICK_HOME="/home/usr203227042/ImageMagick-4.2.9"
export LD_LIBRARY_PATH="/home/usr203227042/ImageMagick-4.2.9/lib"
/home/usr203227042/ImageMagick-4.2.9/bin/convert.bin $*

4. make script executable

chmod 755 convert

5. repeat steps 2.-4. for combine and identify and don't forget to change convert.bin to the appropriate value
</pre>

== Trennung von Produktions und Live-Server (Bearbeitung der Seiten und Darstellung) ==
Für den Website-Betrieb sind die Verzeichnisse TSLib und T3Lib notwendig um eine Website auszuliefern.

Für die Bearbeitung von Seiten sind die Dateien im Typo3 Verzeichnis zuständig. Ohne Typo3 Verzeichnis gibt es kein Backend aber die Seiten funktionieren trotzdem. Ein gutes Mittel um die Seiten vor Angreifern zu schützen.

siehe auch [[Typo3 - Update]]

== Zentrale Typo3-Installation vs mehrere Typo3 ==

Verschiedene Gründe:
1. Es gibt aus Sicherheitsgründen keinen Remote Zugang für unseren Server. Das macht es etwas umständlicher.

2. Von Version 3.7-3.8 gab es bei manchen Extensions Probleme mit Updates, bzw. es gab Extensions die das Typo auch mal aus dem Tritt brachten. Wenn wir alle Präsenzen auf einem Typo laufen lassen würden wären bei einem Fehler alle Homepages betroffen und Nebenwirkungen unter Umständen nicht so einfach zu sehen. Mit der getrennten Installation kann man auch bei sehr experimentellen Extensions relativ sicher updaten. Auch wenn wir verschiedene Datenbanken benutzen würden. Erst ab Version 4 gibt es außerdem die Möglichkeit Seiten vernünftig zu testen bevor Sie bei Änderungen Online gehen. Das war bisher nur mit einer ziemlich umständlichen Extension möglich.

Manche würden das vielleicht als Übervorsichtig auslegen. Im Endeffekt hat es nur den Nachteil der längeren Uploadzeiten. Speicherplatz spielt im Grunde kaum eine Rolle. Der Server wird auch nicht wesentlich mehr belastet. Weil die Skripte egal ob in einer oder in mehreren Typos ja immer für jede Anfrage abgearbeitet werden.

3. Wir haben den Kunden eine komplette Installation verkauft mit der Sie machen können was Sie wollen. Dafür bekommen Sie natürlich auch eine eigene Installation.

Für die Miettypos werden wir allerdings eine einzelne Installation benutzen. Für eine Agentur bietet sich ebenfalls eine eigene Installation an auf der die betreuten Präsenzen laufen.

4. Manche Typos laufen auf anderen Servern ;-) Z.T. mit Anpassungen im Quellcode vom Typo.

=== Weitere Pro und Kontra Argumente ===

* Zeitersparnis beim Update in zentraler Installation
* Ein Backend=>Admin Account unübersichtlich

== automatische Installation ==

Überlegungen zum automatischen Installieren:

Ausgehend von einer fertigen Grundinstallation mit Benutzern und Rechten plus einigen Dummy-Seiten müßten sich per Knopfdruck Installationen anfertigen lassen.

Einzelschritte:
* Notwendige Dateien (Typo3 System, Filadmin Ordner)
* Datenbank (inkl. Benutzer und Dummy Inhalten)
* Config-Datei (automatisiert ?)

== Typo3 - Update ==
=== 3.8 auf 4.0 ===
Ordner typo3, t3lib ersetzen
misc aufspielen
index.php ersetzen (root)

Update Wizard im Install Tool ausführen

Im Database Analyzer Compare und danach die erforderlichen Updates der Datenbanktabellen ausführen.

Nicht benötigte Extensions entfernen und entsprechend Templates anpassen

Alte Sprachpakete löschen und mit dem Translation Handling im Extension Manager die benötigten Sprachen aktualisieren.

=== Kompatibilitätsmodus 3.8 für Version 4 ===
Nach Update von 3.8.x auf 4.0 läuft das Typo zunächst im Kompatibilitätsmodus.

Folgendes sollte verändert werden damit die Ausgabe auch nach umschalten wieder geht.
The following updates will be performed:

changeCompatibilityVersion
TYPO3 output is currently compatible to version 3.8. To use all the new features in the current TYPO3 version, make sure you follow the guidelines below to upgrade without problems.

Follow the steps below carefully and confirm every step!
You will see this list again after you performed the update.
CMS Frontend

*

Word separator character for simulateStaticDocument is changed from underscore (_) to hyphen (-) to make URLs more friendly for search enginesURLs that are already existing (e.g. external links to your site) will still work like before.

You can set the separator character back to an underscore by putting the following line into the Setup section of your Page TypoScript template:

config.simulateStaticDocuments_replacementChar = _
*

CSS Stylesheets and JavaScript are put into an external file by default.

Technically, that means that the default value of "config.inlineStyle2TempFile" is now set to "1" and that of "config.removeDefaultJS" to "external"

Acknowledged
CSS Styled Content: Accessibility improvements

The rendering of the following elements will change:

* tt_content.menu (used f.e. for sitemaps): Instead of div-tags, lists are used now.

* tt_content.mailform: Mailforms do not use tables anymore, instead, they use the div-tag. Besides that, mailforms are accessible now.

* The p-tag has been removed from all table cells.

* CSS based "image" and "text with image"
As the extension cron_cssstyledimgtext has been merged into the core, rendering of the content elements "image" and "text with image" has been changed to be CSS instead of table based. Read the 4.0 release notes for further information.

You will have to update your stylesheets to comply with these changes.

Acknowledged

Check all (ignore selection above)
WARNING: this might break the output of your website.
Show database queries performed

Typo3 - Installation

2007-01-03T11:40:54Z

217.228.133.51: /* Typo3 auf Unix installieren */

== Typo3 Autoinstallation ==
Wünschenswert wäre ein Script, welches eine Typo3 Grundinstallation vollautomatisch durchführt. Als ersten Schritt einige Vorüberlegungen:
Die Installation sollte nach Angabe einer Datenbank die Typo3 Verzeichnisse hochladen, auspacken und das Konfigurationsfile mit den Datenbankwerten belegen. Weiterhin sollte die Datenbank bereits einen Admin-User einige Seiten und einige Grundtemplates enthalten. Typo3 enthält ja die Möglichkeit im DB Teil der installation ein eigenes .sql File zu benutzen, welches bereits die nötigen Werte enthält.

== Grundsätzliche Installation ==

=== Uploaden ===

# Typo3 - Dummy auf den Server laden
# Aus dem Installscript /typo3/install/index.php die die() Funktion auskommentieren
# Install Skript im Browser aufrufen (Standard Passwort ist joh316)
# Passwort ändern !! und neu einloggen (evt. Schreibrecht für /typo3/typo3conf/localconf.php setzten)

=== Basic Configuration ===

# Schreibrechte für die rot markierten Ordner ändern und den den fileadmin Ordner ebenfalls schreibbar machen.
# Datenbank Zugangsdaten eingeben. Host ist in der Regel 'localhost'
# Update localconf.php klicken dann click to continue
# Jetzt die Datenbank im neuen Dropdownfeld. Auswählen
# Encryption key: Generate Knopf klicken

=== Database Analyser ===
# Benötigte Tabellen anlegen: Compare klicken - dann write to database
# Dump static data IMPORT
# (Notwendig?) Tabellen füllen mit statischen Templates typo3conf/database.sql (1.1 M) ebenfalls Compare und write to database
# admin User erstellen damit man sich im Backend einloggen kann.

=== All Configuration ===
# [gdlib_2] auf 1 stellen Wenn GDlib Version 2 Verwendet wird
# [TTFdpi] muß auf 96 stehen wenn die Schrift im Bild bei 'Basic Configuration' nicht vollständig angezeigt wird.
# [noEdit] auf 0 stellen dann kann man vom Backend-Bereich Text-Dateien (z.B. CSS-Files) verändern.
# [warning_email_addr] setzten dann bekommt man eine Email wenn sich jemand viermal falsch einloggt

=== Wichtige ToDos im Typo Backend ===
# Passwort für Install Tool ändern
# Ab Typo4.x DB References Updaten
# Deutsche Sprachpakete im Extension Manage laden (für 3.8 die CSH Files)
# Standard Templates TS-Templates evt. HTML Template und CSS (für TV und Automaketemplate die Extensions nicht vergessen)
# Benutzer Konfiguration bzw. Page Konfiguration (UserTS und PageTS)
# Standard Extensions installieren

== Typo3 auf Unix installieren ==
Wenn man einen Shell Zugang zum Server hat, bietet sich eine Installation mit den tar Paketen an. Das geht erstens schneller als per FTP und man hat die Möglichkeit mit Symlinks zu arbeiten, die ein späteres Update erleichtern.
So gehts:
* Evt. Shell-Zugang erlauben (z.B. mit bash Terminal. Später wieder abschalten!)
* Remote Zugang z.B. mit Putty herstellen (Session > [IP], SSH /
* Entweder per FTP die tars (Source und Dummy) hochladen oder direkt vom Server mit
wget ... (siehe Typo3 Buch)
* jetzt beide Pakete auspacken

tar xzf dummy-4.0.2.tar.gz
tar xzf typo3_src-4.0.2.tar.gz

* Es entstehen die Verzeichnisse
typo3_src-4.0.2
dummy-4.0.2

der Inhalt des Dummy Paket liegt später direkt auf dem Webspace.Der Quelltext der Source im src Verzeichnis damit man später drauf verweisen kann. Deshalb verschieben wir den Inhalt des Dummy Paket auf die unterste (aktuelle) Ebene:
mv dummy-4.0.2/* ./

* Jetzt machen wir einen Symlins der auf das src Verzeichnis zeigt und typo3_src heißt.
ln -s typo3_src-4.0.2 typo3_src (evt. ist schon ein Symlink da der vom dummyVerzeichnis nach unten zeigt evt. kann man nämlich auch das Dummy im Unterordner lassen - ToDo)Wenn man im Dummy Paket das typo3_src Symlink umbiegt kann man ganz schnell ein Update ausprobieren oder eine neue source testen
* Die Archive und den leeren Dummy Ordner kann man jetzt löschen:
rm -r dummy-4.0.2
rm dummy-4.0.3.tar.gz
rm typo3_src-4.0.2.tar.gz
* Im Browser müßte jetzt schon was kommen (/typo3 oder /index.php)
* Mit dem vi Editor können wir die Die Funktion im Installer auskommentieren:
vi typo3_src-4.0.2/install/index.php
* Mit i kommt man in den Einfügemodus Esc verläßt ihn :wq! speichert und schließt den Editor.

* Jetzt kann man den Typo3 Installer starten
* Um die Rechte im Terminal anzupassen kann man den Befehl chmod benutzen
=== Beschreibung der Installation aus der Datei 'install.txt' der Typo3 4.0.2 Distribution ===

<pre>
**************************
* UNIX ARCHIVES OF TYPO3 *
**************************

INTRODUCTION
============

As you have downloaded this package you seem to know already about TYPO3.
If you don't, visit http://typo3.org/ where you can find many useful
information.

This short guide lists the important steps to install this package.

By default TYPO3 installs into the folder:
http://[your.site.name]/<this_site_name>/

Read the additional instructions to install TYPO3 in the root folder:
http://[your.site.name]/

IMPORTANT NOTE
==============

Please be aware of the fact that the file transfer protocol (FTP) does not
support Symlinks. You cannot unpack these archives locally and copy them
to your server using FTP, even if the target server actually is a Unix
server.

So if you don't have shell access, try to use a terminal emulator instead.
(PHPshell to give you an example - Google knows all of them!)

If this doesn't work you'll have to stick back to the ZIP version :-(

NEWBIE INFORMATION ABOUT THE TYPO3 FILESYSTEM STRUCTURE
=======================================================

A Unix TYPO3 installation consists of two parts:
1) The "source" package
2) The "dummy" package

The dummy package contains the skeleton directory structure for a TYPO3
installation and a symlink ('typo3_src') to the location of the source
package which contains all the PHP files, images, JavaScript files, etc.
that TYPO3 needs to run.

In other words: You can have several TYPO3 installations with just one
source package. A typical directory structure looks like this:

/var/www/typo3_src-3.8.1/ # the untared 3.8.0 source package
/var/www/typo3_src-4.0/ # the untared 4.0 source package
/var/www/installation1/ # the untared dummy package of a TYPO3
# installation running on TYPO3 3.8.1
/typo3_src --> ../typo3_src-3.8.1/ # a symlink to the 3.8.1 source
/typo3conf/
/typo3temp/
/fileadmin/
/.../
/var/www/installation2/ # the untared dummy package of a TYPO3
# installation running on TYPO3 4.0
/typo3_src --> ../typo3_src-4.0/ # a symlink to the 4.0 source
/typo3conf/
/typo3temp/
/fileadmin/
/.../

As you see, the two TYPO3-installations (possibly with different domains)
can use the same TYPO3 source package. You can even change the source
package simply be changing the symlink inside the installation directory.

STEP BY STEP
============

1 Get the TYPO3 source package and the TYPO3 dummy package.

2 Copy the archives to the web root of your server.
(Debian default is /var/www/, SuSE default is /srv/www/)

3 Unpack the archives:
$ tar xzf typo3_src-<version>.tar.gz
$ tar xfz dummy-<version>.tar.gz

4 Rename the dummy-<version> directory to fit your needs and make sure it
is accessible by your webserver (for example by creating a virtual
host). We assume you rename the directory to cms:
$ mv dummy-<version> cms

5 Set permissions (as root): There are at least two options.
These steps will make four directories writable for the webserver:
- cms/fileadmin/
- cms/typo3conf/
- cms/typo3temp/
- cms/uploads/

5.a (recommended)
Run these commands as root in the cms/ directory:
# chgrp -R <wwwserver> fileadmin typo3conf typo3temp uploads
# chmod -R g+w,o-rwx fileadmin typo3conf typo3temp uploads

... where <wwwserver> is the name of the group your webserver
is running as

5.b (insecure but easy to apply)
I repeat: This is insecure!
Do not use this method if you are working on a shared server!

Simply run this command:
$ chmod -R a+w fileadmin typo3conf typo3temp uploads

6 Check the symlink cms/typo3_src and make sure it points to the source
directory.
(See above: "Newbie information about the TYPO3 filesystem structure")

7 In your browser, visit
http://[your.site.name]/cms/

8 Follow the instructions in the 1-2-3 install tool

9 From this point, you can access the backend through
http://[your.site.name]/cms/typo3/
with the username "admin" and password "password".

That's it :-)

INSTALLING TYPO3 IN THE WEBROOT FOLDER
======================================

1 Follow the steps 1-6 above.

2 Move the files in the cms/ folder up one level.

$ cd cms
$ mv * ../
$ cd ../

3 Update the symlink

$ rm typo3_src
$ ln -s ./typo3_src-<version> typo3_src

4 Now TYPO3 runs in http://[your.site.name]/

That's it :-)

WHAT SHOULD YOU DO IF YOU HAVE A PROBLEM?
=========================================

TYPO3 is a powerful and complex professional application. When you start
out there will be many things you don´t understand, or that don't seem to
make sense. There is a widely used mailing list (more information on
typo3.com & typo3.org) where many experienced users and developers
lurk... they are always willing to help, provided you followed these steps
BEFORE you ask your question:

1 - Read all available documentation carefully

2 - Read the webserver error logfiles
(for example /var/log/apache/error.log)

3 - Read all available documentation again

4 - Search the mailing list archive carefully

5 - If you still can't figure it out - ask the list...:
- Newsgroup: news://news.netfielders.de/
- Mailing lists: http://lists.netfielders.de/

When posting to one of the lists, see the following guidelines...
- Be polite
Always include the version of used TYPO3 and server environment
(phpinfo())... note that this is available within the TYPO3
Install Tool
- Be as specific and clear as possible - questions like "my TYPO3
installation does not work - what can I do???" will be ignored.
Although English may not be your first language, if those reading
your posting can't understand it, you won't get the help you need
- If you are really having a tough time getting something working,
stay cool and don't criticise or flame. Problems are normally
caused by lack of research into the documentation, or
misunderstanding, not because of bugs. Be logical about your
troubleshooting, and you'll get there

6 - If you have identified a genuine new bug, report it at
http://bugs.typo3.org/ ...do not post to the list about it

Please be aware that if you ask questions that are answered in the
available documentation, you may not get a reply, or any help from the
developers or any experienced users!

We are aware that there is still some work to be done on the
documentation, and the platform for user support... please forgive us for
not having all these gaps filled. If you feel that some information is
missing, hard to find or just plain wrong, or you have a suggestion on
improving TYPO3 or the "support services", please let us know so that we
can do what is necessary. You could also volunteer to help with the work!

(c) Nigel Jackson, Ingmar Schlecht
Unix related additions made by Michael Stucki and some Wiki users:
http://wiki.typo3.org/index.php/Tgz-INSTALL.txt

-- Michael Stucki <michael@typo3.org> Sun, 26 Mar 2006 22:10:53 +0100
</pre>

== Image Magick über SSH Zugang auf VMWare ==
Quelle: http://www.4many.net/imagemagick_setup.html

<pre>
ImageMagick Installation on Virtual Host Account with SSH Access
Situation: Customer got virtual host with ssh access
TYPO3 was installed
no ImageMagick
after installing static linked package imagemagick-4.2.9_i386-static-1.tar.gz
TYPO3 complained that no valid version could be found
Problem: It turned out that due to the virtual setup and the setup of the Apache the environment got lost and the ImageMagick.so.9 couldn't be found during the exec()
Challenge:

1. convince the provider to change the setup
Nice try!
2. convince the provider to install ImageMagick globally
No support for third party products
3. fix it in TYPO3 to pass environment
possible solution, just no time to do so

Solution: Fixed it on script level

1. move required executable to *.bin, i.e.

mv convert convert.bin
mv combine combine.bin
mv identify identify.bin

2. create script

pico convert

3. content of the script file

#!/usr/local/bin/bash
export PATH; PATH="/home/usr203227042/ImageMagick-4.2.9/bin:$PATH"
export MAGICK_HOME="/home/usr203227042/ImageMagick-4.2.9"
export LD_LIBRARY_PATH="/home/usr203227042/ImageMagick-4.2.9/lib"
/home/usr203227042/ImageMagick-4.2.9/bin/convert.bin $*

4. make script executable

chmod 755 convert

5. repeat steps 2.-4. for combine and identify and don't forget to change convert.bin to the appropriate value
</pre>

== Trennung von Produktions und Live-Server (Bearbeitung der Seiten und Darstellung) ==
Für den Website-Betrieb sind die Verzeichnisse TSLib und T3Lib notwendig um eine Website auszuliefern.

Für die Bearbeitung von Seiten sind die Dateien im Typo3 Verzeichnis zuständig. Ohne Typo3 Verzeichnis gibt es kein Backend aber die Seiten funktionieren trotzdem. Ein gutes Mittel um die Seiten vor Angreifern zu schützen.

siehe auch [[Typo3 - Update]]

== Zentrale Typo3-Installation vs mehrere Typo3 ==

Verschiedene Gründe:
1. Es gibt aus Sicherheitsgründen keinen Remote Zugang für unseren Server. Das macht es etwas umständlicher.

2. Von Version 3.7-3.8 gab es bei manchen Extensions Probleme mit Updates, bzw. es gab Extensions die das Typo auch mal aus dem Tritt brachten. Wenn wir alle Präsenzen auf einem Typo laufen lassen würden wären bei einem Fehler alle Homepages betroffen und Nebenwirkungen unter Umständen nicht so einfach zu sehen. Mit der getrennten Installation kann man auch bei sehr experimentellen Extensions relativ sicher updaten. Auch wenn wir verschiedene Datenbanken benutzen würden. Erst ab Version 4 gibt es außerdem die Möglichkeit Seiten vernünftig zu testen bevor Sie bei Änderungen Online gehen. Das war bisher nur mit einer ziemlich umständlichen Extension möglich.

Manche würden das vielleicht als Übervorsichtig auslegen. Im Endeffekt hat es nur den Nachteil der längeren Uploadzeiten. Speicherplatz spielt im Grunde kaum eine Rolle. Der Server wird auch nicht wesentlich mehr belastet. Weil die Skripte egal ob in einer oder in mehreren Typos ja immer für jede Anfrage abgearbeitet werden.

3. Wir haben den Kunden eine komplette Installation verkauft mit der Sie machen können was Sie wollen. Dafür bekommen Sie natürlich auch eine eigene Installation.

Für die Miettypos werden wir allerdings eine einzelne Installation benutzen. Für eine Agentur bietet sich ebenfalls eine eigene Installation an auf der die betreuten Präsenzen laufen.

4. Manche Typos laufen auf anderen Servern ;-) Z.T. mit Anpassungen im Quellcode vom Typo.

=== Weitere Pro und Kontra Argumente ===

* Zeitersparnis beim Update in zentraler Installation
* Ein Backend=>Admin Account unübersichtlich

== automatische Installation ==

Überlegungen zum automatischen Installieren:

Ausgehend von einer fertigen Grundinstallation mit Benutzern und Rechten plus einigen Dummy-Seiten müßten sich per Knopfdruck Installationen anfertigen lassen.

Einzelschritte:
* Notwendige Dateien (Typo3 System, Filadmin Ordner)
* Datenbank (inkl. Benutzer und Dummy Inhalten)
* Config-Datei (automatisiert ?)

== Typo3 - Update ==
=== 3.8 auf 4.0 ===
Ordner typo3, t3lib ersetzen
misc aufspielen
index.php ersetzen (root)

Update Wizard im Install Tool ausführen

Im Database Analyzer Compare und danach die erforderlichen Updates der Datenbanktabellen ausführen.

Nicht benötigte Extensions entfernen und entsprechend Templates anpassen

Alte Sprachpakete löschen und mit dem Translation Handling im Extension Manager die benötigten Sprachen aktualisieren.

=== Kompatibilitätsmodus 3.8 für Version 4 ===
Nach Update von 3.8.x auf 4.0 läuft das Typo zunächst im Kompatibilitätsmodus.

Folgendes sollte verändert werden damit die Ausgabe auch nach umschalten wieder geht.
The following updates will be performed:

changeCompatibilityVersion
TYPO3 output is currently compatible to version 3.8. To use all the new features in the current TYPO3 version, make sure you follow the guidelines below to upgrade without problems.

Follow the steps below carefully and confirm every step!
You will see this list again after you performed the update.
CMS Frontend

*

Word separator character for simulateStaticDocument is changed from underscore (_) to hyphen (-) to make URLs more friendly for search enginesURLs that are already existing (e.g. external links to your site) will still work like before.

You can set the separator character back to an underscore by putting the following line into the Setup section of your Page TypoScript template:

config.simulateStaticDocuments_replacementChar = _
*

CSS Stylesheets and JavaScript are put into an external file by default.

Technically, that means that the default value of "config.inlineStyle2TempFile" is now set to "1" and that of "config.removeDefaultJS" to "external"

Acknowledged
CSS Styled Content: Accessibility improvements

The rendering of the following elements will change:

* tt_content.menu (used f.e. for sitemaps): Instead of div-tags, lists are used now.

* tt_content.mailform: Mailforms do not use tables anymore, instead, they use the div-tag. Besides that, mailforms are accessible now.

* The p-tag has been removed from all table cells.

* CSS based "image" and "text with image"
As the extension cron_cssstyledimgtext has been merged into the core, rendering of the content elements "image" and "text with image" has been changed to be CSS instead of table based. Read the 4.0 release notes for further information.

You will have to update your stylesheets to comply with these changes.

Acknowledged

Check all (ignore selection above)
WARNING: this might break the output of your website.
Show database queries performed

Typo3 - Installation

2007-01-03T11:28:33Z

217.228.133.51: /* Typo3 auf Unix installieren */

== Typo3 Autoinstallation ==
Wünschenswert wäre ein Script, welches eine Typo3 Grundinstallation vollautomatisch durchführt. Als ersten Schritt einige Vorüberlegungen:
Die Installation sollte nach Angabe einer Datenbank die Typo3 Verzeichnisse hochladen, auspacken und das Konfigurationsfile mit den Datenbankwerten belegen. Weiterhin sollte die Datenbank bereits einen Admin-User einige Seiten und einige Grundtemplates enthalten. Typo3 enthält ja die Möglichkeit im DB Teil der installation ein eigenes .sql File zu benutzen, welches bereits die nötigen Werte enthält.

== Grundsätzliche Installation ==

=== Uploaden ===

# Typo3 - Dummy auf den Server laden
# Aus dem Installscript /typo3/install/index.php die die() Funktion auskommentieren
# Install Skript im Browser aufrufen (Standard Passwort ist joh316)
# Passwort ändern !! und neu einloggen (evt. Schreibrecht für /typo3/typo3conf/localconf.php setzten)

=== Basic Configuration ===

# Schreibrechte für die rot markierten Ordner ändern und den den fileadmin Ordner ebenfalls schreibbar machen.
# Datenbank Zugangsdaten eingeben. Host ist in der Regel 'localhost'
# Update localconf.php klicken dann click to continue
# Jetzt die Datenbank im neuen Dropdownfeld. Auswählen
# Encryption key: Generate Knopf klicken

=== Database Analyser ===
# Benötigte Tabellen anlegen: Compare klicken - dann write to database
# Dump static data IMPORT
# (Notwendig?) Tabellen füllen mit statischen Templates typo3conf/database.sql (1.1 M) ebenfalls Compare und write to database
# admin User erstellen damit man sich im Backend einloggen kann.

=== All Configuration ===
# [gdlib_2] auf 1 stellen Wenn GDlib Version 2 Verwendet wird
# [TTFdpi] muß auf 96 stehen wenn die Schrift im Bild bei 'Basic Configuration' nicht vollständig angezeigt wird.
# [noEdit] auf 0 stellen dann kann man vom Backend-Bereich Text-Dateien (z.B. CSS-Files) verändern.
# [warning_email_addr] setzten dann bekommt man eine Email wenn sich jemand viermal falsch einloggt

=== Wichtige ToDos im Typo Backend ===
# Passwort für Install Tool ändern
# Ab Typo4.x DB References Updaten
# Deutsche Sprachpakete im Extension Manage laden (für 3.8 die CSH Files)
# Standard Templates TS-Templates evt. HTML Template und CSS (für TV und Automaketemplate die Extensions nicht vergessen)
# Benutzer Konfiguration bzw. Page Konfiguration (UserTS und PageTS)
# Standard Extensions installieren

== Typo3 auf Unix installieren ==
Wenn man einen Shell Zugang zum Server hat, bietet sich eine Installation mit den tar Paketen an. Das geht erstens schneller als per FTP und man hat die Möglichkeit mit Symlinks zu arbeiten, die ein späteres Update erleichtern.
So gehts:
* Evt. Shell-Zugang erlauben (später wieder abschalten)
* Remote Zugang z.B. mit Putty herstellen
* Entweder per FTP die tars (Source und Dummy) hochladen oder direkt vom Server mit
wget ... (siehe Typo3 Buch)
* jetzt beide Pakete auspacken

tar xzf dummy-4.0.2.tar.gz
tar xzf typo3_src-4.0.2.tar.gz

* Es entstehen die Verzeichnisse
typo3_src-4.0.2
dummy-4.0.2

der Inhalt des Dummy Paket liegt später direkt auf dem Webspace.Der Quelltext der Source im src Verzeichnis damit man später drauf verweisen kann. Deshalb verschieben wir den Inhalt des Dummy Paket auf die unterste (aktuelle) Ebene:
mv dummy-4.0.2/* ./

* Jetzt machen wir einen Symlins der auf das src Verzeichnis zeigt und typo3_src heißt.
ln -s typo3_src-4.0.2 typo3_src (evt. ist schon ein Symlink da der vom dummyVerzeichnis nach unten zeigt evt. kann man nämlich auch das Dummy im Unterordner lassen - ToDo)Wenn man im Dummy Paket das typo3_src Symlink umbiegt kann man ganz schnell ein Update ausprobieren oder eine neue source testen
* Die Archive und den leeren Dummy Ordner kann man jetzt löschen:
rm -r dummy-4.0.2
rm dummy-4.0.3.tar.gz
rm typo3_src-4.0.2.tar.gz
* Im Browser müßte jetzt schon was kommen (/typo3 oder /index.php)
* Mit dem vi Editor können wir die Die Funktion im Installer auskommentieren:
vi typo3_src-4.0.2/install/index.php
* Mit i kommt man in den Einfügemodus Esc verläßt ihn :wq! speichert und schließt den Editor.

* Jetzt kann man den Typo3 Installer starten
* Um die Rechte im Terminal anzupassen kann man den Befehl chmod benutzen
=== Beschreibung der Installation aus der Datei 'install.txt' der Typo3 4.0.2 Distribution ===

<pre>
**************************
* UNIX ARCHIVES OF TYPO3 *
**************************

INTRODUCTION
============

As you have downloaded this package you seem to know already about TYPO3.
If you don't, visit http://typo3.org/ where you can find many useful
information.

This short guide lists the important steps to install this package.

By default TYPO3 installs into the folder:
http://[your.site.name]/<this_site_name>/

Read the additional instructions to install TYPO3 in the root folder:
http://[your.site.name]/

IMPORTANT NOTE
==============

Please be aware of the fact that the file transfer protocol (FTP) does not
support Symlinks. You cannot unpack these archives locally and copy them
to your server using FTP, even if the target server actually is a Unix
server.

So if you don't have shell access, try to use a terminal emulator instead.
(PHPshell to give you an example - Google knows all of them!)

If this doesn't work you'll have to stick back to the ZIP version :-(

NEWBIE INFORMATION ABOUT THE TYPO3 FILESYSTEM STRUCTURE
=======================================================

A Unix TYPO3 installation consists of two parts:
1) The "source" package
2) The "dummy" package

The dummy package contains the skeleton directory structure for a TYPO3
installation and a symlink ('typo3_src') to the location of the source
package which contains all the PHP files, images, JavaScript files, etc.
that TYPO3 needs to run.

In other words: You can have several TYPO3 installations with just one
source package. A typical directory structure looks like this:

/var/www/typo3_src-3.8.1/ # the untared 3.8.0 source package
/var/www/typo3_src-4.0/ # the untared 4.0 source package
/var/www/installation1/ # the untared dummy package of a TYPO3
# installation running on TYPO3 3.8.1
/typo3_src --> ../typo3_src-3.8.1/ # a symlink to the 3.8.1 source
/typo3conf/
/typo3temp/
/fileadmin/
/.../
/var/www/installation2/ # the untared dummy package of a TYPO3
# installation running on TYPO3 4.0
/typo3_src --> ../typo3_src-4.0/ # a symlink to the 4.0 source
/typo3conf/
/typo3temp/
/fileadmin/
/.../

As you see, the two TYPO3-installations (possibly with different domains)
can use the same TYPO3 source package. You can even change the source
package simply be changing the symlink inside the installation directory.

STEP BY STEP
============

1 Get the TYPO3 source package and the TYPO3 dummy package.

2 Copy the archives to the web root of your server.
(Debian default is /var/www/, SuSE default is /srv/www/)

3 Unpack the archives:
$ tar xzf typo3_src-<version>.tar.gz
$ tar xfz dummy-<version>.tar.gz

4 Rename the dummy-<version> directory to fit your needs and make sure it
is accessible by your webserver (for example by creating a virtual
host). We assume you rename the directory to cms:
$ mv dummy-<version> cms

5 Set permissions (as root): There are at least two options.
These steps will make four directories writable for the webserver:
- cms/fileadmin/
- cms/typo3conf/
- cms/typo3temp/
- cms/uploads/

5.a (recommended)
Run these commands as root in the cms/ directory:
# chgrp -R <wwwserver> fileadmin typo3conf typo3temp uploads
# chmod -R g+w,o-rwx fileadmin typo3conf typo3temp uploads

... where <wwwserver> is the name of the group your webserver
is running as

5.b (insecure but easy to apply)
I repeat: This is insecure!
Do not use this method if you are working on a shared server!

Simply run this command:
$ chmod -R a+w fileadmin typo3conf typo3temp uploads

6 Check the symlink cms/typo3_src and make sure it points to the source
directory.
(See above: "Newbie information about the TYPO3 filesystem structure")

7 In your browser, visit
http://[your.site.name]/cms/

8 Follow the instructions in the 1-2-3 install tool

9 From this point, you can access the backend through
http://[your.site.name]/cms/typo3/
with the username "admin" and password "password".

That's it :-)

INSTALLING TYPO3 IN THE WEBROOT FOLDER
======================================

1 Follow the steps 1-6 above.

2 Move the files in the cms/ folder up one level.

$ cd cms
$ mv * ../
$ cd ../

3 Update the symlink

$ rm typo3_src
$ ln -s ./typo3_src-<version> typo3_src

4 Now TYPO3 runs in http://[your.site.name]/

That's it :-)

WHAT SHOULD YOU DO IF YOU HAVE A PROBLEM?
=========================================

TYPO3 is a powerful and complex professional application. When you start
out there will be many things you don´t understand, or that don't seem to
make sense. There is a widely used mailing list (more information on
typo3.com & typo3.org) where many experienced users and developers
lurk... they are always willing to help, provided you followed these steps
BEFORE you ask your question:

1 - Read all available documentation carefully

2 - Read the webserver error logfiles
(for example /var/log/apache/error.log)

3 - Read all available documentation again

4 - Search the mailing list archive carefully

5 - If you still can't figure it out - ask the list...:
- Newsgroup: news://news.netfielders.de/
- Mailing lists: http://lists.netfielders.de/

When posting to one of the lists, see the following guidelines...
- Be polite
Always include the version of used TYPO3 and server environment
(phpinfo())... note that this is available within the TYPO3
Install Tool
- Be as specific and clear as possible - questions like "my TYPO3
installation does not work - what can I do???" will be ignored.
Although English may not be your first language, if those reading
your posting can't understand it, you won't get the help you need
- If you are really having a tough time getting something working,
stay cool and don't criticise or flame. Problems are normally
caused by lack of research into the documentation, or
misunderstanding, not because of bugs. Be logical about your
troubleshooting, and you'll get there

6 - If you have identified a genuine new bug, report it at
http://bugs.typo3.org/ ...do not post to the list about it

Please be aware that if you ask questions that are answered in the
available documentation, you may not get a reply, or any help from the
developers or any experienced users!

We are aware that there is still some work to be done on the
documentation, and the platform for user support... please forgive us for
not having all these gaps filled. If you feel that some information is
missing, hard to find or just plain wrong, or you have a suggestion on
improving TYPO3 or the "support services", please let us know so that we
can do what is necessary. You could also volunteer to help with the work!

(c) Nigel Jackson, Ingmar Schlecht
Unix related additions made by Michael Stucki and some Wiki users:
http://wiki.typo3.org/index.php/Tgz-INSTALL.txt

-- Michael Stucki <michael@typo3.org> Sun, 26 Mar 2006 22:10:53 +0100
</pre>

== Image Magick über SSH Zugang auf VMWare ==
Quelle: http://www.4many.net/imagemagick_setup.html

<pre>
ImageMagick Installation on Virtual Host Account with SSH Access
Situation: Customer got virtual host with ssh access
TYPO3 was installed
no ImageMagick
after installing static linked package imagemagick-4.2.9_i386-static-1.tar.gz
TYPO3 complained that no valid version could be found
Problem: It turned out that due to the virtual setup and the setup of the Apache the environment got lost and the ImageMagick.so.9 couldn't be found during the exec()
Challenge:

1. convince the provider to change the setup
Nice try!
2. convince the provider to install ImageMagick globally
No support for third party products
3. fix it in TYPO3 to pass environment
possible solution, just no time to do so

Solution: Fixed it on script level

1. move required executable to *.bin, i.e.

mv convert convert.bin
mv combine combine.bin
mv identify identify.bin

2. create script

pico convert

3. content of the script file

#!/usr/local/bin/bash
export PATH; PATH="/home/usr203227042/ImageMagick-4.2.9/bin:$PATH"
export MAGICK_HOME="/home/usr203227042/ImageMagick-4.2.9"
export LD_LIBRARY_PATH="/home/usr203227042/ImageMagick-4.2.9/lib"
/home/usr203227042/ImageMagick-4.2.9/bin/convert.bin $*

4. make script executable

chmod 755 convert

5. repeat steps 2.-4. for combine and identify and don't forget to change convert.bin to the appropriate value
</pre>

== Trennung von Produktions und Live-Server (Bearbeitung der Seiten und Darstellung) ==
Für den Website-Betrieb sind die Verzeichnisse TSLib und T3Lib notwendig um eine Website auszuliefern.

Für die Bearbeitung von Seiten sind die Dateien im Typo3 Verzeichnis zuständig. Ohne Typo3 Verzeichnis gibt es kein Backend aber die Seiten funktionieren trotzdem. Ein gutes Mittel um die Seiten vor Angreifern zu schützen.

siehe auch [[Typo3 - Update]]

== Zentrale Typo3-Installation vs mehrere Typo3 ==

Verschiedene Gründe:
1. Es gibt aus Sicherheitsgründen keinen Remote Zugang für unseren Server. Das macht es etwas umständlicher.

2. Von Version 3.7-3.8 gab es bei manchen Extensions Probleme mit Updates, bzw. es gab Extensions die das Typo auch mal aus dem Tritt brachten. Wenn wir alle Präsenzen auf einem Typo laufen lassen würden wären bei einem Fehler alle Homepages betroffen und Nebenwirkungen unter Umständen nicht so einfach zu sehen. Mit der getrennten Installation kann man auch bei sehr experimentellen Extensions relativ sicher updaten. Auch wenn wir verschiedene Datenbanken benutzen würden. Erst ab Version 4 gibt es außerdem die Möglichkeit Seiten vernünftig zu testen bevor Sie bei Änderungen Online gehen. Das war bisher nur mit einer ziemlich umständlichen Extension möglich.

Manche würden das vielleicht als Übervorsichtig auslegen. Im Endeffekt hat es nur den Nachteil der längeren Uploadzeiten. Speicherplatz spielt im Grunde kaum eine Rolle. Der Server wird auch nicht wesentlich mehr belastet. Weil die Skripte egal ob in einer oder in mehreren Typos ja immer für jede Anfrage abgearbeitet werden.

3. Wir haben den Kunden eine komplette Installation verkauft mit der Sie machen können was Sie wollen. Dafür bekommen Sie natürlich auch eine eigene Installation.

Für die Miettypos werden wir allerdings eine einzelne Installation benutzen. Für eine Agentur bietet sich ebenfalls eine eigene Installation an auf der die betreuten Präsenzen laufen.

4. Manche Typos laufen auf anderen Servern ;-) Z.T. mit Anpassungen im Quellcode vom Typo.

=== Weitere Pro und Kontra Argumente ===

* Zeitersparnis beim Update in zentraler Installation
* Ein Backend=>Admin Account unübersichtlich

== automatische Installation ==

Überlegungen zum automatischen Installieren:

Ausgehend von einer fertigen Grundinstallation mit Benutzern und Rechten plus einigen Dummy-Seiten müßten sich per Knopfdruck Installationen anfertigen lassen.

Einzelschritte:
* Notwendige Dateien (Typo3 System, Filadmin Ordner)
* Datenbank (inkl. Benutzer und Dummy Inhalten)
* Config-Datei (automatisiert ?)

== Typo3 - Update ==
=== 3.8 auf 4.0 ===
Ordner typo3, t3lib ersetzen
misc aufspielen
index.php ersetzen (root)

Update Wizard im Install Tool ausführen

Im Database Analyzer Compare und danach die erforderlichen Updates der Datenbanktabellen ausführen.

Nicht benötigte Extensions entfernen und entsprechend Templates anpassen

Alte Sprachpakete löschen und mit dem Translation Handling im Extension Manager die benötigten Sprachen aktualisieren.

=== Kompatibilitätsmodus 3.8 für Version 4 ===
Nach Update von 3.8.x auf 4.0 läuft das Typo zunächst im Kompatibilitätsmodus.

Folgendes sollte verändert werden damit die Ausgabe auch nach umschalten wieder geht.
The following updates will be performed:

changeCompatibilityVersion
TYPO3 output is currently compatible to version 3.8. To use all the new features in the current TYPO3 version, make sure you follow the guidelines below to upgrade without problems.

Follow the steps below carefully and confirm every step!
You will see this list again after you performed the update.
CMS Frontend

*

Word separator character for simulateStaticDocument is changed from underscore (_) to hyphen (-) to make URLs more friendly for search enginesURLs that are already existing (e.g. external links to your site) will still work like before.

You can set the separator character back to an underscore by putting the following line into the Setup section of your Page TypoScript template:

config.simulateStaticDocuments_replacementChar = _
*

CSS Stylesheets and JavaScript are put into an external file by default.

Technically, that means that the default value of "config.inlineStyle2TempFile" is now set to "1" and that of "config.removeDefaultJS" to "external"

Acknowledged
CSS Styled Content: Accessibility improvements

The rendering of the following elements will change:

* tt_content.menu (used f.e. for sitemaps): Instead of div-tags, lists are used now.

* tt_content.mailform: Mailforms do not use tables anymore, instead, they use the div-tag. Besides that, mailforms are accessible now.

* The p-tag has been removed from all table cells.

* CSS based "image" and "text with image"
As the extension cron_cssstyledimgtext has been merged into the core, rendering of the content elements "image" and "text with image" has been changed to be CSS instead of table based. Read the 4.0 release notes for further information.

You will have to update your stylesheets to comply with these changes.

Acknowledged

Check all (ignore selection above)
WARNING: this might break the output of your website.
Show database queries performed

Typo3 - Checkliste

2007-01-03T11:14:34Z

217.228.133.51: /* Pflichtenheft */

Hier findest du Checklisten zu verschiedenen Aufgaben, bzw. eine Checkliste für den kompletten Webauftritt.
== Pflichtenheft ==
* '''Benutzer Account'''
** Anlegen
** Datenbank anlegen
* Typo3 aufspielen
** KAS-Server -> Autoinstallation über Kasserver
** Server mit Shell-Zugang -> Autoinstallation über Script (ToDo)
** Server mit Shell-Zugang -> Installation über Shell
** Server ohne Shell-Zugang -> FTP Upload (langwierig)

* '''HTML-Vorlage'''
** inkl. CSS und
** Menü mit den Zuständen normal hover und der Klasse on für gerade aktive Punkte
** ids für alle Bereiche die später mit dem Autoparser geparst werden anlegen. Alternativ entsprechende Marker oder Subparts anlegen.

* '''TypoScript Main-Template'''
** '''Variante 1'''
*** Marker ins HTML-Template einbinden
*** Marker im TS Anlegen
*** CSS einbinden
** '''Variante 2'''
*** Automaketemplate (Auto Template Parser konfigurieren)
*** Subparts anlegen (erst als TEXT-Objekte zum Testen)
** '''Navigation'''
** '''Inhalte formatieren (CSS, TS)'''
*** Text
*** Text mit Bild
*** Tabellen
*** Filelinks
*** Bulletlist
** '''Allgemeine Einstellungen'''
** '''Benutzer-Einstellungen (Rechte, Backend...)'''
** '''HTML-Area konfiguren'''
** '''Mehrsprachigkeit'''

* '''Extensions'''
** '''News-Plugin'''
** '''Gallerie'
** '''Weitere Plugins'''

== Allgemeine Einstellungen ==

== Mehrsprachigkeit realisieren ==

== Benutzer ==

Typo3 - Checkliste

2007-01-03T10:58:26Z

217.228.133.51: /* Pflichtenheft */

Hier findest du Checklisten zu verschiedenen Aufgaben, bzw. eine Checkliste für den kompletten Webauftritt.
== Pflichtenheft ==
* '''HTML-Vorlage'''
** inkl. CSS und
** Menü mit den Zuständen normal hover und der Klasse on für gerade aktive Punkte
** ids für alle Bereiche die später mit dem Autoparser geparst werden anlegen. Alternativ entsprechende Marker oder Subparts anlegen.

* '''TypoScript Main-Template'''
** '''Variante 1'''
*** Marker ins HTML-Template einbinden
*** Marker im TS Anlegen
*** CSS einbinden
** '''Variante 2'''
*** Automaketemplate (Auto Template Parser konfigurieren)
*** Subparts anlegen (erst als TEXT-Objekte zum Testen)
** '''Navigation'''
** '''Inhalte formatieren (CSS, TS)'''
*** Text
*** Text mit Bild
*** Tabellen
*** Filelinks
*** Bulletlist
** '''Allgemeine Einstellungen'''
** '''Benutzer-Einstellungen (Rechte, Backend...)'''
** '''HTML-Area konfiguren'''
** '''Mehrsprachigkeit'''

* '''Extensions'''
** '''News-Plugin'''
** '''Gallerie'
** '''Weitere Plugins'''

== Allgemeine Einstellungen ==

== Mehrsprachigkeit realisieren ==

== Benutzer ==

Typo3

2007-01-03T10:54:11Z

217.228.133.51: /* Typo3 - Einrichten */

== Typo3 - Praxis ==
=== Typo3 - Baukasten ===
Vorgefertigte Skripte etc. gibt es im

[[Typo3 - Baukasten]]

=== Typo3 - Checkliste ===
In der [[Typo3 - Checkliste]] sind alle Schritte bis zur fertigen Website enthalten (Stichwort Pflichtenheft).

== Typo3 - SEO ==
Wenn man Typo 3 für Suchmaschinen optimieren will gibt es mehrere Möglichkeiten. Hier die wichtigsten.

=== SEO - Links anpassen ===
==== Statische URLs erzeugen ====

'''Setup'''

### CONFIG ###
config {
### statische URL ###
simulateStaticDocuments = 1
simulateStaticDocuments_noTypeIfNoTitle = 1
# Hash wert für einige Extensions statt Parameter:
simulateStaticDocuments_pEnc=md5
simulateStaticDocuments_pEnc_onlyP = cHash, L, tx_ttNews[backPid], tx_ttnews[tt_news]
}
Nicht vergessen im Hauptverzeichnis des Servers die _.htaccess Datei in .htaccess umzubenennen.

Zusätzlich im Feld alias bei den Seiteneigenschaften einen Namen eingeben. Dann kann man die Seite unter: www.meinedomain.de/meinAlias.html ansprechen.

==== Real URL - Extension ====
Mit dieser Extension kann man die Namen für die Unterseiten auch automatisch erzeugen lassen. Vorher gut testen ob noch alle anderen Extensions gut laufen.

=== SEO - Google Sitemap ===
In Google kann man einen Account anlegen über den man Websites einreicht, sich als Benutzer verifiziert und eine Sitemap übermitteln kann. Damit hilft man Google beim indizieren.

Für die Sitemap gibt es eine sehr nette Extension:

mc_googlesitemap_0.4.1.t3x

die macht das ganz automatisch.

=== Verifizieren bei Google ===
Hat man einen Account bei Google kann man seine Seite verifizieren. Google macht das anhand eines HTML Dokuments oder anhand von Metatags. Mit Typo3 ist es einfacher den Meta Tag in die Seiten einzufügen.

Der Tag lautet etwa:<META name="verify-v1" content="0ikv2r96MAPrbYshmhw0FpZDvKdDLhuK66GMaMj1hHc=" />
die Zeichenkombination wird von Google erzeugt. In Typo würde man das jetzt folgendermaßen einbinden:

page.headerData.997 = TEXT
page.headerData.997.value = <META name="verify-v1" content="0ikv2r96MAPrbYshmhw0FpZDvKdDLhuK66GMaMj1hHc=" />

und fertig ist die Laube.Das Page Objekt muß natürlich vorher definiert sein...

== Tipps und Tricks ==
Ausgangspunkt für viele Problemlösungen finden sich hier:

[[Typo3 - Tipps und Tricks]]
Themen: Mehrsprachigkeit, Navigation, Probleme lösen...

== Typo3 - Referenzen ==
Für Typo3 gibt es einige Nachschlagewerke. Aber wo finde ich was? Im Kapitel [[Typo3 - Referenzen]] gibt es eine Übersicht.

== Typo3 - Installieren und Einrichten ==
Infos dazu unter:

[[Typo3 - Einrichten]]

== Typo3 - Wartung ==
Updates, temporäre Dateien, Backup, etc.

[[Typo3 - temporäre Dateien]]

[[Typo3 - Update]]

[[Typo3 - Security]]

== Typo3 - TypoScript ==
Alles über TypoScript die wichtigsten Objekte usw. gibt es unter [[Typo3 - TypoScript]]

== Typo3 - TSConfig ==
Mit TSUserConfig und TSPageConfig Einstellungen für bestimmte Benutzergruppen oder Seitenbereiche vornehmen. Z.B. Erscheinung des Backends anpassen. Benutzerpanel etc.

[[Typo3 - TSConfig]]

== Typo3 - Templates ==
Alles was mit HTML Templates, TS Templates, Static Templates usw. zu tun hat.
Auch Grundsätzliche TypoScript Einstellungen usw.

[[Typo3 - Templates]]

== Typo3 - Mehrsprachig ==
[[Typo3 - Mehrsprachige Seiten]]
[[Typo3 - Mehrsprachige Navigation]]

== Typo3 - Extensions ==

[[Typo3 - Extensions]]

== Typo3, CSS und Barrierefreiheit ==

[[Typo3 und CSS]]

[[Typo3 barrierefrei]]

== Typo3 ohne SSH Zugang ==
Hier hilft das Tool phpshell von Martin Geisler.Das Tool sollte nach der Verwendung wieder entfernt oder gut gesichert werden.
Nachtrag 19.1.2006 - Das Tool hilft leider nicht bei allen Servern da bestimmte notwendige Rechte z.B. das Entpacken von tar.gz Archiven nicht funktionieren. D.h. die Symlinks die sich per ftp nicht erstellen lassen können auch auf diese Weise nicht erstellt werden.

[http://mgeisler.net/php-shell/ Zur Homepage von phpshell]

== Typo3 - XHTML konforme Seiten ==

[[Typo3 - XHTML konforme Seiten]]