アプリケーション・サーバーへの MobileFirst Server のインストール

Apache Tomcat アプリケーション・サーバー用のセキュア JMX 接続を構成する必要があります。

サーバー構成ツールと Ant タスクは、デフォルトのセキュア JMX 接続を構成することができます。これには、JMX リモート・ポートの定義、および認証プロパティーの定義が含まれます。 サーバー構成ツールと Ant タスクは、tomcat_install_dir/bin/setenv.bat および tomcat_install_dir/bin/setenv.sh を変更して、以下のオプションを CATALINA_OPTS に追加します。

-Djava.rmi.server.hostname=localhost
-Dcom.sun.management.jmxremote.port=8686
-Dcom.sun.management.jmxremote.authenticate=false
-Dcom.sun.management.jmxremote.ssl=false

注: 8686 はデフォルト値です。 このポートの値は、ポートがコンピューターで使用可能でない場合、変更することができます。

• tomcat_install_dir/bin/startup.bat または tomcat_install_dir/bin/catalina.bat を使用して Apache Tomcat を始動する場合は、setenv.bat ファイルが使用されます。
• tomcatInstallDir/bin/startup.sh または tomcat_install_dir/bin/catalina.sh を使用して Apache Tomcat を始動する場合は、setenv.sh ファイルが使用されます。

別のコマンドを使用して Apache Tomcat を始動する場合は、このファイルが使用されない場合があります。 Apache Tomcat Windows Service Installer をインストールした場合、サービス・ランチャーは setenv.batを使用しません。

重要: この構成は、デフォルトでは保護されていません。 構成を保護するには、以下の手順のステップ 2 と 3 を手動で完了する必要があります。

Apache Tomcat の手動構成

1. 単純な構成の場合は、CATALINA_OPTS に以下のオプションを追加します

   -Djava.rmi.server.hostname=localhost
   -Dcom.sun.management.jmxremote.port=8686
   -Dcom.sun.management.jmxremote.authenticate=false
   -Dcom.sun.management.jmxremote.ssl=false

2. 認証をアクティブにするには、Apache Tomcat ユーザー資料の SSL サポート - BIO および NIO と SSL 構成方法を参照してください。
3. SSL が有効な JMX 構成の場合は、以下のオプションを追加します。

   -Dcom.sun.management.jmxremote=true
   -Dcom.sun.management.jmxremote.port=8686
   -Dcom.sun.management.jmxremote.ssl=true
   -Dcom.sun.management.jmxremote.authenticate=false
   -Djava.rmi.server.hostname=localhost  
   -Djavax.net.ssl.trustStore=<key store location>
   -Djavax.net.ssl.trustStorePassword=<key store password>
   -Djavax.net.ssl.trustStoreType=<key store type>
   -Djavax.net.ssl.keyStore=<key store location>
   -Djavax.net.ssl.keyStorePassword=<key store password>
   -Djavax.net.ssl.keyStoreType=<key store type>

   注: ポート 8686 は変更することができます。

4. Tomcat インスタンスがファイアウォールの背後で実行されている場合は、JMX リモート・ライフサイクル・リスナーを構成する必要があります。 JMX リモート・ライフサイクル・リスナーについては、Apache Tomcat の資料を参照してください。

   また、以下の例に示すように、以下の環境プロパティーを server.xml ファイル内の管理サービス・アプリケーションの Context セクションに追加する必要があります。

   <Context docBase="mfpadmin" path="/mfpadmin ">
       <Environment name="mfp.admin.rmi.registryPort" value="registryPort" type="java.lang.String" override="false"/>
       <Environment name="mfp.admin.rmi.serverPort" value="serverPort" type="java.lang.String" override="false"/>
   </Context>

   上記の例について、以下に説明します。
   • registryPort の値は、JMX リモート・ライフサイクル・リスナーの rmiRegistryPortPlatform 属性と同じ値でなければなりません。
   • serverPort の値は、JMX リモート・ライフサイクル・リスナーの rmiServerPortPlatform 属性と同じ値でなければなりません。
5. Apache Tomcat Windows Service Installer を使用して Apache Tomcat をインストールした場合は、CATALINA_OPTS にオプションを追加する代わりに、tomcat_install_dir/bin/Tomcat7w.exe を実行し、「プロパティー」ウィンドウの「Java」タブにオプションを追加してください。

MobileFirst Server では、セキュア JMX 接続が構成されている必要があります。

• サーバー構成ツールと Ant タスクは、デフォルトのセキュア JMX 接続を構成することができます。これには、365 日間の有効期間を持つ自己署名 SSL 証明書の生成が含まれます。 この構成は、実稼働環境での使用を目的としたものではありません。
• 実動使用のためのセキュア JMX 接続を構成するには、Liberty プロファイルへのセキュア JMX 接続の構成に記載された指示に従ってください。
• REST コネクターは WebSphere Application Server、Liberty Core、および Liberty の他のエディションで使用可能ですが、Liberty サーバーを使用可能フィーチャーのサブセットと共にパッケージすることが可能です。 REST コネクター・フィーチャーがユーザーの Liberty のインストール済み環境で使用可能かどうかを確認するには、以下のコマンドを入力します。

                      
  liberty_install_dir/bin/productInfo featureInfo

  注: このコマンドの出力に restConnector-1.0 が含まれていることを確認します。

MobileFirst Server では、セキュア JMX 接続が構成されている必要があります。

• MobileFirst Server には、JMX 操作を実行するために、SOAP ポートまたは RMI ポートへのアクセスが必要です。 デフォルトで、SOAP ポートは WebSphere Application Server でアクティブです。 MobileFirst Server は、デフォルトで SOAP ポートを使用します。 SOAP ポートおよび RMI ポートの両方が使用不能の場合、MobileFirst Server は稼働しません。
• RMI は WebSphere Application Server Network Deployment でのみサポートされています。 RMI は、スタンドアロン・プロファイルまたは WebSphere Application Server サーバー・ファームではサポートされていません。
• 管理セキュリティーとアプリケーション・セキュリティーをアクティブにする必要があります。

1. サーバー構成ツールを始動します。
   • Linux の場合、アプリケーションのショートカットから「アプリケーション」→「IBM MobileFirst Platform Server」→「サーバー構成ツール」とクリックします。
   • Windows の場合、「スタート」→「プログラム」→「IBM MobileFirst Platform Server」→「サーバー構成ツール」とクリックします。
   • macOS の場合、シェル・コンソールを開きます。 mfp_server_install_dir/shortcuts に移動し、./configuration-tool.sh と入力します。
   • mfp_server_install_dir ディレクトリーが、MobileFirst Server をインストールした場所です。
2. 「ファイル (File)」→「新規構成 (New Configuration)」を選択して MobileFirst Server 構成を作成します。
   • 「構成の詳細 (Configuration Details)」パネルで、管理サービスとランタイム・コンポーネントのコンテキスト・ルートを入力します。 環境 ID を入力することもできます。 環境 ID は、例えば同じアプリケーション・サーバーまたは同じ WebSphere Application Server セルに MobileFirst Server の複数のインストール済み環境を作成する場合など、高度なユース・ケースにおいて使用します。
   • 「コンソール設定」パネルで、MobileFirst Operations Console をインストールするかどうか選択します。 コンソールをインストールしない場合、コマンド・ライン・ツール (mfpdev または mfpadm) あるいは REST API を使用して MobileFirst Server 管理サービスと対話する必要があります。
   • 「データベース選択 (Database Selection)」パネルで、使用する予定のデータベース管理システムを選択します。 すべてのコンポーネントが同じデータベース・タイプおよび同じデータベース・インスタンスを使用します。 データベース・ペインについて詳しくは、サーバー構成ツールを使用したデータベース表の作成を参照してください。
   • 「アプリケーション・サーバー選択 (Application Server Selection)」パネルで、MobileFirst Server をデプロイするアプリケーション・サーバーのタイプを選択します。
