[Typo3-install] Installation Problems
Sam
samv at netspace.net.au
Sat Oct 22 11:45:28 CEST 2005
I've successfully installed Typo3 on Mac OS 10.4. Here are some tips
for installing Typo3 on Mac OS 10.4.
Installing Typo3 itself is fairly easy. Installing the dependent
libraries I found to be quite tricky. But once you know what to do it
takes no time at all. Caveat: I should note that I'm only just
starting to explore Typo3. I'm no expert on Typo3. Please use my
notes as a guide only. I take no responsibility for errors that might
cause damage to your system. If you spot any errors or important
omissions in these notes please post them to this list so that we can
all benefit.
My notes cover installing and/or configuring: Apache, MySQL, PHP
(with GDlib), phpMyAdmin and Typo3 version 3.8.
Apache
Apache 1.3.33 comes as a standard part of Mac OS 10.4 (server and
client versions of Mac OS). Use your favourite text editor to edit
the httpd.conf file and enable PHP. On Mac OS 10.4 Server Apache's
httpd.conf file is modified by Apple's 'Server Admin' Graphical User
Interface (GUI). The Apple GUI isn't available on Mac OS 10.4 Client
so you'll have to edit Apache's config file in a text editor.
I like to edit the httpd.conf file in my favourite unix text editor
'pico'. Of course, take care with when using 'sudo' command.
sudo pico /etc/httpd/httpd.conf
You need to remove the comment character (#) on lines referring to
PHP4 (the lines are in different parts of the file):
#LoadModule php4_module libexec/httpd/libphp4.so
#AddModule mod_php4.c
Start Apache on Mac OS 10.4 (client) by ticking the 'Personal Web
Sharing' check box in the Sharing system preference. On Mac OS 10.4
Server you will use 'Server Admin' to start Apache.
MySQL
If you wish to use MySQL on Mac OS 10.4 Server be aware that there is
a version of MySQL that comes installed with the operating system
(MySQL 4.1.10a). It isn't installed in the normal location (neither
is the mysql.sock file). This is a good thing if you want to keep the
Apple supplied version of MySQL and install a newer version of MySQL
in the standard location (/usr/local/bin). Don't try to run both
versions on your system at the same time - decide to run one or the
other. I recommend installing MySQL 4.1.x from http://dev.mysql.com
(at the time of writing MySQL 4.1.14). You'll then have the comfort
knowing you have the latest and greatest version of MySQL and it is
installed where most people expect it to be (/usr/local/bin/mysql
and /tmp/mysql.sock). The default installation of phpMyAdmin expects
the mysql.sock file to be in the /tmp directory.
Download MySQL 4.1.14 for Mac OS 10.4. Run the MySQL installer.
Install the GUI preference pane by double-clicking MySQL.prefPane.
Click 'Start' to start MySQL. Install the MySQLStartupItem.pkg
To make life easier when working with MySQL at the command line you
should edit your bash shell profile.
cd ~
pico .bash_profile
If you are installing MySQL on Mac OS 10.4 Server the Apple supplied
MySQL appears early in the shell path. I therefore recommend adding
an alias to your shell profile:
alias mysql="/usr/local/mysql/bin/mysql"
If however you are running MySQL on Mac OS 10.4 (client) you can
simply add the MySQL directory to your shell path:
PATH="$PATH:/usr/local/mysql/bin"
Once you get MySQL, PHP, Apache and Typo3 running nicely I suggest
you return to MySQL and tighten access privileges. This is strongly
recommended in MySQL documentation and is mentioned in every MySQL
installation tutorial I've come across.
PHP (with GDlib)
Mac OS 10.4 ships with PHP 4.3.11 installed. The version of PHP
installed hasn't been complied with the GDLib. Typo3 will make use of
PHP compiled with the GDLib. Installing a version of PHP with the
GDLib was a breeze with the package provided by Marc Liyanage (http://
www.entropy.ch/home/). I recommend Marc's PHP package for Apache
1.3.33 (I haven't tried Typo3 running on Apache 2).
You might want edit the memory_limit and upload_max_filesize in the /
etc/php.ini file.
phpMyAdmin
If you are using MySQL and have PHP installed you will definately
want to install phpMyAdmin. phpMyAdmin provides web browser access to
MySQL. phpMyAdmin is great for quick database searches and updates.
An experience database user will want to use the command line to
execute sophisticated queries with table joins. As I write the latest
version of phpMyAdmin is 2.6.4-pl2. Download it from http://
www.phpmyadmin.net. Put it in your web root directory. Unarchive it.
Check/correct permissions:
sudo chown -R www phpMyAdmin
sudo chgrp -R www phpMyAdmin
For enhanced phpMyAdmin it is worthwhile installing the phpMyAdmin
tables into MySQL. There is a script in the /phpMyAdmin/scripts
directory that will do this for you:
mysql -uroot < create_tables_mysql_4_1_2+.sql
And you will need to modify the config.inc.php file to make use of
the phpmyadmin table:
$cfg['Servers'][$i]['pmadb'] = 'phpmyadmin';
Check that phpMyAdmin is working:
http://localhost/phpmyadmin/
ImageMagick/GraphicsMagick
It initially took me several hours to get Typo3 working with the
ImageMagick library. Typo3 installation documentation suggests the
most common install problems are to do with installing the the GDLib
and/or ImageMagick - indeed this was the case for me. My Typo3
installation refused to recognise the ImageMagick package from the
ImageMagick.org web site (Mac OS 10 compiled version). I could get
ImageMagick working in a Bash shell but I just couldn't get Typo3 to
recognise it. I added ImageMagick to the Bash $PATH and added
required Bash environmental variables for ImageMagick. After several
wasted hour ditched this version of ImageMagick in favour of the
ImageMagick package on Marc Liynage's web site - success. Typo3 at
least now recognised the existence of the ImageMagick library. But it
still wasn't working properly. Changing the settings for the
ImageMagick library in Typo3 didn't seem to solve the problem. Here
is where I wasted the most time. The Typo3 installation documentation
could emphasise most strongly one important instruction: "After
changing ImageMagick settings in Typo3 empty temporary files. Run the
'Clean Up Database: Clean up everything' function." As soon as I
'cleaned up' the Typo3 database it all worked beautifully.
Typo3 version 3.8 has come out and now recommends GraphicsMagick over
ImageMagic. This appeals to me as I don't like the way Marc Liynage's
ImageMagick package littered files loose in the /usr/local directory.
A binary installer of GraphicsMagick isn't available for Mac OS 10 so
you have to compile your own. This isn't difficult. Firstly, install
Xcode 2.1 (This can be downloaded from Apple's developer web site.
Registration is required but this is free. I was fortunately enough
to get Xcode 2.1 at the Worldwide Developers Conference 2005).
Download the GraphicsMagick source code.
Create a directory for your source code.
mkdir /src
cd /src
Move the downloaded package into this source directory and untar the
archive:
sudo tar xvfp GraphicsMagick-1.1.7
Create a build directory:
mkdir /src/build
Move to the build directory:
cd /src/build
Here I configure the build, build it and install it. I could only get
GraphicsMagick to compile on Mac OS 10.4 without perl support. I
suspect the compiler can't access a perl library burried away
somewhere in Mac OS (folder permissions restriction). I don't want to
mess with core operating system folder permissions so I compiled
GraphicsMagick without perl support - fine for Typo3. It is worth
reading the INSTALL-unix.txt and README.txt files.
../GraphicsMagick-1.1.7/configure --without-perl
Wait approximately 10 minutes...
make
Wait a few minutes more...
sudo make install
Wait approximately 2 minutes. By default, 'make install' will install
the package's files in '/usr/local/bin', '/usr/local/man', etc.
Your GraphicsMagick installation is complete!
Typo3
You could download Typo3 *ZIP* file, plonk it in your web root
directory, unzip it, install/configure it and away you go. The Typo3
ZIP files include a copy of the source code (the Typo3 'engine'). If
however you expect to use Typo3 for a lengthy period of time and
occasionally upgrade it then it pays to install it from the *TAR*
files and correctly set up symbolic links.
Let me explain the reasons behind this approach. You download the
"Typo3 source" tar package and the "Typo3 dummy" tar package
separately. Think of the Typo3 source as the Typo3 *engine* and the
dummy package your particular application of Typo3 (your web site).
By keeping the Typo3 source (engine) separate it makes it much easier
to upgrade when a new version comes out. You can have several Typo3
based web sites all pointing to one copy of the source code (the
'engine')
Move typo3_src-3.8.0 to /Library/WebServer directory.
De-archive it with the following command:
sudo tar xvfp typo3_src-3.8.0.tar
Now we will create a generic Typo3 symbolic link (typo3_src) to this
particular version/package:
sudo ln -s typo3_src-3.8.0 typo3_src
The Typo3 3.8 source (engine) is now installed.
Next we need to install your particular application of the Typo3 web
site. If we were creating a new Typo3 web site we would use the Typo3
dummy package. Or you might like to start with the 'quickstart'
version to experiment and learn.
In your web root directory de-archive the quickstart package:
sudo tar xvfp quickstart-3.8.0.tar
cd quickstart-3.8.0.tar
If you moved the contents of the 'quickstart' directory to your web
root directory you don't need to modify the symbolic links.
If the 'quickstart' directory is located *inside* your web root
directory need to modify a symbolic link in this folder to point to
the Typo3 source code (the Typo3 engine):
cd /Library/WebServer/Docuents/quickstart
sudo ln -sfh ../../typo3_src typo3_src
[s] to create a symbolic link, [f] if the target file already exists
(which it does) then unlink it so that the link may occur, [h] and if
the target_file or target_dir is a symbolic link, do not follow it
(This is most useful with the -f option, to replace a symlink which
may point to a directory).
Change permissions on your Typo3 directory/files:
sudo chown -R www quickstart-3.8.0
sudo chgrp -R www quickstart-3.8.0
Complete your Typo3 web site installation by configuring it in a web
browser:
http://localhost/quickstart-3.8.0/
Default Install password: joh316
Default Backend username: admin
Default Backend password: password
Interestingly, Typo3 Config: Image Processing says ImageMagick is
installed. I guess it is actually looking at GraphicsMagick.
Set [TTFdpi] = 96 (default 72)
You will probably want to adjust [maxFileSize].
In a production environment you will want to change the backend
password and disable the install tool.
Sam
On 22/10/2005, at 2:02 AM, Jeff Houston wrote:
> I uploaded the Typo3 version 3.8 but I cannot get it to install.
> All I get is a blank screen that at first blinks a image up that
> seems to say something about a database error but it blinks so fast
> I don't have time to read it then the page just goes completely
> blank. I have poured over all the documents I can find on
> installing and I have tried everything I could find but I am
> getting nowhere with installing Typo3. I am almost ready to give up
> on this thing! I am not exactly a newbie I have installed and run
> several other CMS's including Mambo and others. I have always been
> able to figure out how to install the others but not this one. Can
> anyone help me?
> _______________________________________________
> Typo3-install mailing list
> Typo3-install at lists.netfielders.de
> http://lists.netfielders.de/cgi-bin/mailman/listinfo/typo3-install
-------------- next part --------------
An HTML attachment was scrubbed...
URL: http://lists.netfielders.de/pipermail/typo3-install/attachments/20051022/69c98016/attachment.htm
More information about the TYPO3-install
mailing list