WICE Inhouse: Unterschied zwischen den Versionen

Aus WikiWICE
Wechseln zu: Navigation, Suche
Zeile 82: Zeile 82:
 
=== Hinweise zur Installation des Plugins "XRechnung" in Wice CRM 2020 ab release-9-6 ===
 
=== Hinweise zur Installation des Plugins "XRechnung" in Wice CRM 2020 ab release-9-6 ===
  
'''Es werden Java(SE) und Ghostscript Version 9 (oder höher) benötigt.'''
+
Sie benötigen auf Ihrem Wice-Server zum Betrieb des Plugins Java(SE) und Ghostscript Version 9 (oder höher).
  
 
Wice verwendet zum Erzeugen von XRechnungen das Zugferd-Projekt "Mustang". Sie müssen Mustang jedoch nicht manuell installieren - das zugehörige Mustang-jar-Archiv wird während der Installation des XRechnungs-Plugins automatisch installiert.
 
Wice verwendet zum Erzeugen von XRechnungen das Zugferd-Projekt "Mustang". Sie müssen Mustang jedoch nicht manuell installieren - das zugehörige Mustang-jar-Archiv wird während der Installation des XRechnungs-Plugins automatisch installiert.

Version vom 6. Oktober 2020, 13:51 Uhr

WICE Inhouse

Auf dieser Seite erhalten Sie Antworten zu Ihren Fragen rund um den Betrieb von Wice-Inhouse auf Ihrem eigenen Server bzw. gemieteter Hardware.

Wice-Log-Datei

Es gibt auf dem Wice-Server eine Fehler-Logdatei. Diese Datei kann z.B. mit folgendem Befehl eingesehen werden:

tail -f /home/wice/log/error_log

Treten im laufenden Betrieb von Wice Fehler auf, so sollte immer in diese Logdatei gesehen werden. Dort stehen weitere Hinweise.

Generell gilt beim Betrieb des Wice-Servers: Tritt ein Fehler in Wice auf, so sollte immer zuerst in die Fehler-Logdatei hineingesehen werden. Dies ist der erste Schritt zum Finden der Fehlerursache. Meistens ergibt sich daraus direkt die Lösung des Problems. Näheres entnehmen Sie bitte dem WICE Installation Guide.

Tritt zum Beispiel der folgende Fehler in der Fehler-Logdatei folgendes:

[Wed Aug 24 15:03:13 2011] [error] Can't locate Params/Validate.pm ...

Diese Fehlermeldung bedeutet, dass der Wice-Server die Datei "Params/Validate.pm" nicht finden kann. Die Lösung liegt damit auf der Hand: diese Datei muss nachinstalliert werden.

Wie das Nachinstallieren von Paketen aus Ihrer Linux-, UNIX- oder MacOSX-Distribution funktioniert, entnehmen Sie bitte der Dokumentation Ihres Betriebssystem. Linux-Distributionen halten hierfür verschiedene Tools bereit wie z.B. "yast" (SuSE), "yum" (CentOS, Redhat, Fedora) oder "apt-get" (debian).

Übrigens ist nicht jeder Eintrag, der in die Fehler-Logdatei geschrieben wird, tatsächlich ein Fehler. Teilweise sind es nur Hinweise (z.B: beim Versenden von Emails in bestimmten Wice-Funktionen) oder harmlose Warnungen, die den Betrieb von Wice nicht einschränken und keine Aktion erfordern. Bei der Fehleridentifikation sollten Sie daher immer die Fehler-Logdatei geöffnet haben, während Sie in Wice einen Fehler reproduzieren. Nur, wenn in diesem Augenblick ein Eintrag in die Logdatei hinzukommt, wird es tatsächlich ein Fehler sein.

Wice LDAP-Connector

