MobileFirst Server in IBM Cloud Private einrichten

improve this page | report issue

Übersicht

Folgen Sie den nachstehenden Anweisungen, um eine MobileFirst-Server-Instanz und eine Instanz von MobileFirst Analytics für IBM Cloud Private zu konfigurieren.

  • Richten Sie einen IBM Cloud-Private-Kubernetes-Cluster ein.
  • Richten Sie Ihren Host-Computer mit den erforderlichen Tools ein (Docker, IBM Cloud-CLI (bx), IBM Cloud-Private-Plug-in (icp) für die IBM Cloud-CLI (bx pr), Kubernetes-CLI (kubectl) und Helm-CLI (helm)).
  • Laden Sie das Passport-Advantage-Archiv mit der IBM Mobile Foundation für IBM Cloud Private herunter.
  • Laden Sie das Passport-Advantage-Archiv in den IBM Cloud-Private-Cluster.
  • Abschließend werden Sie MobileFirst Analytics (optional) und MobileFirst Server installieren und konfigurieren.

Fahren Sie mit folgenden Abschnitten fort:

Voraussetzungen

Sie müssen über ein IBM Cloud-Private-Konto verfügen und den Kubernetes-Cluster wie unter IBM Cloud Private Cluster installation dokumentiert eingerichtet haben.

Für die Verwaltung von Containern und Images müssen Sie im Rahmen des IBM Cloud-Private-Setups die folgenden Tools auf Ihrer Hostmaschine installieren:

  • Docker
  • IBM Cloud-CLI (bx)
  • ICP-Plug-in (IBM Cloud Private) für die IBM Cloud-CLI ( bx pr )
  • Kubernetes-CLI (kubectl)
  • Helm (helm)

Für den Zugruff auf den IBM Cloud-Private-Cluster über die CLI sollten Sie den kubectl-Client konfigurieren. Hier finden Sie weitere Informationen.

Passport-Advantage-Archiv mit der IBM Mobile Foundation herunterladen

Das Passport-Advantage-Archiv mit dem IBM Mobile Foundation ist hier verfügbar. Das Passport-Advantage-Archiv mit der Mobile Foundation enthält die Docker-Images und Helm-Charts für die folgenden Komponenten der Mobile Foundation:

  • MobileFirst Server
  • MobileFirst Analytics
  • MobileFirst Application Center

Passport-Advantage-Archiv mit der IBM Mobile Foundation laden

Bevor Sie das Passport-Advantage-Archiv mit der Mobile Foundation laden, müssen Sie Docker einrichten. Anweisungen finden Sie hier.

Führen Sie die nachstehenden Schritte aus, um das Passport-Advantage-Archiv in den IBM Cloud-Private-Cluster zu laden:

  1. Melden Sie sich mit dem IBM Cloud-Private-Plug-in (bx pr) beim Cluster an.

    Lesen Sie die CLI-Befehlsreferenz in der Dokumentation zu IBM Cloud Private.

    Beispiel:

     bx pr login -a https://IP-Adresse:Port
    

    Falls Sie die SSL-Validierung übergehen möchten, können Sie im obigen Befehl die Option --skip-ssl-validation verwenden. Bei Verwendung dieser Option werden Sie zur Eingabe von Benutzername und Kennwort Ihres Clusterendpunkts aufgefordert. Fahren Sie nach erfolgreicher Anmeldung mit den nachstehenden Schritten fort.

  2. Laden Sie mit folgendem Befehl das Passport-Advantage-Archiv mit der Mobile Foundation:
     bx pr load-ppa-archive --archive <Archivname> [--clustername <Clustername>] [--namespace <Namespace>]
    

    Der Archivname für die Mobile Foundation ist der Name des Archivs, den Sie über IBM Passport Advantage heruntergeladen haben.

    Sie können --clustername ignorieren, wenn Sie den vorherigen Schritt ausgeführt und den Clusterendpunkt zum Standard für bx pr gemacht haben.

  3. Synchronisieren Sie nach dem Laden des Passport-Advantage-Archivs die Repositorys, um sicherzustellen, dass die Helm-Charts im Katalog (Catalog) aufgelistet werden. Diesen Schritt können Sie in der Managementkonsole von IBM Cloud Private ausführen.
    • Wählen Sie Admin > Repositories aus.
    • Klicken Sie auf Synch Repositories.
  4. Sie können die Docker-Images und Helm-Charts in der Managementkonsole von IBM Cloud Private anzeigen. Gehen Sie zum Anzeigen von Docker-Images wie folgt vor:
    • Wählen Sie Platform > Images aus.
    • Helm-Charts werden im Katalog (Catalog) angezeigt.

