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

Porta VM 診断チートシート

このページは、Porta VM デプロイメントで何がどこにあり、どう確認するかを一覧にしたものです。手順ではなくリファレンスとして扱い、診断する症状に合ったエントリを選んでください。

クイックデータ収集

Section titled “クイックデータ収集”

VM 内で、SSH 経由または VirtualBox コンソールで直接実行します。

Terminal window
# Bundles diagnostics under ~/logs/collected_data/YYYYMMDD/HH-SS/.
# Requires VM image 0.9.14.2 or newer.
collect_data


# Runs the full Porta diagnostics: versions, group members, health checks.
porta_diag


# Quick environment snapshot: hostname, IPv4, MAC, and /etc/hosts.
~/scripts/vm_info.sh

生成されたバンドルを Windows ホストにコピーするには、VirtualBox 共有フォルダを一度設定し（Porta On Prem VM Windows Shared Folder を参照）、次を実行します。

Terminal window
~/scripts/export_to_windows.sh ~/logs/collected_data/...

VM 内ヘルパー

Section titled “VM 内ヘルパー”

診断

Section titled “診断”
ヘルパー機能対応バージョン
collect_dataシステムとアプリのデータを収集するためのさまざまな診断を実行します。結果は ~/logs/collected_data/YYYYMMDD/HH-SS/ に保存されます。0.9.14.2+
porta_diagPorta サーバーの完全な診断を実行します。0.9.14.2+
view_hosts_file/etc/hosts の内容を表示します。0.9.14.2+
check_diskspace簡易ディスク容量チェック。0.9.14.2+
check_diskspace_sortedサイズ順に並べ替えたディスク容量チェック。0.9.14.2+
docker_disk_usageイメージ、コンテナ、ボリューム別の Docker ディスク使用量。0.9.14.2+
docker_volume_size <volume_name>名前付き Docker ボリュームのサイズを調べます。0.9.14.2+
~/scripts/vm_info.shVM のホスト名、IPv4 アドレス、MAC アドレス、/etc/hosts の内容を表示します。All
~/scripts/porta-manager/check-conn-cache.shすべての Porta Manager コンテナについて、キャッシュされた接続、読み込まれたメモリ内接続、データベース接続キャッシュを表示します。All

バージョン管理

Section titled “バージョン管理”
ヘルパー機能対応バージョン
porta_check_versionLaravel、PHP、MySQL、Redis、OS を含む Porta のバージョン情報を表示します。0.9.14.2+
mngr_check_versionPorta Manager のバージョン情報を表示します。0.9.14.2+
~/scripts/porta-manager/check-manager-version.shmngr_check_version の基盤となるスクリプト。All

ログ

Section titled “ログ”

各 Porta ログヘルパーには、現在の内容を出力する代わりにファイルを追跡する（tail -f に相当）_follow バリアントがペアで用意されています。

ヘルパー表示内容対応バージョン
porta_laravel_logs / porta_laravel_logs_followporta コンテナの /var/www/storage/logs/laravel-YYYY-MM-DD.log。0.9.14.2+
porta_php_errors / porta_php_errors_followporta コンテナの /var/log/php/errors.log。0.9.14.2+
porta_horizon_logs / porta_horizon_logs_follow/var/www/logs/horizon.log — キューワーカーとシーケンスのプレイアウト。0.9.14.2+
porta_task_logs / porta_task_logs_follow/var/www/logs/default_tasks.log — スケジュールされたタスク、データベースバックアップ、ソケットチェック。0.9.14.2+
porta_main_db_logs / porta_main_db_logs_followこのマシンが main マシンの場合の、このマシンの MySQL エラーログ。0.9.14.2+
porta_backup_db_logs / porta_backup_db_logs_followこのマシンが backup マシンの場合の、このマシンの MySQL エラーログ。0.9.14.2+
porta_arbiter_db_logs / porta_arbiter_db_logs_followこのマシンが arbiter マシンの場合の、このマシンの MySQL エラーログ。0.9.14.2+
mngr_app_logsPorta Manager アプリコンテナのログ。0.9.14.2+
mngr_horizon_logsPorta Manager インストーラーウィザードの処理ログ。0.9.14.2+
mngr_task_logsPorta Manager バックグラウンドタスクランナーのログ。0.9.14.2+
~/scripts/porta-manager/view-logs.sh [container] [lines]mngr_*_logs コマンドの基盤となるスクリプト。[container] は app、horizon、task のいずれかです。[lines] は行数、または追跡する場合は f です。All

