====== Mandant anlegen ======
===== mercaware-Mandant anlegen =====

<note important>Dieser Schritt ist für jeden Mandanten(!) eines Kunden einmal auszuführen</note>

==== Setup vorbereiten ====
Zuerst müssen grundlegende Programme wie Perl und AQBanking installiert werden:

   //CentOS 6
   rpm -Uvh http://mirror.de.leaseweb.net/epel/6/i386/epel-release-6-8.noarch.rpm
   
   //CentOS 7
   rpm -Uvh http://mirror.de.leaseweb.net/epel/7/x86_64/e/epel-release-7-7.noarch.rpm

Das Installationsprogramm **mercaware-2.0.1.4-1.el6.x86_64.rpm** muss zuerst in das Verzeichnis root/packages kopiert werden. Danach kann die rpm-Datei mit folgender Befehlszeile gestartet werden, sofern man im richtigen Verzeichnis steht:

   [root@intranet ~]# yum localinstall packages/mercaware-2.0.1.4-1.el6.x86_64.rpm

Danach kann die Setup-Datei konfiguriert werden:

   vi /usr/sbin/mercaware-setup 

Die Variablen mit den gewünschten Werten definieren. Dabei ist zu beachten, dass ''MERCAWARE_USER'', ''MERCAWARE_PORT'', ''POSTGRESQL_USER'' und ''POSTGRESQL_PORT'' immer die letzten drei numerischen Stellen bei allen vier Werten immer gleich sein müssen (Beispiel für Mandant 018):
   
   MERCAWARE_ETC=/etc/mercaware
   MERCAWARE_OPT=/opt/mercaware
   MERCAWARE_USER=mx018
   MERCAWARE_PORT=50018
   POSTGRESQL_HOST=localhost
   POSTGRESQL_DB=MXDBS
   POSTGRESQL_USER=pg_mx018
   POSTGRESQL_PORT=51018
   
   
   MERCAWARE_VERSION=2.0.1.4
   POSTGRESQL_VERSION=9.3.5

==== Setup ausführen ====

   /usr/sbin/mercaware-setup

==== Lizenz einspielen ====

==== Businesslogik einspielen ====
Mandant stoppen

  mercawarectl stopmxsd mxXXX

mitgelieferte Minimal-Businesslogik zu entfernen

  runuser -l mxXXX -c "cd src; rm -rf mod_base modules.in"

aktuelle Version der Mercaware-Businesslogik aus dem Subversion laden:

  runuser -l mxXXX -c "cd src; svn checkout --username afa https://svn.mercaware.de/mercaware-business-logic/tags/1.X.X ." 
  runuser -l mxXXX -c "cd src; make_modclean && make 2> err"
  runuser -l pg_mxXXX -c "dropdb MXDBS; createdb MXDBS"
  runuser -l mxXXX -c "./src/programs/mercaware-mkdbs; ./src/programs/mercaware-mkdbl"
  runuser -l pg_mxXXX -c "psql MXDBS -c \"ALTER TABLE man ALTER COLUMN rdiffkto DROP NOT NULL; INSERT INTO man (lfd, mdnr, fprec) VALUES (1, 'MANDANT', 2);\""

=== maximale PostgreSQL-Verbindungen  bestimmen ===

Mit dem nachstehenden Befehl, wird der Wert der maximalen PostgreSQL-Verbindungen (YYY) in der Konfigurationsdatei gesetzt:

   sed -e 's/^max_connections = [0-9]*/max_connections = YYY/' -i /opt/mercaware/pg_mxXXX/data/postgresql.conf 


Je parallel möglicher PostgreSQL-Verbindung wird sogenannter Shared Memory reserviert. Es werden mindestens so viele PostgreSQL-Verbindungen wie gleichzeitige angemeldete/lizenzierte Mercaware-Benutzer benötigt. Zusätzlich sollte berücksichtigt werden, dass auch der Mercaware-Webstart kurzzeitig PostgreSQL-Verbindungen benötigt. Auch mögliche PostgreSQL-Verbindungen über ein (lokales) pgAdmin, psql oder das Datenbank-Backup müssen berücksichtigt werden

<note tip>Empfehlenswerter Anhaltspunkt (für YYY) sollte sein:\\ **max_connections = (Gleichzeitige/lizenzierte Mercaware-Benutzer * 2) + 5**</note>

=== Mandant starten ===  
   
   mercawarectl restart mxXXX

=== Perl installieren ===
Perl wird für die Überprüfung der USt.ID-Nr., Abfragen der Währungskurse oder für Schnittstellen benötigt. Sie wird installiert mit folgendem Befehl:
   
   yum install 'perl(HTTP::Request::Common)' 'perl(LWP::UserAgent)' 'perl(XML::Simple)' 

<note important>Dieser Befehl muss nur einmal je Server durchgeführt werden. Da beim SaaS-Server die Installation bereits erfolgte, ist eine Installation nicht mehr nötig.</note>