Der Wice-LDAP-Connector ist Bestandteil von WICE Version 3.4 und höher. Mit Hilfe des frei erhältlichen LDAP-Servers slapd können Sie den Wice-Server um einen LDAP-Dienst erweitern. Der Wice-LDAP-Dienst ermöglicht es, LDAP-basierte Adressclients wie MS Outlook, XPhone oder Mozilla anzubinden. Ist der LDAP-Client (z.B. MS Outlook) für den Zugriff auf den Wice-LDAP-Server konfiguriert, so kann der Client transparent auf den Wice-Adressstamm zugreifen. Der Wice-Server dient somit als Adressverzeichnis.

Mit Hilfe von z.B. XPhone und dem Wice-LDAP-Connector ist auch eine CTI-Lösung ("Computer Telephony Integration") implementierbar. Die integrierte Anrufererkennung greift auf den Wice-Adressstamm zu und über Hotkeys ist auch das Markieren und Anwählen von Telefonnummern aus Wice heraus möglich. Bei weiteren Fragen wenden Sie sich gerne an den Wice-Support unter support@wice.de und wir senden Ihnen den Wice-LDAP-Connector-Guide zu.

Update-Voraussetzung beim Update auf Wice 2015


Achtung.png
Wichtig:

Für ein Update auf Wice 2015 muss mindestens Version 7.5 vorhanden sein, damit auf die aktuelle Version von Wice 2015 upgedatet werden kann. Ältere Server müssen dementsprechend erst auf Wice 7.5 (release-7-5-49 vom 25.5.2011) upgedatet werden und von dort aus dann auf Wice 2015!

Installation eines eigenen SSL-Zertifikats auf Ihrem Server

Bei der Standardinstallation von Wice CRM wird automatisch ein von der Wice GmbH erstelltes uns signiertes SSL-Zertifikat installiert. Sie können natürlich auch ein eigenes Zertifikat von einem anderen Anbieter installieren - dazu befolgen Sie die nachfolgenden Schritte:

Das SSL-Zertifikat muss in Form folgender Dateien auf dem Server abgelegt werden:

/home/wice/etc/server.crt (Zertifikatsdatei)
/home/wice/etc/server.key (Key-Datei)
/home/wice/etc/ca.crt (Zertifikats-Chain-Datei, falls notwendig, hängt vom Typ des Zertifikats ab)

Die vorhandenen server.key und server.crt werden dabei überschrieben.

Nach Ablegen dieser 2 oder 3 Dateien muss ein Wice-Update ganz normal mit dem Wice-Installer durchgeführt werden. Dabei werden die Dateien eingelesen und in die Wice-Konfiguration integriert.

Nach Abschluss des Wice-Updates sollte das neue Zertifkat wirksam sein.

Verwenden von OpenOffice und unoconv

Das WICE-Plugin "Media Assistant" kann ab der Version release-3-6 Dateikonvertierungen mit Hilfe von OpenOffice durchführen. Wenn Sie OpenOffice und unoconv auf Ihrem WICE-Server installieren, steht Ihnen verschiedene Features zur Verwendung von ODT-Dateien in WICE zur Verfügung, z.B.:

    * Anzeige von ODT-Dateien direkt im Browser mit Viren- und Trojanerschutz
    * Konvertierung von ODT-Dateien zu PDF
    * Sammeldruck von gedruckten Mailings auf ODT-Basis

Installieren Sie hierzu die Pakete "openoffice.org-headless" und "unoconv". Ersteres sollte Bestandteil jeder Standard-Linuxdistribution sein. Falls das zweite (unoconv) nicht enthalten sein sollte, können Sie es aus dem Repository rpmforge.net installieren. Damit später keine DNS-Timeouts während der Konvertierung entstehen, muss die Datei /etc/hosts folgende Zeile enthalten:

127.0.0.1 localhost localhost.(none)

Starten Sie unoconv im Listening-Modus (dies können Sie auch in einer Startdatei tun, z.B. /etc/rc.d/rc.local) mit folgendem Befehl:

unoconv --listener &

Installieren Sie das WICE Plugin MediaAssistant in der Version release-3-6 oder höher. Fertig!

Google API-Key zur Kartendarstellung