レプリケーション

Section titled “レプリケーション”
ヘルパー機能対応バージョン
porta_group_statusこのマシンが報告するグループレプリケーションのステータスを表示します。0.9.14.2+
porta_all_group_status/etc/hosts のエントリを使用して、グループ内のすべてのマシンに対して同じステータスクエリを実行します。これが機能するには、各 VM の /etc/hosts が正しい必要があります。0.9.14.2+
porta_start_replこのマシンで START GROUP_REPLICATION を実行します。0.9.14.2+
porta_stop_replこのマシンで STOP GROUP_REPLICATION を実行します。0.9.14.2+
porta_bootstrapこのマシンからレプリケーショングループをブートストラップします。まず porta_all_group_status で確認し、他のメンバーがすでに primary になっていない場合にのみ実行してください。0.9.14.2+
porta_set_bootstrap_ONbootstrap フラグを ON として永続化します。このマシンは起動時に常に自身を primary として設定します。単一 VM のセットアップでのみ有用です。複数 VM のレプリケーショングループでは絶対に使用しないでください。スプリットブレインを引き起こす可能性があります。0.9.14.2+
porta_set_bootstrap_OFFbootstrap フラグを OFF として永続化します。これは Porta VM のデフォルト状態です。0.9.14.2+
~/scripts/porta/view-ALL-group-repl-status.shporta_all_group_status の基盤となるスクリプト。All

データベースバックアップ

Section titled “データベースバックアップ”
ヘルパー機能対応バージョン
porta_backup_dbPorta データベースのバックアップを作成します。生成された ZIP アーカイブは porta コンテナ内の /var/www/storage/app/Porta-Backups に保存されます。0.9.14.2+
porta_restore_dbバックアップから Porta データベースを復元します。ローカルで利用可能なダンプの一覧を表示します。0.9.14.2+
porta_db_dump [db_container_name] [db_name]raw mysqldump を実行します。デフォルトは porta-db と porta データベースです。0.9.14.2+
porta_db_restore [db_container_name] [db_name]mysqldump からデータベースを復元します。デフォルトは porta-db と porta データベースです。ローカルで利用可能なダンプの一覧を表示します。0.9.14.2+
porta_reset_db破壊的 — このマシン上のすべてのデータを消去し、マイグレーションからデータベースを再作成します。災害復旧の最終手段として使用されます。0.9.14.2+

Scheduler プレイアウト

Section titled “Scheduler プレイアウト”

これらのヘルパーは、同じ Scheduler のテーブルを、レプリケーショングループ内の異なるマシン上でクエリします。現在操作しているマシンに合ったバリアントを使用してください。たとえば、main マシンからは porta_playouts を、backup マシンからは porta_backup_playouts を実行します。

ヘルパー表示内容対応バージョン
porta_playouts直近 50 件の Scheduler プレイアウト（現在アクティブなエントリと次のエントリを含む）。main マシンのみ。0.9.14.2+
porta_playout_history直近 50 件の Scheduler プレイアウト履歴項目。main マシンのみ。0.9.14.2+
porta_backup_playouts直近 50 件の Scheduler プレイアウト。backup マシンのみ。0.9.14.2+
porta_backup_playout_history直近 50 件の Scheduler プレイアウト履歴項目。backup マシンのみ。0.9.14.2+
porta_arbiter_playouts直近 50 件の Scheduler プレイアウト。arbiter マシンのみ。0.9.14.2+
porta_arbiter_playout_history直近 50 件の Scheduler プレイアウト履歴項目。arbiter マシンのみ。0.9.14.2+

VM ライフサイクル

