Magic xpiトレーニングテキスト
3. Magic xpi のインストール

3.1 8dot3nameの有効化

• Magic xpi をスペースを含むフォルダにインストールする際は、8dot3nameサポートを有効にしておかなければなりません。
• Dドライブなど、Windowsがインストールされているドライブ以外では、8dot3nameサポートが無効になっている場合があります。
• 次ページに示す fsutil コマンドを使用して、xpiをインストールするドライブの8dot3nameが有効かどうかを調べ、無効となっている場合は有効化します。

xpiをdドライブにインストールする場合のコマンドの実行例

※別のドライブにインストールする場合は、ドライブレターを変えてください。

3.2 .NET Frameworkの確認

【レジストリの確認】

• xpiをインストールするマシンには、.NET Framework 4.xがインストールされている必要があります。レジストリエディタで下記のキーのReleaseのDWARD値を確認します。
  HKEY_LOCAL_MACHINE\SOFTWARE\Microsoft\NET Framework Setup\NDP\v4\Full

【.NET Frameworkのバージョン確認】

• DWARD値と下記URLから、インストールされている.NET Frameworkのバージョンを確認します。
  https://docs.microsoft.com/ja-jp/dotnet/framework/migration-guide/how-to-determine-which-versions-are-installed

3.3 IISの有効化

【クライアントOSの場合】

• コントロールパネルの「Windowsの機能の有効化または無効化」より、「インターネット インフォメーション サービス」配下の下記項目に全てチェックを入れます。

【サーバOSの場合】

• サーバーマネージャーの「役割と機能の追加」より、「Webサーバー（IIS）」配下の下記項目に全てチェックを入れます。

3.4 内部データベースのインストール

• xpiが動作するためには内部データベースが必要です。
• xpiのインストーラには内部データベースが同梱されておらず、xpiをインストールする前に下記のいずれかのDBMSをインストールしておく必要があります。

3.5 Javaのインストール

• 以前のバージョンのxpiのインストーラにはJDKが同梱されおり、xpiのインストール時にJDKも一緒にインストールされていました。
• Javaの有償化に伴い、xpi 4.13のインストーラにはJDKが同梱されなくなったため、xpiをインストールする前にJDK 8.0の32bit、64bitを両方インストールしておく必要があります。
• 下記のOpenJDKディストリビューションのいずれかをインストールします。

※Oracle Java version 1.8 update 261はサポートされていません。

【Amazon Correttoのインストール】

• ここでは、Amazon Corretto 8.262.10.1をインストールします。

3.5 Javaのインストール32bit版

【初期画面】

• ダウンロードした32bit版のmsiファイルをダブルクリックし、インストーラを起動します。

【機能の選択】

• インストールする機能と、インストール場所を指定します。

【インストール内容の確認】

• 「Install」ボタンを押してインストールします。

【インストール完了】

• 「Finish」ボタンでインストールを完了します。

3.5 Javaのインストール64bit版

【初期画面】

• ダウンロードした64bit版のmsiファイルをダブルクリックし、インストーラを起動します。

【機能の選択】

• インストールする機能と、インストール場所を指定します。

【インストール内容の確認】

• 「Install」ボタンを押してインストールします。

【インストール完了】

• 「Finish」ボタンでインストールを完了します。

3.6 Magic xpi のインストール

【注意事項】

• Magic xpi のインストールは管理者権限を持ったユーザで行ってください。
• 過去バージョン（例えばMagic xpi 4.9）とMagic xpi 4.13は同一筐体にインストールできますが、同時に実行することはできません。
• 同一筐体に複数バージョンのMagic xpi をインストールすることは推奨しておりません。
• 過去バージョンがインストールされている場合は過去バージョンをアップグレードするのではなく、
• 過去バージョンをアンインストールしてから、Magic xpi 4.13をインストールするようにしてください。

【初期画面】

• setup.exeをダブルクリックし、Magic xpi 4.13インストーラを起動します。

【Magic xpi ソフトウェア使用許諾契約】

• ソフトウェア使用許諾契約書の内容を確認し、同意します。

【インストール先の選択】

• インストール先のフォルダを選択し、アプリケーションを使用できるユーザを指定します。

【インストールタイプの選択】

