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

Porta On Prem VM セットアップガイド

setup_vm.ps1 PowerShell スクリプトは、新しい VM のセットアップを自動的にガイドします。定期的な操作が必要になりますが、全体としてこのスクリプトは次を行います。

  • Hyper-V が有効な場合は検出して無効化します。
  • 新しい Porta VM イメージをインポートするか、既存の VM を使用します。
  • VM のネットワーク設定を構成します。
  • OpenSSH Windows 機能を有効にします。
  • SSH キーを生成し、VM への SSH アクセスを設定します。
  • 必要に応じて Windows ファイアウォールにルールを追加します。
  • 必要に応じて VM の識別情報をリセットします。
  • VM の静的 IP アドレスを構成します。

Prerequisites

Section titled “Prerequisites”

セットアッププロセスを開始する前に、物理マシンが前提条件を満たしていることを確認してください。

  • 最新の Porta On Prem 仮想マシンリリースの zip ファイル。
    • この zip には setup_vm.ps1 スクリプトと .ova VM イメージファイルが含まれます。
    • イメージは .ova ファイルで、VirtualBox にインポートできる仮想マシンイメージです。
    • イメージは、Docker と Porta Manager がインストール済みの、設定済み Ubuntu イメージです。
  • VirtualBox 7.1.8 がインストールされていること。
  • 最新の Porta On Prem アプリケーションの zip ファイル。
  • データベースレプリケーションを実行する場合は、最低 3 台の物理マシン。
コンポーネント仕様
Operating SystemWindows 11 64-bit
HypervisorVirtualBox 7.1.8
CPUIntel i7 第 4 世代（必須: AVX2 対応 CPU）
Memory8GB RAM
Storage100GB 以上の空きディスク容量

セットアップ

