6.1. Connectサーババージョンアップガイド¶

6.1.1. 本資料について¶

本項は、Ericom Connect（以下Connect）の前のバージョンから、最新にバージョンアップする際の簡易手順です。

6.1.2. 事前に準備するもの¶

お願い

事前バックアップをお願いします

単体構成、冗長構成、どちらの構成におかれましてもバージョンアップ事前準備として、以下の実施をお奨め致します。

SQL Serverデータベースのバックアップ(Ericom Connectで利用中のデータベース)
Ericom Connectサーバ上の下記パスにある「EricomConnect」フォルダ
※フォルダのバックアップは、全Connectサーバのものを取得します。
C:¥ProgramData¥EricomConnect
このフォルダは隠しファイル属性になっていますので、表示する場合はエクスプローラで[表示]メニューで[隠しファイル]をチェックしてください。

※どちらも念のための実施となります

必要なサーバ環境
- 既に構築されているEricom Connectサーバ(物理/仮想いずれも可)
  
  ※ 最新バージョンより前のバージョン
- Active Directoryサーバ
Ericom Connect インストールメディア
Ericom Connectの管理者アカウント
SQL ServerのSAアカウント
接続用デバイス（PC、シンクライアント端末、iPad等）

注意

Ericom Connectをバージョンアップする際、MessageLogテーブルのデータが大きい場合、タイムアウトで失敗することがあります。事前にサイズを削減しておいてください。削減手順は「 SQL Server ログデータ削除手順」を参照してください。

6.1.3. Ericom Connect のバージョンアップ¶

単体構成の場合のバージョンアップ¶

既存のConnectサーバにて作業を行います。
Connectサーバが単体構成の場合の手順です。
既存のConnectサーバをアンインストールし、最新のConnectサーバをインストールして、バージョンアップを行います。

Connectの構成パターン(RDS、ダブルブラウザLinux)によって、Connectサーバ上にインストールするコンポーネントの種類が異なります。「構成パターン別 Connect インストールコンポーネント」を参照の上、環境に合わせてコンポーネントをインストールして下さい。

