Login / Status
developer.Resource
Home . Documentation . Document Library . Extension Manuals
Sponsors
hosted by punkt.deTYPO3 and Open Source MagazineAOE Media

1.4. Step by Step Instructions

Download all required ebuilds

At this time you can download the latest ebuilds for Typo3 and ImageMagick-4.2.9 from the http://bugs.gentoo.org/show_bug.cgi?id=37465 page. I hope later we will find them in the official portage tree.

Edit your make.conf

Picture 1 /etc/make.conf

It is recommended that you use a portage overlay your /etc/make.conf file. If you have no portage overlay defined yet add“PORTDIR_OVERLAY=/usr/local/portage” to your make.conf and create the directory

After this, create the directory by “mkdir -p /usr/local/portage”.The overlay dir will not be touched by a “emerge sync” therefore it is a good place for ebuilds that are not in the official portage.

Download the latest Typo3_ebuild.tar.gz file

First check http://bugs.gentoo.org/show_bug.cgi?id=37465 for the latest ebuilds.Download the latest typo3_ebuild.tar.gz file, extract it to your portage overlay.“cd /usr/local/”“tar xzfv /path/to/latest/typo3_ebuild.tar.gz”

Picture 1 download and untar the ebuild

Install libgd

Typo3 will be happy with a libgd that has gif support. Also edit the /etc/make.conf file and search in the file for USE=”...”. Here you only need to add ”gif“ in this line.After this install libgd with gif support with the command.

emerge ligbd

Install ImageMagick-4.2.9

Now you can start the installation of ImageMagick-4.2.9 with:

emerge =imagemagick-4.2.9

Picture 2 The installation of ImageMagick-4.2.9

Install mod_php with gd support

Since version 4.1.0 and higher PHP comes with a gd version. If you want to use an external gd version (and we will) you must add “gd-external” to your USE flags in make.conf. Also go ahead and add this to your make.conf.Build mod_php with external gd support with the following command.

emerge mod_php  

Installing the TYPO3_src package

First of all you need to install the typo3_src package!If you have “~x86” in your make.conf you can use one of the following commands.

“emerge typo3_src” or you can use “emerge =typo3_src-3.6.1”

If not there a two other commands. First you can emerge with the full path to the ebuild, or you set ACCEPT_KEYWORDS to ~x86

“emerge path/to/your/typo3_src-3.6.1.ebuild” or

“ACCEPT_KEYWORDS=”~x86” emerge typo3_src” or

“ACCEPT_KEYWORDS=”~x86” emerge =typo3_src-3.6.1”

If everything is ok you see something like this

Picture 3 Install of the typo3_src

Now you also need to install the typo3_src to your vhost e.g. Localhost

Typo3 need write permissions to some dirs. So we need to edit “/etc/vhost/webapp-config”

Change VHOST_CONFIG_UID="apache" and VHOST_CONFIG_GID="apache".

Picture 4 /etc/vhost/webapp-config

Now you can go on with the Install of the typo3_src for your vhost with webapp-config

e.g. “webapp-config -I --dir /temp --host localhost --virtual-dirs server-owned --virtual-files server-owned typo3_src 3.6.1”

This will install the typo3_src for /var/www/localhost/.

Picture 5 typo3_src install with webapp-config

Now you can go on and install one of typo3_dummy, typo3_testsite or typo3_quickstart. Emerge the package you need and install it with webapp-config to the directory you like.

e.g. “emerge typo3_quickstart”

e.g. “webapp-config -I --dir / --host localhost --virtual-dirs server-owned --virtual-files server-owned typo3_quickstart 3.6.1”

Picture 6 typo3_quickstart install with webapp-config

Enable the TYPO3 Install Tool

This will be done by the ebuild.

Start apache and mysql

If your apache and mysql not started you need to do this

/etc/init.d/apache start/etc/init.d/mysql start

Picture 7 start mysql and apache

Using the 1-2-3 Install Tool

Open a web-browser and go to http://www.yourserver.com/installed_dir/. The TYPO3 site should open with the 1-2-3 Install Tool.

In the first step, you have to enter your MySQL user name, the password and the host name of the database server. Because it's all on the same machine, you should enter localhost as the host name.

Step 2 you need to create a database. Enter a new name and click “Update localconf.php”

Step 3 is for importing the data into the database. After doing that (select database.sql from the pull down and click on »Import database«) you should click on »Continue to configure TYPO3 (Recommended)« and proceed with this tutorial.

You're done!!!

The last thing you have to do is to click on “1: Basic Configuration”, scroll down and check if everything is successfully installed. In the middle of this page you will find one option “Search for ImageMagick:” with a field: “Check this path for ImageMagick installation:” here try the path for ImageMagick-4.2.9(e.g. /usr/local/ImageMagick-4.2.9) and click send. After this update your locallang.conf and take a look at “4: All Configuration”

That's it. You should now have a working TYPO3 installation! You can start by logging in to the TYPO3-Back end of your installation with a web browser http://www.yourserver.com/typo3/htdocs/typo3/ with user:admin and password:password.Change this as soon as possible.