# アップデート手順

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が導入されていたフォルダー内にログファイルを格納していた場合、ログファイルも削除されます。

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