Connectの管理者ユーザでConnectサーバにログインし、[スタートメニュー]より、[Ericom Connect Configuration Tool]を起動します。
[Stop Services]をクリックし、Connectサーバのサービスを停止します。
サービスが停止したら[Exit]をクリックし、Ericom Connect Configuration Toolを閉じます。
コントロールパネルから[プログラムと機能]を開き、[Ericom Connect]を右クリックして[アンインストール]を選択します。
[Preserve existing configuration for future installations and upgrades]にチェックが入っていることを確認し、[Remove]をクリックします。
[Installation Wizard Completed]と表示されたら、[Finish]をクリックしてウィザードを閉じます。必ずサーバを再起動してください。
最新バージョンのConnectをインストールします。[EricomConnect.exe]をダブルクリックしてインストールウィザードを開始します。 Connect 8.0以上のインストールには .Net 4.5.2以上が必要です。必要に応じてインストールしてください。インストールメディア内の以下フォルダにインストーラーがございます。 [.NET Framework 4.5.2]フォルダ
「I accept the terms in the license agreement」にチェックを入れ、[Next]をクリックします。
[Custom]をクリックします。
インストールするコンポーネントを選択します。チェックする項目につきましては、「構成パターン別 Connect インストールコンポーネント」を参考に、必要なコンポーネントをチェックして、[Install]をクリックします。
インストールが完了したら、[Finish]をクリックして閉じます。
Ericom Connect Configuration Toolが起動してきます。[Upgrade / Redeploy]をクリックします。
SQLサーバのバックアップを勧めるメッセージが表示されます。[OK]をクリックします。
[Database Admin]にグリッド作成時に設定したデータベースのアカウント(デフォルトではグリッド名と同じ）とパスワードを入力します。 ※パスワードが不明な場合は、SQL Server上の[SQL Server Management Studio] にWindows認証でログインし、パスワードを変更してください。 [Lookup Service Hosts]には、グリッド作成時に設定したConnectのIPアドレスを入力してください。 ※9.x以降では、[My Hostname or IP]及び[Lookup Service Hosts]には、ホスト名ではなくIPアドレスを設定することが推奨されています。また、9.2以降では、IPアドレス以外を設定して進めた場合、警告が表示されます。
バージョンアップの途中で、Connectの管理者アカウントの入力を求められます。アカウント名とパスワードを入力して[OK]をクリックします。
[*Completed*]と表示されたら、バージョンアップ完了です。[Exit]をクリックしてEricom Connect Configuration Toolを閉じます。

お願い

新バージョンは、旧バージョンと管理コンソールの設定や接続時の設定が異なる場合があるため、最新の設定を必ずご確認ください。

警告

グリッドに参加しているコンポーネントはバージョンを統一する必要があります。RemoteAgentがインストールされているリモートデスクトップ/ターミナルサーバ,VDI,IVEXダブルブラウザLinuxのRemoteAgent、及びSecureGateway、 AccessPad(ダブルブラウザ連携キット含む)もバージョンアップしてください。

冗長構成の場合のバージョンアップ¶

既存のConnectサーバにて作業を行います。
Connectサーバの冗長構成が2台で構成されている場合の手順です。
既存のConnectサーバをアンインストールし、最新のConnectサーバをインストールして、バージョンアップを行います。

Connectの構成パターン(RDS、ダブルブラウザLinux)によって、Connectサーバ上にインストールするコンポーネントの種類が異なります。「構成パターン別 Connect インストールコンポーネント」を参照の上、環境に合わせてコンポーネントをインストールして下さい。

1台目¶

Connectの管理者ユーザでConnectサーバにログインし、[スタートメニュー]より、[Ericom Connect Configuration Tool]を起動します。「Stop Services」をクリックしてConnectの全てのサービスを停止します。 2台のConnectサーバで行ってください。
サービスが停止後、Connectをアンインストールします。コントロールパネルの「プログラムの機能」から「Ericom Connect」を選択して「アンインストール」を実行します。
Connectのインストール・ウィザードが起動します。「Preserve existing configuration for furture installations and upgrades」がチェックされているのを確認してから「Remove」をクリックしてアンインストールを実行します。
Connectのアンインストールが終了したら「Finish」ボタンをクリックして、Connectのインストール・ウィザードを終了します。アンインストール後に必ずOSを再起動してください。
バージョンアップする最新のConnectのインストーラを実行します。Connectのインストール・ウィザードが起動したら「Next」をクリックします。 Connect 8.0以上のインストールには .Net 4.5.2以上が必要です。必要に応じてインストールしてください。
「I accept the terms in the license agreement」にチェックを入れ、[Next]をクリックします。
[Custom]をクリックします。
インストールするコンポーネントを選択します。チェックする項目につきましては、「構成パターン別 Connect インストールコンポーネント」を参考に、必要なコンポーネントをチェックして、[Install]をクリックします。
インストールが完了したら、[Finish]をクリックして閉じます。
Ericom Connect Configuration Toolが起動してきます。[Upgrade / Redeploy]をクリックします。
SQLサーバのバックアップを推奨するメッセージが表示されます。[OK]をクリックします。
[Database Admin]にグリッド作成時に設定したデータベースのアカウント(デフォルトではグリッド名と同じ）とパスワードを入力します。 ※ パスワードが不明な場合は、SQL Server上の[SQL Server Management Studio] にWindows認証でログインし、パスワードを変更してください。 [Lookup Service Hosts]には、グリッド作成時に設定したConnectのIP(複数台の場合はカンマ区切り)を入力してください。 ※ 9.x以降では、[My Hostname or IP]及び[Lookup Service Hosts]には、ホスト名ではなくIPアドレスを設定することが推奨されています。また、9.2以降では、IPアドレス以外を設定して進めた場合、警告が表示されます。 (9.x以降では、複数のConnectサーバを追加する場合には[Lokup Service Hosts]には下記[注意]の通りカンマで区切ってConnectサーバアドレスを記入してください。8.xでは、全てのConnectサーバを同一セグメント内に構築する限りにおいては、空欄でも問題ありません。）

注意

[Lookup Service Hosts]の内容は、同一Gridに参加しているマシン全てで、同一とする必要があります。

メッセージエリアにアップグレードのステータスが表示されていきます。
Connectの管理者アカウントの入力を求められます。アカウント名とパスワードを入力して[OK]をクリックします。
Gridのデータの配置がシングル構成のものに変更されたことを知らせるメッセージが表示されます。[OK]をクリックします。

参考

バージョンアップ前と同じグリッドの設定にする必要がありますので、2台目のConnectサーバのバージョンアップの終了後に「ConnectCLI SetGridParameters」を実行します。手順は後述します。

[＊＊＊Completed＊＊＊]と表示されたら、バージョンアップ完了です。[Exit]をクリックしてEricom Connect Configuration Toolを閉じます。

2台目以降¶

2台目以降も1台目と同じ手順でバージョンアップを行います。手順1～9までを実施してください。

手順10では「Ericom Connect Configuration Tool」が自動で起動したあと、[Join existing grid]をクリックします。

[Grid]を1台目のバージョンアップの時に設定されたグリッド名と一致させます。

[My Hostname or IP]には、このConnectサーバのIPアドレスを入力もしくは設定してください。

[Lookup Service Hosts]には、グリッド作成時に設定したConnectのIP(複数台の場合はカンマ区切り)を入力してください。

※ 9.x以降では、[My Hostname or IP]及び[Lookup Service Hosts]には、ホスト名ではなくIPアドレスを設定することが推奨されています。また、9.2以降では、IPアドレス以外を設定して進めた場合、警告が表示されます。

(9.x以降では、複数のConnectサーバを追加する場合には[Lokup Service Hosts]には下記[注意]の通りカンマで区切ってConnectサーバアドレスを記入してください。8.xでは、全てのConnectサーバを同一セグメント内に構築する限りにおいては、空欄でも問題ありません。）

注意

[Lookup Service Hosts]の内容は、同一Gridに参加しているマシン全てで、同一とする必要があります。

バージョンアップの途中で、Connectの管理者アカウントの入力を求められます。アカウント名とパスワードを入力して[OK]をクリックします。
[＊＊＊Completed＊＊＊]と表示されたら、バージョンアップ完了です。 [Exit]をクリックしてEricom Connect Configuration Toolを閉じます。

Gridの分散配置¶

上記手順まででは、グリッド内のデータがそれぞれのConnectに分散配置されていません。下記の手順によりデータを分散させるように設定します。

いずれかのConnectサーバにおいて管理者権限でコマンドプロンプトを起動し、下記コマンドにより現状を確認します。

C:\>cd "c:\Program Files\Ericom Software\Ericom Connect Configuration Tool"
c:\~Tool>connectcli gridinfo

Searching for 30 seconds ...
EricomConnectBusinessLogicPU Intact; Partitions=1; Backups=0; MaxInstancesPerMachine=0
EricomConnectMirrorService Intact; Partitions=1; Backups=0; MaxInstancesPerMachine=0

ECN01.test.local (192.168.0.1)  #GSC=2.  #LUS=1
  EricomConnectBusinessLogicCluster Partition #1. Primary [pid 3960]
    RedoLogSize: 0
  mirror-service Partition #1. Primary [pid 3872]
    Mirror: Successful 21; Failed=0

ECN02.test.local (192.168.0.2)  #GSC=2.  #LUS=1

続けて分散の為のコマンドを実行します。

c:\~Tool>connectcli setgridparameters 1 1 2 1

Connectの管理者アカウントとパスワードの入力を促されますので入力してEnterキーを押します。

Connect Admin User: Administrator
Connect Admin Password: **********
Searching for deployment ......

設定内容の確認が表示されます。確認の上「y」で実行します。

Searching for 30 seconds ...
Parameter settings are feasible

Sample deployment (DB = database sync component;  Partition.Replica
M1: 1.1 DB
M2: 1.2

All services must be restarted on all machines
Grid machines: 2
Number Partitions: 1
Number Backups: 1
Gsc per Machine: 2
Instances per Machine: 1
Continue [y/n]? y

設定が終了し、すべてのマシンのサービスの再起動を促すメッセージが表示されます。

グリッドに接続されている全てのサーバ、ワークステーション(VM)が対象です。

サーバの再起動によるサービス再起動を推奨します。

Changes saved.  All Processing unit services must be restarted on all machines.

c:\~Tool>

全てのConnectサーバの再起動が終了し、サービスが全て起動されGrid Statusが「Exists」になっていることを確認します。

再度管理者権限でコマンドプロンプトを起動し、下記コマンドにより現状を確認します。

C:\>cd "c:\Program Files\Ericom Software\Ericom Connect Configuration Tool"
c:\~Tool>connectcli gridinfo

Searching for 30 seconds ...
EricomConnectBusinessLogicPU Intact; Partitions=1; Backups=1; MaxInstancesPerMachine=1
EricomConnectMirrorService Intact; Partitions=1; Backups=0; MaxInstancesPerMachine=0

ECN01.test.local (192.168.0.1)  #GSC=2.  #LUS=1
  EricomConnectBusinessLogicCluster Partition #1. Primary [pid 4644]
    RedoLogSize: 0
  mirror-service Partition #1. Primary [pid 4564]
    Mirror: Successful 44; Failed=0

ECN02.test.local (192.168.0.2)  #GSC=2.  #LUS=1
  EricomConnectBusinessLogicCluster Partition #1. Backup 0 [pid 1788]
    RedoLogSize: 2

c:\~Tool>

※EricomConnectBusinessLogic がそれぞれのサーバに配置されていることを確認します。

これで複数台構成のConnectのバージョンアップが終了しました。

管理コンソールの「Ericom Connectについて」からConnectのバージョンを確認できます。

警告

グリッドに参加しているコンポーネントはバージョンを統一する必要があります。RemoteAgentがインストールされているリモートデスクトップ/ターミナルサーバ,VDI,IVEXダブルブラウザLinuxのRemoteAgent、及びSecureGateway、 AccessPad(ダブルブラウザ連携キット含む)もバージョンアップしてください。

6.1.4. その他のコンポーネントのバージョンアップ¶

RemoteAgentのバージョンアップ¶

お願い

事前バックアップをお願いします

バージョンアップ事前準備として、以下の実施をお奨め致します。

RemoteHostAgentインストール端末上の下記パスにある「EricomConnect」フォルダ
※フォルダのバックアップは、全Connectサーバのものを取得します。
C:¥ProgramData¥EricomConnect
このフォルダは隠しファイル属性になっていますので、表示する場合はエクスプローラで[表示]メニューで[隠しファイル]をチェックしてください。

RDSサーバへ管理者ユーザでデスクトップログオンします。

コントロールパネルの「プログラムと機能」の画面から、「Ericom Connect Remote Host」をアンインストールします。

新バージョンのRemoteHostAgentのインストーラを任意のパスにコピーし、インストーラを実行します。

ウィザード画面に従いNextで進め、インストールを実施します。

[Ericom Connect Remote Agent Configuration]が起動しますので、以下の補足事項に沿って表示されている画面に入力されている値に間違いがないことを確認の上、[Connect To Grid]をクリックしてください。

※途中Connectの管理者アカウントの入力画面が表示されますので、入力の上「OK」をクリックします。

参考

Grid Name…Name…Connectサーバの[Ericom Connect Configuration Tool]で確認できます。
My hostname or IP…このサーバの「IPアドレス」を入力してください (ホスト名ではなく、IPアドレス入力をお願い致します。)
Lookup Service Hosts…Ericom Connectで[Upgrade/Redeploy]もしくは [Join existing grid]した時に設定した値と一致するよう記入してください。
※ 9.x以降では、[My Hostname or IP]及び[Lookup Service Hosts]には、ホスト名ではなくIPアドレスを設定することが推奨されています。また、9.2以降では、IPアドレス以外を設定して進めた場合、警告が表示されます。

(9.x以降では、複数のConnectサーバが存在する場合、[Lokup Service Hosts]には下記[注意]の通りカンマで区切ってConnectサーバアドレスを記入してください。8.xでは、ConnectサーバとRemoteAgent Type1サーバを同一セグメント内に構築する限りにおいては、空欄でも問題ありません。）

エラーメッセージなく「*** Completed ***」と出ましたらグリッド参加成功です。

もしグリッドが見つからない等のエラーが出る場合は、下記手順を実施後、Ericom ConnectのWeb管理コンソールでサーバが登録されているかご確認ください。

グリッド参加に失敗する場合¶

下記にあるSettings.xmlのバックアップコピーを取得しておきます。

C:¥Program Files¥Ericom Software¥Ericom Connect Data Grid¥NET v4.0¥Config

Settings.xmlをエディタで開き、下記部分に適切な値を入力して保存します。

<XapNet.HostName>＜このサーバのIPアドレス＞</XapNet.HostName>
       <XapNet.Multicast.Enabled>＜TrueまたはFalse＞</XapNet.Multicast.Enabled>
       <XapNet.Groups>＜グリッド名＞</XapNet.Groups>
       <XapNet.Locators>＜上記がTrueの場合は空欄、Falseの場合は後述通り指定＞
</XapNet.Locators>
       <XapNet.Zones></XapNet.Zones>

参考

<XapNet.Multicast.Enabled>がFalseの場合の<XapNet.Locators>の設定例：）

以下のようにLookup Service Hostsの値を入れます。

<XapNet.Locators>172.16.1.1:4174,172.16.2.2:4174</XapNet.Locators>

Windowsサービス画面から、「Ericom Connect Remote Agent Service」サービスを再起動してください。
Web管理コンソール上で、[サービス]の画面で「Remote Agentサービス」一覧にこのRDSサーバの情報があり、ステータスが「実行中」となっていることを確認してください。

SecureGatewayのバージョンアップ¶

既存の SecureGateway サーバにて作業を行います。
SecureGateway が Connectサーバと別のサーバに導入されている場合の手順です。
Connectサーバと同居している場合はConnectサーババージョンアップ時に同時にバージョンアップされます。

お願い

事前バックアップをお願いします

バージョンアップ事前準備として、以下の実施をお奨め致します。

RemoteHostAgentインストール端末上の下記パスにある「EricomConnect」フォルダ
※フォルダのバックアップは、全Connectサーバのものを取得します。
C:¥ProgramData¥EricomConnect
このフォルダは隠しファイル属性になっていますので、表示する場合はエクスプローラで[表示]メニューで[隠しファイル]をチェックしてください。

SecureGatewayサーバへ管理者ユーザでデスクトップログオンします。

コントロールパネルの「プログラムと機能」の画面から、「Ericom Connect」をアンインストールします。

※ [Preserve existing ～]にチェックが入っていることを確認してください。

Ericom Connectのインストーラを任意のパスにコピーし、インストーラを実行します。

.Net 4.5.2以上が必要です。必要に応じてインストールしてください。

ウィザード画面に従いNextで進め、Setup Typeは「Custom」を選択します。

「Ericom Connect Secure Gateway」以外のチェックを外し、[Install]をクリックします。

[Ericom Connect Configuration Tool]が起動しますので、以下の補足事項に沿って表示されている画面に入力されている値に間違いがないことを確認の上、[Join existing grid]をクリックしてください。

※ 途中、Connectの管理者アカウントの入力画面が表示されますので、入力の上「OK」をクリックします。

参考

Grid Name…Name…Connectサーバの[Ericom Connect Configuration Tool]で確認できます。
My hostname or IP…このサーバの「IPアドレス」を入力してください (ホスト名ではなく、IPアドレス入力をお願い致します。)
Lookup Service Hosts…Ericom Connectで[Upgrade/Redeploy]もしくは [Join existing grid]した時に設定した値と一致するよう記入してください。
※ 9.x以降では、[My Hostname or IP]及び[Lookup Service Hosts]には、ホスト名ではなくIPアドレスを設定することが推奨されています。また、9.2以降では、IPアドレス以外を設定して進めた場合、警告が表示されます。

(9.x以降では、複数のConnectサーバが存在する場合、[Lokup Service Hosts]には下記[注意]の通りカンマで区切ってConnectサーバアドレスを記入してください。8.xでは、ConnectサーバとESGサーバを同一セグメント内に構築する限りにおいては、空欄でも問題ありません。）

エラーメッセージなく「*** Completed ***」と出ましたらグリッド参加成功です。

もしグリッドが見つからない等のエラーが出る場合は、下記手順を実施後、Ericom ConnectのWeb管理コンソールでサーバが登録されているかご確認ください。

グリッド参加に失敗する場合¶

下記にあるSettings.xmlのバックアップコピーを取得しておきます。

C:¥Program Files¥Ericom Software¥Ericom Connect Data Grid¥NET v4.0¥Config

Settings.xmlをエディタで開き、下記部分に適切な値を入力して保存します。

<XapNet.HostName>＜このサーバのIPアドレス＞</XapNet.HostName>
       <XapNet.Multicast.Enabled>＜TrueまたはFalse＞</XapNet.Multicast.Enabled>
       <XapNet.Groups>＜グリッド名＞</XapNet.Groups>
       <XapNet.Locators>＜上記がTrueの場合は空欄、Falseの場合は後述通り指定＞
</XapNet.Locators>
       <XapNet.Zones></XapNet.Zones>

参考

<XapNet.Multicast.Enabled>がFalseの場合の<XapNet.Locators>の設定例：）

以下のようにLookup Service Hostsの値を入れます。

<XapNet.Locators>172.16.1.1:4174,172.16.2.2:4174</XapNet.Locators>

Windowsサービス画面から、「Ericom Connect Secure Gateway」サービスを再起動してください。
Web管理コンソール上で、[サービス]の画面で「ESGサービス」一覧にこのRDSサーバの情報があり、ステータスが「実行中」となっていることを確認してください。

AccessPadのバージョンアップ¶

クライアント端末にて作業を行います。
上書きインストールが可能です。

AccessPadは以下の手順でバージョンアップしてください。

■クライアント端末上のAccessPadバージョンアップ

※ 上書きインストール可能です。

「EricomAccessPadClient.msi」または「EricomAccessPadClient64.msi」をインストール対象のクライアント端末へ配布してください。

※ クライアント端末が32bitOSの場合は前者を、64bitOSの場合は後者のmsiを配布してください。

各エンドユーザ様のクライアント端末上で、配布したmsiを実行してください。

インストーラが起動します。基本的にそのままNextで進めていただいて問題ありませんが、途中でAccessPadインストール先と下記のチェックを入れる箇所が表示されます。

- Use local Windows credentials to single sign-on(SSO) to Ericom AccessPad Client

→ こちらはAccessPadをSSOするかどうかのチェックとなります。現状、SSOしていなければチェック無しで進めてください。SSOしている場合は、チェックを入れて進めてください。

- Register the Ericom URI on this machine

→ こちらはURIから公開アプリを起動したい場合にチェックを入れる必要がありますが、特に利用していない場合はチェック無しで進めてください。

インストール先は任意で問題ございません。

正常にインストールが完了すれば、作業完了となります。

6.1. Connectサーバ バージョンアップガイド¶

6.1.1. 本資料について¶

6.1.2. 事前に準備するもの¶

6.1.3. Ericom Connect のバージョンアップ¶

単体構成の場合のバージョンアップ¶

冗長構成の場合のバージョンアップ¶

1台目¶

2台目以降¶

Gridの分散配置¶

6.1.4. その他のコンポーネントのバージョンアップ¶

RemoteAgentのバージョンアップ¶

グリッド参加に失敗する場合¶

SecureGatewayのバージョンアップ¶

グリッド参加に失敗する場合¶

AccessPadのバージョンアップ¶

6.1. Connectサーババージョンアップガイド¶