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は、FADSCLIユーティリティと同じバージョンの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 14cリリースのドメインで実行されているFADSにデプロイできます。
この項の内容は、次のとおりです。
Formsアプリケーション・パッケージャの取得
Formsアプリケーション・パッケージャには、スクリプト(fa_packager.sh
およびfa_packager.cmd
)とその依存ライブラリが含まれます。Formsアプリケーション・パッケージャ・ユーティリティは次から入手できます。
- 現在のOracle Fusion Middleware 14cリリースおよびOracle Forms Standalone Builder 14cのインストールの
$FMW_HOME/forms/fads/fads-client
ディレクトリ。 - Forms Application Deployment Services Webインタフェースからダウンロードすることもできます。右上にある「<username>」(weblogicなど)ドロップダウン・メニューに移動し、「クライアント・ツールのダウンロード」オプションを選択します。
クライアント・ツールのダウンロードには、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アプリケーション・パッケージャ引数は、構文のリストに示したものと同じ順序で渡す必要があります。引数の詳細は、表-4を参照してください。
表-4 Formsアプリケーション・パッケージャの引数
引数 | 説明 | 必須/オプション | ノート |
---|---|---|---|
appName |
Formsアプリケーション名 | 必須 |
最初の引数は常にFormsアプリケーション名にする必要があります。 例: sales |
appVersion |
Formsアプリケーションのバージョン | 必須 |
2番目の引数は常にFormsアプリケーションのバージョンにする必要があります。これはFormsアプリケーションのバージョンであり、Forms製品のバージョンとは関係ありません。 例: 1.0 |
artifactDirs |
Formsアプリケーションのアーティファクト・ディレクトリ これは、Formsアプリケーション・アーティファクト(Forms、メニュー、PLSQLライブラリ、オブジェクト・ライブラリなど)が常駐するディレクトリです。 オプションとして、Formsアプリケーション関連の構成をFARファイルに含めるには、表-5に示すようにファイル内に構成の内容を作成します。 |
必須 |
3番目の引数は常にアーティファクト・ディレクトリにする必要があります。 すべてのFormsアプリケーションに対して1つのトップレベル・ディレクトリを作成することは避けてください。 例: FormsアプリケーションSales、FinanceおよびHuman Resourcesがある場合。これらのアプリケーションそれぞれについて別々のトップレベル・ディレクトリを作成し、そのディレクトリ・パスをアーティファクト・ディレクトリとして渡します。 オプションの構成ファイルを指定する場合は、アーティファクト・ディレクトリの最上位ディレクトリにファイルを配置します。Formsアプリケーション・パッケージャでは、これらのファイルから構成を集めてFARファイルに含めます。 |
outputDir |
これは、FARファイルが生成されるディレクトリです。 |
オプション ノート: preserve_dir引数を使用する場合、output_dirは必須になります。 |
使用する場合、常にFAパッケージャに渡す4番目の引数とします。 出力ディレクトリを指定すると、fa_packagerによってこのディレクトリ内にFARファイルが生成されます。この引数を指定しないと、fa_packagerによって現行ディレクトリ内にFARファイルが生成されます。 |
preserveDir |
これはブール引数(true/false)で、デフォルト値はfalseです。 アーティファクト・ディレクトリのディレクトリ構造をFARファイル内で維持する必要があるかどうかを示します。 |
オプション | 使用する場合、常にFAパッケージャに渡す5番目の引数とします。 |
表-5 Formsアプリケーション関連の構成ファイル
ファイル | ノート | 追加先のForms構成ファイル |
---|---|---|
app.cfg |
このファイルの内容は、デプロイ時にFADSによってformsweb.cfgに追加されます。
|
formsweb.cfg |
app.env |
このファイルの内容は、デプロイ時にFADSによって新しいenvファイルに追加されます。 app.envを指定しないと、FADSにより、必須の環境変数がすべて指定されたForms環境構成ファイルが作成されます。 |
<appname>.env |
app_jvmcontrollers.cfg |
このファイルの内容は、デプロイ時にFADSによってjvmcontrollers.cfgに追加されます。 | jvmcontrollers.cfg |
app_registry.dat |
このファイルの内容は、Registry.datに追加されます | Registry.dat |
FARファイルの内容の理解
この項では、FARファイルの内容について説明します。
表-6に、Formsアプリケーション・パッケージャによって生成されるFARファイルの内容を示します。
表-6 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引数を渡した場合、表-6に示したディレクトリはいずれも作成されません。アーティファクト・ディレクトリ内のサブディレクトリと同様のサブディレクトリがFARファイルに作成されます。アプリケーション・パッケージのデプロイメント
アプリケーション・パッケージを作成した後、FADSを使用してデプロイできます。
この項の内容は、次のとおりです。
Webインタフェースの使用
UIの理解
FADS Webインタフェースには、「ダッシュボード」タブと「アーカイブ」タブがあります。ドロップダウン・メニューを使用して、構成オプションにアクセスすることもできます。
「ダッシュボード」タブ
「アーカイブ」タブ
「<username>」ドロップダウン・メニュー
「<username>」(weblogicなど)ドロップダウン・メニューには複数のオプションがあります。これらのオプションを使用すると、サービス構成の表示、ツールのダウンロード、ログの表示、およびページ・リフレッシュ間隔の指定を行うことができます。
FADS関連の構成設定がリストされた「サービス構成」ページを表示するには、「サービス構成」オプションをクリックします。このページには、事前移入された「環境」、「設定」および「ルール」セクションが含まれます。
コマンドライン・インタフェースの使い方
FADSコマンドライン・インタフェースを使用して、複数のアプリケーションをデプロイし、アプリケーションのデプロイメントをスケジュールします。
- 同時に複数のアプリケーションをデプロイする
- 同時に複数の既存アプリケーションの更新をデプロイする
- 選択したアプリケーションの夜間または定期的なスケジュール更新をデプロイする
表-7 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