コンテンツにスキップ
Disguise User Guide

インストール手順

手順

Section titled “手順”

インストールおよび更新の手順は、Porta On-Prem を実行する各マシンで実施する必要があります。

関連項目

Section titled “関連項目”

インストール前の要件

Section titled “インストール前の要件”

インストールプロセスを開始する前に、IT と協力してマシンが同じネットワーク上にセットアップされていることを確認してください。

事前にマシンの準備が完了していることを確認してください: Initial Machine Setup

Porta On Prem のインストール

Section titled “Porta On Prem のインストール”

このプロセスは、新しいマシンへのインストール、または既存インストールを消去するためのクリーンインストールを対象としています。既存インストールの更新手順については、下記の 既存インストールの更新 を参照してください。

  1. Docker が実行されていることを確認します。

  2. porta-onprem-bundle.zip アーカイブを、インストールするマシンのデスクトップに転送します。

    • インターネットにアクセスできる場合は、Help メニュー > Plugins の下、https://staging.porta.solutions で見つけられます。

  3. 右クリックして、ファイルをデスクトップに展開します。

  4. 展開した porta-onprem-bundle フォルダを開き、porta-helpers フォルダに移動します。

    このフォルダには、Porta On Prem のインストールと更新に使用する install および update スクリプトのほか、データベース操作を実行するためのヘルパースクリプトを含む database フォルダが含まれています。

  5. install.bat を右クリックして「管理者として実行」を選択し、インストールプロセスを開始します。

  6. プロンプトが表示されたら、Ubuntu (WSL) の sudo パスワードを入力して Enter を押します。

  7. データベースレプリケーションについて尋ねられたら、y と入力して Enter を押します（マシンが 1 台のみの場合でも）。

  8. プロンプトが表示されたら、Porta マシンの タイプ を入力します。現在作業しているマシンに応じて、main、backup、または arbiter になります。

  9. プロンプトが表示されたら、Porta マシンの IP を入力または確認します。

  10. プロンプトが表示されたら、他の Porta マシンの IP を入力します。

  11. 初回のみ のインストール、または失敗後の再インストールで、まだ Porta を使用していない場合は、y でデータベースを消去することを確認します。

  12. インストールが続行するのを待ちます。インストーラーが再びプロンプトを表示するまで最大 10 分かかることがあります。予期しないエラーが発生した場合、プロセスは中断されます。

    • gzip: porta-images.tar already exists; do you wish to overwrite (y or n)? というプロンプトが表示されることがあります。y と入力して Enter を押し、続行します。

    Error response from daemon: conflict: unable to delete 143f1a610ec2 (must be forced) - image is being used by stopped container の後に Error occurred in command: 'xargs docker rmi' というエラーメッセージが表示されるのは正常で、インストールは中断されません。

  13. インストールが完了に近づくと、Should this database be bootstrapped? というプロンプトが表示されます。これが Porta をインストールした最初で唯一のマシンの場合は、y と入力して Enter を押します。別のマシンですでに Porta が実行されている場合は、n と入力して Enter を押します。

  14. インストールが完了すると、インストールが成功したというメッセージが表示され、Porta On Prem と Porta On Prem バックアップへのショートカットがデスクトップに作成されます。

  15. インストールされたばかりの Porta のバージョンは、porta-onprem-bundle/porta-helpers/porta-checks に移動して check-version.bat をダブルクリックすることで確認できます。

  16. これがメインマシンだった場合は、バックアップマシンでステップ 1〜16 を繰り返します。

    • バックアップマシンを開始する前に、必ずメインマシンのインストール完了を待ってください。バックアップマシンのデータベースをセットアップする前に、メインマシンのデータベースが実行されている必要があります。

  17. これがバックアップマシンだった場合は、arbiter マシンでステップ 1〜16 を繰り返します。

    • arbiter マシンを開始する前に、必ずメインマシンとバックアップマシンのインストール完了を待ってください。arbiter マシンのデータベースをセットアップする前に、他のデータベースが実行されている必要があります。

  18. Porta Bridge と Unreal プラグインをセットアップするには（該当する場合）、Porta 連携のセットアップ を参照してください。

