アップデート手順

HULFT10 API Gatewayのアップデートについて説明します。

アップデートは異なるバージョン、レベル、およびリビジョンの実行モジュールを操作することが必要です。

ここでは、以下のフォルダー表示で説明します。

 

既存のHULFT10 API Gatewayの導入フォルダー

$HULFT_API_GATEWAY_OLD_VERSION_PATH

新しいHULFT10 API Gatewayの導入フォルダー

$HULFT_API_GATEWAY_NEW_VERSION_PATH

既存のHULFT10 API Gatewayのサービスの停止と削除

Windowsのコマンドプロンプトを管理者として実行します。

以下のコマンドで、HULFT10 API Gatewayサービスを停止します。

$HULFT_API_GATEWAY_OLD_VERSION_PATH/hulft-api-gateway.exe --stop

 

以下のコマンドで、HULFT10 API Gatewayサービスを削除します。

$HULFT_API_GATEWAY_OLD_VERSION_PATH/hulft-api-gateway.exe --delete-service

新しいHULFT10 API Gatewayのモジュール一式を展開

任意のフォルダーに、新しいHULFT10 API Gatewayのセットアップモジュール(zipファイル)を展開します。

展開されたモジュール一式については、「モジュール構成」を参照してください。

設定ファイルの移行

HULFT10 API Gatewayの設定ファイルを、既存の導入フォルダーから新しい導入フォルダーに移行します。

既存の設定ファイル(hul_gtw_config.yml)で、新しい設定ファイルを上書きしてください。

設定ファイルのパスは以下のとおりです。

etc/hul_gtw_config.yml

注意

既存の設定ファイルでログ定義(log)ファイルパス(filepath)にファイルパスを指定していた場合は、その値を新しいHULFT10 API Gatewayでのログのファイルパスに変更してください。

HULFT10 API Gatewayのプロダクトキーを登録

Windowsのコマンドプロンプトを管理者として実行します。

以下のコマンドで、新しいシリアル番号、プロダクトキー、および期間限定キーを登録します。

$HULFT_API_GATEWAY_NEW_VERSION_PATH/hulft-api-gateway.exe
    --activate
    --serial-number SerialNumber
    --product-key ProductKey
    [--term-license-key TermLicenseKey]
    --root-password RootPassword

 

アクティベートに成功すると以下の製品情報が表示されます。

 

出力例

Hostname             [host01]
Product              [HULFT10 API Gateway]
Version Information  [V10L02R01]
License Type         [Product version (Fixed Term)]
Number of Hosts      [10]
Date of Installation [2025/05/03]
Valid since          [2025/05/03]
Expire on            [2028/05/02]
Successfully Activated.

HULFT10 API Gatewayのサービスを登録

Windowsのコマンドプロンプトを管理者として実行します。

以下のとおり、HULFT10 API Gateway Server実行ファイル(hulft-api-gateway.exe)のコマンドを使用して、HULFT10 API Gatewayのサービスを登録します。

$HULFT_API_GATEWAY_NEW_VERSION_PATH/hulft-api-gateway.exe --register-service [--service-name ServiceName]

 

HULFT10 API Gatewayのサービス名は以下のとおり登録されます。

  • ServiceNameの指定を省略した場合

    HULFT API Gateway

  • ServiceNameを指定した場合

    HULFT API Gateway(ServiceName)

HULFT10 API Gatewayのサービスを起動

Windowsのコマンドプロンプトを管理者として実行します。

以下のとおり、HULFT10 API Gateway Server実行ファイル(hulft-api-gateway.exe)のコマンドを使用して、HULFT10 API Gatewayのサービスを起動します。

$HULFT_API_GATEWAY_NEW_VERSION_PATH/hulft-api-gateway.exe --start

既存のHULFT10 API Gatewayフォルダーを削除

アップデート完了後は、既存のHULFT10 API Gatewayが導入されていたフォルダーを削除します。

注意

既存のHULFT10 API Gatewayが導入されていたフォルダー内にログファイルを格納していた場合、ログファイルも削除されます。

フォルダーを削除する前に、必要に応じてログファイルを退避してください。