GigaSpaces でのアプリケーションの実行

Magic xpa 3.x



本マニュアルに記載の内容は、将来予告なしに変更することがあります。これらの情報について MSE（Magic Software Enterprises Ltd.）および MSJ（Magic Software Japan K.K.）は、いかなる責任も負いません。
本マニュアルの内容につきましては、万全を期して作成していますが、万一誤りや不正確な記述があったとしても、MSE および MSJ はい
かなる責任、債務も負いません。
MSE および MSJ は、この製品の商業価値や特定の用途に対する適合性の保証を含め、この製品に関する明示的、あるいは黙示的な保証は一切していません。
本マニュアルに記載のソフトウェアは、製品の使用許諾契約書に記載の条件に同意をされたライセンス所有者に対してのみ供給されるものです。同ライセンスの許可する条件のもとでのみ、使用または複製することが許されます。
当該ライセンスが特に許可している場合を除いては、いかなる媒体へも複製することはできません。ライセンス所有者自身の個人使用目的で行う場合を除き、MSE または MSJ の書面による事前の許可なしでは、いかなる条件下でも、本マニュアルのいかなる部分も、電子的、
機械的、撮影、録音、その他のいかなる手段によっても、コピー、検索システムへの記憶、電送を行うことはできません。
サードパーティ各社商標の引用は、MSE および MSJ の製品に対するコンパチビリティに関しての情報提供のみを目的としてなされるものです。
本マニュアルにおいて、説明のためにサンプルとして引用されている会社名、製品名、住所、人物は、特に断り書きのないかぎり、すべて架空のものであり、実在のものについて言及するものではありません。

Magic は Magic Software Japan K.K. の登録商標です。
Magic xpa は Magic Software Enterprises Ltd. のイスラエルその他の国での商標または登録商標です。
Magic xpa Enterprise Studio、Magic xpa Enterprise Client、Magic xpa Enterprise Server および Magic xpa RIA Server は Magic
Software Japan K.K. の商標です。
一般に、会社名、製品名は各社の商標または登録商標です。
MSE および MSJ は、本製品の使用またはその使用によってもたらされる結果に関する保証や告知は一切していません。この製品のもたらす結果およびパフォーマンスに関する危険性は、すべてユーザが責任を負うものとします。
この製品を使用した結果、または使用不可能な結果生じた間接的、偶発的、副次的な損害（営利損失、業務中断、業務情報の損失などの損害も含む）に関し、事前に損害の可能性が勧告されていた場合であっても、MSE および MSJ、その管理者、役員、従業員、代理人は、いかなる場合にも一切責任を負いません。

Copyright 2016 Magic Software Enterprises Ltd.and Magic Software Japan K.K. All rights reserved.

2016 年 06 月 1 日

GigaSpaces でのアプリケーションの実行

1 はじめにサーバのインストール .....................................................................................................................................................1

2 インストールの概要
インストール条件 .............................................................................................................................................................2
Magic xpa サーバとアプリケーションの配備 ..............................................................................................................................2

インストール後の設定手順 .............................................................................................................................................2
サービスユーザの設定 ....................................................................................................................................................................2
Magic xpa の環境設定 .....................................................................................................................................................................2
製品ライセンスをインストールする ............................................................................................................................................3
複数のネットワークカードを設定する（オプション）..............................................................................................................3

3 GigaSpaces インフラを実行する
グリッドが正しく開始されたことを確認する .............................................................................................................4
グリッドが実行していることを確認するには： .........................................................................................................................4
Magic スペースが配備されたことを確認するには： ..................................................................................................................5

4 Magic xpa プロジェクトを実行する
自動的に起動するためにサーバとプロジェクトを設定する .....................................................................................6
スペースの起動手順 .........................................................................................................................................................7
projectsStartup.xml の例 ..................................................................................................................................................7
アプリケーションが正しく起動されたことを確認する .............................................................................................8
実行エンジンが起動され、アプリケーションの使用準備ができていることを確認するには： .........................................8
トラブルシューティング ................................................................................................................................................................8

アプリケーションがスペースに接続することができるかどうかを確認する .........................................................9
トラブルシューティング ................................................................................................................................................................10

イベントコンテナの並行性の設定 .................................................................................................................................11
動的にエンジンをロードする .........................................................................................................................................11
オンデマンドサーバのプロジェクトを停止する ........................................................................................................................11

コマンドラインでサーバとプロジェクトの起動と停止を行う（オプション）.......................................................12

5 異なるサーバに Web リクエスタを配備する（オプション）
必要条件 .............................................................................................................................................................................13
インストール .....................................................................................................................................................................13
Web リクエストのフロー ................................................................................................................................................14

6 ファイアウォールの設定
7 スペース・クラタリング SLA
8 スペースの配備
グリッドコンポーネント－メモリアロケーション .....................................................................................................20

9 ライセンス
ライセンススレッド数またはユーザ数をプロジェクトのために予約する .............................................................21i

GigaSpaces でのアプリケーションの実行

10 ロギング
11 GigaSpaces の用語

ii

GigaSpaces でのアプリケーションの実行

はじめにこのガイドは、GigaSpaces ミドルウェアを使用した高可用性なクラスタ環境で Magic xpa プロジェクトを実行する上での推薦事
項とガイドラインを提供しています。このガイドでは、高い冗長性と、セキュアでスケーラブルな環境を提供するうえで必要なトピックを扱っています。
以下の図は、3 台のアプリケーションサーバと 1 台のデータベースサーバ、1 台のフロントエンドの Web サーバと共有ファイルシステム（SMB）ストレージをもつ小規模のサーバークラスタをインストールして構築するための構成例を示しています。

サーバのインストール
推奨される配備方法は、Magic xpa をクラスタ（上の例の APP1、APP2 と APP3）に参加している各ノード上にインストールして、共有ネットワークフォルダにプロジェクトのメタデータを配備することです。別の PC 上に内部データベースを配備することも推奨されます。
アプリケーションサーバの外には、２台の PC を検索サービス（LU）サーバとして割り当てる必要があります。これらの 2 台の
PC は、クラスタに対して名前解決サービスを提供します。
注意：Space ミドルウェアは、Java 17 以上がインストールされている必要があります。

1

GigaSpaces でのアプリケーションの実行

インストールの概要
サーバのインストールには、以下の手順を必要とします。

• 実行アーキテクチャーを理解します。
• インストールの必要条件を確認し準備します。
• セットアップウィザードを使用して Magic xpa サーバを各アプリケーションサーバ上にインストールします。セットアップ処理中にサーバの起動と初期設定が行われます。

• セットアップウィザードの設定処理の後処理を実行します。
• 共有フォルダにプロジェクトを配備して、プロジェクトの開始を設定します。
• オプション：Web リクエスタを配備します。

インストール条件
インストールする前に、以下の必要条件を確認してください。