3. 「アプリケーション・サーバー設定 (Application Server Settings)」パネルで、アプリケーション・サーバーを選択して以下のステップを実行してください。
   • インストール先が WebSphere Application Server Liberty の場合:
     • Liberty のインストール・ディレクトリーおよび MobileFirst Server をインストールするサーバーの名前を入力します。
     • コンソールにログインするためのデフォルト・ユーザーを作成します。 このユーザーは Liberty の基本レジストリーに作成されます。 実動インストールの場合は、「デフォルト・ユーザーの作成」オプションをクリアして、インストール後にユーザー・アクセスを構成することもできます。 詳しくは、MobileFirst Server 管理用のユーザー認証の構成を参照してください。
     • 「スタンドアロン・デプロイメント」 (デフォルト)、「サーバー・ファーム・デプロイメント」、または「Liberty 集合デプロイメント」のいずれかのデプロイメント・タイプを選択します。
     「Liberty 集合デプロイメント」オプションを選択する場合、以下の手順を実行してください。
     • Liberty 集合サーバーを指定します。
       • 管理サービス、MobileFirst Operations Console、およびライブ更新サービスのインストール先。 このサーバーは、Liberty 集合コントローラーでなければなりません。
       • ランタイムのインストール先。 このサーバーは、Liberty 集合メンバーでなければなりません。
       • プッシュ・サービスのインストール先。 このサーバーは、Liberty 集合メンバーでなければなりません。
     • メンバーのサーバー ID を入力します。 この ID は、集合内のメンバーごとに異なっていなければなりません。
     • 集合メンバーのクラスター名を入力します。
     • コントローラーのホスト名および HTTPS ポート番号を入力します。 これらの値は、Liberty 集合コントローラーの server.xml ファイル内の variable エレメントで定義されたものと同じでなければなりません。
     • コントローラーの管理者ユーザー名およびパスワードを入力します。
   • インストール先が WebSphere Application Server または WebSphere Application Server Network Deployment の場合:
     • WebSphere Application Server のインストール・ディレクトリーを入力します。
     • MobileFirst Server をインストールする WebSphere Application Server プロファイルを選択します。 WebSphere Application Server Network Deployment にインストールする場合は、デプロイメント・マネージャーのプロファイルを選択してください。 デプロイメント・マネージャーのプロファイルで、スコープ (サーバーまたはクラスター) を選択できます。 「クラスター」を選択する場合、クラスターを指定する必要があります。
       • ランタイムのインストール先。
       • 管理サービス、MobileFirst Operations Console、およびライブ更新サービスのインストール先。
       • プッシュ・サービスのインストール先。
     • 管理者のログイン ID およびパスワードを入力します。 管理者ユーザーは、管理者ロールを持っている必要があります。
     • 「WebSphere 管理者を MobileFirst Operations Console の管理者として宣言 (Declare the WebSphere Administrator as an administrator of MobileFirst Operations Console)」オプションを選択すると、MobileFirst Server のインストールに使用されたユーザーは、コンソールの管理セキュリティー・ロールにマップされ、管理者の権限を持ってコンソールにログインできます。 また、このユーザーはライブ更新サービスのセキュリティー・ロールにもマップされます。 そのユーザー名とパスワードは、管理サービスの JNDI プロパティー (mfp.config.service.user および mfp.config.service.password) として設定されます。
     • 「WebSphere 管理者を MobileFirst Operations Console の管理者として宣言 (Declare the WebSphere Administrator as an administrator of MobileFirst Operations Console)」オプションを選択すると、MobileFirst Server のインストールに使用されたユーザーは、コンソールの管理セキュリティー・ロールにマップされ、管理者の権限を持ってコンソールにログインできます。
       • 以下の方法で、管理サービスとライブ更新サービスの間の通信を使用可能にする。
         • ライブ更新サービスのセキュリティー・ロール configadmin にユーザーをマップする。
         • このユーザーのログイン ID とパスワードを管理サービスの JNDI プロパティー (mfp.config.service.user および mfp.config.service.password) に追加する。
         • 1 人以上のユーザーを、管理サービスおよび MobileFirst Operations Console のセキュリティー・ロールにマップします。 MobileFirst Server 管理用のユーザー認証の構成を参照してください。
   • インストール先が Apache Tomcat の場合:
     • Apache Tomcat のインストール・ディレクトリーを入力します。
     • RMI との JMX 通信に使用するポートを入力します。 デフォルトで、この値は 8686 です。 サーバー構成ツールは、tomcat_install_dir/bin/setenv.bat ファイルまたは tomcat_install_dir/bin/setenv.sh ファイルを変更してこのポートを開きます。 手動でポートを開きたい場合や、ポートを開くコードが既に setenv.bat または setenv.sh にある場合は、このツールを使用しないでください。 その場合、代わりに Ant タスクを使用してインストールします。 Ant タスクでのインストールの場合は、RMI ポートを手動で開くオプションが提供されます。
     • コンソールにログインするためのデフォルト・ユーザーを作成します。 このユーザーは、tomcat-users.xml 構成ファイルでも作成されます。 実動インストールの場合は、「デフォルト・ユーザーの作成」オプションをクリアして、インストール後にユーザー・アクセスを構成することもできます。 詳しくは、MobileFirst Server 管理用のユーザー認証の構成を参照してください。
4. アプリケーション・サーバーにプッシュ・サービスをインストールする場合は、「プッシュ・サービスの設定 (Push Service Settings)」パネルで「プッシュ・サービスをインストール (Install the Push service)」オプションを選択します。 コンテキスト・ルートは imfpush です。 プッシュ・サービスと管理サービスの間の通信を使用可能にするには、以下のパラメーターを定義する必要があります。
   • プッシュ・サービスの URL とランタイムの URL を入力します。 Liberty、Apache Tomcat、またはスタンドアロンの WebSphere Application Server にインストールする場合、この URL は自動計算できます。 これにはローカル・サーバー上のコンポーネント (ランタイムまたはプッシュ・サービス) の URL が使用されます。 WebSphere Application Server Network Deployment にインストールする場合、あるいは Web プロキシーまたはロード・バランサーを使用して通信が行われる場合は、URL を手動で入力する必要があります。
   • サービス間の OAuth 通信用に、機密クライアント ID および秘密鍵を入力します。 入力しない場合、ツールによってデフォルトの値とランダム・パスワードが生成されます。
5. MobileFirst Analytics がインストールされている場合、 「Analytics 設定 (Analytics Settings)」パネルで「Analytics サーバーへの接続を使用可能にする (Enable the connection to the Analytics server)」を選択します。 以下の接続設定を入力します。
   • Analytics コンソールの URL。
   • Analytics サーバー (Analytics データ・サービス) の URL。
   • Analytics サーバーへのデータの公開を許可されているユーザーのログイン ID とパスワード。
   ツールにより、ランタイムおよびプッシュ・サービスが Analytics サーバーにデータを送信するよう構成されます。
6. 「デプロイ」をクリックしてインストールを続行します。

管理サービスは、アプリケーション・サーバーにデプロイするための WAR アプリケーションとしてパッケージされています。 server.xml ファイル内で、このアプリケーションに固有の構成をいくつか行う必要があります。 管理サービスの WAR ファイルは mfp_install_dir/MobileFirstServer/mfp-admin-service.war にあります。 コンテキスト・ルートは自由に定義できます。 ただし、通常は /mfpadmin です。

必須の JNDI プロパティー

JNDI プロパティーを定義するとき、管理サービスのコンテキスト・ルートを接頭部として JNDI 名に追加する必要があります。 以下の例は、コンテキスト・ルートとして /mfpadmin を使用して管理サービスがインストールされている場合に mfp.admin.push.url を宣言するケースを示しています。

<jndiEntry jndiName="mfpadmin/mfp.admin.push.url" value="http://localhost:9080/imfpush"/>

プッシュ・サービスがインストールされている場合は、以下の JNDI プロパティーを構成する必要があります。

• mfp.admin.push.url
• mfp.admin.authorization.server.url
• mfp.push.authorization.client.id
• mfp.push.authorization.client.secret
• mfp.admin.authorization.client.id
• mfp.admin.authorization.client.secret

構成サービスとの通信用の JNDI プロパティーは以下のとおりです。

• mfp.config.service.user
• mfp.config.service.password

JNDI プロパティーについて詳しくは、MobileFirst Server 管理サービスの JNDI プロパティーのリストを参照してください。

データ・ソース

管理サービスのデータ・ソースの JNDI 名は、jndiName=the-contextRoot/jdbc/mfpAdminDS と定義する必要があります。 以下の例は、管理サービスが、コンテキスト・ルート /mfpadmin を使用してインストールされており、そのサービスがリレーショナル・データベースを使用しているケースを示しています。

<dataSource jndiName="mfpadmin/jdbc/mfpAdminDS" transactional="false">
  [...]
</dataSource>

アプリケーションの application-bnd エレメントで以下のロールを宣言します。

• mfpadmin
• mfpdeployer
• mfpmonitor
• mfpoperator

ライブ更新サービスは、アプリケーション・サーバーにデプロイするための WAR アプリケーションとしてパッケージされています。 server.xml ファイル内で、このアプリケーションに固有の構成をいくつか行う必要があります。 続行する前に、すべてのサービスに共通の構成詳細についてWebSphere Application Server Liberty への手動インストールを検討してください。

ライブ更新サービスの WAR ファイルは mfp_install_dir/MobileFirstServer/mfp-live-update.war にあります。 ライブ更新サービスのコンテキスト・ルートは /the-adminContextRootconfig のように定義する必要があります。 例えば、管理サービスのコンテキスト・ルートが /mfpadmin の場合、ライブ更新サービスのコンテキスト・ルートは /mfpadminconfig でなければなりません。

データ・ソース

ライブ更新サービスのデータ・ソースの JNDI 名は contextRoot/jdbc/ConfigDS と定義する必要があります。 以下の例は、ライブ更新サービスが、コンテキスト・ルート /mfpadminconfig を使用してインストールされており、そのサービスがリレーショナル・データベースを使用しているケースを示しています。

<dataSource jndiName="mfpadminconfig/jdbc/ConfigDS" transactional="false">
  [...]
</dataSource>

アプリケーションの application-bnd エレメントで configadmin ロールを宣言します。 少なくとも 1 人のユーザーがこのロールにマップされている必要があります。 ユーザーとパスワードは、管理サービスの以下の JNDI プロパティーに指定する必要があります。

• mfp.config.service.user
• mfp.config.service.password

このコンソールは、アプリケーション・サーバーにデプロイするための WAR アプリケーションとしてパッケージされています。 server.xml ファイル内で、このアプリケーションに固有の構成をいくつか行う必要があります。 続行する前に、すべてのサービスに共通の構成詳細についてWebSphere Application Server Liberty への手動インストールを検討してください。

コンソール WAR ファイルは mfp_install_dir/MobileFirstServer/mfp-admin-ui.war にあります。 コンテキスト・ルートは自由に定義できます。 ただし、通常は /mfpconsole です。

