This document is about: SERVER 4
SWITCH TO

Photon Control

Photon ControlはPhotonのワンストップ・コントロールUIです。
PhotonControl.exeを起動するとトレイバーにアイコンが追加されますが、ウィンドウが開いたり、サーバーが起動することはありません。

アイコンが灰色の場合、Photonが実行されていないことを示します。
Photon Serverのいずれかが処理を実行中の場合には、アイコンは青色に変わります。

概要

Photon Server: Photon Control
Photon Control: アプリケーションを実行中

アイコンをクリックして、メニューを開いてください。
以下が可能になります:

  • Photonの起動と停止。
  • Photonサービスのインストール、起動および停止。
  • 「LoadBalancing (MyCloud)」のゲームサーバー設定の変更。
  • Photonのパフォーマンス監視(PerfMon)カウンターの設定と開始。
  • ログファイルの表示。
  • 作業パスをエクスプローラーで表示。
  • Photonの最新バージョンを使用していることを確認。

Photon Controlを開始するには、管理者権限が必要です。
これによってWindowsファイアウォールにエントリを作ることが可能になり、最も重要な点としてPhotonへのサービスの追加や削除ができるようになります。

まず、Photon Controlはライセンスを読み込み、ライセンスの有効期間とPhotonの最新バージョンを使用しているかを確認し、結果を「Photon Control」メニューに表示します。

「Autostart Photon Control」オプションを使うと、Windowsへのログイン時にPhoton Controlを起動します。
このオプションは「Explore Working Path」を使用してPhotonのファイルを検索できるため、リモートマシンにアクセスする際に便利です。

アイコンが表示されない場合は小さな三角形をクリックし、Photon Controlのアイコンをポップアップからトレイにドラッグアンドドロップしてください。

Photon Server: Photon Control
Photon Control: トレイアイコンを非表示化

PhotonControlを起動

PhotonControl.exe を起動し、
このアプリケーションの管理者権限を確認してください。
Photonをサービスとしてセットアップするオプションのために管理者権限が必要です。

デフォルトでは右下にあるトレイバーアイコンをクリックし(白または灰色)、
Photonの管理メニューを開きます。

起動しているアプリケーションによっては、Photonが使用できるようになるまで数秒かかる場合があります。 Photon Controlを終了しても、サーバーはシャットダウンされません。

Photonを実行

Photon Server: Photon Control menu
Photon Control: コンテキストメニュー

デフォルトでは、1つのPhoton設定(または「インスタンス」と呼びます)が利用可能です。
これはサーバーアプリケーションと、各アプリケーションにマッピングされたポートの組み合わせを指します。

"LoadBalancing (MyCloud)" というインスタンスを起動すると、ネームサーバーとマスターサーバーが動作し、Photon Cloudと互換性のある最小のセットアップになります。

パブリックサーバー上では、Photonはサービスとして実行する必要があります。
Photon Controlでは3つの手順が必要です。

  • Photonサービスをインストール
  • PerfMonカウンターをインストール(有用な場合があります)
  • Photonをサービスとして起動

PerfMonカウンターは実行の要件ではありませんが、Photonを実行中は有効化できません。このため、必要に応じて最初にPerfMonカウンターを設定するべきです。

Photonをアプリケーションとして実行することは、ローカル開発での代替策です。
ログオフすると、Photonはシャットダウンされます。

Photonを移動

Photonを1つのフォルダから別のフォルダに移動する前に、 すべてのサービスとPhoton Controlの自動起動を必ず削除してください。
新しい場所に再びインストールしてください。

「LoadBalancing IP Config」パスの変更

Photon Controlを拡張的に変更することはできませんが、「PhotonControl.exe.config」内で一部の重要な設定がされています。 「GameServerConfigPaths」の設定は、LoadBalancingにもとづくプロジェクトの名前が変更された場合に必要になるかもしれません。

GameServerConfigPathsは「PhotonControl.exe」のフォルダに関連したパスを「;」で区切ったリストです。

ログ

Photonは必要不可欠な情報(状態、例外など)を複数のログファイルにロギングしています。
「Open Logs」をクリックするとPhotonが12時間以内に使用したすべてのログが表示されます。
もちろん、必要に応じてさらに多くのファイルを開くことが可能です。

2つの「ログ」フォルダがあります:

  • すべての アプリケーションログdeploy/logフォルダ にあります。
    ビジネスロジックでログされたものはすべて、deploy/logフォルダの適切なファイルに記録されます。
  • 「server core's log」フォルダは実行ファイル(例: deploy\bin_Win64\log)の格納場所です。
    インスタンスとCLR(.Net runtime)に関連したすべてのものを格納します。

ロジック層ではLog4Netを使用しています。
Log4Netは拡張的に設定でき、非常に便利です。Log4netの詳細についてはこちらを参照してください。

カウンター

パフォーマンス分析およびエラー分析のため、Photonは必要不可欠な複数の値のトラッキングし続けています。
これらは、2つに分かれた一連のカウンターで表示されます:「PerfMonカウンター」と「ダッシュボードカウンター」です。

PerfMonカウンター

PerfMonカウンターはPhotonコアからのキー値で、接続ピア、パッケージ数、信頼性の高いUDPの使用状況、トラフィックなどの値をトラッキングします。開発者はこれらのカウンターを変更できず、PerfMonによってアクセスされます。
PerfMonはこれらのパフォーマンスグラフを作成するためのGUIで、既にWindowsにインストールされています。

PerfMonカウンターが(GUIを実行せずに)長時間ログを記録する必要がある場合には、Photon Controlをセットアップしてファイルへのロギングを開始できます。
「PerfMon Counters」の下で「Create Logging Set」と「Start Logging」をクリックしてください。
ログは「"C:\PerfLogs\Admin\photon_perf_log_<date>.blg"」の下で終了します。

トラブルシューティング

Photonの挙動が想定どおりでない場合には、常にログを確認してください。

以下は、よくある落とし穴であり、確認が必要です。

  • .NET 4.0の欠落: この場合Photonは起動できません。
    CLRバージョンとこちらを混同しないでください。
  • アプリケーションの欠落: 構成されたアプリケーションの1つを見つけられない場合には、Photonは起動できません。
    展開フォルダと設定を照合してください。
  • ビルドが最新版ではない: 新しいサーバーSDKに切り替える場合、libsフォルダからアセンブリを参照して、アプリケーションを常に再構築する必要があります。さもないと、互換性がなくなる可能性があります。
  • ファイアウォール: Photonが稼働していても、別のマシンからアクセスできない場合には、ファイアウォールを確認してください。より新しいバージョンのWindowsには役割と権利があり、ホスティング事業者はおそらくファイアウォール装置を使用している事でしょう。
  • ラグ: デフォルトでは、ラウンドトリップタイムはローカルでも約50ミリ秒です。
    これは設定に依存し、セットアップページに説明が記載されています。以下を参照してください:Send Delay and Ack Delay(送信遅延とのACK遅延)

ライセンス情報

Photon Serverが作動するにはライセンスが必要です。

PhotonControlは、起動時に「.license」ファイルからいくつかの値を読み込みます。
CCU、有効期限などを確認するには、メニューの「License Info」項目を選択してください。
「.license」ファイルを置換した場合には、PhotonControlとPhoton Serverを再起動して新しい値を取得する必要があります。

サーバーログには、ライセンスに不可欠な値も含まれています。

詳細情報はライセンスページを参照してください。ライセンスを新規追加する場合にはこちらのガイドに従ってください。

Back to top