Tiki software Installation Guide

•

•

•

•

•

•

•

•

•

•

•

•

Tiki Wiki CMS Groupware ( http://tiki.org

) Page 7

Tiki Installation Guide – print date: Jun 20, 2011

Shared Host

Tiki will run in most shared webhost environments. Many hosts offer Tiki installation via a control panel application (such as Fantastico).

You should verify that your webhost meets the minimum requirements:

•

Webserver

•

MySQL

•

PHP

See Tiki Friendly Hosts for a list of working shared host environments.

Tiki Wiki CMS Groupware ( http://tiki.org

) Page 8

Tiki Installation Guide – print date: Jun 20, 2011

Requirements

Webserver

You must have a fully operational webserver in order to install and use Tiki. Tiki should run on any webserver that supports PHP (such as Windows IIS or lighttpd ), but is most widely tested and used with Apache . You may need to make minor modifications for non-Apache webservers.

To simply installation on Windows IIs, Tiki is included in the Windows Web App Gallery and can be installed with the Microsoft Web Platform Installer. See Microsoft Web Platform installer for details.

Your webserver should be configured with the following minimum requirements:

•

512 MB RAM

•

100 MB free storage

MySQL

Tiki requires a MySQL 5 database.

The database can be installed in the same physical location of the webserver (that is, as localhost) or Tiki can access a remote database.

PHP

Tiki

Version

Tiki7

Tiki4

Tiki5 or

Tiki6 LTS

PHP Version Notes

If PDO is not available, you can revert to ADOdb. See

ReleaseNotes40 for details.

PHP 5.2 with the

PDO extension

If you can't get PHP 5.2, you can keep on using Tiki6 LTS (end of support for Tiki6 LTS is when Tiki10 is released)

PHP 5.1 with the

PDO extension

If PDO is not available, you can revert to ADOdb. See

ReleaseNotes40 for details.

PHP 5.2 is preferred primarily to access features in Zend libraries and can be necessary for some of the newer features like WebDAV , however, globally, Tiki works with PHP 5.1

PHP5 with the If PDO is not available, you can revert to ADOdb. See

Tiki Wiki CMS Groupware ( http://tiki.org

) Page 9

Tiki Version PHP Version

PDO extension

Tiki3 LTS PHP5

Tiki Installation Guide – print date: Jun 20, 2011

Notes

ReleaseNotes40 for details.

This is a Long Term Support (LTS). End of life is May 2011, where you should upgrade to Tiki6 LTS

For all versions, MySQLi extension is recommended but the Tiki installer will fall back to the older

MySQL driver if MySQLi is unavailable.

Note on PHP Memory Limits: Some web hosts install PHP with a default memory_limit = 8m.

Although Tiki may appear to install successfully, you will continually face issues with pages failing to load and system errors. Tiki requires a minimum of 32M.

To review your PHP Memory Limits, access http://www.yourdomain.com/tiki-phpinfo.php and review the following values:

• max_execution_time = 60 ; Maximum execution time of each script, in seconds

• max_input_time = 60 ; Maximum amount of time each script may spend parsing request data

• memory_limit = 32M ; Maximum amount of memory a script may consume

For some shared webhosts, these values may not be user-configurable and you may need to request changes from your webhost.

More information

Required PHP Functions

Some webhosts tend to disable some functions which are required for Tiki to run flawlessly.

Function Notes

eval()

Required by Smarty templating engine.

Causes "Please contact support about" messages appearing instead of Modules when eval() is disabled in php.ini.

Additional Libraries

Library Notes

libxml Required

Tiki Wiki CMS Groupware ( http://tiki.org

) Page 10

Tiki Installation Guide – print date: Jun 20, 2011

Library Notes

http://us2.php.net/manual/en/ref.xml.php

mbstring

Useful when working with languages that require it http://us2.php.net/manual/en/ref.mbstring.php

mbstring Required by zend_search_lucene for Admin panel seraching and managing preferences in perspectives

ctype Required for Tiki 1.10 (and higher)

calendar Required TIki6

php.ini Configuration

We recommend using the following configuration in your php.ini file:

PHP.INI Setting Description

memory_limit = 32M Specify the maximum memory for PHP scripts.

_file_uploads = On

Required to allow uploads (files, images, etc.) to your Tiki

upload_max_filesize

= XXM

Specify the maxium upload filesize (in MB).

allow_url_fopen = On Allow trackback pings in your Tiki blogs.

session.save_handler

= files session.save_path =

/tmp max_execution_time

= 60 max_input_time = 60

The path that PHP stores session information. Ensure that the location exists and is writable. In

Shared Hosting ?

environments, if you do not have access to /tmp, use temp (no slash) instead.

Specify the idle timeout (in seconds). If you experience timeouts (such as when performing Admin functions) you may need to increase these settings.

magic_quotes_gpc =

Off default_charset =

"utf-8" mbstring.func_overlo

ad = 0

Turn off PHP's Magic Quotes function.

Specify the default character encoding.

Tiki will not work properly with mbstring.func_overload = 7.

The location of the php.ini file may vary, depending on your operating sytem. Some common locations include:

•

/etc/php.ini

•

/etc/php/php.ini

•

/etc/php4/php.ini

•

/etc/php/apache1-php4/php.ini (Gentoo)

•

/etc/php/cli-php4/php.ini (Gentoo)

•

/etc/php4/apache2 (Debian)

Tiki Wiki CMS Groupware ( http://tiki.org

) Page 11

Tiki Installation Guide – print date: Jun 20, 2011

•

\windows\system\php.ini (Windows)

Notes:

1. If safemode is on you may need safe_mode_allowed_env_vars = TZ in php.ini.

2. To run PHP5 on 1and1.com add the following lines to your _htaccess file (Tiki 3):

AddType x-mapp-php5 .php

AddHandler x-mapp-php5 .php uncomment line 29 and 30 then rename in .htaccess

Optional Software or Libraries

Some Tiki feautures require the following additional software or libraries:

Feature

Additional Requirements

Image processing, used for thumbnail generation, dynamic chart generation, and to prevent bot/automatic registration.

Manage and display maps as a GeoCMS (Geospatial Content

Management System).

Use either GD Library 1.5 (or higher) or ImageMagick.

ImageMagick is included, by default with PHP 4.3+

Mapserver 4.6+

Rewrite Tiki's default URLs

Use the Apache Clean URLs to create shorter, or custom,

URLs.

Tiki Wiki CMS Groupware ( http://tiki.org

) Page 12

Tiki Installation Guide – print date: Jun 20, 2011

Alias

•

Requirements and Setup

•

Requirement

Tiki Wiki CMS Groupware ( http://tiki.org

) Page 13

Tiki Installation Guide – print date: Jun 20, 2011

Installation

You don't have to be a web developer or programmer to install Tiki. Tiki has an easy-to-use, wizardbased installer which will do most of the work for you. The rest can be completed from your webhost's control panel.

If you are a complete novice (or are just not into DIY) consider using Tiki friendly hosts . Many will complete your Tiki setup you free of charge.

•

•

•

•

•

•

•

•

•

•

•

•

•

•

•

•

•

•

•

•

•

•

•

•

•

•

•

•

•

•

•

Tiki Wiki CMS Groupware ( http://tiki.org

) Page 14

Tiki Installation Guide – print date: Jun 20, 2011

•

For more information on the Tiki installation process...

•

Tiki Wiki CMS Groupware ( http://tiki.org

) Page 15

Tiki Installation Guide – print date: Jun 20, 2011

Overview

These videos offer an basic overview of Tiki installation. See Tiki TV and Tiki Movies for additional videos.

No Tabs

5.x

Watch how to complete the Tiki Installer screens, including how to configure your database connection. This movie also shows your initial

Administrator login and General Administration pages.

From Tiki for Dummies Smarties

Watch how to complete the Tiki Installer screens, including how to configure your database connection. This movie also shows your initial Administrator login and General

Administration pages.

From Tiki for Dummies Smarties

Basic overview in Tiki 3: Install and Profiles

This new installer and the application of the new set of Profiles is new in Tiki3 , and you can have a quick look at it in the following 12 min. screencast:

Flash player not available.

Tiki Wiki CMS Groupware ( http://tiki.org

) Page 16

Tiki Installation Guide – print date: Jun 20, 2011

Step by step installation

Before You Begin

Before installing Tiki, read the Requirements and Setup information . Proper planning can ensure a worry-free installation. If you need a webhost for your Tiki, refer to the list of Tiki Friendly Hosts .

These instructions are intentionally generic, and should apply to most shared host installations. See

Installation Guides for instructions for specific combination of operating system and web servers.

Pre-requisites

This guide assumes you have:

•

FTP or SSH (shell) access to a webserver (such as Apache) with PHP5

•

Typically, you upload the files via a FTP client such as WinSCP or FileZilla .

• access to a MySQL database (should be provided by your webhost)

1. Create the database

Tiki requires a MySQL databse.

Many hosts offer a point & click interface to create databases and database users. For example, if your web host has cPanel you probably can see phpMyAdmin in the main menu or a the section labeled

Databases.

The MySQL and phpMyAdmin applications in cPanel 11.

Creating a database (and a database user) is a very simple operation. Essentially you will create a blank

(empty) database that the Tiki installer will later populate with the correct tables and data.

Tiki Wiki CMS Groupware ( http://tiki.org

) Page 17

Tiki Installation Guide – print date: Jun 20, 2011

The Three steps of Database Setup.

1. Create a database.

•

You can name the database anything you want, but don't get fancy with the name — you can use tiki. Depending on your web host, your full database in phpMyAdmin may be listed as accountname_tiki.

Note: By default, Tiki uses UTF-8 for your database encoding. We strongly encourage you to select "utf8" in the "collation" drop-down box in phpmyadmin (or similar), in the field shown in the following image:

If you select a different encoding method, you may need to manually update your

../db/local.php file.

Tip: If you plan on having multiple Tiki installations, don't use tiki as the database name.

•

Be sure to record the database name, you will need it later.

2. Create a database user (with password).

•

Again, don't get fancy with the database username. In fact, you can use the same name that you selected for the database (in step 1).

•

