.. You may want to use the usual include line. Uncomment and adjust the path. .. include:: ../Includes.txt ================================== Installing Typo3 on Mandrake Linux ================================== :Author: Kasper Skårhøj :Created: 2002-11-01T00:32:00 :Changed: 2003-10-27T13:48:13 :Author: Alwin Viereck :Email: alwin@viereck.net :Info 3: :Info 4: .. _Installing-Typo3-on-Mandrake-Linux: Installing Typo3 on Mandrake Linux ================================== Extension Key: **av\_mandrakelinux\_install** Copyright 2000-2002, Alwin Viereck, This document is published under the Open Content License available from http://www.opencontent.org/opl.shtml The content of this document is related to TYPO3 \- a GNU/GPL CMS/Framework available from www.typo3.com .. _Table-of-Contents: Table of Contents ----------------- **Installing Typo3 on Mandrake Linux 1** **Introduction 1** What does it do? 1 Screenshots 1 **Install Mandrake Linux 9.1 1** Boot setting of your Computer 1 Select the language 2 Licence acception 2 Choose your mouse type 2 Security level 2 Harddrive partitioning 2 Package selection 3 Postfix and Webmin 3 Installation progress 3 System configuration 3 Create user accounts 3 Operationsystem starter installation 4 Summary 4 Update 4 Reboot 4 Additional Information 4 **URPMI Sources 4** Introduction 4 Installation 4 **Webserver installation 5** Introduction 5 Apache 5 PHP 5 MySQL 6 Image Magick 6 GD Library 6 Additional tools 6 Restart services 7 phpMyAdmin 7 **Typo3 verbose installation 8** Comment 8 TODO 8 .. _Introduction: Introduction ------------ .. _What-does-it-do: What does it do? ^^^^^^^^^^^^^^^^ \- This manual provides you with all the information needed to setup a Typo3 Server on Mandrake Linux. .. _Screenshots: Screenshots ^^^^^^^^^^^ \- Screenshots will be shown in the manual. .. _Install-Mandrake-Linux-9-1: Install Mandrake Linux 9.1 -------------------------- .. _Boot-setting-of-your-Computer: Boot setting of your Computer ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^ \- Please insert the Linux Mandrake 9.1 installation CD-ROM number 1 into your first drive. - While booting make sure that your server can boot from CD-ROM, otherwise you have to enter the BIOS and change the the first boot- device and boot again. - If there has been another operation system installed before on your server, the setup will ask you to choose on of the available options: - Upgrade 9.1 (Bamboo) - Upgrade 8.2 (Bluebird) - Install Pleae make sure that you choose the “Install” option, otherwise this document could be different from what will apear during the installation. The “Install” option will overwrite any other/old installation. .. _Select-the-language: Select the language ^^^^^^^^^^^^^^^^^^^ Please select you own language if not selected by default, then click the “Next” button. .. _Licence-acception: Licence acception ^^^^^^^^^^^^^^^^^ In order to install Mandrake Linux, you have to accept the terms and conditions Mandrake comes with. Please choose “accept” and then click on the “Next” button. .. _Choose-your-mouse-type: Choose your mouse type ^^^^^^^^^^^^^^^^^^^^^^ - This screen will ask you to choose your mouse connected to the computer. Normally there is one selected by default. - If you have connected a serial mouse, the setup is asking which port the mouse is connected to. The default port is ttyS0 / COM1. - If you have finished, press the “Next” button. .. _Security-level: Security level ^^^^^^^^^^^^^^ - Choosing the security level means influencing the whole security of your server. I suggest to choose “Higher” and evaluate that later, if not needed. Be aware of hacking risks, especially when your computer is permanently connected to the internet and has his own IP address. - The security issues of Mandrake are not yet discussed in that manual. Please make sure you go to the mandrake website and inform yourself, otherwise use any linux mailing lists and ask other people. .. _Harddrive-partitioning: Harddrive partitioning ^^^^^^^^^^^^^^^^^^^^^^ - The setup will ask you if you want to use the whole disk for installation. Please answer with “yes”. - The paritioning can be done automatically. If you are familiar with partitioning hardrives, choose “individual partitioning”. - I suggest to use the following guidelines: .. ### BEGIN~OF~TABLE ### .. _boot: /boot """"" .. container:: table-row Partition /boot Disc Space 100MB Partition Type Ext3 .. _root: /root """"" .. container:: table-row Partition /root Disc Space Approx. 9-10% Partition Type Ext3 .. _SWAP-Space: SWAP Space """""""""" .. container:: table-row Partition SWAP Space Disc Space 500MB – 1GB Partition Type SWAP .. _usr: /usr """" .. container:: table-row Partition /usr Disc Space Approx. 20% Partition Type Ext3 .. _var: /var """" .. container:: table-row Partition /var Disc Space Approx. 50% Partition Type Ext3 .. _home: /home """"" .. container:: table-row Partition /home Disc Space Approx. 20% Partition Type Ext3 .. ###### END~OF~TABLE ###### The directories /var and /home may occupy the most disc space, depending on what you use in your Typo3 website(e.g. many download files). .. _Package-selection: Package selection ^^^^^^^^^^^^^^^^^ \- The selection of packages depend on how you use the server (e.g. If you want to setup GUI like KDE or Gnom). - I normally just select: - Internet - Network - Shell-Tools - Development - Documentation - I do not install the server packages like webserver, mail, database etc. by default. I prefer to do it later because I want to know what is installed. - Remember that this manual shows you how to install your webserver and other packages. If you install additional tools over the setup, be aware of other steps you have to take during the installation of the typo3 server. .. _Postfix-and-Webmin: Postfix and Webmin ^^^^^^^^^^^^^^^^^^ The setup will ask you if you wish to install postfix and webmin. I do not install it, because my server is running in an intranet. Please choose whatever you need. .. _Installation-progress: Installation progress ^^^^^^^^^^^^^^^^^^^^^ Right now the choosen packages will be installed by the setup routine. The setup will show you how much time it needs to finish. The setup will ask you to change the installation discs as needed. Make sure you have them available. |img-1| .. _System-configuration: System configuration ^^^^^^^^^^^^^^^^^^^^ - After installation of the packages, the system will be configured. - No user interaction is needed, so just wait till the next screen turns up which asks you for entering the root password. .. _Create-user-accounts: Create user accounts ^^^^^^^^^^^^^^^^^^^^ - Consider to choose a password you can remember, but nobody can imagine as your choosen password. - The root password has to be of a certain length. - Try to use small and capital letters as well as numbers. - The next step will be to create other users who can access the server. - The users can be provided with certain rights/permission. Try to be conservative. Never give permission to somebody who does not need it. .. _Operationsystem-starter-installation: Operationsystem starter installation ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^ - The setup will install the operationsystem starter LILO. - Please choose the master boot record (MBR) as place to install to on the harddrive. .. _Summary: Summary ^^^^^^^ You get the chance to configure your system right now. Do not leave that out! Do it now. It is a lot easier right now than later. Go through the list and click on configure buttons. .. _Update: Update ^^^^^^ - If you have your server already connected to a network and configured your network card in the summary section, you can download updates now. - Updates contain solved problems, consider security issues etc. It is recommended to install the updates as soon as possible and track also in future use of the server. .. _Reboot: Reboot ^^^^^^ The setup is done :-) Your server can be rebooted right now. Click on the reboot button. .. _Additional-Information: Additional Information ^^^^^^^^^^^^^^^^^^^^^^ - If the server security level is set to “Higher”, you will not be able to login directly as “root”. - First login as normal user, then type in: .. ### BEGIN~OF~TABLE ### .. ###### END~OF~TABLE ###### Right now you can type in the “root” password and you will be logged in as root. .. _URPMI-Sources: URPMI Sources ------------- .. _Introduction: Introduction ^^^^^^^^^^^^ - Mandrake offers the possibility to install packages from internet sources. - You do not have to have installation discs anymore. - Therefore it makes further installation of packages very easy. - The internet sources are also the most recent releases and it is more softare available as on CD-ROM. .. _Installation: Installation ^^^^^^^^^^^^ - To install packages over internet sources you have to tell the Mandrake Package Manager (URPMI) the existence of the sources. - The registration of sources can be done with a script which you can dynamicly create over the following website, called Easy URPMI: http://plf.zarb.org/~nanardon/. Select your system Select the mirrors you want to include (please select at least “main” and “contrib”) Copy the given code into a file and add the following line at the top: “#!/bin/sh” as well as “urpmi.removemedia -a”. - Make sure your internet connection is up and running. - You have to make the file (you pasted the copied code into) executable (chmod 777 {file}). - Then start the file just with typing in the name in the shell and click return/enter. .. ### BEGIN~OF~TABLE ### .. _bin-sh: #!/bin/sh """"""""" .. container:: table-row a #!/bin/sh urpmi.removemedia -a urpmi.addmedia plf ftp://knight.zarb.org/pub/plf/mandrake/9.1 with hdlist.czurpmi.addmedia main ftp://public.ftp.planetmirror.com/pub/mandrake/9.1/i586/Mandrake/RPMS with ../base/hdlist.czurpmi.addmedia contrib ftp://sunsite.informatik .rwth-aachen.de/pub/Linux/mandrake/9.1/contrib/RPMS with../../i586/Mandrake/base/hdlist2.czurpmi.addmedia jpackage.free ftp://ftp.pbone.net/pub/jpackage/1.5/mandrake-9.1/free with hdlist.czurpmi.addmedia --update updates http://distro.ibiblio.org/pub /linux/distributions/mandrake/Mandrake/updates/9.1/RPMS/ with ../base/hdlist.cz .. ###### END~OF~TABLE ###### - This example script deletes at first the already registered sources in the Package Manager URPMI. - Then it starts to register online sources “plf”, “main”, “contrib” etc. - Be aware that the download of reference files can take a couple of minutes. A mirror can be down/not reachable. - Please make sure you have the “main” and “contrib” source included before you start with installation of Typo3. You will need several packages to download. - If the download of reference files doesn't work at all, please check the following things: Is you internet connection up and running ? Do you work behind a proxy ? Did you type in a URPMI mirror / source which is not available at present ? If necessary, you can also type in the command for adding a urpmi source directly over the shell. The script is just a way to make things easier/faster! .. _Webserver-installation: Webserver installation ---------------------- .. _Introduction: Introduction ^^^^^^^^^^^^ This chapter shows you, how and what to install for building Typo3 on your new Mandrake Server. .. _Apache: Apache ^^^^^^ .. ### BEGIN~OF~TABLE ### .. _urpmi-apache2: \# urpmi apache2 """""""""""""""" .. container:: table-row a \# urpmi apache2 \# service httpd start .. ###### END~OF~TABLE ###### - This command will install the Apache 2 release on your server. - After executing this command in the shell you might have to select certain packages to choose from as well as entering “y” to fullfill dependencies (additional, necessary packages will be installed). - In this case please select apache2-mod. .. _PHP: PHP ^^^ .. ### BEGIN~OF~TABLE ### .. _urpmi-mod-php: \# urpmi mod\_php """"""""""""""""" .. container:: table-row a \# urpmi mod\_php \# urpmi php-ini .. ###### END~OF~TABLE ###### - These commands will install the PHP Module for Apache and the configuration file “php.ini” for PHP. - After executing this command in the shell you might have to select certain packages to choose from as well as entering “y” to fullfill dependencies (additional, necessary packages will be installed). - In this case please select mod\_php. - For running Typo3 you need to configure the PHP configuration file. - Please type in the following command: .. ### BEGIN~OF~TABLE ### .. ###### END~OF~TABLE ###### - After the file has been opened in the editor “vi”, please click on “insert”. - Search for the following variable: “Memory\_limit = 8M” // Standard is 8M, not enough for Typo3! - Please set the memory limit at least to “32M”, otherwise the Typo3 Extension Manager will not work correctly. .. _MySQL: MySQL ^^^^^ .. ### BEGIN~OF~TABLE ### .. _urpmi-php-MySQL: \# urpmi php-MySQL """""""""""""""""" .. container:: table-row a \# urpmi php-MySQL \# urpmi MySQL \# service mysql start // starts the database \# chkconfig mysql on 345 // set the database to “start automatically on booting” .. ###### END~OF~TABLE ###### - After executing this command in the shell you might have to select certain packages to choose from as well as entering “y” to fullfill dependencies (additional, necessary packages will be installed). - These commands will install the MySQL database core modules as well as the plugins for PHP. - Afterwards the database will be started and set as “start automatically on booting”. .. _Image-Magick: Image Magick ^^^^^^^^^^^^ .. ### BEGIN~OF~TABLE ### .. ###### END~OF~TABLE ###### - Before installing Image Magick, you need to include the “contrib” URPMI source. If not available the installation will not work. - After executing this command in the shell you might have to select certain packages to choose from as well as entering “y” to fullfill dependencies (additional, necessary packages will be installed). - Be aware that the installation of Image Magick can include up to 42MB of additional packages. - During the installation of Image Magick it seems common that some packages have bad signatures. Please select “y” to continue the installation, otherwise Image Magick will not be installed correctly. .. _GD-Library: GD Library ^^^^^^^^^^ .. ### BEGIN~OF~TABLE ### .. ###### END~OF~TABLE ###### After executing this command in the shell you might have to select certain packages to choose from as well as entering “y” to fullfill dependencies (additional, necessary packages will be installed). .. _Additional-tools: Additional tools ^^^^^^^^^^^^^^^^ .. ### BEGIN~OF~TABLE ### .. _urpmi-sshd-SSHD-daemon-for-remote-control-of-server: \# urpmi sshd // SSHD daemon for remote control of server """"""""""""""""""""""""""""""""""""""""""""""""""""""""" .. container:: table-row a \# urpmi sshd // SSHD daemon for remote control of server \# urpmi gzip // compression tool like TAR \# urpmi catdoc // Used by theTypo3 extension “Indexed Search” to search in .doc files \# urpmi xpdf // Tool package which includes several scripts to search .pdf files; used by Typo3 extension “Indexed Search” .. ###### END~OF~TABLE ###### - After executing this command in the shell you might have to select certain packages to choose from as well as entering “y” to fullfill dependencies (additional, necessary packages will be installed). - For using SSH you need to configure the file “hosts.allow” .. ### BEGIN~OF~TABLE ### .. ###### END~OF~TABLE ###### Please edit the file like this: .. ### BEGIN~OF~TABLE ### .. _: # " .. container:: table-row a # \# hosts.allow This file describes the names of the hosts which are \# allowed to use the local INET services, as decided \# by the '/usr/sbin/tcpd' server. # sshd:192.168.1.1 // Please replace the IP 192.168.1.1 with your own IP address or the text “all” (security problem!!!) .. ###### END~OF~TABLE ###### To find out what IP address you have, please use the following examples: .. ### BEGIN~OF~TABLE ### .. _Click-on-START-than-execute-and-type-in-cms-confirm-with: Click on “START” than “execute” and type in “cms”, confirm with """"""""""""""""""""""""""""""""""""""""""""""""""""""""""""""" .. container:: table-row Example for Windows Click on “START” than “execute” and type in “cms”, confirm with enter/return. A DOS-Windows will appear. Type in “ipconfig” and confirm with enter/return. .. ###### END~OF~TABLE ###### .. ### BEGIN~OF~TABLE ### .. ###### END~OF~TABLE ###### - To use “sshd:all” in hosts.allow might be a serious security issue. I do not suggest to do that. - You may have problems to use an IP address because your dial-up IP is not a fixed IP and will change each time you dial-up with your Internet Service Provider. - Save the file with “ESC” then “:wq”. .. _Restart-services: Restart services ^^^^^^^^^^^^^^^^ .. ### BEGIN~OF~TABLE ### .. _service-httpd-restart-Apache-restart: \# service httpd restart // Apache restart """""""""""""""""""""""""""""""""""""""""" .. container:: table-row a \# service httpd restart // Apache restart \# service mysql restart // MySQL database restart .. ###### END~OF~TABLE ###### After installing several packages you have to restart at least the Apache webserver to load the new packages into the running systems. .. _phpMyAdmin: phpMyAdmin ^^^^^^^^^^ - phpMyAdmin is an open source GUI for mySQL - It is an easy way to configure your database engine for use with Typo3. - Please download the software from:http://sourceforge.net/projects/phpmyadmin/ - Alternatively you can download the software under Linux by typing in the following command in shell: .. ### BEGIN~OF~TABLE ### .. ###### END~OF~TABLE ###### To find out the “source of file” visit the project website of phpMyAdmin and copy the path or search in google.com for other mirrors. **Download and Extract phpMyAdmin** Open project website click on “Files” select a version of phpMyAdmin (.tar or .gz) Extract the archiv “/var/www/html/” .. ### BEGIN~OF~TABLE ### .. ###### END~OF~TABLE ###### or .. ### BEGIN~OF~TABLE ### .. _gzip-d-filename-gz: \# gzip -d {filename}.gz """""""""""""""""""""""" .. container:: table-row a \# gzip -d {filename}.gz \# tar -xf {extracted .gz file}.tar .. ###### END~OF~TABLE ###### ATTENTION, the combined/double extraction process has the following reason:.gz Files at the project website of phpMyAdmin are double compressed/packed, therefore you have to decompress in the same way. - Most of the time the extracted phpMyAdmin directory has a very complicated name with a certain version number etc. - To get rid of this, rename your directory into “phpMyAdmin” in the following way: .. ### BEGIN~OF~TABLE ### .. ###### END~OF~TABLE ###### If your phpMyAdmin directory is not in /var/www/html/ move it with: .. ### BEGIN~OF~TABLE ### .. ###### END~OF~TABLE ###### - Open your browser (e.g. Conquerer for Linux) and type in the following URL:http://{your hostname}/phpMyAdmin/index.php - Create a new database (e.g. “typo3”) - Delete standard users except the root - Create user (e.g. Typo3) and give him local rights to your new typo3 database (NO global rights needed!) - Set a password for user “root” and close the browser (you need to tell phpMyAdmin by now, what root password you have created) - Open the file config.inc.php: .. ### BEGIN~OF~TABLE ### .. _cd-var-www-html-phpMyAdmin: \# cd /var/www/html/phpMyAdmin/ """"""""""""""""""""""""""""""" .. container:: table-row a \# cd /var/www/html/phpMyAdmin/ \# vi config.inc.php .. ###### END~OF~TABLE ###### Please include the root password .. ### BEGIN~OF~TABLE ### .. _i: $i++; """"" .. container:: table-row a $i++; $cfg['Servers'][$i]['host'] = 'localhost'; // MySQL hostname or IP address $cfg['Servers'][$i]['port'] = ''; // MySQL port - leave blank for default port $cfg['Servers'][$i]['socket'] = ''; // Path to the socket - leave blank for default socket $cfg['Servers'][$i]['connect\_type'] = 'tcp'; // How to connect to MySQL server ('tcp' or 'socket') $cfg['Servers'][$i]['compress'] = FALSE; // Use compressed protocol for the MySQL connection // (requires PHP >= 4.3.0) $cfg['Servers'][$i]['controluser'] = ''; // MySQL control user settings $cfg['Servers'][$i]['controlpass'] = ''; // access to the "mysql/user" // and "mysql/db" tables) $cfg['Servers'][$i]['auth\_type'] = 'config'; // Authentication method (config, http or cookie based)? $cfg['Servers'][$i]['user'] = 'root'; // MySQL user $cfg['Servers'][$i]['password'] = '{replace with your password}'; // MySQL password (only needed // with 'config' auth\_type) $cfg['Servers'][$i]['only\_db'] = '' .. ###### END~OF~TABLE ###### - Save the file with “ESC” then “:wq”. - Now you should be able to enter the GUI phpMyAdmin without problems. - Make sure you secure the directory phpMyAdmin with a password, otherwise everybody can edit your databases... .. _Typo3-verbose-installation: Typo3 verbose installation -------------------------- .. _Comment: Comment ^^^^^^^ - The verbose installation of Typo3 has been described by the document “Administrator Guide”. - You can download the file from the development website `http://www.typo3.org `_ .. _TODO: TODO ^^^^ - I did not include my screenshots for the Mandrake 9.1 Setup because I was just allowed to upload an extension with a maximum of 100Kb. I will speak to Kasper about that and evaluate the document later. - Adding the verbose installation of Typo3, described by “Administrator Guide”, just to make things easier (you do not need to download two files...). - Spelling/Grammar check of the document - Translation to other languages - ...do you have anything else in mind? Write me an email! |img-2| Installing Typo3 on Mandrake Linux - 8 .. ######CUTTER_MARK_IMAGES###### .. |img-1| image:: img-1.png .. :align: left .. :border: 0 .. :height: 87 .. :id: Grafik8 .. :name: Grafik8 .. :width: 217 .. |img-2| image:: img-2.png .. :align: left .. :border: 0 .. :height: 32 .. :id: Graphic1 .. :name: Graphic1 .. :width: 102