4.xから5.0へのBETAアップグレードガイド

このガイドは、v4からv5 BETAへの移行に関するものです。

主な変更点の概要

以前にライセンスをお持ちでなく、20個の無料CCUブートストラップ・ライセンスを使用してサーバーを使用していた場合、新しいバージョンのサーバーを使用するためには、今すぐライセンスを取得する必要があります。 それ以外にも、いくつかの設定変更の見直しが必要です。

ライセンスの更新とアップグレード

Photon SDKの新しいメジャー・バージョンにアップグレードする場合や、新たに購入したライセンス・ファイルを使用して古いSDKバージョンを使用する場合は、そのライセンスでPhoton SDKが動作することを事前に確認しておく必要があります。

最も簡単な方法は、使用する予定のPhoton SDKのフォルダにライセンスファイルを入れ、Photon Controlアプリケーションを介してPhotonを起動することです。 その後、トレイ・アプリに表示されるライセンス情報を確認し、さらにログにライセンス・エラーがないか確認してください。

PhotonServer.config 変更点

• サーバーアプリケーションインスタンスの定義に、新しい構文を使用することを推奨します: 以下を削除し:

XML

<Configuration>
  <InstanceName>
  </InstanceName>
</Configuration>

以下を記載してください:

XML

<Configuration>
  <Instance Name="InstanceName">
  </Instance>
</Configuration>

• Applicationノードの廃止された属性を削除

  • RestartDelayMilliseconds
  • WatchFiles
  • ExcludeFiles

• Applicationノードの廃止された属性を削除（少なくともfalseに設定）。

  • EnableShadowCopy
  • EnableAutoRestart
  • ForceAutoRestart

• TCPListenerの廃止された属性を削除

  • MaxQueuedBuffers
  • MaxPendingWrites

• LoadBalancingインスタンスからCounterPublisherアプリケーションノードを削除

• MMOインスタンスを削除

• UnhandledExceptionPolicy "の値 "ReloadDomain "を "Ignore "または "TerminateProcess "に置き換え

• LoadBalancingインスタンスでは、デフォルトのアプリケーションがNameServerになり、v4で使用されていたMasterではなくなりました。

セキュアリスナーの設定

セキュアチャンネル(Schannel)からOpenSSLに移行したため、セキュアリスナーの証明書の形式と設定が変わりました。

• 廃止された属性を削除
  • StoreName
  • UseMachineStore
  • CertificateName

証明書のセットアップの新しい設定に置き換えてください。 詳しくは証明書の設定をご覧ください。

ロードバランシング設定の変更点

プラグイン設定

プラグインの設定を "deploy\Loadbalancing\GameServer\bin\Photon.LoadBalancing.dll.config"から "deploy\LoadBalancing\GameServer\bin\plugin.config"に移動。

NameServer (NEW)

v5では、これまでPhoton Cloudでのみ利用可能だったNameServerアプリケーションを追加しました。 このアプリケーションの設定は以下の2つのファイルで行います。

• 1つは実際のアプリケーション用のファイルです。カスタム認証はMasterServerではなくNameServerで行われるようになりました。そのため、カスタム認証の設定（<AuthSettings>）をMasterServerの設定ファイルからNameServerの設定ファイル"deploy\NameServer\Photon.NameServer.dll.config"に移動します。

• もう1つはNameServer に関連づけられるリージョン（MasterServer）のリストのためのファイルです。このファイルは deploy\NameServer\Photon.NameServer.dll.config の NameServerConfig 設定で変更できます。デフォルトは "deploy\Nameserver.json "です。

PhotonServer.configのLoadBalancingインスタンスのデフォルトアプリケーションが、v4では「Master」だったのに対し、「NameServer」に変更されました。

ロードバランサーとワークロードの設定変更

レベル名の更新

v4では5つのレベルしか存在しませんでした。 これらのレベル名は「Lowest」、「Low」、「Middle」、「High」、「Highest」でした。