• 「標準」を選択すると全機能がインストールされます（推奨）。
• 「カスタム」を選択するとプログラムフォルダ名を変更したり、機能を制限できます。

【プログラムフォルダの選択】　※インストールタイプ「カスタム」選択時

• プログラムフォルダ名を変更できます。

【機能の選択】　※インストールタイプ「カスタム」選択時

• 下表を参照してインストールする機能を選択してください。
• 内部DB、GigaSpaces、Serverは必ずインストールする必要があります。

【xpiシステム構成】

• 「システムのキャパシティ、またはサイズ」ドロップダウンリストから、定義済みの構成である「開発（小）」、「本番（中）」、「本番（大）」のいずれかを選択します。
• 「開発マシン カスタマイズ」にチェックをつけて、各項目を手動で設定することもできます。

設定方法の詳細については、アドバンスド開発ガイド(※)を参照してください。
※ <xpiインストールフォルダ>\Help\Magic xpi 4.x – Advanced Deployment Guide.pdf

【内部データベースの選択】

• 内部データベースを作成するDBMSを選択します。
• インストール時に作成する場合は「…今作成しますか？」にチェックを入れます。

【内部データベース設定　– MSSQLの場合 – 】

• サーバ名と認証情報を入力します。
• Windows認証の場合は、Windows認証にチェックを入れます（ユーザ名/パスワードは非活性）。
• SQL Server認証の場合は、Windows認証のチェックを外し、ユーザ名/パスワードを入力します。

【内部データベース設定　– Oracleの場合 – 】

• tnsnames.oraに定義したネットサービス名と認証情報を入力します。

【JDKフォルダの選択】

• 事前にインストールした32bit、64bitそれぞれのJDKフォルダを選択します。

【インストール内容の確認】

• インストール内容を確認し「次へ」ボタンを押します。

【インストール完了】

• インストールを完了します。

【MSSQLのWindows認証を使用する場合の追加設定】

• 内部データベース設定（P.34）でWindows認証を選択した場合、テーブルの作成に失敗し、インストール完了画面の直前に、下記のようなエラーが表示されます。
• このエラーが表示された場合、Management Studioでテーブル作成スクリプトを手動で実行します。

　　　(1) <xpiインストールフォルダ>\DB\MSSQL\Standard\ms_std_create_tables.sql

　　　(2) <xpiインストールフォルダ>\DB\MSSQL\Enterprise\ms_ent_create_tables.sql

　　　※ SQL Server Enterprise Editionの場合は(2)を、それ以外のEditionの場合は(1)を実行

• 内部データベースへの接続方法をWindows認証に変更します。
• <xpiインストールフォルダ>\Runtime\Config\datasource.xmlを下記のように編集します。

　※ datasource.xmlの2行目～66行目はコメント行です。67行目～74行目の部分を編集します。

3.7 ライセンスファイルの配置

• 弊社が発行したライセンスファイル「License_xxxxxxx.dat」を「License.dat」に改名します。
• 「License.dat」を「<Magic xpiインストールフォルダ>\Runtime\Magic xpa\」に上書きコピーします。
• 上書きコピーする際は、下記のソフトウェアおよびWindowsサービスを停止してください。

　　　　※「License_xxxxxxx.dat」の「xxxxxxx」はお客様固有のシリアル番号です。

3.8 Hot Fixの適用

【Hot Fixのダウンロード】

• 弊社サポートサイトよりHot Fixをダウンロードします。

https://esupp.magicsoftware.co.jp/MGSys/ES/mgrqispiES.dll?appname=eSupport&prgname=Password&arguments=-N001

【Hot Fixの適用方法】

• Hot Fixの適用方法はインストーラ形式のものと、ファイルを上書きコピーするものがあります。
• ダウンロードページの説明に従い、適用してください。
• Hot Fixを適用する際は、下記のソフトウェアおよびWindowsサービスを停止してください。

【Hot Fix適用時の注意事項】

• 新しいHot Fixの提供は、Magic xpi サポートニュース（メール）にてお知らせします。
• 提供されたHot Fixは必ず適用するようにしてください。

3.9 IISの設定

• Magic xpi 4.13 では、IISの機能を使用してHTTPトリガーの機能を提供しています。
  Magic xpi 4.13 インストール後、IISの設定の確認をします。
