実稼働ライセンスのインストール

このトピックの次のセクションでは、実稼働ライセンス (永久ライセンスまたはサブスクリプション) を購入して使用する方法について説明します。

ステップ 1: RLM サーバーをインストールする

永久ライセンスまたはサブスクリプションを購入すると、ライセンスの条件を定義するライセンスファイルが取得されます。ライセンスファイルは、Reprise License Manager (RLM) サーバーにインストールする必要があります。

RLM の詳細については、Reprise Software ウェブサイトを参照してください。

トピック

• Windows に RLM サーバーをインストールする

• Linux に RLM サーバーをインストールする

Windows に RLM サーバーをインストールする

Windows に RLM サーバーをインストールするには

1. RLM License Administration Bundle を Reprise Software ウェブサイトからダウンロードします。

   注記

   Amazon DCV バージョン 2022.1 以降では、RLM サーバー 14 以上が必要です。以前のバージョンでは RLM 12 以上が必要です。

   RLM License Administration Bundle の最新の安定版をインストールすることをお勧めします。

2. RLM License Administration Bundle を C:\RLM にインストールします。

Linux に RLM サーバーをインストールする

Linux に RLM サーバーをインストールするには

1. RLM License Administration Bundle を Reprise Software ウェブサイトからダウンロードします。

   注記

   Amazon DCV バージョン 2022.1 以降では、RLM サーバー 14 以上が必要です。以前のバージョンでは RLM 12 以上が必要です。

   RLM License Administration Bundle の最新の安定版をインストールすることをお勧めします。

2. ユーザーグループと rlm ユーザーを作成します。これは、任意の有効なユーザーまたはサービスアカウントです。この値にはルートアカウントを使用しないことを強くお勧めします。

   $ groupadd -r rlm

   $ useradd -r -g rlm -d "/opt/nice/rlm" -s /sbin/nologin -c "RLM License Server" rlm

3. RLM サーバーに必要な /opt/nice/rlm/license ディレクトリ /opt/nice/rlm とディレクトリを作成します。

   $ mkdir -p /opt/nice/rlm/license

4. RLM License Administration Bundle の内容を /opt/nice/rlm/ に展開し、ファイルが rlm ユーザーに所有されていることを確認します。

   $ tar xvf x64_l1.admin.tar.gz -C /opt/nice/rlm/ --strip-components 1

   $ chown -R rlm:rlm /opt/nice/rlm

ステップ 2: RLM サーバーのホスト ID を取得する

RLM サーバーをインストールしたら、RLM サーバーのホスト ID を取得する必要があります。永久ライセンスまたはサブスクリプションを購入するときは、このホスト ID を指定する必要があります。

Windows で RLM サーバーホスト ID を取得する

サーバーのホスト ID を取得するには、コマンドプロンプトを開き、

C:\RLM\ に移動して、以下のコマンドを実行します。

C:\> rlmutil.exe rlmhostid ether

このコマンドから、RLM サーバーのホスト ID が次のように返されます。

Hostid of this machine: 06814example

ホスト ID を書き留めます。これは次のステップで必要になります。

Linux で RLM サーバーホスト ID を取得する

サーバーのホスト ID を取得するには (単一の戻り値)

1. /opt/nice/rlm/ に移動します。

2. 次のコマンドを実行してください。

   $ ./rlmutil rlmhostid ether

   このコマンドは、各ネットワークインターフェイスの RLM サーバーのホスト ID を次のように返します。

3. ホスト ID を記録します。これは次のステップで必要になります。

このプロシージャが実行され、次の単一の ID が返されました。

Hostid of this machine: 0a1b2c3d4e5f

この ID は記録され、DCV のライセンスの購入に使用されます。

サーバーのホスト ID を取得するには (複数の戻り値)。

1. /opt/nice/rlm/ に移動します。

2. 次のコマンドを実行してください。

   $ ./rlmutil rlmhostid ether

   複数の ID が ID のリストとして返されます。

3. 以下のコマンドを実行してください。

   iface=$(route -n | grep " UG " | tr -s " " | cut -d" " -f8)
   ip link show $iface | grep link/ether | tr -s " " | cut -d" " -f3 | tr -d ":"

   このコマンドはゲートウェイネットワークインターフェイスの RLM サーバーのホスト ID を返します。