• 各アプリケーションサーバ上で、ローカルまたは管理者ユーザ（すなわち Magic xpa の管理ユーザ）に適切な権利を定義します。Magic xpa の管理ユーザは、サービスとして実行する権利が必要です。

• すべてのアプリケーションサーバは、ネットワークアクセスを行い共有プロジェクトフォルダにアクセスするために、
Magic xpa の管理ユーザとして読込／書込の権利を持つ必要があります。

• すべてのアプリケーションサーバは、検索ポートと LRMI ポート（下記参照）を通して互いに通信することができるよ
うにする必要があります。ファイヤウォールの設定を参照してください。

Magic xpa サーバとアプリケーションの配備
各サーバで、Magic xpa のインストールを実行してください。［インストール］ダイアログボックスに従い、［GigaSpaces 環境設
定］画面が表示されたら、［サービスとしてグリッドサービスエージェント（GSA）をインストールします］というチェックボッ
クスを選択します。
注意：サーバ製品の場合は、デフォルトでサービス起動になります。
運用実行環境でアプリケーションをインストールする場合は、『リッチクライアントアプリケーションの実行』のホワイトペー
パー（MRB 関連の記述を除く）に記述されている手順に従ってください。

インストール後の設定手順
サービスユーザの設定
全てのアプリケーションサーバで、［コントロールパネル／管理ツール］内の［サービス］を開き、サービスユーザを Magic xpaの管理者ユーザに変更します。このユーザには、共有プロジェクトフォルダに対して読込及び書込の権利がなければなりません。
注意：同一サーバ内のフォルダにアクセスするだけであれば、デフォルトの「ローカル システム アカウント」の設定で、通常は変更する必要はありません。

Magic xpa の環境設定
全てのアプリケーションサーバで行います。Magic xpa の環境設定ツールを実行して以下の設定を行ってください。

1.［オプション］メニューの［設定／サーバ］を選択し、［サーバ］テーブルを開きます。「Default Space」のエントリか、新たにエントリを追加して［サーバアドレス］カラムに検索ロケータ（メインのサーバ）のアドレスを定義してください。
2.［オプション］メニューの［設定／動作環境］を選択し、［動作環境］ダイアログを開きます。［アプリケー
ションサーバ］タブを開き、［メッセージサーバ］に「Default Space」か＃１で新規に作成した（スペース用の）サーバ名を設定してください。

2

GigaSpaces でのアプリケーションの実行

製品ライセンスをインストールする
Magic xpa は、実行するためのライセンスを必要とします。

1. 購入後に受け取ったライセンスファイルをコピーして、それを全てのサーバ、または、共有位置にコピー
してください。各サーバで独自にライセンスファイルを必要としないように、すべてのサーバでアクセスできるパスに置くことを推奨します。
2. 共有されたライセンスファイルをアクセススするには、magic.ini ファイルの［MAGIC_ENV］のLicenseFile エントリを更新し、ライセンスファイルの位置とライセンス名を変更します。例：
LicenseFile=\\10.1.1.6\licenses\License.dat また、［MAGIC_ENV］の LicenseName に製品のライセン
ス名を指定します。例：LicenseName=MGRIA13

複数のネットワークカードを設定する（オプション）
アプリケーションサーバに複数のネットワークカード（NIC）が設定されている場合、以下のように Magic xpa サーバで特定のNIC を使用するように設定してください。

1. NIC に割り当てられた IP アドレスまたは、NIC の名前を保持するために <Magic xpa のインストールフォ
ルダ >\GigaSpaces-xpa\bin\setenv.bat ファイル内の NIC_ADDR の値を変更してしてください。例：
NIC_ADDR=10.1.1.11、または NIC_ADDR=”#eth0:ip#”（”eth0” は、NIC の名前）。
ヒント：以下のスクリプトを実行することによって、NIC の IP アドレスと名前を確認することができます：
platform-info.bat -verbose
次に、System Environment 内の Network と表示されるセクションを捜します。platform-info.bat ファイルは、<Magic xpaのインストールフォルダ >\GigaSpaces\bin\advanced_scripts.zip ファイルから取得できます。

2. NIC_ADDR の値を magic.ini ファイルの jvm_args セクションに追加してください：Djava.rmi.server.hostname=<NIC の IP アドレス >注意：ホスト名または IP アドレスは、引用符で囲まないでください。

3

GigaSpaces でのアプリケーションの実行

GigaSpaces インフラを実行する
Magic xpa プロジェクトを開始する前に、GigaSpaces インフラを実行する必要があります。GigaSpaces インフラの起動は、2 つの部分から成り立っています。

• GigaSpaces グリッドの開始• Magic スペースの配備
GigaSpaces のサービスが実行されるとデフォルトでは両方の処理を実行するようになっています。最初にグリッドサービスエー
ジェント（GSA）が開始されます。一旦それが実行されると、サービスはスペースを配備します。
GigaSpaces インフラの実行は、1 回だけ行われます。一旦開始されれば、Windows のサービスを再開する必要がありません。
手動でグリッドを開始し、スペースを配備することもできますが、Windows のサービス起動の使用を推奨します。Magic xpa のサーバ製品は、デフォフトでサービスを登録します。この場合、プログラムメニューにサービスの起動／停止のためのメニューが設定されます。
手動でグリッドを開始しスペースを配備する場合は、<Magic xpa のインストールフォルダ >GigaSpaces-xpa\bin フォルダの内の gs-agent.bat ファイルを実行してください。
注意：管理者ユーザとしてグリッドを開始する必要があります。バッチファイル（gs-agent.bat）を使用して手動でグリッドを開始する場合は、［管理として実行］のオプションでコマンドプロンプトを起動し、そこからバッチファイルを実行してください。

グリッドが正しく開始されたことを確認する
グリッドが実行していることを確認するには：
1.［スタート］メニューのインストールのショートカットから、<Magic xpa のインストールフォルダ>\GigaSpaces フォルダにある［Management Center］をクリックします。
2.［GigaSpaces Management Center］ユーティリティが開きます。
3. グリッドが正しく開始されると、［Hosts］タブに PC のホスト名が一覧表示されます。ホスト名の下には、
デフォルト設定として、1 つの GSA、2 つの GSC、1 つの GSM と 1 つの LU が表示されます。
4. さらに、すべての GigaSpaces エンティティが、インストール時に定義された LookupGroup を含めて（次の画像のように）表示されます。

4

GigaSpaces でのアプリケーションの実行

Magic スペースが配備されたことを確認するには：
1. GigaSpaces Management Center の［Deployed Processing Units］タブをクリックしてください。

2. 実行している 4 つのインスタンスが表示され、［Deployment Status］には「Intact」が表示されます。

5

GigaSpaces でのアプリケーションの実行

Magic xpa プロジェクトを実行する
MgxpaRuntime.exe プロセスの開始は、ユーザによって直接行われることはありません。グリッドサービスエージェント（GSA）
を通して、Magic xpa プロセスの起動やモニタ、終了の各処理を行います。GSA に対する Magic xpa への起動指示は Magic スペー
ス内で実行しているプロセスユニットから送られます。起動内容は ProjectsStartup.xml ファイルを定義することで変更できます。
このファイルには、以下のような２の注意すべき設定があります。