必須の JNDI プロパティー

JNDI プロパティーを定義するとき、コンソールのコンテキスト・ルートを接頭部として JNDI 名に追加する必要があります。 以下の例は、コンテキスト・ルートとして /mfpconsole を使用してコンソールがインストールされている場合に mfp.admin.endpoint を宣言するケースを示しています。

<jndiEntry jndiName="mfpconsole/mfp.admin.endpoint" value="*://*:*/mfpadmin"/>

mfp.admin.endpoint プロパティーの標準的な値は *://*:*/the-adminContextRoot です。
JNDI プロパティーについて詳しくは、MobileFirst Operations Console の JNDI プロパティーを参照してください。

セキュリティー・ロール

アプリケーションの application-bnd エレメントで以下のロールを宣言します。

• mfpadmin
• mfpdeployer
• mfpmonitor
• mfpoperator

このランタイムは、アプリケーション・サーバーにデプロイするための WAR アプリケーションとしてパッケージされています。 server.xml ファイル内で、このアプリケーションに固有の構成をいくつか行う必要があります。 続行する前に、すべてのサービスに共通の構成詳細についてWebSphere Application Server Liberty への手動インストールを検討してください。

ランタイム WAR ファイルは、mfp_install_dir/MobileFirstServer/mfp-server.war にあります。 コンテキスト・ルートは自由に定義できます。 ただし、デフォルトでは /mfp です。

必須の JNDI プロパティー

JNDI プロパティーを定義するとき、ランタイムのコンテキスト・ルートを接頭部として JNDI 名に追加する必要があります。 以下の例は、コンテキスト・ルートとして /mobilefirst を使用してランタイムがインストールされている場合に mfp.analytics.url を宣言するケースを示しています。

<jndiEntry jndiName="mobilefirst/mfp.analytics.url" value="http://localhost:9080/analytics-service/rest"/>

mobilefirst/mfp.authorization.server プロパティーを定義する必要があります。 例えば、次のとおりです。

<jndiEntry jndiName="mobilefirst/mfp.authorization.server" value="embedded"/>

MobileFirst Analytics がインストールされている場合は、以下の JNDI プロパティーを定義する必要があります。

• mfp.analytics.url
• mfp.analytics.console.url
• mfp.analytics.username
• mfp.analytics.password

JNDI プロパティーについて詳しくは、MobileFirst ランタイムの JNDI プロパティーのリストを参照してください。

データ・ソース

ランタイムのデータ・ソースの JNDI 名は、jndiName=the-contextRoot/jdbc/mfpDS と定義する必要があります。 以下の例は、ランタイムが、コンテキスト・ルート /mobilefirst を使用してインストールされており、ランタイムがリレーショナル・データベースを使用しているケースを示しています。

<dataSource jndiName="mobilefirst/jdbc/mfpDS" transactional="false">
  [...]
</dataSource>

プッシュ・サービスは、アプリケーション・サーバーにデプロイするための WAR アプリケーションとしてパッケージされています。 server.xml ファイル内で、このアプリケーションに固有の構成をいくつか行う必要があります。 続行する前に、すべてのサービスに共通の構成詳細についてWebSphere Application Server Liberty への手動インストールを検討してください。

プッシュ・サービスの WAR ファイルは mfp_install_dir/PushService/mfp-push-service.war にあります。 コンテキスト・ルートは /imfpush と定義する必要があります。 さもないと、コンテキスト・ルートは SDK にハードコーディングされているため、クライアント・デバイスはプッシュ・サービスに接続できません。

必須の JNDI プロパティー

JNDI プロパティーを定義するとき、プッシュ・サービスのコンテキスト・ルートを接頭部として JNDI 名に追加する必要があります。 以下の例は、コンテキスト・ルートとして /imfpush を使用してプッシュ・サービスがインストールされている場合に mfp.push.analytics.user を宣言するケースを示しています。

<jndiEntry jndiName="imfpush/mfp.push.analytics.user" value="admin"/>

• mfp.push.authorization.server.url
• mfp.push.authorization.client.id
• mfp.push.authorization.client.secret
• mfp.push.services.ext.security - この値は com.ibm.mfp.push.server.security.plugin.OAuthSecurityPlugin でなければなりません。
• mfp.push.db.type - リレーショナル・データベースの場合、この値は DB でなければなりません。

• mfp.push.analytics.endpoint
• mfp.analytics.username
• mfp.analytics.password
• mfp.push.services.ext.analytics - この値は com.ibm.mfp.push.server.analytics.plugin.AnalyticsPlugin でなければなりません。

この成果物コンポーネントは、アプリケーション・サーバーにデプロイするための WAR アプリケーションとしてパッケージされています。 server.xml ファイル内で、このアプリケーションに固有の構成をいくつか行う必要があります。 続行する前に、すべてのサービスに共通の構成詳細についてWebSphere Application Server Liberty への手動インストールを検討してください。

このコンポーネントの WAR ファイルは mfp_install_dir/MobileFirstServer/mfp-dev-artifacts.war にあります。 コンテキスト・ルートは /mfp-dev-artifacts と定義する必要があります。

管理サービスは、Liberty 集合コントローラーにデプロイするための WAR アプリケーションとしてパッケージされています。 Liberty 集合コントローラーの server.xml ファイル内で、このアプリケーションに固有の構成をいくつか行う必要があります。

続行する前に、すべてのサービスに共通の構成詳細についてWebSphere Application Server Liberty 集合への手動インストールを検討してください。

管理サービスの WAR ファイルは mfp_install_dir/MobileFirstServer/mfp-admin-service-collective.war にあります。 コンテキスト・ルートは自由に定義できます。 ただし、通常は /mfpadmin です。

必須の JNDI プロパティー

JNDI プロパティーを定義するとき、管理サービスのコンテキスト・ルートを接頭部として JNDI 名に追加する必要があります。 以下の例は、コンテキスト・ルートとして /mfpadmin を使用して管理サービスがインストールされている場合に mfp.admin.push.url を宣言するケースを示しています。

<jndiEntry jndiName="mfpadmin/mfp.admin.push.url" value="http://localhost:9080/imfpush"/>

プッシュ・サービスがインストールされている場合は、以下の JNDI プロパティーを構成する必要があります。

• mfp.admin.push.url
• mfp.admin.authorization.server.url
• mfp.push.authorization.client.id
• mfp.push.authorization.client.secret
• mfp.admin.authorization.client.id
• mfp.admin.authorization.client.secret

構成サービスとの通信用の JNDI プロパティーは以下のとおりです。

• mfp.config.service.user
• mfp.config.service.password

JNDI プロパティーについて詳しくは、MobileFirst Server 管理サービスの JNDI プロパティーのリストを参照してください。

データ・ソース

管理サービスのデータ・ソースの JNDI 名は、jndiName=the-contextRoot/jdbc/mfpAdminDS と定義する必要があります。 以下の例は、管理サービスが、コンテキスト・ルート /mfpadmin を使用してインストールされており、そのサービスがリレーショナル・データベースを使用しているケースを示しています。

<dataSource jndiName="mfpadmin/jdbc/mfpAdminDS" transactional="false">
  [...]
</dataSource>

セキュリティー・ロール

アプリケーションの application-bnd エレメントで以下のロールを宣言します。

• mfpadmin
• mfpdeployer
• mfpmonitor
• mfpoperator

ライブ更新サービスは、Liberty 集合コントローラーにデプロイするための WAR アプリケーションとしてパッケージされています。 Liberty 集合コントローラーの server.xml ファイル内で、このアプリケーションに固有の構成をいくつか行う必要があります。

続行する前に、すべてのサービスに共通の構成詳細についてWebSphere Application Server Liberty 集合への手動インストールを検討してください。

ライブ更新サービスの WAR ファイルは mfp_install_dir/MobileFirstServer/mfp-live-update.war にあります。 ライブ更新サービスのコンテキスト・ルートは /the-adminContextRootconfig のように定義する必要があります。 例えば、管理サービスのコンテキスト・ルートが /mfpadmin の場合、ライブ更新サービスのコンテキスト・ルートは /mfpadminconfig でなければなりません。

データ・ソース

ライブ更新サービスのデータ・ソースの JNDI 名は the-contextRoot/jdbc/ConfigDS と定義する必要があります。 以下の例は、ライブ更新サービスが、コンテキスト・ルート /mfpadminconfig を使用してインストールされており、そのサービスがリレーショナル・データベースを使用しているケースを示しています。

<dataSource jndiName="mfpadminconfig/jdbc/ConfigDS" transactional="false">
  [...]
</dataSource>

セキュリティー・ロール

アプリケーションの application-bnd エレメントで configadmin ロールを宣言します。 少なくとも 1 人のユーザーがこのロールにマップされている必要があります。 ユーザーとパスワードは、管理サービスの以下の JNDI プロパティーに指定する必要があります。

• mfp.config.service.user
• mfp.config.service.password

コンソールは、Liberty 集合コントローラーにデプロイするための WAR アプリケーションとしてパッケージされています。 Liberty 集合コントローラーの server.xml ファイル内で、このアプリケーションに固有の構成をいくつか行う必要があります。

続行する前に、すべてのサービスに共通の構成詳細についてWebSphere Application Server Liberty への手動インストールを検討してください。

コンソール WAR ファイルは mfp_install_dir/MobileFirstServer/mfp-admin-ui.war にあります。 コンテキスト・ルートは自由に定義できます。 ただし、通常は /mfpconsole です。

必須の JNDI プロパティー

