これは InterSystems FAQ サイトの記事です。

この記事では、ミラーリングの構成方法をご紹介します。

本記事では、「自動ダウンロード」の機能についても、あわせてご紹介します。

では、ミラーの構成手順をご紹介します。
今回ご紹介するのは、同期ミラーによるフェールオーバー（常にデータベースが同期されて複製、障害時に自動でフェールオーバー）構成です。
手順は以下になります。

1) それぞれのサーバで、ISCAgent の構成・起動

2) それぞれのサーバで、ミラーのサービスを有効化

3) 最初のフェイルオーバーメンバー（プライマリ）を構成・ミラーへデータベースの追加

4) 2番目のフェイルオーバーメンバー（バックアップ）を構成・ミラーメンバーからの自動データベースダウンロード

今回は、各設定を管理ポータルを使用して行う方法をご紹介します。

【今回のサンプル・ミラー構成について】

1) それぞれのサーバで、ISCAgent の構成・起動

それぞれのサーバでISCAgent を構成・起動します。
構成・起動方法は、OSごとに異なりますのでドキュメントをご覧ください。

　※アービターを使用する場合、フェールオーバー構成と別のマシン(10.0.0.155)でISCAgent を開始します。
　　ISCAgentのみインストールすることも可能です。
　　ダウンロードは、WRCDirectから行えます。　例：ISCAgent-2025.1.2.374.0-win_x64.exe

　※Windowsの場合は、Windows(管理)ツール > サービスで 名前=ISCAgent のサービスを開始、また自動開始を構成します（インストール後の既定は「手動」設定のため、OS再起動後は停止状態となります）。
　　  
 

2) それぞれのサーバで、ミラーのサービスを有効化

管理ポータル：
[システム管理] > [構成] > [ミラー設定] > [ミラーサービス有効]

3) 最初のフェイルオーバーメンバー（プライマリ：）を構成・ミラーへデータベースの追加

3-1.
最初にフェイルオーバメンバを登録するマシン（プライマリ：MACHINEA）で、TEST という名前の新しいネームスペースを作成し、参照するデータベースとしてTEST データベースをデフォルト設定の状態で作成します。

※こちらの手順では、「相互運用プロダクション用にネームスペースを有効化」はオフ（チェックなし）で作成します
 

3-2.
ミラーの作成画面で、以下の設定を行います。

管理ポータル：
　[システム管理] > [構成] > [ミラー設定] > [ミラーの作成]

3-3.
TESTMIRROR へ TEST データベースを追加します。ミラーデータベース名には、TEST を使用します。

管理ポータル：
　[システム管理] > [構成] > [システム構成] > [ローカルデータベース]
　TEST の編集 → ミラーTESTMIRRORに追加 をクリック
  ※最初から作る場合は、データベースの作成時に「ミラーデータベース？はい」をチェック

3-4.
TESTMIRROR へ追加された TEST を確認します。

管理ポータル：
　[システムオペレーション] > [ミラーモニタ]  

4) 2番目のフェイルオーバーメンバー（バックアップ：MACHINEB）を構成・ミラーメンバからの自動データベースダウンロードを行います。

4-1.
2 番目にフェイルオーバメンバとするマシンで（MACHINEB）、フェイルオーバメンバとして、ミラーに追加するため以下画面を開きます。

管理ポータル：
　[システム管理] > [構成] > [ミラー設定] > [フェイルオーバとして参加]

　以下の情報を登録し、接続ボタンを押下する。

「次へ」クリック

4-2.
ミラーモニターでフェイルオーバーメンバーのステータスを確認する

最初に設定したフェールオーバー メンバーで、[ミラー モニター] ページ ( [システム操作] > [ミラー モニター]) を表示
ミラー フェールオーバー メンバー情報領域には、2 つのフェールオーバー メンバーのミラー メンバ名とネットワーク アドレスが一覧表示されます。

4-3.
MACHINEBのミラーへのデータベースの追加のため、ミラーメンバ（MACHINEA）から自動データベースダウンロードを行います。

