Game > GameAnvil > コンソール使用ガイド > 管理

マシン

GameAnvilプロセスが実行される機器を登録し、登録されたマシンを管理するメニューです。

マシン登録前に、該当のマシンにGameAnvil Agentをインストールする必要があります。[ GameAnvil-Agent Download ]

management_machine_main.png

マシン登録

GameAnvilプロセスが実行される機器を登録します。

GameAnvilサービスを有効化した後、まず最初にマシン登録作業を行う必要があります。

management_machine_register.png * 入力タイプ:コンソールウィンドウに直接マシン情報を入力して登録できます。.csv形式ファイルをアップロードして、複数のマシンを登録できます。 * ホスト名:登録する機器のホスト名を入力します。 * IPアドレス:登録する機器のPublic IPアドレスを入力します。このアドレスでコンソールと通信するため、正確に入力する必要があります。 * GameAnvil Agent Port :該当の機器にインストールされたGameAnvil Agent Port情報を入力します。 (基本値は19080です。 ) * ファイルアップロード:テンプレートサンプルファイルをダウンロードして登録するマシン情報を入力し、ファイルをアップロードします。[ Template File]

マシンリスト

登録されたマシンリストを確認できます。ホスト名、IPアドレス、説明検索機能を提供します。 management_machine_list.png

マシン設定

マシン登録後、マスターマシンとロケーション管理マシンを設定します。

登録したマシンの中から1つのマスターマシンと1つ以上のロケーション管理マシンを選択します。

management_machine_setup.png * マスターマシン: Management Nodeが実行されるマシンを選択します。マスターマシンが登録されている時のみインスタンス / ノードの制御が可能です。 * ロケーション管理マシン: Location Nodeが実行されるマシンを選択します。 * Javaバージョン: GameAnvilサーバービルドに使用されているJavaのバージョンを選択します。

Management NodeとLocation Nodeは、GameAnvilを構成する必須ノードですが、コンテンツの実装および制御ができないノードです。 マシン設定 / マシン初期化機能を利用してManagement NodeとLocation Nodeを管理できます。

マシン設定の初期化

マシン設定機能を利用して、登録したマスターマシンとロケーション管理マシン設定を初期化する機能です。

既存のマシン設定値が初期化され、Management NodeとLocation Nodeも終了します。

登録されているすべてのインスタンスの状態が動作中ではない場合にのみ、マシンの設定を初期化できます。

management_machine_init.png

management_machine_setup_none.png

インスタンス

マシン管理を利用して、登録したマシンで起動するインスタンスを管理します。

インスタンスは複数のノードで構成され、ゲームの環境に応じてインスタンスを自由に構成できます。

リスト

登録されたインスタンスのリストを確認できます。

インスタンスの基本的な情報と構成されたノード情報が表示されます。

ManagementInstance-0

ノードタイプごとにフィルタ機能とインスタンス名、ホスト名検索機能を提供します。

フィルタと検索ワードはAND条件で動作します。

ManagementInstance-1

インスタンスに構成されたノードの詳細設定は確認ボタンを押して確認できます。

上部にあるタブからノードごとに確認できます。

ManagementInstance-2

登録

インスタンス登録画面です。

インスタンスの基本情報を入力し、任意の構成のノードを設定します。

ノード設定の場合、テンプレート形式でのみ入力が可能で、テンプレートの詳細な説明はインスタンス > 設定ガイドで確認できます。

インスタンスの基本情報を入力する登録画面の最上部です。

各項目の入力値はリアルタイムで確認して、形式に合っていない値が入力された場合は案内メッセージを表示します。

サーバービルドアップロードパスマシンの場合、一度登録した後は修正できない点に注意する必要があります。

ManagementInstance-3

インスタンスの基本情報(インスタンス名、サーバービルドアップロードパス)を入力すると、インスタンスを配布するマシンを選択できます。

マシン管理で登録したマシンのリストがポップアップに表示されます。

同じ構成のインスタンスを複数のマシンを選択して登録できます。

ManagementInstance-12

基本情報に続き、各ノードの設定を行います。

ノードタイプのうち、COMMON、VM_OPTIONは必ず設定する必要があり、GATEWAY、GAME、SUPPORT、MATCHのうち1つ以上のノードを必ず設定する必要があります。

ノードの設定は、設定の読み込みを利用して登録されているテンプレートを選択する方式でのみ行うことができます。

ManagementInstance-4

設定の読み込みポップアップから登録されているテンプレートの各ノード設定を確認できます。

