WebshopApi: trigram indices und Hinweiss darauf in der UPGRADE Datei.

[kivitendo-erp.git] / doc / UPGRADE

diff --git a/doc/UPGRADE b/doc/UPGRADE
index f5567ec..806016b 100644 (file)
--- a/doc/UPGRADE
+++ b/doc/UPGRADE
@@ -4,17 +4,42 @@ Wichtige Hinweise zum Upgrade von älteren Versionen
 
 ** BITTE FERTIGEN SIE VOR DEM UPGRADE EIN BACKUP IHRER DATENBANK(EN) AN! **
 
-Upgrade auf v3.4.x Unstable
+Upgrade auf v3.5.1
+
+* Neue Perlabhängigkeiten
+
+  * LWP::Authen::Digest für WebshopApi
+  * LWP::UserAgent für WebshopApi
+
+* Verwendung der WebshopApi
+
+  * Bestehende Datenbanken, die die WebshopApi verwenden sollen benötigen die
+    Postgres Erweiterung pg_trgm
+    Diese kann wie folgt installiert werden:
+
+    su - postgres
+    psql <DATENBANK>
+    CREATE EXTENSION IF NOT EXISTS pg_trgm;
+    \q
+
+    Wenn die Extension installiert ist können in den beiden Dateien
+    - sql/Pg-upgrade2/trigram_indices_webshop.sql
+    - sql/Pg-upgrade2/trigram_indices.sql
+    das ignore auf 0 gesetzt werden und beide Dateien werden dann beim Anmelden eingespielt.
+    Die Trigramindices sind ein Performancegewinn bei größeren Datenbanken
+
+Upgrade auf v3.5.0
 ===========================
 
-* Die Tabelle "files" ist hinzugekommen. Diese wird von der Dateiverwaltung
-  verwendet. Zum Erkennen der Dateiinhalte wird das Paket File::MimeInfo::Magic
-  benötigt.
+* Neue Perl Abhängigkeiten:
+
+  * File::MimeInfo - für den Dateiupload
+  * Sys::CPU
+  * Thread::Pool::Simple
 
-* Die PDF-Generierung ist erweitert. Beim Massendruck können auch Leerseiten
-  eingebaut werden, z.B. falls zweiseitg ausgedruckt wird. Statt die Anzahl
-  Seiten per Ghostscript zu ermitteln wird dazu "pdfinfo" genutzt.
-  Das muß installiert sein. Der Script "installation_check.pl" prüft dies.
+* Neue externe Abhängigkeiten:
+
+  * pdfinfo
 
 * In der Rechte-Tabelle auth.master_rights wurden alle Positionswerte mit 100
   multipliziert, um Lücken für neue Rechte zu schaffen.
@@ -24,25 +49,6 @@ Upgrade auf v3.4.x Unstable
   "0". Falls Kunden per CSV-Import importiert werden muß dieses Feld in der
   CSV-Datei ebenfalls umbenannt werden.
 
-* Es wird jetzt Postgres 9.1 vorausgesetzt um GIN Indizes zu verwenden.
-  Da hier verschiedene Bedingungen auf dem Zielsystem erfüllt werden
-  müssen, ist dies mit dem may_fail Flag gekennzeichnet.
-  Wer sicher sein will, dass die Optimierung bei ihm aktiviert ist,
-  sollte das Skript direkt in der Datenbank ausführen.
-  $ cd /var/www/kivitendo-erp/
-  $ psql -U postgres -h 127.0.0.1 meinekividb
-  # \i sql/Pg-upgrade2/trigram_indices.sql
-
-  Details:
-  Die Erweiterung befindet sich in dem contrib Bereich von postgres,
-  bei den meisten Distributionen muss dieses Paket extra installiert werden
-  (s.a. https://www.postgresql.org/docs/9.1/static/contrib.html).
-
-  Bei debian/ubuntu befindet sich dies bspw. in postgresql-contrib
-  i.d.R. verlangt die Erweiterung superuser Rechte, daher
-  muss für die Erstellung der Erweiterung bspw. mit dem Benutzer postgres
-  ausgeführt werden, Details s.a. https://www.postgresql.org/docs/9.1/static/pgtrgm.html
-
 * Für das neue Feature Lieferantenbriefe ist die Standardvorlage für Briefe
   (letter.tex) angepasst worden. Statt letter.customer muss der Adressat jetzt
   aus letter.custoemr_vendor erzeugt werden.