JNDI プロパティーを定義するとき、コンソールのコンテキスト・ルートを接頭部として JNDI 名に追加する必要があります。 以下の例は、コンテキスト・ルートとして /mfpconsole を使用してコンソールがインストールされている場合に mfp.admin.endpoint を宣言するケースを示しています。

<jndiEntry jndiName="mfpconsole/mfp.admin.endpoint" value="*://*:*/mfpadmin"/>

mfp.admin.endpoint プロパティーの標準的な値は *://*:*/the-adminContextRoot です。
JNDI プロパティーについて詳しくは、MobileFirst Operations Console の JNDI プロパティーを参照してください。

セキュリティー・ロール

アプリケーションの application-bnd エレメントで以下のロールを宣言します。

• mfpadmin
• mfpdeployer
• mfpmonitor
• mfpoperator

ランタイムは、Liberty 集合クラスター・メンバーにデプロイするための WAR アプリケーションとしてパッケージされています。 各 Liberty 集合クラスター・メンバーの server.xml ファイル内で、このアプリケーションに固有の構成をいくつか行う必要があります。

続行する前に、すべてのサービスに共通の構成詳細についてWebSphere Application Server Liberty 集合への手動インストールを検討してください。

ランタイム WAR ファイルは、mfp_install_dir/MobileFirstServer/mfp-server.war にあります。 コンテキスト・ルートは自由に定義できます。 ただし、デフォルトでは /mfp です。

必須の JNDI プロパティー

JNDI プロパティーを定義するとき、ランタイムのコンテキスト・ルートを接頭部として JNDI 名に追加する必要があります。 以下の例は、コンテキスト・ルートとして /mobilefirst を使用してランタイムがインストールされている場合に mfp.analytics.url を宣言するケースを示しています。

<jndiEntry jndiName="mobilefirst/mfp.analytics.url" value="http://localhost:9080/analytics-service/rest"/>

mobilefirst/mfp.authorization.server プロパティーを定義する必要があります。 例えば、次のとおりです。

<jndiEntry jndiName="mobilefirst/mfp.authorization.server" value="embedded"/>

MobileFirst Analytics がインストールされている場合は、以下の JNDI プロパティーを定義する必要があります。

• mfp.analytics.url
• mfp.analytics.console.url
• mfp.analytics.username
• mfp.analytics.password

JNDI プロパティーについて詳しくは、MobileFirst ランタイムの JNDI プロパティーのリストを参照してください。

データ・ソース

ランタイムのデータ・ソースの JNDI 名は、jndiName=the-contextRoot/jdbc/mfpDS と定義する必要があります。 以下の例は、ランタイムが、コンテキスト・ルート /mobilefirst を使用してインストールされており、ランタイムがリレーショナル・データベースを使用しているケースを示しています。

<dataSource jndiName="mobilefirst/jdbc/mfpDS" transactional="false">
  [...]
</dataSource>

プッシュ・サービスは、Liberty 集合クラスター・メンバーまたは Liberty サーバーにデプロイするための WAR アプリケーションとしてパッケージされています。 プッシュ・サービスを Liberty サーバーにインストールする場合、MobileFirst Server プッシュ・サービスの構成の詳細の下の WebSphere Application Server Liberty への手動インストールを参照してください。

MobileFirst Server プッシュ・サービスが Liberty 集合にインストールされる場合、ランタイムと同じクラスターにインストールすることも、別のクラスターにインストールすることもできます。

各 Liberty 集合クラスター・メンバーの server.xml ファイル内で、このアプリケーションに固有の構成をいくつか行う必要があります。 続行する前に、すべてのサービスに共通の構成詳細についてWebSphere Application Server Liberty 集合への手動インストールを検討してください。

プッシュ・サービスの WAR ファイルは mfp_install_dir/PushService/mfp-push-service.war にあります。 コンテキスト・ルートは /imfpush と定義する必要があります。 さもないと、コンテキスト・ルートは SDK にハードコーディングされているため、クライアント・デバイスはプッシュ・サービスに接続できません。

必須の JNDI プロパティー

JNDI プロパティーを定義するとき、プッシュ・サービスのコンテキスト・ルートを接頭部として JNDI 名に追加する必要があります。 以下の例は、コンテキスト・ルートとして /imfpush を使用してプッシュ・サービスがインストールされている場合に mfp.push.analytics.user を宣言するケースを示しています。

<jndiEntry jndiName="imfpush/mfp.push.analytics.user" value="admin"/>

• mfp.push.authorization.server.url
• mfp.push.authorization.client.id
• mfp.push.authorization.client.secret
• mfp.push.services.ext.security - この値は com.ibm.mfp.push.server.security.plugin.OAuthSecurityPlugin でなければなりません。
• mfp.push.db.type - リレーショナル・データベースの場合、この値は DB でなければなりません。

• mfp.push.analytics.endpoint
• mfp.analytics.username
• mfp.analytics.password
• mfp.push.services.ext.analytics - この値は com.ibm.mfp.push.server.analytics.plugin.AnalyticsPlugin でなければなりません。

成果物コンポーネントは、Liberty 集合コントローラーにデプロイするための WAR アプリケーションとしてパッケージされています。 Liberty 集合コントローラーの server.xml ファイル内で、このアプリケーションに固有の構成をいくつか行う必要があります。 続行する前に、すべてのサービスに共通の構成詳細についてWebSphere Application Server Liberty への手動インストールを検討してください。

このコンポーネントの WAR ファイルは mfp_install_dir/MobileFirstServer/mfp-dev-artifacts.war にあります。 コンテキスト・ルートは /mfp-dev-artifacts と定義する必要があります。

管理サービスは、アプリケーション・サーバーにデプロイするための WAR アプリケーションとしてパッケージされています。 アプリケーション・サーバーの server.xml ファイル内で、このアプリケーションに固有の構成をいくつか行う必要があります。

続行する前に、すべてのサービスに共通の構成詳細についてApache Tomcat への手動インストールを検討してください。

管理サービスの WAR ファイルは mfp_install_dir/MobileFirstServer/mfp-admin-service.war にあります。 コンテキスト・ルートは自由に定義できます。 ただし、通常は /mfpadmin です。

必須の JNDI プロパティー

JNDI プロパティーは、アプリケーション・コンテキストの Environment エレメント内に定義されます。 例えば、次のとおりです。

<Environment name="mfp.admin.push.url" value="http://localhost:8080/imfpush" type="java.lang.String" override="false"/>

ランタイムとの JMX 通信を使用可能にするには、以下の JNDI プロパティーを定義します。

• mfp.topology.platform
• mfp.topology.clustermode

プッシュ・サービスがインストールされている場合は、以下の JNDI プロパティーを構成する必要があります。

• mfp.admin.push.url
• mfp.admin.authorization.server.url
• mfp.push.authorization.client.id
• mfp.push.authorization.client.secret
• mfp.admin.authorization.client.id
• mfp.admin.authorization.client.secret

構成サービスとの通信用の JNDI プロパティーは以下のとおりです。

• mfp.config.service.user
• mfp.config.service.password

JNDI プロパティーについて詳しくは、MobileFirst Server 管理サービスの JNDI プロパティーのリストを参照してください。

データ・ソース

データ・ソース (jdbc/mfpAdminDS) は、**Context** エレメントでリソースとして宣言されます。 例えば、次のとおりです。

<Resource name="jdbc/mfpAdminDS" type="javax.sql.DataSource" .../>

セキュリティー・ロール

管理サービス・アプリケーションで使用可能なセキュリティー・ロールは以下のとおりです。

• mfpadmin
• mfpdeployer
• mfpmonitor
• mfpoperator

ライブ更新サービスは、アプリケーション・サーバーにデプロイするための WAR アプリケーションとしてパッケージされています。 server.xml ファイル内で、このアプリケーションに固有の構成をいくつか行う必要があります。

続行する前に、すべてのサービスに共通の構成詳細についてApache Tomcat への手動インストールを検討してください。

ライブ更新サービスの WAR ファイルは mfp_install_dir/MobileFirstServer/mfp-live-update.war にあります。 ライブ更新サービスのコンテキスト・ルートは /the-adminContextRoot/config のように定義する必要があります。 例えば、管理サービスのコンテキスト・ルートが /mfpadmin の場合、ライブ更新サービスのコンテキスト・ルートは /mfpadminconfig でなければなりません。

データ・ソース

ライブ更新サービスのデータ・ソースの JNDI 名は jdbc/ConfigDS と定義する必要があります。 それを Context エレメントでリソースとして宣言します。

セキュリティー・ロール

ライブ更新サービス・アプリケーションで使用可能なセキュリティー・ロールは configadmin です。

少なくとも 1 人のユーザーがこのロールにマップされている必要があります。 ユーザーとパスワードは、管理サービスの以下の JNDI プロパティーに指定する必要があります。

• mfp.config.service.user
• mfp.config.service.password

このコンソールは、アプリケーション・サーバーにデプロイするための WAR アプリケーションとしてパッケージされています。 アプリケーション・サーバーの server.xml ファイル内で、このアプリケーションに固有の構成をいくつか行う必要があります。

続行する前に、すべてのサービスに共通の構成詳細についてApache Tomcat への手動インストールを検討してください。

コンソール WAR ファイルは mfp_install_dir/MobileFirstServer/mfp-admin-ui.war にあります。 コンテキスト・ルートは自由に定義できます。 ただし、通常は /mfpconsole です。

必須の JNDI プロパティー