テンプレート一覧から1つを選択すると、基本設定を除くすべての設定が登録画面に入力されます。

同じ構成のインスタンスを登録または管理する時に役立つように提供している機能です。

ManagementInstance-14

設定の読み込みを行ったら、COMMON、GATEWAY、SUPPORTのPort情報を入力する必要があります。

GATEWAY、SUPPORTノードは設定に応じてPortの入力を要求します。

GATEWAYノードが設定された画面です。

TCP/WEB SOCKETの使用状況に応じてPortの入力が動的に構成されます。

ManagementInstance-14

SUPPORTノードが設定された画面です。

設定されたサービス数に応じてPortの入力が動的に構成されます。

ManagementInstance-14

GATEWAY、SUPPORT設定に応じて構成されたPort入力領域です。

Portは18000~20000の間の値を使用し、同じマシン内で重複しないようにする必要があります。

構成されたPortの入力を終えた後、ポート重複確認を行い、登録されているインスタンスとのPort重複チェックを行う必要があります。

ManagementInstance-14

ポート重複確認により重複したPortが判明した場合は、案内ポップアップで重複したPort情報を確認できます。

この情報を元にPortを再入力した後、全ての入力値が重複しなくなるまでポート重複確認プロセスを繰り返す必要があります。

ManagementInstance-14

ポート重複確認が正常に完了したら、インスタンス登録画面内のすべての入力フィールドが無効状態になり、最終的に登録ができる状態になります。

保存する前に一部の設定を変更するには、設定を再入力ボタンを押して有効状態に切り替えた後、変更できます。

有効状態になったら、再びポート重複確認プロセスを踏むと登録可能な状態になります。

ManagementInstance-14

ManagementInstance-14

修正および削除

登録されたインスタンスの修正、削除を行うことができます。

インスタンスの修正、削除は、インスタンスの状態が起動待機、停止、エラー状態の時のみ可能です。

モニタリング > インスタンスモニタリングでインスタンスの現在状態を確認、変更できます。

ManagementInstance-15

ManagementInstance-16

インスタンス修正でサーバービルドアップロードパスマシン設定は変更できません。

インスタンスのノード設定は、登録方法と同じように設定の読み込みを行って変更できます。

ManagementInstance-17

設定

インスタンスの各タイプのノードのテンプレートを管理します。

インスタンスの登録時、各ノードの設定は直接入力せず、テンプレート選択によってのみ設定できます。

よく使用する各ノードの設定を登録しておき、インスタンスの登録時に使用できます。

リスト

登録されたテンプレートのリストを確認できます。

テンプレート名でソートされ、そのテンプレートを使用中のインスタンスの状況も確認できます。

テンプレート名検索機能を提供します。

ManagementTemplate-1

ManagementTemplate-2

登録

テンプレート登録画面です。

インスタンスの各ノードに適用する設定をテンプレートに登録します。

インスタンス登録画面では、各ノードの設定を直接入力できず、テンプレートでのみ設定が可能なため、必要な設定を事前に登録する必要があります。

基本設定値を提供するため、これを利用してテンプレートの登録を行うことができます。

ゲーム特性に合わせてテンプレートを登録して活用してください。

ManagementTemplate-3

各ノードの設定は、直接設定値を入力して登録することができ、設定の読み込みを行って登録されているテンプレート設定を読み込んで登録することもできます。

類似したテンプレートを登録したい時、設定の読み込みで設定を読み込んだ後、変更が必要な一部設定値のみを直接入力して登録してください。

ManagementTemplate-3

ノードタイプのうち、COMMON、VM_OPTIONは、必ず設定する必要があり、GATEWAY、GAME、SUPPORT、MATCHの中から1つ以上のノードを必ず設定する必要があります。

COMMONノードの設定値です。

ManagementTemplate-4

VM OPTIONノードの設定値です。

ManagementTemplate-5

GATEWAYノードの設定値です。

TCP/WEB SOCKET、SSLの使用状況に応じて設定値が異なります。

ManagementTemplate-6

GAMEノードの設定値です。

ManagementTemplate-7

GAMEノードはサービスを選択して設定する必要があります。

サービス選択ポップアップから最大99個のサービスを選択して設定できます。

サービスは管理 > インスタンス > サービスメニューで管理できます。

ManagementTemplate-8

サービスを選択して確認したら、各サービスに必要な設定値を追加で入力します。

ManagementTemplate-9

SUPPORTノードもサービスを選択して設定する必要があります。