• NumberOfWorkers …… この設定は、サーバが起動時にいくつのワーカスレッドを読み込むかどうかを定義します。異なる Magic xpa サーバ毎に異なるワーカスレッドの数を設定することができます。常時プロジェクトを実行するワーカの数は、ライセンスによって決定されます。各ワーカはリクエストのためにスペースにポーリングするため、この値を可能な限り小さくするように推奨します（ポーリングを試みる間隔は、動作環境の［ワーカリクエストポーリング間隔］
を使用して設定します）。

• NumberOfInstances …… 複数のサーバを同じ環境で動作させたい場合は、ProjectsStartup.xml 内に単一のサーバセクショ
ンを定義し、これらのセクションで実行させる数をこの要素で定義することができます。デフォルト値は「1」です。このエレメントでは必要に応じて有効な追加サーバを設定するために、AdditionalOnDemand 属性を使用することができます。
例 : <NumberOfInstances AdditionalOnDemand="2">0</NumberOfInstances>
デフォルトは 0 で、開始時にのみサーバがロードされることを意味しています。
Magic xpa サーバが GS エージェントによって開始されると、GS エージェントの GigaSpaces-xpa\bin\setenv.bat ファイルに設定された XAP_LOOKUP_LOCATORS の環境変数に従ってグリッドに自動的に振り分けられます。
GigaSpaces の設定についての追加情報は、次を参照してください：
http://docs.gigaspaces.com/xap110adm/moving-into-production-checklist.html

自動的に起動するためにサーバとプロジェクトを設定する
Magic スペースが配備され ると、GSA は <Magic xpa のインストールフォルダ >\GigaSpaces-xpa\config フォルダ内のprojectsStartup.xml ファイルに定義されているサーバプロジェクトの内容をもとに自動的に Magic サーバをロードします。このファイルの Magic プロジェクトやサーバの情報を更新する必要があります。
推奨：スペースが複数のサーバに配備されている場合は、以下のようにしてください。projectsStartup.xml をネットワーク上の共有フォルダに置き、同じファイルにアクセスするために、全てのクラスタリング PC 内の GigaSpaces-xpa\bin\setenv.bat
でこのファイルを指定することができます。

例：set PROJECTS_STARTUP_XML=\\MyServer\config\projectsStartup.xml

注意：• 異なる projectsStartup.xml ファイルはグリッドを横断して使用されます - StartProjects.bat ファイルや GigaSpaces モニタによって起動されされた場合。

• Projects 要素の中の CMDLineArgs 属性 ( オプション ) で繰り返しの値を定義することができます。
<Projects CMDLineArgs="/InternetDispatcherPath=/Magic3xScripts/MGWebRequester.dll /LicenseName=MGENT13 /MaxConcurrentUsers=100 /MaxConcurrentRequests=10">• GS エージェントを使用してプロジェクトが起動されると (projectsStartup.xml ファイルによって )、プロジェクト名はApplicationPublicName の環境設定から自動的に取得されます。
スペースが複数のサーバに配備されている場合は、以下のようにしてください。
1. スペースを配備して、Magic xpa サーバを起動するためには、全てのサーバで GSA の設定を行ってください。これはgs-agent.bat ファイルで行います。このファイルは <Magic xpa のインストールフォルダ >\GigaSpaces-xpa\bin フォル
ダにあり、以下のように設定します。
gsa.deployAndStartProjects 1
2. 2 つのローカル LUS（Lookup Servies）と 2 つのグローバル GSM（Grid Service managers）を開始します。
a. 2 つの PC 上で、gs-agent.bat ファイルに set gsa.lus 1 を定義します。
b. GSA を開始する各 PC で、set gsa.global.gsm 2 を定義します。
ロ ー カ ル と グ ロ ー バ ル な 設 定 に つ い て の 説明は、GigaSpaces のドキュメント（Home > Administration > Runtime

6GigaSpaces でのアプリケーションの実行

Configuration）を参照してください。
3. setenv.bat ファイル（このファイルは <Magic xpa のインストールフォルダ >\GigaSpaces-xpa\bin フォルダにあります）
を以下のように設定します（host1 と host2 は、LUS が開始される 2 つの PC のホスト名）。
set LOOKUPLOCATORS=host1,host2
この設定は、GSA が開始される各 PC の setenv.bat ファイルに対して行ってください。
4. 同様に、各 Web リクエスタの Mgreq.ini ファイル（Scripts\config 内にあります）中で、LookupLocators=host1,host2を設定します。
5. 同様に、Magic xpa GigaSpaces Monitor の Connection details で host1,host2 を設定します。
6. スペースが複数のサーバ上に配備される場合、すべてのログファイルを 1 つの PC（例えば、以下の場合は ServerA）の logs フォルダなどのように一か所に指定することを推奨します。

• < インストールフォルダ >\Magic.ini と < インストールフォルダ >\GigaSpaces-xpa\bin\setenv.bat ファイル内で、filename-pattern={homedir}\ を filename-pattern=\\ServerA\MSJ\Magic xpa 3.2\ に変更します。
（この場合、そして以下の例において、MSJ は、ServerA 上の共有フォルダになります）• < インストールフォルダ >\GigaSpace-xpa\config\log4j2.xml ファイルで、<Appenders> 要素内の ${sys:com.magicsoftwa.xpa.home} を検索し、それを \\ServerA\MSJ\Magic xpa 3.2\ に置き換えてください。

• < インストールフォルダ >\GigaSpaces-xpa\bin\setenv.bat ファイル内で、set PROJECTS_STARTUP_XML= のエン
トリで \\ServerA\MSJ\ProjectsStartup.xml を定義してください。
\\ServerA\MSJ\ProjectsStartup.xml ファイルは以下のように修正します。
<Project Name="GSTest"
StartApplication=\\ServerA\MSJ\Magic xpa 3.2\GigaSpaces-xpa\test\GSTest.ecf CMDLineArgs="/
GeneralErrorLog=\\\\ServerA\\MSJ\\Magic xpa 3.2\\Logs\\''GSTest''_Errors_[%HostName%_%PID%].Log /[MAGIC_LOGGING]ExternalLogFileName=\\\\ServerA\MSJ\\Magic xpa
3.2\\Logs\\''GSTest''_[%HostName%_%PID%].Log

スペースの起動手順
グリッドの起動手順は、以下の通りです。
1. GSA は、各アプリケーションサーバ（つまりグリッドの要素）上で（通常はサービスとして）起動されます。GSA
は、すべてのアプリケーションサーバを一緒に接続するために、中心的なグリッド・インフラを起動します。
1. 最初の GSA は、Magic スペースを配備し、プロジェクトを起動します。このスペースには、グリッド内で共有されるすべての Magic 関連のオブジェクトが含まれています。
2. 同じ GSA では、プロジェクトが自動的に起動することができるようにするために、Magic スペースに
projectsStartup.xml の情報も配備します。
3. グリッド内のすべての GSA は、定義内容に基づいて Magic xpa サーバをロードします。

