Flexera を使用した HCL Z and I Emulator for Transformation の構成

本書では、「HCL Z and I Emulator for Transformation」製品を使用するためのライセンスを取得し、ホストに接続できるように本製品を構成する手順について説明します。

以下の各ステップの詳しい説明に従ってください。
Note: 以下の詳細な手順の情報と参照は、ZIETrans バージョン 1.0 用です。同じ指示が、ZIETrans の他のバージョンにも適用されます。

ステップ 1: FlexNet Operations から製品およびライセンス・サーバー (CLLS) をダウンロードする

  1. 以下のリンクをコピーし、ブラウザーのアドレス・バーに貼り付けて FlexNet ログイン・ページにアクセスします: https://hclsoftware-fno.flexnetoperations.com/flexnet/operations/logon.do?logoff=true

    「Flexera ログイン」ダイアログ・ボックス

  2. 認定ログイン資格情報を入力し、プロデューサー・ポータルのホーム・ページにアクセスします。
  3. QuickSearch セクションに関連キーワードを指定して、必要な製品を検索します。以下のイメージは、「HCL Z and I Emulator for Transformation」を探すために検索フィールドに入力したキーワードを示しています。

    プロデューサー・ポータルのホーム (製品のクイック検索)

    FlexNet Operations のプロデューサー・ポータル・ホーム・ページ
  4. 検索を実行すると、入力されたキーワードに関連するすべての製品パッケージが、検索結果に表示されます。

    パッケージ製品 (検索結果)

  5. それに続く「商品の作成」パネルで、「パッケージのダウンロード」タブをクリックし、必要なパッケージを確認してダウンロードします。下のイメージは、「HCL_CLLS」をダウンロードするために選択したオプションを示しています。

    パッケージ製品 (パッケージのダウンロード)

  6. 「HCL_CLLS」をクリックして、「HCL Common Local License Sever 1.0」パッケージをユーザー定義の場所にダウンロードします。
  7. 「機能」タブをクリックし、HCL_ZIETrans をダウンロードして ZIETrans に関連するすべてのパッケージをダウンロードします。

ステップ 2: インストーラー (製品および License Manager 用) の展開

  1. ダウンロードしたパッケージを開きます。

    HCL Z and I Emulator for Transformation (ZIETrans) 製品の場合、ダウンロードしたパッケージは「HCL_ZIETrans」となります。パッケージを解凍して、Zietrans フォルダーを取得します。

  2. ZIETrans フォルダーから ZIETrans Product Installer を抽出します。

ステップ 3: License Manager 製品を使用するための構成

3.1 ライセンス・サーバー (Flexera) のセットアップ

  1. 選択した HCL_CLLS パッケージの中に、下のイメージに示す圧縮パッケージが存在します。Flexera ライセンス・サーバーに接続する OS の仕様に基づいて、該当するインストーラーをダウンロードします。

    HCL CLLS のインストーラー・パッケージ

    • Windows ユーザーの場合、HCL_CLLS_WIN_1 パッケージをダウンロードします。
    • Linux ユーザーの場合、HCL_CLLS_LNX_1 パッケージをダウンロードします。
    • Flexera ライセンス・サーバーへの接続に使用される flexnetlsadmin.bat ファイルが [Extracted CLLS package]\enterprise フォルダーにあります。
    • インストーラーを入手したら、下のリンクに示す手順を実行して、Flexera ライセンス・サーバーを構成します。https://support.hcltechsw.com/csm?id=kb_article&sysparm_article=KB0073344&sys_kb_id=c75b269c1b79dc54f37655352a4bcb47 注: ライセンス・サーバーのセットアップの間に、サーバー・デプロイメント・モードとしてローカルまたはクラウドを選択できます。

      サーバー・デプロイメント・モード

    • ライセンス・サーバーのデプロイメントが完了すると、カスタム Flexera URL が取得されます。
    • カスタム URL を使用して、この後の手順に示す以下のリンクを置き換えます。<https://[license server host]/api/1.0/instances/[license server ID]>
    • Flexera のセットアップに関してさらに質問がある場合は、以下のリンクを使用して HCL カスタマー・サポート・チームにご連絡ください:https://hclpnpsupport.hcltech.com/csm

3.2 ライセンス・サーバー (Flexera) による製品 (HCL ZIETrans) の構成

  1. キー・ペアの生成に関する以下の前提条件を満たしていることを確認してください。鍵ペアを生成するために、任意のオープン・ソースの鍵ツール (Open SSL、Java 鍵ツールなど) をコンピューターにインストールします。
  2. 以下のステップを実行して、ライセンス・サーバー (Flexera) で製品を構成します。
    1. 鍵ツールの構成
    2. 鍵ペアの生成
    3. Flexera ライセンス・サーバーへの公開鍵のアップロード
鍵ツールの構成 (Open SSL)
  1. Open SSL のインストール後、Open SSL のフォルダーを C:\ drive 配下にコピーします。
  2. 次に示すように、Open SSL パスをシステム環境変数で構成します。

    システム環境変数での Open SSL の構成

鍵ペアの生成 (Open SSL ツールを使用)

生成された公開鍵と秘密鍵のペアは、セキュア通信に使用されます。鍵ペアは「RSA 2048 ビット」形式である必要があります。秘密鍵の形式は「pksc8」、公開鍵の形式は「DER」形式である必要があります。