mfp.admin.endpoint プロパティーを定義する必要があります。 このプロパティーの標準的な値は *://*:*/the-adminContextRoot です。

JNDI プロパティーについて詳しくは、MobileFirst Operations Console の JNDI プロパティーを参照してください。

セキュリティー・ロール

このアプリケーションで使用可能なセキュリティー・ロールは以下のとおりです。

• mfpadmin
• mfpdeployer
• mfpmonitor
• mfpoperator

このランタイムは、アプリケーション・サーバーにデプロイするための WAR アプリケーションとしてパッケージされています。 server.xml ファイル内で、このアプリケーションに固有の構成をいくつか行う必要があります。

続行する前に、すべてのサービスに共通の構成詳細についてApache Tomcat への手動インストールを検討してください。

ランタイム WAR ファイルは、mfp_install_dir/MobileFirstServer/mfp-server.war にあります。 コンテキスト・ルートは自由に定義できます。 ただし、デフォルトでは /mfp です。

必須の JNDI プロパティー

mfp.authorization.server プロパティーを定義する必要があります。 例えば、次のとおりです。

<Environment name="mfp.authorization.server" value="embedded" type="java.lang.String" override="false"/>

管理サービスとの JMX 通信を使用可能にするには、以下の JNDI プロパティーを定義します。

• mfp.topology.platform
• mfp.topology.clustermode

MobileFirst Analytics がインストールされている場合は、以下の JNDI プロパティーを定義する必要があります。

• mfp.analytics.url
• mfp.analytics.console.url
• mfp.analytics.username
• mfp.analytics.password

JNDI プロパティーについて詳しくは、MobileFirst ランタイムの JNDI プロパティーのリストを参照してください。

データ・ソース

ランタイムのデータ・ソースの JNDI 名は jdbc/mfpDS と定義する必要があります。 それを Context エレメントでリソースとして宣言します。

プッシュ・サービスは、アプリケーション・サーバーにデプロイするための WAR アプリケーションとしてパッケージされています。 このアプリケーションに固有の構成をいくつか実行する必要があります。 続行する前に、すべてのサービスに共通の構成詳細についてApache Tomcat への手動インストールを検討してください。

プッシュ・サービスの WAR ファイルは mfp_install_dir/PushService/mfp-push-service.war にあります。 コンテキスト・ルートは /imfpush と定義する必要があります。 さもないと、コンテキスト・ルートは SDK にハードコーディングされているため、クライアント・デバイスはプッシュ・サービスに接続できません。

必須の JNDI プロパティー

以下のプロパティーを定義する必要があります。

• mfp.push.authorization.server.url
• mfp.push.authorization.client.id
• mfp.push.authorization.client.secret
• mfp.push.services.ext.security - この値は com.ibm.mfp.push.server.security.plugin.OAuthSecurityPlugin でなければなりません。
• mfp.push.db.type - リレーショナル・データベースの場合、この値は DB でなければなりません。

MobileFirst Analytics が構成されている場合は、以下の JNDI プロパティーを定義します。

• mfp.push.analytics.endpoint
• mfp.analytics.username
• mfp.analytics.password
• mfp.push.services.ext.analytics - この値は com.ibm.mfp.push.server.analytics.plugin.AnalyticsPlugin でなければなりません。

この成果物コンポーネントは、アプリケーション・サーバーにデプロイするための WAR アプリケーションとしてパッケージされています。 アプリケーション・サーバーの server.xml ファイル内で、このアプリケーションに固有の構成をいくつか行う必要があります。 続行する前に、すべてのサービスに共通の構成詳細についてApache Tomcat への手動インストールを検討してください。

このコンポーネントの WAR ファイルは mfp_install_dir/MobileFirstServer/mfp-dev-artifacts.war にあります。 コンテキスト・ルートは /mfp-dev-artifacts と定義する必要があります。

管理サービスは、アプリケーション・サーバーにデプロイするための WAR アプリケーションとしてパッケージされています。 アプリケーション・サーバーの server.xml ファイル内で、このアプリケーションに固有の構成をいくつか行う必要があります。

続行する前に、すべてのサービスに共通の構成詳細についてWebSphere Application Server および WebSphere Application Server Network Deployment への手動インストールを検討してください。

管理サービスの WAR ファイルは mfp_install_dir/MobileFirstServer/mfp-admin-service.war にあります。 コンテキスト・ルートは自由に定義できます。 ただし、通常は /mfpadmin です。

必須の JNDI プロパティー

JNDI プロパティーは、WebSphere Application Server 管理コンソールを使用して設定できます。 「アプリケーション」→「アプリケーション・タイプ」→「WebSphere エンタープライズ・アプリケーション」→「application_name」→「Web モジュールの環境項目」を選択し、項目を設定します。

ランタイムとの JMX 通信を使用可能にするには、以下の JNDI プロパティーを定義します。

• mfp.admin.jmx.dmgr.host
• mfp.admin.jmx.dmgr.port - デプロイメント・マネージャー上の SOAP ポート。
• mfp.topology.platform - 値を WAS に設定します。
• mfp.topology.clustermode - 値を Cluster に設定します。
• mfp.admin.jmx.connector - 値を SOAP に設定します。

• mfp.topology.platform - 値を WAS に設定します。
• mfp.topology.clustermode - 値を Standalone に設定します。
• mfp.admin.jmx.connector - 値を SOAP に設定します。

プッシュ・サービスがインストールされている場合は、以下の JNDI プロパティーを構成する必要があります。

• mfp.admin.push.url
• mfp.admin.authorization.server.url
• mfp.push.authorization.client.id
• mfp.push.authorization.client.secret
• mfp.admin.authorization.client.id
• mfp.admin.authorization.client.secret

構成サービスとの通信用の JNDI プロパティーは以下のとおりです。

• mfp.config.service.user
• mfp.config.service.password

JNDI プロパティーについて詳しくは、MobileFirst Server 管理サービスの JNDI プロパティーのリストを参照してください。

データ・ソース

管理サービス用のデータ・ソースを作成し、それを jdbc/mfpAdminDS にマップします。

始動順序

管理サービス・アプリケーションは、ランタイム・アプリケーションの前に始動する必要があります。 順序は、「始動の動作」セクションで設定できます。 例えば、管理サービスでは Startup Order を 1 に設定し、ランタイムでは 2 に設定します。

セキュリティー・ロール

管理サービス・アプリケーションで使用可能なセキュリティー・ロールは以下のとおりです。

• mfpadmin
• mfpdeployer
• mfpmonitor
• mfpoperator

ライブ更新サービスは、アプリケーション・サーバーにデプロイするための WAR アプリケーションとしてパッケージされています。 server.xml ファイル内で、このアプリケーションに固有の構成をいくつか行う必要があります。

続行する前に、すべてのサービスに共通の構成詳細についてWebSphere Application Server および WebSphere Application Server Network Deployment への手動インストールを検討してください。

ライブ更新サービスの WAR ファイルは mfp_install_dir/MobileFirstServer/mfp-live-update.war にあります。 ライブ更新サービスのコンテキスト・ルートは /the-adminContextRoot/config のように定義する必要があります。 例えば、管理サービスのコンテキスト・ルートが /mfpadmin の場合、ライブ更新サービスのコンテキスト・ルートは /mfpadminconfig でなければなりません。

データ・ソース

ライブ更新サービスのデータ・ソースを作成し、それを jdbc/ConfigDS にマップします。

セキュリティー・ロール

このアプリケーションに対して configadmin ロールが定義されています。

少なくとも 1 人のユーザーがこのロールにマップされている必要があります。 ユーザーとパスワードは、管理サービスの以下の JNDI プロパティーに指定する必要があります。

• mfp.config.service.user
• mfp.config.service.password

このコンソールは、アプリケーション・サーバーにデプロイするための WAR アプリケーションとしてパッケージされています。 アプリケーション・サーバーの server.xml ファイル内で、このアプリケーションに固有の構成をいくつか行う必要があります。

続行する前に、すべてのサービスに共通の構成詳細についてWebSphere Application Server および WebSphere Application Server Network Deployment への手動インストールを検討してください。

コンソール WAR ファイルは mfp_install_dir/MobileFirstServer/mfp-admin-ui.war にあります。 コンテキスト・ルートは自由に定義できます。 ただし、通常は /mfpconsole です。

必須の JNDI プロパティー

JNDI プロパティーは、WebSphere Application Server 管理コンソールを使用して設定できます。 「アプリケーション」→「アプリケーション・タイプ」→「WebSphere エンタープライズ・アプリケーション」→「application_name」→「Web モジュールの環境項目」を選択し、項目を設定します。

mfp.admin.endpoint プロパティーを定義する必要があります。 このプロパティーの標準的な値は *://*:*/the-adminContextRoot です。

JNDI プロパティーについて詳しくは、MobileFirst Operations Console の JNDI プロパティーを参照してください。

セキュリティー・ロール

このアプリケーションで使用可能なセキュリティー・ロールは以下のとおりです。

• mfpadmin
• mfpdeployer
• mfpmonitor
• mfpoperator

このランタイムは、アプリケーション・サーバーにデプロイするための WAR アプリケーションとしてパッケージされています。 server.xml ファイル内で、このアプリケーションに固有の構成をいくつか行う必要があります。

続行する前に、すべてのサービスに共通の構成詳細についてWebSphere Application Server および WebSphere Application Server Network Deployment への手動インストールを検討してください。