Nach Ausführung der obigen Schritte sehen Sie die hochgeladene Version der -Helm-Charts im ICP-Katalog. MobileFirst Server wird als ibm-mfpf-server-prod aufgelistet und MobileFirst Analytics als ibm-mfpf-analytics-prod.

Helm-Charts für die IBM Mobile Foundation installieren und konfigrieren

Bevor Sie das MobileFirst Server installieren und konfigurieren, benötigen Sie Folgendes:

  • [Obligatorisch] eine konfigurierte und betriebsbereite DB2-Datenbank. Sie benötigen die Datenbankinformationen für die Konfiguration des MobileFirst-Server-Helm-Charts. MobileFirst Server erfordert ein Schema und Tabellen, die in dieser Datenbank erstellt werden (falls sie nicht vorhanden sind).

  • [Optional] einen geheimen Schlüssel mit Ihrem Keystore und Truststore. Sie können Ihren eigenen Keystore und Truststore für die Implementierung angeben, indem Sie mit Ihrem eigenen Keystore und Truststore einen geheimen Schlüssel erstellen.

    Führen Sie vor der Installation die folgenden Schritte aus:

    • Erstellen Sie mit den Dateien keystore.jks, keystore-password.txt, truststore.jks, truststore-password.txt einen geheimen Schlüssel und geben Sie im Feld keystores.keystoresSecretName den Namen des geheimen Schlüssels an.

    • Speichern Sie die Datei keystore.jks mit dem zugehörigen Kennwort in einer Datei mit dem Namen keystore-password.txt und die Datei truststore.jks mit dem zugehörigen Kennwort its password in einer Datei mit dem Namen truststore-password.jks.

    • Rufen Sie die Befehlszeile auf und führen Sie Folgendes aus:
      kubectl create secret generic mfpf-cert-secret --from-file keystore-password.txt --from-file truststore-password.txt --from-file keystore.jks --from-file truststore.jks
      

      Hinweis: Die Namen der Dateien sollten wie angegeben lauten, d. h. keystore.jks, keystore-password.txt, truststore.jks und truststore-password.txt.

    • Geben Sie den Namen des geheimen Schlüssels in keystoresSecretName an, um die Standard-Keystores außer Kraft zu setzen.

    Weitere Informationen finden Sie unter Keystore für MobileFirst Server konfigurieren.

Umgebungsvariablen für MobileFirst Analytics

In der folgenden Tabelle sind die in MobileFirst Analytics in IBM Cloud Private verwendeten Umgebungsvariablen angegeben.

Qualifikationsmerkmal Parameter Definition Zulässiger Wert
arch   Worker node architecture Worker-Knotenarchitektur, in der dieses Chart implementiert werden soll.
Derzeit wird nur die Plattform AMD64 unterstützt.
image pullPolicy Richtlinie für Image-Übertragung per Pull-Operation Standardeinstellung: IfNotPresent
  tag Docker image tag Siehe Docker tag description
  name Docker image name Name des Docker-Image für Operational Analytics
scaling replicaCount Anzahl der Instanzen (Pods) von Operational Analytics, die erstellt werden müssen Positive ganze Zahl
Standardeinstellung: 2
mobileFirstAnalyticsConsole user Benutzername für Operational Analytics Standardeinstellung: admin
  password Kennwort für Operational Analytics Standardeinstellung: admin
