projekt kivitendo

* Manuelle Installation des Programmpaketes:: Installationsort, Berechtigungen

@menu

* Betriebssystem:: Unterstützte Betriebsysteme und Hinweise für ältere Systeme

* Pakete:: Benötigte Software und Perlpakete sowie deren Quellen

@end menu

@node Betriebssystem

@section Betriebssystem

Lx-Office ist für Linux konzipiert, und sollte auf jedem unixoiden

Betriebssystem zum Laufen zu kriegen sein. Getestet ist diese Version im

speziellen auf Debian und Ubuntu, grundsätzlich wurde bei der Auswahl der

Pakete aber darauf Rücksicht genommen, dass es ohne große Probleme auf den

derzeit aktuellen verbreiteten Distributionen läuft.

Anfang 2011 sind das folgende Systeme:

@itemize

@item

Ubuntu 8.04 LTS Hardy Heron

@item

Ubuntu 9.10 Karmic Koala

@item

Ubuntu 10.04 Lucid Lynx

@item

Ubuntu 10.10 Maverick Meerkat

@item

Debian 5.0 Lenny

@item

Debian 6.0 Squeeze

@item

openSUSE 11.2

@item

openSUSE 11.3

@item

SuSE Linux Enterprice Server 11

@item

Fedora 13

@item

Fedora 14

@end itemize

Für die debianoiden Betriebssysteme existiert ein .deb, das deutlich einfacher

zu installieren ist.

Ubuntu 8.04 LTS hat zusätzlich die Schwierigkeit, dass die Module im Archiv

recht alt sind, und das viele der benötigten Module nicht einfach zu

installieren sind. Dafür sollte es kurz nach dem Release ein eigenes .deb

geben.

Alternativ dazu kann die normale Installation durchgeführt werden

(@pxref{Manuelle Installation des Programmpaketes}), wenn vorher ein

Kompatibilitätspaket installiert wird, das die fehlenden Pakete bereitstellt.