4. ホスト ID を記録します。これは次のステップで必要になります。

プロシージャが実行され、複数の ID のリストとして複数の ID が返されました。

Hostid of this machine: 0a1b2c3d4e5f 1b2c3d4e5f6a 2c3d4e5f6a7b 3d4e5f6a7b8c

インターフェイスコマンドが実行され、次の ID が返されます。

Hostid of this machine: 0a1b2c3d4e5f

この ID は記録され、DCV のライセンスの購入に使用されます。

ステップ 3: 永久ライセンスまたはサブスクリプションを購入する

Amazon DCV の永久ライセンスやサブスクリプションの購入方法については、Amazon DCV のウェブサイトの「How to Buy」を参照してください。お住まいの地域の Amazon DCV 販売代理店または再販業者が掲載されています。

RLM サーバーのホスト ID を指定する必要があります。ホスト ID は、Amazon DCV が提供するライセンスファイルに埋め込まれます。

ステップ 4: ライセンスファイルに変更を加える

Amazon DCV の永久ライセンスまたはサブスクリプションを購入すると、ライセンスを定義する license.lic ファイルが届きます。license.lic ファイルには、次の情報が含まれます。

• RLM サーバーのホスト名。

• ライセンスを購入したときに指定した RLM サーバーのホスト ID。

• RLM サーバーの TCP ポート番号。デフォルトは 5053 です。

• ISV ポート番号。これは、RLM サーバーが Amazon DCV ライセンスリクエストをリッスンするオプションポートです。指定しない場合は、起動時に RLM によってランダムにポートが選択されます。

• ライセンスによってカバーされる Amazon DCV 製品、および各製品の以下の詳細:

  • ライセンスの対象であるメジャーバージョン (例: 2017 年の Amazon DCV 製品の場合は 2017)。

  • 有効期限。Permanent はライセンスの有効期限が切れていないことを示します。

  • 同時セッションの最大数 (例: サーバー上の同時セッションが 10 の場合は 10)。

  • ライセンスチェックサム。

  • ライセンス署名。

次のコードブロックは license.lic ファイルの形式を示しています。

HOST RLM_server_hostname RLM_server_host_id RLM_server_port
ISV nice port=port_number
LICENSE product_1 major_version expiration_date concurrent_sessions share=hi _ck=checksum sig="signature"
LICENSE product_2 major_version expiration_date concurrent_sessions share=hi _ck=checksum sig="signature"

次のコードブロックは、ISVポートを省略した license.lic ファイルの例を示しています。ライセンスファイルには、DCV と dcv-gl の 2 つの Amazon DCV 製品のライセンスが含まれています。

HOST My-RLM-server abcdef123456 5053
ISV nice
LICENSE nice dcv 2017 permanent 10 share=hi _ck=456789098a sig="abcdefghijklmnopqrstuvwxyz1234567890abcdefghijklmnopqrstuvwxyz1234567890ab"
LICENSE nice dcv-gl 2017 permanent 10 share=hi _ck=123454323x sig="1234567890abcdefghijklmnopqrstuvwxyz1234567890abcdefghijklmnopqrstuvwxyz12"

license.lic ファイルを編集するには

1. 任意のテキストエディタでファイル を開きます。

2. HOST で始まる RLM サーバーのホスト名とTCPポート番号をファイルの最初の行に追加します。

   警告

   RLM_server_host_id は、ライセンスを購入したときに指定したホスト ID です。RLM_server_host_id は編集できません。

3. (オプション) port=port_number を追加して、ファイルの行に ISV で始まる ISV ポート番号を追加します。このポートは DCV サーバーとの通信を可能にするために必要です。

   ISV ポートを指定しない場合は、port=port_number を省略します。ISV ポートを指定しない場合は、起動のたびに RLM によってランダムなポートが使用されます。

   警告

   ランダムに選択されたポートを使用できないようにファイアウォールを設定している場合は、HOST 行で指定されている RLM ポートに加えてこのポートを指定し、それを有効にするようにファイアウォールを設定する必要があります。

4. ファイルを保存して閉じます。

警告

ライセンスの他の部分を編集すると、ファイルの署名が破損し、ライセンスは無効になります。

ステップ 5: RLM サーバーを設定する

