MobileFirst Server für Bluemix mit Scripts für Liberty for Java einrichten

improve this page | report issue

Übersicht

Folgen Sie den nachstehenden Anweisungen, um eine MobileFirst-Server-Instanz in einer Liberty-for-Java-Laufzeit für Bluemix zu konfigurieren. (Instanzen von MobileFirst Analytics können nur in IBM Containern ausgeführt werden.) Gehen Sie dazu die folgenden Schritte durch:

  • Statten Sie Ihren Host-Computer mit den erforderlichen Tools aus (Cloud-Foundry-CLI).
  • Richten Sie Ihr Bluemix-Konto ein.
  • Erstellen Sie einen MobileFirst Server und übertragen Sie ihn als Cloud-Foundry-Anwendung in Bluemix.

Abschließend werden Sie Ihre mobilen Apps registrieren und Ihre Adapter implementieren.

Hinweise:

  • Das Windows-Betriebssystem wird derzeit nicht für die Ausführung dieser Scripts unterstützt.
  • Die MobileFirst-Server-Konfigurationstools können nicht für die Implementierung in Bluemix genutzt werden.

Fahren Sie mit folgenden Abschnitten fort:

Konto in Bluemix registrieren

Falls Sie noch kein Konto haben, öffnen Sie die Bluemix-Website und klicken Sie auf Kostenloses Konto erstellen oder auf Anmeldung. Sie müssen das Registrierungsformular ausfüllen, bevor Sie mit dem nächsten Schritt fortfahren können.

Bluemix-Dashboard

Nachdem Sie sich bei Bluemix angemeldet haben, wird das Bluemix-Dashboard angezeigt, das Ihnen einen Überblick über den aktiven Bluemix-Bereich gibt. Standardmäßig hat dieser Arbeitsbereich den Namen “dev”. Bei Bedarf können Sie mehrere Arbeitsbereiche erstellen.

Hostmaschine einrichten

Für die Verwaltung der Bluemix-Cloud-Foundry-App müssen Sie die Cloud-Foundry-CLI installieren.
Die Scripts können Sie mit der Terminal.app unter macOS oder einer Linux-Bash-Shell ausführen.

Installieren Sie die Cloud-Foundry-CLI.

Archiv ibm-mfpf-container-8.0.0.0 herunterladen

Wenn Sie die Mobile Foundation in Liberty on Java einrichten möchten, müssen Sie zunächst ein Dateilayout erstellen, das später per Push-Operation in Bluemix übertragen wird.
Folgen Sie den Anweisungen auf dieser Seite, um das Archiv mit MobileFirst Server 8.0 für IBM Container (ZIP-Datei) herunterzuladen (suchen Sie nach CNBL0EN).

Die Archivdatei enthält die Dateien für die Erstellung eines Dateilayouts (dependencies und mfpf-libs), die Dateien für die Erstellung und Implementierung eines Containers mit MobileFirst Analytics (mfpf-analytics) und Dateien zum Konfigurieren einer MobileFirst-Server-Cloud-Foundry-App (mfpf-server-libertyapp).

Dateisystemstruktur der Archivdatei

Ordner 'dependencies'

Enthält die Laufzeit der Mobile Foundation und IBM Java JRE 8

Ordner 'mfpf-libs'

Enthält die Bibliotheken für die MobileFirst-Produktkomponenten und die CLI