Select a strong password. You can easily recover your database username and password if necessary (by reviewing the ../db/local.php file in your Tiki directory.

•

Be sure to record the username and password. You will need it later.

3. Assign all database permissions to the database user that you created (in step 2).

Congratulations. You now have a database that is ready to use, as well a a database user (and password) with the necessary permissions.

2. Download and unzip

Download the current version of Tiki to your local computer from http://tiki.org/download .

Tiki Wiki CMS Groupware ( http://tiki.org

) Page 18

Tiki Installation Guide – print date: Jun 20, 2011

Download button on tiki.org

From Tiki for Dummies Smarties

The full Tiki archive file download is +20MB and is available in a variety of formats.

After downloading the Tiki archive file, decompress (unzip) the file to your local PC.

3. Upload to your webhost

Use FTP (or SCP, SFTP, Rsync, SSH, etc) to connect to your webhost.

Once connected, find your web directory. It is often called www or public_html.

Note: This directory name may vary, depending on your webhost.

Upload all the Tiki files from your PC to you webhost.

•

If you upload the Tiki files to the root of your web directory, Tiki will be accessible directly from the URL: http://www.yourdomain.com

•

If you have installed (or plan to install) other applications on your webhost, you may consider putting Tiki in its own subdirectory (for example: http://www.yourdomain.com/tiki/).

Tiki Wiki CMS Groupware ( http://tiki.org

) Page 19

Tiki Installation Guide – print date: Jun 20, 2011

Time for more coffee?

4. Go to your website.

Open your web browser and access the web directory in which you copied the Tiki files (for example:

http://www.yourdomain.com/tiki/ or simply http://www.yourdomain.com if you copied Tiki to the root of your web directory.

No Tabs

7.x

5.x

2.x

The Tiki Installer Welcome screen appears.

From Tiki for Dummies Smarties

The Tiki Installer Welcome screen appears.

Tiki Wiki CMS Groupware ( http://tiki.org

) Page 20

Tiki Installation Guide – print date: Jun 20, 2011

From Tiki for Dummies Smarties

The Tiki Installer Welcome screen appears.

From Tiki for Dummies Smarties

The Tiki Installer Welcome screen appears.

Tiki Wiki CMS Groupware ( http://tiki.org

) Page 21

Tiki Installation Guide – print date: Jun 20, 2011

From Tiki for Dummies Smarties

The Tiki Installer Welcome screen appears.

From Tiki for Dummies Smarties

You should see a message indicating that Tiki could not connect to the database and prompting you to

Tiki Wiki CMS Groupware ( http://tiki.org

) Page 22

Tiki Installation Guide – print date: Jun 20, 2011

run the Tiki installer (tiki-install.php).

This message is normal and indicates that you are ready to install Tiki.

Troubleshooting

If your browser returns an error such as Parse error: syntax error, unexpected T_STRING, you may have the incorrect PHP version.

Starting with Tiki 3.0, Tiki requires PHP5. Review the _htaccess file included in the Tiki archive file for instructions on activating PHP5.

See the Installation FAQs for more help.

Tiki Wiki CMS Groupware ( http://tiki.org

) Page 23

Tiki Installation Guide – print date: Jun 20, 2011

File and Folder permissions

If your server is unhappy with Tiki file and folder permissions (this is dependent on server configuration), you may get an error message or blank pages. These failed attempts are typically in the error log (ask your web host to know where they are as it's different depending of your setup)

Too few permissions

If a message appears indicating that specific directories are not writable, you will need to change the permissions on the indicated directories. Tiki will attempt to verify that it can read (and write) to all necessary directories. This error message will include instructions about how to resolve the issue.

Too many permissions

If you are getting Internal Server Error 500, blank pages or similar, it could be that the permissions on the files are not appropriate for your webhost.

If your permissions are currently at "777", use your FTP client to change the files to "755". If Tiki is installed in a directory, make sure to also change the permission of the folder which contains the tiki files.

If you have shell access, you can run:

setup.sh

and answer any questions. If you don't know what to answer, just click "enter" to keep the defaults.

If "sh setup.sh" doesn't work for you, you may try, in your ./tiki/ directory

chmod

-R

777 .

/db .

/dump .

/img/wiki .

/img/wiki_up .

/img/trackers .

/modules/cache ./temp ./temp/cache ./templates_c ./templates ./styles ./whelp/

Another way is to set permissions for all directories and then set permissions for all files. For example, to set the permissions for all directories to 777 and the permissions for all files to 644, use the following separate commands through shell access:

find [

YOURDIR

]

-type d -exec

chmod

777

{}

Tiki Wiki CMS Groupware ( http://tiki.org

) Page 24

Tiki Installation Guide – print date: Jun 20, 2011 find [

YOURDIR

]

-type f -exec

chmod

644

{}

After correcting any directory or file permission problems, visit tiki-install.php to continue.

1. Run the Tiki installer (tiki-install.php)

Open a web browser to: http://www.yourdomain.com/tiki-install.php (or

http://www.yourdomain.com/tiki/tiki-install.php if you installed Tiki in a subdirectory).

The first page of the Tiki Installer appears. This installer will allow you to:

•

Pick a language

•

Test your server settings

•

If the installer detects that some of your server settings are inadequate, it will suggest changes to comply to the requirements .

•

Enter your database name, username, and password.

This is the information from the database that you created earlier. You did remember to write it down, right?

•

Create/update the database

•

Set some preferences, such as admin email

•

Disable the install script

• and more

Complete each page of the Tiki Installer.

Alternative "Step 5" without tiki-install.php

If you are unable to complete the Tiki Installer, continue with a Manual Installation .

2. Log in for the first time

1. Enter those informations :

1. user: Enter admin

2. pass: Enter admin

2. Click login.

Tiki Wiki CMS Groupware ( http://tiki.org

) Page 25

Tiki Installation Guide – print date: Jun 20, 2011

3. Change the default password.

Use a strong password. You may want to logout right away, and login again, letting your password manager record your password.

4. Congratulations !

It is recommended to create a new user and give him admin privileges instead of regularly using the admin account. You can now explore the interface but you should check the extra steps before to get you started.

5. Configure Your Tiki

Please visit Initial Configuration to explain the recommended next steps, or configuration for the table of contents related to configuring Tiki.

Add new features through post-install Profiles

Starting in Tiki3 , you can enable several settings/permissions/content in sets altogether in a single go, in order to provide a common feature to your tiki site (make it multilingual, add freetags, configure it as a Collaborative environment, ...). And all that with a just few clicks through the Profile Manager from

"Admin > Profiles".

For more information on the Tiki installation process...

Related pages:

Installation FAQ

Installation Guides - recipes, tips and detailed knowledge about specific hosting environments

Migrate to Tikiwiki

Move Tiki to a new server

Reinstall - to point tiki to a new Database or re-run an upgrade

Tiki in Ten minutes - a recipe for command line installations.

Fantastico Installation

Using SSH (for newbies)

Manual Installation

MultiTiki

Alias

•

Install

•

How to install

•

How to install Tiki

•

How to install TikiWiki

Tiki Wiki CMS Groupware ( http://tiki.org

) Page 27

Tiki Installation Guide – print date: Jun 20, 2011

1. Manual Installation

•

•

•

•

•

•

•

•

•

•

•

•

•

•

•

•

•

•

•

•

•

•

•

•

•

•

•

•

•

•

•

•

For more information on the Tiki installation process...

•

•

•

•

•

Tiki Wiki CMS Groupware ( http://tiki.org

) Page 28

Tiki Installation Guide – print date: Jun 20, 2011

•

•

To install Tiki, you basically point your browser to tiki-install.php and follow the instructions. For the vast majority of setups, this works nicely. But what if it doesn't work out for you? (special server setup, etc). Don't worry, there is an alternate way to install Tiki. This assumes you use mysql and have access to phpMyAdmin and know how to use it. Essentially, tiki-install.php does two essential things. It creates your database connection file (db/local.php) and populates the database with tables & data needed by Tiki.

1.1. Create your db/local.php file

5.x

4.x

3.x

db/local.php

<?php

$db_tiki = 'mysql' ;

$dbversion_tiki = '5.0' ;

$host_tiki = 'localhost' ;

$user_tiki = 'my_database_username' ;

$pass_tiki = 'my_database_secret_password' ;

$dbs_tiki = 'my_database_name' ;

Make sure there are no spaces or special characters before or after the code.

Of course, replace the values with your own.

1.2. Insert tiki.sql

5.x

4.x

3.x

Import the content of db/tiki.sql into your database use the encoding as described on Understanding encoding

Tiki Wiki CMS Groupware ( http://tiki.org

) Page 29

Tiki Installation Guide – print date: Jun 20, 2011

This will populate the database and give you the default profile .

1.3. Insert secdb (optional)

5.x

4.x

3.x

Import the content of db/tiki-secdb_5.0_mysql.sql into your database

For more information: Security Admin

1.4. Rename _htaccess for clean URLs (optional)

You can rename _htaccess to .htaccess

See Clean URLs

Tiki Wiki CMS Groupware ( http://tiki.org

) Page 30

Tiki Installation Guide – print date: Jun 20, 2011

MultiTiki

The instructions above assume you are installing one Tiki. If you are using MultiTiki , please see

MultiTiki Manual Installation alias

•

Manual Install

Tiki Wiki CMS Groupware ( http://tiki.org

) Page 31

Tiki Installation Guide – print date: Jun 20, 2011

Platform-specific Installation Information

This section contains additional installation information for specific platforms.

Table of contents:

•

Linux

•

Install on Debian

•

Install on Gentoo

•

Windows Desktop Install

•

Install Tiki on XAMPP

•

Windows Local Install EasyPhp

•

Windows Server Install

•

Windows Server

•

Windows IIS Install

Tiki Installation on Linux

Initial Steps: Download, Unpack, Create Directories

These initial steps presume you're installing Tiki on a Linux machine running the Apache Webserver.

Read this once top to bottom before getting started. If you're using a Windows box you can ignore the portion about setting permissions, but you'll have to set up some of Tiki's directories manually.

Before you get started it's a good idea to know

• your database user name and password

• your apache user and group ID

If you're using the rpm that is available you can skip down to browser based install.

These are notes on how to setup and configure Tiki.

Step one:

Unpack and set the necessary permissions unpack to the document root of where you want tiki installed, e.g. /var/www/tiki/ bz2 file Use

Tiki Wiki CMS Groupware ( http://tiki.org

) Page 32

tar

-xvjf tikiwikiv.xxx

Tiki Installation Guide – print date: Jun 20, 2011

(g)zip Dateibenutzung

tar

-xvzf tikiwikiv.xxx

Step two:

CHMOD the file setup.sh to 755.

chmod

755 setup.sh

The script setup.sh in this directory assigns necessary permissions for the directories that the webserver writes files to. It also creates the (initially empty) cache directories.

Usage: ./setup.sh user group rights list of virtual host domains

For example, if apache is running as user $AUSER and group $AGROUP, type:

You can find your group using the command 'id'.

-c './setup.sh $AUSER'

Alternatively, you may wish to set both the user and group:

If not root then

-c './setup.sh $USER $AGROUP'

This will allow you to delete certain files/directories without becoming root. Or, if you can't become root, but are a member of the group apache runs under (for example: $AGROUP), you can type:

./setup.sh $USER $AGROUP

If root then, and are not a member of the apache group, then type:

./setup.sh $USER yourgroup 02777

Replace yourgroup with your default group.

Tiki Wiki CMS Groupware ( http://tiki.org

) Page 33

Tiki Installation Guide – print date: Jun 20, 2011

NOTE: If you do execute this last command, you will not be able to delete certain files created by apache, and will need to ask your system administrator to delete them for you if needed.

To use Tiki's multi-site capability (virtual hosts from a single DocumentRoot) add a list of domains to the command to create all the needed directories. For example

If Root then root@localhost tiki

]

# sh ./setup.sh youruser nobody 02775 test1 test2 test3

If not Root then

./setup.sh $USER $AGROUP 02777 domain1 domain2 domain3

This will get you to the next screen go to step three below.

Step three: browser based setup

• create a tiki database

• using PhpMyAdmin (cache) and MySQL

• or on the command line mysqladmin create dbname the database name is usually called

"tiki"

•

Point your browser to the web address that corresponds to the file tiki-install.php?lang=

(http://your_host/tiki/tiki-install.php?lang= XX ); being XX the two letter language code of your choice (e.g. em for English, available from Tiki version 1.9.7).

•

Follow the instructions there: you will need the password and user name for your database

•

For the first time to log into Tiki is

• user: admin

• password: admin

Step four: Custom configuration

Next you can configure Tiki to your needs:

•

Choose which features you want switched on

• click on http://localhost/tiki/tiki-admin.php

on the left side of your screen

•

(Optionally) create groups of users that share permissions

•

Assign appropriate permissions

More information

Tiki Wiki CMS Groupware ( http://tiki.org

) Page 34

•

Install on Debian

•

Install on Gentoo

Tiki Installation Guide – print date: Jun 20, 2011

Debian 5, using PHP 5, MySQL 5

Using your favorite Debian package manager, verify that these packages (and their dependencies) are installed: mysql-server php5-mysql libapache2-mod-php5

Preparing supporting components for Install

There are three major components you need to configure before you actually install Tiki: PHP, MySQL, and Apache.

PHP Setup

There are several settings that need to be edited in the php.ini file. If you have installed the Debian PHP packages, you will find this file in /etc/php5/apache2/php.ini

1. Make a backup of the php.ini file.

cp php.ini php.ini.org

2. You must edit these configurations. Some need to be changed, others just need to be umcommented.

Set them to the values below: max_execution_time = 60 ; Maximum execution time of each script, in seconds session.save_path = /var/www/tmp log_errors = error_log error_log = syslog

The following should not be needed: extension=mysql.so

memory_limit = 32M ; Maximum amount of memory a script may consume (current default is already 128 MB)

Tiki Wiki CMS Groupware ( http://tiki.org

) Page 35

Tiki Installation Guide – print date: Jun 20, 2011

3. Save the file and restart apache.

pince:/etc/php5/apache2# invoke-rc.d apache2 restart

Forcing reload of web server: Apache2.

pince:/etc/php5/apache2#

MySQL Setup

If you have installed MySQL from Debian packages, it should already be set up, and the 'mysql' database should be created. You'll need to secure the database, create the tiki database, and grant rights to the tiki database user.

1. Verify that MySQL is running.

2. Secure the mysqladmin (root) user. Follow the instructions at www.mysql.com

. Do it now. Leaving this user without a password is insecure.

3. Follow the instructions in Requirements to create the tiki database. Use a secure name for the database user. Do not use "admin".

Apache setup

1. Make the appropriate modifications to the Apache configs to set up tikiwiki as a host or virtual host.

Put a simple file (index.html.en) in the DocumentRoot of your host or virtualhost. Test access from localhost and from external machines.

2. Find the name of the user that Apache runs as. Debian uses userid "www-data" by default.

Install Tiki

1. Download the latest release.

2. Move the tiki tarball to the appropriate directory. Debian places it's document root at /var/www/.

3. Untar the tiki release file. It should create a subdirectory with the release number. Here's what mine looked like: pince:/var/www# ls -l total 35236 lrwxrwxrwx 1 root root 24 2005-11-15 07:26 analog ->

/usr/share/analog/images drwxr-xr-x 3 root root 4096 2005-12-26 17:07 apache2-default drwxrwxr-x 20 www-data 1015 16384 2005-12-28 00:36 tikiwiki-1.9.2

-rw-r--r-- 1 root root 36014080 2005-12-26 19:38 tikiwiki-1.9.2.tar

Tiki Wiki CMS Groupware ( http://tiki.org

) Page 36

Tiki Installation Guide – print date: Jun 20, 2011

4. I like to create a symbolic link to my tiki directory: pince:/var/www# ln -s /var/www/tiki-1.9.2 tiki pince:/var/www# ls -l pince:/var/www# ls -l total 35236 lrwxrwxrwx 1 root root 24 2005-11-15 07:26 analog ->

/usr/share/analog/images drwxr-xr-x 3 root root 4096 2005-12-26 17:07 apache2-default lrwxrwxrwx 1 root root 23 2005-12-27 23:42 tiki -> /var/www/tikiwiki-

1.9.2

drwxrwxr-x 20 www-data 1015 16384 2005-12-28 00:36 tikiwiki-1.9.2

-rw-r--r-- 1 root root 36014080 2005-12-26 19:38 tikiwiki-1.9.2.tar

5. Run setup.sh to set permissions on the directories. The defaults should do.

/var/www/tiki# sh setup.sh

6. Go to tiki-install.php. You may enter open an URL similar to http://localhost/tiki/tiki-install.php

Normal installation

To install Tikiwiki on gentoo system simply type emerge tikiwiki

Installation of last package (but not CVS)

In /etc/portage/package.keywords add line www-apps/tikiwiki ~x86 and type emerge tikiwiki

Tiki Wiki CMS Groupware ( http://tiki.org

) Page 37

Tiki Installation Guide – print date: Jun 20, 2011

Windows Desktop Install

Table of contents

•

•

•

•

•

•

•

•

•

•

•

•

•

•

•

•

•

•

•

•

•

•

•

•

•

•

•

•

•

•

•

•

For more information on the Tiki installation process...

•

•

Tiki Wiki CMS Groupware ( http://tiki.org

) Page 38

Tiki Installation Guide – print date: Jun 20, 2011

•

•

•

•

•

•

•

Initial Steps: Download, Unpack, Create Directories

•

•

•

•

•

•

•

•

•

•

•

•

•

•

•

•

•

Why install Tiki on a Windows desktop ?

Tiki is typically used on a server. However, there are instances where installing on a server is not ideal or necessary.

•

Tiki can be used as a personal knowledge base

•

Testing out Tiki before getting a host

•

Easier to install & test locally

•

Using Tiki on a local Intranet

•

If you have a slow or unreliable Internet connection.

•

Laptop

•

..add your reason here!

Tiki uses a standard database so you will be able to transfer all your data to a another Tiki installation

Tiki Wiki CMS Groupware ( http://tiki.org

) Page 39

Tiki Installation Guide – print date: Jun 20, 2011

later on if you wish.

Is Tiki complicated to install ?

Tiki is fairly easy to install thanks to the install script. However, it is not yet a double click experience

Windows users are used to. It gets complicated because Tiki relies on three major external applications to run.

•

PHP (scripting language)

•

Web server (usually Apache)

•

Database (usually MySQL)

These three applications are needed to run Tiki. The nice folks at EasyPHP have bundled these three plus phpMyAdmin (to administer your database via a browser). Once these applications installed, a

Tiki database must be created and a Tiki MySQL user must be created with appropriate privileges.

For details please see:

•

Microsoft Web Platform Installer

•

Windows Local Install EasyPhp

•

Install Tiki on XAMPP

Optional extra steps

Activate some features

Click Admin (click!) and then the first icon, Choose what you want to use. As always you can click the help icon at the top of the page to get some information on what you can do.

Create a new user and a group

•

Click Users from the Admin menu to add users.

•

Click Groups from the Admin menu to add groups.

•

From Admin groups click assign perms to assign the right permissions to your groups.

You probably need to spend some time there so that everyone has access to and only to what it should access.

Raise PHP's memory limit

Although PHP should run Tiki with 8MB of memory only, it's likely that you will need to set it to 16

MB even if it seems to work at most places.

Tiki Wiki CMS Groupware ( http://tiki.org

) Page 40

Tiki Installation Guide – print date: Jun 20, 2011

Enable GD

GD is an graphic library used to perform manipulations on images. Image galleries need such a library.

Since GD is bundled with EasyPHP, all you need to do to get image galleries working is to uncomment the line in php.ini that includes GD's DLL and restart Apache.

Install GraphViz and/or Mapserver

If you want to use WIKIGRAPH plugin, you need to install GraphViz. Maps need Mapserver to work.

Install Tiki on XAMPP

This can apply to a windows install or other hence it is a section of Windows Desktop Install .

TikiWiki relies on three major external applications to run.

•

PHP (scripting language)

•

Web server (usually Apache)

•

Database (usually MySQL)

These three applications are needed to run Tiki. You can install Tiki on XAMPP which also provides phpMyAdmin this is the same idea as Windows Local Install EasyPhp

Once these applications installed, a Tiki database must be created and a Tiki mysql user must be created with appropriate privileges.

These instructions were tested on:

•

Windows XP SP3 + XAMPP Lite version 1.7.4 + TikiWiki 3.4 LTS

Table of contents

•

•

•

•

•

•

•

Tiki Wiki CMS Groupware ( http://tiki.org

) Page 41

Tiki Installation Guide – print date: Jun 20, 2011

•

More information

•

•

•

•

•

•

•

•

•

•

•

•

•

•

•

•

•

•

•

•

•

•

•

•

For more information on the Tiki installation process...

•

•

•

•

•

•

•

•

•

Initial Steps: Download, Unpack, Create Directories

•

•

•

•

•

•

Tiki Wiki CMS Groupware ( http://tiki.org

) Page 42

Tiki Installation Guide – print date: Jun 20, 2011

•

Normal installation

•

•

•

•

•

•

•

•

•

•

•

•

•

•

Step 3.1: Optional but recommended, change the MySQL root password

•

•

•

•

•

the database userid / password that you created in Step 4 .

Step 1: Download xampp and TikiWiki

For TikiWiki, you can choose between different compression formats, you most probably want the .zip, or the .7z if you have 7-Zip installed.

• http://info.tikiwiki.org/Download

•

Windows: http://www.apachefriends.org/en/xampp-windows.html

•

XAMPP is also available for Linux, Solaris Mac OS X: http://www.apachefriends.org/en/xampp.html

Step 2: Setup XAMPP

1. Run the exe you downloaded in step 1

2. Launch the XAMPP control panel from the start menu

3. Double click on the XAMPP

4. Ensure that Apache and MySQL are running

Click Start for both and they will show running.

icon in the lower right hand taskbar.

Tiki Wiki CMS Groupware ( http://tiki.org

) Page 43

Tiki Installation Guide – print date: Jun 20, 2011

For detailed instructions see http://www.apachefriends.org/en/xampp-windows.html

Step 3: Create a database for Tiki

1. Open a web browser to: http://localhost/phpmyadmin/ . The default phpMyAdmin page appears.

2. In the field Create new database type tiki (or some other name) select "MySQL connection collation": utf8_unicode_ci and click Create.

This is the name of your MySQL database that Tiki will use. Write down the name of this database — you will need it later.

3. Click Create. phpMyAdmin creates the database and displays the message: Database tiki has been created

Step 3.1: Optional but recommended, change the MySQL root password

1. Open a web browser to: http://localhost/security

2. read the directions & select the link that will allow you to "fix" security

3. change the MySQL root password

Step 4: Create a MySQL user

1. Point your browser to http://localhost/phpmyadmin/

2. Click Privileges.

3. Click Add a new User.

This will create a new database user — this is not a Tiki user.

4. On the Add a New User page, complete the Login information:

•

User name: Enter tikiadmin or another name if you wish.

•

Host: Leave this field as the default. If you encounter problems, try using localhost or

127.0.0.1 instead.

•

Password: Put a safe password here, you will need it later.

•

Re-type: Re-enter the password.

Write down the user name and password — you will need them later.

5. In the Global Privileges area, click Check All.

6. Click Go to create the database user.

MySQL creates the database user and displays the message:

Tiki Wiki CMS Groupware ( http://tiki.org

) Page 44

Tiki Installation Guide – print date: Jun 20, 2011

You have added a new user.

Step 6: Decompress Tiki files

1. Uncompress the Tiki file that you downloaded. Uncompress the files into:

<xampp install directory>\xampp\htdocs

Note: Be sure to uncompress the files into a tiki directory — not directly in the main directory unless you your tiki to be the only content served by the web server

2. Verify that the following file exists:

<xampp install directory>\xampp\htdocs\tikiwiki-<version>\tiki-index.php

Step 7: Run the install script

1. Point your browser to: http://localhost/tikiwiki-version/

You can then just follow the script's instructions or see Step 5: Run the Installer for details.

Note, you will need to use:

•

•

the database name you entered in Step 3 .

Step 8: Configure your tiki & GO!!

Follow Installation instructions, begin at login for the first time and subsequent steps.

Windows Local Install EasyPhp

This is a section of Windows Desktop Install .

TikiWiki relies on three major external applications to run.

•

PHP (scripting language)

•

Web server (usually Apache)

•

Database (usually MySQL)

These three applications are needed to run Tiki. The nice folks at EasyPHP have bundled these three

Tiki Wiki CMS Groupware ( http://tiki.org

) Page 45

Tiki Installation Guide – print date: Jun 20, 2011

plus phpMyAdmin (to administer your database via a browser)

Once these applications installed, a Tiki database must be created and a Tiki mysql user must be created with appropriate priviledges.

OK, I'm ready to go. What do I need?

These instructions are designed to be used as a step-by-step guide. You can print them out and/or just keep this browser window open.

They explain how to install EasyPHP (which provides in a quick way PHP, Apache, MySQL and more) and then setup Tiki. They were tested on:

•

Windows XP machine with EasyPHP 1.7 and TikiWiki 1.8

•

Windows 2000 machine with EasyPHP 1.6 and TikiWiki 1.7.1.1.

•

Windows XP SP3 with EasyPHP 5.3.0 & Tikiwiki 2.2

They should work with few differences on similar environments.

Requirements:

•

A Windows PC with a .zip decompression utility. Windows XP, Windows 2000, Windows ME,

Windows 98, Windows95?? (please confirm anyone?)

•

20 minutes (excluding download time for about 30 MB)

•

A decompression utility, as 7-Zip (see Useful Links section at bottom of this page).

•

Disk space: 60 Megs {Keep in mind you will have Tiki + EasyPHP (PHP + Apache + MySQL +

PhpMyAdmin)}

Table of contents

•

•

•

•

•

•

•

•

•

Tiki Wiki CMS Groupware ( http://tiki.org

) Page 46

Tiki Installation Guide – print date: Jun 20, 2011

•

•

•

•

•

•

•

•

•

•

•

•

•

•

•

•

•

•

•

•

•

•

•

For more information on the Tiki installation process...

•

•

•

•

•

•

•

•

•

Initial Steps: Download, Unpack, Create Directories

•

•

•

•

•

•

•

•

Tiki Wiki CMS Groupware ( http://tiki.org

) Page 47

Tiki Installation Guide – print date: Jun 20, 2011

•

•

•

•

•

•

•

•

•

•

•

•

•

Step 3.1: Optional but recommended, change the MySQL root password

•

•

•

•

•

•

•

•

•

•

•

•

•

•

If you get a Parse error: (...) templates_c\preferences.php on line 94

•

•

Possible bug if you install at C:\Program Files\EasyPHP\www\ instead of

•

•

•

•

3. User: Enter tikiadmin or whatever database username you entered in Step 4 .

Step 1: Download EasyPHP and TikiWiki

See the links at the bottom of this page. For TikiWiki, you can choose between different compression formats, you most probably want the .zip, or the .7z if you have 7-Zip.

Tiki Wiki CMS Groupware ( http://tiki.org

) Page 48

Tiki Installation Guide – print date: Jun 20, 2011

Step 2: Setup EasyPHP

1. After the file has downloaded, double-clicking the easyPHP file setup file.

2. Select your interface language.

Note: Be sure to specify your language. The default language is French.

3. The Welcome page appears. Click Next.

4. The License Agreement page appears. Select I accept and click Next.

5. Read the warnings on the Information page and click Next.

6. On the Setup page, select your installation directory and click Next.

The default installation directory is: C:\Program Files\EasyPHP 2.0b1

7. Select a Start Menu folder and click Next.

The default Start menu folder is: EasyPHP 2.0b1

8. On the Ready to Install page, verify your installation information and click Install.

Easy PHP will install all the necessary files to your PC.

9. After all files are installed, the Complete page appears. Click Finish.

You may be prompted to restart your PC (Win 98 and earlier, only).

10.To start EasyPHP, select Start > Program Files > EasyPHP > EasyPHP.

EasyPHP will start. The EasyPHP logo should appear in the notification area of your task bar.

The EasyPHP status window appears. Verify that both Apache and MySQL are running.

If the window does not appear, double-click the EasyPHP icon in the task bar.

To have EasyPHP start automatically when your PC boots, right-click the EasyPHP logo in the task bar and select Configuration > EasyPHP.

Note: For more information, http://www.canowhoopass.com/guides/easyphp/ is an excellent guide on installation of EasyPHP.

Step 3: Create a database for Tiki

1. Open a web browser to: http://127.0.0.1/home/mysql/ . The default phpMyAdmin page appears.

2. In the field Create new database type tiki (or some other name) and click Create.

Tiki Wiki CMS Groupware ( http://tiki.org

) Page 49

Tiki Installation Guide – print date: Jun 20, 2011

This is the name of your MySQL database that Tiki will use. Write down the name of this database — you will need it later.

3. Click Create. phpMyAdmin creates the database and displays the message: Database tiki has been created

Step 4: Create a MySQL user

1. Point your browser to http://127.0.0.1/home/mysql/

2. Click Privileges.

3. Click Add a new User.

This will create a new database user — this is not a Tiki user.

4. On the Add a New User page, complete the Login information:

•

User name: Enter tikiadmin or another name if you wish.

•

Host: Leave this field as the default. If you encounter problems, try using localhost or

127.0.0.1 instead.

•

Password: Put a safe password here, you will need it later.

•

Re-type: Re-enter the password.

Write down the user name and password — you will need them later.

5. In the Global Privileges area, click Check All.

6. Click Go to create the database user.

MySQL creates the database user and displays the message:

You have added a new user.

Step 5: Reload MySQL

•

Note: This step MIGHT be optional.

•

Always remember to do this step when you make changes to the database.

• point your browser to: http://127.0.0.1/mysql/ click Reload MySQL

Step 6: Decompress Tiki files

1. Uncompress the Tiki file that you downloaded. Uncompress the files into:

C:\Program Files\EasyPHP\www\tiki

Note: Be sure to uncompress the files into a tiki directory — not directly in the www directory.

Tiki Wiki CMS Groupware ( http://tiki.org

) Page 50

Tiki Installation Guide – print date: Jun 20, 2011

2. Verify that the following file exists:

C:\Program Files\EasyPHP\www\tiki\tiki-index.php

Step 7: Run the install script

1. Point your browser to: http://127.0.0.1/tiki/tiki-install.php

You can then just follow the script's instructions or follow the rest of this step.

2. Fill the informations :

1. Database type: MySQL 4.x (depends on your version of EasyPHP)

2. Host: localhost (leave as is)

4. Password: Enter the password you entered in Step 4 .

5. Database name: Enter tiki or whatever database name you entered in Step 3 .

3. Click Submit Query.

If your browser offers to "remember values" say no.

4. Choose the profile that will determine initial settings. BasicEnabled is recommended for quick testing but you may want Default instead. Detailed descriptions can be read using the link.

5. Click create.

You should see Your database has been configured and Tiki is ready to run, if this is your

first install your admin password is 'admin'.

6. Click Login as the administrator and lock installer (Recommended) (Note: in previous versions of Tiki, it said: Click here to remove the install script and proceed into tiki).

You should finally enter the Tiki interface and see Permission denied you cannot view this page.

If you get a timeout error, you need to change your php.ini to (: max_execution_time = 120) and restart

Apache. The first time a page is called, Tiki generates a template. The next time, the page is generated much faster.

If you get a timeout error,

[+]

You need to change your php.ini to max_execution_time= 120 and restart apache. While you are there, you can modify memory_limit = 16M

The first time a page is called, Tiki generates a template. The next time, the page is generated much faster.

Tiki Wiki CMS Groupware ( http://tiki.org

) Page 51

Tiki Installation Guide – print date: Jun 20, 2011

If you get a Parse error: (...) templates_c\preferences.php on line 94

[+]

If you get:

Parse error: parse error, unexpected T_STRING in c:\program files\easyphp1-7

\www\templates_c\preferences.php on line 94

You need to go to "temp directory" here: http://127.0.0.1/tiki/tiki-admin.php?page=general and clear of any content

Possible bug if you install at C:\Program Files\EasyPHP\www\ instead of C:\Program Files\EasyPHP\www\tiki

[+] http://tikiwiki.org/tiki-view_forum_thread.php?forumId=6&comments_parentId=4652

Step 8: Log in for the first time

You will get an permission error (you cannot view the request page, or something similar). Ignore this and log in using the login box in the right-hand column. Use the following information:

1. Enter those informations :

1. user: Enter admin.

2. pass: Enter admin.

2. Click login.

Step 9: Change default password

• new password: (use a secure password)

Step 10: Congrats!!!

It is recommended to create a new user and give him/her admin privileges instead of regularly using the

Tiki Wiki CMS Groupware ( http://tiki.org

) Page 52

Tiki Installation Guide – print date: Jun 20, 2011

admin account. You can now explore the interface but you should check the extra steps before to get you started.

Step 11: Initial setup/configuration

Please visit Initial Configuration

Useful Links

•

EasyPHP http://www.easyphp.org

•

Download EasyPHP (8-11 MB) http://easyphp.org/download.php

http://sourceforge.net/project/showfiles.php?group_id=14045

•

Download Tiki (6-10 MB) http://doc.tikiwiki.org/download

•

Decompression utilities

•

7-Zip (Open Source, 41 languages, recommended) http://www.7-zip.org

•

WinZip (Free evaluation version available) http://www.winzip.com

•

PowerArchiver http://www.powerarchiver.com

Windows Server Install

Please also see: Microsoft Web Platform Installer

Windows 2008R2 Server setup

[-]

This documentation provides detailed notes on a successful new installation of Tiki4 .0 on a Windows

2008R2 Server.

Hopefully this will allow more TikiWiki users to take advantage of a Windows/IIS environment without the need of a WAMP install.

Tiki Wiki CMS Groupware ( http://tiki.org

) Page 53

Tiki Installation Guide – print date: Jun 20, 2011

Software used:

•

Windows2008R2 Server Standard Edition (x64) - IIS 7

•

MySQL 5.1.41 (x64) Community Edition

•

MySQL GUI tools 5.0-r17-win32 (optional, but much easier)

•

PhP 5.3.1 nts-Win32-VC9 (x86)

Installed Windows:

•

Joined Domain, set static IP. (Running as Administrator)

•

Added IIS Role

•

Features for IIS:

Common HTTP Features

•

Static Content

•

Default Document

•

Directory Browsing

•

HTTP Errors

•

HTTP Redirection

Application Development

•

ASP.NET

•

.Net Extensibility

•

CGI

•

ISAPI Extensions

•

ISAPI Filters

Health and Diagnostics

•

HTTP Logging

•

Request Monitor

Security

•

Request Filtering

Performance

•

Static Content Compression

Management Tools

Tiki Wiki CMS Groupware ( http://tiki.org

) Page 54

Tiki Installation Guide – print date: Jun 20, 2011

•

IIS Management Console

Windows: Turned off IE Enhanced Security

Windows: Ran MS Update installed all important and all optional updates.

Windows: Reboot server

Installed other software

Installed MySQL (x64) all defaults.

Installed MySQL GUI Tools.

Installed PHP 5.3.1 (x86) default settings installed to C:\PHP

Windows: Created C:\Temp directory

Windows: Under Security Settings, added everyone with full permissions to the following direc__tories:

__*C:\inetpub\wwwroot\

•

C:\PHP\

•

C:\Program files\MySQL

•

C:\Temp

Edited PHP.INI

• include_path = ".;c:\php\includes" - uncommented (line 787)

• cgi.force_redirect = 1 - uncommented (line 822)

• fastcgi.impersonate = 1; - uncommented (line 850)

• upload_tmp_dir="C:\temp" - changed from c:\windows\temp (line 908)

• session.save_path="C:\temp" changed from c:\windows\temp (line 909)

• error_log="C:\temp\php-errors.log" changed from c:\windows\temp (line 910)

• date.timezone = America/New_York changed from blank (line 962)

• sendmail_from = my email address changed from blank (line 1056)

Windows: Opened port 3306 in windows firewall for remote MySQL client tools access.

Windows: Unzipped TikiWiki 4.0 to c:\inetpub\wwwroot\tw4

Windows: Created a phpinfo.php file in c:\inetpub\wwwroot to validate the php install.

From LAN workstation:

Verified MySQL remote connectivity and using MySQL Query Browser, created a new schema

(database) named Tiki4.

Opened IE8 and connected to the phpinfo.php page to verify PHP install and settings.

Tiki Wiki CMS Groupware ( http://tiki.org

) Page 55

Tiki Installation Guide – print date: Jun 20, 2011

Take dog for walk and hoping for success!

From LAN workstation, opened FireFox Browser and pointed to the tw4 path, and got the tikiinstall.php page.

TikiWiki 4.0 Install

[+]

This appears to be more or less by the book

Select your language: English

Click continue

read the license

click continue

Review the System Requirements

Memory: Tiki has detected your PHP memory_limit at: 128 MB.

mail: did not test (have not set mail server yet)

Image Processing: Tiki detected: GD bundled (2.0.34 compatible).

click continue

Set the Database Connection

Database Type: MySQL Improved (mysqli). Requires MySQL 4.1+

•

Host name: 192.168.0.40

•

Database name: tw4

•

Database User: root

•

Database Password: ********

click continue

Install - A new install will populate the database.

click install

Tiki Wiki CMS Groupware ( http://tiki.org

) Page 56

Tiki Installation Guide – print date: Jun 20, 2011

Review the Installation

Installation complete

Installation operations executed successfully: 5469 SQL queries.

click continue

Configure General Settings

Browser Title: KCDI Intranet

Sender email: my email address

HTTPS login: Disabled (no change)

Admin email: my email address

click to continue

Enter Your Tiki

click Enter Tiki and Lock Installer (Recommended)

HomePage

Congratulations

This is the default HomePage for your Tiki. If you are seeing this page, your installation was successful.

admin / admin

click login

Change password enforced

old password: admin new password: ******** repeat password: ********

click change

HomePage

Edit Section

Thank you for installing Tiki.

The entire Tiki Community would like to thank you and help you get introduced to Tiki.

Aliases

Tiki Wiki CMS Groupware ( http://tiki.org

) Page 57

Tiki Installation Guide – print date: Jun 20, 2011

Windows Server | WindowsServer

Notes from IIS project for Tiki 5

[-]

(Spring 2010 notes by jonnyb)

Issues (install from svn HEAD)

•

Writable dirs not detected (by installer or tiki main)

•

Caused major issues, but only had to set /temp, /templates_c and db/local.php to run

•

Mail - errors from zend on smtp (default installation)

•

SMTP probably not running on server

•

Then needs tying into PHP?

•

Tiki SMTP is broken (fails with a timeout, on Windows as well as Unix). Chealer9

20100709

• file write error on new tpls

• example error

PHP (5.2.12) ERROR (E_WARNING):

File:

C:\inetpub\wwwroot\tiki\lib\smarty\libs\internals\core.write_file.php

Line: 44

Type: unlink(C:\inetpub\wwwroot\tiki\templates_c\ en^%%23^230^230491F8%

%tiki-list_blogs.tpl.php) [function.unlink]: No such file or directory

•

That function blindly asks to delete a file without knowing whether it exists. This should be fine and most performant (since it saves a filesystem operation) using the PHP @ error-quieting operator, but that operator has no effect on Tiki since it uses custom error handling. This could be considered a PHP/Smarty bug highlighted by Tiki. We have a similar problem with php-openid. Chealer9 20100709

TikiWiki 5.0 Beta1 Install

I created a new Windows 2008R2 virtual server and using the basics listed above, installed 5.0 Beta 1 successfully.

I decided to use the latest software available, and ran into database errors during the Tiki installation with PHP 5.3.2 nts-Win32-VC9 (x386). This could have resulted in missing a line in the php.ini file,

Tiki Wiki CMS Groupware ( http://tiki.org

) Page 58

Tiki Installation Guide – print date: Jun 20, 2011

but I am pretty certain everything was in order. After starting over, I went back to 5.3.1 and had no issues.

I also used the latest version of MySQL (5.1.45 x64) with no problems.

Everything else was standard as per above.

Once I had a successful database creation, the page that came up looked like plain html. No formatting at all. However, I was able to change admin password and get into the site. After checking on #tikiwiki,

Caarrie pointed me to Admin/Performance. There I unchecked the â€œMinify CSSâ€ and all of the formatting was perfect! (Thanks again Caarrie). I am not sure if this is a default setting on installation, but if you run into this problem, it is a simple fix.

Table of contents:

Stuff below is really old. Please go to Windows Server Install

Windows IIS Install

This is an installation guide. This page needs to be refactor ed

Tikiwiki 19 on IIS

I am developing a complete set of instructions for Tiki 1.9 that will be available when 1.9 comes out.

These are the steps I used when I installed a fresh copy of Tiki19 on IIS 5 and IIS 6.

I followed the instructions on the IISInstall ?

page when I first started using Tiki back at version 1.6, so be sure that you follow them if this is your first time setting up Tiki on your system. I've included a portion of the code samples from the IISInstall page below.

STEP 1

Download and unpack the contents of the 19 distribution into a folder.

STEP 2

Tiki Wiki CMS Groupware ( http://tiki.org

) Page 59

Tiki Installation Guide – print date: Jun 20, 2011

Create the IIS virtual directory for the IIS server, pointing to the directory where Tiki19 was placed.

STEP 3

Edit the tiki-install.php and tiki-setup.php files accordingly:

•

Edit c:\tikiwiki_*\tiki-install.php (the actual directory depends on which version you have installed)

•

You will need to use a UNIX-linefeed-friendly editor. I use Crimson Editor

•

Change the line: $docroot = dirname($_SERVER['PATH_TRANSLATED']);

•

To: $docroot = dirname('c:/tikiwiki_*'); // Specify the real directory based on the

Tikiwiki version

•

Edit c:\tikiwiki_*\tiki-setup.php (the actual directory depends on which version you have installed)

•

You will need to use a UNIX-linefeed-friendly editor. I use Crimson Editor

•

Change the line: $docroot = dirname($_SERVER['PATH_TRANSLATED']);

•

To: $docroot = dirname('c:/tikiwiki_*'); // Specify the real directory based on the

Tikiwiki version

•

Change

// Fix IIS servers not setting what they should set if(!isset($_SERVER['QUERY_STRING']))

$_SERVER['QUERY_STRING']=''; if(!isset($_SERVER['REQUEST_URI'])||empty($_SERVER['REQUEST_URI']

))

{

$_SERVER['REQUEST_URI'] = $_SERVER['PHP_SELF'] . '/' .

$_SERVER['QUERY_STRING'];

}

To:

// Fix IIS servers not setting what they should set: if (TikiSetup::os() == "windows")

{

$uri = $_SERVER["REQUEST_URI"];

$len = strlen($uri);

if (substr($uri, $len -1) == "/")

{

$uri = substr($uri, 0, $len -1);

}

else

{

$uri = substr($uri, 0, $len - strlen($_SERVER["QUERY_STRING"]) -1);

$uri = $uri . "?" . $_SERVER["QUERY_STRING"];

}

$_SERVER["REQUEST_URI"] = $uri;

}

Tiki Wiki CMS Groupware ( http://tiki.org

) Page 60

Tiki Installation Guide – print date: Jun 20, 2011

STEP 4

Search the tiki-setup.php file for the following line:

Before the change

$smarty->assign('feature_bidi', $feature_bidi);

Edit it to look like that:

After the change

$feature_bidi = 'n';

$smarty->assign('feature_bidi', $feature_bidi);

STEP 5

Search the tiki-setup.php file for the following: $docroot/$dir/$tikidomain and comment out the section of code:

// foreach ($dirs as $dir) {

// if (!is_dir("$docroot/$dir/$tikidomain")) {

// $errors .= "The directory '$docroot/$dir/$tikidomain' does not exist.\n";

// } else if (!is_writeable("$docroot/$dir/$tikidomain")) {

// $errors .= "The directory '$docroot/$dir/$tikidomain' is not writeable by $wwwuser.\n";

// }

STEP 6

Open up the Tiki web site from a browser to begin the setup process.

older version (circa 1.7)

•

See UpgradeTo18 for upgrading from 1.7 to 1.8

•

If you are installing Tikiwiki 1.9, see

Issues

Tiki Wiki CMS Groupware ( http://tiki.org

) Page 61

Tiki Installation Guide – print date: Jun 20, 2011

1. There's an error message after adding a blog, but the blog is added correctly

2. Don't use the Mozilla theme or you'll be sorry

3. Office documents don't properly download from IE. Right click on the attachment and choose

"Save Target As..."

4. You'll get an error message if you click on "last forum topics" on the right and try to edit the post

•

Renavigate to the post using the forum list and then edit the post

5. Reading a forum thread that doesn't have any comments results in the right sidebar being displayed underneath the left sidebar

These issues are relating to Internet Explorer usage, not IIS specifically - Damian

Installing IIS

•

Go to the control panel, add/remove programs, and click the add/remove Windows Components button

•

Select IIS

•

You may need to reboot

•

Go to the start menu, followed by Windows Update

•

Install all service packs and critical updates

Installing MySQL

•

Download MySQL

•

How to install mySQL on Windows

•

Install MySQL as a service as described in the above link

•

By default, it is possible to log into MySQL with no username or password. I don't know how to change this behavior, but it's not a recommended configuration.

Installing TikiWiki

If you are installing Tiki 1.8 or later, don't follow these instuctions and move to the next section

•

Download TikiWiki

•

Using WinZip , extract to c:\ using folder names

•

Versions prior to 1.8 only Enter the following from the command line:

• cd /d c:\tikiwiki_* (the actual directory depends on which version you have installed)

• mkdir templates_c

•

Go to Windows Explorer and modify the security for the folder c:\tikiwiki_*\templates_c

•

Allow write access for the users whose names start with IUSR and IWAM

•

Note: 2004-10-01 Installed current stable version (1.7.8) and also had to allow write

Tiki Wiki CMS Groupware ( http://tiki.org

) Page 62

Tiki Installation Guide – print date: Jun 20, 2011

access to the tikiwiki base directory.

•

Versions 1.8 and later only Enter the following from the command line:

• cd /d c:\tikiwiki_* (the actual directory depends on which version you have installed)

• cd lib

• mkdir \php4

• xcopy /i /e pear \php4

•

Edit c:\tikiwiki_*\tiki-install.php (the actual directory depends on which version you have installed)

•

You will need to use a UNIX-linefeed-friendly editor. I use Crimson Editor

•

Change the line: $docroot = dirname($_SERVER['SCRIPT_FILENAME']);

•

To: $docroot = dirname('c:/tikiwiki_*'); // Specify the real directory based on the

Tikiwiki version

•

Edit c:\tikiwiki_*\tiki-setup.php (the actual directory depends on which version you have installed)

•

You will need to use a UNIX-linefeed-friendly editor. I use Crimson Editor

•

Change the line: $docroot = dirname($_SERVER['SCRIPT_FILENAME']);

•

To: $docroot = dirname('c:/tikiwiki_*'); // Specify the real directory based on the

Tikiwiki version

•

Change

// Fix IIS servers not setting what they should set (ay ay

IIS, ay ay) if(!isset($_SERVER['QUERY_STRING']))

$_SERVER['QUERY_STRING']=''; if(!isset($_SERVER['REQUEST_URI'])||empty($_SERVER['REQUEST_URI']

))

{

$_SERVER['REQUEST_URI'] = $_SERVER['PHP_SELF'] . '/' .

$_SERVER['QUERY_STRING'];

}

To:

// Fix IIS servers not setting what they should set (ay ay IIS, ay ay) if (TikiSetup::os() == "windows")

{

$uri = $_SERVER["REQUEST_URI"];

$len = strlen($uri);

if (substr($uri, $len -1) == "/")

{

$uri = substr($uri, 0, $len -1);

}

else

{

$uri = substr($uri, 0, $len - strlen($_SERVER["QUERY_STRING"]) -1);

$uri = $uri . "?" . $_SERVER["QUERY_STRING"];

}

Tiki Wiki CMS Groupware ( http://tiki.org

) Page 63

Tiki Installation Guide – print date: Jun 20, 2011

$_SERVER["REQUEST_URI"] = $uri;

}

Installing PHP 4.x

•

Advanced Settings

This section contains additional and advanced installation information.

•

Clean URLs

•

MultiTiki

•

MultiTiki Manual Installation

•

MultiTiki 3.0 Installation for Windows XP

•

TRIM

•

ImageMagick Install

•

GraphViz Install

•

Profiles

Clean URLs

Tiki supports search-engine friendly web addresses (SEFURLs or clean URLs), which are short versions of Tiki URLs, thanks to Apache Rewrite Rules. Some search engine crawlers do not process links with trailing parameters, so transforming the syntax makes the URL more search-engine friendly.

By configuring your server properly, Tiki can understand clean URLs so that such short URLs will bring up a Tiki page, and by configuring Tiki properly, Tiki will produce clean URLS and build them into menus, static links, etc. This page explains both steps: how to make Tiki understand and produce clean URLs.

Table of contents

•

•

•

•

•

•

•

•

•

•

•

•

Tiki Wiki CMS Groupware ( http://tiki.org

) Page 66

Tiki Installation Guide – print date: Jun 20, 2011

•

•

•

•

•

•

•

•

•

•

•

•

•

•

•

•

•

•

•

•

For more information on the Tiki installation process...

•

•

•

•

•

•

•

•

•

Initial Steps: Download, Unpack, Create Directories

•

•

•

•

•

•

•

•

•

•

•

Tiki Wiki CMS Groupware ( http://tiki.org

) Page 67

Tiki Installation Guide – print date: Jun 20, 2011

•

•

•

•

•

•

•

•

•

•

Step 3.1: Optional but recommended, change the MySQL root password

•

•

•

•

•

•

•

•

•

•

•

•

•

•

If you get a Parse error: (...) templates_c\preferences.php on line 94

•

•

Possible bug if you install at C:\Program Files\EasyPHP\www\ instead of

•

•

•

•

Windows 2008R2 Server setup

•

Windows Server Install

•

•

Software used:

•

Installed Windows:

•

Installed other software

•

TikiWiki 4.0 Install

•

Select your language: English

•

read the license

•

Review the System Requirements

Tiki Wiki CMS Groupware ( http://tiki.org

) Page 68

Tiki Installation Guide – print date: Jun 20, 2011

•

Set the Database Connection

•

Install - A new install will populate the database.

•

Review the Installation

•

Configure General Settings

•

Enter Your Tiki

•

•

Change password enforced

•

Notes from IIS project for Tiki 5

•

•

Issues (install from svn HEAD)

•

TikiWiki 5.0 Beta1 Install

•

Windows IIS Install

•

older version (circa 1.7)

•

Advanced Settings

•

Clean URLs

•

Examples

•

How to Activate Clean URLs

•

Step 1: Activate Input Rewrite Rules on Your Server

•

Web Hosting Service Using Apache

•

Apache Configuration When Managing Own Server

•

Web Servers Other Than Apache

•

Suggested Input Rewrite Rules

•

Rewrite Rules for MultiTiki using Subdirectories as Symlinks

•

Step 2: Configure Tiki to Produce Clean URLs

•

Changing Rewrite Rules

•

WARNING: For sites hosted with MediaTemple's (gs) Grid-Service

•

Developer's Corner

•

Version 3 and Higher Before Version 3

Examples

Here are some examples of how clean URLs work for various types of Tiki pages:

Type of Page Clean URL Long URL

Wiki page| tiki.org/TikiRewriteRule | http://tiki.org/tiki-index.php?page=TikiRewriteRule

Forum| http://tiki.org/forum4 | http://tiki.org/tiki-view_forum.php?forumId=4

Article| http://tiki.org/art133 | http://tiki.org/tiki-read_article.php?articleId=133

Article|~~~body23~~ ~~body24~~~

Tiki Wiki CMS Groupware ( http://tiki.org

) Page 69

Tiki Installation Guide – print date: Jun 20, 2011

Note

Note that both the short and long URLs will still access your site.

How to Activate Clean URLs

There are two basic steps to activivating Clean URLs:

1. Activating input rewrite rules on your server (so Tiki can understand clean URLs)

•

With this step alone, accessing your site with clean URL short links will work properly

2. Enabling the SEFURL or SEFURL Filter (version 3.0) feature (or both) in Tiki (So Tiki will

produce clean URLs)

•

This causes internal Tiki links to be rewritten into clean URLs. The generation of the clean URLs is governed with 'output rewrite rules' that are in the code before Tiki version 3.0 and in the database beginning with 3.0.

Step 1: Activate Input Rewrite Rules on Your Server

Web Hosting Service Using Apache

If you have Tiki version 1.9.x or greater and are using a web hosting service that uses Apache, then input rewrite rules can be activated as follows:

•

Rename the file named _htaccess in your Tiki root directory to .htaccess (or create a symbolic link to .htaccess).

•

This will automatically bring in suggested rewrite rules shown below (at Suggested

Input Rewrite Rules ) into the .htaccess file. The _htaccess file is included as part of the

Tiki download (since version 1.9.3) but is not activated by default because it may not work with all server configurations.

Apache Configuration When Managing Own Server

If you manage your server and are using Apache, be sure to

1. Load the rewrite module. Something like this line in httpd.conf: LoadModule rewrite_module modules/mod_rewrite.so (adjust the path if necessary). You can check it is ok if you see the mod_rewrite in the apache loaded modules.

2. Enable the access to .htaccess. To do so you must have lines like

...

Options FollowSymLinks

AllowOverride FileInfo

Tiki Wiki CMS Groupware ( http://tiki.org

) Page 70

Tiki Installation Guide – print date: Jun 20, 2011

...

</Directory>

Adapt the directory path to your need. This block can be in httpd.conf or in your virtual host config (vhosts.d directory in apache2).

The documentation for Apache2 core says that the <FilesMatch> section requires:

AllowOverride All

3. Restart your server

Web Servers Other Than Apache

If you or your web hosting company is using a web server other than Apache (IIS for example), see your server manual or contact your web hosting service to find out how to activate rewrite rules on your server.

Suggested Input Rewrite Rules

Below are the rewrite rules for different versions of Tiki that pull into the .htaccess file automatically when the steps above for Apache web servers are followed.

Tiki Wiki CMS Groupware ( http://tiki.org

) Page 71

6.x version

Tiki Installation Guide – print date: Jun 20, 2011

Object 1

Rewrite Rules for MultiTiki using Subdirectories as Symlinks

[+]

Imagine you have your Tiki set up on a MultiTiki -like installation, and that your Tiki (and the other ones) are created as symlinks. Something like:

1. "http://yoursite.com/subdir1/"

2. "http://yoursite.com/subdir2/"

3. ...

Tiki Wiki CMS Groupware ( http://tiki.org

) Page 72

Tiki Installation Guide – print date: Jun 20, 2011

and they all point, as symlinks, to the same tiki installation in your server, let's say:

/var/www/subdir1/ ---> /home/httpd/tiki/

/var/www/subdir2/ ---> /home/httpd/tiki/

...

Your .htaccess under /home/httpd/tiki/ has to be, then, something like the following:

< Click here to view it

[-]

# These are suggested Rewrite Rules for use with Tiki.

# They enhance security and permit short URLS.

# To use

# 1- rename _htaccess to .htaccess

# or

# 2- add the content of this file to your httpd.conf

# Please find more info here

# http://doc.tiki.org/Rewrite+Rules

order deny,allow

deny from all

</FilesMatch>

RewriteEngine On

# rewrite for multitiki sites, when configured as symlinks, not as apache aliases

RewriteCond %{SCRIPT_FILENAME}/ -d

RewriteRule [^/]$ %{REQUEST_URI}/ [R=301,L]

# direct one-word access for tiki in /subdir1/

RewriteRule ^articles$ /subdir1/tiki-view_articles.php

[L]

RewriteRule ^blogs$ /subdir1/tiki-list_blogs.php

[L]

RewriteRule ^calendar$ /subdir1/tiki-calendar.php

[L]

RewriteRule ^categories$ /subdir1/tiki-browse_categories.php

[L]

RewriteRule ^charts$ /subdir1/tiki-list_charts.php

[L]

RewriteRule ^chat$ /subdir1/tiki-chat.php

Tiki Wiki CMS Groupware ( http://tiki.org

) Page 73

Tiki Installation Guide – print date: Jun 20, 2011

[L]

RewriteRule ^contact$ /subdir1/tiki-contact.php

[L]

RewriteRule ^directories$ /subdir1/tiki-directory_browse.php

[L]

RewriteRule ^eph$ /subdir1/tiki-eph.php

[L]

RewriteRule ^faqs$ /subdir1/tiki-list_faqs.php

[L]

RewriteRule ^files$ /subdir1/tiki-file_galleries.php

[L]

RewriteRule ^forums$ /subdir1/tiki-forums.php

[L]

RewriteRule ^images$ /subdir1/tiki-galleries.php

[L]

RewriteRule ^irc$ /subdir1/tiki-irc_logs.php

[L]

RewriteRule ^galleries$ /subdir1/tiki-galleries.php

[L]

RewriteRule ^games$ /subdir1/tiki-list_games.php

[L]

RewriteRule ^login$ /subdir1/tiki-login.php

[L]

RewriteRule ^mobile$ /subdir1/tiki-mobile.php

[L]

RewriteRule ^my$ /subdir1/tiki-my_tiki.php

[L]

RewriteRule ^newsletters$ /subdir1/tiki-newsletters.php

[L]

RewriteRule ^quizzes$ /subdir1/tiki-list_quizzes.php

[L]

RewriteRule ^sheets$ /subdir1/tiki-sheets.php

[L]

RewriteRule ^stats$ /subdir1/tiki-stats.php

[L]

RewriteRule ^surveys$ /subdir1/tiki-list_surveys.php

[L]

RewriteRule ^trackers$ /subdir1/tiki-list_trackers.php

[L]

RewriteRule ^wml$ /subdir1/tiki-mobile.php

[L]

RewriteRule ^workspaces$ /subdir1/tiki-workspaces_admin.php

[L]

# direct one-word access for tiki in /subdir2/

RewriteRule ^articles$ /subdir2/tiki-view_articles.php

[L]

RewriteRule ^blogs$ /subdir2/tiki-list_blogs.php

[L]

RewriteRule ^calendar$ /subdir2/tiki-calendar.php

[L]

RewriteRule ^categories$ /subdir2/tiki-browse_categories.php

Tiki Wiki CMS Groupware ( http://tiki.org

) Page 74

Tiki Installation Guide – print date: Jun 20, 2011

[L]

RewriteRule ^charts$ /subdir2/tiki-list_charts.php

[L]

RewriteRule ^chat$ /subdir2/tiki-chat.php

[L]

RewriteRule ^contact$ /subdir2/tiki-contact.php

[L]

RewriteRule ^directories$ /subdir2/tiki-directory_browse.php

[L]

RewriteRule ^eph$ /subdir2/tiki-eph.php

[L]

RewriteRule ^faqs$ /subdir2/tiki-list_faqs.php

[L]

RewriteRule ^files$ /subdir2/tiki-file_galleries.php

[L]

RewriteRule ^forums$ /subdir2/tiki-forums.php

[L]

RewriteRule ^images$ /subdir2/tiki-galleries.php

[L]

RewriteRule ^irc$ /subdir2/tiki-irc_logs.php

[L]

RewriteRule ^galleries$ /subdir2/tiki-galleries.php

[L]

RewriteRule ^games$ /subdir2/tiki-list_games.php

[L]

RewriteRule ^login$ /subdir2/tiki-login.php

[L]

RewriteRule ^mobile$ /subdir2/tiki-mobile.php

[L]

RewriteRule ^my$ /subdir2/tiki-my_tiki.php

[L]

RewriteRule ^newsletters$ /subdir2/tiki-newsletters.php

[L]

RewriteRule ^quizzes$ /subdir2/tiki-list_quizzes.php

[L]

RewriteRule ^sheets$ /subdir2/tiki-sheets.php

[L]

RewriteRule ^stats$ /subdir2/tiki-stats.php

[L]

RewriteRule ^surveys$ /subdir2/tiki-list_surveys.php

[L]

RewriteRule ^trackers$ /subdir2/tiki-list_trackers.php

[L]

RewriteRule ^wml$ /subdir2/tiki-mobile.php

[L]

RewriteRule ^workspaces$ /subdir2/tiki-workspaces_admin.php

[L]

# access any object by its numeric identifier for tiki in /subdir1/

RewriteRule ^article([0-9]+) /subdir1/tiki-read_article.php?

articleId=$1 [QSA,L]

Tiki Wiki CMS Groupware ( http://tiki.org

) Page 75

Tiki Installation Guide – print date: Jun 20, 2011

RewriteRule ^art([0-9]+) /subdir1/tiki-read_article.php?

articleId=$1 [QSA,L]

RewriteRule ^blog([0-9]+) /subdir1/tiki-view_blog.php?blogId=$1

[QSA,L]

RewriteRule ^blogpost([0-9]+) /subdir1/tiki-view_blog_post.php?

postId=$1 [QSA,L]

RewriteRule ^cat([0-9]+) /subdir1/tiki-browse_categories.php?

parentId=$1 [QSA,L]

RewriteRule ^categ([0-9]+) /subdir1/tiki-browse_categories.php?

parentId=$1 [QSA,L]

RewriteRule ^chart([0-9]+) /subdir1/tiki-view_chart.php?

chartId=$1 [QSA,L]

RewriteRule ^directory([0-9]+) /subdir1/tiki-directory_browse.php?

parent=$1 [QSA,L]

RewriteRule ^dl([0-9]+) /subdir1/tiki-download_file.php?

fileId=$1 [QSA,L]

RewriteRule ^eph([0-9]+) /subdir1/tiki-directory_browse.php?

parent=$1 [QSA,L]

RewriteRule ^faq([0-9]+) /subdir1/tiki-view_faq.php?faqId=$1

[QSA,L]

RewriteRule ^file([0-9]+) /subdir1/tiki-list_file_gallery.php?

galleryId=$1 [QSA,L]

RewriteRule ^forum([0-9]+) /subdir1/tiki-view_forum.php?

forumId=$1 [QSA,L]

RewriteRule ^img([0-9]+) /subdir1/show_image.php?id=$1

[QSA,L]

RewriteRule ^image([0-9]+) /subdir1/tiki-browse_image.php?

imageId=$1 [QSA,L]

RewriteRule ^int([0-9]+) /subdir1/tiki-integrator.php?repID=$1

[QSA,L]

RewriteRule ^irc([0-9]+) /subdir1/tiki-irc_logs.php?focus=$1

[QSA,L]

RewriteRule ^gal([0-9]+) /subdir1/tiki-browse_gallery.php?

galleryId=$1 [QSA,L]

RewriteRule ^gallery([0-9]+) /subdir1/tiki-browse_gallery.php?

galleryId=$1 [QSA,L]

RewriteRule ^newsletter([0-9]+) /subdir1/tiki-newsletters.php?nlId=$1

[QSA,L]

RewriteRule ^page([0-9]+) /subdir1/tiki-index.php?page_ref_id=$1

[QSA,L]

RewriteRule ^page-([A-Za-z0-9]+) /subdir1/tiki-index.php?page=$1

[QSA,L]

RewriteRule ^poll([0-9]+) /subdir1/tiki-poll_results.php?

pollId=$1 [QSA,L]

RewriteRule ^quiz([0-9]+) /subdir1/tiki-take_quiz.php?quizId=$1

[QSA,L]

RewriteRule ^sheet([0-9]+) /subdir1/tiki-view_sheets.php?

sheetId=$1 [QSA,L]

RewriteRule ^survey([0-9]+) /subdir1/tiki-take_survey.php?

surveyId=$1 [QSA,L]

RewriteRule ^tracker([0-9]+) /subdir1/tiki-view_tracker.php?

trackerId=$1 [QSA,L]

Tiki Wiki CMS Groupware ( http://tiki.org

) Page 76

Tiki Installation Guide – print date: Jun 20, 2011

RewriteRule ^vote([0-9]+) /subdir1/tiki-poll_form.php?pollId=$1

[QSA,L]

RewriteRule ^wiki-([A-Za-z0-9]+) /subdir1/tiki-index.php?page=$1

[QSA,L]

RewriteRule ^ws([0-9]+) /subdir1/tiki-workspaces_desktop.php?

workspaceId=$1 [QSA,L]

# access any object by its numeric identifier for tiki in /subdir2/

RewriteRule ^article([0-9]+) /subdir2/tiki-read_article.php?

articleId=$1 [QSA,L]

RewriteRule ^art([0-9]+) /subdir2/tiki-read_article.php?

articleId=$1 [QSA,L]

RewriteRule ^blog([0-9]+) /subdir2/tiki-view_blog.php?blogId=$1

[QSA,L]

RewriteRule ^blogpost([0-9]+) /subdir2/tiki-view_blog_post.php?

postId=$1 [QSA,L]

RewriteRule ^chart([0-9]+) /subdir2/tiki-view_chart.php?

chartId=$1 [QSA,L]

RewriteRule ^cat([0-9]+) /subdir2/tiki-browse_categories.php?

parentId=$1 [QSA,L]

RewriteRule ^categ([0-9]+) /subdir2/tiki-browse_categories.php?

parentId=$1 [QSA,L]

RewriteRule ^directory([0-9]+) /subdir2/tiki-directory_browse.php?

parent=$1 [QSA,L]

RewriteRule ^dl([0-9]+) /subdir2/tiki-download_file.php?

fileId=$1 [QSA,L]

RewriteRule ^eph([0-9]+) /subdir2/tiki-directory_browse.php?

parent=$1 [QSA,L]

RewriteRule ^faq([0-9]+) /subdir2/tiki-view_faq.php?faqId=$1

[QSA,L]

RewriteRule ^file([0-9]+) /subdir2/tiki-list_file_gallery.php?

galleryId=$1 [QSA,L]

RewriteRule ^forum([0-9]+) /subdir2/tiki-view_forum.php?

forumId=$1 [QSA,L]

RewriteRule ^img([0-9]+) /subdir2/show_image.php?id=$1

[QSA,L]

RewriteRule ^image([0-9]+) /subdir2/tiki-browse_image.php?

imageId=$1 [QSA,L]

RewriteRule ^int([0-9]+) /subdir2/tiki-integrator.php?repID=$1

[QSA,L]

RewriteRule ^irc([0-9]+) /subdir2/tiki-irc_logs.php?focus=$1

[QSA,L]

RewriteRule ^gal([0-9]+) /subdir2/tiki-browse_gallery.php?

galleryId=$1 [QSA,L]

RewriteRule ^gallery([0-9]+) /subdir2/tiki-browse_gallery.php?

galleryId=$1 [QSA,L]

RewriteRule ^newsletter([0-9]+) /subdir2/tiki-newsletters.php?nlId=$1

[QSA,L]

RewriteRule ^page([0-9]+) /subdir2/tiki-index.php?page_ref_id=$1

[QSA,L]

RewriteRule ^page-([A-Za-z0-9]+) /subdir2/tiki-index.php?page=$1

[QSA,L]

Tiki Wiki CMS Groupware ( http://tiki.org

) Page 77

Tiki Installation Guide – print date: Jun 20, 2011

RewriteRule ^poll([0-9]+) /subdir2/tiki-poll_results.php?

pollId=$1 [QSA,L]

RewriteRule ^quiz([0-9]+) /subdir2/tiki-take_quiz.php?quizId=$1

[QSA,L]

RewriteRule ^sheet([0-9]+) /subdir2/tiki-view_sheets.php?

sheetId=$1 [QSA,L]

RewriteRule ^survey([0-9]+) /subdir2/tiki-take_survey.php?

surveyId=$1 [QSA,L]

RewriteRule ^tracker([0-9]+) /subdir2/tiki-view_tracker.php?

trackerId=$1 [QSA,L]

RewriteRule ^vote([0-9]+) /subdir2/tiki-poll_form.php?pollId=$1

[QSA,L]

RewriteRule ^wiki-([A-Za-z0-9]+) /subdir2/tiki-index.php?page=$1

[QSA,L]

RewriteRule ^ws([0-9]+) /subdir2/tiki-workspaces_desktop.php?

workspaceId=$1 [QSA,L]

# todo add support for all characters allowed in a Wiki name for tiki in subdir1

# make sure this is the last rule!

RewriteRule ^show:(~?)([-_\+A-Za-z0-9]+)$ /subdir1/tiki-slideshow.php?

page=$1$2 [QSA,L]

RewriteRule ^(~?)([-_\+A-Za-z0-9]+)$ /subdir1/tiki-index.php?

page=$1$2 [QSA,L]

# todo add support for all characters allowed in a Wiki name for tiki in subdir2

# make sure this is the last rule!

RewriteRule ^show:(~?)([-_\+A-Za-z0-9]+)$ /subdir2/tiki-slideshow.php?

page=$1$2 [QSA,L]

RewriteRule ^(~?)([-_\+A-Za-z0-9]+)$ /subdir2/tiki-index.php?

page=$1$2 [QSA,L]

#for multi-byte char support use for tiki in subdir1

RewriteRule ^([^a-z]+)([^\/]+)([^tki-]+)(.*[^.js]+)(~?)(.*)$

/subdir1/tiki-index.php?page=$1$2$3$4$5$6$7$8$9 [QSA,L]

#for multi-byte char support use for tiki in subdir2

RewriteRule ^([^a-z]+)([^\/]+)([^tki-]+)(.*[^.js]+)(~?)(.*)$

/subdir2/tiki-index.php?page=$1$2$3$4$5$6$7$8$9 [QSA,L]

</IfModule>

Step 2: Configure Tiki to Produce Clean URLs

Now that your input rewrite rules have been set, you now need to configure Tiki to activate the output rewrite rules so that Tiki will generate SEFURLs internally in menus, static links and elsewhere.

Tiki Wiki CMS Groupware ( http://tiki.org

) Page 78

Tiki Installation Guide – print date: Jun 20, 2011

No Tabs

Starting with version 3.0, there is a search engine friendly feature icon directly on the Admin Home page that will look something like this:

Clicking on that icon will bring up the search-engine friendly url admin page (although you could reach this page through the paths described above for previous versions as well):

Search engine friendly url

Selecting the first checkbox will activate the SEFURL feature within Tiki, meaning that some links used in and elsewhere in Tiki will be search-engine friendly. This doesn't work for all links because not all of the templates have been updated, that's why there is a second checkbox...

Search engine friendly url Postfilter

To generate SEFURLs for all Tiki links, also check the second checkbox which creates short URLs by filtering the output. The SEFURL Postfilter consumes more processor (CPU) time than the non-filter version (it deals with all the text and it deals also with cached text like modules while the 'on the fly' filter does not do it. In future versions the SEFURL Postfilter will not be used - it is only necessary until the template SEFURL work is finished. Either one or both features (SEFURL and SEFURL

Postfilter) may be used.

List of Url Parameters that should go in the path

This is used if you want a post or get variable to be represented in the sefurl. For instance if you have a url like tw.org/tiki-index.php?page=xxx&lang=en and if you put lang in the setting, the sefurl will be

tw.org/en/xxx. You can generalize to any number of parameters. For a setting lang,locale, an url

Tiki Wiki CMS Groupware ( http://tiki.org

) Page 79

Tiki Installation Guide – print date: Jun 20, 2011

tw.org/tiki-index.php?page=xxx&lang=en&locale=us, the sefurl will be tw.org/en/us/xxx. This setting requires you adapt your .htaccess.

Display article title in the sefurl

Clicking this checkbox will add the title of the article to the url for a link to that article. For instance,

tiki-read_article.php?articleId=1 will be transformed into article1-My-article-title. This does not work with the postfilter, only with 'on the fly filter'.

Display blog title in the sefurl

Similar to the article checkbox, clicking this checkbox will add the title of the blog to the url for a link to that blog. This does not work with the postfilter, only with 'on the fly filter'.

Within Tiki,

1. Go to Admin Home -> Features -> Experimental -> Search engine friendly url (checkbox)

+ Or use the following URL to get to the Features page (since version 2.0): your URL/tiki-

admin.php?page=features

2. Check the box for "Search engine friendly url" to select this feature

3. Click "Apply" to activate the feature

Here's a screenshot:

Changing Rewrite Rules

You can customize the rewrite rules but it is important to note that that the input and output rewrite

rules are connected, so that if you change one you may need to change the other.

•

You can add as many input rewrite rules you want. For instance if you want to be able to access a forum with forum1 or forum_1, no problem. Add the adequate rule in the htaccess that will

Tiki Wiki CMS Groupware ( http://tiki.org

) Page 80

Tiki Installation Guide – print date: Jun 20, 2011

rewrite forum_1 to tiki-view_forum.php?forumId=1

•

But if you want to change the output "rewrite" rules in Tiki, you must adapt the input rewrite rules

•

Starting with Tiki version 3.0, the output rewrite rules are in the table tiki_sefurl_regex_out

WARNING: For sites hosted with MediaTemple's (gs) Grid-Service

After making these changes, your site may mysteriously revert back to using PHP4. This will result in an error such as the following when you try to access your site:

Parse error: syntax error, unexpected T_STRING, expecting '{' in

/nfs/c03/h01/mnt/GRID#/domains/YOURSITENAME.COM/html/tiki-install.php on line 45

Resolve this by logging into the MediaTemple control panel and switching the site back to PHP5.

Afterwards, double-check that your Search Engine Friendly url is still enabled in TikiWki.

Developer's Corner

The 'on the fly' filter can use 2 smarty tools: prefilter and a function. Here's an example:

Both filters use tiki-sefurl.php to rewrite the urls.

Related

•

Search engine optimization

Alias

.htaccess

Tiki Wiki CMS Groupware ( http://tiki.org

) Page 81

Tiki Installation Guide – print date: Jun 20, 2011

MultiTiki

•

•

•

•

•

•

•

•

•

•

•

•

•

•

•

•

•

•

•

•

•

•

•

•

•

•

•

•

•

•

•

•

For more information on the Tiki installation process...

•

•

•

•

•

•

Tiki Wiki CMS Groupware ( http://tiki.org

) Page 82

Tiki Installation Guide – print date: Jun 20, 2011

•

•

•

Initial Steps: Download, Unpack, Create Directories

•

•

•

•

•

•

•

•

•

•

•

•

•

•

•

•

•

•

•

•

•

Step 3.1: Optional but recommended, change the MySQL root password

•

•

•

•

•

•

•

•

•

•

•

•

•

•

If you get a Parse error: (...) templates_c\preferences.php on line 94

•

•

Possible bug if you install at C:\Program Files\EasyPHP\www\ instead of

Tiki Wiki CMS Groupware ( http://tiki.org

) Page 83

Tiki Installation Guide – print date: Jun 20, 2011

•

•

•

•

Windows 2008R2 Server setup

•

Windows Server Install

•

•

Software used:

•

Installed Windows:

•

Installed other software

•

TikiWiki 4.0 Install

•

Select your language: English

•

read the license

•

Review the System Requirements

•

Set the Database Connection

•

Install - A new install will populate the database.

•

Review the Installation

•

Configure General Settings

•

Enter Your Tiki

•

•

Change password enforced

•

Notes from IIS project for Tiki 5

•

•

Issues (install from svn HEAD)

•

TikiWiki 5.0 Beta1 Install

•

Windows IIS Install

•

older version (circa 1.7)

•

Advanced Settings

•

Clean URLs

•

Examples

•

How to Activate Clean URLs

•

Step 1: Activate Input Rewrite Rules on Your Server

•

Web Hosting Service Using Apache

•

Apache Configuration When Managing Own Server

•

Web Servers Other Than Apache

•

Suggested Input Rewrite Rules

•

6.x version

•

Rewrite Rules for MultiTiki using Subdirectories as Symlinks

•

< Click here to view it

•

Step 2: Configure Tiki to Produce Clean URLs

Tiki Wiki CMS Groupware ( http://tiki.org

) Page 84

Tiki Installation Guide – print date: Jun 20, 2011

•

Changing Rewrite Rules

•

WARNING: For sites hosted with MediaTemple's (gs) Grid-Service

•

Developer's Corner

•

•

1. Create a separate database for each url.

•

•

2. Configure the server to host multiple Tikis

•

2.1. Multitiki using domains

•

2.2. Multitiki using subdirectories

•

3. Create the necessary directories within Tiki's main directory.

•

4. Optionally, add .htaccess with rewrite rules

•

5. Other Installation Procedures for Multiple TikiWikis

Or how to set up Multiple Tikis on the same server with a single Tiki file set installation. For managing different tiki installations (several copies of the same installation files) in the same or different servers, see TRIM instead.

It is possible to have multiple Tikis on a single server and using a single copy of the installation file set.

This can be done through:

1. Multitiki using domains: using different domain names (i.e. http://site1.org/ , http://site2.org/ , ...). or

2. Multitiki using subdirectories: having your several tikis in subdirectories of the same domain

(i.e. http://yourhost/site1/ , http://yourhost/site2/ , ...) .

There are some differences depending on the previous option, but there are three major requirements that must be satisfied in both cases:

•

Tiki must have an access to a separate database for each URL.

•

Apache must know how to associate multiple URLs with the Tiki.

•

You must create the necessary directories with the Tiki's main directory.

1. Create a separate database for each url.

•

Each database will have a different name. In mysql, creating the databases is normally accomplished with the mysqladmin command. You may have permission to create the database, or you may have to ask a system administrator. To actually tell Tiki which database goes with which URL you have to edit one of Tiki's PHP files. The file db/local.php is designed for this purpose.

Tiki Wiki CMS Groupware ( http://tiki.org

) Page 85

Tiki Installation Guide – print date: Jun 20, 2011

See an example of edited local.php file for multikis (either 'multitiki using domains' or 'multitiki using subdirectories') at Manual Installation .

2. Configure the server to host multiple Tikis

2.1. Multitiki using domains

Typically, each Tiki will be accessed by a separate URL through Apache. Generally, the URLs are specified as virtual hosts — often in VirtualHost stanzas within Apache's configuration file. Remember to restart Apache after you have changed the configuration files. On Linux this is usually best done with the "apachectl" graceful command.

On shared hosting, you can use "parked a domain" to have extra domains pointing to the same TikiWiki installation.

2.2. Multitiki using subdirectories

Add symlinks. See the instructions in Manual installation AND in MultiTiki Manual Installation for the time being (and/or improve this page).

3. Create the necessary directories within Tiki's main directory.

•

On a Unix system, the easiest way to create the new directories and set permissions is by specifing more than one tikidomain when you run setup.sh. You would run setup.sh with a command like:

3.x

2.x and 1.9.x

Run setup.sh from the console, and follow instructions. You'll need to grant execution permission on that file the first time, as user with root privileges:

% chmod +x ./setup.sh

Then, just run it with no parameters in the command line, and it will start in interactive mode:

% ./setup.sh

From there follow instructions. Some of the options are explained below:

•

Group: Defaults to nobody or www-data or others (depending on the system, whatever the

Tiki Wiki CMS Groupware ( http://tiki.org

) Page 86

Tiki Installation Guide – print date: Jun 20, 2011

script will suggesst you as default) but may also be the standard group for the files as uploaded.

•

Multi: You should add here the names of your multitiki sites, separated by spaces (i.e. "site1 site2", or "www.site1.org www.site2.org

", without the quotation marks. The script will create as many subdirectories as appropriate using this name for each tiki site under this multitiki installation.

If it doesn't work for any reason, you can do its job by hand. See Manual Installation if needed.

There are a few minor problems that crop up with this approach. The admins for the various tikis have the ability to overwrite each others changes to the css. Ordinary. users with the same login names on different tikis would also be able to overwrite each other's changes to css files. Finally, you must use

Apache's mod_rewrite if you want the different Tikis to have their own favicons.

4. Optionally, add .htaccess with rewrite rules

You optionally add some Clean URLs for your tikis.

5. Other Installation Procedures for Multiple TikiWikis

•

MultiTiki Manual Installation

•

MultiTiki 3.0 Installation for Windows XP

Install ImageMagick

For those that use the image gallery in tiki, note that GD is used by php for image processing. But

GDlib comes with some restrictions on file formats, especially regarding GIF use. Support for Image

Magick is added now, that offers a wider range of available file formats.

Install ImageMagick and Libs

Get Image Magick from http://www.imagemagick.org/

•

Be sure to install the libraries.

•

On RPM based system (RedHat, Mandrake) rpm -q libMagick5 libMagick5-5.4.8.3-2mdk

•

On APT based system (Debian, Knoppix) apt-get -s install imagick

Tiki Wiki CMS Groupware ( http://tiki.org

) Page 121

Tiki Installation Guide – print date: Jun 20, 2011

Install Imagick PECL Module

•

Get the PECL module from http://pecl.php.net/package/imagick Or use pecl to download it: pecl install imagick

•

Activate the extension in /etc/php.ini extension=imagick.so

•

Windows Users can download a dll from http://php.chregu.tv/php_imagick.dll

or http://snaps.php.net/ pecl file. php_imagick.dll has to be placed into the extension_dir directory

(/php/extensions...), add extension=php_imagick.dll

to php.ini, and finally copy all the dll files from ImageMagick installation root directory to

/windows/system32.

•

Debian sid users have that package : apt-get install php4-imagick

•

Other users have to compile it. To compile it, you have to recompile your PHP Get the PHP sources on http://php.net

, read the INSTALL file from the imagick module and ./configure PHP with --with-imagick

Special Tip :

If your compilation stops, There are 2 Bugs:

• do a "rm ./configure" in your php src directory before performing Step 8 of the INSTALL-file of imagick.

• edit imagick.c (Version 0.95) Line 624 should be "RunlengthEncodedCompression" not

"RLECompression", this may depend on your libMagick however your make should tell you the right way. Install your new PHP, restart your webserver. Do a phpinfo() to see if Imagick support is added. If not, you may have forgot to rm ./configure.

Tikiwiki setting up

In the Image Gallery Config select Imagick as Library to use for processing images. If PHP is unable to find the PHP Imagick the setting reverts back to GD.

Useful Links

•

Next Version of the PEAR module will work with GraphicsMagick too: http://graphicsmagick.sourceforge.net/

Tiki Wiki CMS Groupware ( http://tiki.org

) Page 122

Tiki Installation Guide – print date: Jun 20, 2011

Graphviz Install

Graphviz provides a collection of tools for manipulating graph structures and generating graph layouts.

For those who would like to use Dynamic SiteMap

graph generation in Tikiwiki, we recommend the Graphviz library and the PluginWikigraph . GraphViz with Wikigraph plugin (in mods.tw.o) work well still with Tiki 3 LTS, but not with Tiki 6 LTS.

Install Graphviz and Libs

•

On Windows the default installer exe should do all necessary steps.

Get Graphviz from http://graphviz.org/pub/graphviz/ .

•

On RPM based system (RedHat, Mandrake) rpm -q graphviz

•

On APT based system (Debian, Knoppix) apt-get -s install graphviz

•

For Portage users (Gentoo) emerge graphviz

Testing an installed Graphviz Setup

•

Point your browser to http://127.0.0.1/tiki-wiki_graph.php?

page=HomePage&level=2

Troubleshooting Hints

•

Graphviz consumes LOTS of memory with even small (no. of wikipages less than

100) wiki content. Try to keep the Level of the graph low in order to use wiki pages including dynamic graphs.

•

If you use Windows, copy GraphViz binary files (dot.exe, neato.exe, etc) from the

GraphViz bin folder to the windows\system32 or equivalent folder (NaV/system32). The installer should have done this job for you, but we recommend double-checking if you encounter errors. It's not the same to put the exe's in the path, they must be in a Windows system directory.

•

In PHP Safemode environments, special adjustments need to be made to use external libraries.

Tiki Wiki CMS Groupware ( http://tiki.org

) Page 123

Tiki Installation Guide – print date: Jun 20, 2011

•

These settings will be included here.

From Here

•

Take a look at how to use the PluginWikigraph .

Useful Links

•

Development home of the Graph Visualization Project http://graphviz.org/

•

GraphVIZ Reference Manual http://www.research.att.com/sw/tools/graphviz/refs.html

•

Download Graphviz http://www.research.att.com/sw/tools/graphviz/download.html

•

Graphviz Source License http://www.research.att.com/sw/tools/graphviz/license/index.html

•

Graphviz Binary License http://www.research.att.com/sw/tools/graphviz/license/binary.html

alias

GraphViz

Admin Profiles Page

Overview

Tiki profiles allow you to apply a pre-defined configuration to your TIki

To access

Click the Profiles icon or

on the Admin Panel

Access http://yourdomain.com/tiki-admin.php?page=profiles

Alias

•

Profile

•

Configuration Profile

•

Configuration Profiles

•

Apply a Profile

•

Apply Profiles

•

Install Profile

•

Install Profiles

•

Installation Profile

•

Installation Profiles

•

Profile manager

•

Profiles manager

Tiki Wiki CMS Groupware ( http://tiki.org

) Page 125

Tiki Installation Guide – print date: Jun 20, 2011

Upgrade your Tiki site

Upgrading Tiki is very similar to its installation . Upgrading is a one-way process. There is no way to downgrade, other than reverting to a backup. Before undertaking a major upgrade (e.g. from 5.x to 6.x) perform a test upgrade on a backup before proceeding with the real upgrade.

Do I need to upgrade?

Depends. Some versions of Tiki are listed as Long Term Support which means developers are continuing with security patches and bug fixes on that version. If you are upgrading only for security reasons, you can stay with the LTS version you are at. Major upgrades introduce new features, but existing features, themes, plugins and modules may not function as they did before. A test upgrade is strongly recommended. Upgrades within a branch (having the same version number) are unlikely to cause problems and recommended for security reasons.

Overview: How an upgrade works

1. Backup all the files and database from your current installation.

2. Reinstall the new version, preferrably into a empty folder.

3. Copy any custom files (css, uploaded files and images, custom from your backup.

4. Run the installer (tiki-install. which upgrades the database

Do I really need to download and then upload the whole thing? - For some upgrades a "patch version" is available, if only a few files have been modified.

Alternatives to FTP: Rather than downloading and re-uploading the whole package, use commands

svn or wget (ask your hosting provider) to move the files directly from SourceForge to your server.

More detailed instructions

•

•

•

•

•

•

Tiki Wiki CMS Groupware ( http://tiki.org

) Page 126

Tiki Installation Guide – print date: Jun 20, 2011

•

PHP

•

More information

•

•

•

•

•

•

•

•

•

•

•

•

•

•

•

•

•

•

•

•

•

•

•

•

For more information on the Tiki installation process...

•

•

•

•

•

•

•

•

•

Initial Steps: Download, Unpack, Create Directories

•

•

•

PHP Setup

•

MySQL Setup

•

Apache setup

Tiki Wiki CMS Groupware ( http://tiki.org

) Page 127

Tiki Installation Guide – print date: Jun 20, 2011

•

Install Tiki

•

Normal installation

•

•

•

•

•

•

•

•

•

•

•

•

•

•

Step 3.1: Optional but recommended, change the MySQL root password

•

•

•

•

•

•

•

•

•

•

•

•

•

•

If you get a Parse error: (...) templates_c\preferences.php on line 94

•

•

Possible bug if you install at C:\Program Files\EasyPHP\www\ instead of

•

•

•

•

Windows 2008R2 Server setup

•

Windows Server Install

•

•

Software used:

Tiki Wiki CMS Groupware ( http://tiki.org

) Page 128

Tiki Installation Guide – print date: Jun 20, 2011

•

Installed Windows:

•

Installed other software

•

TikiWiki 4.0 Install

•

Select your language: English

•

read the license

•

Review the System Requirements

•

Set the Database Connection

•

Install - A new install will populate the database.

•

Review the Installation

•

Configure General Settings

•

Enter Your Tiki

•

•

Change password enforced

•

Notes from IIS project for Tiki 5

•

•

Issues (install from svn HEAD)

•

TikiWiki 5.0 Beta1 Install

•

Windows IIS Install

•

older version (circa 1.7)

•

Advanced Settings

•

Clean URLs

•

Examples

•

How to Activate Clean URLs

•

Step 1: Activate Input Rewrite Rules on Your Server

•

Web Hosting Service Using Apache

•

Apache Configuration When Managing Own Server

•

Web Servers Other Than Apache

•

Suggested Input Rewrite Rules

•

6.x version

•

Rewrite Rules for MultiTiki using Subdirectories as Symlinks

•

< Click here to view it

•

Step 2: Configure Tiki to Produce Clean URLs

•

Changing Rewrite Rules

•

WARNING: For sites hosted with MediaTemple's (gs) Grid-Service

•

Developer's Corner

•

•

1. Create a separate database for each url.

•

•

2. Configure the server to host multiple Tikis

Tiki Wiki CMS Groupware ( http://tiki.org

) Page 129

Tiki Installation Guide – print date: Jun 20, 2011

•

2.1. Multitiki using domains

•

2.2. Multitiki using subdirectories

•

3. Create the necessary directories within Tiki's main directory.

•

4. Optionally, add .htaccess with rewrite rules

•

5. Other Installation Procedures for Multiple TikiWikis

•

1. MultiTikis using SubDomains

•

1.1. Create subdirectories

•

1.2. Add a single customized local.php for all

•

1.3. Add local.php for each site

•

1.4. Create symlinks for the multitiki to work

•

1.5. Running tiki-install

•

2. MultiTikis in subdirectories (Directory Structure Setup)

•

2.1. Create Subdirectories

•

2.2. Add a single customized local.php for all

•

2.3. Add local.php for each sub-tiki

•

2.4. Create Symlinks

•

2.5. Run tiki-install.php

•

3. Extra: Add .htaccess for all (optional)

•

How to Install Multiple TikiWikis Using Subdomains on Windows XP

•

1. Create a directory in a location outside of Apacheâ€™s root directory.

•

2. Unzip (or decompress) the TikiWiki-3.1.zip file.

•

3. Locate and create a backup of Apacheâ€™s â€œhttpd.confâ€ file.

•

4. Modify the â€œhttpd.confâ€ file

not the backup as described belowâ€¦

•

5. Locate the â€œhostsâ€ file on your Windows XP machine and add your subdomains.

•

6. Locate the â€œhttpd-vhosts.confâ€ file, in the â€œextraâ€ subdirectory at the following location.

•

7. Define your virtual hosts as follows...

•

8. Restart your Apache web server, after you have saved the changes to httpd.conf, hosts, and (possibly) httpd-vhosts.conf.

•

9. Create a local.php file for your TikiWiki-3.1/db directory.

•

10. In the â€œdbâ€ directory of your TikiWiki installation, create a new directory named after each of your subdomains.

•

11. In each of these directories, create a local.php file for each of your subdomains and corresponding databasesâ€¦

•

12. Start the installer for your first domain, by entering

"http://<first_subdomain>.localhost/tiki-install.php" in the address bar.

•

This is important!

•

Do lock the installer until after you have run it for your LAST subdomain.

•

13. Other Procedures for Installing Multiple TikiWiki Instances

Tiki Wiki CMS Groupware ( http://tiki.org

) Page 130

Tiki Installation Guide – print date: Jun 20, 2011

•

•

•

•

•

Advantages of TRIM over MultiTiki

•

Advantages of MultiTiki over TRIM

•

What if I want to share data between instances?

•

•

•

•

•

•

To setup automated updates

•

•

•

•

•

•

•

To setup automated backups

•

make restore

•

make delete

•

make enablewww

•

Rewrite rules are necessary for TRIM Web Administration

•

make viewdb

•

make detect

•

Requirements

•

Shell commands/scripts

•

To restore backups on TRIM (for testing)

•

•

•

•

•

•

•

How to download and use

•

Example

•

To restore backups on TRIM machines

•

An example of creating an instance (where to restore to)

•

Tiki Wiki CMS Groupware ( http://tiki.org

) Page 131

Tiki Installation Guide – print date: Jun 20, 2011

•

Install ImageMagick

•

Install ImageMagick and Libs

•

Install Imagick PECL Module

•

Tikiwiki setting up

•

Graphviz Install

•

Install Graphviz and Libs

•

Testing an installed Graphviz Setup

•

Troubleshooting Hints

•

•

•

•

•

Upgrade your Tiki site

•

1. Determine the version of your current Tiki

•

2. Determine to which version you want to upgrade to

•

3. Fresh install or Install over existing?

•

Fresh install (recommended)

•

Install over existing (NOT recommended for major updates)

•

4. Create a Backup

•

5. Update your files

•

Fresh install

•

Install over existing

•

Updating via SVN

•

6. Check permissions

•

1. tiki-install.php to update your database

•

•

(A) Fresh install

•

(B) Install over existing

•

Fix the encoding issue

•

Either (A) or (B): fix the encoding issue (5.0 or before -> 5.1 or later)

•

1. Force connection to utf-8 in db/local.php

•

2. Convert database and tables to UTF-8

•

3. Convert content from your previous encoding to utf-8

•

Alternative: Upgrading your database through shell

•

2. Post tiki-install.php

•

3. Update the .htaccess file

•

4. Test

•

What to expect as problems

•

Where to look

•

What to do

Tiki Wiki CMS Groupware ( http://tiki.org

) Page 132

Tiki Installation Guide – print date: Jun 20, 2011

•

4.1. Check your content

•

4.2. Check that the features you used to use are still turned on.

•

4.3. Revise potentially unsafe plugin calls and approve or reject them

•

5. Upgrade your Theme

•

Further help?

•

Notes for advanced users

•

symlinks

•