ライセンスファイルを変更したら、そのファイルを RLM サーバーに配置し、RLM サービスを開始する必要があります。

トピック

• Windows で RLM サーバーを設定する

• Linux で RLM サーバーを設定する

Windows で RLM サーバーを設定する

Windows で RLM サーバーを設定するには

1. RLM サーバーに接続します。

2. 編集した license.lic ファイルを C:\RLM\license\ にコピーします。

3. Amazon DCV サーバーから C:\Program Files\NICE\DCV\Server\license\nice.set ファイルをコピーし、RLM サーバーの C:\RLM\ フォルダに入れます。

4. RLM サーバーを、Windows サービスとしてインストールします。

   C:\> rlm.exe -nows -dlog C:\RLM\rlm.log -c C:\RLM\license -install_service -service_name dcv-rlm

   RLM 起動オプションの詳細については、「Reprise Software License Manager (RLM)」の製品ページを参照してください。

5. RLM サーバーを起動します。

   C:\> net start dcv-rlm

6. RLM サーバーが実行されていることを確認します。

   1. 任意のテキストエディタで C:\RLM\nice.dlog を開き、次の行が表示されることを確認します。

      date_time (nice) Server started on license1 (hostid: host_id) for: dcv dcv-gl

      注記

      RLM サーバーのバージョンによって rlm.log ファイルの内容が多少異なる場合があります。

   2. 以下のコマンドを実行してください。

      C:\RLM\rlmutil rlmstat -a -c rlm_server_hostname@5053

      このコマンドから RLM サーバーに関する情報が返されます。

Linux で RLM サーバーを設定する

Linux で RLM サーバーを設定するには

1. 編集した license.lic ファイルを /opt/nice/rlm/license/ にコピーします。

2. Amazon DCV サーバーから /usr/share/dcv/license/nice.set ファイルをコピーし、RLM サーバーの /opt/nice/rlm に入れます。

3. RLM サーバーサービスを作成し、起動時に自動的に起動するようにします。

   1. dcv-rlm という名前のファイルを /opt/nice/rlm/ フォルダに作成します。

      $ touch /opt/nice/rlm/dcv-rlm

   2. 任意のテキストエディタを使用してこのファイルを開き、以下のスクリプトを追加します。ファイルを保存して閉じます。

      #! /bin/sh
      # chkconfig: 35 99 01
      # description: The Reprise License Manager daemon.
      # processname: dcv-rlm
      
      ### BEGIN INIT INFO
      # Provides: dcv-rlm
      # Required-Start: $local_fs $remote_fs $syslog
      # Required-Stop: $local_fs $remote_fs $syslog
      # Default-Start: 3 4 5
      # Default-Stop: 0 1 2 6
      # Short-Description: The Reprise License Manager daemon.
      # Description: A service that runs the Reprise License Manager daemon.
      ### END INIT INFO
      
      # user used to run the daemon
      RLM_USER="rlm"
      
      # root of rlm installation
      RLM_ROOT="/opt/nice/rlm"
      
      # license directory (license files should have .lic extension)
      RLM_LICENSE_DIR="/opt/nice/rlm/license"
      
      # log file
      RLM_LOG_FILE="/var/log/rlm.log"
      
      _getpid() {
          pidof -o $$ -o $PPID -o %PPID -x "$1"
      }
      
      start() {
          echo -n "Starting rlm: "
          touch ${RLM_LOG_FILE}
          chown "${RLM_USER}" ${RLM_LOG_FILE}
          su -p -s /bin/sh "${RLM_USER}" -c "${RLM_ROOT}/rlm -c ${RLM_LICENSE_DIR} \
              -nows -dlog +${RLM_LOG_FILE} &"
          if [ $? -ne 0 ]; then
              echo "FAILED"
              return 1
          fi
          echo "OK"
      }
      
      stop() {
          echo -n "Stopping rlm: "
          pid=`_getpid ${RLM_ROOT}/rlm`
          if [ -n "$pid" ]; then
              kill $pid >/dev/null 2>&1
              sleep 3
              if [ -d "/proc/$pid" ] ; then
                  echo "FAILED"
                  return 1
              fi
          fi
          echo "OK"
      }
      
      status() {
          pid=`_getpid ${RLM_ROOT}/rlm`
          if [ -z "$pid" ]; then
              echo "rlm is stopped"
              return 3
          fi
          echo "rlm (pid $pid) is running..."
          return 0
      }
      
      restart() {
          stop
          start
      }
      
      case "$1" in
          start)
              start
              ;;
          stop)
              stop
              ;;
          status)
              status
              ;;
          restart)
              restart
              ;;
          *)
              echo $"Usage: $0 {start|stop|status|restart}"
              exit 1
      esac
      
      exit $?
      
      # ex:ts=4:et:

   3. スクリプトを実行可能にして /etc/init.d/ にコピーし、それを chkconfig ユーティリティに追加します。

      chmod +x /opt/nice/rlm/dcv-rlm 

      cp -a /opt/nice/rlm/dcv-rlm /etc/init.d/

      chkconfig --add dcv-rlm