analyticsConfiguration clusterName Name des -Analytics-Clusters Standardeinstellung: mobilefirst
  analyticsDataDirectory Pfad für die Speicherung von Analytics-Daten. Unter diesem Pfad wird auch die Forderung nach einem persistenten Datenträger innerhalb des Containers angehängt. Standardeinstellung: /analyticsData
  numberOfShards Anzahl der Elasticsearch-Shards für Analytics Positive ganze Zahl
Standardeinstellung: 2
  replicasPerShard Anzahl der Elasticsearch-Replikate, die pro Shard für Analytics verwaltet werden sollen Positive ganze Zahl
Standardeinstellung: 2
keystores keystoresSecretName Unter Helm-Charts für die IBM Mobile Foundation installieren und konfigurieren sind die Schritte für die Erstellung des geheimen Schlüssels mit den Keystores und den zugehörigen Kennwörtern beschrieben.  
jndiConfigurations mfpfProperties Für die Anpassung von Operational Analytics anzugebende -JNDI-Eigenschaften Liste mit Name-Wert-Paaren, jeweils getrennt durch ein Komma angegeben
resources limits.cpu Beschreibt die maximal zulässige CPU-Kapazität Standardeinstellung: 2000m
Informieren Sie sich über die Bedeutung der CPU-Kapazität unter Meaning of CPU.
  limits.memory Beschreibt die maximal zulässige Speicherkapazität Standardeinstellung: 4096Mi
Informieren Sie sich über die Bedeutung der CPU-Kapazität unter Meaning of memory.
  requests.cpu Beschreibt die erforderliche CPU-Mindestkapazität. Wenn keine Angabe gemacht wird, wird standardmäßig limits verwendet (falls angegeben) oder ein anderweitig für die Implementierung definierter Wert. Standardeinstellung: 1000m
  requests.memory Beschreibt die erforderliche Mindestspeicherkapazität. Wenn keine Angabe gemacht wird, wird standardmäßig limits verwendet (falls angegeben) oder der für die Implementierung definierte Wert. Standardeinstellung: 2048Mi
persistence existingClaimName Name der vorhandenen Forderung nach einem persistenten Datenträger  

Umgebungsvariablen für MobileFirst Server

In der folgenden Tabelle sind die in MobileFirst Server in IBM Cloud Private verwendeten Umgebungsvariablen angegeben.

Qualifikationsmerkmal Parameter Definition Zulässiger Wert
arch   Worker node architecture Worker-Knotenarchitektur, in der dieses Chart implementiert werden soll.
Derzeit wird nur die Plattform AMD64 unterstützt.
image pullPolicy Richtlinie für Image-Übertragung per Pull-Operation Standardwert: IfNotPresent
  tag Docker image tag Siehe Docker tag description
  name Docker image name Name des -Server-Docker-Image
scaling replicaCount Anzahl der -Server-Instanzen (Pods), die erstellt werden müssen Positive ganze Zahl
Standardeinstellung: 3
mobileFirstOperationsConsole user Benutzername für Server Standardeinstellung: admin
  password Kennwort für den Benutzer von Server Standardeinstellung: admin
existingDB2Details db2Host IP-Adresse oder Host der DB2-Datenbank, in der die -Server-Tabellen konfiguriert werden müssen Derzeit wird nur DB2 unterstützt.
  db2Port Port, der für die DB2-Datenbank eingerichtet ist  
  db2Database Name der Datenbank, die in DB2 für die Verwendung vorkonfiguriert ist  
  db2Username DB2-Benutzername für den Zugriff auf die DB2-Datenbank Der Benutzer sollte Zugriff haben, um Tabellen zu erstellen und ein Schema zu erstellen, falls es noch nicht vorhanden ist.
  db2Password DB2-Kennwort für die angegebene Datenbank  
  db2Schema Zu erstellendes Server-DB2-Schema  
  db2ConnectionIsSSL DB2-Verbindungstyp Geben Sie an, ob Ihre Datenbankverbindung über http oder https erfolgen muss. Der Standardwert ist false (http).