既存インストールの更新

Section titled “既存インストールの更新”

  1. デスクトップに既存の porta-onprem-bundle.zip がある場合は、porta-onprem-bundle-old.zip にリネームします。

  2. 上記の #Installing-Porta-On-Prem セクションのステップ 1〜4 に従います（更新と新規インストールで同じです）。

  3. #Installing-Porta-On-Prem セクションのインストールステップ 1〜4 を実施した後、porta-helpers フォルダで porta-database フォルダ、次に actions に移動し、create-backup.bat をダブルクリックして、更新前にデータベースのバックアップを作成します。

  4. porta-helpers フォルダで update.bat を右クリックし、「管理者として実行」を選択して更新プロセスを開始します。

  5. プロンプトが表示されたら、Ubuntu (WSL) の sudo パスワードを入力して Enter を押します。

  6. データベースレプリケーションについて尋ねられたら、y と入力して Enter を押します（マシンが 1 台のみの場合でも）。

  7. プロンプトが表示されたら、Porta マシンの タイプ を入力します。現在作業しているマシンに応じて、main、backup、または arbiter になります。

  8. プロンプトが表示されたら、Porta マシンの IP を入力または確認します。

  9. プロンプトが表示されたら、他の Porta マシンの IP を入力します。

  10. 更新が続行するのを待ちます。更新が再びプロンプトを表示するまで最大 10 分かかることがあります。エラーが発生した場合、プロセスは中断されます。

    • gzip: porta-images.tar already exists; do you wish to overwrite (y or n)? というプロンプトが表示されることがあります。y と入力して Enter を押し、続行します。

    注: Error response from daemon: conflict: unable to delete 143f1a610ec2 (must be forced) - image is being used by stopped container の後の Error occurred in command: 'xargs docker rmi' は中断を引き起こしません。これは正常です。

  11. 更新が完了に近づくと、Should this database be bootstrapped? というプロンプトが表示されます。その答えは、現在のデータベースレプリケーショングループの状態によって異なります。これは porta-onprem-bundle/porta-helpers/porta-database に移動し、view-ALL-group-repl-status.bat をダブルクリックすることで確認できます。これにより、グループ内の各マシンのステータスエントリが表示されます。

    • 結果の出力に MEMBER_STATE が ONLINE で MEMBER_ROLE が PRIMARY のエントリがある場合、グループはすでにブートストラップされており、答えは n であるべきです。
    • 結果の出力ですべてのエントリの MEMBER_STATE が OFFLINE の場合、このマシンをブートストラップしても安全で、答えは y であるべきです。
    • それ以外のすべての場合、答えは n であるべきです。

      • 進め方がまだわからない場合は、n を選択してサポートにお問い合わせください。

    • この出力は次のようになります。
    Terminal window
    "Viewing group replication status as reported by PORTA-DB..."
    +---------------------------+--------------------------------------+----------------+-------------+--------------+-------------+----------------+----------------------------+
    | CHANNEL_NAME              | MEMBER_ID                            | MEMBER_HOST    | MEMBER_PORT | MEMBER_STATE | MEMBER_ROLE | MEMBER_VERSION | MEMBER_COMMUNICATION_STACK |
    +---------------------------+--------------------------------------+----------------+-------------+--------------+-------------+----------------+----------------------------+
    | group_replication_applier | 1a351ce3-ba19-11ee-9e59-0242ac120002 | 192.168.50.163 |        3306 | ONLINE       | PRIMARY   | 8.0.32         | XCom                       |
    | group_replication_applier | d7c0535c-ba19-11ee-9f28-0242ac140002 | 192.168.50.20  |        3307 | ONLINE       | SECONDARY   | 8.0.32         | XCom                       |
    | group_replication_applier | e4a0ac63-ba19-11ee-9f54-0242ac150002 | 192.168.50.42  |        3308 | ONLINE       | SECONDARY     | 8.0.32         | XCom                       |
    +---------------------------+--------------------------------------+----------------+-------------+--------------+-------------+----------------+----------------------------+
    

    "Viewing group replication status as reported by PORTA-DB-2..."
    +---------------------------+--------------------------------------+----------------+-------------+--------------+-------------+----------------+----------------------------+
    | CHANNEL_NAME              | MEMBER_ID                            | MEMBER_HOST    | MEMBER_PORT | MEMBER_STATE | MEMBER_ROLE | MEMBER_VERSION | MEMBER_COMMUNICATION_STACK |
    +---------------------------+--------------------------------------+----------------+-------------+--------------+-------------+----------------+----------------------------+
    | group_replication_applier | 1a351ce3-ba19-11ee-9e59-0242ac120002 | 192.168.50.163 |        3306 | ONLINE       | PRIMARY   | 8.0.32         | XCom                       |
    | group_replication_applier | d7c0535c-ba19-11ee-9f28-0242ac140002 | 192.168.50.20  |        3307 | ONLINE       | SECONDARY   | 8.0.32         | XCom                       |
    | group_replication_applier | e4a0ac63-ba19-11ee-9f54-0242ac150002 | 192.168.50.42  |        3308 | ONLINE       | SECONDARY     | 8.0.32         | XCom                       |
    +---------------------------+--------------------------------------+----------------+-------------+--------------+-------------+----------------+----------------------------+
    

    "Viewing group replication status as reported by PORTA-DB-3..."
    +---------------------------+--------------------------------------+----------------+-------------+--------------+-------------+----------------+----------------------------+
    | CHANNEL_NAME              | MEMBER_ID                            | MEMBER_HOST    | MEMBER_PORT | MEMBER_STATE | MEMBER_ROLE | MEMBER_VERSION | MEMBER_COMMUNICATION_STACK |
    +---------------------------+--------------------------------------+----------------+-------------+--------------+-------------+----------------+----------------------------+
    | group_replication_applier | 1a351ce3-ba19-11ee-9e59-0242ac120002 | 192.168.50.163 |        3306 | ONLINE       | PRIMARY   | 8.0.32         | XCom                       |
    | group_replication_applier | d7c0535c-ba19-11ee-9f28-0242ac140002 | 192.168.50.20  |        3307 | ONLINE       | SECONDARY   | 8.0.32         | XCom                       |
    | group_replication_applier | e4a0ac63-ba19-11ee-9f54-0242ac150002 | 192.168.50.42  |        3308 | ONLINE       | SECONDARY     | 8.0.32         | XCom                       |
    +---------------------------+--------------------------------------+----------------+-------------+--------------+-------------+----------------+----------------------------+

  12. データベースがブートストラップされていない場合、Should the database be migrated? というプロンプトが表示されます。これが更新される最後のマシンで、更新プロセス中にどのマシンもブートストラップされていない場合は、y と入力して Enter を押します。それ以外の場合は、Enter を押して n を確認します。

  13. データベースがブートストラップされていない場合、Should the database be seeded? というプロンプトが表示されます。この更新でシードするよう指示されていない場合は、n と入力または確認します。それ以外の場合で、これが更新される最後のマシンで、更新プロセス中にどのマシンもブートストラップされていない場合は、y と入力して Enter を押します。それ以外の場合は、n と入力して Enter を押します。

  14. 更新が完了すると、インストールが成功したというメッセージが表示されます。

  15. インストールされたばかりの Porta のバージョンは、porta-onprem-bundle/porta-helpers/porta-checks に移動して check-version.bat をダブルクリックすることで確認できます。

  16. Porta がブラウザで開いている場合は、ページを更新して更新を読み込みます。

  17. これがメインマシンだった場合は、バックアップマシンでステップ 1〜14 を繰り返します。

    • バックアップマシンを開始する前に、必ずメインマシンのインストール完了を待ってください。バックアップマシンのデータベースをセットアップする前に、メインマシンのデータベースが実行されている必要があります。

  18. これがバックアップマシンだった場合は、arbiter マシンでステップ 1〜14 を繰り返します。

    • arbiter マシンを開始する前に、必ずメインマシンとバックアップマシンのインストール完了を待ってください。arbiter マシンのデータベースをセットアップする前に、他のデータベースが実行されている必要があります。

  19. 該当する場合は、Porta Bridge と Unreal プラグインの構成を更新します。詳細は下記の Porta 連携のセットアップ を参照してください。