projectsStartup.xml の例
以下の例は、projectsStartup.xml の例です。ここでは、GigaSpace-xpa\test\GSTest.ecf という test アプリケーションを起動するための設定が定義されています。
<Startup><Projects CMDLineArgs="/InternetDispatcherPath=/Magic32Scripts/MGWebRequester.dll /LicenseName=MGENT13/MaxConcurrentUsers=100 /MaxConcurrentRequests=10"><Project Name="GSTest" StartApplication="GigaSpaces-xpa\test\GSTest.ecf" CMDLineArgs="/
GeneralErrorLog=%EngineDir%Logs\\''GSTest''_Errors_[%HostName%_%PID%].log /[MAGIC_LOGGING]ExternalLogFileName=%EngineDir%Logs\\''GSTest''_[%HostName%_%PID%].log "ReservedUsersLicenses="2" ReservedThreadsLicenses="1"><Servers><Server host="Server1"><NumberOfInstances>2</NumberOfInstances><NumberOfWorkers>10</NumberOfWorkers></Server><Server host="Server2"><NumberOfInstances AdditionalOnDemand="1">1</NumberOfInstances><NumberOfWorkers>5</NumberOfWorkers><CMDLineArgs>/MaxContexts=200</CMDLineArgs><StartApplication></StartApplication>

7

GigaSpaces でのアプリケーションの実行</Server></Servers></Project></Projects></Startup>
このサンプルファイルは、以下の設定を行っています。

• アプリケーションは、２つのサーバ（Server1 と Server2）で起動されます。
• Server1 では、２つの Magic xpa サーバ（実行エンジン）が実行され、10 ワーカスレッドを持っています。
• Server2 では、1 つの Magic xpa サーバ（実行エンジン）が実行され、他はオンデマンド（他のエンジンがびビジーの場
合に起動）になります。各々、５つのワーカスレッドかユーザを持ちます。各エンジンは、200 コンテキストに制限されています。
注意：• 各サーバに異なるアプリケーションを起動させることができます（<Server> レベルの <StartApplication> で定義します）。
しかし、すべてのサーバで同じアプリケーションを使用することを推奨します。<Projects> 要素で示しているように、共有フォルダで指定します。

• @ini ファイルの名前に空白がある場合、シングルクオーテーションで囲ってください。

アプリケーションが正しく起動されたことを確認する
projectsStartup.xml ファイルには、デフォルトで GSTest と命名されたテストアプリケーションが定義されています。このアプリ
ケーションのキャビネットファイルは、<Magic xpa のインストールフォルダ >\GigaSpaces-xpa\Test フォルダにあります。
グリッドが起動されプロジェクト実行処理が実行されると、Magic xpa サーバはここに定義されたアプリケーションを起動します。
注意：デフォルトは、無効設定になっています。また、実行させるには実行内容に対応したライセンスが必要です。

実行エンジンが起動され、アプリケーションの使用準備ができていることを確認するには：
1.［スタート］メニューの Magic xpa のショートカットから、［Magic xpa GigaSpaces モニタ］をクリックします。
2. Magic xpa GigaSpaces Monitor が開きます。デフォルトでは、モニタは同じ PC 上のスペースに接続されます。しかし、［Connection Details］メニューから変更することもできます。
3. スペースへの接続が成功したら、モニタのウィンドウタイトルには、サーバがモニタされたことが表示されます。例：
Monitoring SeverName
4. モニタには、サーバーリスト内で projectsStartup.xml ファイルに定義されているエントリが表示されます。正しく起動されていればアプリケーションエントリの［Status］は、「Available」が表示されます。起動できなかった場合は、「Failed to start」が表示されます。

トラブルシューティング
ステータス："Waiting for GS Agent"
サポートバージョン：3.1

8

GigaSpaces でのアプリケーションの実行

Magic xpa GigaSpaces モニタにアプリケーションが表示されてはいるが、アプリケーションのステータスが "Waiting for GS Agent"の場合、GSA が開始されるまで、Magic xpa サーバが 60 秒ごとに再起動を繰り返し続けていることを意味しています。このステータスは、以下のシナリオで発生します。

• 2 台以上のサーバ PC がグリッド上で動作している。
• Magic xpa サーバが 1 台の PC 上で起動された。
• 2 番目の PC はメンテナンスのためにシャットダウンされ、しばらくして再起動された。

ステータス："Failed to start"
Magic xpa GigaSpaces モニタ内のアプリケーションの表示を確認し、アプリケーションの［Status］が「Failed to start」になっていた場合、エンジンが以下のような理由で正しく起動されなかったことを意味しています。

Magic xpa 実行エンジンを起動する権利がない
この場合、Magic xpa インストール内の Logs\GS フォルダにある GSA ログ（例：'2015-02-16~09.58-gigaspaces-gsa-eyalr-8-lp10152.log'）には、以下のようなエラーが記録されます。
"C:\Magicxpa30\GigaSpaces\..\MgxpaRuntime.exe" (in directory "C:\Magicxpa30\GigaSpaces\.."):CreateProcess error=740, The requested operation requires elevation; Caused by: java.io.IOException:
Cannot run program "C:\Magicxpa30\GigaSpaces\..\MgxpaRuntime.exe" (in directory"C:\Magicxpa30\GigaSpaces\.."):CreateProcess error=740, The requested operation requires elevation"
解決手段：GSA を起動するユーザに管理者権限があることを確認してください。gs-agnet.bat ファイルを使用して手動でグリッドを起動する場合、コマンドプロンプトを［管理者として起動する］で実行してしてください。

projectsStartup.xml に正しいホスト名が定義されていない
この場合、Magic xpa のインストールフォルダ内の Logs フォルダにある GS ログ（例えば、'GSC_9744.log'）には、以下のようなエラーが記録されます。
"ERROR: 2015-02-16 10:40:37,636 [Admin GS-startRequestedWatcher-1]: locateAgent -no GSA found.Looking for
Host:[EYALR-8-bad]”
The log will also contain the following line before the error line:“INFO: 2015-02-16 10:40:37,636 [Admin GS-startRequestedWatcher-1]: locateAgent -located Host:[EYALR-8LP],IP:[10.111.2.21].Looking for Host:[EYALR-8-bad]"
このエラーは、projectsStartup.xml の host プロパティが EYALR-8-bad として定義された行が定義されていますが、マシンのホス
ト名は EYALR-8-LP で、IP は 10.111.2.21 であることを示しています。
解決手段：有効なホスト名または IP アドレスを含めるには、projectsStartup.xml の host プロパティを変更してください。