Section titled “セットアップ”

  1. セットアップの開始

    Section titled “セットアップの開始”
    1. インストール先の Windows マシンで、最新の Porta On Prem VM zip ファイルを解凍します。
    2. Windows PowerShell または Windows Terminal を右クリックし、「管理者として実行」を選択します。
    3. 開いたウィンドウで、次のコマンドを実行します。
      Terminal window
      Powershell -ExecutionPolicy ByPass -NoExit -File "\Path\to\setup_vm.ps1"
      例:
      Terminal window
      Powershell -ExecutionPolicy ByPass -NoExit -File "C:\Users\user.name\Desktop\setup_vm.ps1"

  2. スクリプトの実行

    Section titled “スクリプトの実行”
    • スクリプトの実行が始まり、Porta VM のパスワードを求められます。
    • Disguise から提供された Porta VM のパスワードを入力し、Enter を押します。

  3. Hyper-V チェック

    Section titled “Hyper-V チェック”

    Porta VM をセットアップして実行するには、Hyper-V が有効になっていてはいけません。Hyper-V の状態は自動的にチェックされます。

    • Hyper-V がすでに無効になっている場合、スクリプトは自動的に続行します。
    • Hyper-V が有効になっている場合は、y を入力して Enter を押し、無効にする必要があります。
      1. 今すぐ無効にする場合は、コンピューターを再起動する必要があります。
        • 今すぐ再起動するには、y を入力して Enter を押します。
      2. 再起動後、setup_vm.ps1 スクリプトを再度実行し、ステップ 1 から開始します。

  4. VirtualBox チェック

    Section titled “VirtualBox チェック”

    スクリプトは VirtualBox がインストールされているかをチェックします。

    • VirtualBox がすでにインストールされている場合、スクリプトは自動的に続行し、次のステップに進めます。
    • VirtualBox がインストールされていない場合は、インストールを求められます。
      1. インストールする場合は、y を入力して Enter を押します。
      2. スクリプトが VirtualBox を自動的にダウンロードしてインストールします。
      3. インストール後、コンピューターの再起動が必要になる場合があります。
        • 今すぐ再起動するには、y を入力して Enter を押します。
      4. 再起動後、setup_vm.ps1 スクリプトを再度実行します。

  5. VM Selection

    Section titled “VM Selection”

    新しい VM をインポートするか、既存のものを使用するかのオプションが表示されます。

    1. 1 を入力して Enter を押し、新しい VM のインポートを選択します。
    2. 開いたファイルエクスプローラーウィンドウで、VM zip を解凍したフォルダに移動し、.ova ファイルを選択します。
    3. Open をクリックしてこのファイルをインポートします。
    4. イメージのインポートが始まります。完了するまで待ちます。数分かかる場合があります。
      • ターミナルに多数の出力が表示されますが、無視して構いません。
    5. インポートが完了すると、スクリプトは「Successfully imported the appliance.」と表示し、自動的に次のステップに進みます。

  6. VM Network Configuration

    Section titled “VM Network Configuration”

    1. 一覧表示されたアダプターに対応する番号を入力して Enter を押し、VM に使用させるネットワークアダプターを選択します。

      • どのアダプターを選ぶべきか不明な場合は、(Status: Up ...) と表示されているものを選択します。
      • マシンがより複雑なネットワーク構成の場合、機能するアダプターが見つかるまで別のアダプターを試すか、ネットワーク管理者に支援を求める必要がある場合があります。

    2. これで仮想マシンの電源が入り、起動を開始します。

      • これにより別のターミナルウィンドウが開き、多数の出力が一時的に表示される場合があります。
      • VM の起動を待つ間、PowerShell ウィンドウには VM が完全に起動するまで定期的に「Waiting for VM to start…」と表示されます。

    3. PowerShell ウィンドウに、後で Porta にアクセスするために使用される、検出された VM の IP アドレスが表示されます。

      • 例: VM is running with IP: 10.221.113.136

    4. authenticity of the host can't be established と警告され、接続を続行するか尋ねられます。

    5. yes と入力して Enter を押します（「yes」はターミナルに表示されませんが、入力されています）。

    6. ターミナルに「SSH connection established successfully」と表示されます。

    7. ファイアウォールルールの設定は任意です。n を入力して Enter を押すことで設定を断れます。

  7. Resetting Identity

    Section titled “Resetting Identity”
    1. 複数の仮想マシンを実行している場合は、y を入力して Enter を押します。
    2. 新しいホスト名を入力するか、Enter を押してデフォルトの推奨ホスト名を使用します。
    3. パスワードを再度数回求められた後、VM が再起動します。
      • 約 30 秒後、VM がオンラインに戻ります。
      • VM の再起動時にタイムアウトエラーが発生することは珍しくありません。発生した場合は Timed out waiting for VM to come online セクションを参照してください。
    4. その後、スクリプトは VM の新しい IP アドレスを取得し、ターミナルに表示します。
      • パスワードをさらに数回求められる場合があります。

  8. Setting Static IP Address

    Section titled “Setting Static IP Address”

    スクリプトは自動的に VM の静的 IP の設定に進みます。

    1. スクリプトがネットワークスキャンを実行し、ネットワーク上の利用可能な IP アドレスを検索します。
    2. 一覧表示された利用可能な IP のいずれかに対応する番号を入力して Enter を押し、仮想マシンの IP アドレスを選択します。
      • カスタム IP アドレスを入力する場合:
        • 完全な IP アドレス（例: 192.168.1.100）を入力します。
        • その IP が使用中と思われる場合は、y を入力して Enter を押し、確認するよう求められます。
    3. 次に、以下のオプションのいずれかに対応する番号を入力して Enter を押し、マシンのロール（タイプとも呼ばれます）を選択します。
      1. main
      2. backup
      3. arbiter
    4. スクリプトが、選択した静的 IP アドレスとマシンロールで VM の構成を進めます。
      • ターミナルにはパスワードプロンプトを含む多数の出力が表示されますが、無視して構いません。
    5. IP 構成が完了すると、スクリプトは「Static IP setup completed successfully! VM is now accessible at IP:」と新しい静的 IP アドレスを表示します。

  9. 完了

    Section titled “完了”

    セットアップが完了すると、VM を使用する準備が整います。

    • ブラウザで VM の IP アドレスとポート 88 から Porta Manager（インストーラーウィザード）にアクセスします: http://VM-IP:88。
    • Porta Manager のログイン認証情報は次のとおりです。
      • メールアドレス: superadmin@disguise.one
      • パスワード: Porta VM のパスワード
    • サインイン後、ダッシュボードの「Begin」ボタンをクリックして、インストーラーウィザードで Porta をインストールできます。
      • 最新の Porta On Prem バンドルをダウンロードし、インストーラーウィザードで求められたときにアップロードできるよう準備しておいてください。

VM セットアップ中によくある問題のトラブルシューティング

Section titled “VM セットアップ中によくある問題のトラブルシューティング”

ACPI Shutdown is taking longer than 3 minutes

Section titled “ACPI Shutdown is taking longer than 3 minutes”

マシンを強制的に停止します。

  • VM のターミナルウィンドウで、File > Close > Power Off Machine。

VM ターミナルウィンドウが閉じたら、VirtualBox でサイドバーの VM をダブルクリックするか、VM を選択してヘッダーの Start ボタンをクリックして、再度起動します。

Timed out waiting for VM to come online

Section titled “Timed out waiting for VM to come online”

「Timed out waiting for VM to come online」エラーは、IP 設定や識別情報のリセット中に発生することが珍しくありません。次の手順を試してください。

  1. まず、マシンを正常にシャットダウンしてみます。
    • VM のターミナルウィンドウで、File > Close > ACPI Shutdown。
  2. これでウィンドウに新しい出力が表示されない、または完了に 1〜2 分以上かかる場合は、マシンを強制的に停止できます。
    • VM のターミナルウィンドウで、File > Close > Power Off Machine。
  3. 最初の PowerShell ウィンドウに戻り、Ctrl+C を入力して VM セットアップスクリプトを停止します。
  4. キーボードの Up 矢印を押して、このガイドの冒頭の setup_vm.ps1 コマンドを表示し、Enter を押して setup_vm.ps1 スクリプトを再実行します。
  5. VM Selection ステップまで前と同様に続行します。
  6. 新しい Porta VM のインポートか既存のものの使用を求められたら、2 を入力して Enter を押します。
  7. 現在のステータス（実行中または停止）とともに、利用可能な VM の一覧が表示されます。
  8. 先ほどインポートした VM を、一覧の番号を入力して Enter を押して選択します。
  9. VM がまだ実行されていない場合、スクリプトが起動します。
  10. 上記の Network Configuration からの手順を続行します。