現在は、「Level0」、「Level1」、「Level2」、...、「Level9」となっています。 「Lowest」は「Level0」に置き換えられました。 「Highest」は「Level9」に置き換えられました。

ワークロード設定の変更

GameServerの設定である "WorkloadConfigFile "は、LoadBalancerの設定ファイルのパスを設定します。 v5ではデフォルトで "deploy˶Workload.1Gbps.config "となっています（以前は "Workload.config"）。 また、SDKにもサンプルファイル"Workload.config"が用意されている。

コントローラー設定の更新

旧コントローラの設定：

XML

<add Name="{ControllerName}" InitialInput="0" InitialLevel="Lowest">
  <FeedbackLevels>
    <add Level="Lowest" Value="{LowestValue}"/>
    <add Level="Low" Value="{LowValue}"/>
    <add Level="Normal" Value="{NormalValue}"/>
    <add Level="High" Value="{HighValue}"/>
    <add Level="Highest" Value="{HighestValue}"/>
  </FeedbackLevels>
</add>

新コントローラの設定：

XML

<Controller Name="{ContollerName}" InitialInput="0" InitialLevel="Lowest">
  <FeedbackLevels>
    <Level name="0" Level="Level0" Value="{Value0}" ValueDown="{ValueDown0}"/>
    <Level name="1" Level="Level1" Value="{Value1}" ValueDown="{ValueDown1}"/>
    <Level name="2" Level="Level2" Value="{Value2}" ValueDown="{ValueDown2}"/>
    <Level name="3" Level="Level3" Value="{Value3}" ValueDown="{ValueDown3}"/>
    <Level name="4" Level="Level4" Value="{Value4}" ValueDown="{ValueDown4}"/>
    <Level name="5" Level="Level5" Value="{Value5}" ValueDown="{ValueDown5}"/>
    <Level name="6" Level="Level6" Value="{Value6}" ValueDown="{ValueDown6}"/>
    <Level name="7" Level="Level7" Value="{Value7}" ValueDown="{ValueDown7}"/>
    <Level name="8" Level="Level8" Value="{Value8}" ValueDown="{ValueDown8}"/>
    <Level name="9" Level="Level9" Value="{Value9}" ValueDown="{ValueDown9}"/>
  </FeedbackLevels>
</Controller>

ロードバランサーの設定変更

LoadBalancer の設定ファイルは "deploy˶LoadBalancer.config" です。

XML

<?xml version="1.0" encoding="utf-8" ?>
<LoadBalancer>
  <LoadBalancerWeights>
    <add Level="Lowest" Value="{LowestValue}"/>
    <add Level="Low" Value="{LowValue}"/>
    <add Level="Normal" Value="{NormalValue}"/>
    <add Level="High" Value="{HighValue}"/>
    <add Level="Highest" Value="{HighestValue}"/>
  </LoadBalancerWeights>
</LoadBalancer>

新しい構造：

XML

<?xml version="1.0" encoding="utf-8" ?>
  <LoadBalancer ReserveRatio="{ReserveRatio}" ValueUp="{ValueUp}">
    <LoadBalancerWeights>
      <Level name="0" Level="Level0" Value="{Value0}" />
      <Level name="1" Level="Level1" Value="{Value1}"/>
      <Level name="2" Level="Level2" Value="{Value2}"/>
      <Level name="3" Level="Level3" Value="{Value3}"/>
      <Level name="4" Level="Level4" Value="{Value4}"/>
      <Level name="5" Level="Level5" Value="{Value5}"/>
      <Level name="6" Level="Level6" Value="{Value6}"/>
      <Level name="7" Level="Level7" Value="{Value7}"/>
      <Level name="8" Level="Level8" Value="{Value8}"/>
      <Level name="9" Level="Level9" Value="{Value9}"/>
    </LoadBalancerWeights>
  </LoadBalancer>