History: InstallTikiOSX

Installing a TikiWiki is surprisingly simple, admininstering and setting it up is more of a challenge.

Other install Docs:

• InstallTiki (general install docs)
• InstallTikiDoc (install under Linux/Apache - use as a cross reference to this document)

Download TikiWiki
http://sourceforge.net/projects/tikiwiki

• Get the most current non Beta release package (oddly sourceforge highlights the package you want with a dark background which often makes me skip right by the one I really want)

Move Source package to Web server (do this before expanding it since the one file
archive will move much faster than the unpacked files)

I moved it to:

• Webserver/Library/WebServer/hosts/tikiwiki_1.7.1.1.tar.gz
  • (5 MB 5,301,850 Bytes 349 items)

Unpack the files:

• the docs suggest the tar xvjf tikiwiki_1.7.tar.bz2 command
  • OSX doesn't seem to support the j flag so I couldn't do that. After playing with the man pages for a while and not figuring it out I gave up and TibukTu'd to the server and use Expander and the GUI to unpack
• I renamed the unpacked directory (from tikiwiki_1.7.1.1):
  • Webserver/Library/WebServer/hosts/tiki.hostname.ca
    • (25.5MB 17,565,522 Bytes)

Apache on OS X runs as user:group www:www

Set permissions on the setup script:

• Use ssh to connect to the server and go to the directory where you installed
• Command:
• chmod 755 setup.sh
  • Will change the setup script so it is executable.

Run the setup script:

The setup script will set up a few directories for your site. It must be run as root,
it's first two arguments are the user and group you want the directories it sets
up to belong to (the ones Apache can write to/belongs to)

sudo ./setup.sh www www

For advanced use you can use the setup script to set up multiple tiki sites using
the same code - this is good since you would only have to upgrade one install
on the serve to upgrade multiple sites, and it will save 25MB of duplicated files
for multiple sites. It doesn't look terrifyingly difficult.

• InstallMultipleTikis Purports to have more info on this, but:
• You actually want to go to this page: InstallVirtualHosting

Change the ownership of tiki-install.php so it can automatically be renamed
after it has been used (so it can't be re-run accidentally)
sudo chown www:www tiki-install.php

Set up DNS
Use webmin to make new A-records for the domain you want to be
your new tiki site.

Set up Apache Virtual Hosts
I added this to the proper http.conf file:
<VirtualHost 207.179.130.65:80>
ServerName tiki.hostname.ca
ServerAlias blog.hostname.ca
DirectoryIndex index.php
CustomLog '|"/usr/sbin/rotatelogs"
"/Library/WebServer/logs/tiki.hostname.ca/access_log" 604800'
"%h %l %u %t \"%r\" %s %b \"%{Referer}i\" \"%{User-agent}i\""
ErrorLog "/dev/null"
DocumentRoot "/Library/WebServer/hosts/tiki.hostname.ca"
</VirtualHost>

To be Investigated for the Virtual host setup:

Is there any protection I should put on the file with the database information on it (security) if there is any php optimization i should put in, and what the error page setup should be. I also may be able to bail on the Apache log if Tiki keeps its own log.

Create MySQL Database

i used phpMySQL to set up a database tiki and a user tiki I set up the user tiki to have every priveledge on the tiki database, only allow localhost connections, and no priveledges on other databases. Given my basic understanding of MySQL security this should be pretty secure.

Restart Apache

sudo /usr/sbin/apachectl graceful

• (you will need an admin password)

Log in and Confugure your Tiki

In my case: http://tiki.hostname.ca/tiki-install.php

You will need your database information:

• host: localhost
• user: tiki
• pass: whatever you chose
• database: tiki

Submit and you move to:

Same page, but this time it will offer to create or update your database - choose create.

Moves to same page - gives result of database creation (if you check in phpmyadmin you will see it created 161 tables)

There will be links to try to remove the install script (tiki-install.php), or just enter the tiki - try to remove. (sadly the remove didn't work for me - probalby I needed to change the permissions on the enclosing directory not the file. I'm still at Unix baby steps) if yours doesn't remove either Manually change the install script the same way tikiwiki just tried to:
mv tiki-install.php tiki-install.done

Move onto the main tiki page:
http://blog.bales.ca/tiki-index.php

your defailt login is user: admin pass: admin - it will ask you to change it.

Congratulations - you have installed TikiWiki under Mac OS X

Page Style choices:

• ThemesDoc as of 1.7.1.1 I've found that only moreneat, neat, olive, and Subsilver ( StylesMoreneat , StylesNeat , StylesOlive , StylesSubsilver ) don't have obvious display problems on IE 5.2 and Safari. I haven't tested other browsers....