REST APIリファレンス > RunAJobユーティリティ > RunAJobユーティリティのセットアップ
  

RunAJobユーティリティのセットアップ

RunAJobユーティリティを設定するには、ユーティリティに含まれているテンプレートファイルのコピーを作成し、新しいファイルを設定します。
次の表に、RunAJobユーティリティのテンプレートファイルとその説明を示します。
ファイル名
説明
Restenv_default.properties
ログイン資格証明とジョブポーリング動作を指定します。
Set_cli_vars_default.bat
Windowsマシンでは、暗号化キーを保管するキーストアのパスワード、およびRunAJobユーティリティがJavaコマンドの実行に使用する初期ヒープサイズと最大ヒープサイズを指定します。
Set_cli_vars_default.sh
Linuxマシンでは、暗号化キーを保管するキーストアのパスワード、およびRunAJobユーティリティがJavaコマンドの実行に使用する初期ヒープサイズと最大ヒープサイズを指定します。
Log4j2_default.properties
ログファイルに返す詳細のレベルを指定します。
テンプレートファイルは次の場所にあります。
<Secure Agent installation directory>\apps\runAJobCli
RunAJobプロパティをカスタマイズするには、テンプレートファイルをコピーし、ファイル名から_defaultを削除して、プロパティを設定します。または、コピーした既存のファイルがすでに存在する場合は、それらのファイルを更新することもできます。ユーティリティに含まれているテンプレートファイルを参考にしてください。

ログインプロパティ

restenv.propertiesファイルでInformatica Intelligent Cloud Servicesログイン資格情報を指定するか、ログインパラメータをタスクコマンドの引数として含めます。
ネイティブのInformatica Intelligent Cloud Servicesユーザーアカウントのログイン資格情報を使用します。RunAJobユーティリティにSAMLユーザーアカウントを使用することはできません。
restenv.propertiesファイルまたはタスクコマンドに次のパラメータを含めます。
パラメータ
説明
baseUrl
ベースURL。
デフォルトはhttps://dm-us.informaticacloud.com/maです。
username
Informatica Intelligent Cloud Servicesのユーザー名。
password
Informatica Intelligent Cloud Servicesパスワードまたは暗号化されたパスワード文字列。
パスワードの暗号化の詳細については、Linuxでのパスワードの暗号化またはWindowsでのパスワードの暗号化を参照してください。
use.encryption
暗号化されたパスワードの使用を有効にします。暗号化されたパスワードを使用する場合は、値をtrueに設定します。
CONNECT_TIMEOUT_SECONDS
環境に固有のネットワークの問題や遅延に対応するための接続タイムアウト期間。デフォルトは30秒です。
次の例に、暗号化されたパスワードを含むrestenv.propertiesファイルを示します。
username=saki
password=:1xCGDTC0oD9B2Rmd8Sr4IZWaWWkcEmiK5fy+GkycA==
ACTIVITYMONITORWAIT=2000
TOTALWAIT=60000
PROXYHOST=
PROXYPORT=
RETRYCOUNT=30
use.encryption=true
CONNECT_TIMEOUT_SECONDS=30
詳細については、「RunAJobユーティリティの引数」を参照してください。

Linuxでのパスワードの暗号化

restenv.propertiesファイルまたはタスクコマンドで指定する前に、ログインパスワードを暗号化できます。Linuxマシンでは、シェルスクリプトを使用してパスワードを暗号化します。
    1テンプレートファイルset_cli_vars_default.shをコピーし、名前をset_cli_vars.shに変更します。
    2ファイルを編集して、暗号化キーを格納するキーストアのパスワードを設定します。次の形式を使用します: export RUNAJOB_KEYSTORE_PASSWORD=<パスワード>
    3ログインパスワードを暗号化するには、次のいずれかのコマンドを実行します。
    ログインパスワードに英数字以外の文字が含まれている場合は、パスワードを二重引用符で囲みます。

Windowsでのパスワードの暗号化

restenv.propertiesファイルまたはタスクコマンドで指定する前に、ログインパスワードを暗号化できます。Windowsマシンでは、バッチファイルを使用してパスワードを暗号化します。
    1テンプレートファイルset_cli_vars_default.batをコピーし、名前をset_cli_vars.batに変更します。
    2ファイルを編集して、暗号化キーを格納するキーストアのパスワードを設定します。次の形式を使用します: set RUNAJOB_KEYSTORE_PASSWORD=<パスワード>
    3ログインパスワードを暗号化するには、次のいずれかのコマンドを実行します。
    ログインパスワードに英数字以外の文字が含まれている場合は、パスワードを二重引用符で囲みます。

ジョブステータス