• コントロールパネル > 管理ツールを起動します。

• インターネットインフォメーションサービス（IIS）マネージャーを起動します。

• 左ペインで「サーバホーム/サイト/Default Web Site/Magicxpi4.13」を選択します。
• 中央ペインの「ハンドラーマッピング」をダブルクリックします。

• 中央ペインで「MgWebRequesterHandler」を選択します。
• 右ペインの「機能のアクセス許可の編集」を開き、アクセス許可すべてにチェックを入れます。

3.10 内部データベースの設定

【MSSQLの場合】

• 内部データベースとして MSSQL を使用する場合、Magic xpi 4.13 のインストール後、「SQL Server 20XX 構成マネージャー」を使用して以下の設定を行う必要があります。
• SQL Server ネットワークの構成 > MSSQLSERVER（※Express Editionの場合はSQLEXPRESS）のプロトコル：TCP/IP を有効にします。
• TCP/IP のプロパティ画面：IP アドレスタブ内の IPAll にTCPポート「1433」 を設定します。

【Oracleの場合】

• 内部データベースとして Oralce を使用する場合、Magic xpi 4.13 のインストール後、JDBCドライバ（jarファイル）を下記フォルダにコピーする必要があります。
  　　　<xpiインストールフォルダ>\Runtime\java\DatabaseDrivers\

3.11 環境変数の設定

【環境変数Pathの順序変更】

　・システム環境変数Pathに指定するパスの順序を下記の通り変更します。

【環境変数JAVA_HOMEについて】

• xpiをインストールしたマシンでは、システム環境変数JAVA_HOMEは設定しないようにします。
• システム環境変数JAVA_HOMEが設定されていると、Magicモニタはそのパスを参照するため、もし設定する場合は、インストール時に指定したJDK(64bit)のパスを指定してください。

3.12 Windowsサービスの起動とGigaSpacesの確認

【Windowsサービスの起動】

• Magic xpi に関連するWindowsサービスを起動します。

【Windowsサービスのログオンアカウント】

• 前頁のMagic xpi に関連するWindowsサービスのログオンアカウントはデフォルトで「ローカルシステムアカウント」となっています。
• Magicモニタのサービス「Magic xpi 4.13 Monitor Display Server」のログオンアカウントは、Windows Server 2016など一部のサーバOSにおいては、デフォルトのローカルシステムアカウントでは権限が足りず、 Magic モニタ表示時にエラーが発生することがあります。その場合は、管理者権限を持ったアカウントに変更してください。
• Magic xpi で共有フォルダにアクセスする際は、GigaSpacesのサービス「Magic xpi 4.13 GSA」のログオンアカウントを、共有フォルダへのアクセス権を持ったアカウントに変更してください。

【GigaSpacesの実装状況の確認】

• デスクトップのショートカットから「GigaSpaces – UI」を起動します。
• GigaSpacesが正常に起動していないと、デバッグやモニタからの実行ができません。

• 内部DBとしてMSSQLを使用している場合、Windowsのファイアウォールの設定によっては、MSSQLが使用するTCPポート「1433」の通信がブロックされ、GigaSpaces – UIにおいてMAGIC_INFOが表示されないことがあります。
• MAGIC_INFOが表示されない場合、次頁の手順に従って、TCPポート「1433」の受信の規則や送信の規則を作成し、TCPポート「1433」の通信ができるようにしてから 「Magic xpi 4.13 GSA」サービスを再起動してみてください。

【受信の規則の作成例】

• コントロールパネル > 管理ツール > セキュリティが強化されたWindows Defenderファイアウォールの左ペインの「受信の規則」を選択し、右ペインの「新しい規則」をクリックします。

【規則の種類】

• 規則の種類として「ポート」を選択し、「次へ」ボタンを押します。

【プロトコルおよびポート】

• 「TCP」プロトコルの「1433」ポートを指定し、「次へ」ボタンを押します。

【操作】

• 操作として「接続を許可する」を選択し、「次へ」ボタンを押します。

【プロファイル】

• 全てのプロファイルにチェックを入れ、「次へ」ボタンを押します。

【名前】

• 適当な名前（例えば「MS SQL Server」）を入力し、「完了」ボタンを押します。