GAMEノードと同じように、サービス選択ポップアップで最大99個のサービスを選択した後、設定値を追加で入力します。

ManagementTemplate-10

テンプレートの登録中に、あらかじめ登録できなかったサービスがある場合は、サービス選択ポップアップから登録できます。

サービス登録ボタンをクリックすると、登録ポップアップが表示されます。

ここでサービスID、サービス名を入力してサービスを登録できます。

登録のみ行うことができます。修正、削除は管理 > インスタンス > サービスメニューで行うことができます。

ManagementTemplate-11

ManagementTemplate-12

最後にMATCHノードの設定値です。

ManagementTemplate-13

テンプレートは入力項目ごとに基本値とMin/Max値制限が適用されている項目があります。

設定値初期化機能は、該当ノードの設定を基本値に戻します。

GAMESUPPORTノードは、設定値初期化機能を提供しません。

Min/Max範囲を超えた値が入力された場合、該当フィールドからフォーカスアウトした時、フィールドに設定に Min/Max値に自動変更されます。

修正および削除

登録されたテンプレートの修正、削除を行うことができます。

テンプレートの修正、削除は、そのテンプレートが適用されたすべてのインスタンスの状態が起動待機、停止、エラー状態の時のみ可能です。

テンプレートを使用中のインスタンスは、設定リストからポップアップで確認できます。まtインスタンスモニタリングからインスタンスの現在の状態を確認、変更できます。

ManagementTemplate-5

テンプレートの修正では、設定の読み込み機能を提供しないため、必要な設定値を直接修正する必要があります。

ManagementTemplate-16

そしてインスタンスに適用されたテンプレートは、インスタンスの状態と関係なく削除ができません。

該当インスタンスでテンプレートを変更するか、インスタンスを削除した後、テンプレートを削除できます。

ManagementTemplate-17

サービス

サービスとは、GameAnvilで製作されたサーバーコードのBootstrapプロセスにおいてGAMESUPPORTノードで使用する識別子です。

リスト

登録されたサービス一覧を確認できる画面です。

サービスタイプ(GAME、SUPPORTの順)でソートされ、その後、サービスIDでソートされます。

該当サービスが使用されているテンプレートがあるか、ある場合はどのテンプレートなのかを確認できます。

サービス名で検索する機能が提供されます。

ManagementService-1

登録

サービスIDは1~99の数値を入力します。重複した数値は使用できません。

サービス名はサーバーコードのBootstrapに使われた識別子と同じでなければならず、大文字/小文字を区別するため、誤字に注意してください。サービスIDと同様に重複した値は使用できません。

サービスの登録方法は2つあります。直接入力方式とファイルアップロード方式です。

直接入力は、以下のように直接入力をクリックして、値を直接入力する方式です。

ManagementService-2

ファイルアップロード方式は、以下のようにファイルアップロードをクリックして、テンプレートサンプルファイルをクリックしてテンプレート様式に合わせてデータを入力した後、ファイル選択を行うか、ドラッグアンドドロップして複数のサービスをまとめて保存できます。

このとき注意する点は、ファイルをアップロードできるのは1つのサービスタイプだけのため、GAMEとSUPPORTを分けて保存することです。

ManagementService-3

保存を押した後、以下のような画面が表示されます。入力した値が正しいか確認した後、一番下の保存ボタンをもう一度押して、入力した値をサーバーに送ります。

ManagementService-4

修正および削除

サービス名を修正、削除する場合は、リストから該当サービスをクリックすると詳細画面表示に切り替わります。

修正は、該当サービスが登録されたテンプレートを利用して動作しているインスタンスがない時に行うことができます。

削除は、該当サービスが登録されたテンプレートがない時に行うことができます。

ManagementService-5

配布ファイル

GameAnvilインスタンスに配布されるプロセスファイルを管理するメニューです。

ManagementDeployFile-1

ファイルのアップロード

ファイルアップロードメニューから配布ファイルをアップロードできます。一度に1個のファイルのみアップロードが可能です。

拡張子が.jarのファイルのみアップロードをサポートし、ファイルサイズは最大1GBまで許容されます。

アップロードボタンを押すと、ファイルのアップロードが実行され、インスタンスモニタリングメニューで配布する機能を実行すると配布が完了します。

ManagementDeployFile-2

配布履歴

配布ファイルリストから配布履歴確認を押すと、その配布ファイルの配布履歴が下に表示されます。

配布が行われたインスタンス、マシン、配布日時などの情報を確認できます。

ManagementDeployFile-3

TOP