MobileFirst Analytics Receiver Server Installationshandbuch
improve this page | report issueÜbersicht
MobileFirst Analytics Receiver Server wird als Java-EE-Standard-WAR-Datei implementiert und geliefert. Der Server kann daher in einem der folgenden unterstützten Anwendungsserver installiert werden: WebSphere Application Server, WebSphere Application Server Liberty oder Apache Tomcat (nur WAR-Dateien).
Fahren Sie mit folgenden Abschnitten fort:
- Systemvoraussetzungen
- Hinweise zur Kapazität
- MobileFirst Analytics Receiver in WebSphere Application Server Liberty installieren
- MobileFirst Analytics Receiver in Tomcat installieren
- MobileFirst Analytics Receiver in WebSphere Application Server installieren
- MobileFirst Analytics Receiver mit Ant-Tasks installieren
Systemvoraussetzungen
Betriebssysteme
- CentOS/RHEL 6.x/7.x
- Oracle Enterprise Linux 6/7 nur mit RHEL Kernel
- Ubuntu 12.04/14.04
- SLES 11/12
- OpenSuSE 13.2
- Windows Server 2012/R2
- Debian 7
JVM
- Oracle JVM 1.7u55+
- Oracle JVM 1.8u20+
- IcedTea OpenJDK 1.7.0.55+
Hardware
- Arbeitsspeicher: Mehr Arbeitsspeicher ist besser, aber nicht mehr als 64 GB pro Knoten. 32 GB und 16 GB sind auch akzeptabel. Bei Weniger als 8 GB sind viele kleine Knoten im Cluster erforderlich. Mehr als 64 GB sind verschwenderisch und hinsichtlich der Art, wie Java den Arbeitsspeicher für Zeiger verwendet, auch problematisch.
- Platte: Verwenden Sie nach Möglichkeit SSDs oder, wenn SSDs nicht infrage kommen, schnell drehende herkömmliche Platten in einer RAID-0-Konfiguration.
- CPU: Die zentrale Verarbeitungseinheit ist tendenziell der Leistungsengpass. Verwenden Sie Systeme mit 2 bis 8 Kernen.
- Netz: Wenn Sie Ihren Cluster horizontal skalieren müssen, benötigen Sie ein schnelles und zuverlässiges Rechenzentrum mit unterstützten Geschwindigkeiten von 1 bis 10 Gigabit (im Gigabit-Ethernet-Netz GbE).
Hardwarekonfiguration
- Ordnen Sie der JVM reichlich Kapazität (10.000) für die Skalierung der speicherinternen Warteschlange zu (was einem Xmx-Mindestwert von 6 GB entspricht).
- Wenn Sie BSD und Linux verwenden, müssen Sie den E/A-Scheduler Ihres Betriebssystems auf deadline oder noop einstellen und nicht auf cfq.
Hinweise zur Kapazität
Die Frage zur Kapazität wird am häufigsten gestellt. Wie viel Arbeitsspeicher ist erforderlich und wie viel Plattenspeicher? Wie viele Knoten werden benötigt? Die Antwort auf alle diese Fragen ist stets subjektiv.
Der IBM MobileFirst Analytics Receiver erfordert keinen Plattenspeicher, weil er lediglich Protokolle von mobilen Anwendungen empfängt und an den Analyseserver weiterleitet. Es werden keine Ereignisdaten gespeichert.
MobileFirst Analytics Receiver in WebSphere Application Server Liberty installieren
Stellen Sie sicher, dass die WAR-Datei für den MobileFirst Analytics Receiver vorhanden ist. Weitere Informationen zu den Installationsartefakten
finden Sie unter MobileFirst Server in einem Anwendungsserver installieren. Die Datei analytics-receiver.war befindet sich im Ornder <MF-Server-Installationsverzeichnis>\analyticsreceiver
. Weitere Informationen zum Herunterladen und Installieren von
WebSphere Application Server Liberty finden Sie
im Artikel About WebSphere Liberty auf
IBM developerWorks.
-
Erstellen Sie einen Server. Führen Sie dazu in Ihrem Ordner
./wlp/bin
den folgenden Befehl aus:./server create <Servername>
-
Installieren Sie die Features, indem Sie from Ihrem Ordner
./bin
den folgenden Befehl ausführen:./featureManager install jsp-2.2 ssl-1.0 appSecurity-1.0 localConnector-1.0
- Fügen Sie die Datei analytics-receiver.war zum Ordner
./usr/servers/<Servername>/apps
Ihres Liberty-Servers hinzu. -
Ersetzen Sie den Inhalt des Tags **
** durch die Datei `./usr/servers/ /server.xml` mit folgendem Inhalt: <featureManager> <feature>jsp-2.2</feature> <feature>ssl-1.0</feature> <feature>appSecurity-1.0</feature> <feature>localConnector-1.0</feature> </featureManager>
-
Konfigurieren Sie analytics-receiver.war in der Datei
server.xml
als Anwendung mit rollenbasierter Sicherheit. Im folgenden Beispiel wird eine fest codierte Basisbenutzerregistry erstellt und jeder der Analyserollen ein Benutzer zugewiesen.<application id="analytics-receiver" name="analytics-receiver" location="analytics-receiver.war" type="war"> <application-bnd> <security-role name="analytics_administrator"> <user name="admin"/> </security-role> <security-role name="analytics_infrastructure"> <user name="infrastructure"/> </security-role> <security-role name="analytics_support"> <user name="support"/> </security-role> <security-role name="analytics_developer"> <user name="developer"/> </security-role> <security-role name="analytics_business"> <user name="business"/> </security-role> </application-bnd> </application> <basicRegistry id="worklight" realm="worklightRealm"> <user name="business" password="demo"/> <user name="developer" password="demo"/> <user name="support" password="demo"/> <user name="infrastructure" password="demo"/> <user name="admin" password="admin"/> </basicRegistry>
Weitere Informationen zum Konfigurieren von Benutzerregistrytypen wie LDAP finden Sie in unter Benutzerregistry für das Liberty-Profil konfigurieren in der Produktdokumentation zu WebSphere Application Server.
-
Starten Sie den Liberty-Server. Führen Sie dazu in Ihrem Ordner bin den folgenden Befehl aus:
./server start <Servername>
-
Überprüfen Sie den Status, indem Sie die URL health aufrufen.
http://localhost:9080/analytics-receiver/rest/data/health
Weitere Informationen zur Verwaltung von WebSphere Application Server Liberty finden Sie unter Liberty-Profil über die Befehlszeile verwalten in der Produktdokumentation zu WebSphere Application Server.
MobileFirst Analytics Receiver in Tomcat installieren
Stellen Sie sicher, dass die WAR-Dateien
für MobileFirst Analytics Receiver vorhanden sind. Weitere Informationen zu den Installationsartefakten
finden Sie unter MobileFirst Server in einem Anwendungsserver installieren. Die Datei analytics-receiver.war befindet sich im Ornder <MF-Server-Installationsverzeichnis>\analyticsreceiver
. Weitere Informationen zum Herunterladen und Installieren von Tomcat finden Sie auf der Webseite von Apache Tomcat. Sie müssen die Version herunterladen, die Java 7 oder eine aktuellere Java-Version
unterstützt. Welche Tomcat-Version Java 7 unterstützt erfahren Sie unter
Apache Tomcat
Versions.
- Fügen Sie die Datei analytics-receiver.war zum Tomcat-Ordner
webapps
hinzu. -
Entfernen Sie in der Datei
conf/server.xml
das Kommentarzeichen vor dem folgenden Abschnitt, der in einem neu heruntergeladenen Tomcat-Archiv auf Kommentar gesetzt ist.<Valve className="org.apache.catalina.authenticator.SingleSignOn"/>
-
Deklarieren Sie die beiden WAR-Dateien in der Datei
conf/server.xml
und definieren Sie eine Benutzerregistry.<Context docBase ="analytics-receiver-service" path ="/analytics-receiver"></Context> <Realm className ="org.apache.catalina.realm.MemoryRealm"/>
Das MemoryRealm erkennt die in der Datei
conf/tomcat-users.xml
definierten Benutzer. Informationen zu weiteren verfügbaren Optionen finden Sie unter Apache Tomcat Realm Configuration HOW-TO. - Fügen Sie die folgenden Abschnitte zur Datei
conf/tomcat-users.xml
hinzu, um ein MemoryRealm zu konfigurieren.-
Fügen Sie die Sicherheitsrollen hinzu.
<role rolename="analytics_administrator"/> <role rolename="analytics_infrastructure"/> <role rolename="analytics_support"/> <role rolename="analytics_developer"/> <role rolename="analytics_business"/>
-
Fügen Sie ein paar Benutzer mit den gewünschten Rollen hinzu.
<user name="admin" password="admin" roles="analytics_administrator"/> <user name="support" password="demo" roles="analytics_support"/> <user name="business" password="demo" roles="analytics_business"/> <user name="developer" password="demo" roles="analytics_developer"/> <user name="infrastructure" password="demo" roles="analytics_infrastructure"/>
-
Starten Sie Ihren Tomcat Server und überprüfen Sie den Service, indem Sie die URL health aufrufen.
http://localhost:8080/analytics-receiver/rest/data/health
Weitere Informationen zum Starten des Tomcat-Servers finden Sie auf der offiziellen Tomcat-Site, z. B. unter Apache Tomcat 7 für Tomcat 7.0.
-
MobileFirst Analytics Receiver in WebSphere Application Server installieren
Die ersten Installationsschritte zur Beschaffung der Installationsartefakte (JAR- und EAR-Dateien) sind
unter MobileFirst Server in einem Anwendungsserver installieren beschrieben. Die Datei analytics-receiver.war befindet sich im Ornder <MF-Server-Installationsverzeichnis>\analyticsreceiver
.
In den folgenden Schritten ist beschrieben, wie die Analytics-EAR-Datei in WebSphere Application Server installiert und ausgeführt wird. Wenn Sie die einzelnen WAR-Dateien in WebSphere Application Server installieren, führen Sie nach der Implementierung nur die Schritte 2 bis 7 für die WAR-Datei analytics-receiver aus.
-
Implementieren Sie die WAR-Datei im Anwendungsserver, aber starten Sie sie nicht. Informationen zur Installation einer EAR-Datei in WebSphere Application Server finden Sie unter Unternehmensanwendungen über die Konsole installieren in der Produktdokumentation zu WebSphere Application Server.
-
Wählen Sie in der Liste Unternehmensanwendungen den Eintrag MobileFirst Analytics Receiver aus.
-
Klicken Sie auf Laden von Klassen und Erkennung von Dateiaktualisierungen.
-
Setzen Sie die Reihenfolge für das Laden von Klassen auf Übergeordnete zuletzt.
-
Klicken Sie auf Zuordnung von Sicherheitsrollen zu Benutzern/Gruppen, um den Benutzer mit Administratorberechtigung zuzuordnen.
-
Klicken Sie auf Module verwalten.
-
Wählen Sie das Modul analytics-receiver aus und ändern Sie die Reihenfolge der Klassenlader in übergeordnete zuletzt.
- Aktivieren Sie wie folgt die Verwaltungssicherheit und die Anwendungssicherheit
in der Administrationskonsole von WebSphere Application Server:
- Melden Sie sich bei der Administrationskonsole von WebSphere Application Server an.
- Im Menü Sicherheit > Globale Sicherheit müssen die Einträge Verwaltungssicherheit aktivieren und Anwendungssicherheit aktivieren ausgewählt sein.
Hinweis: Die Anwendungssicherheit kann erst aktiviert werden, wenn die Verwaltungssicherheit aktiviert ist.
- Klicken Sie auf OK und speichern Sie die Änderungen.
- Führen Sie die folgenden Schritte aus, um den Zugriff auf den Analytics Service über die Swagger-Dokumentation zu ermöglichen:
- Klicken Sie auf Server > Servertypen > WebSphere-Anwendungsserver und wählen Sie in der Serverliste den Server aus, in dem der Analytics Service implementiert ist.
- Klicken Sie unter Serverinfrastruktur auf Java und navigieren Sie zu Java- und Prozessverwaltung > Prozessdefinition > Java Virtual Machine > Angepasste Eigenschaften.
- Definieren Sie die folgende angepasste Eigenschaft:
Eigenschaftsname: com.ibm.ws.classloader.strict
Wert: true
- Definieren Sie die folgende angepasste Eigenschaft:
- Starten Sie die Anwendung MobileFirst Analytics Receiver und prüfen Sie, ob die URL health im Browser aufgerufen werden kann:
http://<Hostname>:<Port>/analytics-receiver/rest/data/health
.
MobileFirst Analytics Receiver mit Ant-Tasks installieren
Stellen Sie sicher, dass die erforderliche WAR- und Konfigurationsdatei vorliegt: analytics-receiver.war. Weitere Informationen zu den Installationsartefakten
finden Sie unter MobileFirst Server in einem Anwendungsserver installieren. Die Datei analytics-receiver.war finden Sie unter MobileFirst_Platform_Server\AnalyticsReceiver
.
Sie müssen die Ant-Task auf dem Computer ausführen, auf dem der Anwendungsserver oder der Network Deployment Manager für WebSphere Application Server Network Deployment installiert ist. Wenn Sie die Ant-Task
von einem Computer aus starten möchten, auf dem
MobileFirst Server nicht
installiert ist, müssen Sie die Datei \<MF-Server-Installationsverzeichnis\>/MobileFirstServer/mfp-ant-deployer.jar
auf diesen Computer kopieren.
Hinweis: MF-Server-Installationsverzeichnis steht hier für das Verzeichnis, indem Sie MobileFirst Server installiert haben.
- Bearbeiten Sie das Ant-Script, das Sie später für die
Implementierung der WAR-Dateien von
MobileFirst Analytics Receiver
verwenden werden.
- Sehen Sie sich die Beispielkonfigurationsdateien unter Beispielkonfigurationsdateien für MobileFirst Analytics Receiver an.
- Ersetzen Sie die Platzhalterwerte durch die Eigenschaften am Anfang der Datei.
Hinweis: Wenn Sie in den Werten der Ant-XML-Scripts die folgenden Sonderzeichen verwenden, müssen Sie sie mit Escapezeichen angeben:
- Das Dollarzeichen ($) muss mit $$ angegeben werden, sofern Sie mit der Syntax ${variable}, die im Abschnitt Properties der Veröffentlichung “Apache Ant Manual” beschrieben ist, nicht explizit auf eine Ant-Variable verweisen möchten.
- Das Et-Zeichen (&) muss mit & angegeben werden, sofern Sie nicht explizit auf eine XML-Entität verweisen möchten.
- Anführungszeichen (“) müssen mit " angegeben werden, es sei denn, sie werden in einer Zeichenfolge verwendet, die in Hochkommata gesetzt ist.
- Führen Sie den folgenden Befehl aus, um die WAR-Datei zu implementieren:
ant -f configure-appServer-analytics-receiver.xml install
Sie finden den Ant-Befehl unter
MF-Server-Installationsverzeichnis/shortcuts
. Auf dem Server wird ein Knoten mit dem MobileFirst Analytics Receiver installiert. Bei Verwendung von WebSphere Application Server Network Deployment erfolgt die Installation in jedem Member eines Clusters. - Speichern Sie die Ant-Datei, damit sie Ihnen später für die Anwendung eines Fixpacks oder für ein Upgrade zur Verfügung steht. Wenn Sie die Kennwörter nicht speichern möchten, können Sie sie durch
************
(12 Sterne) ersetzen und eine interaktive Aufforderung zur Kennworteingabe verwenden.
Inclusive terminology note: The Mobile First Platform team is making changes to support the IBM® initiative to replace racially biased and other discriminatory language in our code and content with more inclusive language. While IBM values the use of inclusive language, terms that are outside of IBM's direct influence are sometimes required for the sake of maintaining user understanding. As other industry leaders join IBM in embracing the use of inclusive language, IBM will continue to update the documentation to reflect those changes.