Um die Kartendarstellung in der Detailansicht einer Firmanadresse nutzen zu können, benötigen Inhouse-Kunden einen eigenen API-Key von Google. Dieser muss in der Administration unter "Weitere Systemeinstellungen" hinterlegt werden. Sie benötigen dazu einen eigenen Google-Account, den man kostenlos bei Google erstellen kann. Eine genaue Anleitung wie Sie diesen Key bei Google erhalten gibt es hier:

https://developers.google.com/maps/documentation/javascript/get-api-key

(Nur der erste Teil der Anleitung ist hier relevant - die weiteren Informationen zur Authentifizierung nicht.)

Wichtig ist, dass der Key mit dem richtigen HTTP referrer verbunden ist, also die URL unter der Ihr Wice-Server erreichbar ist, also z.B. https://crm.meineserverurl.de/*

Hinweise zur Installation des Plugins "XRechnung" in Wice CRM 2020 ab release-9-6

Sie benötigen auf Ihrem Wice-Server zum Betrieb des Plugins Java(SE) und Ghostscript Version 9 (oder höher).

Wice verwendet zum Erzeugen von XRechnungen das Zugferd-Projekt "Mustang". Sie müssen Mustang jedoch nicht manuell installieren - das zugehörige Mustang-jar-Archiv wird während der Installation des XRechnungs-Plugins automatisch installiert. Wichtig ist, dass Sie vor Installation des Plugins überprüfen, ob Java(SE) und Ghostscript bereits auf Ihrem Wice-Server installiert sind. Sie können die installierte Ghostscript-Version mit dem folgenden Befehl an der Kommandozeile des Wice-Servers überprüfen:

gs -v


Manuelle Installation von Ghostscript 9 (nur notwendig in etwas älteren Distributionen):

Falls für die vorhandene Linux-Distribution Ghostscript kleiner als 9 sein sollte, empfehlen wir eine manuelle Ghostscript-Installation, die neben der Standard-Ghostscript-Version im Verzeichnis /usr/local/gs9 residieren kann. Eine De-Installation Ihres Standard-Ghostscripts ist weder notwendig noch empfohlen.

Die Installation kann wie folgt von der Eingabeaufforderung des Wice-Servers durchgeführt werden (die URL zur aktuellen Version finden Sie auf ghostscript.com; schauen Sie nach der Source-Distribution):

wget http://downloads.ghostscript.com/public/ghostscript-9.18.tar.gz tar xzf ghostscript-9.18.tar.gz cd ghostscript-9.18 ./configure --prefix=/usr/local/gs9 make sudo make install

Tragen Sie anschließend den Pfad zum gs-Binary in die Wice-Datenbank ein:

echo "UPDATE mandant SET gs_path='/usr/local/gs9/bin/gs'" | mysql -u root -p wice


Anschließend sollte das Wice-Plugin "XRechnung" installiert werden. Bei der Installation wird noch einmal überprüft, ob Java und Ghostscript vorhanden sind. Nach Aktivieren des Plugins für Ihren Mandanten kann das Plugin in Wice CRM unter Mehr -> XRechnung aufgerufen werden. Beim ersten Aufruf wird automatisch versucht, den Pfad zum iccprofiles-Verzeichnis von Ghostscript zu ermitteln. Sollte das nicht gelingen, müssen Sie dieses Verzeichnis auf dem Server selbst ermitteln und eintragen. Folgender Befehl kann Ihnen dabei helfen:

find /usr -name iccprofiles

Tragen Sie den gefundenen Pfad in das Plugin ein. Die Felder für Ghostscript-Version und gs-Binary werden automatisch bei der Installation eingesetzt. Sollte die falsche (<9) oder keine Ghostscript-Version erkannt werden, müssen Sie Ihre Ghostscript-Installation überprüfen und die Installation des Plugins wiederholen. Diese Werte werden im Plugin nur angezeigt und können nicht verändert werden.

Für weitere Fragen wenden Sie sich bitte an die Wice GmbH - gerne per Email direkt an support@wice.de.