ランタイム WAR ファイルは、mfp_install_dir/MobileFirstServer/mfp-server.war にあります。 コンテキスト・ルートは自由に定義できます。 ただし、デフォルトでは /mfp です。

必須の JNDI プロパティー

JNDI プロパティーは、WebSphere Application Server 管理コンソールを使用して設定できます。 「アプリケーション」→「アプリケーション・タイプ」→「WebSphere エンタープライズ・アプリケーション」→「application_name」→「Web モジュールの環境項目」を選択し、項目を設定します。

mfp.authorization.server プロパティーに値 embedded を定義する必要があります。
また、以下の JNDI プロパティーを定義して、管理サービスとの JMX 通信を使用可能にする必要があります。

• mfp.admin.jmx.dmgr.host - デプロイメント・マネージャーのホスト名。
• mfp.admin.jmx.dmgr.port - デプロイメント・マネージャーの SOAP ポート。
• mfp.topology.platform - 値を WAS に設定します。
• mfp.topology.clustermode - 値を Cluster に設定します。
• mfp.admin.jmx.connector - 値を SOAP に設定します。

• mfp.topology.platform - 値を WAS に設定します。
• mfp.topology.clustermode - 値を Standalone に設定します。
• mfp.admin.jmx.connector - 値を SOAP に設定します。

MobileFirst Analytics がインストールされている場合は、以下の JNDI プロパティーを定義する必要があります。

• mfp.analytics.url
• mfp.analytics.console.url
• mfp.analytics.username
• mfp.analytics.password

JNDI プロパティーについて詳しくは、MobileFirst ランタイムの JNDI プロパティーのリストを参照してください。

始動順序

ランタイム・アプリケーションは、管理サービス・アプリケーションの後に始動する必要があります。 順序は、「始動の動作」セクションで設定できます。 例えば、管理サービスでは Startup Order を 1 に設定し、ランタイムでは 2 に設定します。

データ・ソース

ランタイムのデータ・ソースを作成し、それを jdbc/mfpDS にマップします。

プッシュ・サービスは、アプリケーション・サーバーにデプロイするための WAR アプリケーションとしてパッケージされています。 このアプリケーションに固有の構成をいくつか実行する必要があります。 続行する前に、すべてのサービスに共通の構成詳細についてWebSphere Application Server および WebSphere Application Server Network Deployment への手動インストールを検討してください。

プッシュ・サービスの WAR ファイルは mfp_install_dir/PushService/mfp-push-service.war にあります。 コンテキスト・ルートは /imfpush と定義する必要があります。 さもないと、コンテキスト・ルートは SDK にハードコーディングされているため、クライアント・デバイスはプッシュ・サービスに接続できません。

必須の JNDI プロパティー

JNDI プロパティーは、WebSphere Application Server 管理コンソールを使用して設定できます。 「アプリケーション」→「アプリケーション・タイプ」→「WebSphere エンタープライズ・アプリケーション」→「application_name」→「Web モジュールの環境項目」を選択し、項目を設定します。

以下のプロパティーを定義する必要があります。

• mfp.push.authorization.server.url
• mfp.push.authorization.client.id
• mfp.push.authorization.client.secret
• mfp.push.services.ext.security - この値は com.ibm.mfp.push.server.security.plugin.OAuthSecurityPlugin でなければなりません。
• mfp.push.db.type - リレーショナル・データベースの場合、この値は DB でなければなりません。

MobileFirst Analytics が構成されている場合は、以下の JNDI プロパティーを定義します。

• mfp.push.analytics.endpoint
• mfp.analytics.username
• mfp.analytics.password
• mfp.push.services.ext.analytics - この値は com.ibm.mfp.push.server.analytics.plugin.AnalyticsPlugin でなければなりません。

JNDI プロパティーについて詳しくは、MobileFirst Server プッシュ・サービスの JNDI プロパティーのリストを参照してください。

データ・ソース

プッシュ・サービスのデータ・ソースを作成し、それを jdbc/imfPushDS にマップします。

この成果物コンポーネントは、アプリケーション・サーバーにデプロイするための WAR アプリケーションとしてパッケージされています。 アプリケーション・サーバーの server.xml ファイル内で、このアプリケーションに固有の構成をいくつか行う必要があります。 続行する前に、すべてのサービスに共通の構成詳細についてWebSphere Application Server および WebSphere Application Server Network Deployment への手動インストールを検討してください。

このコンポーネントの WAR ファイルは mfp_install_dir/MobileFirstServer/mfp-dev-artifacts.war にあります。 コンテキスト・ルートは /mfp-dev-artifacts と定義する必要があります。

MobileFirst Server では、セキュア JMX 接続が構成されている必要があります。

1. サーバー・ファームのメンバーとして構成される必要のあるアプリケーション・サーバーを準備します。
   • サーバー・ファームのメンバーを構成するために使用するアプリケーション・サーバーのタイプを選択します。 Mobile Foundation は、サーバー・ファーム内の以下のアプリケーション・サーバーをサポートしています。
     • WebSphere Application Server フル・プロファイル
       注: ファーム・トポロジーでは、RMI JMX コネクターを使用できません。 このトポロジーでは、Mobile Foundation は SOAP コネクターのみをサポートします。
     • WebSphere Application Server Liberty プロファイル
     • Apache Tomcat
     サポートされているアプリケーション・サーバーのバージョンについては、システム要件を参照してください。

     重要: Mobile Foundation では、同種のサーバー・ファームのみがサポートされます。 同じタイプのアプリケーション・サーバーを接続する場合、サーバー・ファームは同種です。 異なるタイプのアプリケーション・サーバーを関連付けようとすると、予測不能の動作が実行時に起こる可能性があります。 例えば、Apache Tomcat サーバーと WebSphere Application Server フル・プロファイル・サーバーを混在させたファームは、無効な構成になります。

   • ファーム内で必要になるメンバーの数と同じ数のスタンドアロン・サーバーをセットアップします。
     • これらのスタンドアロン・サーバーは、それぞれが同じデータベースと通信する必要があります。 これらのサーバーによって使用されるすべてのポートが、同じホスト上で構成されている他のサーバーによっても使用されることのないように注意してください。 この制約は、HTTP、HTTPS、REST、SOAP、および RMI の各プロトコルによって使用されるポートに適用されます。
     • これらのサーバーは、それぞれに MobileFirst Server 管理サービス、MobileFirst Server ライブ更新サービス、および 1 つ以上の MobileFirstランタイムがデプロイされている必要があります。
     • サーバーのセットアップについて詳しくは、MobileFirst Server 管理サービス、MobileFirst Server ライブ更新サービス、および MobileFirst ランタイムでの制約を参照してください。
   • すべてのサーバー間でそれぞれのトラストストア内の署名者証明書を交換します。
     
     

     注: WebSphere Application Server フル・プロファイルまたは Liberty を使用するファームの場合、セキュリティーが有効にされる必要があるため、このステップは必須です。さらに、Liberty ファームの場合、シングル・サインオンが可能となるように、同じ LTPA 構成が各サーバー上で複製される必要があります。 この構成を行うには、手動でのサーバー・ファームの構成のステップ 6 で説明されているガイドラインに従ってください。

2. ファームの各サーバーに対してサーバー構成ツールを実行します。 すべてのサーバーが同じデータベースを共有する必要があります。 「アプリケーション・サーバー設定」パネルで、デプロイメント・タイプ「サーバー・ファーム・デプロイメント (Server farm deployment)」を選択してください。 このツールについて詳しくは、サーバー構成ツールの実行を参照してください。

MobileFirst Server では、セキュア JMX 接続が構成されている必要があります。

1. サーバー・ファームのメンバーとして構成される必要のあるアプリケーション・サーバーを準備します。
   • サーバー・ファームのメンバーを構成するために使用するアプリケーション・サーバーのタイプを選択します。 Mobile Foundation は、サーバー・ファーム内の以下のアプリケーション・サーバーをサポートしています。
     • WebSphere Application Server フル・プロファイル。 注: ファーム・トポロジーでは、RMI JMX コネクターを使用できません。 このトポロジーでは、Mobile Foundation は SOAP コネクターのみをサポートします。
     • WebSphere Application Server Liberty プロファイル
     • Apache Tomcat
     サポートされているアプリケーション・サーバーのバージョンについては、システム要件を参照してください。

     重要: Mobile Foundation では、同種のサーバー・ファームのみがサポートされます。 同じタイプのアプリケーション・サーバーを接続する場合、サーバー・ファームは同種です。 異なるタイプのアプリケーション・サーバーを関連付けようとすると、予測不能の動作が実行時に起こる可能性があります。 例えば、Apache Tomcat サーバーと WebSphere Application Server フル・プロファイル・サーバーを混在させたファームは、無効な構成になります。

   • ファーム内で必要になるメンバーの数と同じ数のスタンドアロン・サーバーをセットアップします。
     
     これらのスタンドアロン・サーバーは、それぞれが同じデータベースと通信する必要があります。 これらのサーバーによって使用されるすべてのポートが、同じホスト上で構成されている他のサーバーによっても使用されることのないように注意してください。 この制約は、HTTP、HTTPS、REST、SOAP、および RMI の各プロトコルによって使用されるポートに適用されます。
     
     これらのサーバーは、それぞれに MobileFirst Server 管理サービス、MobileFirst Server ライブ更新サービス、および 1 つ以上の MobileFirstランタイムがデプロイされている必要があります。
     
     サーバーのセットアップについて詳しくは、MobileFirst Server 管理サービス、MobileFirst Server ライブ更新サービス、および MobileFirst ランタイムでの制約を参照してください。
   • すべてのサーバー間でそれぞれのトラストストア内の署名者証明書を交換します。
     
     

     注: WebSphere Application Server フル・プロファイルまたは Liberty を使用するファームの場合、セキュリティーが有効にされる必要があるため、このステップは必須です。さらに、Liberty ファームの場合、シングル・サインオンが可能となるように、同じ LTPA 構成が各サーバー上で複製される必要があります。 この構成を行うには、手動でのサーバー・ファームの構成

     のステップ 6 で説明されているガイドラインに従ってください。
