Tine2.0
Kieler Linux und Open Source Tage

Admins/Install Howto

Installing Tine 2.0 is very easy. Just download the right package, edit config.init, call setup.php and you are ready to login in.

Contents

[edit] Downloading Tine 2.0

We are providing 3 different ways to install Tine 2.0. Just grab the right one from our download page.

[edit] The all in one package

First you can download the all in one package. This package contains our source code, the Zend Framework and ExtJS(the JavaScript framework). If you don't like to bother how to configure your webserver, just download this package.

  1. download the package named allinone
  2. create a folder named tine20 in your webservers document root
  3. extract the allinone package into the tine20 directory

[edit] The package without Zend Framework

If you have the latest Zend Framework(1.5.2 currently) installed on your webserver already, you can also download the package named withoutzf. This package contains all the all in one packages contains, except the Zend Framework.

  1. download the all in one package
  2. create a folder named tine20 in your webservers document root
  3. extract the all in one package into the tine20 directory
  4. make sure that the Zend Framework is in your PHP include path

[edit] Multiple packages

If you like to have more control about what to install, you can also download all packages separate. You need to download the tinebase packages, the ExtJS archive and the Zend Framework Package if needed.

  1. download the all in one package
  2. create a folder named tine20 in your webservers document root
  3. extract the all packages into the tine20 directory
  4. make sure that the Zend Framework is in your PHP include path

[edit] preparing the database

Create a database for Tine 2.0.

[edit] editing the configuration file config.ini

Currently we are using the Zend Framework class Zend_Config_Ini, to read the different configuration parameters (for example the database access settings) from the configuration file. This file must be placed above the document root of your webserver. If your document root is at

/var/www/htdocs

then you need to place the config.ini file into

/var/www/config.ini

This way we can ensure, that this file is not directly accessible through the webserver from the outside.

The config.ini file has the following format:

[database]
; the hostname of the database server
host = hostname

; the name of the database
dbname = databasename

; the username used to authenticate against the database
username = databaseusername

; the password used to authenticate against the database
password = yourSecretPasswort

; optional table prefix. defaults to tine20_
;tableprefix = tine20_

;[logger]
;filename = /var/log/tine20.log
;priority = 7
 
;[mail]
;smtpserver = mail.yourserver
;ssl = tls
;port = 25

[authentication]
backend = sql

[accounts]
backend = sql


[edit] call setup.php

After you have prepared the database and the config.ini just point your browser to http://yourwebserver/tine20/setup.php. If everything goes well, you will see a bunch of SQL statements and no error message.

[edit] login as admin

After running setup.php you can point your browser to http://yourwebserver/tine20/ and log into Tine 2.0 using the username "tine20admin" and the password "lars". Later we will improve the setup process to allow you to specify the initial username and password.

[edit] user registration

We added the possiblity for new users to register themselves. If this option is enabled (in the config.ini, more on this later), a new button appears in the login dialog. If you click on this button ("Register"), you have to type in your first- and lastname, email address and username. The dialog will suggest a username, based on the given first- and lastname.

At the end of the registration process an email will be send to the user. In this email he will find his username and password for the tine20 login screen. If the expire option is set (greater than 0), the user has to activate his account by clicking on the link in the email.

Here are the relevant config.ini options (with default values):

[registration]
active = 0
expires = 0
accountPrimaryGroup = Users
accountStatus = enabled
emailValidation = zend
  • active -> is user registration enabled?
  • expires -> 0: account never expires, greater than 0: hours till account is deactivated (it will be enabled again when the email activation is done)
  • accountPrimaryGroup -> primary group name for the new account
  • accountStatus -> enabled/disabled
  • emailValidation -> zend/none/[regexp]?

[edit] google map integration

In order to use the googlemap integration in the Tine 2.0 addressbook, you need to add a valid google api key (http://code.google.com/apis/maps/signup.html) to your config.ini file. This is the key for localhost:

[addressbook]
googleKey = ABQIAAAAJDLv3q8BFBryRorw-851MRT2yXp_ZAY8_ufC3CFXhHIE1NvwkxTyuslsNlFqyphYqv1PCUD8WrZA2A

[edit] caching

If you want to use the caching functionality you hve to add these lines to your config.ini:

[caching]
active = 1
lifetime = 3600
; file backend options
backend = File
path = /tmp
; memcached options
;backend = Memcached
;host = localhost
;port = 11211