Ordner 'mfpf-server-libertyapp'

  • Ordner scripts: Dieser Ordner enthält den Ordner args mit einer Reihe von Konfigurationsdateien. Er enthält außerdem die Scripts für die Anmeldung bei Blumix, die Erstellung einer MobileFirst-Foundation-App für die Push-Übertragung in Bluemix und die Ausführung in Bluemix. Sie können diese Scripts interaktiv ausführen oder die Konfigurationsdateien wie nachfolgend erläutert für die Ausführung der Scripts vorkonfigurieren. Anders als bei den anpassbaren Dateien args/*.properties dürfen Sie in diesem Ordner keine Elemente modifizieren. Verwenden Sie das Befehlszeilenargument -h oder --help, um einen Hilfetext zur Scriptsyntax abzurufen (z. B. Scriptname.sh --help).
  • Ordner usr:
    • Ordner config: Für MobileFirst Server verwendete Serverkonfigurationsfragmente (Keystore, Servereigenschaften, Benutzerregistry)
    • keystore.xml: Konfiguration des Repositorys mit Sicherheitszertifikaten für die SSL-Verschlüsselung. Im Ordner ./usr/security muss auf die aufgelisteten Dateien verwiesen werden.
    • mfpfproperties.xml - Konfigurationseigenschaften für MobileFirst Server. Informieren Sie sich anhand der folgenden Dokumentationsabschnitte über die unterstützten Eigenschaften:
    • registry.xml: Benutzerregistrykonfiguration. Als Standardkonfiguration wird eine auf XML basierende Basisbenutzerregistrykonfiguration (basicRegistry) bereitgestellt. Sie können Namen und Kennwörter für basicRegistry konfigurieren oder ldapRegistry konfigurieren.
  • Ordner env: Enthält die Umgebungseigenschaften für die Serverinitialisierung (server.env) sowie angepasste JVM-Optionen (jvm.options).
  • Ordner security: Wird verwendet, um die Keystore-Datei, die Truststore-Datei und die LTPA-Schlüsseldatei (ltpa.keys) zu speichern.

MobileFirst Server und MobileFirst Application Center einrichten

Sie können die Scripts interaktiv ausführen oder die Konfigurationsdateien verwenden. Ein guter Ausgangspunkt ist die einmalige interaktive Ausführung der Scripts, wobei auch die Argumente erfasst werden (recorded-args). Später können Sie die Dateien mit den Argumenten verwenden, um die Scripts in einem nicht interkativen Modus auszuführen.

Hinweis: Kennwörter werden nicht aufgezeichnet. Sie müssen die Kennwörter manuell zu den Dateien mit Argumenten hinzufügen.

  • Verwendung der Konfigurationsdateien: Führen Sie die Scripts aus und übergeben Sie die entsprechende Konfigurationsdatei als Argument.
  • Interaktiv: Führen Sie die Scripts ohne Argumente aus.

Wenn Sie sich entschließen, die Scripts interaktiv auszuführen, können Sie die Konfiguration übergehen. Wir empfehlen Ihnen jedoch, sich wenigstens mit den Argumenten, die angegeben werden müssen, zu beschäftigen.

MobileFirst Application Center

Hinweis: Sie können Installationsprogramme und Datenbanktools aus den lokalen Installationsordnern des MobileFirst Application Center (installer und tools) herunterladen.

Der Ordner args enthält Konfigurationsdateien mit den Argumenten, die zum Ausführen der Scripts erforderlich sind. Die leeren Schablonendateien und eine Erläuterung der Argumente finden Sie im Ordner args oder nach einer interaktiven Ausführung der Scripts im Ordner recorded-args. Es handelt sich um folgende Dateien:

initenv.properties

Diese Datei enhält Eigenschaften zum Ausführen der Umgebungsinitialisierung.

prepareappcenterdbs.properties

Das MobileFirst Application Center erfordert eine externe dashDB-Enterprise-Transactional-Datenbankinstanz (einen mit "OLTP" oder "Transactional" bezeichneten Plan).
Hinweis: Die Implementierung der dashDB-Enterprise-Transactional-Pläne erfolgt sofort, wenn die Pläne mit "pay as you go" gekennzeichnet sind. Vergewissern Sie sich, dass Sie einen passenden Plan ausgewählt haben, z. B. Enterprise for Transactions High Availability 2.8.500 (Pay per use).

Wenn Sie Ihre dashDB-Instanz eingerichtet haben, geben Sie die erforderlichen Argumente an.

prepareappcenter.properties

Diese Datei wird für das Script prepareappcenter.sh verwendet. Sie erstellt das Application-Center-Dateilayout und überträgt es per Push-Operation als Cloud-Foundry-App in Bluemix.

startappcenter.properties

Diese Datei konfiguriert die Laufzeitattribute des Servers und startet den Server. Es wird dringend empfohlen, für die hohe Verfügbarkeit mindestens 1024 MB (SERVER_MEM=1024) und 3 Knoten (INSTANCES=3) zu verwenden.

Die folgenden Anweisungen demonstrieren die Ausführung der Scripts unter Verwendung der Konfigurationsdateien. Eine Liste mit Befehlszeilenargumenten, die Sie für die Ausführung in einem nicht interaktiven Modus auswählen sollten, wird ebenfalls bereitgestellt.

  1. initenv.sh – Anmeldung bei Bluemix
    Führen Sie das Script initenv.sh für die Anmeldung bei Bluemix aus. Führen Sie das Script für die Organisation und den Bereich aus, an die Ihr dashDB-Service gebunden ist:
    ./initenv.sh args/initenv.properties
    Sie können die Parameter auch in der Befehlszeile übergeben.
    initenv.sh --user Bluemix-Benutzer-ID --password Bluemix-Kennwort --org Bluemix-Organisationsname --space Bluemix-Bereichsname
    Wenn Sie sich über alle unterstützten Parameter und ihre Dokumentation informieren möchten, füren Sie die Option "help" aus.
    ./initenv.sh --help
  2. prepareappcenterdbs.sh - Erstellung der MobileFirst-Application-Center-Datenbank
    Das Script prepareappcenterdbs.sh wird verwendet, um Ihr MobileFirst Application Center mit dem dashDB-Datenbankservice oder einem zugänglichen DB2-Datenbankserver zu konfigurieren. Die DB2-Option kommt insbesondere infrage, wenn Sie Bluemix lokal in dem Rechenzentrum ausführen, in dem der DB2-Server installiert ist. Wenn Sie den dashDB-Service verwenden, muss die Instanz des dashDB-Service in der Organisation und dem Bereich verfügbar sein, bei denen Sie sich in Schritt 1 angemeldet haben. Führen Sie Folgendes aus:
    ./prepareappcenterdbs.sh args/prepareappcenterdbs.properties
    Sie können die Parameter auch in der Befehlszeile übergeben.
    prepareappcenterdbs.sh --acdb MFPAppCenterDashDBService
    Wenn Sie sich über alle unterstützten Parameter und ihre Dokumentation informieren möchten, füren Sie die Option "help" aus.
    ./prepareappcenterdbs.sh --help
  3. initenv.sh (optional) – Anmeldung bei Bluemix
    Dieser Schritt ist nur erforderlich, wenn Sie Ihren Server in einer Organisation und einem Breich ohne verfügbare dashDB-Serviceinstanz erstellen müssen. Wenn das der Fall ist, aktualisieren Sie die Datei initenv.properties mit der neuen Organisation und dem neuen Bereich, in denen die Container erstellt (und gestartet) werden müssen. Führen Sie dann erneut das Script initenv.sh aus:
    ./initenv.sh args/initenv.properties
  4. prepareappcenter.sh - Erstellung des MobileFirst Application Center
    Führen Sie das Script prepareappcenter.sh aus, um ein MobileFirst Application Center zu erstellen und per Push-Operation als Cloud-Foundry-Anwendung in Bluemix zu übertragen. Führen Sie cf apps aus, um alle Cloud-Foundry-Anwendungen mit ihren URLs in der Organisation und in dem Bereich zu sehen, für die Sie sich angemeldet haben.
    ./prepareappcenter.sh args/prepareappcenter.properties
    Sie können die Parameter auch in der Befehlszeile übergeben.
    prepareappcenter.sh --name APP_NAME
    Wenn Sie sich über alle unterstützten Parameter und ihre Dokumentation informieren möchten, füren Sie die Option "help" aus.
    ./prepareappcenter.sh --help
  5. startappcenter.sh - Starten des MobileFirst Application Center
    Das Script startappcenter.sh wird zum Starten von MobileFirst Application Center in der Cloud-Foundry-Anwendung für Liberty for Java zu starten. Führen Sie Folgendes aus:

    ./startappcenter.sh args/startappcenter.properties
    Sie können die Parameter auch in der Befehlszeile übergeben.
    ./startappcenter.sh --name APP_NAME
    Wenn Sie sich über alle unterstützten Parameter und ihre Dokumentation informieren möchten, füren Sie die Option "help" aus.
    ./startappcenter.sh --help

Starten Sie die MobileFirst-Application-Center-Konsole über die URL http://APP_HOST.mybluemix.net/appcenterconsole. (Der Start kann eine Weile dauern.)

Mit dem in IBM Bluemix ausgeführten MobileFirst Application Center können Sie nun Ihre mobilen Apps in das Application Center hochladen.

MobileFirst Server

Der Ordner args enthält Konfigurationsdateien mit den Argumenten, die zum Ausführen der Scripts erforderlich sind. Die leeren Schablonendateien und eine Erläuterung der Argumente finden Sie im Ordner args oder nach einer interaktiven Ausführung der Scripts im Ordner recorded-args. Es handelt sich um folgende Dateien:

initenv.properties

Diese Datei enhält Eigenschaften zum Ausführen der Umgebungsinitialisierung.

prepareserverdbs.properties

Der Mobile Foundation Service erfordert eine externe dashDB-Enterprise-Transactional-Datenbankinstanz (einen mit "OLTP" oder "Transactional" bezeichneten Plan).
Hinweis: Die Implementierung der dashDB-Enterprise-Transactional-Pläne erfolgt sofort, wenn die Pläne mit "pay as you go" gekennzeichnet sind. Vergewissern Sie sich, dass Sie einen passenden Plan ausgewählt haben, z. B. Enterprise for Transactions High Availability 2.8.500 (Pay per use).

Wenn Sie Ihre dashDB-Instanz eingerichtet haben, geben Sie die erforderlichen Argumente an.

prepareserver.properties

Diese Datei wird für das Script prepareserver.sh verwendet. Sie erstellt das Serverdateilayout und überträgt es per Push-Operation als Cloud-Foundry-App in Bluemix.

startserver.properties

Diese Datei konfiguriert die Laufzeitattribute des Servers und startet den Server. Es wird dringend empfohlen, für die hohe Verfügbarkeit mindestens 1024 MB (SERVER_MEM=1024) und 3 Knoten (INSTANCES=3) zu verwenden.

Die folgenden Anweisungen demonstrieren die Ausführung der Scripts unter Verwendung der Konfigurationsdateien. Eine Liste mit Befehlszeilenargumenten, die Sie für die Ausführung in einem nicht interaktiven Modus auswählen sollten, wird ebenfalls bereitgestellt.

  1. initenv.sh – Anmeldung bei Bluemix
    Führen Sie das Script initenv.sh für die Anmeldung bei Bluemix aus. Führen Sie das Script für die Organisation und den Bereich aus, an die Ihr dashDB-Service gebunden ist:
    ./initenv.sh args/initenv.properties
    Sie können die Parameter auch in der Befehlszeile übergeben.
    initenv.sh --user Bluemix-Benutzer-ID --password Bluemix-Kennwort --org Bluemix-Organisationsname --space Bluemix-Bereichsname
    Wenn Sie sich über alle unterstützten Parameter und ihre Dokumentation informieren möchten, füren Sie die Option "help" aus.
    ./initenv.sh --help
  2. prepareserverdbs.sh - Erstellung der MobileFirst-Server-Datenbank
    Das Script prepareserverdbs.sh wird verwendet, um Ihren MobileFirst Server mit dem dashDB-Datenbankservice oder einem zugänglichen DB2-Datenbankserver zu konfigurieren. Die DB2-Option kommt insbesondere infrage, wenn Sie Bluemix lokal in dem Rechenzentrum ausführen, in dem der DB2-Server installiert ist. Wenn Sie den dashDB-Service verwenden, muss die Instanz des dashDB-Service in der Organisation und dem Bereich verfügbar sein, bei denen Sie sich in Schritt 1 angemeldet haben. Führen Sie Folgendes aus:
    ./prepareserverdbs.sh args/prepareserverdbs.properties
    Sie können die Parameter auch in der Befehlszeile übergeben.
    prepareserverdbs.sh --admindb MFPDashDBService
    Wenn Sie sich über alle unterstützten Parameter und ihre Dokumentation informieren möchten, füren Sie die Option "help" aus.
    ./prepareserverdbs.sh --help
  3. initenv.sh (optional) – Anmeldung bei Bluemix
    Dieser Schritt ist nur erforderlich, wenn Sie Ihren Server in einer Organisation und einem Breich ohne verfügbare dashDB-Serviceinstanz erstellen müssen. Wenn das der Fall ist, aktualisieren Sie die Datei initenv.properties mit der neuen Organisation und dem neuen Bereich, in denen die Container erstellt (und gestartet) werden müssen. Führen Sie dann erneut das Script initenv.sh aus:
    ./initenv.sh args/initenv.properties
  4. prepareserver.sh - Erstellung eines MobileFirst Server
    Führen Sie das Script prepareserver.sh aus, um einen MobileFirst Server zu erstellen und per Push-Operation als Cloud-Foundry-Anwendung in Bluemix zu übertragen. Führen Sie cf apps aus, um alle Cloud-Foundry-Anwendungen mit ihren URLs in der Organisation und in dem Bereich zu sehen, für die Sie sich angemeldet haben.
    ./prepareserver.sh args/prepareserver.properties
    Sie können die Parameter auch in der Befehlszeile übergeben.
    prepareserver.sh --name APP_NAME
    Wenn Sie sich über alle unterstützten Parameter und ihre Dokumentation informieren möchten, füren Sie die Option "help" aus.
    ./prepareserver.sh --help
  5. startserver.sh - Starten des Servers
    Das Script startserver.sh wird zum Starten von MobileFirst Server in der Cloud-Foundry-Anwendung für Liberty for Java zu starten. Führen Sie Folgendes aus:

    ./startserver.sh args/startserver.properties
    Sie können die Parameter auch in der Befehlszeile übergeben.
    ./startserver.sh --name APP_NAME 
    Wenn Sie sich über alle unterstützten Parameter und ihre Dokumentation informieren möchten, füren Sie die Option "help" aus.
    ./startserver.sh --help

Starten Sie die MobileFirst Operations Console über die URL http://APP_HOST.mybluemix.net/mfpconsole. (Der Start kann eine Weile dauern.)
Fügen Sie den fernen Server hinzu. Folgen Sie dfür den Anweisungen im Lernprogramm MobileFirst CLI für die Verwaltung von MobileFirst-Artefakten verwenden.

MobileFirst Server wird jetzt in IBM Bluemix ausgeführt, sodass Sie mit der Anwendungsentwicklung beginnen können.

Änderungen anwenden

Nachdem Sie den Server implementiert haben, sind möglicherweise Änderungen am Serverlayout erforderlich. Es könnte beispielsweise sein, dass Sie die Analytics-URL in /usr/config/mfpfproperties.xml aktualisieren möchten. Nehmen Sie die Änderungen vor und führen Sie dann die folgenden Scripts mit den gleichen Parametern erneut aus.

  1. ./prepareserver.sh
  2. ./startserver.sh

Analytics-Server-Konfiguration zu MobileFirst Server hinzufügen

Wenn Sie einen Analytics-Server eingerichtet haben und möchten, dass dieser Server eine Verbindung zu diesem MobileFirst Server herstellen können soll, bearbeiten Sie die Datei mfpfproperties.xml im Ordner Paketstammverzeichnis/mfpf-server-libertyapp/usr/config wie unten angegeben. Ersetzen Sie die mit <> gekennzeichneten Token durch reale Werte Ihrer Implementierung.

<jndiEntry jndiName="${env.MFPF_RUNTIME_ROOT}/mfp.analytics.url" value='"https://<AnalyticsContainerGroupRoute>:443/analytics-service/rest"'/>
<jndiEntry jndiName="${env.MFPF_RUNTIME_ROOT}/mfp.analytics.console.url" value='"https://<AnalyticsContainerPublicRoute>:443/analytics/console"'/>
<jndiEntry jndiName="${env.MFPF_RUNTIME_ROOT}/mfp.analytics.username" value='"<AnalyticsUserName>"'/>
<jndiEntry jndiName="${env.MFPF_RUNTIME_ROOT}/mfp.analytics.password" value='"<AnalyticsPassword>"'/>


<jndiEntry jndiName="${env.MFPF_PUSH_ROOT}/mfp.push.analytics.endpoint" value='"https://<AnalyticsContainerGroupRoute>:443/analytics-service/rest"'/>
<jndiEntry jndiName="${env.MFPF_PUSH_ROOT}/mfp.push.services.ext.analytics" value="com.ibm.mfp.push.server.analytics.plugin.AnalyticsPlugin"/>
<jndiEntry jndiName="${env.MFPF_PUSH_ROOT}/mfp.push.analytics.user" value='"<AnalyticsUserName>"'/>
<jndiEntry jndiName="${env.MFPF_PUSH_ROOT}/mfp.push.analytics.password" value='"<AnalyticsPassword>"'/>

Fixes für MobileFirst Server anwenden

Vorläufige Fixes für MobileFirst Server in Bluemix können über IBM Fix Central abgerufen werden.
Sichern Sie Ihre vorhandenen Konfigurationsdateien, bevor Sie einen vorläufigen Fix anwenden. Die Konfigurationsdateien befinden sich in den folgenden Ordnern:

  • MobileFirst Analytics: Paketstammverzeichnis/mfpf-analytics/usr
  • MobileFirst Server (Liberty-Cloud-Foundry-Anwendung): Paketstammverzeichnis/mfpf-server-libertyapp/usr
  • Application Center: Paketstammverzeichnis/mfp-appcenter-libertyapp/usr

Anwendung des iFix:

  1. Laden Sie das Archiv mit dem vorläufigen Fix herunter und extrahieren Sie den Inhalt des Archivs in Ihrem vorhandenen Installationsordner. Dabei werden in dem Ordner vorhandene Dateien überschrieben.
  2. Speichern Sie Ihre gesicherten Konfigurationsdateien zurück in die Ordner Paketstammverzeichnis/mfpf-analytics/usr, Paketstammverzeichnis/mfpf-server-libertyapp/usr und Paketstammverzeichnis/mfp-appcenter-libertyapp/usr. Dabei werden die neu installierten Konfigurationsdateien überschrieben.
  3. Bearbeiten Sie die Datei Paketstammverzeichnis/mfpf-server/usr/env/jvm.options in Ihrem Editor. Wenn die folgende Zeile vorhanden ist, entfernen Sie sie:
    -javaagent:/opt/ibm/wlp/usr/servers/mfp/newrelic/newrelic.jar
    

    Jetzt können Sie einen aktualisierten Serverbuild erstellen und den Server implementieren. Führen Sie die folgenden Scripts erneut mit den gleichen Parametern aus.

    a. ./prepareserver.sh zum Hochladen der aktualisierten Artefakte in Bluemix

    b. ./startserver.sh zum Starten des aktualisierten Servers

    Eine Kopie der für die vorherige Implementierung verwendeten Argumente wurde im Verzeichnis recorded-args/ gespeichert. Sie können diese Eigenschaften für Ihre Implementierung verwenden.

Datenbankservicekonfiguration aus Bluemix entfernen

Wenn Sie während der Konfiguration des MobileFirst-Server-Image das Script prepareserverdbs.sh ausgeführt haben, werden die für MobileFirst Server erforderlichen Konfigurationen und Datenbanktabellen erstellt. Das Script erstellt auch das Datenbankschema für MobileFirst Server.

Sie können die Datenbankservicekonfiguration im Bluemix-Dashboard wie folgt entfernen.

  1. Wählen Sie im Bluemix-Dashboard den dashDB-Service aus, den Sie verwendet haben. Wählen Sie den dashDB-Servicenamen aus, den Sie für die Ausführung des Scripts prepareserverdbs.sh als Parameter angegeben haben.
  2. Starten Sie die dashDB-Konsole, um mit den Schemata und Datenbankobjekten der ausgewählten dashDB-Serviceinstanz arbeiten zu können.
  3. Wählen Sie Schemata für die Konfiguration von IBM MobileFirst Server aus. Die Schemanamen sind die, die Sie bei Ausführung des Scripts prepareserverdbs.sh als Parameter angegeben haben.
  4. Untersuchen Sie die Schemanamen und die zugehörigen Objekte gründlich, bevor Sie die einzelnen Schemata löschen. Die Datenbankkonfigurationen wurden aus Bluemix entfernt.

Wenn Sie während des Konfigurierens des MobileFirst Application Center das Script prepareappcenterdbs.sh ausführen, folgen Sie den oben beschriebenen Schritten, um die Datenbankservicekonfiguration aus Bluemix zu entfernen.

Last modified on November 21, 2017