2. 管理サービス、ライブ更新サービス、およびランタイム用にデータベースを構成します。
   • 使用したいデータベースを決定し、mfp_install_dir/MobileFirstServer/configuration-samples ディレクトリー内で、データベースを作成して構成するための Ant ファイルを選択します。
     • DB2 の場合、create-database-db2.xml を使用します。
     • MySQL の場合、create-database-mysql.xml を使用します。
     • Oracle の場合、create-database-oracle.xml を使用します。

     注: Derby データベースでは同時に許可されるのは 1 つのみの接続であるため、ファーム・トポロジーでは Derby データベースを使用しないでください。

   • Ant ファイルを編集して、データベースに必要なプロパティーをすべて入力します。
     
     MobileFirst Server コンポーネントによって使用されるデータベースの構成を有効にするため、以下のプロパティーの値を設定します。
     • mfp.process.admin を true に設定します。 これは、管理サービスおよびライブ更新サービス用にデータベースを構成するためです。
     • mfp.process.runtime を true に設定します。 これは、ランタイム用にデータベースを構成するためです。
   • mfp_install_dir/MobileFirstServer/configuration-samples ディレクトリーから以下のコマンドを実行します。create-database-ant-file.xml は選択した実際の Ant ファイル名に置き換えてください。mfp_install_dir/shortcuts/ant -f create-database-ant-file.xml admdatabases および mfp_install_dir/shortcuts/ant -f create-database-ant-file.xml rtmdatabases
     
     MobileFirst Server データベースはファーム内のアプリケーション・サーバー間で共有されるため、これら 2 つのコマンドは、ファーム内のサーバーの数にかかわらず、1 回のみ実行すればすみます。
   • オプションで、別のランタイムを実行したい場合は、別のデータベースを別のデータベース名またはスキーマで構成する必要があります。 これを行うには、Ant ファイルを編集してプロパティーを変更し、ファーム内のサーバーの数にかかわらず、以下のコマンドを 1 回だけ実行します。mfp_install_dir/shortcuts/ant -f create-database-ant-file.xml rtmdatabases
3. 管理サービス、ライブ更新サービス、およびランタイムをサーバーにデプロイし、これらのサーバーをサーバー・ファームのメンバーとして構成します。
   • 管理サービス、ライブ更新サービス、およびランタイムをサーバーにデプロイするため、ご使用のアプリケーション・サーバーおよびデータベースに対応する Ant ファイルを mfp\_install\_dir/MobileFirstServer/configuration-samples ディレクトリー内で選択します。
     
     例えば、DB2 データベースを使用する Liberty サーバーでのデプロイメントの場合、configure-liberty-db2.xml ファイルを選択します。 ファームのメンバーにしたい数だけ、このファイルのコピーを作成します。
     
     注: これらのファイルは構成が終わっても保持しておいてください。これらのファイルは、既にデプロイ済みの MobileFirst Server コンポーネントをアップグレードする場合や、ファームの各メンバーからアンインストールする場合に再使用できます。
   • Ant ファイルの各コピーを編集して、ステップ 2 で使用したのと同じデータベースのプロパティーを入力し、アプリケーション・サーバーについての他の必要なプロパティーも入力します。
     
     サーバーをサーバー・ファーム・メンバーとして構成するため、以下のプロパティーの値を設定します。
     • mfp.farm.configure を true に設定します。
     • mfp.farm.server.id: このファーム・メンバーに対して定義する ID。 ファーム内の各サーバーがそれぞれ固有の ID を持っていることを確認してください。 ファーム内の 2 つのサーバーの ID が同じであると、ファームは予測不能な動作をする可能性があります。
     • mfp.config.service.user: ライブ更新サービスにアクセスするために使用されるユーザー名。 ユーザー名はファームのすべてのメンバーで同じでなければなりません。
     • mfp.config.service.password: ライブ更新サービスにアクセスするために使用されるパスワード。 パスワードはファームのすべてのメンバーで同じでなければなりません。
     サーバーでの MobileFirst Server コンポーネントの WAR ファイルのデプロイメントを有効にするため、以下のプロパティーの値を設定します。
     • mfp.process.admin を true に設定します。 これは、管理サービスおよびライブ更新サービスの WAR ファイルをデプロイするためです。
     • mfp.process.runtime を true に設定します。 これは、ランタイムの WAR ファイルをデプロイするためです。
     
     注: ファームのサーバーに複数のランタイムをインストールすることを計画している場合、Ant タスク installmobilefirstruntime、updatemobilefirstruntime、および uninstallmobilefirstruntime に id 属性を指定し、各ランタイムで固有の値を設定します。
     以下に例を示します。

     <target name="rtminstall">
         <installmobilefirstruntime execute="true" contextroot="/runtime1" id="rtm1">

   • 各サーバーに対して以下のコマンドを実行します。configure-appserver-database-ant-file.xml は選択した実際の Ant ファイル名に置き換えてください。mfp_install_dir/shortcuts/ant -f configure-appserver-database-ant-file.xml adminstall および mfp_install_dir/shortcuts/ant -f configure-appserver-database-ant-file.xml rtminstall
     
     これらのコマンドは、Ant タスク installmobilefirstadmin および installmobilefirstruntime を実行します。 これらのタスクについて詳しくは、MobileFirst Operations Console、MobileFirst Server 成果物、MobileFirst Server 管理サービス、およびライブ更新サービスのインストールのための Ant タスクおよび MobileFirst ランタイム環境のインストールに関する Ant タスクを参照してください。
   • オプションで、別のランタイムをインストールしたい場合は、以下のステップを実行します。
     • ステップ 3.b で構成した Ant ファイルのコピーを作成します。
     • そのコピーを編集して、installmobilefirstruntime、updatemobilefirstruntime、および uninstallmobilefirstruntime に、別のコンテキスト・ルートと、他のランタイム構成とは異なる id 属性の値を設定します。
     • 以下のコマンドをファームの各サーバーで実行します。configure-appserver-database-ant-file2.xml は、編集した Ant ファイルの実際の名前に置き換えてください。mfp_install_dir/shortcuts/ant -f configure-appserver-database-ant-file2.xml rtminstall
     • ファームの各サーバーについてこのステップを繰り返します。
4. すべてのサーバーを再始動します。

1. サーバー・ファームのメンバーを構成するために使用するアプリケーション・サーバーのタイプを選択します。 Mobile Foundation は、サーバー・ファーム内の以下のアプリケーション・サーバーをサポートしています。
   • WebSphere Application Server フル・プロファイル
     注: ファーム・トポロジーでは、RMI JMX コネクターを使用できません。 このトポロジーでは、Mobile Foundation は SOAP コネクターのみをサポートします。
   • WebSphere Application Server Liberty プロファイル
   • Apache Tomcat
   サポートされているアプリケーション・サーバーのバージョンについては、システム要件を参照してください。

   重要: Mobile Foundation では、同種のサーバー・ファームのみがサポートされます。 同じタイプのアプリケーション・サーバーを接続する場合、サーバー・ファームは同種です。 異なるタイプのアプリケーション・サーバーを関連付けようとすると、予測不能の動作が実行時に起こる可能性があります。 例えば、Apache Tomcat サーバーと WebSphere Application Server フル・プロファイル・サーバーを混在させたファームは、無効な構成になります。

2. 使用するデータベースを決定します。 以下の中から選択できます。
   • DB2
   • MySQL
   • Oracle
   MobileFirst Server データベースは、ファーム内のアプリケーション・サーバーの間で共有されます。このことは以下のような意味を持ちます。
   • ファーム内のサーバーの数にかかわらず、データベースを作成するのは 1 回のみです。
   • ファーム・トポロジーでは Derby データベースを使用できません。これは、Derby データベースが同時に 1 つの接続しか許可しないからです。
   データベースについて詳しくは、データベースのセットアップを参照してください。
3. ファーム内で必要になるメンバーの数と同じ数のスタンドアロン・サーバーをセットアップします。
   • これらのスタンドアロン・サーバーは、それぞれが同じデータベースと通信する必要があります。 これらのサーバーによって使用されるすべてのポートが、同じホスト上で構成されている他のサーバーによっても使用されることのないように注意してください。 この制約は、HTTP、HTTPS、REST、SOAP、および RMI の各プロトコルによって使用されるポートに適用されます。
   • これらのサーバーは、それぞれに MobileFirst Server 管理サービス、MobileFirst Server ライブ更新サービス、および 1 つ以上の MobileFirstランタイムがデプロイされている必要があります。
   • これらのサーバーがそれぞれスタンドアロン・トポロジーで正常に稼働している場合には、それらをサーバー・ファームのメンバーに変換できます。