Section titled “VM ライフサイクル”
ヘルパー機能対応バージョン
~/scripts/reset_identity.sh新しいホスト名と一意のマシン ID を選択し、/etc/hosts を更新して再起動します。VM イメージを 2 台目または 3 台目のホストにインポートした後、コピーが同一の識別情報を共有しないように実行します。Manually Resetting the Identity of a Porta On Prem VM を参照してください。All
~/scripts/setup_static_ip.shnetplan を介して静的 IP を設定します。Porta VM の PowerShell セットアップスクリプトがこれを自動的に行うため、セットアップが途中で失敗した場合のみ手動で実行します。Manually Setting Up a Static IP を参照してください。All
~/scripts/disable_static_ip.sh/etc/netplan/99-portacfg.yaml の名前を変更して静的 IP 構成を無効にします。VM は次回起動時に DHCP にフォールバックします。All
~/scripts/reset_dhcp.sh新しい DHCP リースを強制し、キャッシュされたリースをクリアします。VM が静的 IP を使用していない場合にのみ意味があります。All
~/scripts/static_ip_info.sh現在の netplan 静的 IP 構成を表示します。All
~/scripts/setup_shared_folders.shWindows へのファイルエクスポート用に、VirtualBox 共有フォルダの VM 側を準備します。Porta On Prem VM Windows Shared Folder を参照してください。All

Porta Manager ライフサイクル

Section titled “Porta Manager ライフサイクル”
ヘルパー機能対応バージョン
update_manager（エイリアス install_manager）利用可能な最新の Porta Manager ビルドをダウンロードし、インストーラーを実行します。更新時に APP_KEY が保持されるよう、最初に自動的に backup-env.sh を実行します。All
mngr_init_user最初の Porta Manager 管理者ユーザーを初期化します。Porta Manager データベースの完全消去後にのみ必要です。0.9.14.2+
mngr_backup_env更新間で APP_KEY を保持するため、porta-manager-app コンテナから .env ファイルを ${MNGR_CONFIG_DIR}/.env にコピーします。update_manager の呼び出し時に自動的に実行されます。0.9.14.2+
mngr_restore_env保持された .env ファイルを ${MNGR_CONFIG_DIR}/.env から porta-manager-app コンテナに復元します。0.9.14.2+
mngr_recreateデータボリュームを保持したまま、既存のイメージから Porta Manager コンテナを再作成します。Porta Manager ダッシュボードで Fix IP Settings（IP 設定を修正） を実行せずに VM の IP が変更された場合に便利です。0.9.14.2+
mngr_wipe_recreate破壊的 — Porta Manager のデータとストレージボリュームを消去し、既存のイメージからコンテナを再作成します。Porta アプリケーションのデータには影響しません。0.9.14.2+
~/scripts/porta-manager/install-manager.shupdate_manager の基盤となるスクリプト。All
~/scripts/porta-manager/init-manager-user.shmngr_init_user の基盤となるスクリプト。All
~/scripts/porta-manager/backup-env.shmngr_backup_env の基盤となるスクリプト。install-manager.sh の一部として自動的に実行されます。All

各コンテナ内でファイルがある場所

Section titled “各コンテナ内でファイルがある場所”

porta コンテナ — UI と API