以下に、OpenSSL を使用した鍵ペアの生成手順を示します。

Note: 鍵ペアの生成に他のサード・パーティー製ツールを使用する場合、その製品で示されている手順に従う必要があります。
  1. 秘密鍵を生成します。管理者としてコマンド・プロンプトを開き、Open SSL のパスを入力して、ルート・ディレクトリーからパスを変更します (C:\OpenSSL\bin)。以下のコマンドを入力して、C:\OpenSSL\bin フォルダー内にプライベート・キーを生成します。
    openssl genrsa -out private_key.pem 2048
  2. 公開鍵を取得します。秘密鍵が生成された後、次のコマンドを入力すると、公開鍵が同じパスに生成されます。
    openssl rsa -in private_key.pem -pubout -outform DER -out public_key.der
  3. 秘密鍵を pkcs8 形式に変換して使用します。強力な暗号化のために、private_key.pem ファイルを pcks8 形式に変換します。この変換を実行するには、次のコマンドを入力します:
    openssl pkcs8 -topk8 -inform PEM -outform PEM -in private_key.pem -out private_key_pkcs8.pem -nocrypt

    C:\OpenSSL\bin に生成された鍵

Flexera ライセンス・サーバーに公開鍵をアップロードします。
  1. Flexera サーバーに接続するには、展開した CLLS パッケージをローカル・マシンで利用できるようにする必要があります。ローカル・マシンの Flexera フォルダーに移動します (D:\ [Extracted CLLS package]\enterprise)。
  2. コマンド・プロンプトを開き、次のコマンドを入力します:
    flexnetlsadmin.bat -server <https://[license server host]/api/1.0/instances/[license server ID]
    -authorize admin [license sever admin password] -uploadPublicKey [local path to public key (in DER format)]>
    
    例:
    flexnetlsadmin.bat -server https://hclsoftware.compliance.flexnetoperations.com/api/1.0/instances/FED321CBA
    -authorize admin adminpwd -uploadPublicKey C:\temp\public_key.der
  3. 上記のコマンドを使用して公開鍵を Flexera サーバーに正常にアップロードすると、Flexera サーバーから「クライアントの公開鍵が正常にアップロードされました」という確認メッセージを受信します (Flexera のセットアップに関して質問がある場合は、以下のリンクを使用して HCL カスタマー・サポート・チームにご連絡ください: https://hclpnpsupport.hcltech.com/csm)。
  4. 次の Flexera サーバーのコマンドを入力し、機能の説明と、その機能で構成されているライセンスの数を確認します。
    C:\Users\Admin\Desktop\Flexera\Others\[Extracted CLLS package]\enterprise\flexnetlsadmin.bat -server
    <https://[license server host]/api/1.0/instances/[license server ID] /-authorize <username> <password> -licenses -verbose>
    例:
    C:\Users\Admin\Desktop\Flexera\Others\[Extracted CLLS package]\enterprise\flexnetlsadmin.bat -server 
    https://hclsoftware.compliance.flexnetoperations.com/api/1.0/instances/FED321CBA -authorize admin adminpwd -licenses -verbose

    機能の説明と構成済みライセンス数を確認するための Flexera サーバー・コマンド

3.3 製品 (HCL ZIE For Transformation) を使用した License Manager の構成

前提条件:

  1. ユーザーは HCL ZIETrans をインストールし、Toolkit で ZIETrans プロジェクトを作成する必要があります。
  2. Toolkit で、WAS、WebSphere Liberty Profile、JBOSS などのサポートされているアプリケーション・サーバーを構成します。
手順
  1. プロジェクト .ear の runtime.properties ファイルで、「Flexera Server URL」、「Private key path」、および「BorrowInterval」時間を構成します。ユーザーがアプリケーションをデバッグ・モードで実行する場合は、runtime-debug.properties ファイルで同じ内容を構成する必要があります。

    runtime.property ファイルでの Flexera の構成

    flx_PrivateKey_Absolute_Path= Drive\: \\Path\\PrivateKey.pem

    例:

    flx_PrivateKey_Absolute_Path =D\:\\Flexera\\private_key_pkcs8.pem

    flx_ServerURL= https://[license server host]/api/1.0/instances/[license server ID] /api/1.0/instances/Feature ID

    例:

    https\://hclsoftware-uat.compliance.flexnetoperations.com/api/1.0/instances/X9C0S4LR1E0E flx_BorrowInterval=30m(default)

    このパラメーターに含まれる数値の末尾には単位文字が続きます。例えば、flx_BorrowInterval 値の 10h は 10 時間を示します。このパラメーターの単位文字で有効な値は、s、m、h、d、および w です (それぞれ、秒、分、時間、日、週を示します)。

    1. ユーザーがこのパラメーターの値を設定しない場合、デフォルト値は 30 分に設定されます。
    2. このパラメーターは、借用間隔に達すると自動的にライセンスを返すようにライセンス要求で設定されており、ZIETrans が異常終了した場合にライセンスの自動返却を保証するのに役立ちます。
  2. 構成済みのサーバーでプロジェクトを実行します。ユーザーはお好みのブラウザーを使用できます。
  3. Flexera コマンドを実行し、使用したライセンスを確認します。
  4. 上記の手順に従ってアプリケーションを開き、構成済みホストに接続します。