Stellen Sie sicher, dass der DB2-Port für denselben Verbindungsmodus konfiguriert ist.
existingMobileFirstAnalytics analyticsEndPoint URL des Analytics Server Beispiel: http://9.9.9.9:30400
Geben Sie nicht den Pfad zur Konsole an. Dieser wird während der Implementierung hinzugefügt.
  analyticsAdminUser Benutzername des Analytics-Benutzers mit Verwaltungsaufgaben  
  analyticsAdminPassword Kennwort des Analytics-Benutzers mit Verwaltungsaufgaben  
keystores keystoresSecretName Unter Helm-Charts für die IBM Mobile Foundation installieren und konfigurieren sind die Schritte für die Erstellung des geheimen Schlüssels mit den Keystores und den zugehörigen Kennwörtern beschrieben.  
jndiConfigurations mfpfProperties -Server-JNDI-Eigenschaften für die Anpassung der Implementierung Liste mit Name-Wert-Paaren, jeweils getrennt durch ein Komma angegeben
resources limits.cpu Beschreibt die maximal zulässige CPU-Kapazität Standardeinstellung: 2000m
Informieren Sie sich über die Bedeutung der CPU-Kapazität unter Meaning of CPU.
  limits.memory Beschreibt die maximal zulässige Speicherkapazität Standardeinstellung: 4096Mi
Informieren Sie sich über die Bedeutung der CPU-Kapazität unter Meaning of memory.
  requests.cpu Beschreibt die erforderliche CPU-Mindestkapazität. Wenn keine Angabe gemacht wird, wird standardmäßig limits verwendet (falls angegeben) oder ein anderweitig für die Implementierung definierter Wert. Standardeinstellung: 1000m
  requests.memory Beschreibt die erforderliche Mindestspeicherkapazität. Wenn keine Angabe gemacht wird, wird standardmäßig limits verwendet (falls angegeben) oder der für die Implementierung definierte Wert. Standardeinstellung: 2048Mi

-Helm-Charts aus dem ICP-Katalog installieren

MobileFirst Analytics installieren

Die Installation von MobileFirst Analytics ist optional. Wenn Sie Analysen in MobileFirst Server aktivieren möchten, sollten Sie MobileFirst Analytics installieren und konfigurieren und installieren, bevor Sie MobileFirst Server installieren.

Bevor Sie mit der Installation des MobileFirst-Analytics-Charts beginnen, müssen Sie den persistenten Datenträger konfigurieren. Geben Sie den persistenten Datenträger für die Konfiguration von MobileFirst Analytics an. Führen Sie für die Erstellung des persistenten Datenträgers die Schritte in der IBM Cloud-Private-Dokumentation aus.

Führen Sie die folgenden Schritte aus, um das IBM MobileFirst Analytics in der Managementkonsole von IBM Cloud Private zu installieren und zu konfigurieren.

  1. Navigieren Sie in der Managementkonsole zu Catalog.
  2. Wählen Sie das Helm-Chart ibm-mfpf-analytics-prod aus.
  3. Klicken Sie auf Configure.
  4. Geben Sie die Umgebungsvariablen an. Weitere Informationen finden Sie unter Umgebungsvariablen für MobileFirst Analytics.
  5. Akzeptieren Sie die ** Lizenzvereinbarung **.
  6. Klicken Sie auf Install.

MobileFirst Server installieren

Bevor Sie mit der Installation von MobileFirst Server beginnen, benötigen Sie eine vorkonfigurierte DB2-Datenbank.

Führen Sie die folgenden Schritte aus, um IBM MobileFirst Server in der Managementkonsole von IBM Cloud Private zu installieren und zu konfigurieren.

  1. Navigieren Sie in der Managementkonsole zu Catalog.
  2. Wählen Sie das Helm-Chart ibm-mfpf-server-prod aus.
  3. Klicken Sie auf Configure.
  4. Geben Sie die Umgebungsvariablen an. Weitere Informationen finden Sie unter Umgebungsvariablen für MobileFirst Server.
  5. Akzeptieren Sie die ** Lizenzvereinbarung **.
  6. Klicken Sie auf Install.

