導入手順

以下の手順でHULFT10 API Gatewayを導入し、HULFT10 API Gatewayの管理画面を起動します。

PostgreSQLの導入

PostgreSQLの導入手順を説明します。

すでに導入しているPostgreSQLを使用する場合は、手順3から開始してください。

1. postgresql.orgのサイトからバージョン16以降のPostgreSQLをダウンロードします。

2. ダウンロードしたPostgreSQLを任意のディレクトリーに導入します。

3. 導入したPostgreSQL に任意の名称でデータベースを作成します。

 

例

CREATE DATABASE hulgtw;

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

任意のディレクトリーにhulft-api-gateway-V10LLRR.zipを展開します。

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

ファイル実行権限の設定

ファイルに実行権限を与えるため、以下のコマンドを実行してください。

sudo chmod +x hulft-api-gateway-linux

 

また、SELinux（Security-Enhanced Linux）の設定が「Enforcing」である場合、以下の対応が必要になります。

以下のコマンドで、SELinuxの設定を確認してください。

getenforce

 

getenforceコマンドの出力が「Enforcing」である場合、以下の2つのコマンドを実行してください。

sudo chcon -t lib_t lib/libMonoCrypt.so
sudo chcon -t bin_t hulft-api-gateway-linux

PostgreSQLの接続情報を登録

PostgreSQLへの接続情報および「PostgreSQLの導入」で作成したデータベース名を、設定ファイル（hul_gtw_config.yml）に登録します。

設定ファイルの内容については、「設定ファイル」を参照してください。

 

入力例

database:
    host: localhost
    port: 5432
    dbname: hulgtw
    username: postgres
    password: password

HULFT10 API Gatewayのサーバー起動情報を登録

HULFT10 API Gateway サーバーのポート番号を、設定ファイル（hul_gtw_config.yml）に登録します。

設定ファイルの内容については、「設定ファイル」を参照してください。

 

HTTPリッスン時の入力例

server:
    port: 8080
    shutdown-timeout: 30

 

HTTPSリッスン時の入力例

server:
    port: 8080
    shutdown-timeout: 30
    tls-port: 18080
    tls-secret-key: /usr/local/HULFT/tls.key
    tls-crt: /usr/local/HULFT/tls.crt

HULFT10 API Gatewayのアクティベート

HULFT10 API Gateway Server実行ファイル（hulft-api-gateway-linux）のコマンドを使用して、HULFT10 API Gatewayをアクティベートします。

アクティベートには、以下の指定が必要です。

• シリアル番号

• プロダクトキー

• 期間限定キー

  製品版（期間限定ライセンス）の場合のみ必要

• 初期パスワード

 

sudo ./hulft-api-gateway-linux
    --activate
    --serial-number SerialNumber
    --product-key ProductKey
    [--term-license-key TermLicenseKey]
    --root-password InitialRootPassword

 

アクティベートが成功すると、以下の例のように製品情報が出力されます。

 

出力例

Hostname             [host01]
Product              [HULFT10 API Gateway]
Version Information  [V10L02R00]
License Type         [Product version (Fixed Term)]
Number of Hosts      [10]
Date of Installation [2024/08/19]
Valid since          [2024/08/17]
Expire on            [2027/05/13]
Successfully Activated.

HULFT10 API Gatewayのサービスを登録

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

sudo ./hulft-api-gateway-linux --register-service [--service-name ServiceName]

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

ServiceNameの指定を省略した場合

: HULFT API Gateway

ServiceNameの指定をした場合

: HULFT API Gateway_ServiceName

HULFT10 API Gatewayのサービスを起動

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

sudo ./hulft-api-gateway-linux --start

HULFT10 API Gatewayの管理画面を起動

HULFT10 API Gatewayの管理画面の起動には、Webブラウザを使用します。

HULFT10 API Gatewayの対応ブラウザは以下のとおりです。

Google Chrome(x64) バージョン

: 120.0.* 以降

Microsoft Edge(x64) バージョン

: 120.0.* 以降

Webブラウザを使用して以下のURLにアクセスしてください。

http://API-Gatewayを起動しているホスト名:API-Gatewayのポート番号

入力例

http://localhost:8080

 

HULFT10 API Gatewayの管理画面が起動されます。

初期ユーザーは以下のユーザーIDとパスワードでログインできます。

ユーザーID

: root（固定）

パスワード

: 「HULFT10 API Gatewayのアクティベート」で初期パスワードとして指定したパスワード