IBM Sterling Intelligent Promising ファイル転送アダプターのダウンロード、インストール、および構成

データを Sterling Intelligent Promisingに転送するようにファイル転送アダプターをインストールして構成します。 ファイル転送アダプターを使用して、他のシステムからさまざまなデータ・タイプを転送できます。 これらのデータ・タイプは、さまざまな分析、操作、および意思決定の目的で使用できる、複数のソースからのデータを結合し、統一された一貫性のある形式に調整するプロセスにとって重要です。

始める前に

  1. ファイル転送アダプターを使用する前に、ご使用のシステムが以下のシステム要件を満たしていることを確認してください。
    • Java™ 11 以降がインストールされている。
    • Linux® シェル・スクリプトを実行する機能があります。
      • これには、Unixベースのシステムや、同様の機能を持つその他のシステムも含まれる。
    • ファイル転送アダプター配布で提供されるシェル・スクリプトを実行するための実行可能権限が使用可能です。
  2. IBM Cloud® Object Storage バケットをプロビジョンします。 詳細は IBM Cloud Object Storageで始めるを参照。
  3. ファイル転送アダプターに提供する IBM Cloud Object Storage バケットに関する以下のプロビジョニング情報を収集します。
    • IBM Cloud Object Storage サービスインスタンスのエンドポイント URL。
    • サービス・インスタンスの地域または地理的位置。
    • IBM Cloud Object Storageの IAM キー。 詳細は IAMの概要を参照。
    • バケット名。
    • プロビジョンされた Sterling Intelligent Promising テナント ID。
  4. データ・モデルを確認し、ファイルを準備します。 詳細は、データフィードの種類の概要を参照。

このタスクについて

ファイル転送アダプターは、システムと Sterling Intelligent Promisingの間でファイルを転送するために使用されます。 コンテンツを Sterling Intelligent Promisingに転送する各環境にファイル転送アダプターをインストールします。