Porta 連携のセットアップ

Section titled “Porta 連携のセットアップ”

Porta Bridge

Section titled “Porta Bridge”
  1. Bridge を管理者として実行します。
  2. D3 Connection Configuration を入力します。
  3. Start ボタンを押す前に、メニュー Window > Porta に移動します。
  4. Socket Server URL が http://porta-socket.server:6001 であることを確認します。
  5. API URL が http://<PORTA-MACHINE-IP>:6001 であることを確認します。
    • <PORTA-MACHINE-IP> を、現在 Porta を実行しているマシンの IP アドレスに置き換えます。
  6. Http Listener IP Address が <BRIDGE-MACHINE-IP> であることを確認します。
    • <BRIDGE-MACHINE-IP> を、Bridge を実行しているマシンの IP アドレスに置き換えます。
    • Bridge が Porta と同じマシンで実行されている場合、これはおそらく Porta マシンの IP と同じです。
  7. Window > D3 に移動し、Start ボタンを押して Porta を D3 に接続します。

Unreal Plugin

Section titled “Unreal Plugin”

ローカル

Section titled “ローカル”

Unreal が Porta On Prem と同じマシンでローカルに実行されている場合、Unreal プラグインは次のように設定する必要があります。

  • Connection URL: http://porta-socket.server:6001
  • API URL: http://<PORTA-MACHINE-IP>:8000
    • <PORTA-MACHINE-IP> を、現在 Porta を実行しているマシンの IP アドレスに置き換えます。