検索ロケータのサーバアドレスが正しく定義されていない
この場合、Magic xpa のインストールフォルダ内の Project フォルダ（デフォルトの Test プロジェクトのフォルダは、GigaSpacesxpa\Test です）に位置づけられている mgerror.log ファイルには、以下のようなエラーが記録されます。
“<-1> 17/03/2015 19:14:39.931 [Error ] - Error: "Cannot connect to the middleware"(-150), program: Main
Program”
解決手段：検索ロケータのサーバアドレスが正しく定義されているか［Default Space server］の設定を確認してください。場合
によっては、Local アドレス（127.0.0.1）が動作しなかったり、実際の IP アドレスを指定する必要がある点に注意してください。

アプリケーションがスペースに接続することができるかどうかを確認する<Magic xpa のインストールフォルダ >\GigaSpaces-xpa\Test フォルダにある以下のバッチファイルのどれかを実行することによって、アプリケーションが正しく配備されたかどうかをテストすることができます。

9

GigaSpaces でのアプリケーションの実行• RIATest.bat …… このファイルは、GSTest アプリケーションに接続する RIA クライアントを起動します（RIAServer のライセンスを使用してテストアプリケーションを起動する必要があります）。

• BatchTest.bat …… このファイルは、GSTest アプリケーションからバッチプログラムを起動します（Enterprise Server のライセンスを使用してテストアプリケーションを起動する必要があります）。

• HTMLTest.url…… このショートカットは、GSTest アプリケーションから HTML ベースのプログラムを起動します（Enterprise Server のライセンスを使用してテストアプリケーションを起動する必要があります）。

［スタート］メニューから［Magic xpa GigaSpaces モニタ］を起動することで、利用できるサーバやコンテキスト、リクエストや使用しているライセンスを確認することができます。
モニタのリクエストリスト（Requests log）にリクエストが追加されることでクライアントからのリクエストを確認するとができます。

トラブルシューティング
Web リクエスタのインストールに関連する既知の問題がいくつかあります。
ブラウザやリッチクライアントプログラムから Magic xpa を呼び出す場合、さまざまなエラーが発生する場合があります。

1. HTTP エラー
エラーメッセージ：“HTTP Error 500.19 内部サーバエラー ページに関連する構成データが無効であるため、要求されたページにアクセスできません。”
解決手段：
1. インターネットリクエスタがインストールされた JRE と GigaSpaces フォルダにアクセスする必要があるため、
Authenticated Users に Magic xpa のインストールフォルダへのアクセス権を追加してください。

2. IIS の ASP.NET と .NET 拡張コンポーネント（V4.0 またはそれ以上）を有効にしてください。

10

GigaSpaces でのアプリケーションの実行

2. アセンブリのロードに失敗
以下のエラーが発生する場合があります："Configuration Error. Description: An error occurred during the processing of a configuration filerequired to service this request. Please review the specific error details below and modify yourconfiguration file appropriately. Parser Error Message: Could not load file or assembly'GigaSpaces.JavaToNet.DLL' or one of its dependencies. The specified module could not be found."
解決手段：この場合は、VC++ 2010 の再配布可能なパッケージがインストールされていない可能性があります。この問題に解決するには、パッケージをインストールする必要があります。

イベントコンテナの並行性の設定
Magic xpa は、外面的に並行性を制御することができます。選択的に HttpRequestsConvertorEventContainer とHttpResponsesConvertorEventContainer イベントコンテナの並行性（Web アプリケーションで潜在的なボトルネックです）を増やすことができます。例えば、クラスタリングされたスペース内で並行性を増やすことができますが、GSC と Magic xpa ランタイ
ムプロセスがすべて同じ PC 上にあるわけではない場合があります。

これらのイベントコンテナの並行性は、MgxpaGSSpace.properties ファイル（GigaSpaces-xpa\config に置かれます）で設定することができます。
ファイルがなかったり、ファイル内のプロパティがない場合は、デフォルトとして並行性（1）が残ります ｙ す。

動的にエンジンをロードする
スペースミドルウェアは、リクエストを受信したときに、そのリクエストの処理が可能なサーバがない場合、自動的に新しい
Magic xpa サーバをロードすることができます。
リクエストが一定のタイムアウト（デフォルトは 10 秒 :-Dcom.magicsoftware.xpa.ServerLoadOnDemandTimeout=10）内で処理されない場合、Magic xpa サーバが追加で起動されます。この Magic xpa サーバは、サーバが AdditionalOnDemand>0 によって定義され、このサーバ上で現在動作している Magic xpa サーバの数が NumberOfnstances+AdditionalOnDemand の合計を越えていなければ、projectsStartup.xml において定義されたサーバの 1 つとして開始されます。

サポートバージョン：3.1

オンデマンドサーバのプロジェクトを停止する
プロジェクトを停止（GigaSpaces-xpa\bin\StopProjects.bat）したり指定したサーバを停止させると、起動していたアプリケー
ションサーバが停止します。しかし、リクエストがプロジェクトの再起動（GigaSpaces-xpa\bin\StartProjects.bat）前にスペースに送られると、開始されるまでオンデマンドでアプリケーションサーバの起動を待ちます。
プロジェクトが再起動されるとき、オンデマンドで起動を待っている Magic xpa サーバの数は、オンデマンドで起動の準備ができるインスタンス数から引かれます。

11GigaSpaces でのアプリケーションの実行

例えば：
1. プロジェクト GSTest は、1 インスタンスが起動され、（デフォルトの設定では）オンデマンドで 2 インスタンスが利用可能です。
2. プロジェクト GSTest を停止します。
3. GSTest 用のリクエストを送ります。==> 1 サーバが起動されます。（オンデマンドの 2 インスタンスは対象外です）
4. プロジェクト GSest を開始します（再び 1 インスタンス + オンデマンドで 2 インスタンス）==> 1 インスタンスは直ちに開始されます。1 インスタンスのみがオンデマンドで追加で起動された状態になります（オンデマンドで開始される
ために、追加の 1 インスタンスは残ります）。

コマンドラインでサーバとプロジェクトの起動と停止を行う（オプション）
GSA はアプリケーションの起動に関与していますが、コマンドラインから手動で行うこともできます。コマンドラインから
projectsStartup.xml で定義されたプロジェクトを起動するには、<Magic xpa のインストールフォルダ >\GigaSpaces-xpa\bin フォルダ内にある StartProjects.bat を実行する必要があります。
スペースでプロジェクトの実行を停止するには、GigaSpaces-xpa\bin フォルダ内にある ShutdownProjects.bat を実行してください。
スペース内でのサーバの実行を停止させるには、コマンドラインで以下の構文を使用してください。
CommandLine.bat[-ShutdownProject=%*][-ShutdownServer=server name.process ID][-Timeout=10]
例：• -ShutdownProject= …… すべてのサーバ（アプリケーションを処理するかどうかにかかわらず）を停止します。
• -ShutdownProject=GSTest …… アプリケーション GSTest を実行するすべてのサーバを停止します。
• -ShutdownServer=ABC.12345 …… サーバ ABC 内のプロセス ID12345 停止します。これは、特定のサーバの特定のインス
タンスを停止します。