手順

  1. Fix Centralから sip-cos-file-adapter-dist<version>.zip ファイルをダウンロードするには、以下の手順を実行します。
    1. Web ブラウザーで、 Fix Centralを開きます。
    2. 「製品の検索」 タブの 「製品セレクター」 ボックスに、 IBM Sterling Order Management System Softwareと入力します。
    3. 「インストール済みバージョン」 ドロップダウン・リストから 「すべて」 を選択し、 「続行」 をクリックします。
    4. 「Individiual fix ID」 フィールドに IBM Sterling Intelligent Promising と入力し、 「続行」をクリックします。
    5. IBMid と password を入力し、 「サインイン」をクリックします。
    6. ダウンロードのタイプを選択して、 「続行」をクリックします。
    7. IBM Sterling Intelligent Promising ファイル転送アダプターをダウンロードするには、ご使用条件を選択します。 次に、 「今すぐダウンロード」をクリックします。
  2. sip-cos-file-adapter-dist-<version>.zip ファイルを解凍します。
    sip-cos-file-adapter-dist-<version> ディレクトリーが作成されます。 このディレクトリーは、 < install-dir>と呼ばれます。 解凍されたパッケージには、以下のファイルが含まれています。
    readme.txt
    ファイル転送アダプターに関する情報と従うべき指示が含まれているファイル。
    log4j2.xml
    サンプル・ロギング構成ファイル。
    transfer.options
    サンプル構成オプション・ファイル。
    sip_cos_file_adapter.sh
    ツールを実行するためのシェル・スクリプト。
    lib
    アプリケーションの実行ファイル JAR を含むフォルダ。
  3. インストールを検証するには、 -help コマンド行オプションを指定してシェル・スクリプトを実行します。
  4. サポートされるすべての操作について、以下のステップを使用して以下の構成オプションを定義します。
    • コマンド行オプションを使用して、転送ごとに変更される構成オプションの値を定義します。
    • transfer.options 構成ファイルを使用して、頻繁に変更されない一般構成オプションの値を定義します。 例えば、 endpoint URL、 apiKey、 bucketName、または locationなどです。
      • ファイル転送アダプター・ツールを実行し、 -conf path/to/transfer.options コマンド行オプションを使用して構成ファイルを参照します。

        サンプル構成ファイルは、ダウンロードした sip-cos-file-adapter-dist-<version>.zip の一部として提供されています。

    一般構成オプション
    エンドポイント URL
    IBM Cloud Object Storage のURLは、例えば cloud-object-storage.appdomain.cloud です。 詳細については IBM Cloud Object Storage の使用開始 」を参照してください。
    ロケーション
    IBM Cloud Object Storageの地域または地理的位置、例えばUSまたはUS-South。
    apiKey
    IBM Cloud Object Storage にのみ必要な IAM API キー
    bucketName
    IBM Cloud Object Storage バケット名。
    tenantId
    アップロードされたファイルのタグ付けに使用される、プロビジョンされた Sterling Intelligent Promising テナント ID。 UPLOAD 操作に dataType オプションが指定されている場合、ファイルをアップロードするためにバケット内でこの <tenantId>/UPLOAD/<dataType> 仮想フォルダー・パスを動的に構成するために、 tenantId が使用されます。
    ツール実行ごとの特定の構成オプション
    op
    実行される操作: UPLOAD、 DOWNLOAD、および LIST。
    src
    バケットにアップロードするローカル・ソース・ファイルまたはディレクトリーへのパス。
    dataType
    アップロードまたはダウンロードするファイルのデータ・タイプ。 path オプションではなく dataType オプションが UPLOAD 操作に指定されている場合、 dataType を使用して、ファイルをアップロードするためにバケット内にこの <tenantId>/UPLOAD/<dataType> 仮想フォルダー・パスが動的に構成されます。 デフォルトでは、以下のデータ・タイプがサポートされています。
    • OL (オーダー明細)
    • TLOG (トランザクション・ログ)
    • INV (在庫)
    • SUPPLY
    • MKC (マークダウン)
    • ITEM（カタログ商品）
    詳細は、データフィードの種類の概要を参照。
    downloadDest
    これは、DOWNLOAD 操作に必要です。 ファイルがバケットからダウンロードされるローカル・ディレクトリー。 ディレクトリーが存在しない場合は、自動的に作成されます。
    パス
    空の値を指定することによって参照されるファイルがアップロード、ダウンロード、またはリストされるバケット内のルート仮想フォルダーへのパス。 このパスは、 LIST、 DOWNLOAD、および UPLOAD 操作に対して指定されます。
    path オプションにブランク値を指定した場合、これはルート仮想フォルダーを表します。 その結果、 LIST 操作および DOWNLOAD 操作では、バケット全体の内容がリストされ、ダウンロードされます。
    UPLOAD 操作の場合のみ、これを dataType オプションの代わりに使用して、 <tenantId>/UPLOAD/<dataType> で動的に作成された仮想フォルダー・パスの代わりに提供された値を使用するようにツールに指示することができます。
    listMaxSize
    LIST 操作についてリストされるファイルの最大数。 デフォルトは 10000 です。
    deleteFilesAfterUpload
    UPLOAD の操作では、ローカルのソースディレクトリから正常にアップロードされたファイルを永久に削除するかどうかを指定します。 これはブール値のフラグである。 値は必要ない。
    コマンド行でサポートされない構成オプション
    supportedDataTypes
    アップロードするファイルでサポートされているデータ・タイプを含むコンマ区切りリスト。 dataType オプションを指定すると、このリストに対して値が検証され、検証が失敗した場合は操作が拒否されます。 デフォルト値は以下のとおりです。
    • ol
    • TLog
    • INV
    • SUPPLY
    • MKC (M)
    • アイテム
    supportedContentTypes
    アップロードするファイルでサポートされているデータ・タイプを含むコンマ区切りリスト。 アップロードされた各ファイルのコンテンツ・タイプがこのリストに対して検証され、検証が失敗した場合は操作が拒否されます。 デフォルト値は以下のとおりです。
    • text/csv
    • TEXT/PLAIN
    • アプリケーション /gzip
    パフォーマンスおよびエラー処理の構成オプション
    注: パフォーマンスの問題やリカバリー不能エラーが発生しない限り、パフォーマンスおよびエラー処理の構成オプションのデフォルト値を更新する必要はありません。
    maxParallelUploads
    並行してアップロードするファイルの最大数。 デフォルト値は 10 です。 多数の小さいファイルをアップロードするには、デフォルト値を大きくしてパフォーマンスを向上させることができます。 ただし、ネットワーク帯域幅が問題になる可能性がある大容量ファイルをアップロードするには、デフォルト値を変更してもネットワーク・パフォーマンスが向上しない場合があります。
    requestTimeoutMs
    要求タイムアウト (ミリ秒)。 デフォルト値は 60000 です。 要求タイムアウトが頻繁に発生する場合は、デフォルト値を調整してください。
    connectTimeoutMs
    接続タイムアウト (ミリ秒)。 デフォルト値は 10000 です。 接続タイムアウトが頻繁に発生する場合は、デフォルト値を調整してください。
    maxErrorRetry
    失敗した要求に対する再試行の最大回数。 デフォルト値は 10 です。 IBM Cloud Object Storage SDKのデフォルトの再試行ポリシー、指数バックオフ戦略、再試行条件が適用されます。
    maxHttpConnections
    HTTPの最大数。 デフォルト値は 50 です。
  5. サポートされている構成オプションを表示するには、以下のいずれかの手順を実行します。
    • transfer.options ファイルで提供されている構成オプションを確認します。
    • -help コマンド行オプションで提供されるシェル・スクリプトを実行して、サポートされる構成オプションを表示します。