== Installing from Binaries ==
[http://build.opensuse.org/project/show?project=home%3Acsa7fff%3Aadei ADEI Project] is hosted at [https://build.opensuse.org SuSe Build System]. You will need to install at least ''adei'' and one of configuration packages ''adei-config-*''. To redirect users from site entrance to ADEI install ''adei-webroot'' as well.

Execute following command to register repository in the !OpenSuSe 11.2 system:
{{{
zypper ar http://download.opensuse.org/repositories/home:/csa7fff:/adei/openSUSE_11.2/home:csa7fff:adei.repo
}}}

Then you can install adei with the following commands:
{{{
 zypper install adei adei-config-default adei-webroot
}}}

And then see the required configuration changes bellow. In order to update synchronize with ADEI repository first and then issue update:
{{{
  zypper refresh home_csa7fff_adei
  zypper update adei
}}}


== Local repositories within FZK ==
 * OpenSuSE 11 using 'smart' packet manager (repository only available within FZK)
{{{
smart channel --add adei type=rpm-md name=adei baseurl="http://ipepdvadei.ka.fzk.de/binaries/suse_11/"
smart update adei
smart install adei <configuration_package> <additional_packages>
}}}

 * OpenSuSE 11.2 using 'zypper' packet manager (repository only available within FZK)
{{{
zypper addrepo http://ipepdvadei.ka.fzk.de/binaries/suse_11.2/ adei
zypper refresh adei
zypper install adei <configuration_package> <additional_packages>
}}}

== Accessing project repository ==
 * Performing initial import
{{{
bzr checkout http://dside.dyndns.org/bzr/adei/trunk/
}}}

 * Updating to the current revision
{{{
bzr update
}}}

== Branches ==
 * Development branch providing [http://extjs.com/products/extjs/ Ext] based user interface (discontinued):
{{{
bzr checkout http://dside.dyndns.org/bzr/adei/ui/
}}}

== Configuration ==
 * Setup Apache, MySQL 5, and PHP 5.2 with all dependencies
  * Apache modules: mod_php, mod_rewrite, mod_proxy, mod_proxy_http
  * PHP modules: zlib, zip, mysql, pdo, odbc (''needs fixes''), json, nls, xml, session, sockets, imagick, simplexml, gettext
  * PHP/PEAR modules: Spreadsheet_Excel_Writer
  * Other applications: microsoft true type fonts, jpgraph
  * MSSQL connectivity: freetds (''needs fixes'')
 * Enable specified apache modules in configuration
  * '''!OpenSuSe''': In ''/etc/sysconfig/apache2'' add '''php5 rewrite proxy mod_proxy_http''' to the list of apache modules (APACHE_MODULES).
 * In Apache configuration: Enable all options and allow configuration overriding by .htaccess files
  * '''!OpenSuSe''': In ''/etc/apache2/default-server.conf'' set '''Options''' and '''!AllowOverride''' options of ''/srv/www/htdocs'' directory to '''All'''.
 * In PHP configuration: Allow short opening tags and disable reporting E_NOTICE conditions. The limits of script execution time and memory usage may be raised as well.
  * '''!OpenSuSe''': In ''/etc/php5/apache2/php.ini'' a '''short_open_tag''' option should be set to '''On'''. Adjust ''max_execution_time'' and ''memory_limit'' options as well if you wish.
 * Disable binary logging in MySQL configuration, otherwise mysql user accessing caching database would need a '''SUPER''' privilege. Read more on the topic in [http://dev.mysql.com/doc/refman/5.1/en/stored-programs-logging.html Binary Logging of Stored Programs] in the MySQL documentation.
  * '''!OpenSuSe''': In ''/etc/my.cnf'' comment lines defining '''log-bin''' and '''binlog_format'''.
 * Install ADEI
  * Create MySQL account with full permissions to manage certain database. Configure this account and the database in ''config.actual.php'' in the root of ADEI installation.
  * Provide required setups under ''setups'' directory in ADEI tree. Set default setup in ''config.actual.php''.