11 インライン・サービスのコマンドライン・デプロイ

Decision Studioからのデプロイに加えて、インライン・サービスのデプロイはコマンドラインからも可能です。インライン・サービスのこのタイプのデプロイは、コマンドライン・ウインドウ内のコマンドによって直接実行することも、そのコマンドを呼び出すスクリプトから実行することもできます。

これは、ファイルがソース管理システムに格納されているインライン・サービス上で複数の開発者が作業する状況で役立ちます。スケジュールに従って（またはオンデマンドで）、インライン・サービスをソース管理システムから取り出して本番マシンに、または本番マシンにインライン・サービスをデプロイできる別のマシンに移します。次に、プログラムによって、本番RTDサーバーにインライン・サービスをデプロイします。

リリース時点では、コマンドライン・デプロイ・ツールは、ディレクトリRTD_HOME\client\CommandLineDeploy内のzipファイルrtd-deploytool-3.0.0.xxx.zipの中にあります。

最初に、ファイルrtd-deploytool-3.0.0.xxx.zipを解凍します。このファイルは、LinuxまたはWindowsが稼動している任意のマシンに解凍できます。マシンには、JDKがインストールされている必要があります。コマンドライン・デプロイ・ツールの実行に使用されるJDKのバージョンは、RTDサーバーで使用されているJDKのバージョンと一致している必要があります。

この章では、rtd-deploytool-3.0.0.xxx.zipの解凍先ディレクトリをRTD_DEPLOYTOOL_DIRと記述しています。この解凍作業により、RTD_DEPLOYTOOL_DIRの下にフォルダ構造OracleBI/RTDdeploytoolが作成されます。コマンドライン・デプロイを実行する主要なコマンドライン・デプロイ・ツールdeploytool.jarは、RTDdeploytoolフォルダの中にあります。

注意:

コマンドライン・デプロイ・ツールを使用するには、インライン・サービスのデプロイを許可するアプリケーション・サーバー・ロールにユーザーが関連付けられている必要があります。

たとえば、リリース時点でOracle RTDの標準ロールから権限割当てが削除されていない場合、RTDStudioDeployersロールまたはRTDAdministratorsロールに属するユーザーには、コマンドライン・デプロイ・ツールの使用が許可されます。

11.1 インライン・サービスのデプロイ

コマンドラインからインライン・サービスをデプロイするには、次の手順を実行します。

deploytool.jarファイルが格納されているディレクトリにナビゲートします。
```
cd RTD_DEPLOYTOOL_DIR/OracleBI/RTDdeploytool/
```

次のコマンドを実行します。

java [-Djavax.net.ssl.trustStore="<trust_store_location>"] -jar deploytool.jar -deploy [[<named_option>...] source [<positional_option> [...]]

deploytool.jarのパラメータは、次のとおりです。

<named_option>...: 表11-1に一覧表示されている名前と値の1つ以上のペア。

表11-1 コマンドライン・デプロイの名前付きオプション

書式	説明
`-server` `address`	RTDサーバーのホスト名またはIPアドレス。デフォルトはlocalhostです。
`-port` `number`	RTDサーバーで使用するポート。デフォルトは8080です。
`-sslConnection` `bool`	接続にSSLを使用するかどうかを指定します。デフォルトはfalseです。
`-deploymentState` `name`	このインライン・サービスのデプロイ状態。デフォルトはDevelopmentです。
`-releaseLock` `bool`	ロックを解除すると、他のユーザーがDecision Centerでインライン・サービスを編集したり、Decision Studioからインライン・サービスをデプロイできます。デフォルトはtrueです。
`-terminateSessions` `bool`	Decision Serverのアクティブなセッションを終了します。必要のない場合は、本番サーバーにデプロイするときにこのオプションは使用しないでください。デフォルトはfalseです。

source: 次のいずれかです。
- ディレクトリ: デプロイするインライン・サービスが格納されている、インライン・サービスのプロジェクト・フォルダのフルパス。
- zipファイル: デプロイするインライン・サービスが格納されている、インライン・サービスのプロジェクト・フォルダが含まれているzipファイルのフルパス。
  
  zipファイルには、1レベル上までの親フォルダとともにインライン・サービスを1つのみ格納できます。
空白を含むパスは、二重引用符で囲む必要があります（例、"C:\My Projects\CrossSell"）。

<positional_option>[...]: 次の書式の位置指定パラメータ・リスト。

[username password [server[port[ssl[state[unlock[endsessions]]]]]]]

エントリの内容は、表11-2に一覧表示されているとおりです。

表11-2 コマンドライン・デプロイの位置指定オプション

パラメータ	説明（表11-1 書式エントリへの参照を含む）
`username`	RTDサーバーにログインするユーザーの名前。
`password`	ユーザーのパスワード。パスワードを空白にしておくには、""を指定します。
`server`	位置指定`-server`
`port`	位置指定`-port`
`ssl`	位置指定`-sslConnection`
`state`	位置指定`-deploymentState`
`unlock`	位置指定`-releaseLock`
`endsessions`	位置指定`-terminateSessions`

コマンドライン・デプロイのプログラムでは、ソース内にあるOracle RTDインライン・サービスが、コマンドラインからサーバーにデプロイされます。

パラメータ-deployは、最初に必要となる引数です。

source、username、passwordの各パラメータは必須パラメータであり、また位置指定のパラメータでもあります。usernameパラメータおよびpasswordパラメータの値が最初に指定されていない場合には、値を入力するように要求されます。

名前付きオプションとその対応する位置指定オプションに値が指定された場合、その位置指定オプションの値は名前付きオプションの値より優先されます。

注意:

パラメータを指定しないでjarファイルを呼び出すと（例、java -jar deploytool.jar）、パラメータの一覧と説明が記載されているヘルプ・テキストが表示されます。
<trust_store_location> は、トラストストア・ファイルのフルパスです。-Djavax.net.ssl.trustStoreパラメータは、-sslConnection（または同等の位置指定パラメータssl）がtrueに設定されている場合にのみ使用します。

名前付きオプションを使用しない場合の例

java -jar deploytool.jar -deploy "c:\my workspace\CrossSell" scott brighton 192.168.0.15 8080 true Production false

java -jar deploytool.jar -deploy CrossSell sp34kc slater

java -jar deploytool.jar -deploy c:\OracleBI\RTD\examples\CrossSell sdsu b21k7e false QA

名前付きオプションを使用する場合の例

java -jar deploytool.jar -deploy -server 192.168.0.15 -port 8081 c:\OracleBI\RTD\examples\CrossSell sysman mi22ty

java -jar deploytool.jar -deploy -port 8081 -server 192.168.0.15 c:\OracleBI\RTD\examples\DC_Demo sonar chimney

java -jar deploytool.jar -deploy -sslConnection true CrossSell.zip calzone twostep

java -Djavax.net.ssl.trustStore="C:\OracleBI\RTDdeploytool\etc\ssl\sdtrust.store" -jar deploytool.jar -deploy -sslConnection true -port 8443 "C:\OracleBI\RTD\examples\CrossSell" ssluser psword