4. RLM サーバーを起動します。

   $ service dcv-rlm start

5. RLM サーバーが実行中で、予期したとおりに機能していることを確認します。任意のテキストエディタで var/log/rlm.log を開き、次の行が表示されることを確認します。

   date_time (nice) Server started on license1 (hostid: host_id) for: dcv dcv-gl

   注記

   RLM サーバーのバージョンによって rlm.log ファイルの内容が多少異なる場合があります。

ステップ 6: Amazon DCV サーバーを設定する

RLM サーバーを使用するように Amazon DCV サーバーを設定します。この設定のために、Amazon DCV サーバーで license-file 設定パラメータを設定する必要があります。

license-file パラメータは、接続する RLM サーバーを指定して RLM_server_port@RLM_server の形式で設定する必要があります。RLM サーバーは、ホスト名または IP アドレスで指定できます。明示的に設定しない場合、RLM サーバーポートはデフォルトで 5053 です。

複数の RLM サーバーを使用している場合は、Linux の場合は :、Windows の場合は ; で区切って、複数の RLM サーバーのリストを指定できます。その後サーバーは、対応する RLM サーバーと 1 つの接続が確立されるまで、各サーバーに対して順番に接続を試みます。これは、プライマリ RLM サーバーに到達できない場合に引き継ぐために RLM フェイルオーバーサーバーを使用している場合などに特に便利です。この場合、ライセンスを次の形式で指定できます: RLM_primary_server_port@RLM_primary_server:RLM_failover_server_port@RLM_failover_server

注記

Amazon DCV サーバーが Windows にインストールされている場合は、指定のエントリを ; で区切る必要があります。

トピック

• Windows Amazon DCV サーバーの設定

• Linux Amazon DCV サーバーの設定

Windows Amazon DCV サーバーの設定

Windows サーバーの license-file 設定パラメータを設定するには

1. Windows レジストリエディタを開きます。

2. HKEY_USERS\S-1-5-18\Software\GSettings\com\nicesoftware\dcv\license\ キーに移動し、ライセンスファイルパラメータを選択します。

   レジストリキーに license-file パラメータが存在しない場合には作成する必要があります。

   1. 左のパネルで、[ライセンス] キーのコンテキスト (右クリック) メニューを開き、[新規]、[文字列値] の順に選択します。

   2. [名前] に license-file と入力し、[Enter] を押します。

3. [license-file] パラメータを開きます。[値のデータ] に、RLM サーバーのポート番号とホスト名を RLM_server_port@RLM_server の形式で入力します。複数の RLM サーバーへの接続を設定する必要がある場合は、上記の注意事項を確認してください。

4. [OK] を選択して Windows レジストリエディタを閉じます。

Linux Amazon DCV サーバーの設定

Linux サーバーの license-file 設定パラメータを設定するには

1. /etc/dcv/ に移動し、任意のテキストエディタで dcv.conf を開きます。

2. license-file パラメータを [license] セクションで見つけます。次に、既存のパスを RLM_server_port@RLM_server 形式で RLM サーバーのポートとホスト名に置き換えます。

   license-file セクションに [license] パラメータが存在しない場合は、次の形式を使用して手動で追加します。

   license-file = "RLM_server_port@RLM_server"

   複数の RLM サーバーへの接続を設定する必要がある場合は、上記の注意事項を確認してください。

3. ファイルを保存して閉じます。