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

Porta VM サポートチェックリスト

何かが機能しないときの最初のステップとして、稼働中の Porta VM デプロイメントでこのチェックリストを実行します。上から下まで約 5 分で完了し、より深いトラブルシューティングの前に、最も一般的な構成ドリフトの原因（IP の変更、停止したコンテナ、古い /etc/hosts エントリ、連携の設定ミス）を浮き彫りにするよう設計されています。

このページ全体で:

  • <VM-IP> は、ローカルネットワーク上の Porta VM の IPv4 アドレス（静的 IP が構成されている場合はそれ）を意味します。
  • <HOST-IP> は、Windows ホストの IPv4 アドレス（多くの場合 d3net アダプター上）を意味します。
  • VM の SSH ユーザーは常に portavm です。

デプロイメントの特定

Section titled “デプロイメントの特定”

  • VM が実行されている。 Windows ホストの VirtualBox で、Porta VM が Running 状態である。ヘッドレスモードでも問題ありません。

  • VM のホスト名が一意である。

    SSH を使用して VM に接続します（以下のコマンドを自分の値に置き換えてください）。

    • portavm は接続に使用するユーザー名です
    • VM-IP はネットワーク上の VM の IPv4 アドレスです
    Terminal window
    ssh portavm@<VM-IP>
    

    # Example: ssh portavm@192.168.50.9

  • VM の IP とホスト名を取得する。 VM 内で次を実行します。

    Terminal window
    ~/scripts/vm_info.sh

    これにより、次が表示されます。

    • ホスト名。
    • IPv4 アドレス。
    • MAC アドレス。
    • /etc/hosts の内容。

  • Porta のバージョンを取得する。 VM 内で porta_check_version を実行します（VM イメージ 0.9.14.2 以降で利用可能）。

  • Porta Manager のバージョンを取得する。 VM 内で mngr_check_version を実行します（VM イメージ 0.9.14.2 以降で利用可能）。

Docker コンテナ

Section titled “Docker コンテナ”

VM 内で docker ps -a を実行します。想定されるベースラインは次のとおりです。

Porta アプリケーションスタック

Section titled “Porta アプリケーションスタック”

アプリケーションスタックは、レプリケーショングループ内のマシンの役割に応じて名前が付けられた、これらのセットを 1 つ実行します。

  • porta が実行中で、ポート 8080（UI）と 8000（API）が公開されている。
  • 次のいずれかが実行中である。
    • porta-db（ポート 3306 / repl 33061）— main マシン。
    • porta-db-2（ポート 3307 / repl 33062）— backup マシン。
    • porta-db-3（ポート 3308 / repl 33063）— arbiter マシン。
  • porta-socket が実行中で、ポート 6001 が公開されている。
  • porta-redis が実行中で、ポート 6379 が公開されている。

Porta Manager スタック

Section titled “Porta Manager スタック”

すべての Porta VM は、役割に関係なく Porta Manager スタックを実行します。

  • porta-manager-app が実行中で、ポート 88 が公開されている。
  • porta-manager-horizon が実行中である。公開ポートなし。
  • porta-manager-task が実行中である。公開ポートなし。
  • porta-manager-db が実行中で、ポート 3310 が公開されている。
  • porta-manager-redis が実行中で、ポート 6378 が公開されている。

Porta アプリケーションへのアクセス

Section titled “Porta アプリケーションへのアクセス”
  • Porta は、http://localhost:8080 ではなく http://<VM-IP>:8080 でブラウザからアクセスされている。
    • VM はネットワーク上の別個のホストであり、localhost は Porta を実行していない Windows マシンに到達します。
  • API にも同じルールが適用されます: http://<VM-IP>:8000。
  • Porta UI のデータベースステータスアイコンが緑である。
  • http://<VM-IP>:8000/health でデータベースヘルスダッシュボードがすべて緑である。
  • http://<VM-IP>:8000/horizon の Horizon キューダッシュボードに、積み上がった失敗ジョブが表示されない。
  • Porta の Window → Settings → Integrations → Socket Server で、URL が http://<VM-IP>:6001 である。
  • Porta の Window → Settings → Channels で、想定されるチャネルが一覧表示されている。
    • 表示されない場合は、チャネルパネルの同期ボタンをクリックします。
  • Porta の Window → Settings → Preference で、グループシーケンスを使用する場合は次が有効になっている。
    • 「Enable Play Groups」
    • 「Enable play group sequence」
  • Porta の Window → Settings → Preference で、「Local Live Preview」が希望の値に設定されている。

Porta Manager へのアクセス

