Magic xpiトレーニングテキスト
26. その他

26.1 プロジェクトの改名／コピー

• プロジェクトの改名／コピーはプロジェクトを別名で保存することで実現します。
• 改名／コピーしたいプロジェクトをMagic xpiスタジオで開き、「別名で保存」を行います。

• 「別名で保存」したプロジェクトをMagic xpiスタジオで開き、リビルドを行います。
• リビルドを行うと、プロジェクトフォルダ内に下記ファイルが生成または更新されます。

26.2 プロジェクトのインポート／エクスポート

【エクスポート】

• ソリューション エクスプローラーでエクスポートしたい対象を右クリックし、エクスポートします。
• ビジネスプロセス単位もしくはフロー単位でエクスポートできます。

【インポート】

• ビジネスプロセスをインポートする場合は、プロジェクトを右クリック、フローをインポートする場合は、ビジネスプロセスを右クリックし、インポートします。

26.3 デバッグ用フラグ

• デバッグ用フラグを使用して、一部のコンポーネントの詳細ログを出力できます。
• 設定画面の左ペインでプロジェクト環境 > デバッグ用フラグを選択し、右ペインで設定します。

26.4 ドキュメント生成

• プロジェクトの設定内容をHTMLとして出力することができます。
• xpiスタジオのメニュー > プロジェクト > ドキュメント生成をクリックします。

26.5 よくあるエラーと対処法

GigaSpaces起動時

【サービスはエラーを返しませんでした。】

• このエラーは、8dot3nameが無効のドライブにxpiをインストールすると発生します。
• このエラーが出る場合は、いったんxpiをアンインストールしなければなりません。
• インストール先のドライブの8dot3nameを有効にした後、必ずOSを再起動し、あらためてxpiをそのドライブにインストールしてください。

リビルド時

【リビルドにすべて失敗しました。】

• このエラーの原因は大きく分けて３つ考えられます。

　　①License.datの期限が切れている。

　　　　→　適切なLicense.datを配置して、再度リビルドを行ってください。

　　②ifs.iniファイルなど、プロジェクトフォルダ内のファイルを開いたままリビルドを行った。

　　　　→　プロジェクトフォルダ内のファイルを閉じて、再度リビルドを行ってください。

　　③プロジェクト名やプロジェクトを格納するフォルダ名（パス）に日本語を使用している。

　　　　→　プロジェクト名やフォルダ名は英数字および記号※を使用してください。