12

GigaSpaces でのアプリケーションの実行

異なるサーバに Web リクエスタを配備する（オプション）「第 1 章「はじめに」（1 ページ）の図に表示されている設定では、DMZ ファイアウォール内に存在しているフロントエンドのサーバに Web サーバが個別に配備されています。このようなサーバの場合、異なるセットアップ手順を実行する必要があります。

必要条件
Web リクエスタのために、IIS7 が必要になります。

インストールDMZ に位置付けられている Web サーバ上で、以下のように Magic xpa をインストールする必要があります。
1. 追加コンポーネントのインストーラを起動します。
2.［コンポーネントの選択］ダイアログで［インターネットリクエスタ／ ASP .NET リクエスタ］のチェックボックスのみを選択し、インストール処理を実行します。
3. フロントエンドのサーバ（Web サーバ）がスペースに接続できるようにするために、リクエスタの接続先を変更します。これは、<Magic xpa のインストールフォルダ >\Scripts\Config\mgreq.ini ファイルを以下のように変更します。
[REQUESTER_ENV]
LookupLocators=<ServerName>SpaceName=Magic_xpa_space<ServerName> は、Magic スペースが実行しているサーバのホスト名です。
この設定によって、Web サービスリクエスタがスペースと通信することができるようになります。
Web サーバ用の PC は、外部のリクエスタをホストするために使用されるだけで、グリッドコンポーネントまたは Magic xpa エ
ンジンのいずれも実行させる必要はありません。

13

GigaSpaces でのアプリケーションの実行

Web リクエストのフロー

Web リクエストのフローは、以下の通りです。
1. HTTP クライアント（Web ブラウザや RIA クライアントまたは HTTP コールを行うソフトウェアなど）は、HTTP リク
エストを Web サーバに送ります。
2. Web サーバは Web リクエスタ（GigaSpace 用の Web リクエスタは、<Magic xpa のインストールフォルダ>\Scripts\bin\WebRequester.dll です）を呼び出します。
3. Web リクエスタは、
a. HTTP リクエストを解析します。
b. スペースに MgHttpRequest オブジェクトを書き込みます。
c. 同じ exchangeId フィールドを持つ MgHttpResponse オブジェクトと合うまで待ちます。

14

GigaSpaces でのアプリケーションの実行

ファイアウォールの設定
このトピックでは、GigaSpaces インフラのための固定のポートを設定するために必要な変更について説明しています。
２つの設定を有効にする必要があります。

• DISCOVERY_PORT：ディスカバリ待ち受けポート• LRMI_PORT_RANGE：LRMI（グリッドコンポーネント間の内部の通信のためのプロトコル）のためのポートの範囲
setenv.bat ファイルでは、両方の設定がデフォルトで無効になっています。これらは個別に有効化することができます。これは、デフォルトのディスカバリポートを維持し、LRMI のポート範囲を設定だけを行いたい場合、LRMI 設定だけを可能にすることができることを意味します。
注意：ディスカバリポートが GigaSpaces のデフォルトポート（XAP 10.0 の場合は 4174）以外に設定されると、定義されたポートを使用するロケータの値も変更する必要があります。
GigaSpaces のマニュアル（英語）には、ファイアウォール設定のために以下の作業が記載されています。
1. ディスカバリーポートと LRMI の範囲（そして、ランダムに選択されたポート範囲に依存しない ) を設定してください。
2. 入力トラフィックに対するファイアウォールのルールは、定義済みのリスナポートごとにオープンする TCP ポートを含める必要があります。
3. ポート番号の範囲は、1024 から 65536 未満にしてください。未割り当てのポートのみ利用できます。
7100 以上の見割り当ての IANA 範囲です (7102-7120, 7130-7160, 7167-7173, 7175-7199, 7228-7271, 7282-7299,7366-7390...,47558-47623, 47625-47805, 47809-47999, 48004-48127, 48620-49150)

15

GigaSpaces でのアプリケーションの実行

スペース・クラタリング SLA
スペースクラスタリングは、スペースパーティションや、バックアップパーティションの数、そして、これらを有効なグリッド
コンテナ（GSC）上に展開する方法を定義します。
スペースクラスタリングは、サービスレベルアグリーメント（SLA）定義によって管理されます。これは、スペースを配備する
とき、グリッドが常に定義されたクラスタリングを維持しようとすることを意味します。
クラスタリングは、MgxpaGSSpace_sla.xml ファイルで定義されます。このファイルは <Magic xpa のインストールフォルダ>\GigaSpaces-xpa\config フォルダにあります。デフォルトでは、このファイルは、各々１つずつのバックアップを持つ 2 つのパーティションを定義しています（合計で 4 つになります）。そして、プライマリパーティションとそのバックアップのパーティ
ションは同じプロセス内で実行することができない制約があります。
グリッドを SLA 定義に対応させるには、十分な数の GSC を定義する必要があります。
上記のデフォルト設定では、プライマリパーティションが同じプロセス内でそのバックアップと同時に実行することができない
ため、スペース実行を成功させるため少なくとも 2 つの GSC を実行させる必要があります。
最も一般的な SLA 設定は、以下の通りです。

• cluster-schema ……これは常に「partitioned-sync2backup」に設定する必要があります。これはデータをパーティションに置くことができ、各パーティションがそれと同期するバックアップを持つことができることを意味します。

• number-of-instances …… スペースパーティションの必要な数です。読み込まれる Magic プロセスユニットのインスタン
スを意味しています。デフォルトは、「2」です。メモリに多くのデータがある場合、この数を増やす必要があるかもしれません。

• number-of-backups …… プライマリパーティションに対するバックアップのパーティションの数です。開発中は、バックアップを必要としないように値を「0」に設定することができます。number-of-instances="2" と number-of-backups="1" の場合、Magic のプロセスユニットには 4 つのインスタンスが作成されることになります。
各プライマリパーティションには、バックアップのパーティションは、1 つまでしか定義できないため「2」以上を指定しても意味がありません。

• max-instances-per-vm …… この設定が「1」の場合、プライマリパーティションとそのバックアップが同じ JVM（GSC）
で利用できなくなります。同じ JVM（GSC）つまり、同じプロセス内に配備される同じパーティションのインスタンス
数です。現状のままデフォルト（max-instances-per-vm="1"）にしておくと、同じパーティションのプライマリとバック
アップのインスタンスは同じ GSC 上で実行されません。

• max-instances-per-machine …… これが「1」に設定された場合、プライマリ・パーティションとそのバックアップが同じマシン上で実行されなくなります。この値を「1」に設定すると、最低 3 台の PC を含むクラスタに制限されます。そして、PC のうちの 1 台が故障すると、失われたパーティションは 3 番目の PC へ移ります。または、2 台の PC クラスタで使用することもできます。しかし、2 番目の PC が背後で稼働可能になるまで、バックアップなしでプライマリ・パー
ティションを持つことになる危険性があります。
ここに、SLA のいくつかの例があります。
1. 1 つのバックアップを持つ単一パーティションにする場合は、以下のように MgxpaGSSpace_sla.xml ファイルを設定します。
<os-sla:sla cluster-schema="partitioned-sync2backup" number-of-instances="1" number-of-backups="1"maxinstances-per-vm="1">16GigaSpaces でのアプリケーションの実行