Failed to establish SSH connection

Section titled “Failed to establish SSH connection”

Network Configuration ステップでこのエラーが発生し、かつ IP が 127.0.0.1 と表示されていた場合は、以下の VM IP Address is 127.0.0.1 を参照してください。

Resetting Identity ステップでこのエラーが発生した場合は、VM セットアップ完了後に、VM の識別情報を手動でリセットし、マシンの静的 IP を手動で設定する必要があります。手順については Manually Resetting Identity と VM Static IP Setup ガイドを参照してください。

Setting Static IP Address ステップでこのエラーが発生した場合は、VM セットアップ完了後に手動で静的 IP を設定する必要があります。手順については VM Static IP Setup ガイドを参照してください。

VM IP address is 127.0.0.1

Section titled “VM IP address is 127.0.0.1”

VirtualBox が正しいネットワークアダプターに接続されていないか、DHCP が機能していない可能性があります。次の手順で問題の解決を試みてください。

  1. VM が実行中の場合はシャットダウンします。
  2. Windows で PowerShell を開き、ipconfig /all を実行してすべてのアダプターとその名前を一覧表示します。
  3. VirtualBox を開き、VM の Settings -> Network Settings に移動します。
  4. VM の「Attached to」が「Bridged Adapter」に設定されており、選択された「Name」が ipconfig の結果に一覧表示された使用したいアダプターの名前と一致していることを確認します。
  5. VM を起動して再試行します。

“No available IPs found”

Section titled ““No available IPs found””

ネットワークスキャンが完了しない、または利用可能な IP が見つからないことがあります。これが発生するシナリオはいくつかあり、解決策はどれに該当するかによります。

  • Resetting Identity ステップ中にこの問題が発生した場合は、VM セットアップ完了後に手動で識別情報のリセットや静的 IP の設定を行う必要があります。手順については Manually Resetting Identity と Manual Static IP Setup ガイドを参照してください。
  • Setting Static IP Address ステップ中にこの問題が発生した場合は、VM セットアップ完了後に手動で IP を構成する必要があります。手順については VM Static IP Setup ガイドを参照してください。

VirtualBox error when importing appliance: E_INVALIDARG 0X80070057

Section titled “VirtualBox error when importing appliance: E_INVALIDARG 0X80070057”

ディスク容量の問題である可能性が高いです。VM のデフォルトの場所が十分な容量のあるドライブにあることを確認してください。

  • VirtualBox で File > Preferences > General に移動し、必要に応じて Default Machine Folder を変更します。

VM booting is stuck on “Begin: Loading essential drivers”

Section titled “VM booting is stuck on “Begin: Loading essential drivers””

VM をシャットダウンし、VM の VirtualBox Settings -> Storage に移動します。これらが想定どおりに設定されていることを確認します。前回この問題が発生したときは、SATA ハードディスクの Solid State ボックスをチェックすることで解決しました。

rcu: detected stalls on CPUs/tasks or other similar errors in the VM terminal

Section titled “rcu: detected stalls on CPUs/tasks or other similar errors in the VM terminal”

これは VM がリソース不足に陥っていることを示します。通常、VM を再起動すると問題が解決します。VM のターミナルウィンドウに移動し、File > Close > ACPI Shutdown をクリックして VM を正常にシャットダウンします。

これでウィンドウに新しい出力が表示されない、または完了に 1〜2 分以上かかる場合は、VM のターミナルウィンドウに移動して File > Close > Power Off Machine をクリックし、マシンを強制的に停止できます。

このエラーが頻繁に発生するようになった場合は、物理マシンが VM requirements を満たしていることを確認し、満たしている場合は Disguise サポートにお問い合わせください。

systemd-networkd.service: Watchdog timeout message / array-index-out-of-bounds message in the VM terminal

Section titled “systemd-networkd.service: Watchdog timeout message / array-index-out-of-bounds message in the VM terminal”

このメッセージはセットアップ中に表示されることがありますが、通常は問題ありません。セットアップが正常に完了すれば、このメッセージは無視して構いません。

VM Disk Space Issues

Section titled “VM Disk Space Issues”

（Windows 自体ではなく）VM でディスク容量の問題が発生した場合は、VM のターミナルで次のコマンドを実行して Docker のファイルシステムを確認します。

Terminal window
docker system df

表示される例を以下に示します。

TYPE            TOTAL     ACTIVE    SIZE      RECLAIMABLE
Images          12        4         13.77GB   10.3GB (74%)
Containers      4         4         360MB     0B (0%)
Local Volumes   7         3         6.55GB    6.334GB (96%)
Build Cache     0         0         0B        0B

Images の「Reclaimable」容量が大きい場合は、VM に接続して次を実行することで解放できます。

Terminal window
docker image prune -af

それでも容量が必要な場合は、Disguise サポートに支援をお問い合わせください。