　　　　　　　　※スペースおよび @, $, &, *, %, ^, `, ~, (, ), # は使用できません。

デバッグ時

【スペースからのデータの取得に失敗しました。】

• このエラーの原因は大きく分けて２つ考えられます。それぞれ次頁以降に対処法を記載します。

　　　①start.xmlのホスト名やプロジェクト配置場所が正しくない。

　　　②VPN接続をしている。

①start.xmlのホスト名やプロジェクト配置場所が正しくない。

• 開発機で開発したプロジェクトを、本番機にコピーして実行する場合など、開発マシンと実行マシンが異なる場合には、start.xmlのホスト名やプロジェクト配置場所を、実行マシンのものに書き換える必要があります。（ 「25_第25章_Magic xpiトレーニング_本番移行時の注意.pdf」参照）
• start.xmlが正しくない状態でデバッグを行うと、GigaSpacesは間違った情報を使用してサーバを起動しようとして、ステータスが「RUNNING」になりません。
• このような状態となってしまったときは、GigaSpacesを再起動してください。

②VPN接続をしている。

• VPN接続をしている場合、このエラーが発生することがあります。
• VPN接続をしている場合、切断した上で、GigaSpacesを再起動してください。

デバッグ時

【開始処理中にエラーが発生しました。デバッグセッションが終了します。】

• このエラーは、GigaSpacesとデバッガサービスのどちらか一方、または両方が停止した状態でデバッグを行うと発生します。
• デバッグを行う際は、Windowsの「Magic xpi 4.13 GSA」、「Magic xpi 4.13 Debugger」サービスが起動していることを確認してください。

Magicモニタでプロジェクト開始時

【The server [serverId: n] are not currently running.】

• このエラーは、xpiスタジオでデバッグを行ったプロジェクトを、そのままモニタから起動しようとすると発生し、サーバのステータスが「SERVER_INITIALIZING」のままとなってしまいます。
• GigaSpacesを再起動し、スタジオでプロジェクトをリビルドしてから、モニタから起動してください。

Magicモニタ表示時

【 Error: Cannot connect to display server.】

• このエラーの原因は大きく分けて２つ考えられます。それぞれ次頁以降に対処法を記載します。

　　　①システム環境変数「Path」の順序が正しくない。

　　　②モニタサービスのログオンアカウントの権限が足りない。

①システム環境変数「Path」の順序が正しくない。

• このエラーは、システム環境変数「Path」の順序によって発生することがあります。

　　　→　「Path」の値のうち、xpi 4.13関連の下記の２つの値を最上位に移動してください。

②モニタサービスのログオンアカウントの権限が足りない。

• Magicモニタのサービス「Magic xpi 4.13 Monitor Display Server」のログオンアカウントは、デフォルトでローカルシステムアカウントとなっていますが、Windows Server 2016など一部のサーバOSにおいては権限が足りずにこのエラーが発生することがあります。

　　　→　管理者権限を持ったアカウントに変更し、サービスを再起動してください。

26.6 ログコレクター

【ログコレクター】

• ログコレクターは、トラブルシューティングに必要なファイル（ログファイル、構成ファイル、スクリプト、ライセンスファイル等）を収集するために設計されたログ収集ツールです。
• 弊社サポートサイトからログの提供を求められた場合には、本ツールを使用してログを収集し、サポートサイトに添付してください。
• xpiサーバをクラスタ構成としている場合、各クラスターノードでツールを実行する必要があります。

【ログコレクターの実行方法】

• <xpi インストールフォルダ>\Tools\LogsCollector\logs_collector.batをダブルクリックします。
• 同フォルダに「logs-<コンピュータ名>.zip」ファイルが作成されます。

26.7 Magic xpi ヘルプ

【ヘルプファイルの表示】

• デスクトップのショートカットフォルダ > Help > Magic xpi ヘルプをダブルクリックします。

　　　※実体は「<xpiインストールフォルダ>\Help\MagicxpiHelp.chm」

【コンポーネント】

• 各コンポーネントの使用方法は「コンポーネントシリーズ」に記載されています。

【ユーティリティ】

• データマッパー等の使用方法は「リファレンスガイド > ユーティリティ」に記載されています。

【関数リスト】

• 関数の使用方法は「リファレンスガイド > 式エディタ > 関数リスト」に記載されています。

【エラー処理】

• エラー処理についての詳細は「コンセプトペーパ > Magic xpiのエラー処理」に記載されています。

【クラスタ構成】

• クラスタ構成についての詳細は「コンセプトペーパ > クラスタリング環境での配備」に記載されています。

【トラブルシューティング】

• トラブルシューティングは「トラブルシューティング」に記載されています。

【Magic xpi スタジオからの起動】

• Magic xpi スタジオで項目を選択し、「F1」キー押下で、その項目に関するヘルプを表示できます。

26.8 Magic xpi が提供するアダプタ

※ 72種500機能以上のアダプタを提供します。　※一部、別売のアダプタがあります。

26.9 Magic xpi のトリガー

• Magic xpiで使用できるトリガーは下記の通りです。

26.10 Magic xpi のライセンス

【ライセンスについて】

• 各ソフトウェアはインストールしたライセンス（License.dat）にて使用できるかどうかが決まります。

※テストサーバ（IBNPSRV）は開始後24hで停止します。

※上表は一例です。ライセンスについて詳しくは弊社営業にお問い合わせください。

【License.datについて】

• License.datには、使用することのできるソフトウェアおよびアダプタが記載されています。
• ソフトウェアやアダプタの使用期限やシリアル番号、同時使用ユーザ数、スレッド数なども記載されています。

• Magic xpiの各ソフトウェアおよびアダプタのライセンス名は下表の通り。