Das Paket ist auf @uref{https://sourceforge.net/projects/lx-office/files/Lx-Office%20ERP/2.6.2/, Sourceforge} unter dem Namen @code{lx-erp-perl-libs-compat-v2.tar.gz} hinterlegt.

Zur Installation das Paket in das entpackte Lx-Office Verzeichnis entpacken:

@code{tar xzf lx-erp-perl-libs-compat-v2.tar.gz /path/to/lx-office/}

Danach sollte der Installationscheck (@pxref{Pakete}) die enthaltenen Pakete erkennen.

@node Pakete

@section Pakete

Zusätzlich benötigt Lx-Office die folgenden Perl-Pakete, die nicht Bestandteil

einer Standard-Perl-Installation sind:

@node Manuelle Installation des Programmpaketes

@chapter Manuelle Installation des Programmpaketes

Dieses Verzeichnis, wie auch das komplette @code{users}-Verzeichnis, muss vom

Webserver beschreibbar sein. Dieses wurde bereits erledigt

(@pxref{Manuelle Installation des Programmpaketes}), kann aber erneut überprüft

werden, wenn die Konvertierung nach PDF fehlschlägt.

  2.1 Betriebssystem

  2.2 Pakete

3 Manuelle Installation des Programmpaketes

2.1 Betriebssystem

==================

Lx-Office ist für Linux konzipiert, und sollte auf jedem unixoiden

Betriebssystem zum Laufen zu kriegen sein. Getestet ist diese Version im

speziellen auf Debian und Ubuntu, grundsätzlich wurde bei der Auswahl

der Pakete aber darauf Rücksicht genommen, dass es ohne große Probleme

auf den derzeit aktuellen verbreiteten Distributionen läuft.

   Anfang 2011 sind das folgende Systeme:

   * Ubuntu 8.04 LTS Hardy Heron

   * Ubuntu 9.10 Karmic Koala

   * Ubuntu 10.04 Lucid Lynx

   * Ubuntu 10.10 Maverick Meerkat

   * Debian 5.0 Lenny

   * Debian 6.0 Squeeze

   * openSUSE 11.2

   * openSUSE 11.3

   * SuSE Linux Enterprice Server 11

   * Fedora 13

   * Fedora 14

   Für die debianoiden Betriebssysteme existiert ein .deb, das deutlich

einfacher zu installieren ist.

   Ubuntu 8.04 LTS hat zusätzlich die Schwierigkeit, dass die Module im

Archiv recht alt sind, und das viele der benötigten Module nicht

einfach zu installieren sind. Dafür sollte es kurz nach dem Release ein

eigenes .deb geben.

   Alternativ dazu kann die normale Installation durchgeführt werden

(*note Manuelle Installation des Programmpaketes::), wenn vorher ein

Kompatibilitätspaket installiert wird, das die fehlenden Pakete

bereitstellt.  Das Paket ist auf Sourceforge

(https://sourceforge.net/projects/lx-office/files/Lx-Office%20ERP/2.6.2/)

unter dem Namen `lx-erp-perl-libs-compat-v2.tar.gz' hinterlegt.

   Zur Installation das Paket in das entpackte Lx-Office Verzeichnis

entpacken:

   `tar xzf lx-erp-perl-libs-compat-v2.tar.gz /path/to/lx-office/'

   Danach sollte der Installationscheck (*note Pakete::) die

enthaltenen Pakete erkennen.

2.2 Pakete

==========

3 Manuelle Installation des Programmpaketes

*******************************************

vom Webserver beschreibbar sein. Dieses wurde bereits erledigt (*note

Manuelle Installation des Programmpaketes::), kann aber erneut überprüft

<link rel="prev" href="Manuelle-Installation-des-Programmpaketes.html#Manuelle-Installation-des-Programmpaketes" title="Manuelle Installation des Programmpaketes">

voriges:&nbsp;<a rel="previous" accesskey="p" href="Manuelle-Installation-des-Programmpaketes.html#Manuelle-Installation-des-Programmpaketes">Manuelle Installation des Programmpaketes</a>,

<link rel="next" href="Manuelle-Installation-des-Programmpaketes.html#Manuelle-Installation-des-Programmpaketes" title="Manuelle Installation des Programmpaketes">

n&auml;chstes:&nbsp;<a rel="next" accesskey="n" href="Manuelle-Installation-des-Programmpaketes.html#Manuelle-Installation-des-Programmpaketes">Manuelle Installation des Programmpaketes</a>,

<ul class="menu">

<li><a accesskey="1" href="Betriebssystem.html#Betriebssystem">Betriebssystem</a>:  Unterstützte Betriebsysteme und Hinweise für ältere Systeme

<li><a accesskey="2" href="Pakete.html#Pakete">Pakete</a>:  Benötigte Software und Perlpakete sowie deren Quellen

</body></html>

<html lang="en">

<head>

<title>Betriebssystem - Lx-Office Installationsanleitung</title>

<meta http-equiv="Content-Type" content="text/html; charset=utf-8">

<meta name="description" content="Lx-Office Installationsanleitung">

<meta name="generator" content="makeinfo 4.11">

<link title="Top" rel="start" href="index.html#Top">

<link rel="up" href="Ben_00c3_00b6tigte-Software-und-Pakete.html#Ben_00c3_00b6tigte-Software-und-Pakete" title="Benötigte Software und Pakete">

<link rel="next" href="Pakete.html#Pakete" title="Pakete">

<link href="http://www.gnu.org/software/texinfo/" rel="generator-home" title="Texinfo Homepage">

<meta http-equiv="Content-Style-Type" content="text/css">

<style type="text/css"><!--

  pre.display { font-family:inherit }

  pre.format  { font-family:inherit }

  pre.smalldisplay { font-family:inherit; font-size:smaller }

  pre.smallformat  { font-family:inherit; font-size:smaller }

  pre.smallexample { font-size:smaller }

  pre.smalllisp    { font-size:smaller }

  span.sc    { font-variant:small-caps }

  span.roman { font-family:serif; font-weight:normal; } 

  span.sansserif { font-family:sans-serif; font-weight:normal; } 

--></style>

</head>

<body>

<div class="node">

<p>

<a name="Betriebssystem"></a>

n&auml;chstes:&nbsp;<a rel="next" accesskey="n" href="Pakete.html#Pakete">Pakete</a>,

aufw&auml;rts:&nbsp;<a rel="up" accesskey="u" href="Ben_00c3_00b6tigte-Software-und-Pakete.html#Ben_00c3_00b6tigte-Software-und-Pakete">Benötigte Software und Pakete</a>

<hr>

</div>

<h3 class="section">2.1 Betriebssystem</h3>

<p>Lx-Office ist für Linux konzipiert, und sollte auf jedem unixoiden

Betriebssystem zum Laufen zu kriegen sein. Getestet ist diese Version im

speziellen auf Debian und Ubuntu, grundsätzlich wurde bei der Auswahl der

Pakete aber darauf Rücksicht genommen, dass es ohne große Probleme auf den

derzeit aktuellen verbreiteten Distributionen läuft.

   <p>Anfang 2011 sind das folgende Systeme:

     <ul>

<li>Ubuntu 8.04 LTS Hardy Heron

<li>Ubuntu 9.10 Karmic Koala

<li>Ubuntu 10.04 Lucid Lynx

<li>Ubuntu 10.10 Maverick Meerkat

<li>Debian 5.0 Lenny

<li>Debian 6.0 Squeeze

<li>openSUSE 11.2

<li>openSUSE 11.3

<li>SuSE Linux Enterprice Server 11

<li>Fedora 13

<li>Fedora 14

</ul>

   <p>Für die debianoiden Betriebssysteme existiert ein .deb, das deutlich einfacher

zu installieren ist.

   <p>Ubuntu 8.04 LTS hat zusätzlich die Schwierigkeit, dass die Module im Archiv

recht alt sind, und das viele der benötigten Module nicht einfach zu

installieren sind. Dafür sollte es kurz nach dem Release ein eigenes .deb

geben.

   <p>Alternativ dazu kann die normale Installation durchgeführt werden

(siehe <a href="Manuelle-Installation-des-Programmpaketes.html#Manuelle-Installation-des-Programmpaketes">Manuelle Installation des Programmpaketes</a>), wenn vorher ein

Kompatibilitätspaket installiert wird, das die fehlenden Pakete bereitstellt. 

Das Paket ist auf <a href="https://sourceforge.net/projects/lx-office/files/Lx-Office%20ERP/2.6.2/">Sourceforge</a> unter dem Namen <code>lx-erp-perl-libs-compat-v2.tar.gz</code> hinterlegt.

   <p>Zur Installation das Paket in das entpackte Lx-Office Verzeichnis entpacken:

   <p><code>tar xzf lx-erp-perl-libs-compat-v2.tar.gz /path/to/lx-office/</code>

   <p>Danach sollte der Installationscheck (siehe <a href="Pakete.html#Pakete">Pakete</a>) die enthaltenen Pakete erkennen.

   </body></html>

<html lang="en">

<head>

<title>Manuelle Installation des Programmpaketes - Lx-Office Installationsanleitung</title>

<meta http-equiv="Content-Type" content="text/html; charset=utf-8">

<meta name="description" content="Lx-Office Installationsanleitung">

<meta name="generator" content="makeinfo 4.11">

<link title="Top" rel="start" href="index.html#Top">

<link rel="prev" href="Ben_00c3_00b6tigte-Software-und-Pakete.html#Ben_00c3_00b6tigte-Software-und-Pakete" title="Benötigte Software und Pakete">

<link rel="next" href="Anpassung-der-PostgreSQL_002dKonfiguration.html#Anpassung-der-PostgreSQL_002dKonfiguration" title="Anpassung der PostgreSQL-Konfiguration">

<link href="http://www.gnu.org/software/texinfo/" rel="generator-home" title="Texinfo Homepage">

<meta http-equiv="Content-Style-Type" content="text/css">

<style type="text/css"><!--

  pre.display { font-family:inherit }

  pre.format  { font-family:inherit }

  pre.smalldisplay { font-family:inherit; font-size:smaller }

  pre.smallformat  { font-family:inherit; font-size:smaller }

  pre.smallexample { font-size:smaller }

  pre.smalllisp    { font-size:smaller }

  span.sc    { font-variant:small-caps }

  span.roman { font-family:serif; font-weight:normal; } 

  span.sansserif { font-family:sans-serif; font-weight:normal; } 

--></style>

</head>

<body>

<div class="node">

<p>

<a name="Manuelle-Installation-des-Programmpaketes"></a>

n&auml;chstes:&nbsp;<a rel="next" accesskey="n" href="Anpassung-der-PostgreSQL_002dKonfiguration.html#Anpassung-der-PostgreSQL_002dKonfiguration">Anpassung der PostgreSQL-Konfiguration</a>,

voriges:&nbsp;<a rel="previous" accesskey="p" href="Ben_00c3_00b6tigte-Software-und-Pakete.html#Ben_00c3_00b6tigte-Software-und-Pakete">Benötigte Software und Pakete</a>,

aufw&auml;rts:&nbsp;<a rel="up" accesskey="u" href="index.html#Top">Top</a>

<hr>

</div>

<h2 class="chapter">3 Manuelle Installation des Programmpaketes</h2>

<p>Die Lx-Office ERP Installationsdatei (lxoffice-erp-2.6.2.tgz) wird im

Dokumentenverzeichnis des Webservers (z.B. <code>/var/www/html/</code>,

<code>/srv/www/htdocs</code> oder <code>/var/www/</code>) entpackt:

   <p><code>cd /var/www

<br>

tar xvzf lxoffice-erp-2.6.2.tgz</code>

   <p>Verändern Sie evtl. noch den Namen des Verzeichnisses mit

   <p><code>mv lxoffice-erp/ lx-erp/</code>

   <p>Alternativ können Sie auch einen Alias in der Webserverkonfiguration

benutzen, um auf das tatsächliche Installationsverzeichnis zu

verweisen.

   <p>Die Verzeichnisse <code>users</code>, <code>spool</code> und <code>webdav</code> müssen

für den Benutzer beschreibbar sein, unter dem der Webserver läuft. Die

restlichen Dateien müssen für diesen Benutzer lesbar sein. Der

Benutzername ist bei verschiedenen Distributionen unterschiedlich

(z.B. bei Debian/Ubuntu <code>www-data</code>, bei Fedora core <code>apache</code>

oder bei OpenSuSE <code>wwwrun</code>).

   <p>Der folgende Befehl ändert den Besitzer für die oben genannten

Verzeichnisse auf einem Debian/Ubuntu-System:

   <p><code>chown -R www-data lx-office-erp/users lx-office-erp/spool lx-office-erp/webdav</code>

   <p>Weiterhin muss der Webserver-Benutzer im Verzeichnis <code>templates</code> Verzeichnisse für

jeden neuen Benutzer, der in lx-office angelegt wird, anlegen dürfen:

   <p><code>chgrp www-data lx-office-erp/templates; chmod g+w lx-office-erp/templates</code>

<!--  -->

   </body></html>

   <p>Dieses Verzeichnis, wie auch das komplette <code>users</code>-Verzeichnis, muss vom

Webserver beschreibbar sein. Dieses wurde bereits erledigt

(siehe <a href="Manuelle-Installation-des-Programmpaketes.html#Manuelle-Installation-des-Programmpaketes">Manuelle Installation des Programmpaketes</a>), kann aber erneut überprüft

werden, wenn die Konvertierung nach PDF fehlschlägt.

<html lang="en">

<head>

<title>Pakete - Lx-Office Installationsanleitung</title>

<meta http-equiv="Content-Type" content="text/html; charset=utf-8">

<meta name="description" content="Lx-Office Installationsanleitung">

<meta name="generator" content="makeinfo 4.11">

<link title="Top" rel="start" href="index.html#Top">

<link rel="up" href="Ben_00c3_00b6tigte-Software-und-Pakete.html#Ben_00c3_00b6tigte-Software-und-Pakete" title="Benötigte Software und Pakete">

<link rel="prev" href="Betriebssystem.html#Betriebssystem" title="Betriebssystem">

<link href="http://www.gnu.org/software/texinfo/" rel="generator-home" title="Texinfo Homepage">

<meta http-equiv="Content-Style-Type" content="text/css">

<style type="text/css"><!--

  pre.display { font-family:inherit }

  pre.format  { font-family:inherit }

  pre.smalldisplay { font-family:inherit; font-size:smaller }

  pre.smallformat  { font-family:inherit; font-size:smaller }

  pre.smallexample { font-size:smaller }

  pre.smalllisp    { font-size:smaller }

  span.sc    { font-variant:small-caps }

  span.roman { font-family:serif; font-weight:normal; } 

  span.sansserif { font-family:sans-serif; font-weight:normal; } 

--></style>

</head>

<body>

<div class="node">

<p>

<a name="Pakete"></a>

voriges:&nbsp;<a rel="previous" accesskey="p" href="Betriebssystem.html#Betriebssystem">Betriebssystem</a>,

aufw&auml;rts:&nbsp;<a rel="up" accesskey="u" href="Ben_00c3_00b6tigte-Software-und-Pakete.html#Ben_00c3_00b6tigte-Software-und-Pakete">Benötigte Software und Pakete</a>

<hr>

</div>

<h3 class="section">2.2 Pakete</h3>

<p>Zum Betrieb von Lx-Office werden zwingend ein Webserver (meist Apache)

und ein Datenbankserver (PostgreSQL, mindestens v8.2) benötigt.

   <p>Zusätzlich benötigt Lx-Office die folgenden Perl-Pakete, die nicht Bestandteil

einer Standard-Perl-Installation sind:

     <ul>

<li>parent

<li>Archive::Zip

<li>Class::Accessor

<li>CGI::Ajax

<li>DateTime

<li>DBI

<li>DBD::Pg

<li>Email::Address

<li>List::MoreUtils

<li>PDF::API2

<li>Rose::Object

<li>Rose::DB

<li>Rose::DB::Object

<li>Template

<li>Text::CSV_XS

<li>Text::Iconv

<li>URI

<li>XML::Writer

<li>YAML

</ul>

   <p>Gegenüber Version 2.6.0 sind zu dieser Liste 2 Pakete hinzugekommen, <code>URI</code>

und <code>XML::Writer</code> sind notwendig. Ohne startet Lx-Office nicht.

   <p>Gegenüber Version 2.6.1 sind <code>parent</code>, <code>DateTime</code>,

<code>Rose::Object</code>, <code>Rose::DB</code> und <code>Rose::DB::Object</code> neu

hinzugekommen. <code>IO::Wrap</code> wurde entfernt.

   <p><code>Email::Address</code> und <code>List::MoreUtils</code> sind schon länger feste

Abhängigkeiten, wurden aber bisher mit Lx-Office mitgeliefert.  Beide sind auch

in 2.6.1 weiterhin mit ausgeliefert, wurden in einer zukünftigen Version aber

aus dem Paket entfernt werden. Es wird empfohlen diese Module zusammen mit den

anderen als Bibliotheken zu installieren.

   <p><code>CGI::Ajax</code> ist nach wie vor in einer modifizierten Version mitgeliefert

und braucht nicht nachinstalliert werden.

   <p>Die zu installierenden Pakete können in den verschiedenen Distributionen unterschiedlich heißen.

   <p>Für Debian oder Ubuntu benötigen Sie diese Pakete:

   <p><code>apache2 postgresql libparent-perl libarchive-zip-perl libclass-accessor-perl libdatetime-perl libdbi-perl libdbd-pg-perl libpg-perl libemail-address-perl liblist-moreutils-perl libpdf-api2-perl librose-object-perl librose-db-perl librose-db-object-perl libtemplate-perl libtext-csv-xs-perl libtext-iconv-perl liburi-perl libxml-writer-perl libyaml-perl</code>

   <p>Für Fedora Core benötigen Sie diese Pakete:

   <p><code>httpd postgresql-server perl-parent perl-Class-Accessor perl-DateTime perl-DBI perl-DBD-Pg perl-Email-Address perl-List-MoreUtils perl-PDF-API2 perl-Rose-Object perl-Rose-DB perl-Rose-DB-Object perl-Template-Toolkit perl-Text-CSV_XS perl-Text-Iconv perl-URI perl-XML-Writer perl-YAML</code>

   <p>Für OpenSuSE benötigen Sie diese Pakete:

   <p><code>apache2 postgresql-server perl-Archive-Zip perl-Class-Accessor perl-DateTime perl-DBI perl-DBD-Pg perl-MailTools perl-List-MoreUtils perl-PDF-API2 perl-Template-Toolkit perl-Text-CSV_XS perl-Text-Iconv perl-URI perl-XML-Writer perl-YAML</code>

   <p>Bei openSuSE 11 ist <code>parent</code> bereits enthalten, und braucht nicht nachinstalliert werden. Die <code>Rose::*</code> Pakete sind derzeit nicht für SuSE gepackt, und müssen anderweitig nachinstalliert werden.

   <p>Lx-Office enthält ein Script, mit dem überprüft werden kann, ob alle

benötigten Perl-Module installiert sind. Der Aufruf lautet wie folgt:

   <p><code>./scripts/installation_check.pl</code>

<!--  -->

   </body></html>

<ul>

<li><a href="Betriebssystem.html#Betriebssystem">2.1 Betriebssystem</a>

<li><a href="Pakete.html#Pakete">2.2 Pakete</a>

</li></ul>

<li><a name="toc_Manuelle-Installation-des-Programmpaketes" href="Manuelle-Installation-des-Programmpaketes.html#Manuelle-Installation-des-Programmpaketes">3 Manuelle Installation des Programmpaketes</a>

<li><a accesskey="3" href="Manuelle-Installation-des-Programmpaketes.html#Manuelle-Installation-des-Programmpaketes">Manuelle Installation des Programmpaketes</a>:  Installationsort, Berechtigungen