上記の例は、１つの PC 上に少なくとも 2 つのコンテナを必要とします。各コンテナには、１つのパーティションを保持します。

2. 各々 1 つずつのバックアップを持つ２つのパーティションで、プライマリとバックアップのパーティションを個別のGSC 上に置く場合は、以下のように MgxpaGSSpace_sla.xml ファイルを設定します。
<os-sla:sla cluster-schema="partitioned-sync2backup" number-of-instances="2" number-of-backups="1"maxinstances-per-vm="1">
上記の例は、１つの PC で少なくとも 2 つのコンテナを必要とします。各コンテナは、2 つのパーティションを保持します。

3. 1 つのバックアップを持つ２つのパーティションで、プライマリとバックアップのパーティションを個別の PC 上に置く場合は、以下のように MgxpaGSSpace_sla.xml ファイルを設定します。
<os-sla:sla cluster-schema="partitioned-sync2backup" number-of-instances="2" number-of-backups="1"maxinstances-per-machine ="1">17GigaSpaces でのアプリケーションの実行

上記の例は、各 PC に少なくとも 1 つのコンテナを持つ少なくとも 2 台の PC を必要とします。各 PC では、コンテナは 2 つのパーティションを保持します。2 台の PC のクラスタがあり、1 つの PC に障害が発生した場合、Magic スペースの実行は不完全（コンプロマイズ）で、障害が発生した PC が再び起動するまで、バックアップのパーティションは紛失したバックアップのパー
ティションに置き換わりません。

*** max-instances-per-machine ="1" の使用は、最低 3 台の PC を含むクラスタに制限されます。この場合、PC のうちの 1 台に障害が発生しても、紛失したパーティションは 3 番目の PC に移ります。
*** GSC の数は gs-agent.bat ファイルで定義されます。このファイルは、GigaSpaces-xpa\bin フォルダにあります。call gs-agent.bat
で開始されるコマンドの gsa.gsc パラメータの隣の数値を修正することによって、必要なパーティション数に対応した GSC の数を定義する必要があります。
注意：クラスタ上でプロジェクトを実行している場合、PC のクロックが全て同期していることを確認してください。

18

GigaSpaces でのアプリケーションの実行

スペースの配備
Magic xpa のサーバ製品のデフォルトでは、Windows サービスによってグリッドサービスエージェント（GSA) が起動されるように設定されます。GSA は、DeployAndStart.bat と呼ばれる Magic スペースの配備を行うバッチ処理を実行します。Magic スペー
スは一度だけ配備されます。これは起動された Windows サービスのうちの 1 つによってのみ実行されます。
実行プロセスは、MgxpaGSSpace_sla.xml ファイル（「スペース・クラタリング SLA」
（ページ：16）のセクションで説明されているように）で定義される SLA 設定を使用します。
注意：リッチクライアントビルダで作成されるファイルは、デフォルトでは MRB ミドルウェアを使用する場合を想定して、
publish.html ファイルなどの必要なパスを設定しています。GigaSpace を使用する場合はこの設定を変更する必要があります。
配備プロセスは、1 つのサーバの障害が Magic スペースの処理に影響を及ぼさず、データ損失も発生しないような方法で、有効なコンテナ（GSC）上でパーティションを拡張しようとします。このプロビジョニング処理は自動的に行われます。1 回完了す
ると、自身で再編成することはありません。
Magic スペースの配備処理の間は、１つの PC だけが実行していて、単一 PC に関連する SLA 定義（max-instances-per-machine）の制約がなければ、この PC は全てのパーティションを保持します。配備が完了した後、他の PC 上で起動しているコンテナはMagic スペースのパーティションを保持しません。そして、現在 Magic スペースを実行している単一 PC は障害点とみなされるようになります。
グリッドの要素として複数の PC がある場合、Magic スペースを実行するタイミングを制御したいと思うはずです。グリッドサー
ビスエージェント（GSA）がロードされ、PC がグリッドの一部となる場合、Magic スペースがすでにグリッド上にあれば、その PC は Magic スペースの一部とはなりません。
1 つの PC が全てのパーティションを保持している状態でパーティションを複数の PC に展開するには、以下のオプションが利用できます。
1. GigaSpaces Management Center からパーティションを手動で再編成することができます。これを行うには、GigaSpaces
Management Center の［Hosts］タブを開いてください。左側の階層ツリーの最上位の［Hosts］エントリに移動してください。右側の［Services］ペインにはコンテナとパーティションのツリーが表示されます。以下の図で示すように、ここでパーティション（プライマリまたはバックアップ）を選択し、異なるコンテナにドラッグすることができます。
図は同じ PC 上のコンテナへの移動の例ですが、クラスタリング環境の場合は、別の PC に移動することも可能です。

図 8-1 変更ダイアログ

図 8-2 変更後

2. GSA のプライマリパーティションを再起動させることで、バックアップパーティションと入れ替えることができます。
これを行うには、以下のようにします。
a. GSC ノードのプライマリパーティションにパークします。
b. コンテキストメニューから、［Restart］を選択します。
c. しばらくすると、バックアップパーティションがプライマリパーティションに切り替わり、プライマリパーティ
ションがバックアップに切り替わります。

19

GigaSpaces でのアプリケーションの実行

GigaSpaces は、下の図のように、バックアップ用のコンテナを 2 番目の PC に配置します。これによって、冗長性をア
プリケーションに提供します。2 番目の PC が利用できない場合、GigaSpaces は現在の PC にバックアップのパーティ
ションを作成します。2 番目の PC が再度利用できるようになっても、GigaSpaces は２番目の PC にバックアップを自動的には移動しないかもしれません。この場合は、手動で処理を移動させる必要があります。

図 8-32 番目の PC 起動時

図 8-42 番目の PC が停止した場合最初に起動した PC にバックアップが作成される場合もあります。
4. SLA 内の max-instances-per-machine の制約を使用することができます。この方法は少なくとも 3 台の PC のクラスタに制限されます。そして、グリッド内に少なくとも 2 台の PC で確実にスペース・パーティションを実行することになります。
a.「スペース・クラタリング SLA」（ページ：16）の セクションで説明されている MgxpaGSSpace_sla.xml ファイルのmax-instances-per-machine="1" のエントリを定義します。
b. 自動配備プロセスが開始されると、少なくとも 2 台の PC でスペース・パーティションを配備するまで、処理が完了しません。

