Portrait Dialogue-Serverkonfiguration
Werbung
Administratorhandbuch für die Integration von Portrait Dialogue 6.1 Version 7.1 © 2016 Pitney Bowes Software Inc. Alle Rechte vorbehalten. Dieses Dokument kann vertrauliche und eigentumsrechtlich geschützte Informationen enthalten, die Eigentum von Pitney Bowes Inc. bzw. seinen Tochter- und Beteiligungsgesellschaften sind. Die Portrait Software, das Portrait Software-Logo und das Portrait-Zeichen der Portrait Software sind Warenzeichen der Portrait Software International Limited und dürfen in keiner Weise ohne die vorherige, ausdrückliche schriftliche Genehmigung von Portrait Software International Limited benutzt oder verwertet werden. Warenzeichen Die Namen von Firmen und Produkten, Marken, Logos und Zeichen, die hier genannt werden, sind möglicherweise Warenzeichen oder eingetragene Warenzeichen ihrer jeweiligen Eigentümer. Portrait Software-Support Sollten sie über den Inhalt dieser Dokumentation hinausgehende Hilfe benötigen, können sie in der Wissensbasis auf unserer Website http://support.portraitsoftware.com nachsehen und den Links zu ihrem Produkt folgen. Sie können auch andere Portrait Miner-Dokumentationen herunterladen. Falls Sie keinen Benutzernamen und kein Kennwort haben oder sie diese vergessen haben sollten, kontaktieren Sie uns über einen der nachstehenden Kanäle. Wenn sie Probleme bei der Nutzung, Installation oder Dokumentation von diesem Produkt feststellen, kontaktieren sie uns bitte auf einem der folgenden Wege: E-Mail: [email protected] Telefon • USA/Kanada 1-800-335-3860 (gebührenfrei) • Übrige Welt +44 800 840 0001 Bei einer Problemmeldung ist es hilfreich, wenn Sie uns Folgendes mitteilen können: • • • • Der Name der Software-Anwendung Die Umstände, unter denen das Problem auftrat Welche Fehlermeldungen Sie gegebenenfalls gesehen haben Die Version der von Ihnen benutzten Software Pitney Bowes Software Inc. February 23, 2016 Inhalt Kapitel 1: Einleitung....................................................................................................5 Zweck....................................................................................................................................6 Wer dieses Buch lesen sollte.............................................................................................6 Verwandte Dokumente........................................................................................................6 Kapitel 2: Miner-Integrationsübersicht.....................................................................7 Miner-Integrationsübersicht...............................................................................................8 Portrait Miner....................................................................................................................8 Portrait Dialogue..............................................................................................................8 Kapitel 3: Installation des Plug-Ins für den Export von Portrait Miner..................9 Installation des Plug-Ins für den Export von Portrait Miner in Portrait Dialogue.......10 Kapitel 4: Portrait Dialogue-Serverkonfiguration...................................................13 Portrait Dialogue-Serverkonfiguration............................................................................14 Kapitel 5: Tests und Fehlerbehebung.....................................................................15 Tests und Fehlerbehebung...............................................................................................16 Kapitel Einleitung In diesem Abschnitt: • Zweck . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .6 • Wer dieses Buch lesen sollte . . . . . . . . . . . . . . . . . . . . . . .6 • Verwandte Dokumente . . . . . . . . . . . . . . . . . . . . . . . . . . . . .6 1 Zweck Zweck Dieses Dokument beschreibt, wie Sie das Plug-In für Portrait Miner und die Webdienstkomponente PAWS installieren können, die den Export von Bewertungen, Listen und Regeln in Portrait Dialogue erleichtert. Wer dieses Buch lesen sollte Systemadministratoren, welche die Integration zwischen Portrait Miner und Portrait Dialogue installieren und verwalten. Verwandte Dokumente Dokument Datenträger (Zip-Datei/DVD) und Ort • Portrait • Portrait Dialogue-Datenträger in: \Documentation\7 - Miner Miner7.1-Integrationsbenutzerhandbuch Integration\ • Portrait • Portrait Dialogue-Datenträger in: \Documentation\1 - Installation Dialogue 5.2-Installationshandbuch & upgrade\ • Portrait • Portrait Dialogue-Datenträger in: \Documentation\ Dialogue 5.2-Versionshinweise Tipp: Alle Dokumente stehen ebenfalls auf der Portrait Software-Support-Website zur Verfügung: http://support.portraitsoftware.com 6 Portrait Miner 7.1 Kapitel Miner-Integrationsübersicht In diesem Abschnitt: • Miner-Integrationsübersicht . . . . . . . . . . . . . . . . . . . . . . . .8 2 Miner-Integrationsübersicht Miner-Integrationsübersicht Portrait Miner ist eine Portrait-Lösung für die Erstellung von Erkenntnissen durch die Analyse von Kundenverhalten. Portrait Dialogue ist eine Kundeninteraktionslösung, die disparate Kundeninteraktionen zur stärkeren Kundenbindung in einen schlüssigen, geschlossenen Dialog über alle Kanäle verwandelt. Die Integration zwischen Portrait Miner und Portrait Dialogue ermöglicht Analyseergebnisse und Erkenntnisse (z. B. bezüglich Zielgruppen und Vorhersageregeln, die im Portrait Miner identifiziert werden) an eine operationale Umgebung weiterzuleiten und direkt in ihr zu verwenden. Dies geschieht wahlweise entweder durch Exportieren einer Liste von Kundenidentifizierern (und optional einer Pro-Kopf-Bewertung) oder einer analytischen Regelbeschreibung. Portrait Miner Folgende Systemvoraussetzungen gelten für die Installation der Plug-in-Komponenten zur Unterstützung des Exports von Bewertungen/Listen von Portrait Miner zu einer Portrait Dialogue-Installation. • Portrait Miner 7.1-Server/Desktop ist installiert. • Ein Befehlszeilen-SQL-Client ist auf dem Server/Desktop installiert, auf dem das Plug-in installiert werden soll (z. B. sqlcmd für SQL Server oder sqlplus für Oracle) und der von allen Benutzern des Portrait Miner Servers/Desktops ausgeführt werden kann. • Der Portrait Miner Server/Desktop und der Portrait Dialogue-Datenbankserver haben Zugriff auf ein gemeinsames Dateisystem, für das sowohl der Benutzer, der den Export durchführt, als auch der Benutzer des Datenbanksystems lese- und schreibberechtigt ist. • Der Portrait Dialogue-Datenbankserver ist mit einem Netzwerk verbunden, das für alle Benutzer des Portrait Miner-Servers/Desktops sichtbar ist. • Der Benutzer, der die Installation vornimmt, hat Zugriff auf einen einfachen Texteditor auf dem Installationscomputer des Portrait Miner-Servers/Desktops. Portrait Dialogue Für eine erfolgreiche Benutzung des Plug-Ins sind folgende Voraussetzungen zu erfüllen. • Portrait Dialogue 5.2 ist installiert. • Portrait Dialogue läuft auf einer Datenbank, die nicht zwischen Groß- und Kleinschreibung unterscheidet. • Der Portrait Dialogue-Datenbankserver und der Portrait Miner-Server/Desktop haben Zugriff auf ein gemeinsames Dateisystem, für das sowohl der Benutzer, der den Export durchführt, als auch der Benutzer des Datenbanksystems lese- und schreibberechtigt ist. • Damit alle exportierten Kategorien genutzt werden können, muss die Systemdatengruppe „Kategorien“ in der Domäne vorhanden sein, zu der die Kategorien exportiert werden sollen. • Hinweis: Der SQL Server 2000 wird nicht mehr als Datenbank für die Exportfunktion unterstützt. 8 Portrait Miner 7.1 Kapitel Installation des Plug-Ins für den Export von Portrait Miner In diesem Abschnitt: • Installation des Plug-Ins für den Export von Portrait Miner in Portrait Dialogue . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .10 3 Installation des Plug-Ins für den Export von Portrait Miner in Portrait Dialogue Installation des Plug-Ins für den Export von Portrait Miner in Portrait Dialogue Die Erweiterungskomponenten für den Portrait Miner Server werden in einem Verzeichnis auf der Versions-DVD bereitgestellt. Um die Komponenten zu installieren, gehen Sie wie folgt vor: • Kopieren Sie den Ordner „millionhandshakes“ auf der Versions-DVD (\5.2\5.2.x.xx\Miner Integration\Miner7.1\Portrait Miner Export to Portrait Dialogue Plug-in 1.3A\) in das Verzeichnis „ext“ der Installation von Portrait Miner. Das heißt, wenn sich die Installation von Portrait Miner 7.1 unter C:\PortraitMiner_7.1 befindet, kopieren Sie den Komponentenordner in C:\PortraitMiner_7.1\ext. • Navigieren Sie zum neuen „millionhandshakes“-Komponentenverzeichnis (C:\PortraitMiner_7.1\ext\millionhandshakes), öffnen Sie die Datei javastartup.xml, und legen Sie die Werte für Ihre Installation für folgende Eigenschaften fest: Eigenschaft Beschreibung MH_DATABASE_TYPE Der Datenbanktyp, auf dem Portrait Dialogue installiert ist (muss entweder MSSQL2005 oder ORACLE sein). Hinweis: Für einen SQL Server 2008 Datenbankserver müssen Sie MSSQL2005 eingeben. MH_INSTANCE Die Portrait Dialogue-Instanz (das heißt der Name der im Visual Dialogue-Anmeldefenster erscheinende Datenbankname), in die diese Installation exportieren wird. MH_USERNAME Der Benutzername für Portrait Dialogue (das heißt der Benutzername, der zum Anmelden beim Visual Dialogue verwendet wird), unter dem alle Exporte durchgeführt werden. MH_PASSWORD Das Kennwort für den oben genannten Benutzer (das heißt das Kennwort zum Anmelden beim Visual Dialogue). MH_WH_BASE_URL Dies ist die Basis-URL für die Portrait Dialogue-Webservices, und zwar typischerweise: http://<SERVERNAME>/MHDialogServerAPI/ Hinweis: Die URL muss mit einem Schrägstrich '/' enden. MH_EXPORT_DIR Der Pfad zu einem Verzeichnis, in das diese Installation ihre Daten exportieren wird. Typischerweise ist das ein Verzeichnis im Default Share des Portrait Dialogue sein, z. B. ein UNC-Pfad wie \\<MHServerName>\MH\Imports es kann auch ein 10 Portrait Miner 7.1 Kapitel 3: Installation des Plug-Ins für den Export von Portrait Miner Eigenschaft Beschreibung zugeordnetes Laufwerk sein. Wichtig ist, dass dieser Speicherort sowohl für den Portrait Miner-Server als auch den Portrait Dialogue-Datenbankserver erkennbar ist (daher wird ein UNC-Pfad empfohlen). MH_IMPORT_DIR Das ist der Pfad zum Verzeichnis, das der Portrait Dialogue-Datenbankserver prüft, um die Dateien zu lokalisieren, welche die zu importierenden Daten enthalten. Im Allgemeinen wird das derselbe UNC-Ort sein wie MH_EXPORT_DIR. Es kann aber ein anderer Name sein, solange beide auf denselben physikalischen Ort auf dem Laufwerk verweisen. Hinweis: Bei Portrait Dialogue-Systemen, die Oracle nutzen, wird dieser Wert nicht verwendet und der Exportort muss einem definierten Oracle-Verzeichnis mit dem Namen MH_IMPORT zugewiesen werden. MH_IMPORT_SQL_CMD Die SQL Client-Befehlszeile für SQL Server 2005/2008: sqlcmd /U <user> /P <passwd> /S <server> /i ~FILE~ Hinweis: Es kann sein, dass Sie die /d database angeben müssen, wenn die Portrait Dialogue-Datenbank nicht Ihre Standardeinstellung ist. Hinweis: Falls Sie die Windows-Authentifizierung für die Verbindung zur Datenbank nutzen, lassen Sie die Optionen /U und /P weg. Die SQL Client-Befehlszeile für Oracle: sqlplus <user>/<passwd>@<server>@~FILE~ Hinweis: ~FILE~ muss in der Befehlszeile vorkommen (wird durch den Namen einer dynamisch generierten SQL-Datei beim Exportvorgang ersetzt). Hinweis: Das Befehlszeilen-Tool muss sich auf dem Pfad des Benutzers befinden, der den Export durchführt, oder aber es muss der volle Pfad zur Befehlszeileneingabe verwendet werden. Der Benutzer muss auch die entsprechenden Systemberechtigungen haben, um das Tool verwenden zu können. Hinweis: Die Benutzerkonten, die in der Befehlszeile erscheinen, müssen über die entsprechenden Zugriffsberechtigungen verfügen. So muss der Administratorhandbuch für die Integration von Portrait Dialogue 6.1 11 Installation des Plug-Ins für den Export von Portrait Miner in Portrait Dialogue Eigenschaft Beschreibung Benutzer z. B. für den SQL Server bulkadmin-Rechte haben. • Bei einer Eingabeaufforderung ist sicherzustellen, dass sich das Portrait Miner-Klassenverzeichnis auf dem Pfad befindet. Dies erfolgt durch folgende Skriptzeile: <PMHOME>/config/setpath-qs7.1.bat • Dann weiter wie folgt, um DBC verfügbar zu machen: qsextadmin –enable millionhandshakes • Starten Sie den Portrait Miner-Server (Quadstone System Server qs7.1) über „Systemsteuerung > Verwaltung > Dienste“ neu. 12 Portrait Miner 7.1 Kapitel Portrait Dialogue-Serverkonfiguration In diesem Abschnitt: • Portrait Dialogue-Serverkonfiguration . . . . . . . . . . . . . . .14 4 Portrait Dialogue-Serverkonfiguration Portrait Dialogue-Serverkonfiguration Erstellen Sie auf dem Datenbankserver ein gemeinsames Verzeichnis, das für die Benutzer von Portrait Miner und alle, die lese-/schreibberechtigt sind, ersichtlich ist (wie in den Portrait Miner Installationsanleitungen für MH_IMPORT_DIR beschrieben). Dieses Verzeichnis dient dem Empfang der vom Portrait Miner exportierten Bewertungen und Listen. Hinweis: Auf einem Oracle Server muss dieses Verzeichnis auch beim Oracle-Datenbankserver angemeldet werden, und zwar mit folgendem SQL-Befehl: CREATE OR REPLACE DIRECTORY MH_IMPORT AS “[import directory]”; GRANT READ, WRITE ON DIRECTORY MH_IMPORT TO [db user in the SQL command]; Der obige Befehl unterstützt nicht die Verwendung von UNC-Pfadnamen. 14 Portrait Miner 7.1 Kapitel Tests und Fehlerbehebung In diesem Abschnitt: • Tests und Fehlerbehebung . . . . . . . . . . . . . . . . . . . . . . . .16 5 Tests und Fehlerbehebung Tests und Fehlerbehebung So testen Sie die Installation: • Starten Sie Decision Studio. • Laden Sie einen Fokus, und öffnen Sie Table Viewer. Die Symbole „Score nach Portrait Dialogue exportieren“ und „Liste nach Portrait Dialogue exportieren“ sollten jetzt in der Symbolleiste sichtbar sein. • Durch Anklicken des Symbols „Liste exportieren“ sollte der Dialog „Exportieren“ mit den verfügbaren Domänen in der Dropdown-Liste erscheinen. Wenn Kategorien in der gewählten Domäne definiert werden, muss die Optionsschaltfläche „Update“ aktiviert sein und bei deren Betätigung die Liste der Kategorien in der entsprechenden Dropdown-Liste angezeigt werden. Erstellen Sie zum Testen der neuen Kategorie im Portrait Dialogue eine neue Auswahl mithilfe der gerade exportierten Kategorie. Wenn die Installation nicht korrekt funktioniert, überprüfen Sie zuerst die Protokolldateien in <PMHOME>/shared/logs (insbesondere das Decision Studio-Sitzungsprotokoll), wobei <PMHOME> das Verzeichnis ist, das die Portrait Miner-Installation enthält. Hat das Klicken auf das Symbol „Liste exportieren“ keinerlei Effekt, überprüfen Sie, ob der Dienst Portrait Miner qs7.1 auf dem Server neu gestartet wurde. 16 Portrait Miner 7.1