ダウンロードを開始するには、新しいメンバーまたは復元対象のメンバーにデータベースを作成し、2 番目のダイアログで、「ミラー データベース?」に対して「はい」を選択し、ミラー内のデータベースの名前を正確に入力します。

管理ポータル：
　[システム管理] > [構成] > [システム構成] > [ローカルデータベース]
より、データベースの新規作成を行い、以下のように設定します。

ミラーデータベース？はい
ミラー・データベース名：TEST

※この機能は、新規作成ミラーデータベースに対しては非常に便利ですが、元のデータベースのサイズが大きい場合は非常に時間がかかるため、注意が必要です。サイズの大きいデータベースの場合は従来の方法（バックアップ＆リストア、もしくはiris.datのコピー）をお勧めします。

※外部／オンラインバックアップ・リストアについては、以下の記事で詳細手順を説明していますので、参考になさってください。
・外部バックアップとリストアについて
・オンラインバックアップとリストアについて

※バックアップからのリストアの場合、
　Limit restore to mirrored databases? →Yes　でリストアします（リストア後、ミラーが有効化＆キャッチアップされます）

　この場合、データベース定義も別途必要になります。
　データベース定義がない場合、ミラーモニタにて「見つからないミラー・データベース・レポート」にリストされます。
　データベースを作成していない場合、新規データベース作成することで、「ミラーされたデータベース」に追加されます。
 

4-4.
ミラーモニタで確認します。

こちらで、フェイルオーバーミラー構成は完了です。

詳細は以下のドキュメントをご覧ください。
ミラーの作成

これは InterSystems FAQ サイトの記事です。
 

WebSocketは、リアルタイム双方向通信を可能にするプロトコルで、Webアプリケーションの動的な操作性を向上させるために広く活用されています。

この技術は、TCP上で動作し、HTTPプロトコルを介して接続を確立します。

一度接続が確立されると、持続的な接続が維持され、サーバーとクライアントが効率的にデータを交換できるのが特徴です。

通常のHTTP通信の場合、クライアントからのリクエストに対してサーバーが応答するというのが基本的な動作になるため、サーバーから非同期にデータを送信することが難しいですが、WebSocketを利用することでそのような機能を簡単に実現できます。

一方で、サーバーからの一方向の非同期通信が実現できれば良いという要件であれば、SSE (Server-Sent Events)を使用することもできます。

一般的にWebSocket通信が最も適していると考えられるのは、クライアント・サーバー間で双方向にデータを交換する必要がある場合になります。

双方向の接続を維持する必要があるため、状況によって、サーバー上のコンピュータ資源の消費（メモリー、CPU、IRISライセンス使用量など）に注意する必要があります。

ネット上にもWebSocketに関する様々な情報（メリット・デメリットを含む）がありますので、インターネット上での検索や生成AIに確認してみてください。

ここではIRISでWebSocketを利用する方法について、説明します。

IRISでWebSocketを実現するためには、%CSP.WebSocketクラスを継承したクラスを作成し、必要なインタフェース（メソッド）を実装する必要があります。

以下のように、OnPreServerとServerインスタンスメソッドを実装します。

OnPreServerメソッドは、WebSocketの接続の際に最初に呼ばれるメソッドで、接続の前に実行する必要のあるコードを記述します。

SharedConnectionプロパティの設定を、このメソッドで実行することが一般的です。

Serverメソッドはクライアントからのリクエストに応答するための処理を記述します。

その処理概要は、以下のような流れです。

• クライアントからのリクエストに応答するためにReadメソッドをこのメソッドの中で呼び出します。
• クライアントからの応答があると、このReadメソッドはその応答内容を取得します。
• その応答の内容に基づき、適切な処理を実行し、その結果をWriteメソッドで返します。
• この一連の処理(ReadメソッドとWriteメソッド)を繰り返します。
• 繰り返し処理を終了する条件は、クライアントからの終了を指示するメッセージを取得した場合や以下のコード例のようにReadメソッドにて指定したタイムアウト値を超えて、クライアントからの応答を得られなかった場合などを設定できます。
• そして最後にEndServerメソッドを呼び出してWebSocketの接続を切断します。