グリッドコンポーネント－メモリアロケーション
様々な GigaSpaces エンティティに対するメモリアロケーションは、setenv.bat と呼ばれるバッチファイルで定義されています。このファイルは、<Magic xpa のインストールフォルダ >\GigaSpaces-xpa\bin フォルダ内にあります。
このバッチファイルには、GigaSpaces のメモリ関連を設定するパラメータ（-Xmx）が指定されています。
set XAP_GSA_OPTIKONS=-Xmx64m
set XAP_GSM_OPTIKONS=-Xmx64m
set XAP_LUS_OPTIKONS=-Xmx64m
GSA や GSM そして LUS エンティティは、メモリの使用量は少ないため、これらの設定はデフォルトのままにしておくことができます。GSC は、スペース・パーティションを実行するコンテナで、プロジェクト内の全てのデータを保持します。GSC に関するメモリの問題に直面した場合、この値を増やすことを検討する必要があります。デフォルトでは、以下のように設定されています。
set GSC_JAVA_OPTIONS=-Xmx512m %LOG_OPTIONS% .....
この場合は、512M バイトとなります。

20

GigaSpaces でのアプリケーションの実行

ライセンス
本来、Magic xpa のライセンスメカニズムは、フローティングになっていますが、オプションとして最小限のライセンススレッ
ド数またはユーザ数を各プロジェクトのために予約することができます。
ライセンスは、全てのプロジェクトで利用できます。スペースはライセンスサーバの働きをします。フローを実行する前に、ワーカはプールからライセンスのチェックアウトを試みます。フローを実行し終わると、ワーカはプール内でライセンスをチェックインします。このように、サーバ間でライセンスを分けることでマルチプロジェクト環境における最適条件でライセンスを利用することができます。従って、特定のプロジェクトがアイドル状態の場合、他のプロジェクトはそのライセンスを利用することができます。
Magic xpa サーバがスペースミドルウェアによって開始された場合、各ライセンス（MGENT13、または MGRIA13）に対して、
Magic xpa サーバはチェックアウトします（ライセンスファイルから）。特定のライセンス（すなわち同じシリアル番号を持つライセンス）がスペースに書き込まれていない場合、スペースにライセンストークンを書き込みます。実際のところ、複数の Magic
xpa サーバが同時に起動されても 1 つの Magic xpa サーバだけがスペースにライセンストークンを書き込みます。
注意：同じ PC で複数の RIA クライアントを実行しても 1 つ（RIA）ライセンストークンを消費します。
すべての Magic xpa インストールは、同じライセンスファイル（共有フォルダに置くことができます）を指定するようにしてください。
起動される最初のエンジンは、スペースにライセンス数を書き込みます。そして、他のエンジンも実行させることができます。
ライセンスを割り当てた Magic xpa エンジンが、実行し続ける必要はありません。スレッドとユーザカウントをスペースに設定
したら、ライセンスを維持するために必要でありません。従ってグリッド上の他の Magic xpa エンジンと同じように停止したり、開始したりすることができます。

ライセンススレッド数またはユーザ数をプロジェクトのために予約する
複数のプロジェクトを実行している場合、いくつかのプロジェクトはストレス条件（たとえば、多くの Web サービスや HTTP リ
クエストを処理する）ですべてのスレッドまたはユーザを消費するかもしれません。絶えず実行する必要がある重大なプロジェ
クトのためにライセンススレッドまたはユーザの数を対応可能な最低限を確保する必要があります。
1 つのプロジェクトあたりのユーザ数、またはスレッドライセンス数を確保するには、projectsStartup.xml ファイル内のReservedUsersLicenses と ReservedThreadsLicenses 属性を使用することができます。
注意：与えられたプロジェクトのために確保されたライセンスは、確保されなかったライセンスを取得しようとする前に、そのプロジェクトを実行している Magic xpa サーバ内のワーカによって取得されます。

21

GigaSpaces でのアプリケーションの実行

ロギング
デフォルトの出力フォルダは、Magic xpa のインストールフォルダ内の Logs フォルダです。

インフラストラクチャ

ログタイプ

場所と説明

Log4netASP .NET リクエスタのログ

このログは、Scripts フォルダ内の Web.config で定義されます。

Space Monitor アプリケーション
ログ

このログは、GigaApace-xpa\Monitor フォルダ内の
MgGSMonitor.exe.config 設定ファイルで定義されます。

Space エンジンと Apache Tomcat
リクエスタエンジン

スペース関連の動作の表示。これらのログは GigaApace-xpa\config フォルダ内の log4j2.xml に定義されています。log4j2.xml ファイル 10M バイトを超えることはできません。

log4j222

GigaSpaces でのアプリケーションの実行

GigaSpaces の用語• データグリッド …… インメモリ・データグリッドは、複数の（物理または仮想の）マシンインスタンス上で実行する複数のサーバプロセスから構成されるミドルウェアソフトです。これらのプロセスはメモリ内に大量のデータを保存するために同時に動作します。これによって高性能で柔軟性のあるスケーラビリティとフェイルセーフに対する冗長性を提供します。

• スペース …… スペースは、（データベース・インスタンスと同じように）メモリ内にデータオブジェクトを保存して、データグリッドで動作するデータとビジネスロジックのコンテナです。データグリッドには、複数のスペースを含める
ことができます。しかし、Magic xpa は複数のプロジェクトを実行するために、シングルスペースを使用します。冗長性とスケーラビリティのために、スペース内のデータとビジネスロジックはデータグリッドに参加しているすべての PC 全体で複製され、分割されます。そして、PC またはソフトウェアに障害が発生した場合でも継続してサービスを提供することを保証します。

• プロセスユニット …… プロセスユニットは、データグリッド上で動作して、スペース内のすべてのデータへのダイレク
トアクセスを行うソフトウェアモジュールです。Magic xpa は、エンジンの起動やモニタリング、リカバリ処理のような管理およびハウスキーピング処理を実行するプロセスユニット・コンポーネントを含んでいます。

• グリッドサービスエージェント（GSA）…… これは、プロセスマネージャとして動作する GigaSpaces のエンティティです。これは、グリッドサービス・マネージャ（GSM）やグリッドサービス・コンテナ（GSC）、検索サービス（LUC）な
どのようなサービスグリッドのプロセスを生成したり管理したりすることができます。このエージェントは、OS のプロ
セスのようにインストールされます。GSA は特定の PC で実行され、PC をグリッドに追加したり、自身の PC のグリッドプロセスのモニタリングを行ったり、プロセスに障害が発生した場合それらを再起動する処理を担います。

• グリッドサービス・コンテナ（GSC）…… プロセスユニットまたはスペース・パーティションのホストとして動作するコンテナです。

• グリッドサービス・マネージャ（GSM）…… グリッドサービス・コンテナを管理するサービスです。GSM は、グリッドにプロセスユニットの配備したり解放したりします。GSM は、各 GSC でのプロセスユニットの実行をモニタします。

• 検索サービス（LUS）…… ロードされた各コンポーネントが実際どこに位置しているかという情報を含んでいるレジス
トリです。

23