Section titled “Porta Manager へのアクセス”

  • Porta Manager に http://<VM-IP>:88 で到達できる。

  • Porta Manager の Porta Configuration Management → Machines で、各マシン行に表示される IP アドレスが、その VM の実際の静的 IP と一致している。

Designer、Unreal、Porta Bridge

Section titled “Designer、Unreal、Porta Bridge”

  • Designer が実行中で、想定されるプロジェクトが開いている。

  • アクティブな Designer プロジェクトが、Porta が使用するよう構成されているページ、テンプレート、チャネルと一致している。

  • Unreal（使用する場合）が実行中で、プラグインが最新であり、想定されるプロジェクトが開いている。

  • Unreal の Porta プラグイン設定が正しい Porta インスタンスを参照している。

    • Connection URL: http://<VM-IP>:6001 または http://porta-socket.server:6001
    • API URL: http://<VM-IP>:8000 または http://porta.server:8000

  • porta-socket.server または porta.server ホスト名を使用している場合、Unreal マシンの Windows hosts ファイルがそれらを VM の現在の静的 IP にマッピングしている。

  • Porta Bridge が実行中である。

  • Porta Bridge のインスタンスが 1 つだけ実行中である。

  • Porta Bridge が最新である。

  • Porta Bridge が正しい Porta と Designer に接続されている。

  • Porta Bridge の構成がデプロイメントと一致している。

    • API URL: http://<VM-IP>:8000
    • Socket Server URL: http://<VM-IP>:6001 または http://porta-socket.server:6001（ホスト名を使用する場合は対応する Windows hosts エントリ付き）
    • HTTP Listener IP Address: Windows ホストの IPv4（Bridge が実行されている場所）

  • Bridge マシンの Windows ホストファイアウォールで、インバウンドトラフィック用にポート 1500 が開いている。Scheduler はこのポートを使用してトランスポートとメディアのリクエストを駆動します。

ネットワークとファイアウォール

Section titled “ネットワークとファイアウォール”

  • VM に静的 IP がある。 VM 内で:

    Terminal window
    ~/scripts/static_ip_info.sh

    これは /etc/netplan/99-portacfg.yaml の内容を表示します。空の場合、VM は DHCP 上にあり、IP が変わる可能性があります。ネットワークによっては、これがすでに現在のインシデントを引き起こしている可能性があります。Manually Setting Up a Static IP を参照してください。

  • VM の /etc/hosts ファイルがレプリケーショングループを正しくマッピングしている。 VM 内で view_hosts_file を実行します。単一マシンのセットアップでは、唯一の重要なエントリは 127.0.0.1 localhost です。レプリケーションの場合、各 VM には次が必要です。

    Terminal window
    <MAIN IP>     porta-db
    <BACKUP IP>   porta-db-2
    <ARBITER IP>  porta-db-3

  • Windows ホストファイアウォールが、次のポートでのインバウンドトラフィックを許可している。

    • MySQL ポート: 3306、3307、3308
    • グループレプリケーションポート: 33061、33062、33063
    • ソケットサーバー: 6001
    • Porta UI: 8080
    • Porta API: 8000
    • Porta Manager: 88
    • Porta Bridge HTTP Listener: 1500（別の場合は Bridge マシン上）

    VM はネットワークアダプターを LAN にブリッジするため、これらのポートはホストの観点からも到達可能である必要があります。

ディスクとリソース

Section titled “ディスクとリソース”

  • VM に空きディスク容量がある。 VM 内で:

    Terminal window
    check_diskspace

    / の空きが約 10 パーセント未満の場合は問題です。porta コンテナはログの書き込みに失敗し、データベースは新しいトランザクションを拒否します。

  • Docker に大きな再利用可能キャッシュがない。 VM 内で:

    Terminal window
    docker_disk_usage

    「Images Reclaimable」が数ギガバイトを超える場合は、次で解放します。

    Terminal window
    docker image prune -af

    これは未使用のイメージのみを削除します。ボリューム（データ）は保持されます。

  • VirtualBox が VM に十分なホストリソースを割り当てている。 VirtualBox の Settings → System で、VM に少なくとも次があることを確認します。

    • 8 GB RAM
    • 4 vCPU
    • AVX2 をサポートする CPU

    割り当て不足は、次の頻繁な原因です。

    • rcu: detected stalls on CPUs/tasks メッセージ。
    • 起動が遅い。
    • 断続的なコンテナの再起動。

チェックが失敗した場合

Section titled “チェックが失敗した場合”

失敗した各チェックについては、Porta VM Troubleshooting guide の該当するセクションを参照してください。失敗したチェックから復旧手順までのほとんどの経路がそこに記載されています。