Class User.WebSocket Extends %CSP.WebSocket
{

Method OnPreServer() As %Status
{

    set ..SharedConnection = +$get(^websocket("smode"))

    quit $$$OK
}

Method Server() As %Status [ ProcedureBlock = 0 ]
{
    try {
      set cnt=$I(^websocket)

      set ^websocket(cnt,"wid") = ..WebSocketID
      set ^websocket(cnt,"sid") = ..SessionId
      set ^websocket(cnt,1)="start: job # = "_$job_" datetime = "_$ZDT($H)

      set sc=$$$OK
      set scount = 0
      for {

        // クライアントからのメッセージを読み取る
        set data = ..Read(0,.sc,200) // Disconnect if no communication for 200 sec
        if $$$ISERR(sc) {
          // read timeout or the client requets close()	
          set ^websocket("error",$zh) = $system.Status.GetErrorText(sc)
          quit
        }
 
        set ^websocket(cnt,$increment(scount))=data

        ;; メッセージをクライアントに送信
        do ..Write("XYZ")

        //quit  // Disconnect
      }

      do ..EndServer()

      set ^websocket(cnt,2)="close: "_$ZDT($H)

  }
  catch e {
    set status = e.AsStatus()
    set ^websocket("error",$zh) = $system.Status.GetErrorText(status)
  }
  quit $$$OK
}

クライアント側のコードのサンプルは以下のようになります。

<html>
<head>
<title>WebSocket test</title>
<script language="JavaScript">

var ws=null;

function createSocket() {

  ws=new WebSocket('ws://localhost:8080/csp/user/User.WebSocket.cls');

  ws.binaryType='blob';

  ws.onopen=function(event)   { alert('socket created!');      };

  ws.onmessage = function(event) { alert('receive data ' + event.data); };

  ws.onerror = function(event)  { alert('connection error');      };

  ws.onclose = function(event)  { ws=null; alert('closed');      };

}

function sendMsg() {

 var json=JSON.stringify( {message:123} );

 try{

   var blob = new Blob([json], {type : 'application/json'});

   ws.send(blob);

 }

 catch (e) {

   alert('send error\n' + e);

 }

}

</script>
</head>
<body>
<form>
<input type="button" name="xxx" value="create socket" onClick="createSocket();"><hr>
<input type="button" name="btn" value="hello" onClick="sendMsg();"><hr>
<input type="button" name="close" value="close socket" onClick="ws.close();">
</form>
</body>
</html>

SharedConnectionプロパティの値の設定により、接続の形態を制御できます。

この値がゼロ（デフォルト値）の場合、接続は、同期モードとなり、サーバーとクライアントは一対一のプライベートな関係になります。

この値を１に設定すると、接続は、非同期モードとなり、サーバーから複数クライアントに対して、同報メッセージ送信のような機能を実現することができます。

以下に同報通信を実行するコードサンプルを示します。

ClassMethod SendDataAsync() As %Status
{
    try {

      set count = $get(^websocket)
      for i = 1:1:count {
        set websocket = ##class(%CSP.WebSocket).%New()
        set websocketid = $get(^websocket(i,"wid"))
        set status = websocket.OpenServer(websocketid)
		$$$ThrowOnError(status)
        set status = websocket.Write("How are you?")
		$$$ThrowOnError(status)
      }
    }
    catch e {
      set status = e.AsStatus()
      set ^websocket("error",$zh) = $system.Status.GetErrorText(status)
    }
	quit $$$OK
}

ここで示したサンプルは、以下からも取得できます。

WebSocketのサンプル

IRISのWebSocketに関連する機能の詳細は、以下のドキュメントを確認してください。

WebSocketの使用

IISをWebサーバーとして利用する際には、IISにWebSocket機能のインストール作業が必要です。

その作業については、インターネット上で検索するか、生成AIにご確認ください。