RunAJobユーティリティがステータスをポーリングする頻度をrestenv.propertiesファイルで指定します。
以下のパラメータを使用できます。
パラメータ
説明
ACTIVITYMONITORWAIT
内部例外（ログインの失敗やネットワークの問題など）が発生した場合の再試行の間隔。
デフォルトは5000ミリ秒です。
TOTALWAIT
ジョブの完了を待機する最大時間。この時間を超えると、再びアクティビティモニタとアクティビティログでステータスのポーリングが行われます。
デフォルトは5000ミリ秒です。
RETRYCOUNT
ステータスをポーリングする回数。デフォルトは6です。このパラメータは、アクティビティモニタとアクティビティログでジョブステータスや内部例外（ネットワークの失敗など）をポーリングするために使用されます。
ログインが失敗した場合は、最大5回再試行されます。
注: Informatica Intelligent Cloud Servicesは各API呼び出しの間に10秒追加してサーバーの問題を防ぎます。
ジョブステータスをポーリングするようにrestenv.propertiesファイルを設定する場合は、TOTALWAITおよびRETRYCOUNTに設定する値を検討し、ジョブの実行にかかる予想時間を考慮に入れてください。
例えば、ジョブの実行に約25分かかると予想される場合は、次のパラメータを設定します。
TOTALWAIT=60000
RETRYCOUNT=30
これにより、ジョブステータスが60秒おきに最大30回、それぞれの再試行の間は10秒でポーリングされます（合計35分）。ジョブの実行が35分を超えると、コマンドは戻りコード6で終了します。これは、ジョブが実行中であることを意味します。ジョブは引き続きInformatica Intelligent Cloud Servicesで実行されます。
内部例外用にrestenv.propertiesファイルを設定する場合は、ACTIVITYMONITORおよびRETRYCOUNTに設定する値を検討してください。
例えば、次のようなパラメータを設定することができます。
ACTIVITYMONITORWAIT=5000
RETRYCOUNT=30
これらの設定を使用すると、ネットワークに障害が発生した場合、ユーティリティは5秒ごとに最大5回ログインを再試行し、再試行の間隔はさらに10秒となります。

ログファイルの詳細

ログファイルに含めるジョブの詳細のレベルをlog4j2.propertiesファイルで設定できます。
デフォルトでは、詳細レベルはINFOに設定されています。このレベルでは、ログファイルには、ユーザーID、ジョブID、タスクが開始された時刻などの基本情報が含まれます。デバッグ目的でログファイルにジョブの詳細を含める場合は、詳細レベルをDEBUGに変更します。または、細かい詳細を含める場合は、レベルをTRACEに変更します。
詳細レベルを設定するには、log4j2.propertiesファイルで次のパラメータの値を変更します。
rootLogger.level=INFO

Javaヒープサイズ

仮想メモリを最適に使用するには、RunAJobユーティリティが使用するJavaコマンドの初期ヒープサイズと最大ヒープサイズを指定します。CLI_JAVA_OPTSパラメータを使用してヒープサイズの値を設定します。
CLI_JAVA_OPTSパラメータに次のプロパティを指定します。
プロパティ
説明
Xms
JVMが割り当てる初期ヒープサイズを指定します。
Xmx
JVMが割り当てることができる最大ヒープサイズを指定します。
次のset_cli_vars.shファイルの例に示すように、CLI_JAVA_OPTSパラメータを設定できます。
@echo off
REM This variable is used to override the default KeyStore password.
set RUNAJOB_KEYSTORE_PASSWORD=
REM This variable is used to set the Java initial heap size and maximum heap size.
set CLI_JAVA_OPTS =Xms256m -Xmx512m

LinuxでのJavaヒープサイズの設定

set_cli_vars_default.shファイルで、Linuxマシン上のJavaヒープサイズの初期サイズと最大サイズを設定します。
    1set_cli_vars.shファイルを開きます。
    set_cli_vars.shファイルがない場合は、テンプレートファイルset_cli_vars_default.shをコピーし、名前をset_cli_vars.shに変更します。
    2ファイルを編集して、初期ヒープサイズと最大ヒープサイズを指定します。次の形式を使用します。
    export CLI_JAVA_OPTS="-Xms<初期ヒープサイズ>m -Xmx<最大ヒープサイズ>m"
    例: export CLI_JAVA_OPTS="-Xms256m -Xmx512m"
    3ファイルを保存します。

WindowsでのJavaヒープサイズの設定

set_cli_vars_default.batファイルで、Windowsマシン上のJavaヒープサイズの初期サイズと最大サイズを設定します。
    1set_cli_vars.batファイルを開きます。
    set_cli_vars.batファイルがない場合は、テンプレートファイルset_cli_vars_default.batをコピーし、名前をset_cli_vars.batに変更します。
    2ファイルを編集して、初期ヒープサイズと最大ヒープサイズを指定します。次の形式を使用します。
    set CLI_JAVA_OPTS=-Xms<初期ヒープサイズ>m -Xmx<最大ヒープサイズ>m
    例: set CLI_JAVA_OPTS=-Xms256m -Xmx512m
    3ファイルを保存します。