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.
- download the package named allinone
- create a folder named tine20 in your webservers document root
- 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.
- download the all in one package
- create a folder named tine20 in your webservers document root
- extract the all in one package into the tine20 directory
- 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.
- download the all in one package
- create a folder named tine20 in your webservers document root
- extract the all packages into the tine20 directory
- 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