4. ファームのメンバーにする予定のサーバーをすべて停止します。
5. アプリケーション・サーバーのタイプに合わせて各サーバーを適切に構成します。
   いくつかの JNDI プロパティーを正しく設定する必要があります。 サーバー・ファーム・トポロジーでは、JNDI プロパティー mfp.config.service.user および mfp.config.service.password は、ファームのすべてのメンバーで同じでなければなりません。 Apache Tomcat の場合には、JVM 引数が適正に定義されていることを確認する必要もあります。
   • WebSphere Application Server Liberty プロファイル
     server.xml ファイルで、以下のサンプル・コードに示される JNDI プロパティーを設定します。

     <jndiEntry jndiName="mfp.topology.clustermode" value="Farm"/>
     <jndiEntry jndiName="mfp.admin.serverid" value="farm_member_1"/>
     <jndiEntry jndiName="mfp.admin.jmx.user" value="myRESTConnectorUser"/>
     <jndiEntry jndiName="mfp.admin.jmx.pwd" value="password-of-rest-connector-user"/>
     <jndiEntry jndiName="mfp.admin.jmx.host" value="93.12.0.12"/>
     <jndiEntry jndiName="mfp.admin.jmx.port" value="9443"/>

     これらのプロパティーは、適切な値で設定する必要があります。
     • mfp.admin.serverid: このファーム・メンバー用に定義された ID。 この ID は、すべてのファーム・メンバーにわたって固有である必要があります。
     • mfp.admin.jmx.user および mfp.admin.jmx.pwd: これらの値は、administrator-role エレメントで宣言したユーザーの資格情報と一致する必要があります。
     • mfp.admin.jmx.host: このパラメーターには、リモート・メンバーがこのサーバーにアクセスするために使用する IP またはホスト名を設定します。 したがたって、localhost には設定しないでください。 このホスト名はファームの他のメンバーによって使用されるため、すべてのファーム・メンバーにとってアクセス可能でなければなりません。
     • mfp.admin.jmx.port: このパラメーターには、JMX REST 接続に使用するサーバー HTTPS ポートを設定します。 この値は、server.xml ファイルの httpEndpoint エレメントにあります。
   • Apache Tomcat
     管理サービスのコンテキストおよびすべてのランタイムのコンテキストで以下の JNDI プロパティーを設定するために、conf/server.xml ファイルを変更します。

     <Environment name="mfp.topology.clustermode" value="Farm" type="java.lang.String" override="false"/>
     <Environment name="mfp.admin.serverid" value="farm_member_1" type="java.lang.String" override="false"/>

     mfp.admin.serverid プロパティーは、このファーム・メンバーに対して定義した ID に設定する必要があります。この ID は、すべてのファーム・メンバーにわたって固有である必要があります。
     -Djava.rmi.server.hostname JVM 引数は、リモート・メンバーがこのサーバーにアクセスするために使用する IP またはホスト名に必ず設定しなければなりません。 したがたって、localhost には設定しないでください。 さらに、-Dcom.sun.management.jmxremote.port JVM 引数の設定に使用されるポートが、JMX RMI 接続を有効にするために既に使用中のポートではないことを確認する必要があります。 両方の引数が CATALINA_OPTS 環境変数で設定されます。
   • WebSphere Application Server フル・プロファイル
     管理サービスおよびサーバー上でデプロイされたすべてのランタイム・アプリケーションで、以下の JNDI プロパティーを宣言する必要があります。
     • mfp.topology.clustermode
     • mfp.admin.serverid
     WebSphere Application Server コンソールで、以下を行います。
     • 「アプリケーション」→「アプリケーション・タイプ」→「WebSphere エンタープライズ・アプリケーション」を選択します。
     • 管理サービス・アプリケーションを選択します。
     • 「Web モジュール・プロパティー」で「Web モジュールの環境項目」をクリックして、JNDI プロパティーを表示します。
     • 以下のプロパティーの値を設定します。
       • mfp.topology.clustermode を Farm に設定します。
       • mfp.admin.serverid をこのファーム・メンバーに割り当てた ID に設定します。 この ID は、すべてのファーム・メンバーにわたって固有である必要があります。
       • mfp.admin.jmx.user を SOAP コネクターにアクセスできるユーザー名に設定します。
       • mfp.admin.jmx.pwd を mfp.admin.jmx.user で宣言したユーザーのパスワードに設定します。
       • mfp.admin.jmx.port を SOAP ポートの値に設定します。
     • mfp.admin.jmx.connector が SOAP に設定されていることを確認します。
     • 「OK」をクリックし、構成を保存します。
     • サーバー上にデプロイされているすべての MobileFirst ランタイム・アプリケーションに対して同様の変更を行います。
6. ファームのすべてのメンバー間でトラストストア内のサーバー証明書を交換します。 トラストストア内のサーバー証明書の交換は、WebSphere Application Server フル・プロファイルおよび WebSphere Application Server Liberty プロファイルを使用するファームにとって必須です。これは、これらのファームにおいてサーバー間の通信が SSL によって保護されるためです。
   • WebSphere Application Server Liberty プロファイル
     トラストストアの構成は、Keytool または iKeyman などの IBM ユーティリティーを使用して行うことができます。
     • Keytool について詳しくは、IBM SDK, Java Technology Edition の Keytool を参照してください。
     • iKeyman について詳しくは、IBM SDK, Java Technology Edition の iKeyman を参照してください。
     鍵ストアおよびトラストストアのロケーションは、server.xml ファイルに定義されています。 SSL 構成属性内の keyStoreRef 属性と trustStoreRef 属性を参照してください。 デフォルトで、Liberty プロファイルの鍵ストアは ${server.config.dir}/resources/security/key.jks にあります。 トラストストア参照が server.xml ファイルにないか定義されていない場合は、keyStoreRef によって指定された鍵ストアが使用されます。 サーバーはデフォルトの鍵ストアを使用し、ファイルはサーバーを初めて実行した時に作成されます。 その場合、365 日間の有効期間でデフォルト証明書が作成されます。 実動の場合、独自の証明書を (必要な場合は中間証明書を含めて) 使用すること、または、生成された証明書の有効期限を変更することを検討してください。

     注: トラストストアの場所を確認する場合は、server.xml ファイルに次の宣言を追加して行うことができます。

     <logging traceSpecification="SSL=all:SSLChannel=all"/>

     最後に、サーバーを始動し、${wlp.install.dir}/usr/servers/server_name/logs/trace.log ファイル内で com.ibm.ssl.trustStore を含む行を見つけます。
     • ファーム内の他のサーバーの公開証明書を、サーバーの server.xml 構成ファイルによって参照されているトラストストアにインポートします。 グラフィカル・モードでの MobileFirst Server のインストールのチュートリアルに、ファーム内の 2 つの Liberty サーバー間で証明書を交換する手順が説明されています。 詳しくは、MobileFirst Server を実行する 2 つの Liberty サーバーのファームの作成セクションのステップ 5 を参照してください。
     • WebSphere Application Server Liberty プロファイルの各インスタンスを再始動して、セキュリティー構成を有効にします。 以下のステップは、シングル・サインオン (SSO) を機能させる場合に必須です。
     • すべてのサーバー間でそれぞれのトラストストア内の署名者証明書を交換します。
       
       

       注: WebSphere Application Server フル・プロファイルまたは Liberty を使用するファームの場合、セキュリティーが有効にされる必要があるため、このステップは必須です。さらに、Liberty ファームの場合、シングル・サインオンが可能となるように、同じ LTPA 構成が各サーバー上で複製される必要があります。 この構成を行うには、以下のステップを実行します。

     • ファームのメンバーの 1 つを始動します。 デフォルトの LTPA 構成では、Liberty サーバーが正常に始動すると、LTPA 鍵ストアを ${wlp.user.dir}/servers/server_name/resources/security/ltpa.keys として生成します。
     • ltpa.keys ファイルを各ファーム・メンバーの ${wlp.user.dir}/servers/server_name/resources/security ディレクトリーにコピーして、ファーム・メンバー全体にわたって LTPA 鍵ストアを複製します。 LTPA 構成について詳しくは、Liberty プロファイル上での LTPA の構成を参照してください。
   • WebSphere Application Server フル・プロファイル
     WebSphere Application Server 管理コンソールでトラストストアを構成します。
     • WebSphere Application Server 管理コンソールにログインします。
     • 「セキュリティー」→「SSL 証明書および鍵管理」を選択します。
     • 「関連項目」で、「鍵ストアおよび証明書」を選択します。
     • 「鍵ストアの使用法」フィールドで、「SSL 鍵ストア」が選択されていることを確認します。 これで、ファーム内の他のすべてのサーバーから証明書をインポートできるようになりました。
     • 「NodeDefaultTrustStore」をクリックします。
     • 「追加プロパティー」で、「署名者証明書」を選択します。
     • 「ポートから取得 (Retrieve from port)」をクリックします。 これで、ファーム内の他のサーバーそれぞれについて通信とセキュリティーの詳細を入力できるようになりました。 他のファーム・メンバーのそれぞれに対して以下のステップに従って操作します。
     • 「ホスト」フィールドに、サーバーのホスト名または IP アドレスを入力します。
     • 「ポート」フィールドに、HTTPS トランスポート (SSL) ポートを入力します。
     • 「アウトバウンド接続のための SSL 構成」で、「NodeDefaultSSLSettings」を選択します。
     • 「別名 (Alias)」フィールドに、この署名者証明書の別名を入力します。
     • 「署名者情報の取得 (Retrieve signer information)」をクリックします。
     • リモート・サーバーから取得した情報を検討し、「OK」をクリックします。
     • 「保存 (Save)」をクリックします。
     • サーバーを再始動します。