Oracle Forms Application Deployment Services
Forms Application Deployment Services (FADS)により、アプリケーションのパッケージ化やアプリケーションのアーカイブ・コピーのデプロイ、構成および格納のプロセスが簡略化されます。
Forms Application Deployment Servicesを使用すると、管理者または開発者はボタンをクリックするだけで、アプリケーションのパッケージ化やアプリケーションのアーカイブ・コピーのデプロイ、構成および格納ができるようになります。Formsアプリケーションを配信およびデプロイするには、fmx、mmx、plxファイルなどのForms実行可能ファイルを含むアプリケーション・パッケージを作成する必要があります。実行可能ファイルの生成に加えて、アプリケーションでは、jarやhtmlなどの追加のカスタム・ファイルや、場合によっては一意の構成設定を必要とすることもあります。
ノート:
FADS Webインタフェースでは、100MB最大アーカイブ(.far)ファイル・サイズ制限がサポートされています。100MBを超えるファイルをデプロイしようとすると、タイムアウト・エラーとなり、デプロイメントが失敗することがあります。大規模なファイルの場合は、Webインタフェースではなく、提供されているコマンドライン・ユーティリティを使用してください。内容は次のとおりです。
FADSへのアクセス
FADSで使用するには、Webインタフェースまたはコマンドライン・インタフェースを使用できます。
Webインタフェースへのアクセス
FADSは、WebLogic Server管理サーバーにデプロイされます。したがって、FADSにアクセスするには、WebLogic Server管理サーバーが実行され、アクセス可能である必要があります。最高レベルのセキュリティを確保するために、WebLogic Server管理サーバーでSSLを有効にすることをお薦めします。HTTPリスナーとOracle WebLogic ServerでのOracle Forms Servicesの使用方法を参照してください。FADS Webインタフェースにアクセスするには、次のようなURLを使用します。
http://example.com:7001/fadsui
ノート:
管理サーバー・ログに表示されるFADSに関連する一部のADFエラーおよび警告は、FADSが正しく機能していない場合でなければ無視して構いません。コマンドライン・インタフェースへのアクセス
FADSCLIは、最新のOracle Fusion Middleware 12cドメインで実行されているForms Application Deployment Servicesに接続してやり取りできるようになるコマンドライン・インタフェースです。
デフォルトでは、FADSコマンドライン・インタフェースは非SSLモードでサーバーに接続します。
SSLモードを使用するには、追加の引数ssl=true
を様々なFADSCLIオプションに渡して、WebLogic管理サーバーのSSLポートに接続します。SSLモードでの実行時、FADSCLIを実行しているクライアント側JVMで証明書をインポートする必要があります。Javaキーストアへの証明書のインポートについては、Javaのドキュメントを参照してください。
FADSCLIには、FADSCLIスクリプトとそのライブラリが格納されています。これは、FMW ORACLE_HOME
のディレクトリORACLE_HOME/forms/fads/fads-client
にあります。
様々なFADSCLIオプションの詳細は、「FADSCLIのオプション」を参照してください。
Formsアプリケーション・パッケージャの使用
FADSを使用してアプリケーション・パッケージをデプロイするには、そのアプリケーション・パッケージをあらかじめ作成する必要があります。Forms Application Packager (FAP)コマンドライン・ユーティリティを使用して、FARファイルと呼ばれるFormsアプリケーション・アーカイブ・ファイルをパッケージ化します。
Formsアプリケーション・パッケージャは、アーティファクト・ディレクトリ内でFormsアーティファクトを検索し、FARファイルを生成します。このようなFARファイルは、最新のOracle Fusion Middleware 12cリリースのドメインで実行されているFADSにデプロイできます。
この項の内容は、次のとおりです。
Formsアプリケーション・パッケージャの取得
Formsアプリケーション・パッケージャは、アーティファクト・ディレクトリ内でFormsアーティファクトを検索し、FARファイルを生成します。このようなFARファイルは、最新のOracle Fusion Middleware 12cリリースのドメインで実行されているFADSにデプロイできます。Formsアプリケーション・パッケージャを使用するには、Webインタフェースからクライアント・ツール・セットをダウンロードします。このセットには、FAPユーティリティが含まれています。
fa_packager.sh
およびfa_packager.cmd
)とその依存ライブラリが含まれます。Formsアプリケーション・パッケージャ・ユーティリティは次から入手できます。
- 現在のOracle Fusion Middleware 12cリリースおよびOracle Forms Standalone Builder 12cのインストールの
$FMW_HOME/forms/fads/fads-client
ディレクトリ。 - Forms Application Deployment Services Webインタフェースからダウンロードすることもできます。右上にある「<username>」(weblogicなど)ドロップダウン・メニューに移動し、「クライアント・ツールのダウンロード」オプションを選択します。
図fads_download-fap-menu.pngの説明クライアント・ツールのダウンロードには、Formsアプリケーション・パッケージャ・ユーティリティとFADSコマンドライン・インタフェース(FADSCLI)の両方が含まれます。
アプリケーション・パッケージの作成
様々なFormsアプリケーション・パッケージャ引数を使用して、アプリケーション・パッケージを作成します。
Formsアプリケーション・パッケージャで使用する構文は次のとおりです。
fa_packager.sh appName=<app_name> appVersion=<app_version> artifactDirs=<artifact_dirs>
outputDir=<output_dir> preserveDir=<preserve_dir> startForm=<startForm> ignoreExt=<ignore extn list>
Formsアプリケーション・パッケージャ引数は、構文のリストに示したものと同じ順序で渡す必要があります。引数の詳細は、表-9を参照してください。
表-9 Formsアプリケーション・パッケージャの引数
引数 | 説明 | 必須/オプション | ノート |
---|---|---|---|
|
Formsアプリケーション名 |
必須 |
最初の引数は常にFormsアプリケーション名にする必要があります。 例: sales |
|
Formsアプリケーションのバージョン |
必須 |
2番目の引数は常にFormsアプリケーションのバージョンにする必要があります。これはFormsアプリケーションのバージョンであり、Forms製品のバージョンとは関係ありません。 例: 1.0 |
|
Formsアプリケーションのアーティファクト・ディレクトリ これは、Formsアプリケーション・アーティファクト(Forms、メニュー、PLSQLライブラリ、オブジェクト・ライブラリなど)が常駐するディレクトリです。 オプションとして、Formsアプリケーション関連の構成をFARファイルに含めるには、表-10に示すようにファイル内に構成の内容を作成します。 |
必須 |
3番目の引数は常にアーティファクト・ディレクトリにする必要があります。 すべてのFormsアプリケーションに対して1つのトップレベル・ディレクトリを作成することは避けてください。 例: FormsアプリケーションSales、FinanceおよびHuman Resourcesがある場合。これらのアプリケーションそれぞれについて別々のトップレベル・ディレクトリを作成し、そのディレクトリ・パスをアーティファクト・ディレクトリとして渡します。 オプションの構成ファイルを指定する場合は、アーティファクト・ディレクトリの最上位ディレクトリにファイルを配置します。Formsアプリケーション・パッケージャでは、これらのファイルから構成を集めてFARファイルに含めます。 |
|
これは、FARファイルが生成されるディレクトリです。 |
オプション ノート: preserve_dir引数を使用する場合、output_dirは必須になります。 |
使用する場合、常にFAパッケージャに渡す4番目の引数とします。 出力ディレクトリを指定すると、fa_packagerによってこのディレクトリ内にFARファイルが生成されます。この引数を指定しないと、fa_packgerによって現行ディレクトリ内にFARファイルが生成されます。 |
|
これはブール引数(true/false)で、デフォルト値はfalseです。 アーティファクト・ディレクトリのディレクトリ構造をFARファイル内で維持する必要があるかどうかを示します。 |
オプション |
使用する場合、常にFAパッケージャに渡す5番目の引数とします。 |
表-10 Formsアプリケーション関連の構成ファイル
ファイル | ノート | 追加先のForms構成ファイル |
---|---|---|
|
このファイルの内容は、デプロイ時にFADSによってformsweb.cfgに追加されます。
|
|
|
このファイルの内容は、デプロイ時にFADSによって新しいenvファイルに追加されます。
|
|
|
このファイルの内容は、デプロイ時にFADSによってjvmcontrollers.cfgに追加されます。 |
|
|
このファイルの内容は、Registry.datに追加されます |
|
FARファイルの内容の理解
この項では、FARファイルの内容について説明します。
表-11に、Formsアプリケーション・パッケージャによって生成されるFARファイルの内容を示します。
表-11 FARファイルの内容
名前 | 説明 |
---|---|
Forms_application.xml |
パッケージ化されたFormsアプリケーションに関連するメタデータがすべて含まれるFADSデプロイメント・ディスクリプタです。 |
fmbディレクトリ |
Formsアプリケーション・アーティファクト・ディレクトリのForms (fmb)ファイルがすべて含まれます。 |
mmbディレクトリ |
Formsアプリケーション・アーティファクト・ディレクトリのMenus (mmb)ファイルがすべて含まれます。 |
pllディレクトリ |
Formsアプリケーション・アーティファクト・ディレクトリのPLSQLライブラリ(pll)ファイルがすべて含まれます。 |
olbディレクトリ |
Formsアプリケーション・アーティファクト・ディレクトリのオブジェクト・ライブラリ(olb)ファイルがすべて含まれます。 |
sqlディレクトリ |
Formsアプリケーション・アーティファクト・ディレクトリのSQLファイルがすべて含まれます。 |
user_exitsディレクトリ |
Formsアプリケーション・アーティファクト・ディレクトリのユーザー・イグジット・ライブラリ(.soおよびWindowsプラットフォームの場合は.dll)ファイルがすべて含まれます。 |
client_jarsディレクトリ |
Formsアプリケーション・アーティファクト・ディレクトリの次のアーティファクトが含まれます。
|
java_importerディレクトリ |
FormsアプリケーションにJava Importer関連のJARファイルがある場合、java_importerという名前のディレクトリに入れ、Formsアプリケーション・アーティファクト・ディレクトリ下のトップレベル・ディレクトリに入れる必要があります。 |
misc_filesディレクトリ |
Formsアプリケーション・アーティファクト・ディレクトリのMicrosoft Word (*.doc, *.docx)ファイル、Portable Document Format (*.pdf)ファイルおよびテキスト(*.txt)ファイルがすべて含まれます。 |
webutil 32ビット・ファイル・ディレクトリ |
すべての32ビットwebutilファイルが含まれています。 最上位の
|
webutil 64ビット・ファイル・ディレクトリ |
すべての64ビットwebutilファイルが含まれています。 最上位の
|
ノート:
preserve_dir引数を渡した場合、表-11に示したディレクトリはいずれも作成されません。アーティファクト・ディレクトリ内のサブディレクトリと同様のサブディレクトリがFARファイルに作成されます。アプリケーション・パッケージのデプロイメント
アプリケーション・パッケージを作成した後、FADSを使用してデプロイできます。
この項の内容は、次のとおりです。
Webインタフェースの使用
UIの理解
FADS Webインタフェースには、「ダッシュボード」タブと「アーカイブ」タブがあります。ドロップダウン・メニューを使用して、構成オプションにアクセスすることもできます。
「ダッシュボード」タブ
FADS Webインタフェースの「ダッシュボード」タブは、最初のログオン時に表示されます。名前が示すとおり、このタブを使用してアプリケーションをデプロイすると、デプロイメントの進行状況およびステータスを表示できます。
図fads_dashboard-png.pngの説明
「アーカイブ」タブ
「アーカイブ」タブには、以前にデプロイされたすべてのアプリケーションがリストされます。アーカイブ名、アプリケーション名とバージョンおよび日付を確認できます。リストで特定のアプリケーションを検索するには、「検索」フィールドを使用します。リスト内の選択したアプリケーションについて、詳細の表示、デプロイ、デプロイの停止、削除またはダウンロードを実行できます。
図fads_archives.pngの説明
「<username>」ドロップダウン・メニュー
「<username>」(weblogicなど)ドロップダウン・メニューには複数のオプションがあります。これらのオプションを使用すると、サービス構成の表示、ツールのダウンロード、ログの表示、およびページ・リフレッシュ間隔の指定を行うことができます。
FADS関連の構成設定がリストされた「サービス構成」ページを表示するには、「サービス構成」オプションをクリックします。このページには、事前移入された「環境」、「設定」および「ルール」セクションが含まれます。
図fads_serv_config.pngの説明
コマンドライン・インタフェースの使い方
FADSコマンドライン・インタフェースを使用して、複数のアプリケーションをデプロイし、アプリケーションのデプロイメントをスケジュールします。
- 同時に複数のアプリケーションをデプロイする
- 同時に複数の既存アプリケーションの更新をデプロイする
- 選択したアプリケーションの夜間または定期的なスケジュール更新をデプロイする
表-12 FADSCLIのオプションのリスト
オプション | 説明 |
---|---|
|
Forms Application Deployment Servicesを介してFMWドメインにデプロイされたFormsアプリケーションをすべて表示します。 |
|
Forms Application Deployment Servicesのアーカイブ・リポジトリにあるFormsアプリケーション・アーカイブ(far)ファイルをすべて表示します。 |
|
指定のFormsアプリケーション・アーカイブ(far)ファイルをFMWドメインで実行されているForms Application Deployment Servicesにデプロイします。 |
|
これはバッチ・モードのデプロイメントで、指定のアーカイブ・ディレクトリ内のFormsアプリケーション・アーカイブ(far)ファイルをすべて、FMWドメインで実行されているForms Application Deployment Servicesにデプロイします。 |
|
アーカイブ・リポジトリにあるFormsアプリケーション・アーカイブ・ファイルをFMWドメインで実行されているForms Application Deployment Servicesにデプロイします。 |
|
Forms Application Deployment Servicesに現在デプロイされているFormsアプリケーションをアンデプロイまたは削除します。 |
|
Forms Application Deployment Servicesに現在デプロイされているFormsアプリケーションの内容の説明を示します。 |
|
アーカイブ・リポジトリにあるFormsアプリケーション・アーカイブ・ファイルをデプロイします |
|
Forms Application Deployment ServicesにデプロイされているFormsアプリケーションのデプロイメント・ログをダウンロードします。 |
|
アーカイブ・リポジトリにあるFormsアプリケーション・アーカイブ・ファイルを削除します。 |
これらのオプションの詳細は、「FADSCLIオプション」を参照してください。
FADSCLIのオプション
この項では、FADSCLIで使用できるオプションを説明します。
ヘルプ
次のスクリプトは、FADSCLIのヘルプ
を示しています。
sh-4.1$ ./fadscli.sh
fadscli Help :
------------------------------------------------------------------------------------------------------------------------------
options | description
------------------------------------------------------------------------------------------------------------------------------
listApps | displays all the applications deployed to the FMW domain
listArchives | displays all the far files that reside in the archives repository
deployApp | deploys the far file to the FMW domain
deployApps | deploys all the far files in the local archives directory (archivedir) to the FMW domain
deployArchive | deploys the far file (archivename) from the archive repository to the FMW domain
undeployApp | undeploys/deletes the Forms application from the FMW domain
describeApp | describes the contents of an application that is deployed on the FMW domain
deleteArchive | deletes the archive from the archive repository
downloadLog | gets the deployment logs of an application that is deployed to the FMW domain
downloadArchive | downloads an archive from the archive repository
Usage :
fadscli.sh option hostname=hostname portno=portno username=username password=password
-----------------------------o-p-t-i-o-n-s-----a-r-g-u-m-e-n-t-s--------------------------------------------------------------
fadscli.sh listApps hostname=<hostname> portno=<portno> username=<username> password=<password>
fadscli.sh listArchives hostname=<hostname> portno=<portno> username=<username> password=<password>
fadscli.sh deployApp hostname=<hostname> portno=<portno> username=<username> password=<password> farfile=<path to the far file> dbuser=<dbuser> dbpassword=<dbpassword> dbalias=<dbalias> managedserver=<managedserver1,managedserver2>
fadscli.sh deployApps hostname=<hostname> portno=<portno> username=<username> password=<password> archivedir=<path to the directory containing far files> dbuser=<dbuser> dbpassword=<dbpassword> dbalias=<dbalias> managedserver=<managedserver1,managedserver2>
fadscli.sh deployArchive hostname=<hostname> portno=<portno> username=<username> password=<password> archivename=<archivename> appname=<appname> appversion=<appversion> dbuser=<dbuser> dbpassword=<dbpassword> dbalias=<dbalias> managedserver=<managedserver1,managedserver2>
fadscli.sh undeployApp hostname=<hostname> portno=<portno> username=<username> password=<password> appname=<appname> appversion=<appversion>
fadscli.sh describeApp hostname=<hostname> portno=<portno> username=<username> password=<password> appname=<appname> appversion=<appversion>
fadscli.sh deleteArchive hostname=<hostname> portno=<portno> username=<username> password=<password> archivename=<archivename> appname=<appname> appversion=<appversion>
fadscli.sh downloadLog hostname=<hostname> portno=<portno> username=<username> password=<password> appname=<appname> appversion=<appversion>
fadscli.sh downloadArchive hostname=<hostname> portno=<portno> username=<username> password=<password> archivename=<archivename> appname=<appname> appversion=<appversion>
optional argument: pass argument ssl=true when running HTTPS/SSL
------------------------------------------------------------------------------------------------------------------------------
sh-4.1$
listApps
sh-4.1$ ./fadscli.sh help listApps
listApps : displays all the applications deployed to the FMW domain
usage:
fadscli.sh listApps hostname=<hostname> portno=<portno> username=<username> password=<password>
arguments:
--------------------------------------------------------------
hostname : Weblogic Admin Server hostname
portno : Weblogic Admin Server port (ssl or non-ssl)
username : Weblogic Admin username
password : Weblogic Admin password
listArchives
sh-4.1$ ./fadscli.sh help listArchives
listArchives : displays all the far files that reside in the archives repository
usage:
fadscli.sh listArchives hostname=<hostname> portno=<portno> username=<username> password=<password>
arguments:
--------------------------------------------------------------
hostname : Weblogic Admin Server hostname
portno : Weblogic Admin Server port (ssl or non-ssl)
username : Weblogic Admin username
password : Weblogic Admin password
deployApp
sh-4.1$ ./fadscli.sh help deployApp
deployApp : deploys the far file to the FMW domain
usage:
fadscli.sh deployApp hostname=<hostname> portno=<portno> username=<username> password=<password> farfile=<path to the far file> dbuser=<dbuser> dbpassword=<dbpassword> dbalias=<dbalias> managedserver=<managedserver1,managedserver2>
arguments:
--------------------------------------------------------------
hostname : Weblogic Admin Server hostname
portno : Weblogic Admin Server port (ssl or non-ssl)
username : Weblogic Admin username
password : Weblogic Admin password
farfile : path of the far file that is to be deployed
dbuser : Forms application database username
dbpassword : Forms application database password
dbalias : Forms application database alias
managedserver : Forms Managed Servers where the Forms application should be deployed
deployApps
sh-4.1$ ./fadscli.sh help deployApps
deployApps : deploys all the far files in the local archives directory (archivedir) to the FMW domain
usage:
fadscli.sh deployApps hostname=<hostname> portno=<portno> username=<username> password=<password> archivedir=<path to the directory containing far files> dbuser=<dbuser> dbpassword=<dbpassword> dbalias=<dbalias> managedserver=<managedserver1,managedserver2>
arguments:
--------------------------------------------------------------
hostname : Weblogic Admin Server hostname
portno : Weblogic Admin Server port (ssl or non-ssl)
username : Weblogic Admin username
password : Weblogic Admin password
archivedir : local directory path containing the far files
dbuser : Forms application database username
dbpassword : Forms application database password
dbalias : Forms application database alias
managedserver : Forms Managed Servers where the Forms application should be deployed
deployArchive
sh-4.1$ ./fadscli.sh help deployArchive
deployArchive : deploys the far file (archivename) from the archive repository to the FMW domain
usage:
fadscli.sh deployArchive hostname=<hostname> portno=<portno> username=<username> password=<password> archivename=<archivename> appname=<appname> appversion=<appversion> dbuser=<dbuser> dbpassword=<dbpassword> dbalias=<dbalias> managedserver=<managedserver1,managedserver2>
arguments:
--------------------------------------------------------------
hostname : Weblogic Admin Server hostname
portno : Weblogic Admin Server port (ssl or non-ssl)
username : Weblogic Admin username
password : Weblogic Admin password
archivename : Name of the archive in archive repository
appname : Forms application name
appversion : Forms application version
dbuser : Forms application database username
dbpassword : Forms application database password
dbalias : Forms application database alias
managedserver : Forms Managed Servers where the Forms application should be deployed
undeployApp
sh-4.1$ ./fadscli.sh help undeployApp
undeployApp : undeploys/deletes the Forms application from the FMW domain
usage:
fadscli.sh undeployApp hostname=<hostname> portno=<portno> username=<username> password=<password> appname=<appname> appversion=<appversion>
arguments:
--------------------------------------------------------------
hostname : Weblogic Admin Server hostname
portno : Weblogic Admin Server port (ssl or non-ssl)
username : Weblogic Admin username
password : Weblogic Admin password
appname : Forms application name
appversion : Forms application version
describeApp
sh-4.1$ ./fadscli.sh help describeApp
describeApp : describes the contents of an application that is deployed on the FMW domain
usage:
fadscli.sh describeApp hostname=<hostname> portno=<portno> username=<username> password=<password> appname=<appname> appversion=<appversion>
arguments:
--------------------------------------------------------------
hostname : Weblogic Admin Server hostname
portno : Weblogic Admin Server port (ssl or non-ssl)
username : Weblogic Admin username
password : Weblogic Admin password
appname : Forms application name
appversion : Forms application version
deleteArchive
sh-4.1$ ./fadscli.sh help deleteArchive
deleteArchive : deletes the archive from the archive repository
usage:
fadscli.sh deleteArchive hostname=<hostname> portno=<portno> username=<username> password=<password> archivename=<archivename> appname=<appname> appversion=<appversion>
arguments:
--------------------------------------------------------------
hostname : Weblogic Admin Server hostname
portno : Weblogic Admin Server port (ssl or non-ssl)
username : Weblogic Admin username
password : Weblogic Admin password
archivename : Name of the archive in archive repository
appname : Forms application name
appversion : Forms application version
downloadLog
sh-4.1$ ./fadscli.sh help downloadLog
downloadLog : gets the deployment logs of an application that is deployed to the FMW domain
usage:
fadscli.sh downloadLog hostname=<hostname> portno=<portno> username=<username> password=<password> appname=<appname> appversion=<appversion>
arguments:
--------------------------------------------------------------
hostname : Weblogic Admin Server hostname
portno : Weblogic Admin Server port (ssl or non-ssl)
username : Weblogic Admin username
password : Weblogic Admin password
appname : Forms application name
appversion : Forms application version
downloadArchive
sh-4.1$ ./fadscli.sh help downloadArchive
downloadArchive : downloads an archive from the archive repository
usage:
fadscli.sh downloadArchive hostname=<hostname> portno=<portno> username=<username> password=<password> archivename=<archivename> appname=<appname> appversion=<appversion>
arguments:
--------------------------------------------------------------
hostname : Weblogic Admin Server hostname
portno : Weblogic Admin Server port (ssl or non-ssl)
username : Weblogic Admin username
password : Weblogic Admin password
archivename : Name of the archive in archive repository
appname : Forms application name
appversion : Forms application version