Section titled “porta コンテナ — UI と API”
パス注記
/var/wwwLaravel アプリケーションのルート。
/var/www/.envホスト、データベース認証情報、アプリキー、連携を含むアプリケーション環境ファイル。
/var/www/bootstrap/cache/config.phpキャッシュされた Laravel 構成。.env を変更した後は php artisan config:cache で再生成する必要があります。
/var/www/storage/logs/laravel-YYYY-MM-DD.logLaravel エラーログ。
/var/www/storage/app/Porta-Backups/*.zip自動および手動のデータベースバックアップ。
/var/www/logs/horizon.logHorizon ワーカーログ — シーケンスのプレイアウト。
/var/www/logs/default_tasks.logスケジュールタスクログ — データベースチェック、ソケットチェック、バックアップ。
/var/www/logs/default_queue.logデフォルトキューワーカーログ。エントリは FAIL ではなく DONE で終わるはずです。
/var/log/php/errors.logコンテナ内の PHP エラーログ。
/etc/nginx/sites-available/defaultNginx vhost。デフォルトの client_max_body_size は 1024M です。
/etc/supervisord.confSupervisor 構成。nginx、php-fpm、porta-horizon-worker_*、porta-task-worker_* を管理します。
/usr/local/etc/php/conf.d/app.iniPHP 構成。デフォルトの post_max_size は 1024M、デフォルトの upload_max_filesize は 1000M です。

porta-db* コンテナ — MySQL

Section titled “porta-db* コンテナ — MySQL”
パス注記
/etc/my.cnfMySQL 構成。
/var/lib/mysqlデータディレクトリ。Docker ボリュームとしてマウントされます。高度なシステム管理用途のみ。

porta-socket コンテナ

Section titled “porta-socket コンテナ”
パス注記
/usr/src/appNode.js ソース。
/usr/src/app/.envソケットサーバー環境 — Redis の URL とポート。

正常な起動ログには次の行が含まれます。

info: Starting namespace: /unreal
info: Starting namespace: /disguise
info: Starting namespace: /playout_status

Socket.IO 管理 UI は http://<VM-IP>:8000/socketio-adminui で利用できます。認証情報については support@disguise.one までお問い合わせください。

porta-redis コンテナ

Section titled “porta-redis コンテナ”

Porta API（Porta Scheduler を含む）からソケットサーバーへのメッセージを監視するには、Redis CLI セッションを開きます。

Terminal window
docker exec -it porta-redis redis-cli
> MONITOR
# or, only API → socket messages:
> PSUBSCRIBE *-API-msg

ヘルスチェックコマンド

Section titled “ヘルスチェックコマンド”

これらを porta コンテナに対して実行します。

Terminal window
docker exec -it porta bash -c "php artisan check:version"

データベースレプリケーションのヘルス

Section titled “データベースレプリケーションのヘルス”
Terminal window
docker exec -it porta bash -c "php artisan health:single-check 'PrimaryDatabaseConnectionCheck' --do-not-store-results --no-notification --fail-command-on-failing-check"


docker exec -it porta bash -c "php artisan health:single-check 'MysqlClusterCheck' --do-not-store-results --no-notification --fail-command-on-failing-check"


docker exec -it porta bash -c "php artisan health:single-check 'MysqlNodeStatusCheck' --do-not-store-results --no-notification --fail-command-on-failing-check"

Porta のアクティブなデータベース接続を調べるには、次を実行します。

Terminal window
docker exec -it porta bash -c "cat .env | grep DB_HOST"
docker exec -it porta bash -c "cat bootstrap/cache/config.php | grep -B 2 \"'default' => 'mysq\""

DB_HOST は、現在のプライマリの IP と同じ DB_HOST_# スロットを参照しているはずです。異なる場合、Porta バックエンドは読み取り専用レプリカと通信しています。プライマリ接続のヘルスチェックを再実行すると再接続がトリガーされます。

ブラウザ側モニタリング URL

Section titled “ブラウザ側モニタリング URL”
URL目的
http://<VM-IP>:8000/healthデータベースグループ、レプリケーション、プライマリ接続のヘルス。緑は正常です。
http://<VM-IP>:8000/horizonキューワーカーダッシュボード。失敗したジョブが積み上がっていないか確認します。
http://<VM-IP>:8000/socketio-adminuiSocket.IO 管理 UI。Disguise サポートからの認証情報が必要です。

Porta UI のブラウザコンソール（F12 → Console）が、UI 側エラーが表示される唯一の場所です。フロントエンドのログファイルはありません。

構成キャッシュの無効化

Section titled “構成キャッシュの無効化”

porta コンテナで構成キャッシュを更新するには、次を実行します。

Terminal window
docker exec -it porta bash -c "php artisan config:cache"

その後、PHP-FPM が起動時に読み取るものに変更があった場合は docker restart porta を実行します。

Porta Manager の場合、同等の操作は mngr_recreate で、既存のイメージから Manager コンテナを削除して再作成し、データボリュームを保持します。