アップデート手順
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が導入されていたフォルダー内にログファイルを格納していた場合、ログファイルも削除されます。
フォルダーを削除する前に、必要に応じてログファイルを退避してください。