Installation überprüfen

Nachdem Sie MobileFirst Analytics (optional) und MobileFirst Server installiert und konfiguriert haben, können Sie wie folgt Ihre Installation und den Status der implementierten Pods überprüfen:

Wählen Sie in der Managementkonsole von IBM Cloud Private Workloads > Helm Releases aus. Klicken Sie auf den Releasenamen für Ihre Installation.

Zugriff auf die -Konsole

Nach einer erfolgreichen Installation können Sie mit <Protokoll>://<IP-Adresse>:<Port>/mfpconsole auf die IBM Operational Console zugreifen. Auf die IBM MobileFirst Analytics Console können Sie mit <Protokoll>://<IP-Adresse>:<Port>/analytics/console zugreifen.

Das Protokoll kann http oder https sein. Beachten Sie außerdem, dass der Port im Falle einer NodePort-Implementierung NodePort lautet. Führen Sie die folgenden Schritte aus, um die IP-Adresse und den NodePort Ihres installierten -Charts zu erhalten:

  1. Wählen Sie in der Managementkonsole von IBM Cloud Private Workloads > Helm Releases aus.
  2. Klicken Sie auf den Releasenamen für Ihre Helm-Chart-Installation.
  3. Lesen Sie die Informationen im Abschnitt Notes.

Hinweis: Der Port 9600 wird intern im Kubernetes-Service zugänglich gemacht und von den -Analytics-Instanzen als Transportport verwendet.

Beispielanwendung

Gehen Sie die -Lernprogramme durch, um den Beispieladapter zu implementieren und die Beispielanwendung in einem IBM MobileFirst Server in IBM Cloud Private auszuführen.

Upgrade für -Helm-Charts und -Releases

Unter Upgrading bundled products finden Sie Anweisungen zur Durchführung eines Upgrades für Helm-Charts bzw. Releases.

Beispielszenarien für Helm-Release-Upgrades

  1. Für das Upgrade eines Helm-Release mit einer Änderung der Werte von values.yaml können Sie den Befehl helm upgrade mit der Option –set verwenden. Sie können die Option – set mehrfach angeben. Priorität erhält die in der Befehlszeile ganz rechts angegebene Option “set”.
      helm upgrade --set <name>=<Wert> --set <name>=<Wert> <existing-helm-release-name> <Pfad_des_neuen_Helm-Charts>
    
  2. Wenn Sie ein Upgrade für ein Helm-Release mit Angabe von Werten in einer Datei durchführen, verwenden Sie den Befehl helm upgrade mit der Option -f. Sie können die Option –values oder -f mehrfach verwenden. Priorität erhält die in der Befehlszeile ganz rechts angegebene Datei (Option “-f”). Wenn im folgenden Beispiel sowohl myvalues.yaml als auch override.yaml einen Schlüssel Test enthält, hat der in override.yaml festgelegte Wert Vorrang.
      helm upgrade -f myvalues.yaml -f override.yaml <existing-helm-release-name> <Pfad_des_neuen_Helm-Charts>
    
  3. Wenn Sie ein Uprade für ein Helm-Release durchführen und dabei die Werte des letzten Release wiederverwenden und einige der Werte überschreiben möchten, können Sie einen Befehl wie den folgenden verwenden:
      helm upgrade --reuse-values --set <name>=<Wert> --set <name>=<Wert> <existing-helm-release-name> <Pfad_des_neuen_Helm-Charts>
    

Deinstallation

Verwenden Sie zum Deinstallieren von MobileFirst Server und MobileFirst Analytics die Helm-CLI. Mit dem folgenden Befehl werden die installierten Charts und die zugehörigen Implementierungen vollständig gelöscht:

helm delete --purge <Releasename>

Hier steht Releasename für den implementierten Releasenamen des Helm-Charts.

Last modified on March 28, 2018