外部

Section titled “外部”

Unreal が Porta On Prem とは別のマシンで実行されている場合、Unreal のセットアップは少し異なります。

  1. Unreal マシンで、Windows の hosts ファイルを 管理者として 開きます（C:\Windows\System32\drivers\etc にあります）。
    • これは多くの場合、スタートメニューを開いて notepad と入力し、Notepad アプリケーションを検索するのが最も簡単です。
    • Notepad アプリケーションを右クリックして「管理者として実行」を選択します。
  2. 次のエントリを hosts ファイルの末尾にコピー＆ペーストし、各 <XXXXXXX MACHINE IP> を適切なマシンの IP に置き換えます。hosts ファイルを All files (*.*) のタイプで保存します（ファイル拡張子は付けないでください）。 
    <PORTA MACHINE IP> porta.server

その後、Unreal プラグインは次のように設定する必要があります。

  • Connection URL: http://porta.server:6001
  • API URL: http://porta.server:8000

Chrome での Porta へのアクセス

Section titled “Chrome での Porta へのアクセス”

「Main Company」を使用し、Socket Server URL を確認して、ソケットサーバーが http://porta-socket.server ではなく http://<PORTA-MACHINE-IP>:6001 に設定されていることを確認します。

デフォルトのログイン認証情報:

  • email: superadmin@disguise.one

ブラウザで Porta にアクセスする際は、必ず localhost ではなくマシン IP を使用してください。

Porta: http://<PORTA-MACHINE-IP>:8080/
Porta API: http://<PORTA-MACHINE-IP>:8000/