Admins/Install Howto
Installing Tine 2.0 is very easy. Just download the right packages, edit the central configuration file, call setup.php and you are ready for login.
Preparing the database
Create a database for Tine 2.0. On your mysql system execute the following commands(with your own secret password):
# mysql mysql> CREATE DATABASE tine20; mysql> GRANT ALL PRIVILEGES ON tine20.* TO 'tine20'@'localhost' IDENTIFIED BY 'XXXXXXXX';
Editing the configuration file config.inc.php
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 in the tine20 folder on your webserver. We provided a sample config file (config.inc.php.dist) that you can use for your own config.inc.php.
The config.inc.php file has the following format:
<?php return array( # For Developer Modus set: # 'buildtype' => 'DEVELOPMENT',
'database' => array(
'host' => 'localhost',
# 'unix_socket' => '/var/run/mysqld/mysqld.sock',
'dbname' => 'tine20',
'username' => 'tine20',
'password' => '********',
'adapter' => 'pdo_mysql',
'tableprefix' => 'tine20_'
),
'setupuser' => array(
'username' => 'tine20setup',
'password' => 'setup'
),
# 'session.save_path' => '/writeable/path/for/webserver/sessions',
'logger' => array(
'filename' => '/var/www/tine20.log',
'priority' => '7',
'filter' => array(
'user' => 'username to log',
'message' => 'message to log'
)
'active' => 1
),
/*
'login' => array(
'username' => 'tine20admin',
'password' => 'lars'
),
'pdfexport' => array(
'fontpath' => '/var/www/tine20/test/unifont.ttf',
'fontpathbold' => '/var/www/tine20/test/unifont.ttf',
'fontembed' => true
),
'asterisk' => array(
'managerurl' => 'http://your.asterisk.server:8088/asterisk/mxml',
'managerusername' => 'manager',
'managerpassword' => 'password'
)
*/
);
?>
You can add more config values simply be extending the php array. I'll show more config options (for caching, user registration and more) at the bottom of this page.
Call setup.php
After you have prepared the database and the config.inc.php just point your browser to http://yourwebserver/yourtinepath/setup.php. If everything goes well, you will see a bunch of SQL statements and no error message.
For Tine versions > 2009/02
We now have a new shiny setup tool (available at http://yourwebserver/yourtinepath/setup.php) that requires a login. Just use the credentials from the config.inc.php file (section 'setupuser') to login. You are then able to edit the config file and install, uninstall, or update applications. If you don't have a config file at the beginning of the setup process, the setup tool can create one for you.
Login as admin
After running setup.php you can point your browser to http://yourwebserver/yourtinepath 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.
User registration (optional)
Note: the user registration is not operational at the moment (August 2009-11-2)
We added the possibility for new users to register themselves. If this option is enabled (in the config.inc.php, 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.inc.php options (with default values):
'registration' => array(
'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]?
Caching (optional)
If you want to use the caching functionality, you have to add these lines to your config.inc.php:
'caching' => array(
'active' => 1,
'lifetime' => 3600,
'backend' => 'File',
'path' => '/tmp',
),
// memcached options:
// 'backend' => 'Memcached',
// 'host' => 'localhost',
// 'port' => 11211
LDAP authentication
Here is a ldap config setting example (it allows to get users and groups from LDAP):
'authentication' => array(
'backend' => 'ldap',
'ldap' => array(
'host' => 'ldap.host.net',
'username' => "cn=_yourbindcn_",
'password' => '*****',
'bindRequiresDn' => true,
'baseDn' => "_yourbasedn_",
'accountCanonicalForm' => 2
),
),
'accounts' => array(
'backend' => 'ldap',
'ldap' => array(
'host' =>'ldap.host.net',
'username' => "cn=_yourbindcn_",
'password' => '*****',
'bindRequiresDn' => true,
'userDn' => "_youruserdn_",
'groupsDn' => "_yourgroupdn_",
'pwEncType' => 'SHA',
//'useRfc2307bis' => true,
'minUserId' => 10000,
'maxUserId' => 29999,
'minGroupId' => 11000,
'maxGroupId' => 11099,
),
),?>
Felamimail Email default account settings
this is obsolete with Mialena / only working with August or lower versions
'imap' => array ( 'host' => 'mail.server.net', 'user' => 'username', 'password' => 'password', 'port' => 143, 'useAsDefault' => true, 'name' => 'default', 'secure_connection' => 'tls', ),
If you want to use the Tine 2.0 user credentials for the imap/smtp authentication as well, set the Felamimail preference 'User Email Account' to 'true'. In this case you can omit the user/password/useAsDefault options.
Mialena settings
'imap' =>
array (
'host' => 'mail.server.net',
'user' => 'username',
'password' => 'password',
'port' => 143,
'useSystemAccount' => true,
'secure_connection' => 'tls',
),
'smtp' =>
array (
'hostname' => 'mail.server.net',
'username' => 'username',
'password' => 'password',
'ssl' => 'tls',
'port' => 25,
'auth' => 'login',
'domain' => 'mydomain',
),
'themes' => array(
'default' => 0,
'themelist' => array(
0 => array(
'name' =>'TineSkin',
'path' => 'styles/tine20.css',
'useBlueAsBase' => 1,
),
1 => array(
'name' =>'ExtJS Blue',
'path' => 'library/ExtJS/resources/css/xtheme-blue.css',
),
2 => array(
'name' =>'ExtJS Slate',
'path' => 'extjsthemes/xtheme-slate/css/xtheme-slate.css',
'useBlueAsBase' => 1,
),
),
),
IMAP/SMTP Authentication
If you want to use the Tine 2.0 user credentials for the imap/smtp authentication remove user/password from the config.inc.php.
Themes
You need to use the current trunk to get this functionality until there is an official release ...
It's possible to setup an installation wide theme. To add more themes you may setup the array as provided. In Mialena the user has no possibility to change his theme. In later versions it'll be possible to change the theme on user base.
The paramters and their function:
- themes > default - Number of default theme from themelist array
- themes > forceDefault - boolean value to specify if the default theme will be forced (this property is currently not supported, but will be in a later or service release)
- themes > themelist - Array of valid themes
- themes > themelist > ID > name - human readable name of a theme
- themes > themelist > ID > path - path to the main css file of the theme
- themes > themelist > ID > useBlueAsBase - compatibility fix, as there are some themes around which need the default blue extJS theme as base
A lot of themes can be found on one of the following websites (Please have a look on the license ...).
- Free or almost free
- Non free
Tine updates
Have a look at the FAQ: http://www.tine20.org/wiki/index.php/FAQ#How_do_I_update_my_Tine_2.0_installation.3F
Short Video Tutorial for XAMPP & Tine20 on Windows (in German)
http://www.jetzt-ansehen.de/tutorials/xampp_tine20_install.htm
Short Video Tutorial for Tine 2.0 ActiveSync installation (in German)
http://www.jetzt-ansehen.de/tutorials/tine20-activesync-installation.htm
