Oracle9i Application Server for HP Tru64 UNIX
リリース・ノート
リリース 1.0.2.2.2
2003 年 4 月
部品番号:
部品番号 J07348-02
このリリース・ノートは、現時点で公表できる最新の情報にもとづいています。このリリース・ノートの
後に明らかになった情報については、通常のサポート情報で入手できます。
Copyright ©2003, Oracle Corporation
All Right Reserved
Oracle と Oracle のロゴは Oracle Corporation の登録商標です。Oracle9i Application Server、Oracle Application Server、Oracle8i、PL/SQL、Oracle Developer's Kit、
Oracle JSP、Oracle Reports、Oracle Forms、Oracle BC4J、Oracle Database Cache、Oracle Portal、Oracle WebDB、
Oracle8i JVM、PL/SQL Gateway は、Oracle Corporation の商標です。記載されているその他の製品名および社名はその製品および会社を識別する目的にのみ使用さ
れており、それぞれ該当する所有者の商標です。
目次
はじめに...................................................................................................................................................... 18
マニュアルに記載されている名称について ........................................................................................ 18
最新情報の入手について..................................................................................................................... 18
第１部 ......................................................................................................................................................... 19
第１章 日本語環境での使用上の注意 ......................................................................................................... 20
ドキュメントの修正および補足事項 ................................................................................................... 20
全体 ............................................................................................................................................ 20
インストレーション・ガイド...................................................................................................... 20
Oracle9iAS Web Cache 管理および配置ガイド.......................................................................... 20
Oracle9iAS Containers for J2EE スタート・ガイド リリース 1.0.2.2........................................ 21
既知の障害および注意事項 ................................................................................................................. 21
Core Edition について ................................................................................................................. 21
インストール時のディスク容量について.................................................................................... 21
Oracle EJE 用のデータベースについて ...................................................................................... 21
インストール時における不要な設定のスキップについて........................................................... 21
Oracle9iAS R1.0.2.1 からの移行に関しての注意点 .................................................................... 22
mod_ose に関する障害 ............................................................................................................... 22
mod_plsql 利用時の日付型の引数に関する障害.......................................................................... 22
サンプル・プログラムについて .................................................................................................. 23
BC4J のサンプル実行手順について ............................................................................................ 23
PL/SQL ゲートウェイの使用について ........................................................................................ 23
Oracle9iAS Containers for J2EE の Servlet で OCI ドライバ使用に関して(Bug#1866890)........ 23
Oracle Wallet Manager 利用に関する制限(Bug#1941090).......................................................... 24
Oracle9iAS を Core Edition/Minimal Edition インストールした場合の Universal Installer 起動問題
(Bug#1974129).................................................................................................................... 24
VALIDATEXML オプションを指定して OC4J を起動できない (Bug#1763194)......................... 24
Oracle SOAP clientenv.csh と clientenv.sh ファイルの修正(Bug#1978217) .............................. 24
OC4J ロード・バランサが不正なメッセージを出力する(Bug#1972747)................................... 24
OC4J ロード・バランサがループしメッセージ・ログを出力し続ける (Bug#1964229)............ 24
OC4J クラスタ化でセッション情報が共有できない(Bug#1951486) .......................................... 25
Oracle9iAS Containers for J2EE のグラフィカル・ツールについて........................................... 25
不正なパケットを受信すると TNS リスナーが異常終了する問題について ................................ 25
ロードバランサを経由した SSL 接続.......................................................................................... 25
Oracle9iAS Containers for J2EE のデータソース設定で反映されない項目
(Bug#1865617,197830)....................................................................................................... 25
Oracle9iAS Containers for J2EE の EJB コンテナ利用時の注意点 ............................................. 25
Oracle9iAS Containers for J2EE におけるステートフル Session Bean のメソッド間でのトランザ
クションの共有についての問題(Bug#1831054).................................................................. 26
Oracle9iAS Containers for J2EE のインストールについて ......................................................... 27
Oracle9iAS SOAP のデフォルト設定におけるセキュリティ上の問題点 .................................... 27
FastCGI（mod_fastcgi）でサポートする開発言語について....................................................... 29
2
Oracle9i Application Server for HP Tru64 UNIXリリース・ノート
Oracle Servlet Engine で getPathInfo()メソッドが使用できない(Bug#2067677)........................ 29
CD Pack に同梱されるパッチの適用について .................................................................................... 29
mod_plsql に関する修正の適用................................................................................................... 29
Oracle HTTP Server に関連した修正の適用 ............................................................................... 29
Oracle9iAS Web Cache R2.0.0.4.0 インストール....................................................................... 30
Oracle Developer R6i Patch13.................................................................................................... 30
Oracle9iAS Portal のインストールについて................................................................................ 30
Oracle JSP 1.1.3.1 のインストール ............................................................................................ 30
Oracle9i Database に JDBC Thin ドライバで接続する際の修正の適用 ...................................... 31
オリジナル・データベースに IBM AIX システムを使用する場合の Database Cache Configuration
Assistant のエラー(Bug#1319688) ...................................................................................... 31
第２部 ......................................................................................................................................................... 32
第２章 Oracle9i Application Server ............................................................................................................ 33
はじめに.............................................................................................................................................. 33
この章の目的...............................................................................................................................33
製品名称変更...............................................................................................................................33
動作保証に関する情報 ........................................................................................................................ 34
JDK/JRE の動作保証................................................................................................................... 34
Java Importer の環境設定............................................................................................................ 35
Oracle Enterprise Manager の動作保証....................................................................................... 35
新機能 ................................................................................................................................................. 35
インターネット・アプリケーションの新機能............................................................................. 35
Oracle9i Application Server Containers for J2EE ................................................................ 35
Oracle HTTP Server powered by Apache ........................................................................... 38
既知の問題点....................................................................................................................................... 43
インストールに関する問題 ......................................................................................................... 43
ロケールの選択 ................................................................................................................... 43
Oracle9i データベースの初期化パラメータの手動設定の必要性 ........................................ 43
Oracle Universal Installer における不正なインストール・ステータスの表示 ..................... 44
インストール時のエラー ..................................................................................................... 44
インストール後に redo ログを開いた際のエラー ............................................................... 44
Standard Edition のキャラクタ・セット ............................................................................. 44
インストール時の root ユーザーのログイン........................................................................ 44
非対話モードのインストール用レスポンス・ファイルの設定ガイド ................................. 44
全インストール・タイプ共通（Minimal Edition、Standard Edition および Enterprise Edition）
.................................................................................................................................... 45
Minimal Edition および Standard Edition インストール・タイプのみ ................................. 46
Standard Edition インストール・タイプのみ ...................................................................... 47
Enterprise Edition インストール・タイプのみ .................................................................... 47
Portal Configuration Assistant のみ（全インストール・タイプ共通）................................ 48
Oracle9iAS Database Cache のインストール時のエラー................................................... 52
Oracle9iAS Database Cache の設定 ................................................................................... 52
同じ Oracle ホームへの再インストール時の Oracle HTTP Server 設定の変更点の保持..... 53
RDBMS パッチのインストール・ダイアログの表示........................................................... 53
目次
3
Oracle Forms、Reports および Discoverer のパッチのインストール................................. 53
openssl の要件 .................................................................................................................... 53
アンインストールおよび移行に関する問題点............................................................................. 54
Oracle Universal Installer を使用した Oracle9iAS Database Cache のアンインストールによ
る依存コンポーネントの削除 ...................................................................................... 54
OraInventory ディレクトリの移行前にバックアップが必要 ............................................... 54
Oracle HTTP Server 起動時のエラー .................................................................................. 54
SOAP のリリース・ノートおよびドキュメントのリンクが機能しない ............................. 54
移行後の nmxw.ora のインスタンス化の必要性.................................................................. 54
Core Edition への Minimal/Standard/Enterprise Edition の上書きインストールでの既知の問
題点 ............................................................................................................................. 55
インターネット・アプリケーション・ソリューションの分野の問題点 ..................................... 55
Oracle HTTP Server powered by Apache ........................................................................... 55
キャッシュ・ソリューション分野の問題点 ................................................................................ 60
Oracle9iAS Database Cache............................................................................................... 60
Web Cache.......................................................................................................................... 61
管理ソリューション分野の問題点............................................................................................... 61
Oracle Enterprise Manager ................................................................................................. 61
例およびデモ....................................................................................................................................... 62
デモの制限事項 ........................................................................................................................... 62
OracleJSP のデモ................................................................................................................ 62
Oracle Business Components for Java のデモのエラー ..................................................... 63
National Language Support（NLS）に関する問題点 ......................................................................... 63
NLS_LANG Environment Variable ...................................................................................... 63
initicache.ora ファイルの NLS パラメータ .......................................................................... 63
NLS の制約事項................................................................................................................... 63
Compaq Tru64 UNIX におけるネットワーク・カードの問題 ............................................................. 64
第３章 Oracle Servlet Engine..................................................................................................................... 65
はじめに.............................................................................................................................................. 65
パラメータ・ファイルの変更.............................................................................................................. 65
ケース 1....................................................................................................................................... 65
ケース 2....................................................................................................................................... 66
第４章 Oracle9iAS Portal ........................................................................................................................... 68
はじめに.............................................................................................................................................. 68
ドキュメント....................................................................................................................................... 68
動作要件.............................................................................................................................................. 68
Oracle9iAS Portal のインストールについて ....................................................................................... 68
PSR30983A 以降を適用時のプロキシ・サーバーの制限.................................................................... 73
ブラウザの設定 ................................................................................................................................... 74
ログインのトラブルシューティング ................................................................................................... 74
Internet Explorer 5 での高度なセキュリティ............................................................................... 74
ドキュメント名の制限 ........................................................................................................................ 74
Oracle9iAS Portal の分散環境での制限............................................................................................... 74
セキュリティ情報付きのインポート/エクスポート ............................................................................ 75
4
Oracle9i Application Server for HP Tru64 UNIXリリース・ノート
Solaris でのインポート/エクスポートの制限 ...................................................................................... 75
フォームの制限 ................................................................................................................................... 75
Oracle Report Security について......................................................................................................... 77
イメージ・チャートの制限 ................................................................................................................. 77
ユーザーの追加、削除について .......................................................................................................... 77
ユーザー・プロファイルの編集について............................................................................................ 78
各国語サポートの制限 ........................................................................................................................ 78
その他の制限....................................................................................................................................... 83
第５章 Oracle Forms Developer and Oracle9iAS Forms Services R6i (Patch13)...................................... 84
はじめに.............................................................................................................................................. 84
この章の目的...............................................................................................................................84
サーバーのライセンス ................................................................................................................ 84
概要 .................................................................................................................................................... 84
コンポーネントのバージョン番号............................................................................................... 84
RSF コンポーネントの追加のバグ修正....................................................................................... 84
日付の扱い .................................................................................................................................. 84
サポートするデータベース ......................................................................................................... 84
使用可能なキャラクタ・セット .................................................................................................. 84
SJIS キャラクタ・セットでの使用 ............................................................................................. 85
確認されている制限 .................................................................................................................... 85
PLL ファイルのアップグレードでのコマンドラインにおける.PLL 拡張子の必要性........... 85
データベース・オブジェクト名における非英数字.............................................................. 85
このリリースと互換性のあるプリコンパイラ............................................................................. 85
UNIX 上の ORAINFONAV_DOCPATH 環境変数 ........................................................................ 85
Oracle File Packager................................................................................................................... 85
同一 ORACLE_HOME へのインストール順序 ............................................................................ 85
Database Admin スクリプトにおける Oracle Translation Builder（OTB）の必要性.................. 85
Unix 上のインストールに必要な追加ステップ............................................................................ 85
TEMPLATES ディレクトリの欠落.............................................................................................. 86
Oracle8i R8.1.6 Server に接続する際の問題............................................................................... 86
Forms-Graphics における Oracle8 R8.0.6 Server への接続の問題 ............................................. 86
データベース・サーバーAgent のアップグレード ...................................................................... 86
Wallet Manager のカスタム・インストールにおける Net8 Assistant の必要性 .......................... 86
Oracle Repository との統合 ........................................................................................................ 87
クライアント・プラットフォームの認定.................................................................................... 87
Intersolve のドライバをアンインストールする場合の警告......................................................... 87
ORACLE_HOME について.......................................................................................................... 87
Oracle Forms Developer クライアント/サーバーコンポーネントの使用前の作業..................... 87
Forms Services の使用................................................................................................................ 87
Windows 2000 への JInitiator のインストール ............................................................................ 88
Project Builder..................................................................................................................................... 88
Form Builder........................................................................................................................................ 88
塗りパターンのパフォーマンスに対する影響............................................................................. 88
ドキュメントに記載されていないエラー・メッセージ（FRM-99999） .................................... 88
目次
5
エラー・メッセージ 1412 と 1413 ...................................................................................... 88
エラー・メッセージ 10905-10909 ...................................................................................... 88
エラー・メッセージ 13009-18010 ...................................................................................... 89
エラー・メッセージ 18117-18121 ...................................................................................... 89
Forms 環境変数の追加 ................................................................................................................ 90
Java キーバインディング API の提供 ......................................................................................... 90
FormAction.java .................................................................................................................. 90
KeyBinder.java - API の使用................................................................................................ 91
KeyBinder.java API の例 ..................................................................................................... 92
Web 上で Run_Product を使用するための要件 .......................................................................... 92
索引構成表の使用........................................................................................................................ 92
Netscape ユーザーのレポート HTML ファイルの保存 ............................................................... 92
Forms-Reports 統合における TMPDIR の非設定 ........................................................................ 92
フォントの変更による Forms の問題.......................................................................................... 93
Oracle Trace Collection の使用 ................................................................................................... 93
HTTPS のサポートとブラウザ JVM............................................................................................ 93
IE での CAB サポートと Java セキュリティ ............................................................................... 93
Java Importer .............................................................................................................................. 93
OEM と Forms 内部処理 ............................................................................................................. 93
Load Balancer Server のトレース・ログ .................................................................................... 93
Oracle9iAS Forms Services 非 SSL リスナーの要件 .................................................................. 93
チャート・ウィザード ................................................................................................................ 93
IE での印刷機能 .......................................................................................................................... 94
og.pll の使用 ................................................................................................................................ 94
Report Builder ..................................................................................................................................... 94
Graphics Builder.................................................................................................................................. 94
Unix 上での必要な環境変数の設定.............................................................................................. 94
Query Builder ...................................................................................................................................... 94
Schema Builder................................................................................................................................... 94
Translation Builder .............................................................................................................................. 94
Procedure Builder ............................................................................................................................... 94
Open Client Adapter............................................................................................................................ 94
各国語サポート ................................................................................................................................... 94
すべての言語で確認されている問題 ........................................................................................... 94
Form Builder のユーザー・インタフェースの不完全な翻訳................................................ 94
一部のウィザード・ボタンのテキストの未翻訳 ................................................................. 95
印刷取消し後のキーボードでのメニュー・アクションの使用不可..................................... 95
FMRWEB.RES の手動構成の必要性 ................................................................................... 95
NLS_LANG パラメータ値に関する情報.............................................................................. 95
Wallet Manager の英語のユーザー・インタフェース ......................................................... 95
ダブルバイト言語で確認されている問題.................................................................................... 96
シングルバイト・フォントでの編集 ................................................................................... 96
日本語で確認されている問題...................................................................................................... 96
JA16EUC キャラクタ・セットの場合のモジュールの保存不可.......................................... 96
6
Oracle9i Application Server for HP Tru64 UNIXリリース・ノート
Windows から UNIX への移行時の長さの制限 .................................................................... 96
PL/SQL エディタの表示の問題 ........................................................................................... 96
UTF8 の制限........................................................................................................................ 96
PL/SQL ライブラリ名におけるマルチバイト・キャラクタ・セットの使用不可 ................ 96
別の prefs.ora ファイルが必要となる場合 .......................................................................... 96
PL/SQL インタプリタのメッセージ・テキストにおける言語の混在 .................................. 97
Unix 上にキュー・カードをインストールするための記憶域の要件.................................... 97
ファイルのオープン、保存時の不具合................................................................................ 97
異なるキャラクタ・セットで作成された OGD ファイルの実行 ......................................... 97
Net8 構成ツールの制限 ....................................................................................................... 97
アラビア語で確認されている問題............................................................................................... 97
UNIX 上でチャートを表示するための制限.......................................................................... 97
その他の問題点 ................................................................................................................................... 98
ドキュメントに関する既知の問題点 ........................................................................................... 98
&Auml タグ.......................................................................................................................... 98
Java Importer のための環境設定 ......................................................................................... 98
Forms アプリケーション Web 利用ガイド.......................................................................... 98
Oracle Developer for Compaq Tru64 UNIX R6i Patch13 の適用......................................................... 98
パッチの適用に関して ................................................................................................................ 98
CD の内容 ................................................................................................................................... 99
インストールに関して ................................................................................................................ 99
アンインストール方法 .............................................................................................................. 100
このパッチで修正される不具合 ................................................................................................ 100
確認されている問題点 .............................................................................................................. 100
Oracle9i Database の NCHAR データ型 ........................................................................... 100
キュー・カードの不正な表示............................................................................................ 100
「デフォルト警告ボタン」プロパティ.............................................................................. 100
異なるフォーム間でライブラリや値を共有する場合 ........................................................ 100
アラートが 2 回表示される ............................................................................................... 100
JInitiator1.3.1.9 を利用した場合に、メッセージが文字化けする ...................................... 101
Oracle Forms Developer 6i Patch10 新機能...................................................................................... 101
タイムゾーンのサポート........................................................................................................... 101
新規プロパティ ......................................................................................................................... 101
POST メソッドと RUN_PRODUCT ビルトインを、もう 1 つの別のフォーム・セッションの起
動に使用する場合.............................................................................................................. 101
Oracle Forms Developer 6i Patch9 新機能........................................................................................ 101
ブラウザ言語の自動検出........................................................................................................... 101
Forms Listener Servlet におけるサーバー側長時間処理に関して ............................................. 101
Oracle Forms Developer 6i Patch8 新機能........................................................................................ 102
パスを指定しない場合の baseHTML および envFile................................................................. 102
formsweb.cfg ファイルの変更 ................................................................................................... 102
Servlet エンジン起動の際の PATH および LD_LIBRARYP_PATH の設定............................... 102
FormsServlet パラメータに関して............................................................................................ 102
Servlet 構成要件の簡略化.......................................................................................................... 102
目次
7
Oracle Forms Developer R6i Patch7 新機能 ..................................................................................... 102
ユーザー/パスワードの非表示................................................................................................... 102
拡張されたシングル・サインオン（SSO）サポート................................................................ 103
Oracle Forms Developer R6i Patch6 新機能 ..................................................................................... 103
拡張されたネットワーク・リジリエンス.................................................................................. 103
Listener サーブレットを使用した、HTTPS モード内での JInitiator の Forms アプリケーション実
行時のパフォーマンスの改善............................................................................................ 104
Oracle Forms Developer R6i Patch4 新機能 ..................................................................................... 104
Forms Listner サーブレットの導入 ........................................................................................... 104
必要条件 ............................................................................................................................ 105
Forms Listener サーブレットについて.............................................................................. 105
Forms Listener サーブレットを使用する理由 ................................................................... 105
より詳細な情報について ................................................................................................... 105
日本語環境での jserv.properties ファイルの修正 ...................................................................... 105
エラーメッセージの追加........................................................................................................... 106
エラー・メッセージ 13009-18010 .................................................................................... 106
Oracle Forms Developer R6i Patch2 新機能 ..................................................................................... 106
Oracle9i Application Server との統合........................................................................................ 106
Forms サーブレット.................................................................................................................. 106
Oracle9i Application Server の Forms Services 用設定ファイルの場所 ............................ 107
f60all_jinit.jar ファイル .............................................................................................................. 107
Internet Explorer 5.0 のサポート ............................................................................................... 107
Java Importer ............................................................................................................................ 107
Dynamic JavaBean Manager .................................................................................................... 107
第６章 Oracle Reports Developer and Oracle9iAS Reports Services R6i (Patch13) ............................... 108
はじめに............................................................................................................................................ 108
この章の目的............................................................................................................................. 108
サーバーのライセンス .............................................................................................................. 108
概要 .................................................................................................................................................. 108
コンポーネントのバージョン番号............................................................................................. 108
RSF コンポーネントの追加のバグ修正..................................................................................... 108
日付の扱い ................................................................................................................................ 108
サポートするデータベース ....................................................................................................... 108
使用可能なキャラクタ・セット ................................................................................................ 108
確認されている制限 .................................................................................................................. 109
データベース・オブジェクト名における非英数字............................................................ 109
このリリースと互換性のあるプリコンパイラ........................................................................... 109
UNIX 上の ORAINFONAV_DOCPATH 環境変数 ...................................................................... 109
Oracle File Packager................................................................................................................. 109
UNIX 上でのヘルプのインストールに必要な追加ステップ....................................................... 109
TEMPLATES ディレクトリの欠落............................................................................................ 109
Database Admin スクリプトにおける Oracle Translation Builder（OTB）の必要性................ 109
Oracle Repository との統合 ...................................................................................................... 109
Oracle8i R8.1.6 Server に接続する際の問題............................................................................. 110
8
Oracle9i Application Server for HP Tru64 UNIXリリース・ノート
クイック・ツアー...................................................................................................................... 110
Forms のアンインストールによるクイック・ツアーの使用不可.............................................. 110
ORACLE_HOME について........................................................................................................ 110
Oracle Reports Developer クライアント/サーバーコンポーネントの使用前の作業 ................ 110
Reports Services の使用 ........................................................................................................... 110
Project Builder................................................................................................................................... 110
初期パラメーターの修正........................................................................................................... 110
Form Builder...................................................................................................................................... 111
Report Builder ................................................................................................................................... 111
新しく追加されたビルトイン・プロシージャ........................................................................... 111
SRW.SET_XML_PROLOG ............................................................................................... 111
SRW.SET_XML_TAG ....................................................................................................... 111
SRW.SET_XML_TAG_ATTR ............................................................................................ 112
REP-3000 エラー・メッセージ................................................................................................. 112
HTML/XML 出力の国際化.......................................................................................................... 112
キャラクタ・セットの識別 ............................................................................................... 112
IANA キャラクタ・セットとそれに対応する Oracle キャラクタ・セット ........................ 113
サポートする PDF のバージョン .............................................................................................. 113
PDF ページの幅の制限.............................................................................................................. 114
Advanced Networking Option.................................................................................................... 114
Microsoft IE4 と PDF で確認されている問題 ............................................................................ 114
Netscape と HTMLCSS 出力の問題 .......................................................................................... 114
Reports と Graphics の統合 ...................................................................................................... 114
データ・モデルの制限 .............................................................................................................. 114
Reports と Oracle OLAP Server のバージョン ......................................................................... 114
Reports と OLAP Server のための Oracle8 Server の要件........................................................ 114
Report Builder と OLAP Server の統合 ..................................................................................... 115
.ORA ファイルの構成........................................................................................................ 115
Express Oracle8 コンポーネントの Oracle8 8.0.6 ORACLE_HOME へのインストール .. 115
Express ディメンション・ソート − 6.0 レポートの要件 ............................................... 116
OLAP Server からのレポート作成時のエラーORA-28575 ............................................... 116
Reports と OLAP Server の統合の制限 ..................................................................................... 116
レイアウト・モデルの制限 ....................................................................................................... 116
Web ウィザード ........................................................................................................................ 117
バージョンの混合...................................................................................................................... 117
V1-V2-V8 変換:PLSQL V2 の予約語の置換え ........................................................................... 117
レポートの幅と高さのプロパティの場所.................................................................................. 117
NULL チャート列の問題............................................................................................................ 117
クラスタ化とクラスタ構成 ....................................................................................................... 117
ドキュメントに記載されていないサーバー構成パラメータ ..................................................... 118
デバッグの中止 ......................................................................................................................... 118
ランタイム・カスタマイズのための JRE の要件...................................................................... 118
PLSQL エディタ:DE_PREFS_TABSIZE によるタブ・サイズの設定 ....................................... 118
R6i より前に作成された HTML パラメータ・フォームへの行追加の必要性 ............................ 118
目次
9
フィールド・タグでの幅属性の使用 ......................................................................................... 119
ランタイム・カスタマイズの特別な文字.................................................................................. 119
レポートを DESTYPE=MAIL に送る場合の失敗....................................................................... 119
Internet Explorer の認証ウィンドウの反復................................................................................ 119
Tru64 UNIX 上の Reports Web CGI と Apache Web Server..................................................... 119
UNIX 上の Reports サーブレットからのエラー500 .................................................................. 120
Oracle9iAS Reports Services エラー ........................................................................................ 120
チャート・ウィザード .............................................................................................................. 120
Graphics Builder................................................................................................................................ 120
Unix 上での必要な環境変数の設定............................................................................................ 120
Query Builder .................................................................................................................................... 120
Schema Builder................................................................................................................................. 120
Translation Builder ............................................................................................................................ 120
Procedure Builder ............................................................................................................................. 121
Open Client Adapter.......................................................................................................................... 121
各国語サポート ................................................................................................................................. 121
すべての言語で確認されている問題 ......................................................................................... 121
Report Builder のユーザー・インタフェースの不完全な翻訳 ........................................... 121
左から右のみの PDF 形式レポート ................................................................................... 121
一部のウィザード・ボタンのテキストの未翻訳 ............................................................... 121
ダブルバイト言語で確認されている問題.................................................................................. 121
シングルバイト・フォントでの編集 ................................................................................. 121
日本語で確認されている問題.................................................................................................... 121
JA16EUC キャラクタ・セットの場合のモジュールの保存不可........................................ 121
Windows から UNIX への移行時の長さの制限 .................................................................. 122
PL/SQL エディタの表示の問題 ......................................................................................... 122
PL/SQL ライブラリ名におけるマルチバイト・キャラクタ・セットの使用不可 .............. 122
XML ファイルからのレポートにおける非 ASCII フォント名の使用不可 .......................... 122
別の prefs.ora ファイルが必要となる場合 ........................................................................ 122
PL/SQL インタプリタのメッセージ・テキストにおける言語の混在 ................................ 122
Unix 上にキュー・カードをインストールするための記憶域の要件.................................. 122
異なるキャラクタ・セットで作成された OGD ファイルの実行 ....................................... 123
Oracle9iAS Reports Services エラーメッセージの表示.................................................... 123
ファイルのオープン、保存時の不具合.............................................................................. 123
Net8 構成ツールの制限 ..................................................................................................... 123
アラビア語で確認されている問題............................................................................................. 123
UNIX 上でチャートを表示するための制限........................................................................ 123
その他の問題点 ................................................................................................................................. 124
ドキュメントに関する既知の問題点 ......................................................................................... 124
&Auml タグ........................................................................................................................ 124
デモ・テーブルを作成するスクリプト.............................................................................. 124
レポート Web 公開ガイド ................................................................................................. 124
Oracle9iAS Reports Services サーバーでの X Window セッションの要件 ............................... 124
Oracle Developer for Compaq Tru64 UNIX R6i Patch13 の適用....................................................... 124
10
Oracle9i Application Server for HP Tru64 UNIXリリース・ノート
確認されている問題点 .............................................................................................................. 124
Oracle9i Database の NCHAR データ型 ........................................................................... 124
reports60.csh(reports60.sh)の修正.................................................................................... 125
キュー・カードの不正な表示............................................................................................ 125
Oracle Reports Developer R6i Patch2 新機能................................................................................... 125
Oracle Reports セキュリティ.................................................................................................... 125
Oracle9iAS Portal.............................................................................................................. 125
拡張集約操作および分析関数.................................................................................................... 125
ランキング・ファミリ....................................................................................................... 126
ウィンドウ集約ファミリ ................................................................................................... 126
レポート集約ファミリ....................................................................................................... 126
LAG および LEAD ファミリ .............................................................................................. 126
第７章 Oracle9i Application Server への EJB の配置 ............................................................................... 128
はじめに............................................................................................................................................ 128
この章の目的............................................................................................................................. 128
トランザクションのための Oracle 固有要素の定義.......................................................................... 128
トランザクションへのローカル・リソース参加の定義 ............................................................ 128
2 フェーズ・コミット・エンジンの定義................................................................................... 129
トランザクション内のブランチの使用可能化........................................................................... 129
コンテナ管理の永続性の定義............................................................................................................ 130
Oracle 固有の DTD の変更 ................................................................................................................ 130
Oracle9i Application Server 環境でのグローバル・トランザクション...................................... 131
第８章 Oracle9iAS Database Cache........................................................................................................ 133
はじめに............................................................................................................................................ 133
この章の目的............................................................................................................................. 133
Oracle9iAS Database Cache の既知の問題点および制限事項 ......................................................... 133
Cache Manager の既知の問題点および制限事項.............................................................................. 136
Oracle9iAS Database Cache Configuration Assistant を使用する際の Net8 設定ファイルについて 137
Oracle9iAS Database Cache の tnsnames.ora の設定について ....................................................... 137
インストール中の Oracle9iAS Database Cache 構成ツールの不正な表示(Bug#1791035) ............. 138
Oracle9iAS Database Cache Configuration Assistant の"Detail"ボタンについて.............................. 138
DB Cache Configuration Assistant で WTE-03802 のエラー (Bug#1877274) .................................. 138
Oracle9iAS Database Cache のパフォーマンスモニター表示に関する障害 ................................... 138
Oracle9iAS Database Cache Manager のヘルプ文字化けについて(Bug#1973932)......................... 139
SQL*Plus からの Oracle9iAS Database Cache 使用について .......................................................... 139
索引つきの表のキャッシュについて ................................................................................................. 139
Oracle9iAS Database Cache の PL/SQL プログラムの例外処理に対する動作 ................................ 139
Oracle9iAS Database Cache のキャッシュ管理 API に関する制限(Bug#1834097) ......................... 139
Oracle9iAS Database Cache でサポートされないコンポーネント .................................................. 139
第９章 Oracle9iAS Web Cache................................................................................................................ 141
はじめに............................................................................................................................................ 141
この章の目的............................................................................................................................. 141
Oracle9iAS Web Cache のバージョン ...................................................................................... 141
目次
11
Oracle9iAS Web Cache の構成......................................................................................................... 141
Oracle9iAS Web Cache の制限事項.................................................................................................. 142
HTTP Range リクエストとマルチパートのレスポンス ............................................................ 142
パーソナライズ・ページ........................................................................................................... 142
Oracle9iAS Web Cache Manager での不十分な入力チェック.................................................. 142
Web サーバー・ステータスの報告 ........................................................................................... 142
Admin Server への IP アクセス ................................................................................................. 143
Netscape の制限事項 ........................................................................................................................ 143
ファイル記述子の制限事項 ............................................................................................................... 143
TCP のチューニング ......................................................................................................................... 143
Oracle9iAS Web Cache のデフォルト・ポート................................................................................ 144
Oracle9iAS Web Cache 使用法の例.................................................................................................. 145
1024 以下のポートをリスニングするための Oracle9iAS Web Cache の構成方法 ........................... 145
Oracle9iAS Web Cache Manager の administrator パスワード紛失について ................................... 145
Oracle9iAS Web Cache のキャッシュルール設定時の注意.............................................................. 145
Oracle9iAS Web Cache キャッシュ失効機能について(Bug#1972673) ............................................ 146
Oracle9iAS Web Cache でサポートされないコンポーネント .......................................................... 146
Basic 認証を必要とするページのキャッシュ指定について .............................................................. 146
拡張機能............................................................................................................................................ 146
バージョン 1.0.2.1.0 の拡張機能 ............................................................................................. 146
watchdog 機能 ................................................................................................................... 146
Web Cache Manager を使用して、アクセスのロギングを使用不可にすることが可能.... 146
イベント・ログは、オプションで冗長モードをサポート ................................................. 146
バージョン 1.0.2.3.0 の拡張機能............................................................................................... 146
バージョン 2.0.0.1 の拡張機能.................................................................................................. 147
キャッシュされたオブジェクトの TOP100 のリスト ....................................................... 147
キャッシュされたコンテンツのリスト.............................................................................. 147
Oracle9iAS Web Cache の Watchdog 機能 ....................................................................... 148
キャッシュのヒット/ミス .................................................................................................. 149
リスニングの保留/再開...................................................................................................... 149
第１０章 Oracle Enterprise Manager ....................................................................................................... 151
はじめに............................................................................................................................................ 151
インストール............................................................................................................................. 151
互換性一覧 ........................................................................................................................................ 151
データベースの互換性 .............................................................................................................. 151
Intelligent Agent と Oracle Server ............................................................................................. 151
Enterprise Manager リリースと Intelligent Agent...................................................................... 152
Enterprise Manager 製品と Management Server / リポジトリ ................................................ 152
Oracle Enterprise Manager ............................................................................................................... 152
新機能 ....................................................................................................................................... 152
Enterprise Manager コンソール ........................................................................................ 152
パフォーマンスの向上....................................................................................................... 153
Apache Web サーバーおよび Apache for iAS Web サーバーのサポート.......................... 153
12
Oracle9i Application Server for HP Tru64 UNIXリリース・ノート
ジョブ・システムおよびイベント・システム................................................................... 153
拡張通知 ............................................................................................................................ 153
エンタープライズ・レポート............................................................................................ 153
DBA Studio........................................................................................................................ 154
OMS チューニング用パラメータ ...................................................................................... 154
Intelligent Agent バージョン 8.1.7 ..................................................................................... 154
コンソール ................................................................................................................................ 155
イベント・システムおよびジョブ・システム........................................................................... 155
グループ.................................................................................................................................... 157
ポケットベルおよび電子メールのブラックアウト.................................................................... 157
DBA Management Pack ............................................................................................................157
Oracle Management Server（OMS） ....................................................................................... 158
Enterprise Manager Configuration Assistant ............................................................................. 159
Enterprise Manager Migration Assistant.................................................................................... 159
ブラウザベースの Enterprise Manager ..................................................................................... 159
統合アプリケーション .............................................................................................................. 160
Oracle interMedia Text Manager ....................................................................................... 160
Oracle Forms Server Manager .......................................................................................... 160
Oracle Enterprise Security Manager.................................................................................. 160
Oracle Parallel Server Manager ........................................................................................ 161
その他 ....................................................................................................................................... 161
既知の問題点..................................................................................................................................... 161
コンソールに関する問題........................................................................................................... 161
グループパネル ................................................................................................................. 161
ジョブ・システムとイベント・システム .......................................................................... 161
DBA Management Pack に関する問題...................................................................................... 162
第１１章 Oracle9iAS Wireless ................................................................................................................. 163
はじめに............................................................................................................................................ 163
この章の目的............................................................................................................................. 163
ライセンス ................................................................................................................................ 163
『Oracle9i Application Server for UNIX インストレーション・ガイド』の訂正 .............................. 163
Oracle9iAS Wireless の設定の検証 ........................................................................................... 164
jserv.conf ファイルの ApJServGroupMount エントリの例........................................................ 164
新機能 ............................................................................................................................................... 164
JDK/JRE の動作保証........................................................................................................................ 164
Oracle9iAS Wireless クライアント・ツールのサポート OS............................................................. 164
Oracle9iAS Wireless クライアント・ツールの CPU 要件................................................................. 164
Oracle9iAS Wireless 1.1.1 ................................................................................................................ 164
Oracle9iAS Wireless のアップグレード............................................................................................ 164
JServ.conf への追加点 ...................................................................................................................... 165
Oracle9iAS Wireless の再インストール............................................................................................ 165
Oracle9i Application Server Wireless サーバー・インストレーション ............................................. 165
インストール・オプション ....................................................................................................... 165
非対話モードのインストールの非サポート .............................................................................. 165
目次
13
データベース接続...................................................................................................................... 166
接続可能な Oracle データベース............................................................................................... 166
Oracle 9.0.1 に接続するための作業 .......................................................................................... 166
Oracle9i Application Server インストール後の設定 .................................................................. 166
Oracle9iAS Wireless クライアント・インストレーション ............................................................... 168
Oracle9iAS Wireless クライアントのセットアップの準備 ....................................................... 168
Oracle9iAS Wireless Service Designer のセットアップ ........................................................... 168
Oracle9iAS Wireless Web Integration Developer のセットアップ ............................................ 169
Oracle9iAS Wireless クライアント・ツールのプログラム・フォルダの位置........................... 170
システム Logger................................................................................................................................ 170
追加設定の必要性...................................................................................................................... 171
データベース Logger の開始手順 .............................................................................................. 172
Oracle9iAS Wireless 用の複数の VM のセットアップ ...................................................................... 172
Oracle9iAS Wireless インスタンスのプロパティ設定について ........................................................ 173
既知の制限事項と制約事項 ............................................................................................................... 177
JDBC ドライバ.......................................................................................................................... 177
ブートストラップ・リポジトリの Provisioning Service ........................................................... 177
位置情報サービス...................................................................................................................... 178
メール・アダプタ...................................................................................................................... 178
メール・アダプタからのメールのヘッダ情報に日本標準時間以外が設定されている .............. 178
メール・アダプタのローカライゼーションの注意事項 ............................................................ 178
Web Integration アダプタの文字コード設定 ............................................................................. 178
SQL アダプタ・マスター・サービス ........................................................................................ 178
SQL アダプタを使用した半角カナデータの取得について ........................................................ 179
SQL アダプタの出力結果のキャプション ................................................................................. 179
URL アダプタの文字コード設定について ................................................................................. 179
ストリッパ・アダプタにおける文字コード設定 ....................................................................... 179
ストリッパ・アダプタの外部サイトへのアクセス.................................................................... 179
LDAP アダプタのログオンについて ......................................................................................... 179
LDAP アダプタの日本語使用について ...................................................................................... 179
Servlet アダプタの未サポートについて .................................................................................... 179
トランスフォーマ...................................................................................................................... 180
Compact HTML トランスフォーマのサポートについて............................................................ 180
HDML トランスフォーマのサポートについて .......................................................................... 180
KDDI au/Tu-Ka EZweb 用ロジカル・デバイスの設定事項 ....................................................... 180
SMS への対応 ........................................................................................................................... 181
プッシュ型通知機能(アラート) ................................................................................................. 181
プッシュ型通知機能(アラート)の作成について ........................................................................ 181
ptg/rm からのアラートアドレスの変更が正常に行われない ..................................................... 181
アラート作成時のアラートアドレスのデフォルト表示について .............................................. 181
デバイス（ブラウザ、DoCoMo）からのアラートアドレス作成で EMAIL を選択しても、再度ペ
ージを表示すると SMS になってしまう ........................................................................... 181
デバイス（UP.SDK、J-PHONE）からのアラートアドレス割り当てで EMAIL を選択しても、再
度ページを表示すると空になってしまう .......................................................................... 182
14
Oracle9i Application Server for HP Tru64 UNIXリリース・ノート
アラートメールのヘッダ情報に日本標準時間以外が設定されている場合がある ..................... 182
プッシュ型通知機能(アラート)の開始時刻が 13 時間遅れて表示される .................................. 182
デバッグ.................................................................................................................................... 182
Oracle9iAS Wireless Web Integration Server の Shutdown でエラーが発生する ..................... 182
Oracle9iAS Wireless Web Integration Developer：起動時の Java エラー ................................ 182
Oracle9iAS Wireless Web Integration Developer：文字入力時の注意...................................... 183
Oracle9iAS Wireless Web Integration Developer：WIDL 作成時における日本語使用.............. 183
Oracle9iAS Wireless Web Integration Developer：日本語変数名の使用について .................... 183
Oracle9iAS Wireless Web Integration Developer：正規表現の未サポートについて ................ 183
Oracle9iAS Wireless Web Integration Server：正規表現の未サポートについて ...................... 183
Oracle9iAS Wireless Service Designer：文字コード設定......................................................... 183
Oracle9iAS Wireless Service Designer：EMAIL ロジカル・デバイスの文字コード ................ 183
Oracle9iAS Wireless Service Designer：テスト・ウィザード.................................................. 183
Oracle9iAS Wireless Service Designer：Transformer Testing Tool.......................................... 183
Oracle9iAS Wireless Service Designer：Transformer Testing Tool でのエラー....................... 184
Oracle9iAS Wireless Service Designer：Transformer Testing Tool における実行 URI ............ 184
Oracle9iAS Wireless Service Designer：Transformer Testing Tool でのサービスのテストで文字
化けが発生する ................................................................................................................. 184
Oracle9iAS Wireless Service Designer：フォルダ内容の表示.................................................. 184
Oracle9iAS Wireless Service Designer：エイリアス作成ウィザード....................................... 184
Oracle9iAS Wireless Service Designer：XSLT エディタでの日本語入力................................. 184
Oracle9iAS Wireless Service Designer：追加された新規の検索/ソート機能 ........................... 184
Oracle9iAS Wireless Service Designer：Disp.Name に半角かなを使用しているユーザ名が登録さ
れているとユーザー検索で全くヒットしない................................................................... 184
Oracle9iAS Wireless Service Designer：ロジカルデバイス→PAPZ エンコーディングを SJIS に
変更すると HTML ソースが壊れてタグが表示されてしまう............................................. 185
Oracle9iAS Wireless Service Designer：大きな XML ファイルのロード・エラー ................... 185
Oracle9iAS Wireless Service Designer：Master Service Creation Wizard : Name フィールドに１
文字の文字列が使用できない............................................................................................ 185
Personalization Portal：PAPZ ベースの Personalization Portal のサポート ............................. 185
Personalization Portal:ログイン後の画面で HELP を参照できない .......................................... 185
Personalization Portal：ブックマーク ...................................................................................... 185
Personalization Portal：イメージの表示................................................................................... 186
Personalization Portal：アラート・アドレスの一意制約違反................................................... 186
Personalization Portal：マスター・サービスでのアラート ...................................................... 186
Personalization Portal：サービス実行時の権限 ........................................................................ 186
Personalization Portal：LocalStrings.properties の翻訳後のイメージ表示 ............................... 186
Personalization Portal：オブジェクトの順序変更で JAVA エラーが発生することがある........ 186
Personalization Portal：フォルダの削除で JAVA エラーが発生することがある ...................... 187
Personalization Portal：サービスのコピーでコピー先のフォルダが'−'(全角ハイフン)という名称
だとコピーに失敗する....................................................................................................... 187
LocalStrings.properties の翻訳 .................................................................................................. 187
SystemLog.enableServiceLogging パラメータについて........................................................... 187
sys_panama.log ファイルのタイムスタンプが 13 時間遅れている .......................................... 187
第１２章 Edge Side Includes の JESI タグ .............................................................................................. 188
目次
15
Edge Side Includes テクノロジおよび処理の概要 ............................................................................ 188
Edge Side Includes テクノロジ......................................................................................................... 188
ESI の概要................................................................................................................................. 188
サロゲートについて .................................................................................................................. 189
主要な ESI 機能......................................................................................................................... 189
Oracle9iAS Web Cache および ESI プロセッサ ............................................................................... 189
Oracle9iAS Web Cache の概要................................................................................................. 189
Web Cache 使用方法のステップ .............................................................................................. 190
Oracle9iAS Web Cache ESI プロセッサ ................................................................................... 190
JESI 機能の概要........................................................................................................................ 190
JESI タグを使用する理由.......................................................................................................... 190
OracleJSP によって実装される JESI タグの概要..................................................................... 191
JESI 使用方法モデル......................................................................................................................... 191
control/include モデル................................................................................................................ 192
template/fragment モデル.......................................................................................................... 192
JESI include に関する注意 ........................................................................................................ 192
ページの失効化 ................................................................................................................................. 193
ページのパーソナライズ................................................................................................................... 193
OracleJSP JESI タグの説明.............................................................................................................. 193
構文における記号の表記および注意事項.......................................................................................... 193
ページの設定およびコンテンツ・タグの説明........................................................................... 194
ページの設定および使用方法モデルの要約 .............................................................................. 194
JESI control タグ....................................................................................................................... 194
構文 .................................................................................................................................. 195
属性 .................................................................................................................................. 195
JESI include タグ ...................................................................................................................... 195
構文 .................................................................................................................................. 195
属性 .................................................................................................................................. 196
例−control/include モデル ........................................................................................................ 196
例 1: control/include........................................................................................................... 196
例 2: control/include........................................................................................................... 196
例 3: control/include........................................................................................................... 197
例 4: control/include........................................................................................................... 197
JESI template タグ.................................................................................................................... 198
構文 .................................................................................................................................. 198
属性 .................................................................................................................................. 199
JESI fragment タグ ................................................................................................................... 199
構文 .................................................................................................................................. 199
属性 .................................................................................................................................. 199
例−template/fragment モデル................................................................................................... 199
例 1: template/fragment ..................................................................................................... 199
例 2: template/fragment ..................................................................................................... 200
ページの失効化タグおよびサブタグの説明 ...................................................................................... 200
16
Oracle9i Application Server for HP Tru64 UNIXリリース・ノート
JESI invalidate タグ .................................................................................................................. 201
構文 .................................................................................................................................. 201
属性 .................................................................................................................................. 201
例: 構成ファイル............................................................................................................... 202
JESI object サブタグ................................................................................................................. 202
構文 .................................................................................................................................. 202
属性 .................................................................................................................................. 202
JESI cookie サブタグ ................................................................................................................ 203
構文 .................................................................................................................................. 203
属性 .................................................................................................................................. 203
JESI header サブタグ ............................................................................................................... 203
構文 .................................................................................................................................. 203
属性 .................................................................................................................................. 203
例−ページの失効化 .................................................................................................................. 203
例 1: ページの失効化 ........................................................................................................ 203
例 2: ページの失効化 ........................................................................................................ 204
例 3: ページの失効化 ........................................................................................................ 204
例 4: ページの失効化 ........................................................................................................ 204
例 5: ページの失効化 ........................................................................................................ 205
ページのパーソナライズ・タグの説明 ............................................................................................. 205
JESI personalize タグ ............................................................................................................... 205
構文 .................................................................................................................................. 205
属性 .................................................................................................................................. 205
例−ページのパーソナライズ.................................................................................................... 205
JESI タグ処理および JESI から ESI への変換 .................................................................................. 206
OracleJSP JESI タグ・ライブラリ記述ファイル.............................................................................. 206
目次
17
はじめに
マニュアルに記載されている名称について
Oracie9i Application Server 関連マニュアルは、英語版を翻訳しているため、マニュアル内で参照されてい
る情報には、日本では提供されていないものも含まれます。
インターネット URL
マニュアル名
ソフトウェア名
最新情報の入手について
日本オラクルでは、インターネット開発者向けのあらゆる技術リソースを、24 時間 365 日提供するコミュ
ニティ・サイト OTN-J（Oracle Technology Network Japan）を運営しています。
OTN-J では、最新の技術情報、オンライン・マニュアル、ソフトウェア・コンポーネントなどを、無料で
入手できます。
http://otn.oracle.co.jp/
また、最新のセキュリティ情報については、以下のサイトを参照して下さい。
http://otn.oracle.co.jp/security/
18
Oracle9i Application Server for HP Tru64 UNIXリリース・ノート
第１部
はじめに
19
第１章 日本語環境での使用上の注意
ドキュメントの修正および補足事項
全体
本リリースでは、以下の機能はサポートされません。よって、以下の機能に関するドキュメント上の関連
記述も一切無効です。インストールされる関連ファイルやツールのご利用もサポートされません。
Oracle Internet File System
Oracle9iAS Object Cache for Java
Oracle9iAS Discoverer
Oracle Internet Directory
Oracle Workflow
Oracle9iAS InterConnect
Oracle9iAS Email
Oracle9iAS Unified Messaging
インストレーション・ガイド
P.2-3 の表 2-1 は、各インストール・オプションでインストールされるコンポーネントを意味します。本リ
リースでサポートされる機能を示す表ではありませんので、ご注意ください。
P3-26, P4-30, P5-36 に記載されている「JSP の設定」については作業の必要はありません。「JSP の設定」
に記載されてる"wrapper.classpath"は存在しません。
Oracle9iAS Web Cache 管理および配置ガイド
管理および配置ガイド
マニュアル「Oracle9iAS Web Cache 管理および配置ガイド リリース 2.0.0」のページ B-2 に、最大受信接続
数の初期値は 1,000 と記載されていますが、正しくは 900 です。(Bug#1966582)
また、ページ 5-15 の項目「6.「Submit」を選択します。」の直前には、以下の記述が追加されます。「注
意:統計モニター・リクエストで HTTPS を使用可能にした場合、Oracle Web Cache Manager のインターフェ
ースを使用して統計モニター・リクエストを送信できません。」
失効管理者ユーザーinvalidator のデフォルトパスワードは、次の箇所にて invalidator と記述されています。
P.5-31
P.B-1
P.E-7
正しいデフォルトパスワードは、invalidator ではなく、administrator です。(Bug#1973676)
マニュアル「Oracle9iAS Web Cache 管理および配置ガイド リリース 2.0.0」のページ 5-12 には必要とされ
るファイル・ディスクリプタ数に関する説明がありますが、以下のように訂正します。
20
【誤】
Max_File_Desc = Current_Max_Conn + App_Web_Server_Capacity_Sum + 20
【正】
Max_File_Desc = Current_Max_Conn + App_Web_Server_Capacity_Sum + 50
Oracle9i Application Server for HP Tru64 UNIXリリース・ノート
【誤】
20 は、Oracle9iAS Web Cache の内部使用のために確保されている接続数です。
【正】
50 は、Oracle9iAS Web Cache の内部使用のために確保されている接続数です。
Oracle9iAS Containers for J2EE スタート・ガイド リリース 1.0.2.2
マニュアル「Oracle9iAS Containers for J2EE スタート・ガイド リリース 1.0.2.2」の 13 ページに｢OC4J は、
Sun Microsystems JDK バージョン 1.2.2_07 の tools.jar ファイルと共にインストールされます。｣と記載され
ていますが､実際に OC4J にインストールされている tools.jar ファイルは、Sun Microsystems JDK バージョ
ン 1.3.1-beta のものです。
既知の障害および注意事項
Core Edition について
本リリースでは、インストレーション・ガイドに記載されているインストール・オプションの他に Core
Edition でのインストールが可能です。Core Edition でインストールを行った場合、次のコンポーネントがイ
ンストールされます。
Oracle HTTP Server
Oracle Business Components for Java
Oracle9iAS Containers for J2EE
Oracle9iAS Web Cache
Oracle9iAS Containers for J2EE は Core Edition を選択した場合のみインストールされます。Oracle9iAS
Containers for J2EE と、Minimal/Standard/Enterprise Edition に含まれる機能を併せて使用する場合は、
Minimal/Standard/Enterprise Edition のインストールの後に Core Edition のインストールを実行してください。
インストール時のディスク容量について
インストール時のディスク容量について
製品のインストール時にはインストレーションガイド P.1-2 に記載されているディスク領域よりも多くの
ディスク領域を必要とします。ORACLE_HOME に以下の空きディスク領域が必要です。
Core Edition
866MB
Minimal Edition
1.12GB
Standard Edition
2.88GB
Enterprise Edition
6.29GB
Oracle EJE 用のデータベースについて
Enterprise Edition としてインストールした場合、Oracle EJE として利用するためのデータベースは作成され
ません。Oracle EJE をご利用の際には、Oracle Database Configration Assistant などにより、新規で Oracle EJE
用のデータベースを作成してください。
インストール時における不要な設定のスキップについて
インストール中に、Oracle9iAS Portal と Oracle9iAS Wireless に関する設定を入力する画面が現われます。
Oracle9iAS Portal は、本リリースでは Patch CD-ROM を適用するため、各項目はデフォルト値のまま「次へ」
ボタンをクリックして下さい。詳細については「Oracle9iAS Portal のインストールについて」を参照して
下さい。また、Oracle9iAS Wireless をインストールしない場合もこれらの設定を無視して構いません。空白
もしくは仮の値を入力して、インストールを先に進めてください。上記の対処によって、幾つかの設定を
スキップした場合、インストール中にインストーラー（runInstaller ）を起動したコンソール画面に、以下
のようなエラーが出力されます。しかし、これらは Oracle9iAS Wireless の設定をスキップしたために発生
したエラーなので、無視して構いません。
第１章 日本語環境での使用上の注意
21
<prompt%> /cdrom/9i_appserver_disk1/runInstaller
<prompt%> Initializing Java Virtual Machine from
/tmp/OraInstall/jre/bin/jre.
Please wait...
SQL*Plus: Release 8.1.7.0.0 - Production on Tue Dec 5 11:44:56 2000
(c) Copyright 2000 Oracle Corporation. All rights reserved.
Enter user-name: ERROR:
ORA-12545: Connect failed because target host or object does not exist
Enter user-name: SP2-0306: Invalid option.
Usage: CONN[ECT] [logon] [AS {SYSDBA|SYSOPER}] | [INTERNAL]
where <logon> ::= <username>[/<password>][@<connect_string>] | /
Enter user-name: Enter password:
ERROR:
ORA-12545: Connect failed because target host or object does not exist
SP2-0157: unable to CONNECT to ORACLE after 3 attempts, exiting SQL*Plus
Oracle9iAS R1.0.2.1 からの移行に関しての注意点
Oracle9iAS R1.0.2.1 から Oracle9iAS R1.0.2.2 への移行の際には<Oracle_Home>/Apache/Apache/conf 内の
Apache 設定ファイルが更新されます。移行前の設定ファイルが<Oracle_Home>/Apache/Apache/conf 以外に
配置されていた場合や、移行後に 1.0.2.1 で使用していた設定ファイルを上記ディレクトリに配置する場合
は、移行後に次の変更を行なって下さい。
移行後に使用する httpd.conf の最後に以下二行を追加して下さい。
LoadModule oprocmgr_module
libexec/liboprocmgr.so
AddModule mod_oprocmgr.c
mod_ose に関する障害
Oracle HTTP Server では、
$ORACLE_HOME/Apache/Apache/conf/mod__ose.conf
の中で、
SetHandler aurora-stateless-server
と設定された URL を呼び出すと、ブラウザの画面に表示されるコンテンツの先頭にそのサイズが表示され
ることがあります。
SetHandler aurora-server
と設定することで、この問題を回避してください。
mod_plsql 利用時の日付型の引数に関する障害
mod_plsql を使用してデータベースのストアド・プログラムを呼び出す時に、日付型の引数のフォーマット
が正しく解釈されない場合があります。この不具合は将来のリリースで修正されます。現在のリリースで
この問題を回避するためには、以下の作業を行って下さい。
1.
22
SYS ユーザーでデータベースに接続し、以下のコマンドを実行し、ストアド・プロシージャを作成し
ます。日付書式フォーマットは、必要に応じて変更します。
Oracle9i Application Server for HP Tru64 UNIXリリース・ノート
create or replace procedure fix_date_format is
begin
DBMS_SESSION.SET_NLS('NLS_DATE_FORMAT','''YYYY-MM-DD''');
end;
/
2.
以下のコマンドを実行して、1.で作成したストアド・プロシージャを全ユーザーより実行可能にしま
す。
grant execute on fix_date_format to public;
3.
Oracle HTTP Server を停止します。
prompt>$ORACLE_HOME/Apache/Apache/bin/apachectl stop
4.
以下のファイルを編集し、各 DAD の before_proc 項目を以下のように変更します。
$ORACLE_HOME/Apache/modplsql/cfg/wdbsvr.app
<変更前> ;before_proc =
<変更後> before_proc = sys.fix_date_format
5.
最後に、Oracle HTTP Server を再起動します。
prompt>$ORACLE_HOME/Apache/Apache/bin/apachectl start
サンプル・プログラムについて
本リリースに添付されているサンプル・プログラムは、動作保証されたものではありません。
BC4J のサンプル実行手順について
サンプルを実行する際のセットアップ手順が書かれている$ORACLE_HOME/Apache/htdocs/createtables.html
に誤りがあります。
(誤) 2. Locating the ImageLoader.java at
OracleHome/Apache/BC4J/samples/OnlineOrders/DatabaseSetup/Imageloader
(正) 2. Locating the ImageLoader.java at
OracleHome/Apache/BC4J/samples/onlineorders/DatabaseSetup/ImageLoader
PL/SQL ゲートウェイの使用について
Oracle9iAS Portal の環境が構築されていない場合、「Service Temporarily Unavailable」と表示されて PL/SQL
ゲートウェイ管理画面が利用できません。以下の手順でこの現象を回避できます。
$ORACLE_HOME/Apache/modplsql/cfg/wdbsvr.app
をテキストエディタで開きます。
[DAD_portal30]セクションの以下の行を変更します。
(変更前)enablesso
= Yes
(変更後)enablesso
= No
この設定を行った場合、誰でも管理画面にアクセスが可能になります。運用時にはセキュリティ上、管理
画面を保護する必要がありますので「Oracle9i Application Server PL/SQL ゲートウェイの使用」の「基本
(Basic)認証による管理ページの保護」を参照のうえ管理画面を保護してください。
Oracle9iAS Containers for J2EE の Servlet で OCI ドライバ使用に関して
(Bug#1866890)
Oracle9iAS Containers for J2EE の Servlet で OCI ドライバを使用する場合、次のステップで JDBC ライブラ
リを置き換えてから使用してください。
<OC4J_HOME>/lib/classes12.jar を削除します。
第１章 日本語環境での使用上の注意
23
$ORACLE_HOME/jdbc/lib/classes12.zip を<OC4J_HOME>/lib にコピーします。
Oracle Wallet Manager 利用に関する制限(Bug#1941090)
利用に関する制限
Oracle9iAS に付属しています Oracle Wallet Manager は利用できません。
Oracle9iAS を Core Edition/Minimal Edition インストールした場合の Universal
Installer 起動問題(Bug#1974129)
起動問題
Minimal Edition インストールした場合、runInstaller コマンドが$ORACLE_HOME/bin に存在いたしません。
次のコマンドを実行して、シンボリックリンクを作成してください。
ln -s $ORACLE_BASE/oui/install/runInstaller.sh $ORACLE_HOME/bin/runInstaller
Core Edition インストールの場合は、Universal Installer は CD-ROM より起動して下さい。
VALIDATEXML オプションを指定して OC4J を起動できない (Bug#1763194)
デフォルトでインストールされた server.xml を使用して、VALIDATEXML オプション付きで OC4J サーバ
ーを起動すると、以下のエラーで起動できません。
Error initializing server: Error at line 28: Element
"application-server" does not allow "library" here.
この場合 VALIDATEXML オプションを指定せずに起動してください。
Oracle SOAP clientenv.csh と clientenv.sh ファイルの修正(Bug#1978217)
ファイルの修正
<ORACLE_HOME>/soap/bin/clientenv.csh（11,12 行目）及び<ORACLE_HOME>/soap/bin/clientenv.sh（10, 11
行目）を実行前にそれぞれ以下のように修正して下さい。
変更前：
java -fullversion |& grep '_1¥.1' >& /dev/null && set JDK="1"
java -fullversion |& grep '_1¥.2' >& /dev/null && set JDK="2"
変更後：
java -fullversion |& grep '1¥.1¥.8' >& /dev/null && set JDK="1"
java -fullversion |& grep 'v¥.1¥.2¥.2' >& /dev/null && set JDK="2"
OC4J ロード・バランサが不正なメッセージを出力する
ロード・バランサが不正なメッセージを出力する(Bug#1972747)
ージを出力する
日本語ロケール(LANG=ja など)を設定した環境で OC4J ロード・バランサを起動した場合、 以下のように
不正なメッセージを出力することがあります。
Unable to connect to <HostName>/<IP Address>:<Port>: ??????????????????,
removing node from list
この現象を回避するためには、LANG=C を設定して OC4J ロード・バランサを起動してください。正しい
メッセージが出力されます。
Unable to connect to <HostName>/<IP Address>:<Port>: connect (code=10061),
removing node from list
OC4J ロード・バランサがループしメッセージ・ログを出力し続ける (Bug#1964229)
load-balancer.xml ファイルに記述した全ての OC4J サーバーが停止状態で OC4J ロード・バランサを起動し、
OC4J サーバーにアクセスすると、ロード・バランサがループして以下のメッセージを出力し続けます。
Unable to connect to <HostName>/<IP Address>:<Port>: connect (code=10061),
24
Oracle9i Application Server for HP Tru64 UNIXリリース・ノート
removing node from list
この現象が発生した場合、OC4J サーバーを起動してください。
OC4J クラスタ化でセッション情報が共有できない(Bug#1951486)
クラスタ化でセッション情報が共有できない
OC4J でクラスタ化を有効にする時に、global-web-application.xml ファイルへ <cluster-config/> を追加して
もセッション状態を共有できないという問題が報告されています。
この現象が発生した場合、orion-web.xml ファイルに<cluster-config/>を追加します。
Oracle9iAS Containers for J2EE のグラフィカル・ツールについて
Oracle9iAS Containers for J2EE に付属する以下のツールはサポート対象外です。
−
Service Console (orionconsole.jar)
−
Taglib-Assembler (taglibassembler.jar)
−
Web-App Assembler (webappassembler.jar)
−
EJB-Assembler (ejbassembler.jar)
−
Client-Assembler (clientassembler.jar)
−
EAR-Assembler (earassembler.jar)
−
EJB-Maker (ejbmaker.jar)
不正なパケットを受信すると TNS リスナーが異常終了する問題について
TNS リスナーが 1024byte より大きい TNS 接続データを受信すると、TNS リスナーがハングしたり異常終
了することがあります。また、TNS リスナーが不正な TNS 接続データを受信した場合、TNS リスナーが異
常終了することがあります。この問題は、Oracle 9iAS Database Cache、Oracle Enterprise Java Engine の TNS
リスナーを必要とするコンポーネントを使用する際に影響を受けます。
この問題の詳細については、次の Web サイトの[説明とよくある質問・回答]を参照して下さい。
http://www.oracle.co.jp/news/security/
ロードバランサを経由した
ロードバランサを経由した SSL 接続
本リリースの Oracle9iAS Containers for J2EE ではロードバランサ(loadbalancer.jar)を経由した SSL 接続はサ
ポートされません。
Oracle9iAS Containers for J2EE のデータソース設定で反映されない項目
(Bug#1865617,197830)
本リリースでは data-sources.xml ファイル内に記述のある以下の 3 つのパラメータは有効にはなりません。
今後のリリースにて修正される予定となっています。
max-connect-attempts
connection-retry-interval
min-connection
Oracle9iAS Containers for J2EE の EJB コンテナ利用時の注意点
- Entity Bean におけるトランザクション同時実行性
EJB1.1 及び 2.0 では Entity Bean におけるトランザクション・コミット後のインスタンスの状態保持(キャッ
シング)に関して、以下の 3 つが規定されています。各 EJB コンテナは少なくともいずれか一つを実装する
必要があります。(Enterprise JavaBeans Specification v1.1, Chapter 9 Entity Bean Component Contract)
第１章 日本語環境での使用上の注意
25
Option A
EJB コンテナはトランザクション終了後も有効なインスタンス及びその状態(値)を保持する。これに
より次回のトランザクション開始時にそのインスタンスが必要な場合、データベースからの再読み込
みを行わずにインスタンスを再利用できる。またトランザクション間で値の有効性を保証するために、
データベースに対する排他的なアクセスが必要になる。すなわち同一のエンティティを表すインスタ
ンスは常に 1 つのみ作成される。
Option B
EJB コンテナはトランザクション終了後も有効なインスタンスを保持するが、その状態(値)は次回の
トランザクション開始時にデータベースから再度読み込みを行う。トランザクション開始時に毎回読
み込みが発生するが、データベースに対するアクセスを複数のインスタンスから行うことが出来る。
この場合同一のエンティティを表すインスタンスは複数作成、実行されることができる。
Option C
EJB コンテナはトランザクション終了後に有効なインスタンスを保持せず、プールにインスタンスを
戻す。次回のトランザクション実行時にそのインスタンスが必要な場合、再度 ejbActivate()メソッド等
が呼び出される。データベースに対するアクセスを複数のインスタンスから行うことが出来る。
Oracle9iAS Containers for J2EE の EJB コンテナでは Option A のみを実装しているため、特定のエンティティ
を表す Entity Bean に対するアクセスは一つのクライアントからのみになります。このため複数のクライア
ントが同一のエンティティを表す Entity Bean に同時にアクセスした場合、最初のクライアントのトランザ
クションが終了するまで次のクライアントの操作は実行されません。Entity Bean のメソッド実行をクライ
アントのトランザクションに含める必要が無い場合には、ejb-jar.xml の<trans-attribute>タグで指定される
Entity Bean のトランザクション属性に NotSupported を指定することで、この同時実行性の影響を軽減する
ことが出来ます。またこのような同時実行性がパフォーマンス上大きな影響を及ぼす場合、Session Bean に
よる実装を検討して下さい。
Oracle9iAS Containers for J2EE におけるステートフル Session Bean のメソッド間
でのトランザクションの共有についての問題(Bug#1831054)
でのトランザクションの共有についての問題
ステートフル Session Bean のメソッド間でトランザクションを分割した場合、「No active Transaction」のエ
ラーが発生することがあります。このエラーは以下の条件で発生します。
−
トランザクション制御に Bean 管理区分を指定したステートフル Session Bean を使用します。
−
EJB の複数メソッドで１つのトランザクションを使用します。
−
EJB と異なる JavaVM 環境で動作しているクライアント・アプリケーションから EJB を呼び出します。
エラーが発生すると以下のメッセージが表示されます。
Exception in thread "main" javax.transaction.TransactionRolledback
Exception:java.lang.IllegalStateException: No active Transaction
ステートフル Session Bean のメソッド間でのトランザクションの共有を行う場合には以下の設定を行って
ください。
$ORACLE_HOME/j2ee/home/config/rmi.xml ファイルに serialize-connection-calls="true"を追加します。
以下は修正例です。
<rmi-server port="23791" serialize-connection-calls="true">
<!-- A remote server connection example -->
<!-- <server host="the.remote.server.com
username="adminUser" password="123abc" /> -->
<!-- path to the log-file where RMI-events/errors are stored -->
<log>
<file path="../log/rmi.log" />
</log>
26
Oracle9i Application Server for HP Tru64 UNIXリリース・ノート
</rmi-server>
この設定を行うと EJB の動作方法が変更されます。serialize-connection-calls 属性を省略または false を設定
すると EJB 内のメソッドはスレッドを起動してから実施されます。serialize-connection-calls="true"を設定す
ると、EJB 内のメソッドはスレッドを起動せずに実施されます。
Oracle9iAS Containers for J2EE のインストールについて
インストーラーで Core Edition を選択してインストールすると、$ORACLE_HOME/J2EE_containers ディレ
クトリに Oracle9iAS Containers for J2EE コンポーネントがインストールされます。インストール終了後、
$ORACLE_HOME/J2EE_containers ディレクトリ内の oc4j.zip を Oracle ホームディレクトリ上で解凍してイ
ンストールしてください。
インストールの詳細は「Oracle9i Application Server for UNIX インストレーション・ガイド リリース 1.0.2.2」
の C 章「Oracle9iAS Containers for J2EE（OC4J）のインストール」を参照してください。また、参照する際
には"Oracle9iAS Containers for J2EE CD-ROM"を$ORALE_HOME/J2EE_containers ディレクトリに読み替え
てください。
Oracle9iAS SOAP のデフォルト設定におけるセキュリティ上の問題点
Oracle9iAS リリース 1.0.2.2 では、SOAP サンプルが直ぐに使用できるように、デフォルト（'標準'インスト
ール）の設定では、SOAP が利用可能となっています。このデフォルト・インストレーションでは、SOAP
サービスのデプロイ/アンデプロイが機能が制限されていないために、特に、インターネットを介して HTTP
サーバーにアクセスする場合などに、セキュリティの問題が生じる可能性があります。Oracle9iAS リリー
ス 1.0.2.2 のデフォルト SOAP インストレーションを不正に利用した侵入に対処するために以下の何れかの
方法をご検討ください。
（$ORACLE_HOME は Oracle9iAS をインストールしたディレクトリを示します。また、設定ファイル内の
ポート番号などは設定例であり、実際に設定されているものとは異なりますのでご注意ください）
1.
SOAP を使用しない場合には、ファイル$ORACLE_HOME/Apache/Jserv/etc/jserv.conf を編集し、以下
の 4 行をコメントアウトすることによって SOAP 自体を無効にします。
ApJServGroup group2 1 1 $ORACLE_HOME/Apache/Jserv/etc/jservSoap.properties
ApJServMount /soap/servlet ajpv12://localhost:8200/soap
ApJServMount /dms2 ajpv12://localhost:8200/soap
ApJServGroupMount /soap/servlet balance://group2/soap
2.
すでに SOAP を使用しており、必要なサービスがデプロイされており、追加や変更のデプロイ/アン
デプロイが発生しない場合には、以下の例の様な設定によってデプロイ/アンデプロイを無効にしま
す。
SOAP 設定ファイル（$ORACLE_HOME/soap/werbapps/soap/WEB-INF/config/soapConfig.xml）で、
serviceManager 要素の下に次の設定を行います。
例)
<osc:serviceManager
class="oracle.soap.server.impl.FileServiceManager">
<!-- Please include the appropriate absolute path with the filename -->
<osc:option name="filename"
value="$ORACLE_HOME/soap/webapps/soap/WEB-INF/services.dd" />
<!-- auto-deploy providerManager and serviceManager as services -->
<!-- <osc:option name="autoDeploy" value="true" /> -->
<osc:option name="autoDeploy" value="false" /> <== ●設定
</osc:serviceManager>
第１章 日本語環境での使用上の注意
27
3.
SOAP サービスをデプロイ/アンデプロイする為の URL を追加しアクセス制限を設定することによ
って、一般のユーザーから実行ができないように設定する事ができます。設定の手順は次の通りで
す。
3-1
ファイル$ORACLE_HOME/Apache/Jserv/etc/jserv.conf を以下の例の様に編集しアクセスできる
パスを追加します。
例)
# SOAP Entries
ApJServGroup group2 1 1 $ORACLE_HOME/Apache/Jserv/etc/jservSoap.properties
ApJServMount /soap/servlet ajpv12://localhost:8200/soap
ApJServMount /dms2 ajpv12://localhost:8200/soap
ApJServGroupMount /soap/servlet balance://group2/soap
ApJServGroupMount /soap/admin balance://group2/soap
3-2
<== ●追加
追加したパスに対するアクセス制限を以下の例の様に設定をします。この例では jserv.conf に
て localhost からしかアクセスができないようにしています。
例)
<Location /soap/admin/ >
order deny,allow
deny from all
allow from localhost
</Location>
3-3
SOAP 設定ファイル（$ORACLE_HOME/soap/werbapps/soap/WEB-INF/config/soapConfig.xml）に
おいて、以下の例の様に serviceManager 要素と providerManager 要素の下部に次を設定しデプロ
イ/アンデプロイを実行する URL を上記で設定した URL に設定をしてこのパスでしか実行がで
きないように制限します。
例)
<osc:providerManager
class="oracle.soap.server.impl.FileProviderManager">
<!-- filename is the absolute path to the filename -->
<osc:option name="filename"
value="$ORACLE_HOME/soap/webapps/soap/WEB-INF/providers.dd" />
<osc:option name="requiredRequestURI" value="/soap/admin/soaprouter" /> <== ●追加
</osc:providerManager>
<osc:serviceManager
class="oracle.soap.server.impl.FileServiceManager">
<!-- Please include the appropriate absolute path with the filename -->
<osc:option name="filename"
value="$ORACLE_HOME/soap/webapps/soap/WEB-INF/services.dd" />
<!-- auto-deploy providerManager and serviceManager as services -->
<!-- <osc:option name="autoDeploy" value="true" /> -->
<osc:option name="autoDeploy" value="true" />
<osc:option name="requiredRequestURI" value="/soap/admin/soaprouter" /> <== ●追加
</osc:serviceManager>
28
Oracle9i Application Server for HP Tru64 UNIXリリース・ノート
FastCGI（
（mod_fastcgi）でサポートする開発言語について
）でサポートする開発言語について
本リリースに付属の FastCGI(mod_fastcgi)機能では、C 言語のみをサポート対象とします｡
Oracle Servlet Engine で getPathInfo()メソッドが使用できない
メソッドが使用できない(Bug#2067677)
メソッドが使用できない
Oracle Servlet Engine 使用時、サーブレットの中で getPathInfo()メソッドを使って URL から拡張パスの情報
を取得しようとすると、
「ドキュメントにデータが含まれていません。あとでやりなおすか、サーバの管理者にお尋ね下さい。」
というダイアログが表示されます。URL が拡張パスの情報を持たない場合は、ダイアログは表示されずに
null が表示されます。
CD Pack に同梱されるパッチの適用について
mod_plsql に関する修正の適用
Oracle9i Application Server R1.0.2.2 Update CD-ROM には、Oracle9i Application Server R1.0.2.2 に含まれる
mod_plsql よりも新しいバージョンが含まれています。mod_plsql のセキュリティ上の脆弱性に対する修正
を含みますので、mod_plsql の機能を利用する場合は、必ずインストールしてください。インストール手順
は、Oracle9i Application Server R1.0.2.2 Update CD-ROM の次の場所の readme.html を参照して下さい。
<cdrom>/modplsql/
Oracle HTTP Server に関連した修正の適用
Oracle HTTP Server に対する修正が、Oracle9i Application Server R1.0.2.2 Update CD-ROM 内の次のディレク
トリにあります。
<cdrom>/ohs/p1923352
<cdrom>/ohs/p2492925
<cdrom>/ohs/p2611482
これらのパッチを適用することで修正される主な問題は以下の通りです。
−
一台のマシンで複数の Oracle HTTP Server が起動できない問題(Bug#1774568)
−
一台のマシンで複数の FastCGI プロセスが起動できない問題(Bug#1803670)
−
1024 番 Port 以下で Oracle HTTP Server を起動した場合、mod_plsql のキャッシュが使用できない問題
(Bug#1817550)
−
Oracle HTTP Server のチャンク・ハンドリングのセキュリティ脆弱性の問題(Bug#2424256)
−
OpenSSL の複数のセキュリティの脆弱性について(Bug#p2492925)
−
Apache 1.3.27 に含まれるセキュリティの修正(Bug#p2611482)
Oracle HTTP Server をご使用になる前にこのパッチを必ず適用してください。また、これらのパッチは、以
下の順序で適用する必要があります。
1. p1923352
2. p2492925
3. p2611482
パッチの詳細および適用方法に関しては、ディレクトリ内の readmeja.htm または README.txt を参照して
ください。
第１章 日本語環境での使用上の注意
29
Oracle9iAS Web Cache R2.0.0.4.0 インストール
Oracle9i Application Server R1.0.2.2 Update CD-ROM には、Oracle9i Application Server R1.0.2.2.2 に含まれる
Oracle9iAS Web Cache よりも新しいバージョン Web Cache R2.0.0.4.0 が含まれています。Web Cache 機能を
利用する場合は、必ずインストールしてください。インストール手順は、次のようになります。
1.
Oracle9i Application Server R1.0.2.2.2 の Core Edition のインストールあるいは Enterprise Edition のイン
ストール後、Universal Installer を起動し、Web Cache R2.0.0.1.0 のインストールを開始します。
> runInstaller
2.
"次"ボタンを押し、「ファイルの場所」画面に移動します。
3.
ソースの指定で、Oracle9i Application Server R1.0.2.2 Update CD-ROM の products.jar を指定します。
<cdrom>/webcache/webcache2.0.0.1.0_tru64/Disk1/stage/products.jar
4.
インストール先の指定は、既存のオラクルホームを指定します。
5.
Web Cache R2.0.0.1.0 のインストールを完了させます。
6.
続いて、Oracle9i Application Server R1.0.2.2 Update CD-ROM の次の場所の readmeja.html の記述に従
い、Web Cache R2.0.0.4.0 をインストールします。
<cdrom>/webcache/webcache2.0.0.4.0_tru64/
Oracle Developer R6i Patch13
Oracle9iAS Forms Services または Oracle9i Reports Services を使用する際は、Oracle9i Application Server
R1.0.2.2 をインストール後、各プラットフォーム向けの Oracle Developer R6i Patch13 CD-ROM から、Oracle
Developer R6i Patch13 を適用して下さい。Oracle Developer R6i Patch13 の適用方法等の詳細は、第 5 章の
「Oracle Developer for Compaq Tru64 UNIX R6i Patch13 の適用」を参照してください。
Oracle9iAS Portal のインストールについて
Oracle9iAS Portal リリース 3.0.9 では「Oracle Portal Configuration Assistant」を用いたインストールはサポー
トされません。OUI の「Component Configuration and Startup」画面で、「Oracle9iAS Portal」の選択を解除し
てください。また、インストールした後に、Portal3.0.9.8.1patch を適用する必要があります。適用手順は「４
章 Oracle9iAS Portal」の「Oracle9iAS Portal のインストールについて」の項を参照してください。
Oracle JSP 1.1.3.1 のインストール
Oracle9iAS R1.0.2.2 Update CD-ROM に含まれている Oracle JSP 1.1.3.1 には、Oracle9iAS Web Cache の JESI
タグライブラリに関する修正が含まれています。
以下の手順でインストールしてください。
1.
ojsp_11310.zip をテンポラリディレクトリに展開します。
例： > unzip ./ojsp_11310.zip
2.
bin ディレクトリと lib ディレクトリのファイルを、それぞれ$ORACLE_HOME/bin と
$ORACLE_HOME/lib にコピーします。
例：> cp ./bin/* $ORACLE_HOME/bin
> cp ./lib/* $ORACLE_HOME/lib
3.
手順 2 でコピーした servlet22.jar を利用するように Apache JServ Configuration Fie を修正します。
例：jserv.properties ファイルの次の箇所を書き換えます。
(ここでは $ORACLE_HOME が /u01/app/oracle/product/iAS1022 と仮定します)
変更前:
wrapper.classpath=/u01/app/oracle/product/iAS1022/lib/servlet.jar
30
Oracle9i Application Server for HP Tru64 UNIXリリース・ノート
変更後:
wrapper.classpath=/u01/app/oracle/product/iAS1022/lib/servlet22.jar
4.
jsp ディレクトリを$ORACLE_HOME/jsp にコピーします。
例： > cp -r ./jsp $ORACLE_HOME
5.
jsp/demo/demo.zip をテンポラリディレクトリに展開します。
6.
WEB-INF と demo ディレクトリを$ORACLE_HOME/Apache/Apache/htdocs にコピーします。
修正に関する詳細および、OJSP1131 を OC4J で使用する方法については、<cdrom>/ojsp に含まれるドキュ
メントを参照してください。
Oracle9i Database に JDBC Thin ドライバで接続する際の修正の適用
Oracle9i Database に JDBC Thin ドライバで接続する場合に必要となるパッチが、Oracle9i Application Server
R1.0.2.2 Update CD-ROM で提供されています。適用手順に関しましては、<cdrom>/jdbc に含まれる
README.txt を参照してください。
オリジナル・データベースに IBM AIX システムを使用する場合の Database Cache
Configuration Assistant のエラー(Bug#1319688)
のエラー
オリジナル・データベースに IBM AIX システムを使用した場合、Database Cache Configuration Assistant 実
行中、96%で次のエラーが発生します。
Reason: WTE-03501 Error updating list of users: Export failed on origin database.
OCI error - ORA-06520: PL/SQL: Error loading external library
ORA-06522: No such file or directory
ORA-06512: at "SYS.WTCSYS", line 11
ORA-06512: at "SYS.WTCSYS", line 66
ORA-06512: at line 1
このエラーを修正するパッチが Oracle9i Application Server R1.0.2.2 Update CD-ROM で提供されています。
このパッチを FTP などで転送し、IBM AIX システムのオリジナル・データベースに対してパッチの適用を
行なって下さい。適用手順に関しましては、<cdrom>/dbcache/p1319688 に含まれる README.1319688 を参
照してください。このパッチは、Oracle8 R8.0.6、Oracle8i R8.1.7 の両方に対応します。なお、R8.0.6 に適用
したとき、"R8.1.7"というバージョンが表示されますが、無視してください。
第１章 日本語環境での使用上の注意
31
第２部
32
Oracle9i Application Server for HP Tru64 UNIXリリース・ノート
第２章 Oracle9i Application Server
原典情報: Oracle9i Application Server Release Notes Release 1 (v1.0.2.2) for AIX-Base Systems, Compaq Tru64 UNIX, HP
9000 Series HP-UX, Linux Intel, and Sun Solaris Intel（A90377-01）
はじめに
この章の目的
この章では、Oracle9i Application Server for UNIX リリース 1.0.2.2 のコンポーネントについて、ドキュメン
トで説明されている機能と実際との違いについて説明します。
製品名称変更
今回のリリースでは、製品名が次のように変更されています。
以前の名称
新しい名称
新しい名称
Oracle8i JVM
Oracle Enterprise Java Engine（EJE）
Oracle Forms Service
Oracle9iAS Forms Services
Oracle LDAP Developer’s kit
Oracle LDAP Developer Kit
Oracle Database Client Developer's Kit
Oracle Database Developer Kit
Oracle XML Developer's Kit
Oracle XML Developer Kit
Oracle Portal
Oracle9iAS Portal
Oracle Portal-to-Go
Oracle9iAS Wireless
Oracle Database Cache
Oracle9iAS Database Cache
Oracle Web Cache
Oracle9iAS Web Cache
Oracle Reports Service
Oracle9iAS Reports Services
Oracle Discoverer
Oracle9iAS Discoverer
Oracle Transparent Gateways
Oracle Gateways
Oracle eMail Server
Oracle9iAS Email
Oracle Unified Messaging
Oracle9iAS Unified Messaging
Oracle9i Application Server のインターネット・アプリケーションおよびそのサブコンポーネントは、次のと
おりです。
Oracle HTTP Server powered by Apache
Apache JServ、mod_jserv
Perl インタプリタ、mod_perl
mod_plsql、mod_ssl
Dynamic Monitoring Service（DMS）
FastCGI
Oracle9i Application Server Containers for J2EE
Oracle9i Application Server Servlet Container
第２章 Oracle9i Application Server
33
Oracle9i Application Server EJB Container
Oracle9i Application Server JSP Container
Oracle Business Components for Java
Oracle9i Application Server Object Caching Services for Java *1
Oracle PL/SQL
Oracle PL/SQL Server Pages（Oracle PSP）
Oracle9i Application Server Forms Services
Oracle9i Application Server Developer Kits
Oracle Database Developer Kit
Oracle XML Developer Kit
Oracle9i Application Server Portal
Oracle9i Application Server Wireless
Oracle9i Application Server Cache
Oracle9i Application Server Web Cache
Oracle9i Application Server Database Cache
Oracle9i Application Server Business Intelligence
Oracle9i Application Server Reports Services
Oracle9i Application Server Discoverer（Discoverer Viewer および Discoverer Plus を含む）*2
Oracle Enterprise Manager
Oracle Advanced Security
Oracle9i Application Server Single Sign-On
Oracle9i Application Server Integration
Oracle Workflow *1
Oracle9i Application Server InterConnect *1
Oracle9i Application Server SOAP
Oracle Internet Directory *1
Oracle9i Application Server Email *1
Oracle9i Application Server Unified Messaging *1
Oracle Internet File System *1
*1 本リリースではサポートされません。
*2 2001 年 10 月 1 日現在、サポートされていません。
動作保証に関する情報
JDK/JRE の動作保証
オラクル社では、mod_jserv を使用した Java アプリケーションの構築および運用にあたり、JDK/JRE 1.1.8
および JDK/JRE 1.2.x の両方で動作を保証しています。今回のリリースでは、Java クラス・ライブラリ（た
とえば、Oracle Business Components for Java、Oracle XML Developer's Kit）は、すべて JDK 1.1.8_10 でコン
パイルされたものを出荷しています。これらのコンパイル済みクラスは、サポートされている Java JRE の
両バージョンで動作することが保証されています。これらを再コンパイルしないでください。
JDK 1.3 を使用した場合の動作保証は、『Oracle9i Application Server リリース・ノート追加情報』を参照し
てください。
34
Oracle9i Application Server for HP Tru64 UNIXリリース・ノート
Java Importer の環境設定
Java Importer の機能は、Oracle9iAS Forms で使用可能です。この機能を使用するには、JDK 1.2.2 が必要で
す。
この機能を使用するためには、次のステップを実行します。
1.
<java_inst_dir>/bin を含めるように PATH を設定します。
2.
CLASSPATH に<IAS_HOME>/6iserver/lib/importer.jar およびインポートする Java クラ
ス・ファイルの場所を設定します。
注意:
注意: java_inst_dir には、JDK および JRE 1.2 がインストールされている場所を指定してください。
表 1-1
プラット
フォーム
環境変数
ライブラリ・パス
Tru64
LD_LIBRARY_PATH
<java_inst_dir>/jre/lib/alpha:
<java_inst_dir>/jre/lib/alpha/classic:
<java_inst_dir>/jre/lib/alpha/native_¥
threads
Oracle Enterprise Manager の動作保証
Oracle9iAS リリース 1.0.2.2 には、Oracle Enterprise Manager 2.2 が含まれています。これは、Oracle9i データ
ベースでの動作は保証されていません。
新機能
この項では、今回のリリースの新機能を、アプリケーション分野ごとに説明します。
インターネット・アプリケーションの新機能
Oracle9i Application Server Containers for J2EE
Oracle9iAS Containers for J2EE は、
JDK で実行される純粋な Java ランタイムです。
次の機能が提供されます。
すべての J2EE 1.2 API のサポート。Enterprise JavaBeans（EJB）1.1、Servlet 2.2、Java ServerPages（JSP）
1.1、JTA 1.0.1、JNDI 1.2、JMS 1.0、JDBC 2.0 および JavaMail 1.1.2 が含まれます。
J2EE 1.3 API の部分的なインプリメント。Servlet 2.3 および EJB 2.0 が含まれます。
XML ベースの設定。
標準 J2EE EAR 、WAR または EJB JAR ファイルを使用した Java のデプロイ。
標準の Java 開発ツールおよびプロファイリング・ツールのサポート。
コンポーネント cSOAlustering、ロード・バランシングおよびアプリケーションの状態のレプリケーシ
ョンによる信頼性およびスケーラビリティの実現。
Oracle9iAS Containers for J2EE の現在のリリースは、JDK バージョン 1.2.2_07 または 1.3x とともに使用した
場合に、特に動作が安定しています。
Oracle9iAS Containers for J2EE は、oc4j.zip という名前の ZIP ファイルとして提供されています。このファ
イルを解凍し、README の手順に従います。
次の J2EE コンポーネントおよびサービスが存在します。
第２章 Oracle9i Application Server
35
Java Servlet
Servlet 2.3 の完全なサポート
Tomcat Servlet エンジンとの 100%の互換性
フィルタの完全なサポート
完全な WAR ファイル・ベースのデプロイ
オート・コンパイルおよびデプロイ
ステートフルなフェイルオーバーおよびクラスタ配布
JavaServer Pages
JSP 1.1 の完全なサポート
シンプル、ボディ、パラメータ化、およびコラボレーション・タグ
JSP キャッシュ・タグ
メール、検索およびその他のタグ
完全な WAR ファイル・ベースのデプロイ
Enterprise JavaBeans (EJB)
EJB 1.1 の完全なサポートおよび EJB 2.0（Public Draft）の大部分のサポート
Session Bean
Entity Bean（完全なコンテナ管理の永続性（CMP）および Bean 管理の永続性（BMP））
Message-Driven Bean
基本および拡張 O-R マッピングのサポート
EJB スタブの動的生成
完全な EAR ファイルベースのデプロイ
簡単かつ自動的な EJB アプリケーションのデプロイ
オート・デプロイ
設定のカスタマイズの簡易化
ホット・デプロイ
Java Database Connectivity Services（
（JDBC）
）
JDBC による Oracle データベースへのアクセス
Oracle JDBC-OCI ドライバ
Oracle thin JDBC ドライバ
JDBC 2.0 の完全なサポート
データ型の完全なサポート
JDBC 2.0 接続プーリング
拡張機能
Oracle8.0、8i、9i のサポート
Merant JDBC ドライバとの動作保証
36
Oracle9i Application Server for HP Tru64 UNIXリリース・ノート
Java（
（SQLJ）インプリメンテーションにおける埋込み
）インプリメンテーションにおける埋込み SQL
Oracle9iAS Containers for J2EE では、標準 ANSI SQLJ が実装されているため、(ほとんどの場合におい
て)JDBC API でのコーディングを必要とせず、動的 SQL を直接 SQLJ 文として記述することができま
す。SQLJ のインプリメンテーションでは、未定義の ResultSetIterator から fetch コマンドが実行可能
で、イテレータ宣言を省略できます。
さらに、JDBC のプログラムおよびロジックを 1 対 1 で SQLJ に変換可能です。直接、Oracle JDBC の
コードの生成が可能で、SQLJ プロファイルを生成またはカスタマイズする必要はありません。対応す
る Oracle JDBC の拡張機能もサポートされています。
インフラストラクチャ・サービス
Oracle9iAS Container for J2EE には、次のインフラストラクチャ・コンポーネントが含まれています。
Java Naming and Directory Interface（JNDI）
Java Transaction API（JTA）
Java Message Service(JMS)
Java Security Services
RMI および HTTP トンネル・サービス
Web サーバーから JSP/ Servlet エンジンへの接続
JSP/ Servlet から EJB および EJB から EJB への接続
HTTP と HTTP(S)のトンネル
設定、配布および管理
Oracle9iAS Container for J2EE 設定は、XML をベースに標準化されており、サーバー、汎用およびアプ
リケーション/コンポーネントの分野で管理されています。
サーバー設定ファイル: server.xml、web-site.xml、principals.xml、data-sources.xml、rmi.xml、jms.xml、
load-balancer.xml、default-web-site.xml
汎用 J2EE アプリケーションおよびコンポーネント設定ファイル: web.xml、ejb-jar.xml、
application.xml、application-client.xml
Oracle9iAS Container for J2EE 固有のアプリケーションおよびコンポーネント設定ファイル（.xml）
配布プロセスを簡単にするために、次のツールが用意されています。
WAR ファイル作成ツールにより、JSP、サーブレット、タグ・ライブラリおよび静的コンテンツ
から WAR ファイルを作成します。
EJB 作成ツールにより、EJB Home、リモート・インタフェース、デプロイメント・ディスクリ
プタおよび EJB 自体を標準の JAR ファイルにパッケージ化します。
EAR ファイル作成ツールにより、WAR ファイルおよび EJB JAR から標準の EAR ファイルを作
成します。
タグ・ライブラリ作成ツールにより、JSP タグ・ライブラリから標準の JAR ファイルを作成しま
す。
システム管理
システム管理は、コマンドライン・ツールを使用して、リモートおよびローカルで実行できます。
Oracle9iAS リリース 1.0.2.2 付属の管理コンソールは、次のリリースの機能で提供されるテクノロジの
プレビュー版です。このコンソールは、本番環境での使用はサポートされていません。Oracle9iAS リ
リース 2 には、Oracle Enterprise Manager と完全に統合された新しい管理コンソールが含まれる予定で
す。
第２章 Oracle9i Application Server
37
システム管理および開発を支援するために、ロギング・サービスが用意されています。Web アクセス、
アプリケーション、サーバー、および RMI や JMS のアクティビティをログに記録可能です。
今回のリリースでは、Oracle9iAS 次の機能を使用することにより、システム管理が簡単になり、信頼
性が向上しています。
ロード・バランシングおよび可用性機能
HTTP サーバーまたは Oracle9iAS J2EE Container レベルでのロード・バランシング
サード・パーティー製のロード・バランシング製品との統合
No single point of failure
接続の自動再ルーティング
自動障害検出および再起動
透過的なアプリケーションのフェイルオーバー、ステートフルおよびステートレスなクラスタの
サポート
クラスタ機能
IP ベースの静的マルチキャスト
Web プレゼンテーションおよび Web サーバーのフェイルオーバー
セッションの状態のレプリケーションおよびクラスタのフェイルオーバー
透過的なアプリケーションのフェイルオーバー（TAF）およびデータベースの状態管理
Oracle HTTP Server powered by Apache
Apache JServ プロセスに関する注意
Oracle9i Application Server のサイトでサポートされている Apache JServ プロセスの最大数は、Apache
配布時のデフォルトの最大数 25 から Oracle9i Application Server の最大数 128 に増加しました。この値
は、実行時に設定できません。
Oracle9i Application Server のサード・パーティー製コンポーネントのサポート
すべてのサード・パーティー製コンポーネント Oracle9i Application Server の一部は、サード・パーテ
ィーのライセンスを受けてオラクル社によって販売されています（サード・パーティー製コンポーネ
ントと呼ばれます）。これには、Apache Software Foundation のライセンスを受けた Apache Web サー
バー バージョン 1.3.19 が含まれます。オラクル社は、これらのサード・パーティー製コンポーネント
を Oracle9i Application Server 製品の一部として販売するものであり、ここに明記されている場合を除
き、サード・パーティー製コンポーネントに対しても標準の製品サポートを行います。これらのサポ
ートの詳細については、オラクル社のテクニカル・サポート・ポリシーに定義されています。
注意:
注意 オラクル社では、Oracle9i Application Server 付属のサード・パーティー製コンポーネントのバ
ージョンのみサポートするものであり、インターネット上で無料で入手可能であるその他のバ
ージョンなどは、オラクル社のサポート対象外のため、ご注意ください。
オラクル社は、サード・パーティー製コンポーネントの拡張を、コンポーネントのライセンス元であ
るサード・パーティーに要請する場合があります。ただし、オラクル社にはその義務はありません。
さらに、サード・パーティー製コンポーネント以外のコンポーネント（Oracle コンポーネント）につ
いても、問題が Oracle コンポーネントのみで構成される環境で再現できない限り、技術サポートの要
請は受け付けません。
Apache モジュール オラクル社では、Apache Web サーバー（Apache モジュールと呼ばれる）の拡
張機能を提供し、Oracle9i Application Server の一部としての Apache Web サーバーの機能を強化してい
38
Oracle9i Application Server for HP Tru64 UNIXリリース・ノート
ます。このリリース・ノートでは、オラクル社によって提供される Apache モジュールを Oracle Apache
モジュールと呼びます。
このリリースでは、次の Oracle Apache モジュールをサポートしています。
Oracle Apache
モジュール
説明
http_core
Apache のコア機能。
mod_access
ホスト・ベースのアクセス制御。クライアントのホスト名ま
たは IP アドレスに基づいたアクセス制御を提供します。
mod_actions
ファイル・タイプ/方式ベースのスクリプト実行。メディア・
タイプまたはリクエスト方式に基づき、CGI スクリプトに使
用されます。
mod_alias
別名とリダイレクト。ホスト・ファイル・システムの様々な
部分をドキュメント・ツリーにマッピングする際、および URL
のリダイレクトに使用されます。
mod_auth
テキスト・ファイルを使用したユーザー認証。
mod_auth_anon
匿名のユーザー認証（FTP 方式）。
mod_autoindex
自動ディレクトリ・リスト。
mod_cgi
CGI スクリプトの実行。mime タイプが application/x-httpd-cgi
であるファイルをすべて処理します。
mod_define
設定の定義。
mod_digest
MD5 認証。MD5 ダイジェスト認証を使用したユーザー認証
に使用されます。
mod_dir
基本ディレクトリ処理。後続のスラッシュのリダイレクトお
よびディレクトリのインデックス・ファイルの処理に使用さ
れます。
mod_env
環境情報の CGI スクリプトへの受渡し。環境変数を CGI/SSI
スクリプトに受け渡すために使用されます。
mod_expires
Expires: ヘッダーのリソースへの適用。ユーザー指定の条件
に合わせた Expires ヘッダーの生成に使用されます。
mod_fastcgi
Fast CGI サーバーのプールへのリクエストのルーティング。
mod_headers
リソースへの任意の HTTP ヘッダーの追加。ヘッダーは、マ
ージ、置換または削除が可能です。
mod_include
サーバー解析のドキュメント。サーバーによって解析される
HTML ドキュメントに使用されます。
mod_info
サーバー設定情報。インストールされたすべてのモジュール
および設定ファイル内のディレクティブなど、サーバー設定
の全般的な概要を提供します。
mod_jserv
サーブレット・エンジンとの通信。
mod_log_config
mod_log_common の代替手段として使用可能なユーザー設定
可能なロギング。共通ログ・フォーマットまたはユーザー指
定のフォーマットを使用した、サーバーに対するリクエスト
のロギングに使用されます。
mod_log_referer
ドキュメントの参照のロギング。サーバー上のドキュメント
を参照するドキュメントのロギングに使用されます。
mod_mime
ファイル拡張子を使用したドキュメント・タイプの判別。
mod_mime_magic
"マジック・ナンバー"を使用したドキュメント・タイプの判
別。内容を数バイト調べることによってファイルの MIME タ
第２章 Oracle9i Application Server
39
Oracle Apache
モジュール
説明
別。内容を数バイト調べることによってファイルの MIME タ
イプを判別するために使用できます。
mod_negotiation
コンテンツのネゴシエーション。
mod_ose
Oracle Servlet Engine（OSE）におけるステートフルな Java サ
ーブレットおよび PL/SQL サーブレットへの URL の委任。
mod_oprocmgr
サーブレット・エンジンに対するプロセス管理および障害検
出の提供。
mod_perl
Perl で Apache モジュールを作成するためのサポート。
mod_plsql
PL/SQL のサポート。
libproxy
(mod_proxy)
キャッシング・プロキシの機能。HTTP 1.0 キャッシング・プ
ロキシ・サーバーに使用されます。
mod_rewrite
正規表現を使用した、URL からファイル名への強力なマッピ
ング。ルール・ベースの書換えエンジンを提供し、要求され
た URL をすばやく書き換えます。
mod_setenvif
クライアント情報に基づいた環境変数の設定。リクエストの
属性に基づいて、環境変数を設定する機能に使用されます。
mod_so
実行時のモジュールのロードのサポート。起動時または再起
動時にサーバーに実行コードおよびモジュールをロードする
ために使用されます。
mod_speling
URL のマイナーな入力ミスの自動修正。大文字入力を無視し、
1 回以下のスペル・ミスを認容することにより、ユーザーが
入力した URL のスペル・ミスを修正します。
mod_ssl
SSL のサポート。
mod_status
サーバー・ステータスの表示。サーバー管理者がサーバーの
稼動状況を確認できるよう、現在のサーバーの統計を示す
HTML ページを読みやすい形式で表示します。
mod_unique_id
各リクエストに対する一意のリクエスト識別子の生成。非常
に特別な状況下で、全リクエストにわたって一意であると保
証されたマジック・トークンを各リクエストに提供します。
mod_userdir
ユーザーのホーム・ディレクトリ。ユーザー固有のディレク
トリに使用されます。
mod_usertrack
Cookie を使用したユーザーのトラッキング。
mod_vhost_alias
動的に設定されるマス仮想ホスティングのサポート。
Oracle9i Application Server に含まれているこれ以外の Oracle Apache モジュールは元のまま提供されて
おり、一切保証またはサポートはありません。Apache Software Foundation またはお客様を含め、オラ
クル社以外のソースによる Apache モジュールについては、オラクル社のサポートはありません。
Apache モジュールにより、Apache のイベント処理が変更されます。そのため、オラクル社では、サ
ポートを提供する際、サポートされているモジュールのみで構成された Apache 設定を使用して問題
が再現可能であることを求める可能性があります。オラクル社では、サポートされているモジュール
のみで構成される設定で再現可能な問題に対し、バグ修正サポートのみを提供します。
また、オラクル社では、サポートされている Apache の設定を使用している場合のみ、付属の Perl イ
ンタプリタの使用をサポートします。
40
Oracle9i Application Server for HP Tru64 UNIXリリース・ノート
mod_perl DBI/DBD-Oracle および Apache::DBI のビルド
UNIX プラットフォームで mod_Perl DBI/DBD-Oracle および Apache::DBI のビルド、インストー
ルおよびテストを行うには、次のステップを実行します。ただし、本リリースでは、mod_perl
DBI/DBD-Oracle および Apache::DBI を用いたデータベース接続は、サポート対象外とさせていただき
ます。Perl インタプリタ本体は、サポート対象です。
1.
ご使用の環境で、次のソフトウェアが使用可能であることを確認します。
C コンパイラ
GNU Make バージョン 3.77
Perl バージョン 5.005_03
2.
必須のソフトウェアを正しく検出できるよう PATH 環境変数が設定されていることを確認しま
す。
3.
製品 CD から Oracle9i Application Server をインストールします。このバージョンでは、mod_perl
1.21 が組み込まれています。このインストールでは、次のモジュールは含まれません。
Apache::DBI
Perl DBI
Perl DBD-Oracle
4.
正しい Perl バイナリを実行するよう、PATH 環境変数を設定します。たとえば、次のようになり
ます。
prompt> setenv ORACLE_HOME /private1/iAS10
prompt> setenv PATH ${ORACLE_HOME}/Apache/perl/bin:${PATH}
注意:
注意: これ以外の方法もあります。次の表の環境変数をご使用のプラットフォームに合わせて設定し、
mod_perl DBI/DBD-Oracle が機能するようにします。
表 1-3
5.
プラットフォーム
環境変数
True64
LD_LIBRARY_PATH
すべてのプラットフォーム
PERL5LIB
PERL5LIB 環境変数を次のように変更します。
prompt> setenv PERL5LIB
${ORACLE_HOME}/Apache/perl/lib/5.00503:${ORACLE_HOME}/Apache/
perl/lib/site_perl/5.005
6.
次の Web サイトに移動します。
http://www.cpan.org/modules/by-module
7.
次のモジュールをダウンロードします。
DBI バージョン 1.14
DBD::Oracle バージョン 1.06
Apache::DBI バージョン 0.87
8.
DBI パッケージを解凍し、README の手順をよく読んでモジュールのビルド、テストおよびイ
ンストールを行います。
9.
DBD-Oracle モジュールでは、ドライバを正しくビルドするために、Oracle ソフトウェアのパス
（$ORACLE_HOME/lib、$ORACLE_HOME/rdbms/lib など）を設定する必要があります。ご使用
の環境で、次の情報が存在していることを確認してください。
a.
有効な Oracle9i Application Server または Oracle データベースを指すよう、ORACLE_HOME
環境変数を設定します（たとえば、8.1.6、8.1.7 など）。
第２章 Oracle9i Application Server
41
b.
有効な Oracle SID を指すよう、ORACLE_SID 環境変数を設定します。
c.
次の表の環境変数が、ご使用のプラットフォームで対応するファイルを指していることを検
証します。
プラットフォーム
環境変数
ライブラリ・
パス
Tru64
LD_LIBRARY_PATH
libclntsh.so
これらのファイルを指すようにするには、ご使用のシステムで該当する環境変数の
$ORACLE_HOME/lib を設定します。
d.
各国語サポート（NLS）を使用している場合、ORA-01019 エラーを回避するよう、ORA_NLS
および ORA_NLS33 環境変数が設定されていることを確認してください。
e.
オプションで、ORACLE_USERID 環境変数を設定します。この環境変数を設定しない場合、
テストでは、デフォルトで scott/tiger が使用されます。
10. DBD-Oracle パッケージを解凍し、README の手順をよく読んでモジュールのビルド、テストお
よびインストールを行います。テストを正しく実行するには、データベースが稼働中である必要
があります。
11. Apache::DBI パッケージを解凍し、README の手順をよく読んでモジュールのビルドおよびイン
ストールを行います。このモジュールに関しては、テストはまだ用意されていません。このステ
ップにより、Apache AuthDBI.pm および DBI.pm モジュールがインストールされます。
12. $ORACLE_HOME/Apache/Apache/conf/httpd.conf を次のように編集します。
a.
次の行のコメントを解除します（先頭の#記号を削除します）。
PerlModule Apache::DBI
これにより、Apache::DBI の永続データベース接続の使用が可能になります。詳細は、Apache::DBI
の README の手順を参照してください。
注意:
注意: httpd.conf は、Apache サーバーの主要な設定ファイルです。このファイルの先頭に記
述されている指示を必ずお読みください。
13. 永続的接続をテストします。例として、次のステップを実行して startup.pl からの接続をテストし
ます。
a.
httpd.conf ファイルに次の行を追加します。
PerlRequire <absolute path to ApacheDBI's startup.pl script>
b.
startup.pl 接続コールを次のように変更します。
Apache::DBI->connect_on_init('dbi:Oracle:',"scott/tiger", '');
c.
Oracle HTTP Server を再起動します。
prompt> $ORACLE_HOME/Apache/Apache/bin/apachectl start
d.
接続が正しく取得されたことを Oracle HTTP Server のログで確認します。
注意:
注意: Oracle HTTP Server のログに、ORACLE_HOME 環境変数が設定されていないという
メッセージが出力されている場合、次の行を httpd.conf ファイルに追加します。
PerlSetEnv ORACLE_HOME "<absolute path to Oracle Home>"
次のサンプル Perl スクリプトを使用して、接続をテストすることも可能です。
##### Perl script start ######
use DBI;
print "Content-type: text/plain¥n¥n";
$dbh = DBI->connect("dbi:Oracle:", "scott/tiger", "") ||die $DBI::errstr;
$stmt = $dbh->prepare("select * from emp order by empno")|| die $DBI::errstr;
$rc = $stmt->execute() || die $DBI::errstr;
42
Oracle9i Application Server for HP Tru64 UNIXリリース・ノート
while (($empno, $name) = $stmt->fetchrow()) { print "$empno
$name¥n"; }
warn $DBI::errstr if $DBI::err;
die "fetch error: " . $DBI::errstr if $DBI::err;
$stmt->finish() || die "can't close cursor";
$dbh->disconnect() || die "cant't log off Oracle";
##### Perl script End ######
既知の問題点
この項では、リリース 1.0.2.2 の既知の問題点について説明します。
Oracle9i Application Server を使用する前に、この項の各アイテムを読み、このリリースの制限事項および制
約事項について理解してください。追加作業が必要になる場合もあります。各項目は、ソリューション分
野別に分類されています。
インストールに関する問題
ロケールの選択
Oracle9i Application Server のインストール用のロケールを選択するには、次のようにします。
1.
ご使用のプラットフォーム上で共通デスクトップ環境を使用して、開いているすべてのウィンドウを
閉じます。
2.
ログアウトします（デスクトップで右クリックして「Logout」を選択し、次に「OK」をクリックしま
す）。
3.
「Options」メニューから、適切なロケールを選択します。たとえば、ドイツ語のロケールの場合、次
のようにして選択します。
「Options」→「Language」→「C to es_BO」→「de (German)」
4.
ログインします（ユーザー名とパスワードを入力します）。
5.
端末エミュレータ・ウィンドウを開きます。
6.
次のコマンドを入力して、ロケールを検証します。
env | grep LANG
このコマンドの結果に、LANG 環境変数が含まれていて、その値がステップ 3 で選択した値になって
いる必要があります。
もし、LANG 環境変数が表示されなかったり、異なる値が設定されている場合は、.profile、.login、.cshrc
ファイル、または LANG 環境変数の設定または解除を行うその他のファイルを調べてください。
問題を修正した後、ステップ 1 からやり直してください。
7.
Oracle9i Appication Server を Compaq Tru64 UNIX にインストールします。
選択したロケールの翻訳版ファイルがインストールされます。さらに、英語のファイルは、常にイン
ストールされます。
Oracle9i データベースの初期化パラメータの手動設定の必要性
o7_dictionary_accessibility パラメータが FALSE に設定されている場合、Oracle9i Application Server の一部の
コンポーネントは、Oracle9i データベースと対話処理を行う際に正しく機能しない可能性があります。
Oracle9i データベースの init.ora ファイルに次の行を追加してください。
o7_dictionary_accessibility=TRUE
第２章 Oracle9i Application Server
43
Oracle Universal Installer における不正なインストール・ステータスの表示
コンポーネントのインストールの完了後に、Oracle Universal Installer によって「in progress」ステータスが
表示される場合があります。この状況は、Database Cache および Portal の構成ツールのインストール時に発
生し、1 回目の試行を取り消すと解決されます。2 回目の試行では、インストールの完了ステータスが正し
く表示されます。
インストール時のエラー
Oracle9i Application Server をインストールする前に、PATH、ORACLE_HOME および LD_LIBRARY_PATH
環境変数がコマンド・シェル初期化ファイル（たとえば、csh の場合.cshrc、bash の場合.bashrc または ksh
の場合$ENV など）で設定されていないことを確認してください。
初期化ファイルにこれらの変数のいずれかが設定されていると、Oracle9i Application Server のインストール
が失敗します。ログイン初期化ファイル（sh の場合.profile、csh の場合.login、ksh の場合.kshrc または bash
の場合.bash_login）にこれらの環境変数のいずれかが設定されていても、Oracle9i Application Server のイン
ストールには影響はありません。
インストール後に redo ログを開いた際のエラー
Oracle9i Application Server のシード・データベースのインストール後に、ユーザー・ダンプの場所に次のエ
ラーが出力される場合があります。
ORA-00313: open failed for members of log group 1 of thread 1
ORA-00312: online log 1 thread 1: '<redo log file_name>'
ORA-27037: unable to obtain file status
これらは深刻なエラーではありません。redo ログは、シード・データベース作成の将来のステップで作成
されます。
Standard Edition のキャラクタ・セット
のキャラクタ・セット
Oracle9i Application Server Standard Edition（SE）の一部として提供されている初期データベースでは、
US7ASCII キャラクタ・セットが使用されています。インストール後にデータベースのキャラクタ・セット
を変更するには、sqlplus を使用してデータベースに接続し、次の SQL 文を発行します。
SQL> alter database character set <character set>
詳細は、『Oracle8i NLS ガイド』を参照してください。
インストール時の root ユーザーのログイン
Oracle9i Application Server のインストール時に、root ユーザーでログインする際、次のコマンドを使用しな
いでください。
$ su
su コマンドでは環境変数が正しく設定されないため、インストールが失敗する可能性があります。かわり
に、別のセッションで root としてログインするか、または次のコマンドを使用してください。
$ su -root
非対話モードのインストール用レスポンス・ファイルの設定ガイド
Oracle9iAS リリース 1.0.2.2 の CD-ROM には、各インストール・オプションごとに 1 つずつ、合計 3 つの
Oracle Universal Installer 用のレスポンス・ファイルが含まれています。ご使用のインストール・オプション
に合せて、レスポンス・ファイルを編集する必要があります。
レスポンス・ファイルを使用するには、そのファイルを Oracle9i Application Server の CD-ROM からご使用
のシステムのドライブへコピーします。レスポンス・ファイルは、Disk#1 の/stage/Response ディレクトリ
に存在します。
Minimal Edition : oracle.iappserver.iapptop.Minimal.rsp
44
Oracle9i Application Server for Compaq Tru64 UNIX リリース・ノート
Standard Edition : oracle.iappserver.iapptop.Standard.rsp
Enterprise Edition : oracle.iappserver.iapptop.Enterprise.rsp
任意のテキスト・エディタを使用して、使用するレスポンス・ファイルを、ご使用のシステム固有の情報
が反映されるように編集します。各ファイルには、レスポンス・ファイルを正しく設定するための説明が
含まれています。
このドキュメントは、レスポンス・ファイルの編集用のリファレンスとしてご使用ください。ここでは、
前述の各レスポンス・ファイルの、非対話モードでインストールする場合に関連のあるセクションおよび
値の例を示しています。次のセクションについて説明します。
全インストール・タイプ共通（Minimal Edition、Standard Edition および Enterprise Edition）
Minimal Edition および Standard Edition インストール・タイプのみ
Standard Edition インストール・タイプのみ
Enterprise Edition インストール・タイプのみ
その他の構成ツール
root.sh の実行
必要な変更箇所の数:
Enterprise Edition: パラメータが 12 箇所、さらに Portal Configuration Assistant 固有のエントリが 7 箇所
Standard Edition: パラメータが 13 箇所、さらに Portal Configuration Assistant 固有のエントリが 7 箇所
Minimal Edition: パラメータが 10 箇所、さらに Portal Configuration Assistant 固有のエントリが 7 箇所
注意:
注意: UNIX_GROUP_NAME パラメータは、インベントリ・ディレクトリに設定する UNIX グループです。
インストーラのコマンドラインで、インベントリの場所をローカル・ディレクトリに指定した場合、
この値を入力する必要はありません。
FROM_LOCATION_CD_LABEL パラメータは、複数の CD を使用したインストール時にのみ使用し
てください。値は、"Oracle9i Application Server 1.0.2.2.0"です。
全インストール・タイプ共通（Minimal
Edition、
、Standard Edition および Enterprise Edition）
）
全インストール・タイプ共通（
合計: 9 箇所
[SESSION]
#Parameter: UNIX_GROUP_NAME
#Type: String
#Description: Unix group to be set for the inventory directory. Valid
only in Unix platforms.
#Example : UNIX_GROUP_NAME = "install"
UNIX_GROUP_NAME=<Value Unspecified>
#Parameter: FROM_LOCATION
#Type: String
#Description: Complete path of the products.jar.
#Example : FROM_LOCATION =
"/net/tools-nfs/inst_ias/solaris/ias10220/production/Disk1/stage/
products.jar"
FROM_LOCATION="/net/tools-nfs/inst_ias/solaris/ias10220/production/Disk1
/stage/products.jar"
第２章 Oracle9i Application Server
45
#Parameter: FROM_LOCATION_CD_LABEL
#Type: String
#Description: This variable should only be used in multi-CD
installations. It includes the label of the Compact Disk where
the file "products.jar" exists. The label can be found in the file
"disk.label" in the same directory as products.jar.
#Example : FROM_LOCATION_CD_LABEL = "CD Label"
FROM_LOCATION_CD_LABEL=<Value Unspecified>
#Parameter: ORACLE_HOME
#Type: String
#Description: Complete Location of the Oracle Home.
#Example : ORACLE_HOME = "C:¥OHOME1"
ORACLE_HOME="/private2/oracle/iasse2"
[oracle.webdb.apache_3.0.9.8.0]
#Parameter: user_input2
#Type: StringList
#Description: This variable holds the input from dialog2.
user_input2={"portal30", "portal30", "t816.world"}
#Parameter: user_input1
#Type: StringList
#Description: This variable takes the input from the first dialog.
user_input1={"portal30_sso", "portal30_sso", "t816.world"}
[portaltogo.server_1.1.0.0.0]
#Parameter: SYSTEM_PASSWORD
#Type: String
#Description: This will hold the panama SYSTEM user password
SYSTEM_PASSWORD="manager"
#Parameter: SRV_USER
#Type: StringList
#Description: This will hold the Portal-to-Go User and Password
SRV_USER={"scott", "tiger"}
#Parameter: SRV_HOST
#Type: StringList
#Description: This will hold the Portal-to-Go host variables
SRV_HOST={"london.us.oracle.com", "2021", "l816"}
Minimal Edition および Standard Edition インストール・タイプのみ
合計: 1 箇所
46
Oracle9i Application Server for Compaq Tru64 UNIX リリース・ノート
[oracle.iappserver.iapptop_1.0.2.2.0]
#Parameter: startupProcesses
#Type: StringList
#Description: StringList of processes to configure and start
automatically in iAS Installation. This variable is used only in
Enterprise Edition installs (in other install types, all processes are
automatically started). Possible values that can be
included in the StringList are the strings "Oracle HTTP Server in
Non-SSL mode", "Oracle9iAS Portal".
If the StringList is empty, no processes are started. For example, the
#StringList {"Oracle HTTP Server in Non-SSL mode",
"Oracle9iAS Portal"} would configure and start up those products.
startupProcesses={"Oracle HTTP Server in Non-SSL mode",
"Oracle 9iASPortal"}
Standard Edition インストール・タイプのみ
合計: 3 箇所
[oracle.assistants.dbca_8.1.7.0.0]
#Parameter: s_globalDBName
#Type: String
#Description: Global Database Name
s_globalDBName="m10ee2.world"
#Parameter: s_mountPoint
#Type: String
#Description: Database file location: directory for datafiles, control
files, redo logs.
s_mountPoint="/private2/oracle/iasee2/dbs"
#Parameter: s_dbSid
#Type: String
#Description: Value that $ORACLE_SID will be set to.
s_dbSid="m10ee2"
Enterprise Edition インストール・タイプのみ
合計: 3 箇所
[oracle.iappserver.iapptop_1.0.2.2.0]
#Parameter: startupProcesses
#Type: StringList
#Description: StringList of processes to configure and start
automatically in iAS Installation. This variable is used only in
第２章 Oracle9i Application Server
47
Enterprise Edition installs (in other install types, all processes are
automatically started). Possible values that can be
included in the StringList are the strings "Oracle9iAS Database Cache" ,
"Oracle9iAS Forms and Reports Services" ,
"Oracle HTTP Server in Non-SSL mode" , "Oracle9iAS Web
Cache" , "Oracle9iAS Portal" ,
"Oracle9iAS Discoverer", "Oracle Management Server". If the StringList
is empty, no processes are started.
For example, the
#StringList {"Oracle9iAS Database Cache" , "Oracle9iAS Forms and
Reports Services" ,"Oracle HTTP Server in Non-SSL mode", "Oracle9iAS Web Cache",
"Oracle9iAS Portal","Oracle9iAS Discoverer","Oracle Management Server"}
[oracle.icache.icacheca_1.0.2.2.0]
#Parameter: sl_dbaReturn
#Type: StringList
#Description: Name and Password of SYSDBA user on origin DB.
sl_dbaReturn={"sys", "change_on_install"}
#Parameter: sl_connectStringReturn
#Type: StringList
#Description: Fields are: Name of origin DB machine, Port number of
listener on origin (often 1521), Service name of
origin DB.
sl_connectStringReturn={"london.us.oracle.com", "2021", "l816.world"}
Portal Configuration Assistant のみ（全インストール・タイプ共通）
合計: 7 箇所
注意:
注意: レスポンス・ファイルで次の 4 つの表領域名に値が指定されていない場合、OPCA ではデフォルト
値が使用されます。該当する表領域名と値は次のとおりです。使用する値がこれらと同じである場
合、レスポンス・ファイルで指定する必要はありません。
tmp_tablespace="TEMP"
log_tablespace="USERS"
doc_tablespace="USERS"
def_tablespace="USERS"
[oracle.webdb_3.0.9.8.0]
#Parameter: silent
#Type: Boolean
#Description: This variable is true if silent mode is on. It is passed
to the wwv component.
silent=true
48
Oracle9i Application Server for Compaq Tru64 UNIX リリース・ノート
[oracle.webdb.apache_3.0.9.8.0]
#Parameter: opca_tnsconnect
#Type: String
#Description: tns connect string which is required by Oracle Portal
Config Assistant. This should be in <machine
name>:<port>:<sid> format.
opca_tnsconnect="london.us.oracle.com:2021:l816"
[oracle.webdb.wwv_3.0.8.9.8]
#Parameter: sys_password
#Type: String
#Description: System Password for Portal's OPCA
sys_password="change_on_install"
#Parameter: temporary_tablespace
#Type: String
#Description: Temporary Tablespace for Portal's OPCA
temporary_tablespace="TEMP"
#Parameter: logging_tablespace
#Type: String
#Description: Logging tablespace for Portal's OPCA
logging_tablespace="USERS"
#Parameter: document_tablespace
#Type: String
#Description: Document Tablespace for Portal's OPCA
document_tablespace="USERS"
#Parameter: default_tablespace
#Type: String
#Description: Default Tablespace for Portal's OCPA
default_tablespace="USERS"
その他の構成ツール
DBCA および Net Configuration Assistant
これらのツールは、Oracle9i Application Server を非対話モードで実行する場合も標準モードで実行されるた
め、レスポンス・ファイルは不要です。
Oracle9iAS Database Cache Configuration Assistant
このツールのユーザー入力は、Enterprise Edition のレスポンス・ファイル内に存在する前述のコンポーネン
ト[oracle.icache.icacheca_1.0.2.2.0]の 2 つのパラメータ、sl_dbaReturn および
sl_connectStringReturn パラメータによって指定されます。
Oracle Internet File System Configuration Tool
製品に付属のファイル・テンプレート IfsConfig.properties を使用します。これは、インストール後
に行う作業です。この構成ツールは Oracle9i Application Server のインストール時には実行されません。
第２章 Oracle9i Application Server
49
Oracle Management Server
非対話モードは、Oracle9i Application Server リリース 1.0.2 ではサポートされていません。Oracle9i
Application Server 2.0 でサポートされる予定です。
root.sh の実行
show_rootsh_confirmation=false パラメータを設定し、root.sh をインストール後に実行することが
可能です。/etc/oratab がインストーラ・プロセスの所有者によって書込み可能であり、Database
Configuration Assistant（DBCA）および iCache Configuration Assistant（icacheca）によって oratab ファイルが
更新可能であることを確認する必要があります。そうでない場合、DBCA および icacheca は、構成ツール
の起動時に失敗します。
Enterprise Edition のレスポンス・ファイルのセクションおよびパラメータ
[SESSION]
#Parameter: UNIX_GROUP_NAME
#Type: String
#Description: Unix group to be set for the inventory directory. Valid
only in Unix platforms.
#Example : UNIX_GROUP_NAME = "install"
UNIX_GROUP_NAME=<Value Unspecified>
#Parameter: FROM_LOCATION
#Type: String
#Description: Complete path of the products.jar.
#Example : FROM_LOCATION = "../stage/products.jar"
FROM_LOCATION=
"/private1/balbert/dve/production/Disk1/stage/products.jar"
#Parameter: FROM_LOCATION_CD_LABEL
#Type: String
#Description: This variable should only be used in multi-CD
installations. It includes the label of the Compact Disk where
the file "products.jar" exists. The label can be found in the file
"disk.label" in the same directory as products.jar.
#Example : FROM_LOCATION_CD_LABEL = "CD Label"
FROM_LOCATION_CD_LABEL="9iAppServer"
#Parameter: ORACLE_HOME
#Type: String
#Description: Complete Location of the Oracle Home.
#Example : ORACLE_HOME = "C:¥OHOME1"
ORACLE_HOME="/private1/oracle/iasee1"
#Parameter: TOPLEVEL_COMPONENT
#Type: StringList
#Description: The Toplevel component that has to be installed in the
current session.
#The following choices are available. The value should contain only one
of these choices.
50
Oracle9i Application Server for Compaq Tru64 UNIX リリース・ノート
#The choices are of the form Internal Name, Version : External name.
Please use the internal name and version while
specifying the value.
# oracle.iappserver.iapptop, 1.0.2.0.1 : Oracle9i Application Server 1.0.2.0.1
#Example : TOPLEVEL_COMPONENT = {"oracle.iappserver.iapptop","1.0.2.0.0"}
TOPLEVEL_COMPONENT={"oracle.iappserver.iapptop","1.0.2.0.1"}
[oracle.iappserver.iapptop_1.0.2.0.1]
#Parameter: startupProcesses
#Type: StringList
#Description: StringList of processes to configure and start
automatically in iAS Installation. This variable is used only in
Enterprise Edition installs (in other install types, all processes are
automatically started). Possible values that can be
included in the StringList are the strings: "Oracle Database Cache" ,
"Forms and Reports Server" , "Oracle HTTP Server
(on port 7777)" , "Oracle Web Cache", "Oracle Discoverer 3i Viewer",
"Oracle Portal", "Oracle Management Server". If
the StringList is empty, no processes are started. For example, the
#StringList {"Oracle Database Cache","Forms and Reports Server"} would
configure and start up those products.
#Possible Values are { "Oracle Database Cache" , "Forms and Reports
Server" , "Oracle HTTP Server (on port 7777)" ,
"Oracle Web Cache" , "Oracle Discoverer 3i Viewer" , "Oracle Portal",
"Oracle Management Server" }
#But Following 4 config tools doesn't support silent modes:
#1. "Oracle Web Cache" , 2. "Oracle Portal", 3. "Oracle Database Cache"
, 4. "Oracle Management Server"
startupProcesses={"Forms and Reports Server" , "Oracle HTTP Server (on
port 7777)" , "Oracle Discoverer 3i Viewer"
}
[oracle.webdb.apache_1.3.12.0.0a]
#Parameter: user_input2
#Type: StringList
#Description: This variable holds the input from dialog2.
user_input2={"portal30", "portal30", "t816.world"}
#Parameter: user_input1
#Type: StringList
#Description: This variable takes the input from the first dialog.
user_input1={"portal30_sso", "portal30_sso", "t816.world"}
[portaltogo.server_1.0.2.2.0]
第２章 Oracle9i Application Server
51
#Parameter: SYSTEM_PASSWORD
#Type: String
#Description: This will hold the panama SYSTEM user password
SYSTEM_PASSWORD="manager"
#Parameter: SRV_USER
#Type: StringList
#Description: This will hold the Portal-to-Go User and Password
SRV_USER={"scott", "tiger"}
#Parameter: SRV_HOST
#Type: StringList
#Description: This will hold the Portal-to-Go host variables
SRV_HOST={"toronto.us.oracle.com", "2021", "t816"}
[oracle.icache.icacheca_1.0.2.0.0]
#Parameter: sl_dbaReturn
#Type: StringList
#Description: Name and Password of SYSDBA user on origin DB.
sl_dbaReturn={"sys", "change_on_install"}
#Parameter: sl_connectStringReturn
#Type: StringList
#Description: Fields are: Name of origin DB machine, Port number of
listener on origin (often 1521), Service name of
origin DB.
sl_connectStringReturn={"toronto.us.oracle.com", "2021", "t816.world"}
Oracle9iAS Database Cache のインストール時のエラー
Oracle9iAS Database Cache のインストール時に、オリジナル・データベースのリスナーが正しく設定されて
いない場合、次のエラーが発生する可能性があります。
Adding users to the cache failed.
Reason: WTE-03501 Error updating list of users: Export failed on origin database
OCI error - ORA-28575: unable to open RPC connection to external procedure agent
オリジナル・データベースのリスナーの設定方法の詳細は、『Oracle9i Application Server インストレーシ
ョン・ガイド』を参照してください。
Oracle9iAS Database Cache の設定
Oracle9i Application Server Enterprise Edition をインストールする際、Oracle9iAS Database Cache をインストー
ル中に設定するか、または後で設定するかを選択できます。インストール中に Oracle9iAS Database Cache
を設定するように選択した場合、インストール・プロシージャにより、Oracle9iAS Database Cache の次の属
性にデフォルト値が使用されます。
Oracle9iAS Database Cache のホスト（デフォルト: ドメイン名付きホスト名）
Oracle9iAS Database Cache の名前（デフォルト: <cache_nodename-cache>）
52
Oracle9i Application Server for Compaq Tru64 UNIX リリース・ノート
Oracle9iAS Database Cache のリスナーのポート番号（デフォルト: 51719）
Oracle9iAS Database Cache の割当てメモリー（デフォルト: 25MB）
Oracle9iAS Database Cache の割当てディスク領域（デフォルト: 32MB）
ディスク領域を保持するファイルの場所（デフォルト: $ORACLE_HOME/dbs ディレクトリ）
デフォルト値以外の値を指定する場合、インストール中に Oracle9iAS Database Cache を設定しないよう選
択します。そして、インストールが正しく完了した後、次のコマンドを使用して Oracle9iAS Database Cache
Configuration Assistant を起動します。
prompt>$ORACLE_HOME/bin/wtacca -create -custom
詳細は、Configuration Assistant のオンライン・ヘルプを参照してください。
同じ Oracle ホームへの再インストール時の Oracle HTTP Server 設定の変更点の保持
httpd.conf、jserv.conf、zone.properties およびその他の変更を加えた Oracle HTTP Server 設定
ファイルのコピーをすべて保存しておいてください。Oracle9iAS を同じ Oracle ホームに再インストールす
ると、既存の設定ファイルは新しくインストールされたファイルによって上書きされてしまいます。
RDBMS パッチのインストール・ダイアログの表示
Oracle9iAS Enterprise Edition のインストール時に、次の RDBMS パッチのインストール・ダイアログが表示
される場合があります。
「You have enabled the ORATAB_FAIL feature by setting the environment variable ORATAB_FAIL to
TRUE. This will allow you to continue installation eventhough there is no write permission on ORATAB
(/var/opt/oracle/oratab) file.
Currently ORATAB file does not exist, or is not writtable by the user. You can run the orainst/oratab.sh script
as the root user to create the file or modify its permissions. In that case select [Shell] to invoke a new window
from which to run the oratab.sh script, or exit the installer and restart it after oratab.sh has been run.
If you decide to continue without changing the ORATAB permissions, select OK. But this installation session
will not update ORATAB file and OCSM functionalities may not work properly. However running root.sh in
the end will update the ORATAB file.」
「OK」をクリックしてインストールを続行します。ダイアログに表示されているように、シェルを開始し
たりスクリプトを実行する必要はありません。
Oracle Forms、
、Reports および Discoverer のパッチのインストール
パッチのインストール時には、Forms、Reports および Discoverer の ORACLE_HOME として
<IAS_HOME>/6iserver を使用してください。<IAS_HOME>は、Oracle9i Application Server で使用される
ORACLE_HOME です。
openssl の要件
Oracle9i Application Server で SSL の秘密鍵を生成する際に、以下のような警告の後で終了する場合がありま
す。
warning, not much extra random data, consider using the -rand option Generating RSA private key,1024 bit
long modulus 23973:error:24064064:random number generator:SSLEAY_RAND_BYTES:PRNG not
seeded:md_rand.c:538:23973:error:04069003:rsa routines:RSA_generate_key:BN lib:rsa_gen.c:182:
いくつかの UNIX プラットフォームでは/dev/random が openssl の必要とする乱数を生成するために必要と
なります。オペレーティングシステムのマニュアルをご参照の上、乱数生成のガイドラインをご確認下さ
い。
第２章 Oracle9i Application Server
53
アンインストールおよび移行に関する問題点
アンインストールおよび移行に関する問題点
Oracle Universal Installer を使用した Oracle9iAS Database Cache のアンインストールによる依存コン
ポーネントの削除
Oracle Universal Installer を使用して Oracle9iAS Database Cache をアンインストールすると、すべてのサービ
スがアンインストールされます。Oracle9iAS Database Cache をアンインストールするには、次のコマンドを
使用します。
1.
キャッシュが稼動中であることを確認します。稼動中でない場合、Cache Manager を使用するか、
$ORACLE_HOME/bin ディレクトリ内の cachstrt スクリプトを使用してキャッシュを起動します。
2.
-deinstall オプションを指定して Database Cache Configuration Assistant を実行します。
prompt>wtacca -deinstall
OraInventory ディレクトリの移行前にバックアップが必要
Oracle Universal Installer で移行プロセスを実行する前に、OraInventory ディレクトリをバックアップする必
要があります。
移行が失敗するか、途中で中止されると、Oracle Universal Installer によって OraInventory ディレクトリが変
更されているため、その後の処理が失敗する可能性があります。移行プロセスが完了しなかった場合、移
行前のバックアップ・ファイルから OraInventory ディレクトリを復元してから、移行を再試行してくださ
い。
Oracle HTTP Server 起動時のエラー
Oracle9i Application Server をアンインストールし、同じ Oracle ホームに再インストールした後、Oracle HTTP
Server を起動すると次のエラーが発生する可能性があります。
Syntax error on line 14 of <ORACLE_HOME>Apache/Apache/conf/mod__ose.conf:
AuroraService - directive already in effect for this server
このエラーを解決するには、次のステップを実行します。
1.
2.
<ORACLE_HOME>Apache/Apache/conf/oracle_apache.conf ファイルを開きます。
次の行の重複を削除します。
include "<ORACLE_HOME>Apache/Apache/conf/mod__ose.conf:"
3.
Oracle HTTP Server を再起動します。
SOAP のリリース・ノートおよびドキュメントのリンクが機能しない
リリース 1.0.2 またはリリース 1.0.2.1 からリリース 1.0.2.2 にアップグレードまたは移行した後、"SOAP
Release Notes and Documentation"というタイトルの index.html ページのリンクは機能しません。
この問題を解決するには、次のようにします。
1.
次のディレクティブを ORACLE_HOME/Apache/Apache/conf/httpd.conf ファイルに追加します。
Alias /soapdocs/ "ORACLE_HOME/soap/"
（ORACLE_HOME は Oracle ホーム・ディレクトリの絶対パスです）。
2.
サーバーを再起動します。
移行後の nmxw.ora のインスタンス化の必要性
のインスタンス化の必要性
Oracle9iAS リリース 1.0.2.0.1 またはリリース 1.0.2.1 からリリース 1.0.2.2 への移行後、
nmxw.ora ファイルを
手動でインスタンス化し、Web サーバーの ServerRoot、ConfigFile および ApacheVersion ディレクティブに
値を挿入する必要があります。これらに値が挿入されていない場合、Enterprise Manager Console は HTTP
サーバーを検出できません。
54
Oracle9i Application Server for Compaq Tru64 UNIX リリース・ノート
このファイルのパスは ORACLE_HOME/network/agent/config/です。
Core Edition への Minimal/Standard/Enterprise Edition の上書きインストールでの既知の問題点
1.
すでに Core Edition がインストールされている ORACLE_HOME に Minimal/Standard/Enterprise Edition
をインストールする場合には、まず Oracle HTTP Server を停止する必要があります。停止していな
い場合には「Apache Listener Configuration for Oracle9iAS Portal（DAD およびスキーマ名）」画面で
次へボタンを押すとエラーが返されます。この場合には Oracle HTTP Server を停止して、インスト
ール作業を続行してください。
2.
Oracle HTTP Server を停止してから、
すでに Core Edition がインストールされている ORACLE_HOME
に Minimal/Standard/Enterprise Edition をインストールする場合には、インストール・プロセスでエラ
ーメッセージは出ません。しかし、インストール後に Portal の設定を手動で行う必要があります。
$ORACLE_HOME/Apache/modplsql/cfg/wdbsvr.app に Portal の接続情報を設定してください。
インターネット・アプリケーション・ソリューションの分野の問題点
Oracle HTTP Server powered by Apache
Oracle HTTP Server powered by Apache の Global Server ID
Apache サーバーに適切な GS-ID 証明書が含まれており、GS-ID を受け入れるためのパッチがブラウザ
に適用されている場合、Global Server ID を使用すると、
輸出レベルのブラウザをアップグレードして、
高度な暗号化（128 ビット）を使用できます。すべてのブラウザに高度な暗号化機能が備わっていま
すが、輸出製品の場合、この機能は使用不可の状態で出荷されています。米国輸出法が最近変更され
たため、将来は GS-ID は不要になります。ただし、現在、輸出レベルのブラウザを使用しており、高
度な暗号化が必要な場合、次のステップを実行して GS-ID 証明書を取得し、ブラウザで高度な暗号化
を使用可能にしてください。
1.
GS-ID 証明書を購入する。
適切なベンダーから GS-ID 証明書を入手します。オラクル社では、ベリサイン社の GS-ID 証明書
をテスト済みです。詳細は、次の Web サイトを参照してください。
http://www.verisign.com/server/prd/g/index.html
手順に従って証明書をダウンロードし、サーバーに保存します。証明書の取得後、Oracle HTTP
Server 管理者は、httpd.conf ファイルを更新する必要があります。更新する行は次のとおりで
す。
SSLCertificateFile <pathname>/gsid.crt
SSLCertificateKeyFile <pathname>/gsid.key
SSLCertificateChainFile <pathname>/gsidintermediate.crt
pathname は、インストール済みの Verisign ファイルの絶対パスです。
2.
ブラウザのパッチを購入する。
ブラウザの暗号化方式をアップグレード可能にするパッチを入手します。ブラウザのパッチは、
次の Apache または Fortify のサイトから入手可能です。
http://www.apache.org
http://www.fortify.net/intro.html
第２章 Oracle9i Application Server
55
Oracle Demo 証明書の置換
Oracle Demo 証明書（ダミーの証明書）が Oracle HTTP Server powered by Apache のビルドに含まれて
いますが、これはテスト環境でのみ使用可能です。本番環境に移る前に、Oracle Demo 証明書を実際
に利用する証明書に置き換える必要があります。
仮想ホスト使用時の"APACHECTL
-START"による
による Apache 起動エラー
仮想ホスト使用時の
ポート番号ディレクティブと NameVirtualHost ディレクティブ・ポートが一致しない場合、このエラ
ーが発生します。この問題を解決するには、ポートおよび NameVirtualHost が同じポートに設定され
ていることを確認してください。また、この問題は、NameVirtualHost ディレクティブのポート番号を
指定しないことによっても解決できます。
この問題は、SSL を使用せずに起動した場合のみ発生します。
Apache JServ アプリケーション用のメモリーの増加
Apache JServ ログまたはブラウザにより「メモリー不足」という状況が報告された場合、大半は、JVM
のメモリー不足に起因している可能性があります。通常、JVM によって処理されるデータがメモリー
割当てプールを超過した場合にこの状況が発生します。
JVM のメモリー割当てプールの最大サイズを増加するには、次のステップを実行します。
1.
$ORACLE_HOME/Apache/Jserv/etc/jserv.properties に次の行を追加します。
wrapper.bin.parameters=-mx<size>m
<size>はメモリー割当てプールのサイズ（メガバイト単位）です。デフォルト値は、メモリー1
メガバイトです。オラクル社では、128 メガバイトのサイズの使用をお薦めします。値を 128 メ
ガバイトに設定するには、次の行を追加します。
wrapper.bin.parameters=-mx128m
2.
変更後、Web サーバーを再起動し、変更を反映させます。
mod_plsql の要件
mod_plsql モジュールを特定のバックエンド・データベースに対して使用するには、Oracle PL/SQL Web
Toolkit（OWA PL/SQL パッケージ）をバックエンド・データベースに手動でインストールする必要が
あります。OWA PL/SQL パッケージは、SYS データベース・スキーマにインストールする必要があり
ます。OWA PL/SQL パッケージが 1 つのみインストールされていることを確認してください。既存の
Oracle Application Server（OAS）から Oracle9i Application Server にアップグレードする場合、以前のバ
ージョンの OWS PL/SQL パッケージが存在するため、これらを新しいバージョンに置き換える必要が
あります。
詳細は、『Oracle9i Application Server PL/SQL ゲートウェイの使用』を参照してください。
mod_plsql のキャッシング・エラー
mod_plsql のキャッシングが正しく動作しない場合、$ORACLE_HOME/Apache/modplsql/cfg/cache.cfg
内の 2 つの cache_dir エントリから最後のスラッシュを削除します。
Oracle Application Server の OWA パッケージの復元
新しい mod_plsql OWA パッケージをインストールすると、SYS データベース・スキーマに格納されま
す。これにより、PL/SQL カートリッジを使用している Oracle Application Server のアプリケーション
で問題が発生する可能性があります。このような問題が発生し、Oracle Application Server の PL/SQL
カートリッジ・アプリケーションを引き続き使用する場合、Oracle Application Server の OWA パッケ
ージを参照するシノニムを再作成する必要があります。
オリジナル・データベース・マシンでこれらのシノニムを作成するには、次のステップを実行します。
56
Oracle9i Application Server for Compaq Tru64 UNIX リリース・ノート
1.
SQL*Plus で、SYS ユーザーとしてオリジナル・データベースに接続します。
2.
SQL*Plus で次のコマンドを実行します。これにより、Oracle9i Application Server のインストール・
プロセス中に作成された OWA パブリック・シノニムがすべて削除されます。
drop public synonym OWA_CUSTOM;
drop public synonym OWA_GLOBAL;
drop public synonym OWA;
drop public synonym HTF;
drop public synonym HTP;
drop public synonym OWA_COOKIE;
drop public synonym OWA_IMAGE;
drop public synonym OWA_OPT_LOCK;
drop public synonym OWA_PATTERN;
drop public synonym OWA_SEC;
drop public synonym OWA_TEXT;
drop public synonym OWA_UTIL;
drop public synonym OWA_INIT;
drop public synonym OWA_CACHE;
drop public synonym WPG_DOCLOAD;
3.
"oas_public" という OWA パッケージ・インストール・スキーマに接続します。
4.
ユーザー・スキーマに"CREATE PUBLIC SYNONYM"権限があることを確認します。権限がない
場合、次のステップに進む前に、これらの権限をユーザー・スキーマに付与します。
5.
SQL*Plus で次のコマンドを実行します。これにより、OWA パブリック・シノニムが再作成され、
Oracle Application Server の OWA パッケージが参照されます。
create public synonym OWA_CUSTOM for OWA_CUSTOM;
create public synonym OWA_GLOBAL for OWA_CUSTOM;
create public synonym OWA for OWA;
create public synonym HTF for HTF;
create public synonym HTP for HTP;
create public synonym OWA_COOKIE for OWA_COOKIE;
create public synonym OWA_IMAGE for OWA_IMAGE;
create public synonym OWA_OPT_LOCK for OWA_OPT_LOCK;
create public synonym OWA_PATTERN for OWA_PATTERN;
create public synonym OWA_SEC for OWA_SEC;
create public synonym OWA_TEXT for OWA_TEXT;
create public synonym OWA_UTIL for OWA_UTIL;
create public synonym OWA_INIT for OWA_CUSTOM;
create public synonym OWA_CACHE for OWA_CACHE;
create public synonym WPG_DOCLOAD for WPG_DOCLOAD;
8.1.7.0 から 8.1.7.1 へのアップグレード時の既知の問題点
Oracle9i Application Server ベースの mod_plsql アプリケーション（Oracle Portal など）を実行している
場合、8.1.7.1 へのアップグレードにより、データベース付属のデフォルトの OWA パッケージが再イ
ンストールされる点に注意してください。これらのパッケージは、Oracle9i Application Server/Oracle
Portal 付属のものより古く、Oracle Portal の一部のコンポーネントの実行時に問題が発生します。
関連項目:
関連項目 バグ番号 1745320
第２章 Oracle9i Application Server
57
この問題の回避策としては、アップグレードの最後に、Oracle9i Application Server から OWA パッケー
ジを再インストールする必要があります。
1.
8.1.7.1 へのアップグレードをまだ実行していない場合、回避策は次のとおりです。
$ORACLE_HOME/rdbms/admin/catproc.sql ファイルを編集します。
2.
OWA パッケージをロードする"@@owacomm.sql"という行をコメント化します。
Oracle9i Application Server からデータベースにすでにロードされている OWA パッケージが保持されま
す。
注意:
注意 OWA パッケージを再インストールする場合、無効になった依存オブジェクトをすべて再コン
パイルする必要があります。
mod_rewrite のセキュリティの脆弱性
mod_rewrite において、一部のルールを使用すると、Web サーバー上のあらゆるファイルにアクセス可
能になるというセキュリティ上の脆弱性が判明しています。これらの問題を回避するには、書換えル
ールを直接ファイルにマップするのではなく、すべて絶対 URL にマップします。
たとえば、ご使用の Web サーバーで DocumentRoot に/webroot が設定されている場合、次のルールは
使用しないでください。
RewriteRule /foobar/(.*) /webroot/myfiles/$1
この場合、リクエストが直接ファイルシステムの場所にマップされてしまいます。かわりに、次のル
ールを使用します。
RewriteRule /foobar/(.*) http://myserver.mydomain.com/myfiles/$1
この場合、アクセスは、Apache インスタンスによってアクセス可能なファイル（つまり、DirectoryRoot
ディレクトリ・ツリーに含まれるファイル）のみに制限されます。
OpenSSL の CA 機能の非サポート
OpenSSL の認証局（CA）機能はサポートされていないため、使用しないでください。Oracle9i Application
Server は Certicom SSL スタックに移動しており、
ここには SSL の CA 機能は含まれていません。
openssl
コマンドは、証明書要求の生成にのみ使用してください。証明書の調査、証明書の署名など、その他
の機能は、オラクル社ではサポートしていません。
mod_ssl の制約事項
リリース 1.0.2.2 では、
対称型暗号化アルゴリズム RC2、
RC5 および IDEA はサポートされていません。
mod_oprocmgr のドキュメントの誤り
のドキュメントの誤り
Oracle9i Application Server のドキュメント「Using mod_oprocmgr with mod_jserv」（部品番号:
A90282-01）に、完全に動作しないステータス・ハンドラに関する記述が存在します。mod_oprocmgr
の現在の機能を反映するために、二重引用符で囲まれた次の項目をドキュメントから削除してくださ
い。
2 ページの「System Administration（システム管理）」の項:
"mod_oprocmgr provides a status handler which displays process information stored in shared memory."
3 ページの「Changes to httpd.conf（httpd.conf への変更）」の項:
"<Location /oprocmgr-status>
SetHandler oprocmgr-status
</Location> "
4 ページの「Changes to jserv.properties（jserv.properties への変更）」の項:
58
Oracle9i Application Server for Compaq Tru64 UNIX リリース・ノート
"or
port=8007 9000-9010 8010 "
7 ページの「Checking JServ Process Status（JServ プロセスのステータスの確認）」の項:
"The directive shown in "Changes to httpd.conf" includes a status handler that enables you to monitor JServ
processes managed by mod_oprocmgr. You can access the status handler at
http://myhost:port/oprocmgr-status, and display a page similar to that shown below."
（スクリーン・キャプチャには、正しく機能しないボタンが表示されているため、これも削除する必
要があります。）
"If there are zeroes instead of port numbers in the Process Port column, it could be that the JServ processes have
not yet registered with the process manager. If you refresh the browser window and the port numbers still do not
appear, then the JServ processes were unable to start (possibly because the specified ports were unavailable).
Ensure that the specified ports are free, and that you have allotted enough port numbers for the JServ processes.
To determine the cause of errors, see jserv.log and mod_jserv.log."
HTTP サーバーのインフラストラクチャ・ウォッチャによる JVM の一時停止の可能性
HTTP サーバーのインフラストラクチャにはウォッチャ・コンポーネントが含まれており、自動的に
起動された JServ プロセスを監視します。JServ プロセスが応答しなくなると、ウォッチャにより、そ
のプロセスが停止され、別のプロセスが起動されて置き換えられます。JVM の負荷が高いか、または
ガベージ・コレクションを実行している場合にも、やはり JVM は一時停止されます。JVM の終了を
防ぐためには、jserv.conf ファイルのタイムアウト値（ApJServVMTimeout）を大きくするか、または
JVM のヒープ・サイズを小さくしてガベージ・コレクションの時間を短くします。
同じ URL を使用した 2 回目のリクエストで有効なサーブレット・リクエストが失敗
有効なサーブレットが 1 回リクエストされ、さらにそのサーブレットの URL の URL エンコード・バ
ージョンを使用して再びリクエストされると、2 回目のリクエストは失敗し、Apache の error_log にエ
ラーが記録される可能性があります。
たとえば、次の例の 2 番目の URL によって HTTP エラーが発生する可能性があります。
http://mysite/demo/basic/hellouser/hellouser.jsp
http://mysite/demo/basic/hellouser/hellouser%2ejsp
サーバーは実行を継続し、エンコードされていないバージョンの URL は正しく機能します。
回避策としては、常に各 URL のエンコード・バージョンを使用するか、または常に各 URL のエンコ
ードされていないバージョンを使用するようにします。混在して使用する必要がある場合、必ず、エ
ンコードされていないバージョンを使用する前にエンコード・バージョンを使用します（サーバーの
各実行のたびに）。
DMS クライアントの設定の変更の必要性
DMS クライアント（flexmon、oasomo、ohsTree および EMD を含む）が正しく機能するように、
soap.properties を若干変更する必要があります。SOAP サーバー（および独自の JServ プロパティ・フ
ァイルを持つ各プロセス・グループごと）に、"root"というゾーンが存在する必要があります。DMS
クライアントは、このゾーンを使用して、パフォーマンス・メトリックを取得します。
"root"ゾーンを soap.properties ファイルに追加するには、soap.properties の中の 1 行を変更し、
soap.properties に新しい行を 1 行追加する必要があります。
次のように変更します。
1.
%ORACLE_HOME%/Apache/Jserv/etc/ jservSoap.properties ファイルを開き、次のステップを実行し
ます。
zones=soap
次のように変更します。
zones=soap,root
第２章 Oracle9i Application Server
59
次のような行を探します。
soap.properties=%ORACLE_HOME%/soap/webapps/soap/WEB-INF/config/
soap.properties
その後に、次の行を追加します。
root.properties=%ORACLE_HOME%/Apache/Jserv/etc/zone.properties
（%ORACLE_HOME%を、展開済みの ORACLE_HOME 環境変数に置換します。）
2.
サーバーを再起動します。
3.
テストするには、次の URL を使用します（mysite をご使用のサイトの hostname:port に置換しま
す）。
@
http://mysite/dms/AggreSpy
この URL への 1 回目のアクセスでは、一部のメトリックが使用できないという
メッセージが返される可能性がありますが、その後のアクセスでは、有効なメトリック値が返さ
れます。サーバーが正しく設定されていない場合、URL により、長時間のタイムアウトの遅延、
Apache の error_log ファイルでのエラー、および HTTP リクエストに対する応答エラーが発生し
ます。
JServ の LANG 環境変数
LANG 環境変数により、アプリケーション・プログラムのデフォルトのロケールが指定されます。サ
ーブレットおよび JSP が英語以外のロケールで正しく動作するようにするには、Oracle9iAS のインス
トール後、Oracle HTTP Server の起動前に、次の作業を実行する必要があります。
$ORACLE_HOME/Apache/Jserv/etc/jserv.properties ファイルを開き、サーブレットおよび JSP を実行す
る Java VM のデフォルトのロケールが、LANG 環境変数に対応して初期化されるようにします。
#wrapper.env.copy=LANG
負荷が高い場合の HTTP サーバーのタイムアウト
Oracle HTTP Server の負荷が高い場合、リクエストがタイムアウトになり、大きな（10MB 以上の）静
的ファイルの送信が完了しないことがあります。これに対処するには、httpd.conf の TimeOut ディレク
ティブの値を大きくします。
キャッシュ・ソリューション分野の問題点
Oracle9iAS Database Cache
Oracle9iAS Database Cache をサーブレットとともに使用する
サーブレットを使用して中間層にキャッシュされたデータにアクセスするには、サーブレット環境の
ORA_OCI_CACHE 環境変数を設定して Oracle9iAS Database Cache を使用可能にする必要があります。
$ORACLE_HOME/Apache/Jserv/etc ディレクトリ内の jserv.properties ファイルに次の行を追加し
ます。
wrapper.env=ORA_OCI_CACHE=1
さらに、TNS_ADMIN 環境変数を、ローカル・ネットワーク設定の場所に設定する必要があります。
この値のデフォルトは、
$ORACLE_HOME/network/admin です。
次の行を jserv.properties に追加します。
wrapper.env=TNS_ADMIN=<absolute path to Oracle Home>/network/admin
60
Oracle9i Application Server for Compaq Tru64 UNIX リリース・ノート
Oracle9iAS Database Cache 環境での loadjava の制約事項
Oracle9iAS Database Cache 環境での LOB サポートに関する既知の問題により（ORA_OCI_CACHE が 1
に設定されている場合）、loadjava ユーティリティは動作しません。
ConText 索引が含まれている表のキャッシュ時の Oracle9iAS Database Cache の応答停止
ConText 索引が含まれている表のキャッシュ時に dbms_icache.add_table を使用すると、Oracle
Database Cache は応答を停止（ハング）します。また、バックエンド・データベースで ORA-600 エラ
ーが発生します。現在、この問題の解決策は存在しません。
キャッシュの環境変数の設定
ORA_OCI_CACHE システム環境変数における問題により、負荷があまり高くない状態で mod_plsql が
中断または停止する場合があります。Oracle HTTP Server の起動時に、この環境変数が設定されていな
いことを確認してください。
Web Cache
設定時に不正なリスナー・ポートが使用される
Oracle9iAS Web Cache のデフォルトの設定では、プライマリ Web リスナーがポート 7777 でリスニン
グを行うことを前提としています。Oracle HTTP Server がリスニングするポート番号は、インストール
時に動的に選択されます。
Oracle HTTP Server によって 7777 以外のポートが選択された場合、Oracle9iAS Web Cache は、Web サ
ーバーのポート 7777 に接続できないため、
自分のポート 1100 にアクセスする際にエラーを返します。
この問題を解決するには、Web Cache Manager の「Application Web Servers」画面で、ポート番号を HTTP
サーバーがリスニングしているポートに変更します。
Oracle9iAS Web Cache 許容量パラメータが低い場合のコア・ダンプ
リクエストの処理数が許容量パラメータ設定を大幅に上回り、ほとんどのリクエストがキャッシュ不
可のページに対するものである場合、Web Cache によりコア・ダンプが発生する可能性があります。
これに対処するには、許容量パラメータ「Capacity」を、予測されるリクエスト数に近い数値に設定
します。400 のクライアントがキャッシュ不可のページを要求したテストで、許容量パラメータが 400
に設定されている場合、コア・ダンプは発生しませんでした。同じテストで許容量パラメータが 30
に設定されている場合（デフォルト）、コア・ダンプが発生しました。
許容量パラメータ「Capacity」の設定は、Oracle9iAS Web Cache Manager の「Application Web Server」
セクションに存在します。
管理ソリューション分野の問題点
Oracle Enterprise Manager
Enterprise Manager のナビゲータ・ウィンドウで JServer ノードの拡張時にエラーが
発生
JServer が 2481 以外のポート番号にインストールされると、ナビゲータ・ウィンドウで JServer ノード
を展開したときに、次のエラーが発生します。
org.omg.CORBA INTERNAL (completed=MAYBE)
このエラーを回避するには、エラー・メッセージが表示されるダイアログ・ボックスに、正しい JServer
ポート番号を入力します。
第２章 Oracle9i Application Server
61
Enterprise Manager のナビゲータ・ウィンドウに Oracle HTTP Server のポート番号が表示されない
Oracle HTTP Server に関連付けられたポート番号は、ナビゲータ・ウィンドウに表示されません。
この問題を解決するには、httpd.conf を編集し、コメント行の先頭の空白またはタブをすべて削除しま
す。コメント記号#が行の先頭に配置されていないと、Oracle HTTP Server はコメント行を除外しませ
ん。
Enterprise Manager から Oracle HTTP Server を編集した場合の Java 例外の発生
Oracle HTTP Server を Enterprise Manager コンソールから編集すると、httpd.conf ファイルの解析時の論
理エラーにより、Java 例外が発生します。
この問題を解決するには、httpd.conf を編集し、コメント行の先頭の空白またはタブをすべて削除しま
す。コメント記号#が行の先頭に配置されていないと、Oracle HTTP Server はコメント行を除外しませ
ん。
Web サーバーでの Direct Connect の非サポート
Performance Manager の Direct Connect 機能は、Web サーバーではサポートされていません。Web サー
バーで Direct Connect 機能を使用するとエラーが発生します。この問題の回避手段はありません。
ブラウザベースの Oracle Enterprise Manager リリース 2.2 の既知の問題
ブラウザベースの Oracle Enterprise Manager リリース 2.2 には以下のような既知の問題があります。
−
ブラウザベースの Oracle Enterprise Manager は Pentium4 互換プロセッサを搭載した Windows マシ
ンから使用することはできません。
−
ブラウザベースの Oracle Enterprise Manager のトレースを有効にすることはできません。
−
ブラウザベースの Oracle Enterprise Manager ではデフォルト以外のポートを設定した Management
Server への接続ができません。
例およびデモ
Oracle9i Application Server のほとんどのコンポーネントのデモおよび例は、次の場所に存在します。
http://<hostname:port>
hostname はご使用のマシン名で、port は Oracle HTTP Server リスナーのポートです。このポートの詳細
は、Apache のドキュメントを参照してください。
さらに、Oracle9i Application Server のコンポーネントの例およびデモは、製品の CD-ROM に含まれており、
各コンポーネントのディレクトリにもインストールされます。
デモの制限事項
OracleJSP のデモ
クライアント側で実行する OracleJSP のデモ
今回付属している OracleJSP のデモは、Oracle9i Application Server のクライアント側で実行するための
もので、Oracle Servlet Engine（OSE）のデータベースでは実行できません。Email、Cache、JESI、XML
Dom および info デモを含め、いくつかの新しいデモは、サーバーに自動的にロードされないライブラ
リに依存しています。make または makeit.bat ファイルを使用せずに、デモの README ファイルの非
OSE セクションの説明に従ってください。
62
Oracle9i Application Server for Compaq Tru64 UNIX リリース・ノート
Oracle Business Components for Java のデモのエラー
Business Components for Java のデモが動作しない場合、ご使用のシステムがセットアップされていない可能
性があります。HTTP Server のホーム・ページで Business Components for Java のリンクをクリックし、Sample
Application Setup リンクの手順に従ってください。
$ORACLE_HOME/Apache/Apache/htdocs/OnlineOrders_html/submit_login.jsp
National Language Support（
（NLS）に関する問題点
）に関する問題点
NLS_LANG Environment Variable
mod_plsql mod_plsql の設定時には、NLS_LANG 環境変数は、Web サーバーのインスタンス・レベルご
とに設定されます。パラメータを設定すれば、DAD レベルで NLS_LANG の設定を行なうことも可能です。
Oracle9i Application Server インスタンスを開始する前に、NLS_LANG の設定が正しいことを確認してくだ
さい。
Oracle PSP Oracle PSP の場合、loadpsp コマンドを使用して PL/SQL Server Pages（PSP）をデータベー
スにロードする前に、NLS_LANG 環境変数を設定する必要があります。
JDBC OCI8 ドライバを JServ および OracleJSP とともに使用する JDBC OCI8 ドライバを使用して
Oracle に接続する場合、jserv.properties で NLS_LANG を正しく設定する必要があります。たとえば、次の
ようになります。
wrapper.env=NLS_LANG=AMERICAN_AMERICA.UTF8
NLS_LANG 環境変数の詳細は、『Oracle8i NLS ガイド』を参照してください。
initicache.ora ファイルの NLS パラメータ
Oracle9iAS Database Cache をインストールすると、オリジナル・データベースと同じデータベース・キャラ
クタ・セットを使用するキャッシュが作成されます。ただし、日付書式または通貨記号など、その他の各
国語サポート（NLS）機能は設定されません。
オリジナル・データベースの初期化ファイル（initSID.ora）で NLS パラメータが指定されている場合、そ
れらのパラメータをキャッシュの初期化ファイル（initicache.ora）にコピーする必要があります（NLS パラ
メータは"NLS_"で始まります）。
たとえば、オリジナル・データベースの初期化ファイルに次のパラメータが含まれている場合、それらを
initicache.ora にコピーします。
NLS_LANGUAGE = JAPANESE
NLS_CALENDAR = "Japanese Imperial"
NLS_DATE_FORMAT = "E YY-MM-DD"
initicache.ora ファイルは、
$ORACLE_HOME/admin/icache/pfile ディレクトリに含まれています。
NLS の制約事項
今回のリリースでは、NLS に関し、次の不具合が判明しています。
Developer 6i の簡体字中国語バージョンのユーザー・インタフェースおよびメッセージの一部は、英語
で表示されます。この不具合の回避手段はありません。
Developer 6i の Forms Builder の繁体字中国語バージョンで、メニュー項目「File」→「Generate to file」
→「Delimited」の「Delimited」という単語は翻訳されているべきですが、文字化けしています。この
不具合の回避手段は判明していません。
第２章 Oracle9i Application Server
63
Compaq Tru64 UNIX におけるネットワーク・カードの問題
Compaq Tru64 UNIX でリモートの X 端末を使用している場合に Oracle のインストールに長時間かかり、ネ
ットワークの衝突が発生する（netstat -i で識別可能）場合、ES40 の DE602 ネットワーク・インタフ
ェース・カードとネットワーク・ルーティング・デバイス間の自動ネゴシエーションで競合が発生してい
る可能性があります。
この競合を解決するには、lan_config コマンドを使用して、DE602 インタフェースの速度とモードを、
ネットワーク・ルーティング・デバイスの速度とモードに合うよう設定します。次に、コマンドラインの
例を示します。
lan_config -iee0 -a0 -s100 -x1
Compaq Tru64 UNIX v. 5.1 の場合、Oracle9i Application Server では、ネットワーク・インタフェース・カー
ドのパラメータの設定に、コンソール変数を使用しなくなりました。再起動後もこの変更を維持するため
には、/etc/inet.local ファイルの最後に、該当する lan_config コマンドを入力してください。
関連項目:
関連項目: lan_config コマンドの詳細は、ご使用の Compaq Tru64 UNIX システムの man
lan_config を参照してください。
64
Oracle9i Application Server for Compaq Tru64 UNIX リリース・ノート
第３章 Oracle Servlet Engine
原典情報: A86590-01 Oracle8i Oracle Servlet Engine Release Notes Release 3 (8.1.7)
この章では、Oracle Servlet Engine 環境の初期設定について説明します。
次の項目について説明します。
はじめに
パラメータ・ファイルの変更
はじめに
1.
Oracle Servlet Engine を設定するには、セッション・シェルを使用します。セッション・シェルを起動
して、Oracle Servlet Engine の Web ドメインを構成するコマンドにアクセスします。
例:
% sess_sh -u sys/change_on_install -s jdbc:oracle:oci8:@
2.
この手順以降は、セッション・シェルで実行します。createservice コマンドで、Web サービスを作成
します。サービス・ルート・ディレクトリを定義します。サービス名と JNDI ロケーションを指定し
てください。マルチドメイン・サービスを作成する場合は、IP アドレスとバーチャル・ホスト名も定
義してください。
$ createwebservice -root <JNDI ロケーション> <Web サービス名>
例:
$ createwebservice -root webdomains webserver
3.
データベース・リスナーを経由して OSE にアクセスするには、addendpoint コマンドで登録します。
$ addendpoint -net8 <Web サービス名> <エンドポイント名>
例:
$ addendpoint -net8 -timeout 300 webserver endpnet8
指定のポート番号でディスパッチャを起動しても、OSE にアクセスできます。
次の例では、ポート番号 8800 のディスパッチャでアクセスします。
例:
$ addendpoint -port 8800 -timeout 300 webserver endp8800
4.
createwebdomain コマンドで新しい Web ドメインを作成します。作成される Web ドメインは、このコ
マンドを実行したスキーマにより所有されます。ドメインに含まれるサーブレットは、ドメイン・オ
ーナーとして実行されます。-docroot オプションで OSE ファイル・ディレクトリを指定します。
$ createwebdomain [-docroot <ファイル・ディレクトリ>] <Web ドメイン名>
例:
$ createwebdomain -docroot /usr/local/public_html /webdomains
$ exit
パラメータ・ファイルの変更
必要に応じたケースを選択し、パラメータ・ファイルを変更します。
ケース 1
指定のポート番号でディスパッチャを起動する場合
第３章 Oracle Servlet Engine
65
1.
初期化パラメータ・ファイル（init.ora）に mts_dispatchers パラメータを追加します。
mts_dispatchers = "(ADDRESS=(PROTOCOL=tcp)(HOST=localhost)¥
(PORT=<ポート番号>))(DISP=1)(PRE=http://<Web サービス名>)"
例:
mts_dispatchers = "(ADDRESS=(PROTOCOL=tcp)(HOST=localhost)¥
(PORT=8800))(DISP=1)(PRE=http://webserver)"
ケース 2
データベース・リスナーを経由して OSE にアクセスする場合
1.
初期化パラメータ・ファイル（init.ora）に mts_dispatchers パラメータを追加します。
> mts_dispatchers = "(PROTOCOL=tcp)(PRE=http://<Web サービス名>)"
例:
mts_dispatchers = "(PROTOCOL=tcp)(PRE=http://webserver)"
2.
Net8 クライアント用にデフォルトのポート 1521 を使用しない TCP/IP リスナー・アドレスを構成する
場合は、local_listener パラメータを設定し、tnsnames.ora ファイルなどを使用してこのパラメータ
を解決する必要があります。
> local_listener = "local_listener_name"
例:
local_listener = "listener_orcl"
tnsnames.ora ファイルにエントリを追加します。
> <local_listener_name> =
> (ADDRESS_LIST =
>
(ADDRESS = (PROTOCOL=TCP)(HOST=localhost)(PORT=<ポート番号>))
> )
> #（ポート番号：TCP/IP リスナーがリスニングしているポート番号）
例:
listener_orcl =
(ADDRESS_LIST =
(ADDRESS = (PROTOCOL=TCP)(HOST=localhost)(PORT=7521))
)
3.
Listener.ora ファイルにエントリを追加します。
> (DESCRIPTION =
> (PROTOCOL_STACK =
>
(PRESENTATION = http://<Web サービス名>)
>
(SERVICE_NAME=localhost)
> )
> (ADDRESS = (PROTOCOL=TCP)(HOST=localhost)(PORT=<ポート番号>))
> )
> #（ポート番号：HTTP プロトコルをリスニングするポート番号）
例:
LISTENER =
(DESCRIPTION_LIST =
(DESCRIPTION =
(ADDRESS_LIST =
(ADDRESS = (PROTOCOL=TCP)(HOST=localhost)(PORT=7521))
)
)
(DESCRIPTION =
(PROTOCOL_STACK =
(PRESENTATION = GIOP)
(SESSION = RAW)
)
(ADDRESS = (PROTOCOL=TCP)(HOST=localhost)(PORT=2481))
)
66
Oracle9i Application Server for Compaq Tru64 UNIX リリース・ノート
(DESCRIPTION =
(PROTOCOL_STACK =
(PRESENTATION = http://webserver)
(SERVICE_NAME = localhost)
)
(ADDRESS = (PROTOCOL=TCP)(HOST=localhost)(PORT=7700))
)
第３章 Oracle Servlet Engine
67
第４章 Oracle9iAS Portal
はじめに
この章では、Oracle9iAS Portal リリース 3.0.9 とドキュメントに記載されている機能との相違点、制限事項
および使用上の注意点について説明します。Oracle9iAS Portal リリース 3.0.9 をご使用になる前に必ずお読
みください。また以下の記述に Oracle9iAS Portal リリース 3.0.9 のマニュアルと相違がある場合は、以下
の記述を優先して下さい。
ドキュメント
Oracle Portal の正式な製品名は、「Oracle9iAS Portal」となりました。ドキュメント内では、表現を簡潔に
するために、短縮された製品名である「Oracle Portal」も引き続き使用されます。
動作要件
Oracle9iAS Portal リリース 3.0.9 を実行するには、以下のシステムを必要とします。
Oracle データベース
Oracle8i リリース 8.1.7
Oracle9i リリース 9.0.1
Web ブラウザ
Netscape Navigator/Communicator 4.73(日本語版)以上
(Netscape 6 は除く)
Microsoft Internet Explorer 5.01 Service Pack 1 以上
Oracle9iAS Portal のインストールについて
以下に Oracle9iAS Portal インストール時の注意点を示します。
Oracle9iAS Portal をインストールする対象データベースが Oracle9i Database R9.0.1 の場合、データベー
スの CD Pack に同梱されている「Oracle9i Database Patch Set Release」を適用してください。適用方法
は、「Oracle9i Database Patch Set Release」CD-ROM に含まれる Patch Set Notes 等のドキュメントを参
照してください。
Oracle9iAS Portal インストール後にデータベースの Patch Set Release を適用した場合は、PL/SQL Web
Toolkit を再インストールする必要があります。
−
owaload.sql を以下の手順で実行してください。
コマンド・プロンプトでディレクトリを次のように変更します。
<ORACLE_HOME>/portal30/admin/plsql/owa
ここで<ORACLE_HOME>は Oracle9iAS のオラクルホーム・ディレクトリです。
SQL*Plus で Oracle9iAS Portal をインストールする対象のデータベースに sys ユーザーでロ
グインします。
owaload.sql を実行します。オプションは次のようになります。
SQL > @owaload.sql <logfile>
ここで<logfile>は任意のログファイル名です。
実行例: @owaload.sql owaload.log
−
68
owaload.sql を実行した際に「すでに使用されているオブジェクト名です。」というエラーメッセ
ージが表示された場合は、以下の手順で recomp.sql を実行した後、上の手順に従って PL/SQL Web
Toolkit を再インストールしてください。
Oracle9i Application Server for Compaq Tru64 UNIX リリース・ノート
コマンド・プロンプトでディレクトリを次のように変更します。
<ORACLE_HOME>/portal30/admin/plsql
ここで<ORACLE_HOME>は Oracle9iAS のオラクルホーム・ディレクトリです。
SQL*Plus で Oracle9iAS Portal をインストールする対象のデータベースに SYSDBA としてロ
グインします。SQL*Plus を「nolog 」オプションをつけて起動し、sys ユーザーでログイン
した後、次のコマンドを実行してください。
>sqlplus /nolog
SQL> connect sys/<sys_password>@<connect_string> as sysdba
ここで<sys_password> は sys ユーザーのパスワード、<connect_string>は Oracle9iAS Portal を
インストールする対象のデータベースに接続するための TNS 接続文字列です。
recomp.sql を実行します。
SQL> @recomp.sql
Oracle9iAS Portal リリース 3.0.9 では Oracle Portal Configuration Assistant を用いたインストールはサポ
ートされません。次の注意事項にしたがってインストール作業を行ってください。
UNIX 環境では C シェルを使用する必要があります。
OUI で Oracle9iAS をインストールする際の、Oracle9iAS Portal を使用するために必要な注意点を示し
ます。
-
OUI の「Component Configuration and Startup」画面で、「Oracle9iAS Portal」の選択を解除してくださ
い。もしくは OUI から Oracle Portal Configuration Assistant が起動された時点で、最初の画面で「キャ
ンセル」ボタンをクリックしてください。（キャンセルした場合は、インストール終了時に OUI の画
面で「Oracle9i Application Server のインストールに失敗しました」と表示されますが、インストール
は正常終了しています。）
-
OUI の「Oracle Portal 用 Apache リスナー構成 – Oracle Portal 対応 Database Access Descriptor (DAD)」
画面では各項目はデフォルト値のまま「次へ」ボタンをクリックしてください。
-
OUI の「Oracle Portal 用 Apache リスナー構成 – Login Server 対応 Database Access Descriptor (DAD)」
画面では各項目はデフォルト値のまま「次へ」ボタンをクリックしてください。
Oracle9iAS Portal をインストールするためには、OUI 終了後に「Oracle Portal マニュアル・インストレ
ーション・ガイド リリース 3.0.9」に沿って、インストール作業を行う必要があります。その際に必
要な注意点を示します。
-
Oracle9iAS Portal をインストールする対象のデータベースの SYSTEM 表領域は 600MB 以上、デフォ
ルト表領域に 200MB 以上の空きがあること。また、ブロック・サイズは 4096byte 以上あること。
-
データベース作成時に次のコンポーネントがインストールされていること。
Oracle interMedia
Oracle JServer
-
データベースの作成時にブロック・サイズが 4096Byte 以上に設定されていること。
-
データベースの init<sid>.ora のパラメータが次のような設定になっていること。ここで、<sid>は
Oracle9iAS Portal をインストールする対象データベースの SID です。
open_cursors = 300 以上
max_enabled_roles = 30 以上
processes = 150 以上
compatible = 8.1.0 以上
java_pool_size = 50000000 以上
shared_pool_size = 100000000 以上
large_pool_size の指定を解除(インストール時のみ)
第４章 Oracle9iAS Portal
69
job_queue_processes=1 以上
cursor_sharing=exact
o7_dictionary_accessibility=true
(Oracle9i データベースからデフォルト値が false に変更されています。Oracle9i データベースで
は明示的に true を指定してください。)
−
Oracle9iAS Portal をインストールする時の対象データベースが Oracle9i データベースの場合、次のよ
うな設定を行ってください。
spfile<sid>.ora が存在する場合は、spfile<sid>.ora 以外の任意の名前にリネームしてデータベース
を再起動します。
−
Oracle9i データベースからサーバ・パラメータ・ファイル(Server Parameter File) が導入され
ています。spfile<sid>.ora、spfile.ora が存在する場合、init<sid>.ora に設定した値が確実に反
映されるようにするために spfile<sid>.ora、spfile.ora を別の名前にファイル名を変更してく
ださい。
ここで、<sid>は Oracle9iAS Portal をインストールする対象データベースの SID です。
Oracle9iAS Portal リリース 3.0.9 のインストール対象データベースが Oracle9i Database Standard
Edition の場合、winstall コマンドを実行する前に insttrig.sql を置き換えてからインストールを実
行する必要があります。Oracle9iAS Portal R3.0.9.8.5 Patch CD に収録されている「9idb.zip」を適
当なディレクトリにコピーして展開してください。インストールについては 9idb.zip に含まれて
いる readmeJP.pdf を参照してください。
vpdstatic.sql スクリプトを実行してください。
−
Oracle9iAS Portal R3.0.9.8.5 Patch CD に収録されている「9idb.zip」を任意のディレクトリに
コピーして展開し、さらにその中の「p2207018_309_GENERIC.zip」を展開してください。
インストールについては「9idb.zip」に含まれている readmeJP.pdf を参照してください。
-
データベースに Oracle8i R8.1.7 を使用していて Oracle8i と Oracle9iAS を同一マシン上で稼働させる場
合、Oracle8i R8.1.7 に付属の Oracle HTTP Server は停止しておくか、使用するポート番号が Oracle9iAS
に付属の Oracle HTTP Server と競合しないよう設定を変更しておいてください。
-
Oracle9iAS Portal のインストール対象データベースが Oracle8i Standard Edition（旧名称：Oracle8i
Workgroup Server） の場合、インストール時に以下のようなエラーが複数出力されますが、インスト
ールは問題ありません。エラーは無視してください。
create unique index xxxxxxxxxxxxxxx
*
1 行でエラーが発生しました。
ORA-00439: 機能は使用できません: Function-based indexes
create bitmap index xxxxxxxxxxxxxxxx
*
1 行でエラーが発生しました。
ORA-00439: 機能は使用できません: Bit-mapped indexes
-
70
「Oracle Portal マニュアル・インストレーション・ガイド リリース 3.0.9」の「前提条件」にある通
り、Oracle9iAS Portal をインストールする対象のデータベースに接続できるように Oracle9iAS の
tnsnames.ora を編集してください。例えば次のような記述を
<ORACLE_HOME>/network/admin/tnsnames.ora に追加します。なお<ORACLE_HOME>は Oracle9iAS のオラ
クルホーム・ディレクトリです。
Oracle9i Application Server for Compaq Tru64 UNIX リリース・ノート
<CONNECT_STRING> =
(DESCRIPTION =
(ADDRESS_LIST =
(ADDRESS = (PROTOCOL = TCP)(HOST = <HOSTNAME>)(PORT = <PORT>))
)
(CONNECT_DATA =
(SERVICE_NAME = <SERVICE_NAME>)
)
)
<CONNECT_STRING>は設定する接続文字列(任意)、<HOSTNAME>はデータベースの稼働しているホスト名、
<PORT>は TNS リスナーの稼働しているポート番号、<SERVICE_NAME>はデータベースのサービス名で
す。
設定が完了したら、Oracle9iAS の SQL*Plus で Oracle9iAS Portal をインストールする対象のデータベ
ースに接続できることを確認してください
-
「Oracle Portal マニュアル・インストレーション・ガイド リリース 3.0.9」の「Oracle9iAS Portal の手
動インストール」の 6.で実行する onetime スクリプト・ファイルのオプションは次の通りです。
オプション
意味
デフォルト値
-p
SYS ユーザのパスワード
change_on_install
-l (必須)
ログファイル名
なし
-c
Oracle9iAS Portal をインストールする対象の
データベースに接続するための TNS 接続文
字列
空白文字列
-
実行例: onetime -p change_on_install -l onetime.log -c orcl.jp.oracle.com
-
「Oracle Portal マニュアル・インストレーション・ガイド リリース 3.0.9」の「Oracle9iAS Portal の手
動インストール」の 7.で実行する winstall スクリプト・ファイルのオプションは次の通りです。
オプション
意味
デフォルト値
-s
Portal のパッケージがインストールされる
Portal スキーマ
PORTAL30
-p
SYS ユーザのパスワード
CHANGE_ON_INSTALL
-u
デフォルト表領域名
USERS
-t
一時表領域名
TEMP
-d
ドキュメント表領域(コンテンツ領域にアッ
プロードしたデータが格納される表領域)
デフォルト表領域名
-l
ログ表領域(Portal のログが記録される表領
域)
デフォルト表領域名
-o
ログイン・サーバのパッケージがインストー
ルされる SSO スキーマ
<portal_schema>_SSO
ログイン・サーバのパスワードが保存される
スキーマ
<sso_schema>_PS
パスワードの暗号化に用いられる乱数列の
初期化値
空白文字列
-I
-r
ここで<portal_schema>は Portal スキ
ーマ名です
ここで<sso_schema>は SSO スキーマ
名です
第４章 Oracle9iAS Portal
71
初期化値
-c
Oracle9iAS Portal をインストールする対象の
データベースに接続するための TNS 接続文
字列
空白文字列
-nodemo
デモのインストールの省略
指定なし(デモをインストールする)
-nosso
ログイン・サーバのインストールの省略
指定なし(ログイン・サーバをインス
トールする)
-casesensitive
パスワードで大文字小文字を区別する
指定なし(パスワードで大文字小文字
を区別しない)
-disablerep
Oracle Reports Security ポートレットのインス
トールの省略
指定なし(Oracle Reports Security ポー
トレットをインストール)
-
実行例: winstall -s portal30 -p change_on_install -c orcl.jp.oracle.com
-
winstall スクリプト・ファイルの実行が完了するまでには約 1∼2 時間かかります。
-
<ORACLE_HOME>/Apache/Apache/conf/httpd.conf の「ServerName」項目(2 ヶ所)の値がホスト名のみの
場合は、ネットワークのドメイン名を追加します。また大文字が混ざっている時はすべて小文字に変
換してください。なお<ORACLE_HOME>は Oracle9iAS のオラクルホーム・ディレクトリです。
例: 「ServerName MyHost」→「ServerName myhost.jp.oracle.com」
-
「Oracle Portal マニュアル・インストレーション・ガイド リリース 3.0.9」の「Oracle9iAS Portal の手
動インストール」の 8.での、Oracle9iAS Portal のスキーマをすべて削除するコマンドは実際には次の
ようになります。ここでは Portal スキーマを「portal30」、SSO スキーマを「portal30_sso」、ログイン・
サーバのパスワードが保存されるスキーマを「portal30_sso_ps」、デモがインストールされたスキーマ
を「portal30_demo」とします。データベースを再起動した後、SQL*Plus から SYS ユーザでログイン
して以下のコマンドを実行してください。削除が完了するまでには約 1∼2 時間かかります。
SQL>drop user portal30 cascade;
SQL>drop user portal30_public cascade;
SQL>drop user portal30_sso cascade;
SQL>drop user portal30_sso_public cascade;
SQL>drop user portal30_sso_ps cascade;
SQL>drop user portal30_demo cascade;
SQL>drop public synonym owa_vpd_ctx;
SQL>commit;
-
「Oracle Portal マニュアル・インストレーション・ガイド リリース 3.0.9」の「Oracle9iAS Portal の手
動インストール」の 9.で実行する ssodatan スクリプト・ファイルは、Oracle9iAS Portal にアクセスす
るための URL が変更された場合には、新しい URL を指定して再実行する必要があります。例えば
Oracle9iAS をインストールしたホストのホスト名を変更したり、Oracle HTTP Server の使用するポート
番号を変更したり、Oracle9iAS Portal にアクセスするための DAD を変更したりした場合は、必ず新し
い URL を-w オプションおよび-l オプションに指定して ssodatan を再実行してください。
Portal 3.0.9 での Portal3.0.9.8.5 patch(PSR3.0.9.8.5)の適用手順
この PSR3.0.9.8.5 の詳細については Oracle9iAS Portal R3.0.9.8.5 Patch CD に収録されている 30985t64.zip
に含まれる readme.txt および relnotes.htm を参照してください。
−
72
オンライン・ヘルプのインストール(オプション)を行う場合には、Oracle9iAS Portal 3.0.9.8.0 に対
して行ってください。PSR 3.0.9.8.5 を適用すると、それ以後オンライン・ヘルプのインストール
を行うことができません。オンライン・ヘルプは必ず PSR 適用前にインストールしてください。
Oracle9i Application Server for Compaq Tru64 UNIX リリース・ノート
−
Oracle9iAS Portal R3.0.9.8.5 Patch CD に収録されている 30985t64.zip ファイルに含まれている次
のファイルを適当なディレクトリにコピーして展開してください。
p2394398_309_TRU64.zip
−
Oracle9iAS の Oracle HTTP Server を停止してください。
−
OUI を起動します。
−
「ファイルの場所」画面のソースセクションでパッチを展開したパスにある products.jar を指定し
ます。
例：<dir>/Disk1/Stage/products.jar
ここで<dir>はパッチファイルを展開した任意のディレクトリです。
−
「ファイルの場所」画面のインストール先セクションで Oracle9iAS がインストールされている
ORACLE_HOME の名前とパスを設定します。
−
「次へ」ボタンを選択し、パッチをインストールするためのウィザードが行う質問に答え、OUI
でのインストールを完了させてください。
−
searchdb.plb を適用します。Oracle9iAS Portal R3.0.9.8.5 Patch CD に収録されている「searchdb.zip」
を任意のディレクトリにコピーして展開してください。適用方法については「searchdb.zip」に含
まれている readmejp.htm を参照してください。
−
Oracle9iAS Portal をインストールする対象のデータベースが Oracle9i/8i for Linux の場合において
DB PSR 9.0.1.2 以下または DB PSR 8.1.7.2 以下を適用している時 、
Portal PSR 3.0.9.8.5 を適用後、
Oracle Text/interMedia Text を使用して検索を行うためには、Oracle Text/interMedia Text の索引を
作成する前に、Oracle9iAS Portal R3.0.9.8.5 Patch CD に収録されている context.pth を適用してくだ
さい。適用方法については「context.zip」に含まれている readmejp.htm を参照してください。ま
たこの context.pth を適用した場合、URL コンポーネントや URL アイテム、URL フォルダで指定
したコンテンツは、Oracle Text/interMedia Text を使用した検索の対象にはなりません。
−
Oracle9iAS の Oracle HTTP Server を起動してください。
以前のバージョンからのアップグレードについて
Oracle9iAS Portal R3.0.9.8.5 Patch CD には以前のバージョンからのアップグレード・スクリプト・ファ
イルを収録しています。アップグレードの手順はそのファイルの中に含まれるドキュメントを参照し
てください。
PSR30983A 以降を適用時のプロキシ・サーバーの制限
PSR3.0.9.8.3A 以降を適用時、プロキシ・サーバーに squid を使用している場合、外部アプリケーションに
ログインできない場合があります。
以下のいずれかの方法で回避できます。
ブラウザに Internet Explorer を使用する。
http.c ファイルを次のように修正し、再ビルドする。
[src/http.c]
httpBuildRequestHeader()
...
/* append Authorization if known in URL, not in header and going direct */
if (!httpHeaderHas(hdr_out, HDR_AUTHORIZATION)) {
@
if (!request->flags.proxying && *request->login) {
httpHeaderPutStrf(hdr_out, HDR_AUTHORIZATION, "Basic %25s",
@
base64_encode(request->login));
}
第４章 Oracle9iAS Portal
73
}
...<中略>...
以下をコメントアウトして squid を再ビルドします。
/* httpHeaderPutStrf(hdr_out, HDR_AUTHORIZATION, "Basic %25s",
@
base64_encode(request->login)); */
squid 以外のプロキシ・サーバーにおいても、内部で Authorization ヘッダを付与するような処理を行ってい
る場合、Netscape では外部アプリケーションへの SSO は正常に動作しません。その場合は、プロキシ・サ
ーバーの設定で、自動的に Authorization ヘッダを付けないようにする必要があります。
ブラウザの設定
Internet Explorer 5.0 SP1 以上の場合
「インターネット オプション」の「全般」タブで「設定」ボタンをクリックして「ページを表示する
ごとに確認する」にチェックし、「詳細設定」タブで「いつも UTF-8 として URL を送信する」のチ
ェックを外してください。
Netscape Communicator 4.73(日本語版)以上の場合
「編集」メニューの「設定」を選択して「詳細」の「キャッシュ」で「毎回」にチェックして下さい。
ログインのトラブルシューティング
ログイン時に問題が発生した場合、Portal 管理者は『Oracle Portal 構成ガイド』のトラブルシューティング
の項を参照してください。
Internet Explorer 5 での高度なセキュリティ
Internet Explorer 5 で最高度のセキュリティを設定していると、Oracle9iAS Portal のパブリック・ホーム・ペ
ージを表示する際に問題が発生する場合があります。この場合、Oracle9iAS Portal ホーム・ページを表示す
るために、Internet Explorer 5 のセキュリティ・レベルを引き下げることが必要になります。セキュリティ
設定は、Internet Explorer の「インターネット オプション」ダイアログの「セキュリティ」タブで変更でき
ます。
ドキュメント名の制限
コンテンツ領域にアップロードするドキュメントの名前に、次の制限が適用されます。
ファイル名は、80 文字以内である必要があります。
ファイル名には、文字¥ / : * ? < > | " % # +を含めることはできません。
ファイル名には、空白および文字! @ ~ & . $ ^ ( ) - _ ` ' [ ] { } ; =を含めることができます。
Oracle9iAS Portal の分散環境での制限
Oracle9iAS Portal の分散環境において、ウィザードを用いて作成したリモート・ノードのアプリケー
ション・コンポーネントを使用することはできません。
分散環境において、Oracle9iAS Portal をインストールしている対象のデータベースに適用されている
Patch Set Release のバージョンが同一である必要があります。またプラットフォームが異なる場合、
Patch Set Release8.1.7.1 を適用してください。
74
Oracle9i Application Server for Compaq Tru64 UNIX リリース・ノート
セキュリティ情報付きのインポート/エクスポート
セキュリティ情報付きのインポート エクスポート
アプリケーション、ページおよびコンテンツ領域をエクスポートおよびインポートする場合、関連するペ
ージおよびセキュリティ情報（ユーザー名、パスワード、アクセス制御リスト）もエクスポートおよびイ
ンポートできます。この機能は、セキュリティ権限およびページを保持したままエクスポートおよびイン
ポート処理を実行する場合に有用です。
適切な Oracle9iAS Portal エクスポートまたはインポート・スクリプトを実行する際、-security および-page
スイッチのいずれかまたは両方を指定できます。
たとえば、Solaris では次のようにスクリプトを実行できます。
スクリプト
例
アプリケーションのインポート
appimp.csh -s portal30 -p portal30 -t SCOTT -a
EXAMPLE_APP -security
ページのエクスポート
pageexp.csh -s portal30 -p portal30 -n HOMEPAGE -security
ページのインポート
pageimp.csh -s portal30 -p portal30 -o portal30 -c orcl
-security
コンテンツ領域のエクスポート
contexp.csh -s portal30 -p portal30 -a
SAMPLECONTENTAREA -security -page
コンテンツ領域のインポート
contimp.csh -s portal30 -p portal30 -o portal30 -m reuse
-security -page
各オプションは、次のように使用します。
-s <portal_schema>
-p <portal_password>
-n <page_name>
-d <dump_file_name>
-a <application_name>
<-security>
-c <connect_string>
注意:
Windows の場合、拡張子.csh を拡張子.cmd で置き換えるか、拡張子を指定せずに実行してください。
たとえば、アプリケーションのインポート・スクリプトは次のようになります。
appimp.cmd -s portal30 -p portal30 -t SCOTT -a EXAMPLE_APP -security
エクスポート/インポート・スクリプトの-security または-page オプションを使用して作成されたダン
プ・ファイルには、デフォルト名が付けられます。他のスクリプト・ファイルの場合、ダンプ・ファ
イルに任意の名前を指定できます。
Solaris でのインポート/エクスポートの制限
でのインポート エクスポートの制限
Solaris 上に存在するデータベースに対して、NT マシンのコンテンツ領域をインポート/エクスポートする
場合、2 タスク変換エラー（ORA-03120）が発生します。
この問題を回避するには、NT マシン上ではなく Solaris マシン上で、スクリプト（contexp.csh および
contimp.csh）を実行してください。
フォームの制限
以下に、Forms コンポーネントの既知の制限事項を示します。
第４章 Oracle9iAS Portal
75
データベース・リンクの使用は、Oracle8i データベースでのみ認められます。Oracle8i 以外のデータベ
ース（例：Oracle 7.3）へのデータベース・リンクを使用すると、予期しない結果になる場合がありま
す。
現時点では、ユーザー定義のオブジェクト型はサポートされていません。
次のリストに、データ型およびそのサポート状況を示します。
データ型
サポート状況
BLOB
はい
CHAR
はい
CLOB
いいえ
DATE
はい
LONG
いいえ
LONG RAW
いいえ
MLSLABEL
いいえ
NCHAR
いいえ
NCLOB
いいえ
NUMBER
はい
NVARCHAR
いいえ
NVARCHAR2
いいえ
RAW
いいえ
ROWID
いいえ
UNDEFINED
いいえ
VARCHAR
はい
VARCHAR2
はい
次のリストに、interMedia オブジェクト型およびそのサポート状況を示します。
オブジェクト型
サポート状況
ORDIMAGE
はい
ORDAUDIO
いいえ
ORDVIDEO
いいえ
Custom object types
いいえ
フォームのベースとなるアイテム（表またはビュー内の列およびボタンや他の要素）の最大数は、200
です。
表/ビュー上に構築するフォームおよびマスター/ディテール・フォームは、複数のパブリック・デー
タベース・リンクをまたぐ表/ビュー上にのみ作成できます。プライベート・データベース・リンクは
サポートされていません。
ファイル・アップロード機能は、複数のデータベース・リンクをまたぐ環境では、サポートされてい
ません。ファイル・アップロード機能は、ストアド・プロシージャをベースとするフォームでもサポ
ートされません。
次のいずれかを保持するビューを、フォームのベースとすることはできません。なお更新可能なビュ
ーの詳細は、Oracle8i ドキュメントを参照してください。
76
Oracle9i Application Server for Compaq Tru64 UNIX リリース・ノート
−
DISTINCT 演算子
−
AVG、COUNT、MAX、MIN などの集計関数
−
GROUP BY、HAVING、START WITH、または CONNECT BY 句
表/ビューまたはマスター/ディテール・フォームをベースとするフォーム上のすべてのアイテム・プ
ロパティで「挿入可能」および「更新可能」オプションを選択すると、エラーが発生します。この問
題を回避するには、フォーム上の少なくとも 1 つのフィールドで、「挿入可能」および「更新可能」
を選択しないようにする必要があります。
Oracle Report Security について
Oracle Reports Security はサポートしていません。
イメージ・チャートの制限
•
イメージ・チャート機能は、このリリースではベータ機能でありサポート対象外です。なおこの機能
を有効にするには、Oracle9iAS Portal ホームページの「管理」タブをクリックしてから、「グローバ
ル設定」をクリックします。次に「グローバル設定」ページで、「問合せウィザードからのイメージ・
チャート」をチェックします。
ユーザーの追加、削除について
Oracle9iAS Portal 管理画面、「管理」タブの「ユーザー」ポートレットからユーザーを削除しても、
ユーザーのプロファイル情報が残ったままになります。したがって、「ユーザー」ポートレットから
ユーザーを削除した後、次の手順でプロファイル情報を削除してください。
−
SQL*Plus で Oracle9iAS Portal をインストールしたデータベースに、Oracle9iAS Portal をインス
トールした Portal スキーマ(デフォルト Portal30)でログインして、次のコマンドを実行してくだ
さい 。
SQL> exec PORTAL30.WWSEC_API.DELETE_PORTAL_USER( P_USER_NAME
=>'<USERNAME>' )
SQL> COMMIT;
ここで<USERNAME>は削除したいユーザー名です。
また、1 つのログイン・サーバーに複数の Oracle9iAS Portal が関係付けられている場合は、この
作業を全ての Oracle9iAS Portal のインストール対象データベースに対して行ってください。
ユーザーの追加、削除には次の API が使用できます。ユーザーを追加する場合は、「ログイン・サー
バーへのユーザー追加」「Oracle9iAS Portal へのユーザー追加」の順に実行してください。ユーザー
を削除する場合は、「Oracle9iAS Portal からのユーザー削除」「ログイン・サーバーからのユーザー
削除」の順に実行してください。
−
ログイン・サーバーへのユーザー追加
PROCEDURE <SSO_SCHEMA>.WWSSO_API_USER_ADMIN.CREATE_USER(
P_USERNAME IN VARCHAR2,
-- ユーザー名
P_PASSWORD IN VARCHAR2,
-- パスワード
P_EMAIL IN VARCHAR2,
-- 電子メール・アドレス
P_ACTIVATION_TIME IN DATE DEFAULT NULL,
-- アカウント発効日
P_TERMINATION_TIME IN DATE DEFAULT NULL, -- アカウント失効日
P_LSADMIN IN BOOLEAN DEFAULT FALSE,
-- ログイン・サーバーの
総合管理者
第４章 Oracle9iAS Portal
77
P_ERROR_CODE OUT NUMBER
-- エラー・コード
);
−
ログイン・サーバーからのユーザー削除
PROCEDURE <SSO_SCHEMA>.WWSSO_API_USER_ADMIN.DELETE_USER (
P_USER_NAME IN VARCHAR2,
P_ERROR_CODE OUT NUMBER
-- ユーザー名
-- エラー・コード
);
−
Oracle9iAS Portal へのユーザー追加
FUNCTION <PORTAL_SCHEMA>.WWSEC_API.ADD_PORTAL_USER(
P_USER_NAME IN VARCHAR2
-- ユーザー名
) RETURN NUMBER;
−
Oracle9iAS Portal からのユーザー削除
PROCEDURE <PORTAL_SCHEMA>.WWSEC_API.DELETE_PORTAL_USER(
P_USER_NAME IN VARCHAR2
-- ユーザー名
);
ここで<SSO_SCHEMA>は SSO スキーマ、<PORTAL_SCHEMA>は Portal スキーマです。
Oracle9iAS Portal へのユーザー追加に関するユーザー名以外のパラメータについては PDK 付属の
PL/SQL API リファレンスを参照してください。
ユーザー・プロファイルの編集について
下記の Oracle9iAS Portal のデフォルト・ユーザーに関して、「Portal ユーザー・プロファイルの編集」
画面で「デフォルトに戻す」ボタンを実行しますと、フォーム・コンポーネントの作成や、編集が行
えなくなります。これらのユーザーに関しては、「デフォルトに戻す」ボタンを実行しないでくださ
い。
−
<Portal スキーマ名>
(デフォルト: PORTAL30 )
−
<Portal スキーマ名>_ADMIN
(デフォルト: PORTAL30_ADMIN )
−
<Login Server スキーマ名>_SSO
(デフォルト: PORTAL30_SSO )
−
<Login Server スキーマ名>_ADMIN
(デフォルト: PORTAL30_SSO_ADMIN )
−
PUBLIC
(デフォルト: PUBLIC )
なお、<Portal スキーマ名> (デフォルト: PORTAL30 ) は、「デフォルトに戻す」ボタンを実行しても
エラーにより実行を継続することはできません。
各国語サポートの制限
中間層(Oracle9iAS)で使用するキャラクタ・セット(NLS_LANG)の設定は、データベースのキャラク
タ・セットと同じにする必要があります。
データベースで UTF8 キャラクタ・セットを使用する場合、一部ページのレイアウトが乱れます。そ
の場合 Netscape Navigator ではなく Microsoft Internet Explorer を使用してください。
Oracle HTTP Server が「Internal Server Error」を表示する場合、次のファイルを編集して設定を変更す
ると改善されます(マシンの性能が高くない時に有効です)
78
-
UNIX 版の場合: $ORACLE_HOME/Apache/Jserv/etc/jserv.conf
-
デフォルトでは「#」でコメントアウトされている「ApJServVMTimeout」パラメータの設定を追加しま
す
Oracle9i Application Server for Compaq Tru64 UNIX リリース・ノート
例：「# ApJServVMTimeout 10」
→「ApJServVMTimeout 30」
Oracle9iAS に含まれる Oracle9iAS Web Cache を、Oracle9iAS Portal で構築されたポータルに対して使
用することはサポートされません。
Oracle9iAS Portal の初期画面であるウェルカム・ページは、最初英語で表示されます。日本語の画面
に変更したいときは、まず「ゲートウェイ構成メニュー」画面の「キャッシュ構成の設定」リンクか
ら「キャッシュ構成の設定」画面を表示させます。その画面の「PLSQL キャッシュを有効にする」と
「セッションキャッシュを有効にする」を「No」に設定し、「OK」ボタンをクリックします。次に
Oracle9iAS Portal にログインし、「言語を設定」ポートレットで「日本語」を選択してください。そ
の後ログアウトして、ウェルカム・ページが日本語になっていることを確認してください。確認でき
たら、「PLSQL キャッシュを有効にする」と「セッションキャッシュを有効にする」の設定を「Yes」
に戻してください。
オンライン・ヘルプで検索する時は英語の検索語句を指定して下さい。検索結果は英語で表示されま
すが、ヘルプの内容は日本語で表示されます。
フォーム・ウィザードによってフォーム・コンポーネントを作成、編集する場合、「書式および妥当
性チェックオプション」画面において列名やボタン名を選択した状態で、「次へ」ボタンや「完了」
ボタン、或いは画面右上のタブ(編集時)をクリックしないで下さい。ボタン名やラベルが文字化けす
る場合があります。それらの操作を行って次の画面に移る前に、必ず左上の「Form 」項目を一度選
択して下さい。
レポート・コンポーネント作成時に「レポート作成ウィザード」の「書式条件」ステップで「点滅」
チェックボックスにチェックした場合、レポート・コンポーネントを Internet Explorer で実行しても点
滅表示はされません。
QBE レポートを作成する時に、選択した列の中に日付型の列が含まれている場合、「表示書式」画面
でその列の「書式マスク」項目に書式マスクを指定してください。指定されていない場合、実行時に
「更新」リンクからデータを更新することはできません。
カレンダー・コンポーネント作成時、日付書式を間違って入力した時に表示されるエラーメッセージ
は日付書式を「YYYY- MM」と指示していますが、入力する日付書式は「MON-YYYY」で入力して
ください。
URL コンポーネント、URL アイテム、または URL フォルダでは、対象の Web ページの Content-Type
HTTP ヘッダーで、キャラクタ・セットが指定されていない場合、キャラクタ・セットを ISO-8859-1
として Web ページを表示します。(Web ページの HTML ヘッダー内で、<META>タグの HTTP-EQUIV
属性で指定されているキャラクタ・セットは、有効になりません。)
たとえば、
Shift_JIS キャラクタ・セットを使用している Web ページであるにもかかわらず、
Content-Type
HTTP ヘッダーが"text/html"である場合など、Content-Type HTTP ヘッダーで適切なキャラクタ・セッ
トが指定されていない場合、Web ページを正しく表示できません。
日本語環境において、コンテンツ領域内右上のプロパティシートアイコンは機能しません。また検索
結果のアイテムの右のプロパティシートも機能しません。コンテンツ領域に関する情報は、「ナビゲ
ータ」の「コンテンツ領域」タブの「プロパティの編集」からアクセスして下さい。
コンテンツ領域に日本語の名前を持つファイルをファイル・アイテムや Zip ファイル・アイテムとし
てアップロードすると、
データベースのキャラクタ・セットが UTF8 で Web ブラウザに Internet Explorer
を使用している場合は、ファイルをダウンロードして保存する時にファイル名が乱れて表示されます。
適切なファイル名にリネームしてから保存して下さい。
Zip ファイルアイテムをアップロードする場合は、必ず含まれているファイルの名前に日本語が使用
されていないことを確認して下さい。またディレクトリ構造付きで ZIP されている場合は、ディレク
トリ名がアルファベット、数字及び「_」(アンダースコア)以外を含んでいないことを確認して下さい。
日本語の名前を持つファイルを含んでいる場合や、ディレクトリ名がアルファベット、数字及び「_」
(アンダースコア)以外の文字を含んでいる場合は、コンテンツ領域内に正常に解凍されません。
Zip ファイルアイテムをコンテンツ領域に解凍する場合は、必ず「バックグラウンドで解凍」オプシ
ョンのチェックをはずして下さい。
第４章 Oracle9iAS Portal
79
日本語環境において Zip ファイル・アイテムをコンテンツ領域に解凍した場合、「バルクロードのロ
グ」の表示が乱れますが、そのまま操作を続行して下さい。
コンテンツ領域のアイテムを検索する時に、検索語句として複数の単語を指定する場合、全角スペー
スでは語句を区切ることはできません。必ず半角スペースを使用して下さい。
コンテンツ領域の「フォルダの編集」時に「アイテム一括操作」を選択してアイテムの一括操作をす
る画面で、Internet Explorer5.0 SP2 以上のブラウザでは「フォルダをブラウズ」アイコンを選択しても
フォルダのツリーが表示されません。Netscape Navigator か Internet Explorer5.0 SP1 を使用してくださ
い。
コンテンツ領域で「フォルダの編集」時の「アイテム一括操作」での「コピー」機能はサポートされ
ません。
コンテンツ領域から検索を実行して得られた検索結果のページから、「一括操作」リンクへアクセス
し再度検索結果のページへ戻った時、検索文字列が崩れていた場合は、検索文字を再入力してくださ
い。
コンテンツ領域の表示名を変更した後、Oracle9iAS Portal 管理画面から、コンテンツ領域を「表示」
または「編集」する場合、コンテンツ領域のリストから選択されたコンテンツ領域名が、以前の表示
名になっている場合があります。その場合「表示」または「編集」対象のコンテンツ領域名を手動で
入力するか、「言語の設定」ポートレットで設定を「English」にした後、コンテンツ領域のリストか
らコンテンツ領域を選択するか、「Oracle Portal ナビゲータ」画面から変更したコンテンツ領域にア
クセスするか、もしくは次の手順で mod_plsql のキャッシュをクリアしてください。
−
次のディレクトリの下にあるファイルとディレクトリをすべて削除して下さい。(名前が数字のみ
のディレクトリが多数存在するので、それらをすべて削除して下さい。また次のディレクトリ自
体は削除しないで下さい。)
<PLSQL_CACHE>/plsql
<SESSION_CACHE>/session
ここで「<PLSQL_CACHE>」及び「<SESSION_CACHE>」は、それぞれ mod_plsql の「ゲートウ
ェイ構成メニュー」画面の、「キャッシュ構成の設定」画面の「PL/SQL キャッシュ」および「セ
ッション Cookie キャッシュ」項目で「キャシュ・ディレクトリ」に指定されているディレクト
リです。
ただし、キャッシュを全てクリアするので、一時的にパフォーマンスが低下することがあります。
コンテンツ領域でフォルダの「スタイルのプロパティ」の「フォルダのレイアウト」タブを選択し、
「領域のプロパティ」の「フォルダ領域のプロパティ」を選択すると「使用可能な属性」リストに「作
成者」が二つ表示されます。このため属性の表示部分で二つの「作成者」属性を両方表示させたい場
合には、「アイテムの追加」でアイテムの管理者として設定可能な「作成者」にデフォルトの作成者
と区別可能な値を設定してください。
コンテンツ領域にファイル・アイテムとして登録されたテキストファイルや HTML ファイルは以下の
条件をすべて満たす場合にのみ、Oracle Text/interMedia Text を使用した日本語検索の対象となります。
−
Oracle9iAS Portal のインストール対象データベースのキャラクタセットが JA16SJIS であること
−
テキストファイルおよび HTML ファイル中に含まれる文字の文字コードが Shift JIS であること
−
HTML ファイルの場合は<HTML>タグの直後に以下の META タグが含まれていること
<META HTTP-EQUIV="Content-Type" CONTENT="text/html; charset=Shift_JIS">
URL コンポーネントや URL アイテム、URL フォルダで指定したコンテンツが日本語の場合、それら
は Oracle Text/interMedia Text を使用した検索の対象にはなりません。
Oracle9iAS Portal をインストールする対象のデータベースが Oracle8i for MS Windows の場合、
interMedia Text の索引を作成する場合および interMedia Text を使用して検索を行う場合、次の設定が
必要です。また、Oracle9iAS Portal をインストールする対象のデータベースが Oracle9i for MS Windows
の場合、Oracle Text の索引を作成する場合にのみ、次の設定が必要です。
−
80
「Database Access Descriptor」ページの「接続プール・パラメータ」の設定で「接続プーリングを
有効にしますか?」を「No」にしてください。
Oracle9i Application Server for Compaq Tru64 UNIX リリース・ノート
Oracle9iAS Portal をインストールする対象のデータベースが Oracle9i/8i for Linux の場合、Oracle
Text/interMedia Text を使用して検索を行うためには、Oracle Text/interMedia Text の索引を作成する前
に次の作業を行ってください。
−
コマンド・プロンプトでディレクトリを次のように変更します。
<ORACLE_HOME>/portal30/admin/plsql/wws
ここで<ORACLE_HOME>は Oracle9iAS のオラクルホーム・ディレクトリです。
−
SQL*Plus で Oracle9iAS Portal をインストールしたデータベースに、Oracle9iAS Portal をインスト
ールした Portal スキーマでログインして、次のコマンドを実行してください。
SQL> @context.pth
また Oracle9iAS Portal をインストールする対象のデータベースが Oracle8i for Linux の場合は、URL コ
ンポーネントや URL アイテム、URL フォルダで指定したコンテンツは、interMedia Text を使用した検
索の対象にはなりません。
Oracle Text/interMedia Text 検索の検索結果の画面において Oracle9iAS Portal をインストールしている
対象データベースが Oracle8i for Solaris で PSR8.1.7.1 を適用している場合および Oracle9i for Solaris の
場合、Text 強調表示(HTML)は機能しません。文章の確認は HTML 表示の機能で行ってください。
Oracle Text/interMedia Text 検索の検索結果の画面において Oracle9iAS Portal をインストールしている
対象データベースが Oracle8i for HP-UX で PSR8.1.7.1 を適用している場合および Oracle9i for HP-UX の
場合、HTML 表示は機能しません。文章の確認は Text 強調表示の機能で行ってください。
Oracle Text/interMedia Text 検索の検索結果の画面において、Microsoft(R) Word2000 のファイルでは
Text 強調表示(HTML)は機能しません。文章の確認は HTML 表示の機能で行ってください。
Oracle Text/interMedia Text の「テーマと要旨」は、英語とその他一部の言語でのみ提供されている機
能であり、日本語では提供されておりません。そのため、Oracle9iAS Portal においても日本語環境で
は、Oracle Text/interMedia Text の「テーマと要旨」は利用できません。
Oracle Text/interMedia Text の索引を削除するとき、Java script のエラーで「An Unhandled Exception has
occurred」(ハンドルされていない例外発生)が表示される場合がありますが、削除は正常に行われてい
ます。
Oracle9iAS Portal をインストールする対象のデータベースが Oracle8i リリース 8.1.7.2(ただし Oracle8i
for MS Windows リリース 8.1.7.2.5 以上を除く)の場合、interMedia Text を使用して検索を行うために
は、interMedia Text の索引を作成する前に次の作業を行ってください。
−
コマンド・プロンプトでディレクトリを次のように変更します。
<ORACLE_HOME>/portal30/admin/plsql/wws
ここで<ORACLE_HOME>は Oracle9iAS のオラクルホーム・ディレクトリです。
SQL*Plus で Oracle9iAS Portal をインストールしたデータベースに、Oracle9iAS Portal をイン
ストールした Portal スキーマでログインして、次のコマンドを実行してください。
set serverout on;
declare
cursor rls_cur is
select object_name, policy_name
from user_policies
where policy_name = 'WEBDB_VPD_POLICY';
begin
dbms_output.enable(100000);
for c1 in rls_cur
loop
dbms_output.put_line('Disabling RLS on table '||c1.object_name);
dbms_rls.enable_policy(
第４章 Oracle9iAS Portal
81
object_name=>c1.object_name,
policy_name=>c1.policy_name,
enable=>FALSE);
end loop;
end;
/
また interMedia Text の索引の作成が完了したら、次の作業を行ってください。
−
コマンド・プロンプトでディレクトリを次のように変更します。
<ORACLE_HOME>/portal30/admin/plsql/wws
ここで<ORACLE_HOME>は Oracle9iAS のオラクルホーム・ディレクトリです。
SQL*Plus で Oracle9iAS Portal をインストールしたデータベースに、Oracle9iAS Portal
をインストールした Portal スキーマでログインして、次のコマンドを実行してください。
set serverout on;
declare
cursor rls_cur is
select object_name, policy_name
from user_policies
where policy_name = 'WEBDB_VPD_POLICY';
begin
dbms_output.enable(100000);
for c1 in rls_cur
loop
dbms_output.put_line('Enabling RLS on table '||c1.object_name);
dbms_rls.enable_policy(
object_name=>c1.object_name,
policy_name=>c1.policy_name,
enable=>TRUE);
end loop;
end;
/
なおこの作業は索引の作成時にのみ必要です。索引の作成後、「Oracle Portal 構成ガイド」
の「6.5.4
手順 4: interMedia Text 索引の管理」のように索引の自動更新を有効にする際にはこの作業は必要
ありません。
Netscape Navigator を使用する場合、ページにポートレットを追加する時に「選択したポートレット」
枠内で日本語のポートレット名の表示が乱れることがありますが、そのまま操作を続行してください。
ポートレットをページに追加する時、「ポートレットの追加」画面の「使用可能なポートレット」の
プレビュー画面で Internet Explorer では文字化けが発生します。その場合は、Netscape Navigator を使用
してください。
日本語環境で作成したポートレットをページに追加する時、「言語を設定」ポートレットでページの
言語に「English」が選択されている場合、プレビューは表示されませんが、ポートレットの追加はで
きますので、そのまま操作を継続してください。
82
Oracle9i Application Server for Compaq Tru64 UNIX リリース・ノート
日本語環境で作成したアプリケーション・コンポーネントのポートレットをページに追加する時、「言
語を設定」ポートレットでページの言語に「English」が選択されている場合、プレビューは表示され
ませんが、そのまま操作を継続してください。
新規ページ作成時にカスタムテンプレートを適用した場合、右上のヘルプボタンは正常に機能しませ
ん。バナー付きのデフォルトテンプレートを使用して下さい。
その他の制限
ページの言語の変更や、ページにポートレットを追加した時に変更がすぐにページに反映されない場
合は、ページの「ページの更新(Refresh)」リンクやブラウザの「再読み込み」ボタンでページを再読
み込みしてください。
大きなファイルのアップロードなど処理に時間がかかるような場合は、
<ORACLE_HOME>/Apache/Apache/conf/httpd.conf で指定される TimeOut ディレクティブの値(デフォ
ルト 300 秒)で接続が切断されてしまいます。その場合は切断されないような値に変更してください。
<ORACLE_HOME>は Oracle9iAS のオラクルホーム・ディレクトリです。
Oracle9iAS の Oracle HTTP Server に含まれる mod_plsql から Oracle WebDB への接続は、Oracle9iAS
R1.0.2.1 以降ではサポートされません。Oracle9iAS R1.0.2.0 でのみサポートされています。
第４章 Oracle9iAS Portal
83
第５章 Oracle Forms Developer and Oracle9iAS Forms Services
R6i (Patch13)
はじめに
この章の目的
この章では、Oracle Forms Developer および Oracle9iAS Forms Services と、ドキュメントに記載されている
機能との相違点を説明します。
サーバーのライセンス
Forms または Graphics を Web 環境に配置する場合は、Oracle9iAS Forms Services とそれに関連するライセン
スが必要であることに注意してください。
Forms Services(Forms Server)は、開発目的用に Oracle Developer CD-ROM にも含まれていますが、Forms
Developer とは別にライセンスされます。
概要
コンポーネントのバージョン番号
Oracle Forms Developer R6i のこのリリースでは、ほとんどの主要コンポーネント（Form Builder、Graphics
Builder など）に 6.0.8 というバージョン番号が付いています。また、ほとんどのサブコンポーネント（Toolkit
など）に 6.0.5 というバージョン番号が付いています。これらのバージョン番号は、このリリースのサブコ
ンポーネントに適切なバージョン番号です。
RSF コンポーネントの追加のバグ修正
リリース 6i には、いくつかの RSF コンポーネントが含まれています。この RSF コンポーネントには、コ
ンポーネントに対する正式な、番号付きパッチ内のコード修正とは別の修正が含まれます。（コンポーネ
ントのこれらの修正またはパッチレベルは、"ワンオフ"と呼ばれることがあります。）
特に、リリース 6i には、バグ 1063571、1063104、1028960、1049171 および 1040536 の修正が含まれてい
ます。これらのバグ修正は、コンポーネント sqlnet、rdbms、nls および plsql に影響します。
日付の扱い
Oracle Forms Developer での日付の扱いに関する重要な情報については、http://www.oracle.co.jp/year2000/を
参照し、資料と White Paper へのリンクに従ってください。
サポートするデータベース
パッチ(Oracle Developer R6i Patch13)を適用することで、Oracle Server リリース 7.3.4, 8.0.4, 8.0.5, 8.0.6, 8.1.5,
8.1.6, 8.1.7, 9.0.1, 9.2 をサポートします。
使用可能なキャラクタ・セット
本リリースでサポートされる日本語キャラクタ・セットは JA16SJIS 及び JA16EUC です。
84
Oracle9i Application Server for Compaq Tru64 UNIX リリース・ノート
SJIS キャラクタ・セットでの使用
リソースファイル$ORACLE_HOME/forms60/admin/resource/JA/fmrweb.res は、EUC キャラクタ・セットで提
供されます。SJIS 環境で Forms Services を使用する場合、このファイルを SJIS キャラクタ・セットに変換
する必要があります。変換が行われてない場合「fmrweb が見つかりません」というエラーが発生します。
確認されている制限
PLL ファイルのアップグレードでのコマンドラインにおける.PLL
拡張子の必要性
ファイルのアップグレードでのコマンドラインにおける
バッチ・ファイルを使用して.PLL ファイルをアップグレードする場合は、バッチ・ファイルに拡張子.pll
を使用する必要があります。これを行わないと、エラー「FRM-10043: ファイルをオープンできません」が
表示されます。
データベース・オブジェクト名における非英数字
Oracle Forms Developer R6i は、英数字以外（!や*など）を使用した ASCII 文字の表名および列名をサポー
トしません。
このリリースと互換性のあるプリコンパイラ
Oracle プリコンパイラを使用して Oracle Forms Developer R6i 用のユーザー・イグジットを開発する場合は、
Oracle8 R8.0.6 に対応したバージョンのプリコンパイラを使用してください。
UNIX 上の ORAINFONAV_DOCPATH 環境変数
Unix プラットフォームでは、ORAINFONAV_DOCPATH 環境変数がオンライン・マニュアルの場所に設定
されている必要があります。この環境変数のデフォルト値は、英語版のオンライン・マニュアルの場所
（$ORACLE_HOME/doc60/admin/manuals/US）に設定されています。日本語版のオンライン・マニュアルを
参照する場合は、ORAINFODOC_DOCPATH 環境変数を$ORACLE_HOME/doc60/admin/manuals/JA に設定す
る必要があります。
Oracle File Packager
Oracle File Packager（Forms Developer ドキュメントに記載されています）は、このリリースには含まれませ
ん。
同一 ORACLE_HOME へのインストール順序
Oracle Forms Developer R6i と Oracle8 R8.0.6 の両方を同一の ORACLE_HOME にインストールする場合は、
Oracle8 を最初にインストールしてから Forms Developer をインストールする必要があります。この順序で
インストールすると、ライブラリ・リンクの競合を防ぐことができます。
Database Admin スクリプトにおける Oracle Translation Builder（
（OTB）の必要性
）の必要性
Database Admin 作成スクリプトおよび削除スクリプトは、Oracle Translation Builder SQL スクリプトを検出
できない場合、失敗します。
この問題は、製品 CD から明示的に Oracle Translation Builder をインストールすることによって回避できま
す。
Unix 上のインストールに必要な追加ステップ
Forms Developer ヘルプ・システムを Unix システム上で正しく動作させるには、ORACLE_AUTOREG 変数
を値$ORACLE_HOME/guicommon6/tk60/admin に設定する必要があります。（このヘルプ・システムには、
第５章 Oracle Forms Developer and Oracle9iAS Forms Services R6i (Patch13)
85
ツールキット・オートメーション・レジストリである autoprefs.oar ファイルが必要です。UNIX 用のオンラ
イン・ヘルプは英語です。）
TEMPLATES ディレクトリの欠落
Oracle Forms Developer および Oracle Reports Developer のマニュアル『アプリケーション作成ガイド』には、
TEMPLATES ディレクトリについての記載があります。しかし、この製品には TEMPLATES ディレクトリ
は含まれていません。
Oracle8i R8.1.6 Server に接続する際の問題
オペレーティング・システムの認証を使用して Oracle Forms Developer 製品から Oracle8i R8.1.6 データベー
スに接続できないことがあります。（この問題はデータベース・サーバーのバグ 1139334 によるものです。）
Forms-Graphics における Oracle8 R8.0.6 Server への接続の問題
問題: ローカルの Oracle8 R8.0.6 データベース・サーバーへの接続がユーザーID とパスワード（例、
scott/tiger）のみで行われる場合、Forms-Graphics 統合が正しく機能しません。
対処: tnsnames.ora ファイル内にローカル・データベースを定義します。その後、そのデータベースに接続
するときに、完全な接続文字列を提供します。
（例、scott/tiger@local806）
データベース・サーバーAgent
のアップグレード
データベース・サーバー
Oracle Forms Developer R6i では、Forms と同じ ORACLE_HOME 内に Forms の拡張機能を持つ 8.0.6Agent
が提供されます。すでに既存の Agent がインストールされている場合、つまり新しいバージョンの Agent
にアップグレードする場合は、Forms の拡張機能を手動で Agent にインストールする必要があります。
8.0.6 以外の Agent を Forms と同じ ORACLE_HOME にインストールできないこと、
および一度に 1 つの Agent
しか使用できないことに注意してください。また、8.0.6Agent を使用することを強くお薦めします。
次のインストール手順は、Windows NT と UNIX の両方に共通です。（ファイルはプラットフォーム固有で
あり、プラットフォーム間でファイルをコピーしてはいけないことに注意してください。）
次の手順に従って、自分の Agent 用の Forms サポートを手動でインストールします。（現在 8.0.6、8.1.5 お
よび 8.1.6 がサポートされています。
）
次の手順では、
Forms の拡張機能を持つ Agent が ORACLE_HOME $OH
にインストールされること、および Forms の拡張機能を$OH から ORACLE_HOME $OH2 にインストール
されている Agent にコピーすることを前提としています。
1.
$OH/network/agent/jobs/oracle/forms/general/*を$OH2 内の対応するディレクトリ（必要な場合は作成し
ます）にコピーします。
2.
$OH/network/agent/events/oracle/forms/fault/*を$OH2 内の対応するディレクトリ（必要な場合は作成し
ます）にコピーします。
3.
$OH/network/agent/tcl/frminit.tcl を$OH2 内の対応するディレクトリにコピーします。
4.
$OH/network/agent/config/nmiforms.tcl を$OH2 内の対応するディレクトリにコピーします。
5.
エントリ"nmiforms.tcl"を$OH2/network/agent/config 内にある nmiconf.lst の最後に付加します。
（nmiconf.lst はテキスト・ファイルです。）
Wallet Manager のカスタム・インストールにおける Net8 Assistant の必要性
Wallet Manager が正常に起動するためには、Net8 Assistant が必要です。
Forms Developer の一般的なデフォルトのインストールでは、これらのコンポーネントの両方がインストー
ルされます。
ただし、特定のコンポーネントを選択するカスタム・インストールを行って Wallet Manager をインストー
ルする場合は、Net8 Assistant もインストールする必要があります。
86
Oracle9i Application Server for Compaq Tru64 UNIX リリース・ノート
Oracle Repository との統合
Oracle Forms Developer は、Oracle Repository と統合できます。
このリリース 6i は、ソース制御管理のためにリポジトリとの統合を可能にする d2sc プラグイン（PVCS、
ClearCase およびその他の製品に提供されるプラグインと同様のもの）
とともに出荷されます。
ユーザーは、
FMB、MMB などをチェックインおよびチェックアウトすることができ、リポジトリの依存性追跡やその
他の高度な機能を使用できます。（詳細はリポジトリのドキュメントを参照してください。）
この初期機能により、将来の Forms Developer リリースにおける高度なレベルの統合の可能性が確立されま
す。
クライアント・プラットフォームの認定
サポートされているクライアント・プラットフォームとそのサポート・レベルに関する最新情報は、オラ
クル社のカスタマーサポート、または日本オラクル Web サイト（http://www.oracle.co.jp/）より提供されま
す。
Intersolve のドライバをアンインストールする場合の警告
同じマシンの別の ORACLE_HOME にある他の製品が Intersolve のドライバ（ODBC）を使用する場合は、
ORACLE_HOME から Intersolve のドライバをアンインストールしないでください。1 つの ORACLE_HOME
からこのドライバをアンインストールすると、システム全体からこのドライバが削除されます。
ORACLE_HOME について
Oracle9i Application Server のインストール直後、ORACLE_HOME はインストールで使用したディレクトリ
に設定されています。
Forms 関連コンポーネントを使用するにあたっては、
そのディレクトリの下の/6iserver
というディレクトリを ORACLE_HOME として使用します。
Oracle Forms Developer クライアント/サーバーコンポーネントの使用前の作業
クライアント サーバーコンポーネントの使用前の作業
.fmb ファイルの作成、コンパイル作業など、Oracle Forms Developer のクライアント/サーバーコンポーネン
トを使用する場合、ログイン後下記の作業をしてください。この作業によって、Forms Developer 関連の環
境変数が設定されます。また Oracle9i Application Server 環境下では ORACLE_HOME が
$ORACLE_HOME/6iserver に切り替えられます。
（C シェルの場合）
1.
cd $ORACLE_HOME/6iserver
2.
source forms60.csh
※B シェルをお使いの場合は、forms60.sh を使用します。また、これらのシェルスクリプトはあらかじめお
使いの OS や環境に合わせて修正しておく必要があります。
Forms Services の使用
Forms Services の起動と停止は、forms60_server、というシェルスクリプトで行うことができます。Forms
Services の使用は、このシェルスクリプトだけで可能です。
このコマンドの実行により、Oracle9i Application Server 環境下では ORACLE_HOME が
$ORACLE_HOME/6iserver に切り替えられ、その他に Forms Services 関連の環境変数が設定されます。環境
変数については、
お使いの OS や環境に合わせてファイルの修正が必要な場合があるので注意が必要です。
環境変数の意味については、インストレーション・ガイドを参照してください。
また、このシェルスクリプトでは、Oracle HTTP Server の起動と停止はできません。別途行ってください。
第５章 Oracle Forms Developer and Oracle9iAS Forms Services R6i (Patch13)
87
Windows 2000 への JInitiator のインストール
Windows 2000 のグループは主に Administrators、Power Users、Users の三つがあります。JInitiator をインス
トールする際は、Administrators、または Power Users グループに属するユーザーで行う必要があります。
Project Builder
既知の問題はありません。
Form Builder
塗りパターンのパフォーマンスに対する影響
大きな Forms オブジェクトに塗りパターンを割り当てると、Web 上のランタイム・パフォーマンスが低下
することがあります。オブジェクトは、64x64 ピクセルの増分で塗り込まれます。したがって、64x64 より
大きなオブジェクトには複数の操作が必要です。（たとえば、800x600 のサイズのウィンドウを塗るには、
このような操作が 120 回必要です。）
推奨事項:どうしても必要としない限り、大きなオブジェクトに塗りパターンを使用することは避けてくだ
さい。また、異なるパターンの数を最小限にしてください。（使用される各パターンには 4K のメモリが必
要です。）
ドキュメントに記載されていないエラー・メッセージ（FRM-99999）
）
ドキュメントに記載されていないエラー・メッセージ（
オンライン・ヘルプに記載されていない Forms エラー・メッセージでは、次のような一般的なメッセージ
が表示されます。
FRM-99999 エラー: FRM-nnnnn が発生しました。このエラーに関する情報は、リリース・ノート・ファイ
ル（relnotes）を参照してください。
これらのエラー・メッセージの詳細は、次の項で説明します。
エラー・メッセージ 1412 と 1413
FRM-99999 エラー1412: スクロールバーのないブロックに対してスクロールバーの位置を設定しようとし
ました。
FRM-99999 エラー1413: スクロールバーのないブロックに対してスクロールバーの位置を取得しようとし
ました。
エラー・メッセージ 10905-10909
FRM-10905:次の戻り値が無効です。
原因: ウィザードのこのページを終了する前に、無効な戻り値を修正する必要があります。
処置: 有効な戻り値を入力します。戻り値は、次のいずれかであることが必要です。
1.
完全修飾された項目名（<BLOCK_NAME>.<ITEM_NAME>）。
2.
フォーム・パラメータ（PARAMETER.<PARAMETER_NAME>）。
3.
グローバル PL/SQL 変数（GLOBAL.<VARIABLE_NAME>）。
FRM-10906:1 つ以上の値リスト列に負の幅が設定されています。
原因: 値リストの 1 つ以上の列に負の幅が設定されています。
処置: 値リストのどの列にも負の幅が設定されていないことを確認します。
88
Oracle9i Application Server for Compaq Tru64 UNIX リリース・ノート
FRM-10907:値リストのサイズまたは位置に負の値が設定されています。
原因: 値リストのサイズおよび位置の 1 つ以上の属性が負に設定されています。
処置: 値リストのサイズおよび位置のどの属性も負ではないことを確認します。
FRM-10908:取り出された行数は 0 以下です。
原因: 取り出された行数が 0 以下です。
処置: 取り出されるレコード数に 0 より大きい値を入力します。
FRM-10909:値リスト・ウィザードを使用して、古い値リストを変更できません。
原因: 以前のバージョンで作成された値リストが、値リスト・ウィザードで起動されました。
処置: レコード・グループに基づいて新しい値リストを作成します。
エラー・メッセージ 13009-18010
FRM-13009:JavaBean が IView インタフェースをインプリメントしません。
原因: Forms でこの JavaBean を使用するためには、JavaBean により Oracle Forms IView インタフェースを
インプリメントする必要があります。
処置: Oracle Forms の oracle.forms.ui.IView インタフェースをインプリメントします。
FRM-18010:JavaBean を処理しようとした時に、不明エラーが発生しました。
原因: Forms でこの JavaBean を使用するためには、指定した JavaBean を Forms で検索およびインスタンス
化できなければなりません。
処置: 指定した JavaBean とそれに付随するクラス・ファイルが正しくインストールされていることを確認
します。Form Builder を再起動してから、JavaBean を再実行します。
エラー・メッセージ 18117-18121
FRM-18117:作業環境に、存在しない HTML への参照が含まれています。
原因: 作業環境ダイアログのランタイム・タブに HTML ファイルが指定されていますが、その HTML フ
ァイルが存在しないか、または指定された場所が存在しません。
処置: 作業環境ダイアログのランタイム・タブにおいて、無効な HTML ファイルへの参照を削除してデフ
ォルトの HTML ファイルを使用するか、または既存の HTML ファイルを指定します。あるいは、
指定されている場所に HTML ファイルを配置します。
FRM-18120:libjava.so が存在しません。
原因: Forms Services を Solaris 環境で機能させるためには、有効な JDK インストールがパスに存在してい
る必要があります。
処置: 有効な JDK がパスに存在しているかどうかを調べ、必要に応じて JDK を再インストールします。
FRM-18121:JavaBean が IView インタフェースをインプリメントしません。
原因: Forms でこの JavaBean を使用するためには、JavaBean により Oracle Forms IView インタフェースを
インプリメントする必要があります。
処置: Oracle Forms の oracle.forms.ui.IView インタフェースをインプリメントします。
第５章 Oracle Forms Developer and Oracle9iAS Forms Services R6i (Patch13)
89
Forms 環境変数の追加
次の新しい環境変数を使用できます。
FORMS60_WEB_CONFIG_FILE
この環境変数を使用して、Forms CGI 構成ファイルのフル・パスおよび名前を指定できます。
デフォルト値は$ORACLE_HOME/forms60/server/formsweb.cfg です。
例：FORMS60_WEB_CONFIG_FILE=$ORACLE_HOME/temp/myfile.cfg
Java キーバインディング API の提供
Forms において一貫性があり構成可能で効率的なキーバインディングを実現するために、キーバインディ
ング API が提供されます。この API は、まず、クライアントにキーバインディングをダウンロードします。
次に、この API はキー・シーケンスを問い合わせて対応するフォーム・アクションを返すか、あるいはフ
ォーム・アクションを問い合わせて対応するキー・シーケンスを返すことができます。
詳細は次のサブセクションを参照してください。
FormAction.java
標準のフォーム・アクションは FormAction.java に定義されます。これらのフォーム・アクションは、
FormAction クラスの静的インスタンスです。たとえば、「次フィールド」フォーム・アクションは
FormAction.FA_NEXT_FIELD として扱うことができます。
FormAction.java 内の様々なフォーム・アクションの定数は、frmweb.res から取得されます。FormAction.java
内のキーバインディング定数の初めの部分を次に示します。
public class FormAction extends Property
{
/*
** The constants (or id's) for various forms actions have
** been obtained from frmweb.res. These id's will not change.
** New forms actions will be assigned new id's.
*/
public static final FormAction FA_NEXT_FIELD
= new
FormAction(1);
public static final FormAction FA_PREVIOUS_FIELD = new
FormAction(2);
public static final FormAction FA_CLEAR_FIELD
= new
FormAction(3);
.
.
.
FormAction.java クラスに含まれているキーバインディングのすべての静的定数のリストを次に示します。
FA_NEXT_FIELD
FA_PREVIOUS_FIELD
FA_CLEAR_FIELD
FA_UP
FA_DOWN
FA_SCROLL_UP
FA_SCROLL_DOWN
FA_EDIT
FA_RETURN
FA_LIST_OF_VALUES
FA_HELP
FA_EXIT
FA_SHOW_KEYS
FA_COMMIT
FA_NEXT_PRIMARY_KEY
FA_CLEAR_RECORD
FA_DELETE_RECORD
FA_DUPLICATE_RECORD
90
Oracle9i Application Server for Compaq Tru64 UNIX リリース・ノート
FA_INSERT_RECORD
FA_NEXT_SET_OF_RECORDS
FA_NEXT_RECORD
FA_PREVIOUS_RECORD
FA_CLEAR_BLOCK
FA_BLOCK_MENU
FA_NEXT_BLOCK
FA_PREVIOUS_BLOCK
FA_DUPLICATE_FIELD
FA_CLEAR_FORM
FA_ENTER_QUERY
FA_EXECUTE_QUERY
FA_DISPLAY_ERROR
FA_PRINT
FA_COUNT_QUERY
FA_UPDATE_RECORD
FA_FUNCTION_0
FA_FUNCTION_1
FA_FUNCTION_2
FA_FUNCTION_3
FA_FUNCTION_4
FA_FUNCTION_5
FA_FUNCTION_6
FA_FUNCTION_7
FA_FUNCTION_8
FA_FUNCTION_9
FA_LIST_TAB_PAGES
KeyBinder.java - API の使用
キーバインディングをダウンロードし、要求されたフォーム・アクションまたはキー・シーケンスを取得
するには、KeyBinder API を使用します。このプロセスの概要を次に示します。
1.
起動コード内の downloadKeyBindings()を実行します。
2.
isKeyBindingsAvailable()を使用して、キーバインディングがクライアント上で使用できるかどうかをテ
ストします。
3.
キーバインディングが使用できる場合、getKeySequence (FormAction action)を使用して、要求されたフ
ォーム・アクションのキー・シーケンスを取得します。
または
getFormAction (KeyEvent event)を使用して、要求されたキー・シーケンスのフォーム・アクションを取
得します。
次の KeyBinder.java API メソッドを使用します。
public synchronized static void downloadKeyBindings()
* クライアント上にキーバインディングが作成されていない場合、このメソッドは、サーバーにそのバイ
ンディングを送るように要求します。これはブロッキング・コールではありません。これは、サーバーか
らキーバインディングを取得するためにラウンドトリップが発生するのを避けるためです。サーバーは、
次にラウンドトリップが発生したときに必要な情報を送ります。
public synchronized static Hashtable getKeyBindings()
* このメソッドは、すべてのキーバインディングのクローン表を返します。
public synchronized static boolean isKeyBindingsAvailable()
* このメソッドは、キーバインディングがクライアント上で使用できるかどうかを調べます。
public synchronized static KeyEvent getKeySequence(FormAction action)
* このメソッドは、要求されたフォーム・アクションに対応するキー・シーケンスを取得します。
public synchronized static FormAction getFormAction(KeyEvent event)
* このメソッドは、要求されたキー・シーケンスに対応するフォーム・アクションを取得します。
第５章 Oracle Forms Developer and Oracle9iAS Forms Services R6i (Patch13)
91
KeyBinder.java API の例
KeyBinder.java API を使用して、押されたキーからフォーム・アクションを取得するためのプログラムの例
を次に示します。
KeyBinder.downloadKeyBindings();
// get bindings from server
その後、テキスト・フィールドの processKeyEvent(KeyEvent e)実装において、次のプログラムがイベントを
扱います。
//
//
//
//
//
//
If we have key bindings, see whether this event maps to
one that we care about.
If it does, record which event it is with the name of
the action that goes with it.
Many actions can be invoked by buttons, key presses,
and/or menu selections...
if (KeyBinder.isKeyBindingsAvailable())
{
String
actionName;
FormAction fact = KeyBinder.getFormAction(e);
if (fact == (FormAction) null)
{
// if no binding found, issue message.
system.out.printer("No binding found.");
}
else if (fact == FormAction.FA_LIST_OF_VALUES)
actionName = "LOV";
else if (fact == FormAction.FA_EDIT)
actionName = "FLDEDIT";
else if (fact == FormAction.FA_EXIT)
actionName = "CANCEL";
else
{
}
.
.
.
Web 上で Run_Product を使用するための要件
フォームで Run_Product を使用してレポートを実行し、ブラウザのウィンドウに出力を表示する場合は、
次のことを行う必要があります。
TMPDIR 環境変数を削除する。
索引構成表の使用
Forms で索引構成表を使用するには、ブロックのキー・モードが「更新可能」または「更新不可」のいず
れかに設定されている必要があります。また、主キーの指定も必要です。
Netscape ユーザーのレポート HTML ファイルの保存
Forms Services のインストール・プロセスでは、"HTML"（大文字）という値を持つ FORMS60_REPFORMAT
という名前の環境変数を作成します。レポートを起動する Netscape ブラウザでユーザーが Forms アプレッ
トを実行している場合、ブラウザにレポートが表示されるのではなく、ユーザーにレポート HTML ファイ
ルを保存するよう求められます。
FORMS60_REPFORMAT 環境変数を"html"（小文字）に設定することによってこの状況を回避できます。
Forms-Reports 統合における TMPDIR の非設定
Forms-Reports 統合を Unix システムの Web 上で機能させるためには、TMPDIR 変数が設定されていないこ
とが必要です。Forms リスナーを起動する前にこの環境変数の設定を解除します。
92
Oracle9i Application Server for Compaq Tru64 UNIX リリース・ノート
フォントの変更による Forms の問題
問題: Form Builder を使用しているときに、テキスト・オブジェクトを記述してからそのフォントを変更
すると、copy、paste および delete キーが機能しなくなります。
対処: 現時点ではありません。
Oracle Trace Collection の使用
Forms Services リリース 6i の Oracle Trace Collection はベータ版です。
HTTPS のサポートとブラウザ JVM
Internet Explorer のネイティブ JVM をエンドユーザーが使用する場合、ユーザーは、初期 Forms 起動用の
HTML ページを HTTPS でダウンロードする必要があります。エンドユーザーが Oracle JInitiator を（ブラウ
ザ JVM として）使用する場合は、ユーザーは、初期 Forms 起動用の HTML ページを HTTPS でダウンロー
ドする必要はありません。
IE での CAB サポートと Java セキュリティ
Forms 6i の CAB ファイル（f60all.cab）では、ブラウザでのデフォルトの Java セキュリティ設定（高、中、
低）がサポートされます。Java コードの実行時に最も高度な保護環境を提供するために、セキュリティ設
定を「高」にすることをお薦めします。「カスタム」セキュリティ設定を使用する場合、未署名コンテン
ツ・フラグを使用可能に設定するか、またはサンドボックス内で実行できるように設定する必要がありま
す。
Java Importer
Builder の Web プレビュー・モードを使用する場合、Java Importer は機能しません。Java Importer は、ドキ
ュメントに記載されているとおり、クライアント/サーバーのランタイム・モードまたは Oracle9iAS Forms
Services を使用した配置環境で機能します。
Java Importer を使用する前に、JDK 1.2.2 を手動でインストールする必要があります。
OEM と Forms 内部処理
Developer サーバー・ノードの下にジョブを作成する場合、Oracle Enterprise Manager（OEM）のコンソール
上で、「Forms 内部処理」というラベルが付けられた「タスク」タブに項目がリストされます。これらは
Forms の内部タスクです。OEM ジョブ内でスケジュールしないでください。
Load Balancer Server のトレース・ログ
のトレース・ログ
トレース・レベルに 0 より大きい値を指定して Load Balancer Server（d2ls60）を起動すると、Load Balancer
Server のトレース・ログが作成されます。d2ls60 Load Balancer Server をコマンドラインから起動した場合、
d2lslog.txt ログ・ファイルは、デフォルトでは Load Balancer Server が起動されたディレクトリに作成されま
す。
Oracle9iAS Forms Services 非 SSL リスナーの要件
Oracle9iAS Forms Services では、Apache が少なくとも 1 つのポート上で非 SSL モードでリスニングしてい
る必要があります。これは、Oracle JInitiator が SSL 経由で Forms Applet をダウンロードできないためです。
チャート・ウィザード
このリリースでは、チャート・ウィザードの使用はサポートされません。
第５章 Oracle Forms Developer and Oracle9iAS Forms Services R6i (Patch13)
93
IE での印刷機能
Oracle9iAS Forms Services アプリケーションを Internet Explorer で使用する場合、
印刷機能は動作しません。
og.pll の使用
og.pll を使用して Forms に Graphics を埋め込む場合には、Oracle Developer R6i のインストール CD-ROM に
ある、
/<CD-ROM>/extras/forms/graphics/og.pll
をコピーして使用して下さい。
Report Builder
（Reports Developer 用の別の項を参照してください。）
Graphics Builder
Unix 上での必要な環境変数の設定
Graphics 統合を Unix システム上で機能させるためには、次の環境変数を設定する必要があります。
setenv TK_PRINTER <printer_name>
setenv TK_PRINT_STATUS echo
Query Builder
既知の問題はありません。
Schema Builder
既知の問題はありません。
Translation Builder
既知の問題はありません。
Procedure Builder
既知の問題はありません。
Open Client Adapter
既知の問題はありません。
各国語サポート
すべての言語で確認されている問題
Form Builder のユーザー・インタフェースの不完全な翻訳
一部の言語では Form Builder のユーザー・インタフェースの翻訳が完全ではありません。（日本語では、
翻訳されたユーザー・インタフェースが提供されています）
94
Oracle9i Application Server for Compaq Tru64 UNIX リリース・ノート
それら翻訳が完全でない言語の場合は、英語のインタフェースを使用してください。
そのためには、次の設定をします。
DEVELOPER_NLS_LANG=AMERICAN_AMERICA.<charset>
USER_NLS_LANG=< Language>_<Territory>.<charset>
この設定は、Builder を実行しているワークステーションで行います。
< Language>にフォームを実行する言語を代入します。
< Territory>にフォームを実行する地域を代入します。
<charset>に使用する Oracle キャラクタ・セットを代入します。
一部のウィザード・ボタンのテキストの未翻訳
Unix システム上のウィザードでは、ボタンのテキストが英語で表示される場合があります。
印刷取消し後のキーボードでのメニュー・アクションの使用不可
問題: キーボード・コマンドでフォームにアクセスし、印刷ダイアログを選択してからそのダイアログを
数回取り消すと、印刷ダイアログが表示されなくなります。
対処: ダイアログの取消しを繰り返す等の操作を避けてください。
FMRWEB.RES の手動構成の必要性
ファイル"fmrweb.res"にはキーボード・マップが含まれています。このマップは、ユーザーのブラウザに入
力されたキー・ストロークを検出し、そのキー・ストロークを Forms アクションにマップするために、
Oracle9iAS Forms Services によって使用されます。このマップは、キーボードが VT100 キーボードと同様の
ものであることを前提としています。
ユーザーが PC スタイルのキーボードを使用している場合は、オリジナルの"fmrpcweb.res"のかわりにファ
イル"fmrweb.res"をコピーして使用することをお薦めします。これにより、サーバーはキーボードが 101 キ
ーの"PC"キーボードと同様のものであるとみなします。
デフォルトでは、言語に関係なく、US バージョンの fmrweb.res および fmrpcweb.res がインストールされま
す。さらに、特定の言語の場合、その言語の一般的なキーボードに適切なマッピング・ファイルがインス
トールされます。これらは、ファイル"fmrweb<lang>.res"と"fmrpcweb<lang>.res"（<lang>は Oracle 言語コー
ド）にインストールされます。たとえば、日本語の Oracle 言語コードは"ja"です。US バージョン以外の特
定の言語のファイルを使用するには、ファイル"fmrweb.res"のかわりに必要なファイルをコピーして使用し
ます。
Oracle9iAS Forms Services R6i 以降では、ファイル"fmrweb<lang>_utf8.res"と"fmrpcweb<lang>_utf8.res"もイン
ストールされます。これらのファイルには、"fmrweb<lang>.res"および"fmrpcweb<lang>.res"と同じキー・マ
ッピングが含まれています。ただし、これらのファイルは UTF8 キャラクタ・セットにエンコードされて
います。サーバーが UTF8 キャラクタ・セットを使用する場合は、これらのファイルが使用される必要が
あります（UTF8 は NLS_LANG に指定されるキャラクタ・セットです）。
NLS_LANG パラメータ値に関する情報
『Forms アプリケーション Web 利用ガイド』には、¥bonus¥nls¥nlsd2rl.wri という名前のファイルについて
の記載があります。しかし、このファイルはすでに最新のものではなく、製品 CD で提供されません。
NLS_LANG のパラメータ値の詳細は Oracle8 R8.0.6 サーバーのドキュメントを参照してください。有効な
NLS_LANG パラメータ値は、Forms とデータベース・サーバーで同一です。
Wallet Manager の英語のユーザー・インタフェース
Oracle9iAS Forms Services では Wallet Manager は英語のユーザー・インタフェースで提供されます。
第５章 Oracle Forms Developer and Oracle9iAS Forms Services R6i (Patch13)
95
ダブルバイト言語で確認されている問題
シングルバイト・フォントでの編集
問題: Builder のダブルバイト言語実装では、シングルバイトのフォント（例、Arial）を使用して編集する
と、文字化けが起こります。これは、編集フィールドで発生します。
対処: シングルバイト・フォントを使用せずに、ローマン・スクリプトを表示するダブルバイト・フォン
トを使用します。
日本語で確認されている問題
JA16EUC キャラクタ・セットの場合のモジュールの保存不可
キャラクタ・セットの場合のモジュールの保存不可
問題: キャラクタ・セットが JA16EUC の場合、Oracle データベースにモジュールを保存できません。
対処: かわりに、JA16SJIS キャラクタ・セットを使用します。
Windows から UNIX への移行時の長さの制限
問題: 30 バイトを超える長さの
（半角カタカナを使用した）
名前を持つオブジェクトを Windows から UNIX
に移行できません。
対処: 現時点ではありません。
PL/SQL エディタの表示の問題
問題: 1 行に入力された文字が、複数行に一部重複して表示されます。
対処: 現時点ではありません。
UTF8 の制限
問題: NLS_LANG が American_America.UTF8 に設定されている場合、JA16SJIS で作成された fmb ファイ
ルから fmx ファイルを作成できません。
対処: 現時点ではありません。
PL/SQL ライブラリ名におけるマルチバイト・キャラクタ・セットの使用不可
問題: マルチバイト・キャラクタ・セットを使用して PL/SQL ライブラリ名を作成できません。
対処: 現時点ではありません。
別の prefs.ora ファイルが必要となる場合
問題: 日本語版のインストールを選択した場合、JA16SJIS エンコードの日本語用の prefs.ora
（ORACLE_HOME の Cagpref.ora）がインストールされます。これにより、次のような他の
NLS_LANG 設定でアプリケーションを開発するお客様にいくつかの問題が発生します。
−
American_America.JA16SJIS (a)
または
−
Japanese_Japan.UTF8 (b)
対処:
a.
96
アメリカ英語用の prefs.ora ファイルが必要です。これらのファイルをインストール CD からコピ
ーする必要があります。
Oracle9i Application Server for Compaq Tru64 UNIX リリース・ノート
b.
UTF8 エンコードの prefs.ora ファイルが必要です。prefs.ora ファイルを JA16SJIS エンコードから
UTF8 エンコードに変換します。
PL/SQL インタプリタのメッセージ・テキストにおける言語の混在
Procedure Builder を実行する場合、PL/SQL インタプリタからのエラー・メッセージ（例、ORA-04098）が
英語で表示される場合があります。
Unix 上にキュー・カードをインストールするための記憶域の要件
Unix システム上にキュー・カードをインストールする場合、日本語 tar ファイルと US tar ファイルの両方
がインストールされます。これらの tar ファイルに必要な記憶域の合計は、約 275MB です。
キュー・カードはオプションです。記憶領域が小さい場合は、キュー・カードをインストールしなくても
かまいません。
ファイルのオープン、保存時の不具合
問題: ファイルのオープン/保存ダイアログボックスの文字が正しく表示されない場合があります。
対処: ダイアログ下部に並んでいる 3 つのボタンのうち、
左側のボタンを
「OK」、
中央のボタンを
「Update」
、
右側のボタンを「Cancel」としてご使用下さい。
異なるキャラクタ・セットで作成された OGD ファイルの実行
問題: 実行環境と異なるキャラクタ・セットで作成されたチャートを、Graphics または、Forms モジュー
ルから実行できません（例：Windows(SJIS)環境で作成した OGD ファイルを、UNIX の EUC 環境で
実行）。異なるキャラクタ・セットで作成した OGD ファイルを実行しようとすると下記のような
エラーが発生し、チャートが表示されない、間違った値でチャートが表示される、また Web 環境で
は、チャートが表示されるフィールドが空白になる場合があります。
「OG-04001 チャート・テンプレートにフィールド・テンプレートがありません」
「OG-04002 問い合わせ列にデータが見つかりません」
対処: 実行環境と同じとキャラクタ・セット環境で作成した OGD ファイルを使用してください。
Net8 構成ツールの制限
問題: net8asst.sh および netwiz.sh によって起動される Net8 構成ツールで、日本語で表示されるメッセージ
やメニュー項目のうち半角カナが正しく表示されません。
対処: Net8 設定ファイルを手動で編集しデータベース接続情報の設定を行ってください。
アラビア語で確認されている問題
UNIX 上でチャートを表示するための制限
UNIX バージョンの Oracle Forms Developer R6i を使用してチャートを作成するお客様は、UNIX オペレーテ
ィング・システムでは、Windows NT に比べてフォントとロケールのサポートが少ないことに注意する必要
があります。特に、UNIX には正式なアラビア語ロケールがありません。Oracle Forms Developer R6i for
Compaq Tru64 UNIX では、Unicode ロケールに対するサポートが非常に限られています。
したがって、アラビア語または Unicode を使用する場合、UNIX 上で作成されたチャートにはテキストが正
しく表示されません。これは、UNIX ベースのサーバーにアクセスする Web クライアント上に表示される
チャートでも起こります。これは、チャートがサーバー上でビットマップ・グラフィックにされるために
起こります。サーバーが UNIX ベースである場合、アラビア語および Unicode のフォントは使用できませ
ん。フォーム、レポート、グラフィックの他のテキストは、通常、直接クライアントに送られ、クライア
ントのロケールで処理されます。
第５章 Oracle Forms Developer and Oracle9iAS Forms Services R6i (Patch13)
97
対処方法として、Unicode ではなく西ヨーロッパのチャート・テキスト・フォントを選択することをお薦め
します。
その他の問題点
ドキュメントに関する既知の問題点
&Auml タグ
ブラウザによっては特定の文字が正常に表示されないことがあります。HTML のドキュメントで&Auml タ
グを Netscape で正常に表示できません。
Java Importer のための環境設定
ドキュメント「J02409-01 Oracle9i Application Server for Windows and UNIX Forms アプリケーション Web 利
用ガイド リリース 1.0.2」の「C.3 インストール要件」に記述されている設定に加え、jvm のあるディレク
トリを PATH 環境変数に追記する必要があります。
1. JDK 1.2.2 をインストールする。
2. libjvm.so のある場所を LD_LIBRARY_PATH に追加する。
例：
setenv LD_LIBRARY_PATH
${JAVAHOME}/jre/lib/alpha/native_threads:${JAVAHOME}/jre/lib/alpha:${JAVAHOME}/jre/lib/alpha/classic:${
LD_LIBRARY_PATH}
注：ここで JAVAHOME とは JDK をインストールしたディレクトリを指す。
3. importer.jar(通常$ORACLE_HOME/lib/importer.jar)を CLASSPATH 環境変数に追加。
setenv CLASSPATH $ORACLE_HOME/lib/importer.jar;$CLASSPATH
注：importer.jar は絶対パスで指定。
Forms アプリケーション Web 利用ガイド
CD から$ORACLE_HOME/doc60/admin/manuals/JA/deploy60 ディレクトリにインストールされるドキュメン
トは古い内容です。
Oracle9i Application Server のドキュメント CD に含まれる
「J02409-01 Oracle9i Application
Server for Windows and UNIX Forms アプリケーション Web 利用ガイド リリース 1.0.2」
を参照してください。
Oracle Developer for Compaq Tru64 UNIX R6i Patch13 の適用
パッチの適用に関して
このパッチを適用する場合には、あらかじめ Oracle Developer for Compaq Tru64 UNIX R6i、または Oracle
Developer Server for Compaq Tru64 UNIX R6i、または Oracle9i Application Server Enterprise Edition R1.0.2 がイ
ンストールされている必要があります。
patch_install.sh スクリプトは$ORACLE_HOME に既にインストールされている製品のみに適用されます。
パッチのアンインストールが必要な場合は patch_install.sh で作成されるバックアップファイル及び
patch_deinstall.sh スクリプトを削除しないようにしてください。バックアップファイルは全て拡張子
が.PRE_P13 になります。
パッチを適用する場合は、インストールされているすべてのコンポーネントにパッチを適用する必要があ
ります。たとえば、Forms のみにパッチを適用し使用することはサポート対象外となります。
Forms か Reports の one-off パッチを適用する場合は、Patch13 をインストールした後に、それらのパッチを
再適用する必要があります。
98
Oracle9i Application Server for Compaq Tru64 UNIX リリース・ノート
パッチは Zip 圧縮されています。Zip ファイルを解凍する Unzip ユーティリティが無い場合は、Info-ZIP の
Web サイト( http://www.info-zip.org/ )等を参照することで Unzip に関する情報を入手することができます。
CD の内容
CD のルートディレクトリには次のファイルがあります。
README_dev6ip13.html
developer6i_p13.zip
README_dev6ip13.html は英語版 README ファイルです。
developer6i_p13.zip がパッチファイルです。
各コンポーネントのバージョンは、README_VERSION.html ファイルをご参照ください。
インストールに関して
このパッチを Oracle9i Application Server 環境に適用する場合は、環境変数 ORACLE_HOME を
<iAS_HOME>/6iserver に設定してください。また、 <iAS_HOME>/6iserver/lib を環境変数
LD_LIBRARY_PATH の最初に、<iAS_HOME>/6iserver/bin を環境変数 PATH の最初に設定してください。
このパッチには、RDBMS 8.0.6.3.0 ライブラリが含まれており、パッチのインストールの一部として RDBMS
8.0.6.3.0 ライブラリのアップグレードが自動的に行われます。このアップグレードを正常に行うため、環境
変数 ORACLE_HOME、DISPLAY 変数が適切に設定されているか確認し、patch_install.sh スクリプトがある
ディレクトリをカレントディレクトリとしてから、スクリプトを実行してください。
既に RDBMS 8.0.6.3.0 ライブラリがインストールされている場合、通常はインストールスクリプトが自動的
にそれを検出しますが、インストールスクリプトを複数回実行すると以下のダイアログが表示されること
があります。(初回は発生しません。)
「You have answered 'No' to installing patchset for RDBMS, returning to the Asset Manager Screen.」
ここで「Yes」を選択すると RDBMS ライブラリのインストールが終了して、インストール・スクリプトの
次の段階に進む事ができます。
注意: Oracle E-Business Suite 11i ユーザーは Oracle E-Business Suite 11i のドキュメントを参照して下さい。
注意:インストール時、「Default Display for Reports Server」画面でデフォルト・ディスプレイの値が表示さ
れますが先頭の一文字が欠けて表示されます。
例）"yourserver.domain.com:0.0"が"ourserver.domain.com:0.0"と表示されます。
1.
環境変数 ORACLE_HOME を設定します。
2.
ファイル developer6i_p13.zip を $ORACLE_HOME にコピーします。
3.
Unzip を用いてファイルを解凍します。
4.
パッチディレクトリに移動します。
5.
インストールのためのシェルスクリプトを実行します。
./patch_install.sh
インストールの途中、以下のエラーが発生する事がありますが、問題ありませんので無視してくださ
い。
ln:$ORACLE_HOME/6iserver/lib/libifjsl60.so と$ORACLE_HOME/6iserver/lib/libifjsl60.so.0 は同一で
す。 $ORACLE_HOME/6iserver/lib/libifjsl60.so を作成できません。ファイルが存在します。
6.
環境変数 LD_LIBRARY_PATH に
$ORACLE_HOME/network/jre11/lib/alpha/native_threads
を追加します。
7.
Relink します。
cd $ORACLE_HOME/procbuilder60/lib; make -f ins_procbuilder.mk install
第５章 Oracle Forms Developer and Oracle9iAS Forms Services R6i (Patch13)
99
cd $ORACLE_HOME/forms60/lib; make -f ins_forms60w.mk install
cd $ORACLE_HOME/reports60/lib; make -f ins_reports60w.mk install
cd $ORACLE_HOME/graphics60/lib; make -f ins_graphics60w.mk install
アンインストール方法
1.
環境変数 ORACLE_HOME を設定します。
2.
アンインストールのためのシェルスクリプトを実行します。
./patch_deinstall.sh
3.
Relink します。
cd $ORACLE_HOME/procbuilder60/lib; make -f ins_procbuilder.mk install
cd $ORACLE_HOME/forms60/lib; make -f ins_forms60w.mk install
cd $ORACLE_HOME/reports60/lib; make -f ins_reports60w.mk install
cd $ORACLE_HOME/graphics60/lib; make -f ins_graphics60w.mk install
このパッチで修正される不具合
修正される不具合の一覧は英語版の README を参照してください。
確認されている問題点
Oracle9i Database の NCHAR データ型
Oracle9i データベースを接続先データベースとして使用した場合、NCHAR(NVARCHAR2)列からデータを
取得する項目で、データが正しく表示されません。これは Oracle9i から NCHAR(NVARCHAR2)型の格納文
字コードが Unicode に変更されたことに伴い、Net8 クライアントから Oracle9i の NCHAR データ型を取得
する際に発生する現象と同一です。
キュー・カードの不正な表示
問題: JA16EUC 環境下ではキュー・カードの文字列が正常に表示されません。
対処: キャラクター・セットを JA16SJIS に設定してキュー・カードを起動します。
「デフォルト警告ボタン」プロパティ
「デフォルト警告ボタン」プロパティはオンライン・ヘルプにはオプションとありますが、必須です。
異なるフォーム間でライブラリや値を共有する場合
異なるフォーム間でライブラリを共有している場合、最初のフォームを閉じたときには値が失われます。2
つ目以降のフォームを閉じたときには値は保持されます。
モジュール間でひとつの値を共有する場合には、環境変数 DE_VARIABLESHARE に NULL 値以外の値を
設定してください。
例 DE_VARIABLESHARE=YES
ただし、この環境変数を設定することにより、わずかなメモリー・リークが発生することがあります。し
たがって、異なるフォームがグローバル変数を共有し、2 番目のフォームが開いていて、最初のフォームが
閉じている場合にのみ、この環境変数を設定してください。
アラートが 2 回表示される
スクロール・バーをドラックして移動する際に、When-Validate-Item トリガーが起動し Alert が表示される
場合、アラートが 2 回表示されます。
100
Oracle9i Application Server for Compaq Tru64 UNIX リリース・ノート
JInitiator1.3.1.9 を利用した場合に、メッセージが文字化けする
を利用した場合に、メッセージが文字化けする
JInitiator 1.3.1.9 を利用すると、ブラウザ下部にあるメッセージ・バー（Forms のメッセージ・バーではあり
ません）に表示されるメッセージが文字化けする場合があります。特に Netscape を用い静的 HTML による
WebForms を実行する場合、文字化けしたメッセージが消えないことがあります。
Oracle Forms Developer 6i Patch10 新機能
Forms6i Patch10 では、次の機能が変更されました。これらの機能に対する詳細な資料が OTN-Japan から入
手可能です。OTN-Japan の Web サイト(http://otn.oracle.co.jp/)をご参照下さい。
タイムゾーンのサポート
Forms6i アプリケーションの DATETIME 値により、あるタイムゾーンから別のタイムゾーンに調整するこ
とができます。アプリケーションのすべてのレベルにおいてタイムゾーンを定義することで、正確な時間
がデータベースに格納されることになります。
新規プロパティ
Forms6i(Java クライアント)に、OK_TO_PASTE という新規プロパティが追加されました。このプロパティ
は、Boolean 型を返し、単一行テキスト項目、複数行テキスト項目、コンボ・ボックス項目に対して使用で
きます。
さらに、コンボ・ボックスで使用される EDITABLE(Boolean 型を返す)と SELECTION (Point を返す)の二
つも追加されています。
POST メソッドと RUN_PRODUCT ビルトインを、もう 1 つの別のフォーム・セッシ
ョンの起動に使用する場合
POST メソッドと RUN_PRODUCT ビルトインを使用してもう 1 つの別の Web 配置フォーム・アプリケー
ションを起動した場合、エラーが発生する可能性があります。
Connection from a new browser window not supported
回避策として、POST メソッドではなく GET メソッドを使用するという方法もありますが、新規のセッシ
ョンでは、run_product を「open_form」PL/SQL ビルトインで代用してください。これは、1 つのブラウザ・
ウィンドウ内で複数の Forms セッションを実行する場合に推奨される方法です。
Oracle Forms Developer 6i Patch9 新機能
Forms6i Patch9 では、次の機能が変更されました。これらの機能に対する詳細な資料が OTN-Japan から入
手可能です。OTN-Japan の Web サイト(http://otn.oracle.co.jp/)をご参照下さい。
ブラウザ言語の自動検出
Forms アーキテクチャは、複数の言語の配置をサポートしています。この機能の目的は、ユーザーが使用
する言語に一致する適切な構成を自動的に選択することです。この機能を使用すれば、だれでも同じ URL
を使用して Forms アプリケーションを実行でき、しかもユーザーが使用する言語でアプリケーションを実
行することができます。
Forms Listener Servlet におけるサーバー側長時間処理に関して
runtime プロセスにおいて、15 分以上かかるデータベース・クエリーのような長いオペレーションがサポー
トされます。以前のバージョンでは、servlet セッションはタイムアウト後（デフォルト：15 分）、Forms
セッションは完全に終了してしまいました。
第５章 Oracle Forms Developer and Oracle9iAS Forms Services R6i (Patch13)
101
Oracle Forms Developer 6i Patch8 新機能
Forms6i Patch8 では、次の機能が変更されました。これらの機能に対する詳細な資料が OTN-Japan から入
手可能です。OTN-Japan の Web サイト(http://otn.oracle.co.jp/)をご参照下さい。
formsweb.cfg ファイル内のパラメータ envFile および workingDirectory のサポート
formsweb.cfg ファイル (FormsServlet 構成ファイル)内に、runtime プロセスの環境設定ファイルおよび作業
ディレクトリを設定することが可能となりました。これにより、異なる作業ディレクトリおよび環境変数
によるマルチ構成が容易になります。
パスを指定しない場合の baseHTML および envFile
パラメータ baseHTML および envFile の値にパスを指定せずにファイル名のみ指定することが可能になり
ました(例:envFile=default.env)。パスが指定されていない場合には、Forms は baseHTML および envFile を
Forms Servlet 構成ファイル(formsweb.cfg)と同じディレクトリに探しにいきます。
formsweb.cfg ファイルの変更
ファイルの変更
パッチの適用により、Forms Servlet 構成ファイル（formsweb.cfg）に以下の項目が追加されます。
baseHTML=base.htm
baseHTMLJInitiator=basejini.htm
baseHTMLIE=baseie.htm
envFile=default.env
workingDirectory=
Servlet エンジン起動の際の PATH および LD_LIBRARYP_PATH の設定
Servlet エンジンを起動する際、PATH および LD_LIBRARY_PATH を設定する必要はありません。
FormsServlet パラメータに関して
Forms Servlet パラメータ baseHTML、baseHTMLie、baseHTMLJInitiator を設定する必要はありません。そ
れらは、Forms Servlet の構成ファイル(formsweb.cfg)の default セクションにて定義されます。
Servlet 構成要件の簡略化
Servlet 構成プロセスが簡略化されました。
Oracle Forms Developer R6i Patch7 新機能
Forms6i Patch7 では、次の機能が変更されました。これらの機能に対する詳細な資料が OTN-Japan から入手
可能です。OTN-Japan の Web サイト(http://otn.oracle.co.jp/)をご参照下さい。
ユーザー/パスワードの非表示
ユーザー パスワードの非表示
ユーザーID が構成ファイル（formsweb.cfg）で指定された場合、Forms サーブレット（または CGI）によっ
て生成された HTML ページには、ユーザーID 値（パスワードを含む）は表示されません。
Forms6i Patch7 より前のバージョンでは、ユーザーID が構成ファイル（formsweb.cfg）で指定されている場
合、Forms サーブレット（または CGI）によって生成されたページには、ユーザーID 値（パスワードを含
む）が HTML ソース内に含まれていました。これはセキュリティ上の問題となりえます。これに対する回
避策は、
ユーザーID やパスワードを指定せず、
ユーザーID およびパスワードを入力するプロンプトを Forms
に表示させることでした。
102
Oracle9i Application Server for Compaq Tru64 UNIX リリース・ノート
Patch7 では、ユーザーID パラメータ値は、Forms サーブレットが Listener サーブレットと共に使用された
場合、Forms サーブレットによって生成された HTML に含まれません。FormsCGI または固定 HTML ペー
ジを使用した場合、または Forms Listener を使用した場合、動作しません。
拡張されたシングル・サインオン（SSO）サポート
）サポート
拡張されたシングル・サインオン（
シングル・サインオン環境（Oracle Login Server を使用）内で実行中の Forms Service アプリケーションは、
アンパサンド（&）によって区切られた名前値のペアで構成される、特殊なログオン・フォーマットを要
求します。Patch 7 以前では、デフォルトでは、Forms ユーザーID フォーマットは formsweb.cfg ファイルを
変更することによってのみ変更可能でした。
拡張シングル・サインオン・サポートを使用するには:
拡張シングル・サインオン・サポートを使用するには
1.
ログオン・マスクを次のようなフォーマットに変更します。
username=value&password=value&database=value
次のエントリを formsweb.cfg ファイルに指定します。
userid=%user%/%password%@%database%
これは個々の構成セクション内でも使用できます。
例:
[myapp_sso]
userid=%user%/%password%@%database%
注意:
注意 %間の名前（ユーザー、パスワードおよびデータベース）は、URL でその後使用されるものと一
致するのであれば、変更可能です。
2.
Logon Server 管理者ページに移動します。Oracle Portal からアクセス可能です。Forms アプリケーショ
ンを新規外部アプリケーションとして構成します。以下の指定を確認します。
-
アプリケーションの起動に使用されている URL（たとえば、http://myserver/servlet/f60servlet ）。
-
ユーザー名およびパスワードの指定に使用されるログオン・パラメータのフィールド名。
-
予備ログオン・パラメータ（ユーザーに、または適切なデフォルト値で表示された）。例えば、
構成パラメータおよびデータベース接続情報。データベース接続パラメータ名は formsweb.cfg フ
ァイルに指定するものすべてです。
例えば、データベース接続パラメータに名前「Source」を定義するには、データベース接続パラ
メータを formsweb.cfg ファイル内に以下のように指定します。
userid=%name%/%password%@%Source%
-
POST のような「認証に使用するタイプ」。これは、ログオン・パラメータが POST メソッドを使
用して、URL パラメータとして Forms サーブレットに渡されたことを意味します。そのため、ユ
ーザーはブラウザから見ることができません。
Oracle Forms Developer R6i Patch6 新機能
Forms6i Patch6 では、次の機能が変更されました。
拡張されたネットワーク・リジリエンス
拡張されたネットワーク・リジリエンス
現状、Oracle Forms 6i Patch5 では、ネットワーク障害が数秒以上続いた場合、Oracle Forms セッションは失
われ、次のエラー・メッセージが表示され、結果的にいくつかの保存されていない情報が失われます。
「FRM-92100: サーバーへの接続が中断されました。原因はネットワーク・エラーまたはサーバー障
害の可能性があります。セッションを再度確立する必要があります。」
Patch6 では、（Bug#1762055 の修正に伴い）Listener サーブレットを使用するとき、クライアントはサーバ
ー（Oracle Forms ランタイム）からネットワーク障害を区別することができます。そして、ネットワーク障
害の場合、ネットワーク接続の再確立を試みます。クライアントは、<networkRetries>パラメータに指定し
第５章 Oracle Forms Developer and Oracle9iAS Forms Services R6i (Patch13)
103
た回数分、再接続を試みます。そして、接続試行ごとに、以下のようなメッセージをステータス・バーの
右側に表示します。
"2/30"
"2"は 2 回目の試行を意味し、"30"は<networkRetries>の値を表します。
クライアントが<networkRetries>パラメータで指定した回数分再試行してもサーバーと接続できなかった場
合、Oracle Forms セッションは異常終了し、次のメッセージが表示されます。
「FRM-92102: ネットワーク・エラーが発生しました。Forms クライアントはサーバーと<数字>回の
接続を試みましたが、成功しませんでした。ネットワーク接続を確認し、もう 1 度実行してください。」
サーバーに障害があった場合（Forms ランタイム・プロセスが予想せず終了した場合や、誰かが終了させ
た場合）、Oracle Forms セッションは異常終了し、次のメッセージが表示されます。
「FRM-92101: サーバーでエラーが発生しました。セッションを再度確立する必要があります。」
拡張ネットワーク・リジリエンス機能の使用
base HTML ファイルを編集し、新規"networkRetries"アプレット・パラメータを追加する必要がありま
す。その後、formsweb.cfg ファイルのデフォルト・セクションにこのパラメータを追加する必要があ
ります。次のような行を追加します。
networkRetries=30
このステップを踏まえない場合、デフォルト値 0 が使用されます。この場合、ネットワーク障害が発
生すると、クライアントは以前と同様の行動（すなわち、接続を再確立しない）をとります。ネット
ワークの性質や要求に応じて設定を変更する場合は、formsweb.cfg ファイルを編集します。
Listener サーブレットを使用した、HTTPS モード内での JInitiator の Forms アプリケ
ーション実行時のパフォーマンスの改善
以前は、JInitiator の HTTPS 実装は HTTP の keep-alive オプションを使用していませんでした。現在は、
keep-alive オプションは実装され（JInitiator 1.1.8.11 以降）、クライアントは、URL 要求ごとに再接続する
必要がなくなりました。したがって、シン・クライアントがサーバーと接続するごとに SSL 接続をする必
要はありません。
Oracle Forms Developer R6i Patch4 新機能
次に説明する新機能は Forms6i Patch4 でサポートされます。
さらに詳しい情報は、
ホワイト・ペーパー
「Forms
6i Patch 4:Forms Listener サーブレットによる Forms のインターネットへの配布」をご覧ください。なお、
Compaq Tru64 UNIX プラットフォームでは Patch4 は Patch4a を指します。
Forms Listner サーブレットの導入
Forms の以前のリリースでは、クライアントからの初期接続を管理するために Forms Listener を使用してい
ます。Forms Listener では、インターネット上で Forms アプリケーションを HTTP または HTTPS 配置で使
用する場合、Forms Listener を実行しているマシンとポートをファイアウォール上で公開する事に潜在的な
セキュリティ・リスクが存在することに留意する必要がありました。
Forms 6i Patch4 では新しく Forms Listener の機能を改良した Forms Listener サーブレット があり、Forms ア
プリケーションをインターネット上に配置する場合、より安全な接続を提供します。Forms Listener サーブ
レットはファイアウォールで公開されたマシン上で実行する必要がないためです。
注意：HTTP または HTTPS を用いてアプリケーションを配置する場合 Forms Listener サーブレットを使用
することをお勧めします。ただし、Forms Listener でも従来通り、直接のソケット接続、HTTP 接続および
HTTPS 接続をサポートしています。
104
Oracle9i Application Server for Compaq Tru64 UNIX リリース・ノート
必要条件
Oracle9iAS R1.0.2 以上が必要です。
Forms Listener サーブレットについて
Forms Listener サーブレットは、Oracle9i Application Server のようなサーブレット・エンジンを備えた Web
サーバー上で実行される Java サーブレットです。
Forms Listener サーブレットが管理するもの：
各クライアントに対する Forms Server Runtime プロセスの作成
クライアントと対応する Forms Server Runtime プロセス間のネットワーク通信
Forms Listener サーブレットを使用する理由
Forms Listener サーブレットはインターネット上に Forms アプリケーションをより強力に、より標準的に配
置するために設計されています。Forms Listener と Forms Listener サーブレットを比較すると次のような利
点があります。
ファイアウォールとプロキシが広範囲にサポートされます。
クライアント・ブラウザは Web サーバーと通信します。このアーキテクチャはサーブレット・
セッションを使用する標準的なサーブレットが動作可能なファイアウォールとプロキシをサポ
ートします。
プロトコルの制限(HTTP/1.1 または HTTP/1.0)がありません。
HTTP/1.1 に準拠しているプロキシを使用するとよりパフォーマンスが上がりますが、このアーキ
テクチャは HTTP/1.0 に準拠しているプロキシでも機能します。
管理するための余分なプロセスが不要です。
このアーキテクチャには Forms Listener プロセスおよび Forms Listener プロセスを起動、停止する
ための管理タスクが必要ありません。
SSL 配置のために特別なクライアント証明書を購入・管理する必要はありません。
SSL(Secure Sockets Layer)を使用した配置を行う場合、クライアント・ブラウザと Web サーバー
の間に HTTPS 接続が確立されるため、Forms Server レベルでの特別なセキュリティ構成は必要あ
りません。
標準的なロード・バランシングをサポートします。
このアーキテクチャでは、ハードウェアのロード・バランシング、リバース・プロキシおよび標
準的な Apache Jserv ロード・バランシングのような標準的なロード・バランシング方法を使用で
きます。
Internet Explorer 5.0 ネイティブ JVM をサポートします。
Oracle JInitiator に加えて、このアーキテクチャは HTTP および HTTPS 接続モードを使用したイン
ターネット配置に対する Internet Explorer 5.0 ネイティブ Microsoft JVM の使用をサポートします。
より詳細な情報について
Forms Listener サーブレットの詳細な説明（インストール、構成に関する情報）についてはホワイト・ペー
パー「Forms 6i Patch 4:Forms Listener サーブレットによる Forms のインターネットへの配布」を参照してく
ださい。Oracle Technology Network の Web サイト http://otn.oracle.co.jp/を参照してください。ホワイト・ペ
ーパーは更新される場合があります。
日本語環境での jserv.properties ファイルの修正
Forms Listener サーブレットを日本語環境で実行する場合は Oracle9iAS の Servlet 設定ファイル、
<9iAS_HOME>/Apache/Jserv/etc/jserv.properties に、以下に示す日本語環境用の記述を追加します。
第５章 Oracle Forms Developer and Oracle9iAS Forms Services R6i (Patch13)
105
次の行を追加します。
wrapper.env=NLS_LANG=Japanese_Japan.JA16EUC
エラーメッセージの追加
エラー・メッセージ 13009-18010
FRM-13009: JavaBean が IView インタフェースをインプリメントしません。
原因: Forms でこの JavaBean を使用するためには、JavaBean により Oracle Forms IView インタフェースを
インプリメントする必要があります。
処置: Oracle Forms の oracle.forms.ui.IView インタフェースをインプリメントします。
FRM-18010: JavaBean を処理しようとした時に、不明エラーが発生しました。
原因: Forms でこの JavaBean を使用するためには、指定した JavaBean を Forms で検索およびインスタンス
化できなければなりません。
処置: 指定した JavaBean とそれに付随するクラス・ファイルが正しくインストールされていることを確認
します。Form Builder を再起動してから、JavaBean を再実行します。
Oracle Forms Developer R6i Patch2 新機能
Oracle Forms Developer R6i Patch2 では、次の新しい機能がサポートされています。これらの新機能は、
『Oracle9i Application Server for Windows and UNIX Forms アプリケーション Web 利用ガイド リリース
1.0.2』に詳しく記述されています。
Oracle9i Application Server との統合
Forms サーブレット
f60all_jinit.jar ファイル
Internet Explorer 5.0 のサポート
Java Importer
Dynamic JavaBean Manager
次にそれぞれの新機能の概要を説明するとともに、詳細情報の参照先を示します。
Oracle9i Application Server との統合
Oracle9i Application Server にはあらゆるベンダーの中で最も広い範囲の中間層サービスが用意されており、
ポータルとトランザクション・アプリケーションの開発、柔軟な配置、企業での統合およびビジネス・イ
ンテリジェント・サービスのすべてがサポートされます。
Oracle9i Application Server を使用すると、低コストで迅速に、新規および既存のアプリケーションをインタ
ーネット上で実行できるようにすることができます。また、拡張性、可用性およびロード・バランス・サ
ービスを介した、パフォーマンス面の利点もあります。Oracle9iAS Forms Services を使用すると、Oracle
Forms Developer で作成したアプリケーションを、機能やインタフェースを損なうことなくインターネット
または社内のイントラネットで実行できます。
Forms サーブレット
Forms のロード・バランスおよびフォームの起動に使用するために、CGI に加えて Forms サーブレットが
用意されています。Forms サーブレットによってクライアントのブラウザ種別が自動的に検出され、それ
に応じた HTML ページがその場で生成されます。生成される HTML ページには、正しいタグと使用する正
しいアーカイブが含まれます。
106
Oracle9i Application Server for Compaq Tru64 UNIX リリース・ノート
Oracle9i Application Server の Forms Services 用設定ファイルの場所
ドキュメント CD に含まれる「J02409-01 Oracle9i Application Server for Windows and UNIX Forms アプリケー
ション Web 利用ガイド リース 1.0.2」内で Oracle9i Application Server を Forms Services を実行するために設
定するファイルのうちいくつかは、配置される位置が$ORACLE_HOME/6iserver/conf ディレクトリに変更さ
れています。
f60all_jinit.jar ファイル
f60all_jinit.jar ファイルは高圧縮された JAR ファイルで、ダウンロード時のパフォーマンスを向上させるた
めに Oracle JInitiator でのみ使用できます。
Internet Explorer 5.0 のサポート
Oracle9iAS Forms Services は、Internet Explorer 5.0 で実行されるネイティブ JVM (Java Virtual Machine) に対
する Bronze サポートを可能にするために Microsoft 固有の署名済 CAB ファイルを提供しています。これ
により、Internet Explorer 5.0 内で、Oracle Forms Java アプレットを信頼されたアプレットとして実行できま
す 。このブラウザ・オプションを使用すると、エンド・ユーザーのブラウザ環境を構成する必要性が少な
くなります。
Internet Explorer 5.0 とネイティブ JVM で稼動した場合の現在の制限事項は、次のとおりです。
1.
HTTP または HTTPS モードでは、Forms Services および Web リスナーが同一マシン上で稼動してい
る必要があります。
2.
HTTPS モードでは、Oracle9iAS Forms Services は、ファイアウォール経由で通信することはできま
せん。
3.
HTTPS モードでは、Oracle9iAS Forms Services アプレットは、HTTPS モードでダウンロードする必
要があります。
4.
HTTPS モードでは、heartbeat アプレット・パラメータをサーバーとの通信を維持するために低い値
に設定する必要があります。0.3（分）の値が、テスト、検証されています。
Internet Explorer 5.0 のネイティブ JVM は Microsoft 社により提供されています。Internet Explorer 5.0 のネイ
ティブ JVM をご使用の場合にのみ発生する Forms アプリケーションの不具合があった場合、オラクル社は
Microsoft 社に問題の報告を行い共に問題解決をはかって参りますが、Microsoft 社からの問題解決が必要に
なる場合もあります。
Java Importer
Forms Developer では Java Importer を使用して、Java クラスにアクセスする PL/SQL パッケージを生成でき
ます。さらに、生成された PL/SQL を Forms アプリケーション内で使用してプログラムを作成できます。
Java Importer で生成された PL/SQL は強力で、元の Java クラスのコンストラクタ、メソッドおよびフィー
ルドをサポートします。
Dynamic JavaBean Manager
JavaBeans をカスタム Java UI コンポーネントとして使用することで、Oracle Forms Java クライアントを拡
張できます。Forms の以前のリリースでは、Oracle Forms アプリケーション内で JavaBeans を使用する場合、
Forms コンポーネントと JavaBean コンポーネントの間で通信を行うためには特別なレイヤーのコードが必
要でした。このリリースでは、現行の JavaBean サポートに加えて Dynamic JavaBean Manager がサポートさ
れています。これにより、Oracle Forms 固有の Java レイヤー・コードを開発する必要がなくなりました。
Dynamic JavaBean Manager によって、指定した JavaBean のプロパティとメソッドが自動的に登録され、
Forms の PL/SQL から利用できるようになります。プロパティおよびメソッドは、Java の標準的なリフレク
ション・メカニズムを使用して検出され、一貫した命名メカニズムを使用して登録され、その後 Forms ア
プリケーションで使用するためにアクセスできるようになります。さらに、Dynamic JavaBean Manager に
は型変換メカニズムも用意されています。これは Java の基本データ型と PL/SQL の標準的なデータ型とを
自動的に変換するものです。この型変換メカニズムは完全に拡張可能であり、標準でないデータ型の変換
をするために、独自の型コンバータを作成することができます。
第５章 Oracle Forms Developer and Oracle9iAS Forms Services R6i (Patch13)
107
第６章 Oracle Reports Developer and Oracle9iAS Reports Services
R6i (Patch13)
はじめに
この章の目的
この章では、Oracle Reports Developer および Oracle9iAS Reports Services リリース 6i と、ドキュメントに記
載された機能との相違点を説明します。
サーバーのライセンス
Reports または Graphics を Web 環境に配置する場合は、Oracle9iAS Reports Services とそれに関連するライ
センスが必要であることに注意してください。
Oracle9iAS Reports Services スケジューラを使用して Reports をスケジュールする場合にも同様です。
Reports Services は、開発目的用に Oracle Developer CD-ROM に含まれていますが、Reports Developer とは別
にライセンスされます。
概要
コンポーネントのバージョン番号
Oracle Reports Developer R6i の最初のリリースでは、ほとんどの主要コンポーネント（Report Builder など）
に 6.0.8 というバージョン番号が付いています。また、ほとんどのサブコンポーネント（Toolkit など）に
6.0.5 というバージョン番号が付いています。これらのバージョン番号は、このリリースのサブコンポーネ
ントに適切なバージョン番号です。
RSF コンポーネントの追加のバグ修正
コンポーネントの追加のバグ修正
この製品のこのリリースには、いくつかの RSF コンポーネントが含まれています。この RSF コンポーネン
トには、コンポーネントに対する正式な、番号付きパッチ内のコード修正とは別の修正が含まれます。（コ
ンポーネントのこれらの修正またはパッチレベルは、"ワンオフ"と呼ばれることがあります。）
特に、このリリースには、バグ 1063571、1063104、1028960、1049171 および 1040536 の修正が含まれてい
ます。これらのバグ修正は、コンポーネント sqlnet、rdbms、nls および plsql に影響します。
日付の扱い
Oracle Reports Developer での日付の扱いに関する重要な情報については、http://www.oracle.co.jp/year2000/
を参照し、資料と White Paper へのリンクに従ってください。
サポートするデータベース
パッチ(Oracle Developer R6i Patch13)を適用することで、Oracle Server リリース 7.3.4, 8.0.4, 8.0.5, 8.0.6, 8.1.5,
8.1.6, 8.1.7, 9.0.1, 9.2 をサポートします。
使用可能なキャラクタ・セット
本リリースでサポートされる日本語キャラクタ・セットは JA16SJIS 及び JA16EUC です。
108
Oracle9i Application Server for Compaq Tru64 UNIX リリース・ノート
確認されている制限
データベース・オブジェクト名における非英数字
Oracle Reports Developer R6i は、ASCII 文字のうち英数字以外（!や*など）を使用した表名および列名をサ
ポートしません。
このリリースと互換性のあるプリコンパイラ
Oracle プリコンパイラを使用して Oracle Reports Developer R6i 用のユーザー・イグジットを開発する場合は、
Oracle8 R8.0.6 に対応したバージョンのプリコンパイラを使用してください。
UNIX 上の ORAINFONAV_DOCPATH 環境変数
Unix プラットフォームでは、ORAINFONAV_DOCPATH 環境変数がオンライン・マニュアルの場所に設定
されている必要があります。この環境変数のデフォルト値は、英語版のオンライン・マニュアルの場所
（$ORACLE_HOME/doc60/admin/manuals/US）に設定されています。日本語版のオンライン・マニュアルを
参照する場合は、ORAINFODOC_DOCPATH 環境変数を$ORACLE_HOME/doc60/admin/manuals/JA に設定す
る必要があります。
Oracle File Packager
Oracle File Packager（Reports Developer ドキュメントに記載されています）は、このリリースには含まれま
せん。
UNIX 上でのヘルプのインストールに必要な追加ステップ
Reports Developer ヘルプ・システムを Unix システム上で正しく動作させるには、ORACLE_AUTOREG 変
数を値$ORACLE_HOME/guicommon6/tk60/admin に設定する必要があります。（このヘルプ・システムには、
ツールキット・オートメーション・レジストリである autoprefs.oar ファイルが必要です。UNIX 用のオンラ
イン・ヘルプは英語です。）
TEMPLATES ディレクトリの欠落
Oracle Forms Developer および Oracle Reports Developer のマニュアル『アプリケーション作成ガイド』には、
TEMPLATES ディレクトリについての記載があります。しかし、この製品には TEMPLATES ディレクトリ
は含まれていません。
Database Admin スクリプトにおける Oracle Translation Builder（
（OTB）の必要性
）の必要性
Database Admin Build スクリプトおよび Drop スクリプトは、Oracle Translation Builder SQL スクリプトを検
出できない場合、失敗します。
この問題は、製品 CD から明示的に Oracle Translation Builder をインストールすることによって回避できま
す。
Oracle Repository との統合
Oracle Reports Developer は、Oracle Repository と統合できます。
このリリース 6i は、ソース制御管理のためにリポジトリとの統合を可能にする d2sc プラグイン（PVCS、
ClearCase およびその他の製品に提供されるプラグインと同様のもの）
とともに出荷されます。
ユーザーは、
FMB、MMB などをチェックインおよびチェックアウトすることができ、リポジトリの依存性追跡やその
他の高度な機能を使用できます。(詳細はリポジトリのドキュメントを参照してください。）
この初期機能により、今後の Reports Developer リリースにおける高度なレベルの統合の可能性が確立され
ます。
第６章 Oracle Reports Developer and Oracle9iAS Reports Services R6i (Patch13)
109
Oracle8i R8.1.6 Server に接続する際の問題
オペレーティング・システムの認証を使用して Oracle Reports Developer 製品から Oracle8i R8.1.6 データベ
ースに接続できないことがあります。（この問題はサーバーのバグ 1139334 によるものです。）
クイック・ツアー
Solaris では、環境変数 REPORTS60_DEV2K が FALSE に設定されていることを確認する必要があります。
これが FALSE に設定されていない場合は、「ヘルプ」メニューまたは「Report Builder へようこそ」ダイ
アログから Reports Developer のクイック・ツアーを呼び出せません。
Forms のアンインストールによるクイック・ツアーの使用不可
Report Builder と Form Builder の両方をインストールし、その後 Form Builder をアンインストールすると、
Report Builder とその他の Builder の「ヘルプ」メニューにクイック・ツアーが表示されなくなります。
ORACLE_HOME について
Oracle9i Application Server のインストール直後、ORACLE_HOME はインストールで使用したディレクトリ
に設定されています。Reports 関連コンポーネントを使用するにあたっては、そのディレクトリの下の
/6iserver というディレクトリを ORACLE_HOME として使用します。
Oracle Reports Developer クライアント/サーバーコンポーネントの使用前の作業
クライアント サーバーコンポーネントの使用前の作業
.rdf ファイルの作成、コンパイル作業など、Oracle Reports Developer のクライアント/サーバーコンポーネン
トを使用する場合、ログイン後下記の作業をしてください。この作業によって、Reports Developer 関連の
環境変数が設定されます。また Oracle9i Application Server 環境下では ORACLE_HOME が
$ORACLE_HOME/6iserver に切り替えられます。
（C シェルの場合）
1.
cd $ORACLE_HOME/6iserver
2.
source reports60.csh
※B シェルをお使いの場合は、reports60.sh を使用します。また、これらのシェルスクリプトはあらかじめ
お使いの OS や環境に合わせて修正しておく必要があります。
Reports Services の使用
Reports Services の起動と停止は、reports60_server、というシェルスクリプトで行うことができます。Reports
Services の使用は、このシェルスクリプトだけで可能です。
このコマンドの実行により、Oracle9i Application Server 環境下では ORACLE_HOME が
$ORACLE_HOME/6iserver に切り替えられ、その他に Reports Services 関連の環境変数が設定されます。環
境変数については、お使いの OS や環境に合わせてファイルの修正が必要な場合があるので注意が必要で
す。環境変数の意味については、インストレーション・ガイドを参照してください。
また、このシェルスクリプトでは、Oracle HTTP Server の起動と停止はできません。別途行ってください。
Project Builder
初期パラメーターの修正
問題: Report Builder モジュール、Report Builder ライブラリモジュールなど、Report Compiler によってビル
ドされるよう設定されているモジュールのビルド時に、「FRM-90927 コマンド・ラインのパラメー
タが不明です。」エラーが出力されます。
110
Oracle9i Application Server for Compaq Tru64 UNIX リリース・ノート
対処: グローバル・レジストリノードで、各モジュールのプロパティパレットを開き、アクションノード
の「・・・からビルド」に入力されている初期パラメーターから、"Minimize=YES" を削除してく
ださい。
Form Builder
（Forms Developer 用の別の項を参照してください。）
Report Builder
新しく追加されたビルトイン・プロシージャ
このリリースには次の 3 つのビルトイン・プロシージャが新しく追加されています。
SRW.SET_XML_PROLOG
SRW.SET_XML_TAG
SRW.SET_XML_TAG_ATTR
これらのビルトイン・プロシージャによって、PL/SQL の XML 出力プロパティを設定できます。各ビルト
イン・プロシージャについて、次の項で説明します。
SRW.SET_XML_PROLOG
構文:
SRW.SET_XML_PROLOG(type, 'string');
このプロシージャは、現行のレポートの XML Prolog を置き換えます。必要な XML Prolog（<?xml
version="1.0"?>）を指定する必要があります。また、エンコードやその他のコメントを指定できます。
type: SRW.FILE_ESCAPE または SRW.TEXT_ESCAPE。
これは、string パラメータがファイル名であるか、挿入されるテキストであるかを示します。
string: これは、ファイル名または使用されるテキストです。どちらであるかは、type パラメータに何を指
定したかによって異なります。
参照: XML Prolog 型プロパティおよび XML Prolog 値プロパティ。
制限: SRW.SET_XML_PROLOG は、レポートがフォーマットを開始する前に起動するトリガー（例、Before
Report トリガー）内に設定する必要があります。
このビルトイン・プロシージャの使用例は、このリリース・ノートの「キャラクタ・セットの変換」に記
載されています。
SRW.SET_XML_TAG
構文:
SRW.SET_XML_TAG(type, 'name', 'string');
このプロシージャは、現行のレポート、グループ、外部グループ、または列の XML タグを置き換えます。
type: SRW.REPORT_XML、SRW.GROUP_XML、SRW.GROUP_OUTER_XML または SRW.COLUMN_XML。
これは、オブジェクトがレポート・オブジェクト、グループ・オブジェクト、列オブジェクトのいずれで
あるかを示します。また、グループ・オブジェクトである場合、グループの XML タグに対するものである
か、外部グループの XML タグに対するものであるかを示します。
name: 設定される、レポート・オブジェクトの XML タグです。
string: 使用する XML テキストです。
参照: XML タグ・プロパティおよび XML 外部タグ・プロパティ。
第６章 Oracle Reports Developer and Oracle9iAS Reports Services R6i (Patch13)
111
制限: SRW.SET_XML_TAG は、レポートがフォーマットを開始する前に起動するトリガー（例、Before
Report トリガー）内に設定する必要があります。
例:
function BeforeReport return boolean is
begin
SRW.SET_XML_TAG(SRW.REPORT_XML, 'DEPT', 'TOOLS_DIVISION');
SRW.SET_XML_TAG(SRW.GROUP_OUTER_XML, 'G_DEPTNO',
'DEPARTMENT_LISTING');
SRW.SET_XML_TAG(SRW.GROUP_XML, 'G_DEPTNO', 'DEPARTMENT');
SRW.SET_XML_TAG_ATTR(SRW.GROUP_XML, 'G_DEPTNO',
'NUMBER="&DEPTNO"');
SRW.SET_XML_TAG(SRW.COLUMN_XML, 'DNAME', 'DEPARTMENT_NAME');
return (TRUE);
end;
SRW.SET_XML_TAG_ATTR
構文:
SRW.SET_XML_TAG_ATTR(type, 'name', 'attribute');
このプロシージャは、SRW.SET_XML_TAG と似ていますが、XML タグではなく属性値を提供します。上
記の例を参照してください。
REP-3000 エラー・メッセージ
rwrun60 をバッチ・モードで実行すると、出力の生成中にエラーREP-3000 が発生します。これは、Windows
で rdf ファイルが作成される場合に起こります。
出力は正しく生成されます。このメッセージは無視してください。
HTML/XML 出力の国際化
キャラクタ・セットの識別
クライアント（ブラウザ）、中間層（Reports Services）、データベースのすべてが異なるキャラクタ・セッ
トで実行される 3 層アーキテクチャでは、データが正しく変換され、表示されることを確認することが重
要です。Net8 では、データベース−Reports Services 間の変換を扱います。ただし、レポート出力は Reports
Services が実行されたキャラクタ・セットで生成されるので、ブラウザに HTML または XML がどのキャラ
クタ・セットで生成されたかを認識させることが重要です。
HTML の場合、次の META タグ（通常、<HEAD>タグと</HEAD>タグの間に置きます）でこれを行うこと
ができます。
<META CONTENT="text/html; charset=windows-1251" HTTP-EQUIV=Content-Type >
XML の場合は、次の Prolog（最初の行）でこれを行うことができます。
<?xml version="1.0" encoding="windows-1251"?>
上記の例は、windows-1251 キャラクタ・セットに切り替える場合のものです。
注意: これらの設定は、Netscape および Microsoft IE に有効です。他のブラウザには、キャラクタ・セット
の動的な切替えをサポートしないものもあります（例、Opera）。詳細は、
http://www.w3.org/International/で、この件に関する W3C の資料を参照してください。
レポートの開発者は、NLS_LANG 環境変数の値を取得することによって、レポートが生成されるキャラク
タ・セットを調べることができます。これは、LANGUAGE_TERRITORY.CHARACTERSET という形式で
す。（たとえば、JAPANESE_JAPAN.JA16EUC）最後の引数がキャラクタ・セットです。
Oracle キャラクタ・セットは、国際組織（IANA など）が標準を制定する前に定義されたものなので、Oracle
バージョンと標準バージョンでは、キャラクタ・セットの名前が少し異なることがあります。
112
Oracle9i Application Server for Compaq Tru64 UNIX リリース・ノート
ブラウザは、標準名のみを認識します。したがって、Oracle キャラクタ・セット名をそれに対応する標準
名に変更する必要があります。次のサブセクションに、キャラクタ・セットの対応関係を示します。
IANA キャラクタ・セットとそれに対応する Oracle キャラクタ・セット
これは、一般的なキャラクタ・セットとそれに対応する Oracle キャラクタ・セットのリストですが、決定
版ではありません。
IANA キャラクタ・セット
Oracle キャラクタ・セット
US-ASCII
US7ASCII
ISO-8859-1
WE8ISO8859P1
ISO-8859-2
EE8ISO8859P2
ISO-8859-3
SE8ISO8859P3
ISO-8859-4
NEE8ISO8859P4
ISO-8859-5
CL8ISO8859P5
ISO-8859-6
AR8ISO8859P6
ISO-8859-7
EL8ISO8859P7
ISO-8859-8
IW8ISO8859P8
ISO-8859-9
WE8ISO8859P9
windows-1250
EE8MSWIN1250
windows-1251
CL8MSWIN1251
windows-1253
EL8MSWIN1253
windows-1254
TR8MSWIN1254
windows-1255
IW8MSWIN1255
windows-1256
AR8MSWIN1256
windows-1257
BLT8MSWIN1257
windows-1258
VN8MSWIN1258
EUC-JP
JA16EUC
Shift_JIS
JA16SJIS
EUC-KR
KO16KSC5601
GB2312
ZHS16CGB231280
Big5
ZHT16BIG5
UTF-8
UTF8
サポートする PDF のバージョン
Reports は、PDF 1.1 をサポートしています。
レポートに英語ではないキャラクタ・セットの言語（通常マルチバイト）または Unicode キャラクタ・セ
ットが含まれている場合、Adobe Acrobat Reader では、Report Builder によって生成された.PDF レポート・
ファイルを読み取ることができません。ただし、Reports からポスト・スクリプトを生成し（Reports がポス
ト・スクリプト出力で正しいフォントを参照していることを確認します）、結果として得られたポスト・
スクリプト・ファイルを、「全フォントを埋め込む」オプションを有効にして Adobe の Distiller プログラ
ムに渡せます。これにより、サブセット・フォントが埋め込まれた PDF ファイルが作成されます。その後、
Acrobat を使用してその埋込みフォントを持つポスト・スクリプトを生成します。
第６章 Oracle Reports Developer and Oracle9iAS Reports Services R6i (Patch13)
113
PDF ページの幅の制限
Adobe Acrobat Reader には表示制限があります。Acrobat Reader が扱うことのできる最大ページ幅は、45 イ
ンチです。レポートのページ幅が 45 インチよりも大きく設定され、PDF 形式で生成される場合、Acrobat
Reader には何も表示されません。
Advanced Networking Option
Reports Multi-tier Server は、現在、Advanced Network Option をサポートしていません。
Microsoft IE4 と PDF で確認されている問題
Microsoft Internet Explorer 4 から Reports Services を介して PDF 形式のレポートを実行すると、レポート出力
がブラウザに表示されないことがあります（ウィンドウの左上端に小さなアイコンが表示されます）。
Microsoft IE 4 の不具合が原因で、PDF ファイルがリダイレクト時に空白ページとして表示されます。
これは、IE 5.01 で修正されています。
Netscape と HTMLCSS 出力の問題
Netscape ウィンドウのサイズを変更すると、ページが変形し、そのページの再ロードが必要となることが
あります。8 ポイントより小さいフォントは、太字の属性を失います。
「Web プレビュー」オプションを使用して、ブックマークを持つ Reports を表示する場合は、ブックマーク・
フレームがリフレッシュされません。レポートを表示するたびに、新しいブックマーク・フレームが表示
されます。ブラウザを終了してから再起動し、不適切なフレームを削除する必要があります。
Reports と Graphics の統合
Graphics 図表をレポートに統合する場合は、データベースへの接続時に、接続文字列を指定する必要があ
ります。
LOCAL 環境変数またはレジストリ・エントリが定義済である場合でも、接続文字列を指定する必要があり
ます。これを行わない場合、統合できません。
データ・モデルの制限
データ・モデルの制限
問題: 「ツール」→「作業環境」メニューより、作業環境ダイアログの「一般」タブで「オープン時にレ
ポート・エディタを表示しない」がオンであるかオフであるかに関わらず、モジュールのオープン
時に、最初にレポート・エディタがオープンしません。
対処: 「ツール」→「レポート・エディタ」メニューを使用します。
Reports と Oracle OLAP Server のバージョン
Reports は、Oracle OLAP Server R6.2 または R6.3 とともに動作することがサポートされています。
Reports と OLAP Server のための Oracle8 Server の要件
Reports と OLAP Server の接続には、Oracle8 R8.0.6 データベース・サーバーが必要です。Tru64 UNIX 版
Reports R6i のこのリリースから OLAP Server への接続のサポートに関する情報は、日本オラクルのカスタ
マーサポート、または日本オラクル Web サイト（http://www.oracle.co.jp/）または OTN Japan
（http://otn.oracle.co.jp/）より提供される予定です。
114
Oracle9i Application Server for Compaq Tru64 UNIX リリース・ノート
Report Builder と OLAP Server の統合
.ORA ファイルの構成
Report Builder が Oracle OLAP Server に対する外部コールを行うためには、TNSNAMES.ORA、SQLNET.ORA
および LISTENER.ORA ファイルに次のエントリが含まれている必要があります。
TNSNAMES.ORA
-----------extproc_connection_data.world =
(DESCRIPTION =
(ADDRESS =
(PROTOCOL = IPC)
(KEY = EXTPROC%ORACLE_HOME_ID%)
)
(CONNECT_DATA = (SID = extproc)
)
)
SQLNET.ORA
---------names.default_domain = world
name.default_zone = world
automatic_ipc = off
LISTENER.ORA
-----------PASSWORDS_LISTENER= (oracle)
STARTUP_WAIT_TIME_LISTENER = 0
LISTENER =
(ADDRESS_LIST =
(ADDRESS = (PROTOCOL = IPC)(KEY = oracle.world))
(ADDRESS = (PROTOCOL = IPC)(KEY = ORCL))
(ADDRESS = (COMMUNITY = NMP.world)(PROTOCOL = NMP)(SERVER =
YourServer)(PIPE = ORAPIPE))
(ADDRESS = (PROTOCOL = TCP)(Host = <my machine>)(Port = 1521))
(ADDRESS = (PROTOCOL = TCP)(Host = <my machine>)(Port = 1526))
(ADDRESS = (PROTOCOL = TCP)(Host = 127.0.0.1)(Port = 1521))
(ADDRESS = (PROTOCOL=IPC)(KEY=EXTPROC %ORACLE_HOME_ID%))
)
CONNECT_TIMEOUT_LISTENER = 10
SID_LIST_LISTENER =
(SID_LIST =
(SID_DESC =
(GLOBAL_DBNAME = <my machine>)
(SID_NAME = ORCL)
)
(SID_DESC =
(SID_NAME = extproc)
(PROGRAM = extproc)
)
)
TRACE_LEVEL_LISTENER = 0
注意: Oracle8/8i データベースが Reports Developer と同じマシンにインストールされており、Net8 を介し
てそのデータベースに接続していない場合でも、TNS リスナーが実行されている必要があります。
Express Oracle8 コンポーネントの Oracle8 8.0.6 ORACLE_HOME へのインストール
UNIX では、Express Oracle8 外部プロシージャ・コンポーネントが Reports とともに CD に入っています。
ただし、そのコンポーネントを Reports の ORACLE_HOME にインストールしないでください。代わりに、
そのコンポーネントを Oracle Server 8.0.6 の ORACLE_HOME にインストールします。
第６章 Oracle Reports Developer and Oracle9iAS Reports Services R6i (Patch13)
115
Express ディメンション・ソート − 6.0 レポートの要件
Reports Developer R6i の新しい Express ディメンション・ソート機能は、自動的にはリリース 6.0 レポート
に適用されません。
Report Builder によってリリース 6.0 のレポートをリリース 6i 形式でオープンし、
Express
の問合せをオープンして、そのレポート全体をリリース 6i 形式で保存する必要があります。
OLAP Server からのレポート作成時のエラーORA-28575
からのレポート作成時のエラー
このエラーは、デフォルトの TNSNAMES.ORA ファイル（Oracle8 のインストール時に作成されたもの）が
上書きされたときに発生します。このエラーに対処するには、上記の「.ORA ファイルの構成」の指示に従
って、TNSNAMES.ORA ファイルにエントリを追加します。
Reports と OLAP Server の統合の制限
問題: パスワードを必要とする Express データベースを連結できません。
対処: 現時点ではありません。
問題: Express の問合せを含むレポートが Web に配置されている場合に、「Express log-in」ボックスが表
示されません。このため、ユーザーが接続を指定することができず、ブラウザでレポートが実行さ
れません。
対処: 意図された動作です。これは RDBMS 接続と同じモデルであり、次のようにして解決できます。
1.
パラメータ・フォーム・エディタから利用できるパラメータ・フォーム・ウィザードを使用
して、EXPRESS_SERVER パラメータをパラメータ・フォームに手動で追加します。
2.
レポートの'cgicmd.dat'ファイルに EXPRESS_SERVER パラメータを指定します。
3.
EXPRESS_SERVER パラメータのコンポーネント部分のユーザー・パラメータを作成し、実
際の EXPRESS_SERVER パラメータを作成します。
問題: このリリースでは、パラメータを Express の問合せに渡すことができません。
対処: 現時点ではありません。
レイアウト・モデルの制限
問題: チャート・ハイパーリンクでは、最初から 10 個目以降のハイパーリンクの値が機能しないことがあ
ります。
対処: 現時点ではありません。
問題: ボイラープレート・テキストの値をシングルバイトからマルチバイトに変更すると、GPF（一般保
護違反）が発生します。
対処: ボイラープレート・テキストを変更する前に、フォントを'Arial'から'Gothic BBB'に変更します。
問題: マルチバイトの場合、ライブ・プレビューアにおいて「すべて選択」を発行すると、GPF（一般保
護違反）が発生します。
対処: オブジェクト・ナビゲータまたはレイアウト・エディタを使用してオブジェクトを「すべて選択」
します。
問題: ヘッダー・セクションまたはトレーラ・セクションでレポート・ウィザードを使用すると、メイン
のレイアウト・セクションが無効になります。
対処: 「追加デフォルト・レイアウト」ツールを使用してヘッダー・セクションまたはトレーラ・セクシ
ョンのレイアウトを作成するか、これらのセクションがデフォルトになっている場合はレポート・
ウィザードを使用してデータ・モデルを変更するのを避けます。
問題: プロパティ・パレットで「検索」機能を使用する場合、「名前」プロパティおよび「コメント」プ
ロパティを持たないレイアウト・オブジェクトがあるために Reports がハングします。
対処: このパレットで「検索」を使用するのを避け、オブジェクト・ナビゲータを使用してオブジェクト
の名前を変更します。
116
Oracle9i Application Server for Compaq Tru64 UNIX リリース・ノート
問題: Web 用のレポートを開発しているときに、出力イメージを確認するために何度も Report Builder か
ら Web ブラウザに切り替えると、Report Builder がハングすることがあります。
対処: 現時点ではありません。
Web ウィザード
問題: Web 用のレポートを開発しているときに Web ウィザードでテストを行うと、レポートがハングする
ことがあります。
対処: 現時点ではありません。
バージョンの混合
異なるリリースの実行可能ファイルを混合することはできません。
たとえば、リリース 6i の実行可能 CLI コマンド（rwcli60）を使用してリリース 1.6.1 の Report Server にア
クセスすることはできません。
V1-V2-V8 変換:PLSQL
V2 の予約語の置換え
変換
PL/SQL バージョン 1 をバージョン 2 以上に変換すると、新しい予約語が既存の表名または列名と重複する
という問題が生じることがあります。たとえば、VARIANCE は PL/SQL バージョン 2 以上の新しい予約語
です。これらの予約語の中には、大文字のキーワードを二重引用符で囲むことによって表名または列名を
参照するための識別子として使用できるものもあります。一般的には、リリース 6i のドキュメントの
V1-V2-V8 コンバータに関する記述の通り、新しい予約語のすべてのインスタンスを新しい一意な識別子に
置き換えることをお薦めします。
レポートの幅と高さのプロパティの場所
リリース 6 より前のバージョンでは、レポートの幅および高さがレポート・レベルのプロパティ・パレッ
トに設定されていました。Oracle Reports R6.0 および 6i では、ユーザーが、レポートのセクションごとに異
なったディメンションを持つことができます。したがって、幅および高さのプロパティは、レポート・レ
ベルのプロパティ・パレットからセクション・レベルのプロパティ・パレットに移動されました。
NULL チャート列の問題
問題: チャート・ウィザードを使用する場合にチャート列として使用されているフィールド内のデータが
NULL であると、Reports が正しく機能しないことがあります。
対処: NVL 関数を使用します。以下に例を示します。
SELECT ALL nvl(TRAVEL.NODENAME,'null') NODENAME,
TRAVEL.DESCRIPTION, TRAVEL."VALUE",
'Profiles of'||decode(TRAVEL.COST,'I','Inexpensive',
'E','Expensive',NULL||'
Travellers' cost_category
FROM TRAVEL
クラスタ化とクラスタ構成
クラスタ化により、複数の Reports Services 上でレポートを実行できます。クラスタ構成は、マスター・サ
ーバーに対するスレーブ・サーバーの構成です。マスター・サーバーは、使用可能なスレーブ・サーバー
を識別し、必要に応じてそのエンジンを起動できます。多くのサーバーをマスター・サーバーに対するス
レーブとして設定できます。
構文:
マスター・サーバー構成ファイルでは、次のようになります。
第６章 Oracle Reports Developer and Oracle9iAS Reports Services R6i (Patch13)
117
clusterconfig="(server=server_name minengine=0 maxengine=1
initengine=1
cachedir=/cache)"
注意: パラメータ値全体を二重引用符で囲む必要があります。スレーブ・サーバーの各定義は、カッコで
囲む必要があります。
クラスタ構成パラメータに関連する値の詳細は、『Oracle Reports Developer パブリッシング・レポート リ
リース 6i』を参照してください。
ドキュメントに記載されていないサーバー構成パラメータ
Failnotefile
Failnotefile は、実行に失敗したジョブの通知メッセージ・テンプレートのパスおよびファイル名です。
Succnotefile
Succnotefile は、正常に実行されたジョブの通知メッセージ・テンプレートのパスおよびファイル名で
す。
デバッグの中止
REPORTS60_CGINODIAG を yes（または他の任意の値）に設定すると、R60CGI からのデバッグ/診断出力
がすべて無効になります（たとえば、http://your_webserver/r60cgi/help?が機能しません）。
ランタイム・カスタマイズのための JRE の要件
Reports Developer のランタイム・カスタマイズには JRE が必要です。
ランタイム・カスタマイズ機能を有効にするには、次の環境変数が必要な jar ファイルを指すように設定す
る必要があります。
REPORTS60_CLASSPATH は、ランタイム・カスタマイズ機能に必要な jar ファイル、rt.jar、myreports60.jar
および xmlparser.jar を指す必要があります。
Windows の場合は、レジストリで REPORTS60_CLASSPATH を設定できます。
UNIX の場合は、シェル・スクリプトで、またはコマンド行から REPORTS60_CLASSPATH を設定できま
す。以下に例（C シェル構文）を示します。
setenv REPORTS60_CLASSPATH
$ORACLE_HOME/network/jre11/lib/rt.jar:
$ORACLE_HOME/reports60/java/myreports60.jar:
$ORACLE_HOME/reports60/java/xmlparser.jar
REPORTS60_JNI_LIB には、JVM ネイティブ・ライブラリ（Win32 上では javai.dll、UNIX 上では libjava.so）
の場所が含まれています。他の JRE ランタイム・ライブラリ（UNIX 上の libzip.so など）も同じディレク
トリ内に存在する必要があります。Windows の場合は、レジストリで REPORTS60_JNI_LIB を設定できま
す。UNIX の場合は、シェル・スクリプトで、またはコマンド行から REPORTS60_JNI_LIB を設定できます。
以下に例を示します。
setenv REPORTS60_JNI_LIB
$ORACLE_HOME/network/jre11/lib/alpha/native_threads/libjava.so
PLSQL エディタ:DE_PREFS_TABSIZE
によるタブ・サイズの設定
エディタ
PL/SQL エディタのタブ・サイズは、DE_PREFS_TABSIZE レジストリ・エントリを使用して設定できます。
DE_PREFS_TABSIZE の値を、PL/SQL エディタのタブ幅（文字数で表します）に設定します。デフォルト
では、タブ・サイズは 2 に設定されています。
R6i より前に作成された HTML パラメータ・フォームへの行追加の必要性
パラメータ・フォームの妥当性チェックを使用する、R6i より前のレポートでは（つまり、パラメータ・フ
ォームがエラーをレポートする場合）、問題が発生することがあります。
118
Oracle9i Application Server for Compaq Tru64 UNIX リリース・ノート
この問題を回避するには、手動で、次に示す HTML の行を BEFORE FORM VALUE パラメータ内、または
srw.set_before_form_html ビルトインを使用してこのプロパティの値を設定するコード内に追加します。
<font color=red><!--error--></font>
この行を次に示す既存の行の間に追加します。
<input name="hidden_run_parameters" type=hidden value="_hidden_">
<center>
したがって、拡張されたコードは次のようになります。
<input name="hidden_run_parameters" type=hidden value="_hidden_">
<font color=red><!--error--></font>
<center>
フィールド・タグでの幅属性の使用
ランタイム・カスタマイズには、「field」タグに、幅を表すオプションの属性が追加されました。
構文: [width='size_in_characters']
width は、フィールドの長さを文字数で表したものです。
この属性は、新しいフィールドのみに適用されます。既存のフィールドでは、この属性が無視され、その
フィールドの元の幅が使用されます。
ランタイム・カスタマイズの特別な文字
ランタイム・カスタマイズ用の XML では、ASCII 番号が 127 より大きな文字を HTML ASCII にエンコー
ドする必要があります。たとえば、英国のポンド記号（ASCII 文字 163）を XML で使用する場合は、その
記号を&#163 としてエンコードします。
さらに、そのポンド記号を書式マスク属性に入れる場合は、その記号を囲む二重引用符をエンコードする
必要があります。以下に例を示します。
formatMask="&#034;&#163;&#034;NNNGNNNGNNNGNN0D99"
プログラムで文字の ASCII 番号を検索するには、ASCII 関数（例、select ascii('"') from dual）を使用できま
す。
レポートを DESTYPE=MAIL に送る場合の失敗
問題: Report Builder または Reports CGI から desname=<有効な email アドレス>の destype=mail でレポート
を送信すると、メッセージ REP-4204 を受け取り、失敗します。
対処: Netscape Communicator をリリース 4.7 にアップグレードします。個人用アドレス帳にメール受信者
のアドレスを追加します。
Internet Explorer の認証ウィンドウの反復
問題: Microsoft Internet Explorer を使用して Reports CGI またはカートリッジを実行し、データベース・サ
ーバーまたは保護サーバーに対してユーザーを認証させる場合、何度も認証ウィンドウが表示され
ます。
対処: IE のオプション「保存しているページの新しいバージョンの確認」の「ページを表示するごとに確
認する」を選択します。このオプションは、「ツール」→「インターネットオプション」、「全般」
タブの「設定」にあります。
Tru64 UNIX 上の Reports Web CGI と Apache Web Server
Tru64 UNIX 上で Reports Web CGI を実行する場合、使用するシェル・スクリプトに ORACLE_HOME 環境
変数と LD_LIBRARY_PATH 環境変数の両方の値を設定する必要があります。これらの環境変数の詳細は
オンライン・ヘルプを参照してください。
第６章 Oracle Reports Developer and Oracle9iAS Reports Services R6i (Patch13)
119
UNIX 上の Reports サーブレットからのエラー500
サーブレットからのエラー
問題: UNIX 上で Reports サーブレットを起動すると、次のエラー・メッセージが表示されます。
エラー:500
サーブレット内部エラー: java.lang.UnsatisfiedLinkError:
rwexec
この問題は、サーブレットが、リンクする必要のあるライブラリを検出できないために発生しま
す。
対処: UNIX プロンプトから次の操作を行います。
cp $ORACLE_HOME/bin/rwsvl60.so
$ORACLE_HOME/lib/librwsvl60.so
この操作により、ライブラリが正しい場所にコピーされ、ライブラリの名前が変更されます。
（この問題は、将来のリリースで解決される予定です。）
Oracle9iAS Reports Services エラー
TNS_ADMIN 環境変数またはレジストリ・キーを別の値に設定した場合に、Oracle9iAS Reports Services は
エラー186 または REP-0186 で失敗する可能性があります。そのような場合は、Oracle9iAS Reports Services
を次のように始動してください。
prompt> setenv TNS_ADMIN <IAS_HOME>/6iserver/network/admin
prompt> <IAS_HOME>/6iserver/reports60_server start
この場合の、＜IAS_HOME>は、Oracle9i Application Server をインストールしたディレクトリに置換してく
ださい。これにより、Oracle9iAS Reports Services は、<IAS_HOME>/6iserver/network/admin にある tnsnames.ora
ファイルを使用するようになります。
チャート・ウィザード
このリリースでは、チャート・ウィザードの使用はサポートされません 。
Graphics Builder
Unix 上での必要な環境変数の設定
上での必要な環境変数の設定
Graphics 統合を Unix システム上で機能させるためには、次の環境変数を設定する必要があります。
setenv TK_PRINTER <printer_name>
setenv TK_PRINT_STATUS echo
Query Builder
既知の問題はありません。
Schema Builder
既知の問題はありません。
Translation Builder
既知の問題はありません。
120
Oracle9i Application Server for Compaq Tru64 UNIX リリース・ノート
Procedure Builder
既知の問題はありません。
Open Client Adapter
既知の問題はありません。
各国語サポート
すべての言語で確認されている問題
Report Builder のユーザー・インタフェースの不完全な翻訳
一部の言語では Report Builder のユーザー・インタフェースの翻訳が完全ではありません。（日本語では、
翻訳されたユーザー・インタフェースは提供されています）
それら翻訳が完全でない言語の場合は、英語のインタフェースを使用してください。
そのためには、次の設定をします。
DEVELOPER_NLS_LANG=AMERICAN_AMERICA.<charset>
USER_NLS_LANG=< Language>_<Territory>.<charset>
この設定は、Builder を実行しているワークステーションで行います。
< Language>にレポートを実行する言語を代入します。
< Territory>にレポートを実行する地域を代入します。
<charset>に使用する Oracle キャラクタ・セットを代入します。
左から右のみの PDF 形式レポート
問題: PDF 形式で生成されたレポートは、方向設定に関係なく、必ず左から右に表示されます。
対処: 可能な場合は、非 PDF 形式を選択します。
一部のウィザード・ボタンのテキストの未翻訳
Unix システム上のウィザードでは、ボタンのテキストが英語で表示される場合があります。
ダブルバイト言語で確認されている問題
シングルバイト・フォントでの編集
問題: Builder のダブルバイト言語実装では、シングルバイトのフォント（例、Arial）を使用して編集する
と、文字化けが起こります。これは、編集フィールドで発生します。
対処: シングルバイト・フォントを使用せずに、ローマン・スクリプトを表示するダブルバイト・フォン
トを使用します。
日本語で確認されている問題
JA16EUC キャラクタ・セットの場合のモジュールの保存不可
問題: キャラクタ・セットが JA16EUC の場合、Oracle データベースにモジュールを保存できません。
対処: 代わりに、JA16SJIS キャラクタ・セットを使用します。
第６章 Oracle Reports Developer and Oracle9iAS Reports Services R6i (Patch13)
121
Windows から UNIX への移行時の長さの制限
問題: 30 バイトを超える長さの
（半角カタカナを使用した）
名前を持つオブジェクトを Windows から UNIX
に移行できません。
対処: 現時点ではありません。
PL/SQL エディタの表示の問題
問題: 1 行に入力された文字が、複数行に一部重複して表示されます。
対処: 現時点ではありません。
PL/SQL ライブラリ名におけるマルチバイト・キャラクタ・セットの使用不可
問題: マルチバイト・キャラクタ・セットを使用して PL/SQL ライブラリ名を作成できません。
対処: 現時点ではありません。
XML ファイルからのレポートにおける非 ASCII フォント名の使用不可
問題: NLS_LANG が American_America.UTF8 に設定されている場合でも、埋込みフォント名は Shift-JIS エ
ンコードです。この構成では、html の他の文字（ボイラープレートなど）は、UTF8 エンコードで
す。つまり、出力に Shift-JIS エンコードと UTF-8 エンコードの両方が含まれます。したがって、こ
のファイルをブラウザから処理することはできません。
対処: ASCII バージョンのフォント名を使用します。たとえば、（Windows 環境などでは）MS P ゴシック
ではなく MS UIGothic を使用します。
別の prefs.ora ファイルが必要となる場合
問題: お客様が日本語版のインストールを選択した場合、JA16EUC エンコードの日本語用の prefs.ora がイ
ンストールされます。これにより、次のような他の NLS_LANG 設定でアプリケーションを開発す
るお客様にいくつかの問題が発生します。
American_America.JA16EUC (a)
または
Japanese_Japan.UTF8 (b)
対処:
a.
アメリカ英語用の prefs.ora ファイルが必要です。これらのファイルをインストール CD からコピ
ーする必要があります。
b.
UTF8 エンコードの prefs.ora ファイルが必要です。prefs.ora ファイルを JA16SJIS エンコードから
UTF8 エンコードに変換します。
PL/SQL インタプリタのメッセージ・テキストにおける言語の混在
Procedure Builder を実行する場合、PL/SQL インタプリタからのエラー・メッセージ（例、ORA-04098）が
英語で表示される場合があります。
Unix 上にキュー・カードをインストールするための記憶域の要件
Unix システム上にキュー・カードをインストールする場合、日本語 tar ファイルと US tar ファイルの両方
がインストールされます。これらの tar ファイルに必要な記憶域の合計は、約 275Mb です。
キュー・カードはオプションです。記憶領域が小さい場合は、キュー・カードをインストールしなくても
構いません。
122
Oracle9i Application Server for Compaq Tru64 UNIX リリース・ノート
異なるキャラクタ・セットで作成された OGD ファイルの実行
問題: 実行環境と異なるキャラクタ・セットで作成されたチャートを、Graphics または、Forms モジュー
ルから実行できません（例：Windows(SJIS)環境で作成した OGD ファイルを、UNIX の EUC 環境で
実行）。異なるキャラクタ・セットで作成した OGD ファイルを実行しようとすると下記のような
エラーが発生し、チャートが表示されない、間違った値でチャートが表示される、また Web 環境で
は、Reports Services の応答が返ってこない場合があります。
「OG-04001 チャート・テンプレートにフィールド・テンプレートがありません」
「OG-04002 問い合わせ列にデータが見つかりません」
対処: 実行環境と同じとキャラクタ・セット環境で作成した OGD ファイルを使用してください
Oracle9iAS Reports Services エラーメッセージの表示
Oracle9iAS Reports Services アプリケーション実行時に HTML 形式で表示されるエラーメッセージの日本語
文字列が正しく表示されません。
ファイルのオープン、保存時の不具合
問題: ファイルのオープン/保存ダイアログボックスの文字が正しく表示されない場合があります。
対処: ダイアログ下部に並んでいる 3 つのボタンのうち、左側のボタンを「OK」、中央のボタンを「更新」、
右側のボタンを「Cancel」としてご使用ください。
Net8 構成ツールの制限
問題: net8asst.sh および netwiz.sh によって起動される Net8 構成ツールで、日本語で表示されるメッセージ
やメニュー項目のうち半角カナが正しく表示されません。
対処: Net8 設定ファイルを手動で編集しデータベース接続情報の設定を行ってください。
アラビア語で確認されている問題
UNIX 上でチャートを表示するための制限
UNIX バージョンの Oracle Reports Developer R6i を使用してチャートを作成するお客様は、UNIX オペレー
ティング・システムでは、Windows NT に比べてフォントとロケールのサポートが少ないことに注意する必
要があります。特に、UNIX には正式なアラビア語ロケールがありません。Oracle Reports Developer R6i for
Compaq Tru64 UNIX では、Unicode ロケールに対するサポートが非常に限られています。
したがって、アラビア語または Unicode を使用する場合、UNIX 上で作成されたチャートにはテキストが正
しく表示されません。これは、UNIX ベースのサーバーにアクセスする Web クライアント上に表示される
チャートでも起こります。これは、チャートがサーバー上でビットマップ・グラフィックにされるために
起こります。サーバーが UNIX ベースである場合、アラビア語および Unicode のフォントは使用できませ
ん。フォーム、レポート、グラフィックの他のテキストは、通常、直接クライアントに送られ、クライア
ントのロケールで処理されます。
対処方法として、Unicode ではなく西ヨーロッパのチャート・テキスト・フォントを選択することをお薦め
します。
第６章 Oracle Reports Developer and Oracle9iAS Reports Services R6i (Patch13)
123
その他の問題点
ドキュメントに関する既知の問題点
&Auml タグ
ブラウザによっては特定の文字が正常に表示されないことがあります。HTML のドキュメントで&Auml タ
グを Netscape で正常に表示できません。
デモ・テーブルを作成するスクリプト
マニュアル『J00918-01 Oracle Reports Developer レポート作成ガイド リリース 6i』の 1 章 「1.3 起動前の
データベース・アクセス権の取得」に下記の記述があります。
このマニュアルで説明するレポートを作成するためには、Oracle Reports Developer デモ・テーブルに
アクセス可能であることが必要です。デモ用の SQL スクリプトをインストールしてください。このス
クリプトは、データベースにデモ・テーブルをインストールするために使用します。
デモ・テーブルを作成するスクリプトは、Oracle Technology Network Japan
http://otn.oracle.co.jp/
からダウンロード可能です。
レポート Web 公開ガイド
CD から$ORACLE_HOME/doc60/admin/manuals/JA/od_pubrep60 ディレクトリにインストールされるド
キュメントは古い内容です。Oracle9i Application Server のドキュメント CD に含まれる「J02835-01
Oracle9i Application Server Oracle9iAS Reports Services レポート Web 公開ガイド リリース 1.0.2」を参
照してください。
Oracle9iAS Reports Services サーバーでの X Window セッションの要件
ビットマップ・レポートを実行するには、Oracle9iAS Reports Services サーバーによって起動されたエンジ
ンに適切なウィンドウ・システムへのアクセス権限が必要です。これは Windows プラットフォームでは問
題ありませんが、Windows 以外のプラットフォームでは、有効な X Window セッションを使用できなけれ
ばならないことを意味します。これに該当するかどうかを確かめるには、Oracle9iAS Reports Services サー
バーが、有効な DISPLAY 環境変数のあるセッションから起動されていることを確認してください。該当し
ない場合は、REP-3000 および REP-1800 エラーになります。
Oracle Developer for Compaq Tru64 UNIX R6i Patch13 の適用
パッチの内容やインストール方法に関しては、第 5 章の「Oracle Developer for Compaq Tru64 UNIX R6i
Patch13 の適用」を参照してください。
確認されている問題点
Oracle9i Database の NCHAR データ型
Oracle9i データベースを接続先データベースとして使用した場合、NCHAR(NVARCHAR2)列からデータを
取得する項目で、データが正しく表示されません。これは Oracle9i から NCHAR(NVARCHAR2)型の格納文
字コードが Unicode に変更されたことに伴い、Net8 クライアントから Oracle9i の NCHAR データ型を取得
する際に発生する現象と同一です。
124
Oracle9i Application Server for Compaq Tru64 UNIX リリース・ノート
reports60.csh(reports60.sh)の修正
の修正
問題: Reports の環境変数を設定する reports60.csh(B シェルにおいては reports60.sh)スクリプトにおいてテン
プレートの格納されているディレクトリの指定が間違っています。
対処: スクリプトの REPORTS60_PATH の指定部分で$ORACLE_HOME/reports60/admin/templates を追加し
て指定します。
例)
reports60.csh の場合
setenv REPORTS60_PATH
$ORACLE_HOME/reports60/admin/templates:$ORACLE_HOME/tools/devdem60/demo/report
s
reports60.sh の場合
REPORTS60_PATH=$ORACLE_HOME/reports60/admin/templates:$ORACLE_HOME/tools/devde
m60/demo/reports
export REPORTS60_PATH
キュー・カードの不正な表示
問題: JA16EUC 環境下ではキュー・カードの文字列が正常に表示されません。
対処: キャラクター・セットを JA16SJIS に設定してキュー・カードを起動します。
Oracle Reports Developer R6i Patch2 新機能
Oracle9i Application Server リリース 1.0.2 の Oracle9iAS Reports Services では、次の点が変更および強化され
ました。
Oracle Reports セキュリティ
Oracle9iAS Portal
このリリースでは、Oracle9iAS Reports Services 6i セキュリティとともに機能する Oracle9iAS Portal リリー
ス 3.0 が導入されています。ただし、日本においては Oracle9i Application Server のこのリリースでは
Oracle9iAS Reports Services 6i セキュリティ機能はベータ機能として提供されており、サポートされません。
拡張集約操作および分析関数
Oracle9iAS Reports Services では、拡張集約操作および分析関数がサポートされるようになりました。
集約操作は、単一行ではなく、行グループを基にして単一結果行を返します。集約関数は選択リスト、
ORDER BY 句および HAVING 句で使用できます。通常は、SELECT 文中で GROUP BY 句とともに使用し
ます。この場合、問合せ表またはビューの行は Oracle8i によってグループに分割されています。たとえば、
次のようになります。
SELECT dname, sum(sal)
FROM dept, emp
WHERE dept.deptno =emp.deptno
GROUP BY dname
データベースは各行グループに集約関数を適用し、各グループに単一結果行を返します。したがって、この例で
は個々の部門別の給与合計が示されます。
拡張集約操作は Oracle8i リリース 8.1.5 で導入され、正規のグループの他に（追加行として）超集合グルー
プを生成する CUBE および ROLLUP 拡張が追加されて機能を強化しました。ROLLUP は、最小単位の合計
から総計まで、集約のレベルを増やしながら小計を算出します。CUBE は ROLLUP に似た拡張で、考えら
れる限りの組合せの小計を 1 つの文で計算できます。CUBE では、cross-tabulation レポートに必要な情報を
1 回の問合せで生成できます。ユーザーは、選択リストの GROUPING 関数を使用して、問合せにより返さ
第６章 Oracle Reports Developer and Oracle9iAS Reports Services R6i (Patch13)
125
れた実際のデータ行と CUBE および ROLLUP 拡張により追加された行を区別できます。GROUPING 関数
は、実際の行であれば 0 を、そうでなければ 1 を返します。
Oracle8i R8.1.6 では、ビジネス･インテリジェンス・アプリケーションおよびデータ・ウェアハウス・アプ
リケーション用に SQL 関数の強力なファミリが新しく導入されました。
これらの関数は分析関数と呼ばれ、
数多くのビジネス分析問合せのパフォーマンスを大幅に改善し、コーディングを容易にします。これらの
新しい SQL 関数は、SQL 規格に新たに追加するために ANSI でも検討されています。オラクル社では、分
析関数の 4 つのファミリを作成しました。それぞれにいくつかの関数が含まれています。
ランキング・ファミリ
ウィンドウ集約ファミリ
レポート集約ファミリ
LAG および LEAD ファミリ
ランキング・ファミリ
このファミリは、「各地域の販売員の上位 10 人と下位 10 人を表示する」、「各地域で売上の 25%を計上
した販売員を表示する」などのビジネス上の問合せをサポートします。この関数は、結果を生成する前に
出力全体を調べます。オラクル社では、RANK、DENSE_RANK、PERCENT_RANK、CUME_DIST および
NTILE 関数を提供しています。
ウィンドウ集約ファミリ
このファミリは、「13 週間の株価の平均推移を表示する」、「地域ごとの売上の累積を表示する」などの
問合せを発行します。この新しい機能では、AVG、SUM、MIN、MAX、COUNT、VARIANCE および STDDEV
を含むすべての SQL 集約関数について、推移および累積処理を提供します。
レポート集約ファミリ
最も一般的な計算方法の 1 つに、非集約値と集約値の比較があります。全体の中の割合および市場占有率
の計算すべてに、この処理が必要です。レポート集約ファミリはこの種の計算を簡略化します。同じ行に
対して違う集約レベルで計算された値を求めることができます。また、結合操作を行うことなく、集約値
を詳細な行まで比較できます。この新しいファミリでは、AVG、SUM、MAX、COUNT、VARIANCE およ
び STDDEV を含むすべての SQL 関数について、レポート集約処理を提供します。
LAG および LEAD ファミリ
変化と変動の調査は分析の中心です。これには必然的に表中の異なる行を比較することが含まれます。こ
れは SQL でも可能ですが（通常は内部結合で行います）、効果的ではなく、式を作成するのが容易ではあ
りませんでした。LAG および LEAD ファミリを使用すると、現在の行からのオフセットを指定するだけで
表中の異なる行を比較する問合せが作成できます。
これらの関数と操作に関するアプリケーションの例を次に示します。所属する組織の人事部長から、会社
の従業員に関する次の情報を要求されたとします。
「報酬方針と職務が平等で、かつ会社の方向性に沿っているかを確かめたい。これを判断するには、
人事データベースから次のことを調べる必要がある。」
1.
従業員数の内訳および社内の各職務の平均給与。最初に会社全体について、次に部門別に調べた
い。
2.
各従業員について部門ごとに、報酬の合計がいくらか、この報酬が会社全体およびその部門でど
れくらいのランクにあるか（およびその割合）、会社の平均報酬がこれをどれくらい上回ってい
るまたは下回っているかを調べたい。
「同じレポート上で、従業員の雇用日、会社での先任順位（つまり、雇用された順番）、その次に雇
用された人、その後の勤続年数を調べたい。」
Oracle8i の新しい分析関数を使用すれば、人事部長が要求するすべての情報をたった 2 つの SQL 文で調べ
られます。PL/SQL でデータを処理する必要はありません。最初の要求は、次のように表せます。
126
Oracle9i Application Server for Compaq Tru64 UNIX リリース・ノート
SELECT GROUPING(dname) dept_grouping_code,
DECODE(GROUPING(dname), 1, 'All Departments',initcap(dname)) AS dname,
GROUPING(job) job_grouping_code,
DECODE(GROUPING(job), 1, 'll Jobs', job) AS job, COUNT(*) "Total Empl",
AVG(sal+nvl)(comm,0)) "Average Comp"
FROM emp, dept
WHERE dept.deptno = emp.deptno
GROUP BY CUBE (dname, job)
2 番目の要求は、SQL では次のように表せます。
SELECT emp.deptno,
dept.dname,
avg(sal+nvl(comm,9)) over (partition by dept.deptno) avg_dept_sal,
ename,
job,
sal,
nvl(comm,0),
(sal+nvl(comm,0)) Compensation,
hiredate
RANK () OVER (PARTITION BY emp.deptno ORDER BY (sal+nvl(comm,0)) DESC) as rk,
RANK () OVER (ORDER BY (sal+nvl(comm,0)) DESC) "Rank in Company",
RANK () OVER (ORDER BY hiredate) "rank in employ",
((LEAD(hiredate, 1) OVER (ORDER BY hiredate))-hiredate) "Days over emp",
(LEAD(ename,1) OVER (ORDER BY hiredate)) next_emp
FROM emp, dept
WHERE dept.deptno = emp.deptno
ORDER BY rk
普通は人事部長には会議用資料相当の出力を提出するため、SQL*Plus のかわりに Oracle9iAS Reports
Services を使用してこのレポートを作成します。
ここで問題となるのは、この特別な構文を使用した問合せを、どのようにして企業レポートに取り入れる
かです。答えは簡単です。他の標準的な SQL 文を使用する場合と同様に行います。
Oracle9iAS Reports Services では SQL を直接データベースに渡すため、開発者はこれらの関数と拡張集約操
作をすべてのバージョンの Oracle9iAS Reports Services の（スタンドアロンまたはリンクされていない）個
別問合せで利用できます。また、Oracle9iAS Reports Services 6i Patch2 はこうした SQL 構文の拡張を認識で
きるように強化されているため、これらの関数を使用した問合せは、データ・モデルで変更された他の問
合せまたはフィールドのブレーク順序にリンクできます。Oracle9iAS Reports Services では、見えないとこ
ろでこれらの機能によって実際に SQL 文が書き直されるため、Oracle9iAS Reports Services 6i Patch2 が必要
となります。
レポートは、ウィザードを使用して、またはグループ上レポートに定義されたブレーク・グループを使用
して手動で問合せを作成することによって作成できます。
人事部長は 2 つのサマリーを要求しているので、
問合せをリンクする必要はありません。Oracle9iAS Reports Services のマルチ・セクションおよびバースト
機能を使用して、最初のセクションに最初の問合せ結果を、別のセクションに次の問合せ結果を表示でき
ます。もちろん、一度レポートを実行すれば、それぞれのセクションを様々なフォーマット（PostScript、
HTML、RTF 等）で様々な宛先（プリンタ、電子メール等）へ実行できます。
もう一度レポート・ウィザードを実行し、2 つ目の分析用のレイアウトを作成します。チャート・ウィザー
ドを起動して、いくつかのデータを視覚的に表示することもできます。
このように、新しい拡張集約操作と分析関数は非常に強力で、これを使用すると Oracle9iAS Reports Services
でのデータ分析を簡単に強化できます。
第６章 Oracle Reports Developer and Oracle9iAS Reports Services R6i (Patch13)
127
第７章 Oracle9i Application Server への EJB の配置
原典情報: Oracle8i JVM Deploying Enterprise JavaBeans to Oracle9i Application Server (A88705-01)
はじめに
この章の目的
このリリースでは、
Enterprise Java Beans
（EJB）
1.1 が完全にサポートされています。
Oracle9i Application Server
中間層と 8.1.7 データベースの両方で、EJB が適切に機能できるようにするために、Oracle 固有の EJB 用デ
ィプロイメント・ディスクリプタに変更があります。
この章では、次のトピックを取り扱います。
トランザクションのための Oracle 固有要素の定義
コンテナ管理の永続性の定義
Oracle 固有の DTD の変更
トランザクションのための Oracle 固有要素の定義
グローバル・トランザクションのために、追加で指定できる 3 つの要素があります。
ローカル・リソースをトランザクションに自動的に参加させるかどうかを定義する
2 フェーズ・コミット・エンジンを定義する
グローバル・トランザクションでブランチを使用可能にするかどうかを定義する
次に、上記の要素に必要な要素を示します。これらは、Oracle 固有のディプロイメント・ディスクリプタ
の<transaction-manager>要素の中に含めます。
<mappings>
...
<transaction-manager>
<jndi-name>/test/TransactionManager</jndi-name>
<default-enlist>TRUE</default-enlist>
<create-branches>FALSE</create-branches>
</transaction-manager>
</mappings>
トランザクションへのローカル・リソース参加の定義
ローカル・リソースは、データベースまたは Oracle9i Application Server 中間層のキャッシュになります。
EJB が Oracle 8.1.7 データベースで稼動している場合で、ローカル・リソースをグローバル・トランザクシ
ョンに参加させるときは、<default-enlist>を TRUE に指定する必要があります。
<mappings>
...
<transaction-manager>
...
<default-enlist>TRUE</default-enlist>
</transaction-manager>
128
Oracle9i Application Server for Compaq Tru64 UNIX リリース・ノート
</mappings>
EJB が、Oracle9i Application Server 中間層で稼動している場合は、Oracle9i Application Server Database Cache
が読取り専用なので、Oracle9i Application Server キャッシュをトランザクション・マネージャには参加させ
ません。この要素のデフォルトは FALSE なので、ディプロイメント・ディスクリプタに
<default-enlist>タグを付ける必要はありません。
<mappings>
...
<transaction-manager>
...
</transaction-manager>
</mappings>
2 フェーズ・コミット・エンジンの定義
グローバル・トランザクションに 2 フェーズ・コミットを使用している場合、Oracle 固有のディプロイメ
ント・ディスクリプタ内の<transaction-manager>要素に UserTransaction オブジェクトの JNDI
名を提供する必要があります。次の例では、UserTransaction オブジェクト/test/myUTFor2pc を指定して
います。
<mappings>
...
<transaction-manager>
<jndi-name>/test/myUTFor2pc</jndi-name>
...
</transaction-manager>
</mappings>
トランザクション内のブランチの使用可能化
X/Open XA プロトコルによると、単一のデータベースに複数の更新を行なう場合、トランザクション・マ
ネージャは、それぞれの update-known を unit-of-work-through ブランチとして管理します。
<create-branches>要素で、複数の単位の作業が単一のデータベース上で実行できるかどうかを定義し
ます。すなわち、単一のデータベースに複数の別々の更新を適用する場合、この要素を、TRUE に設定す
る必要があります。これが FALSE の場合は、グローバル・トランザクション内で、データベースあたり 1
単位の作業しか行なえません。
次のように、<create-branches>要素を TRUE に指定することで、グローバル・トランザクション内で
複数のブランチを可能にすることができます。
<mappings>
...
<transaction-manager>
...
<create-branches>TRUE</create-branches>
</transaction-manager>
</mappings>
ブランチを使用可能にすることは、グローバル・トランザクションが次のものを使用する場合にのみサポ
ートされています。
複数のデータベース
単一データベースにアクセスする複数のセッション
単一トランザクション内で同一データベースへのセッションのブランチはサポートされていません。
第７章 Oracle9i Application Server への EJB の配置
129
複数セッションから単一データベースにアクセスするときは、ブランチが使用されます。ただし、これは、
2 フェーズ・コミットになります。
コンテナ管理の永続性の定義
コンテナ管理の永続性 Entity Bean を使用すると決めた場合、永続性の属性がアクセスされる
<persistence-datasource>を任意に提供することができます。ディプロイメント・ディスクリプタに
<persistence-datasource>が定義されていない場合、EJB コンテナは kprb ドライバを使用して、永続
性属性のためにローカル・データベースにアクセスします。
次の例では、永続性フィールドを格納するためにリモート・データベースを使用する永続性プロバイダを
定義します。この例では、/test/empDatabase JTA DataSource がリモート永続性ストレージとして
定義されています。この DataSource は、-type jta オプションでバインドされています。
<persistence-provider>
<description>specifies a type of persistence manager</description>
<persistence-name>
psi-ri
</persistence-name>
<persistence-deployer>
oracle.aurora.ejb.persistence.ocmp.OcmpEntityDeployer
</persistence-deployer>
<persistence-datasource>
/test/empDatabase
</persistence-datasource>
</persistence-provider>
Oracle 固有の DTD の変更
完全な Oracle 固有 DTD を下にリストします。ここに、前述のオプション・タグが含まれていることに注意
してください。
<!-- This is the XML DTD for the Oracle Specific EJB deployment descriptor -->
<!ELEMENT oracle-descriptor (mappings*, run-as*, persistence-provider*,
persistence-descriptor*)>
<!ELEMENT run-as (description?, mode, security-role*, method)>
<!ELEMENT method (description?, ejb-name, method-intf?, method-name, method-params?)>
<!ELEMENT method-params (method-param*)>
<!ELEMENT method-intf (#PCDATA)>
<!ELEMENT method-name (#PCDATA)>
<!ELEMENT method-param (#PCDATA)>
<!ELEMENT mappings (ejb-mapping*, security-role-mapping*, resource-ref-mapping*,
transaction-manager*)>
<!ELEMENT transaction-manager (description?, jndi-name?, default-enlist?,
create-branches?)>
<!ELEMENT ejb-mapping (ejb-name, jndi-name)>
<!ELEMENT security-role-mapping (security-role, oracle-role)>
<!ELEMENT resource-ref-mapping (res-ref-name, jndi-name)>
<!ELEMENT ejb-name (#PCDATA)>
<!ELEMENT jndi-name (#PCDATA)>
<!ELEMENT default-enlist (#PCDATA)>
<!ELEMENT create-branches (#PCDATA)>
130
Oracle9i Application Server for Compaq Tru64 UNIX リリース・ノート
<!ELEMENT security-role (description?, role-name)>
<!ELEMENT role-name (#PCDATA)>
<!ELEMENT oracle-role (#PCDATA)>
<!ELEMENT ejb-ref-name (#PCDATA)>
<!ELEMENT res-ref-name (#PCDATA)>
<!-mode = SYSTEM_IDENTITY, SPECIFIED_IDENTITY, CLIENT_IDENTITY
if mode is SPECIFIED_IDENTITY, security-role must be specified
if mode is SYSTEM_IDENTITY or CLIENT_IDENTITY and security-role is
security-role is ignored
specified,
-->
<!ELEMENT mode (#PCDATA)>
<!--- persistence-provider describes the container managed persistence -->
<!ELEMENT persistence-provider (description?, persistence-name, persistence-deployer,
persistence-datasource?)>
<!ELEMENT description (#PCDATA)>
<!ELEMENT persistence-name (#PCDATA)>
<!ELEMENT persistence-deployer (#PCDATA)>
<!ELEMENT persistence-datasource (#PCDATA)>
<!ELEMENT persistence-descriptor (description?, ejb-name, persistence-name,
persistence-param*, psi-ri*)>
<!ELEMENT persistence-param (#PCDATA)>
<!ELEMENT psi-ri (schema, table, attr-mapping+, serialize-mapping?)>
<!ELEMENT schema (#PCDATA)>
<!ELEMENT table (#PCDATA)>
<!ELEMENT attr-mapping (field-name, column-name)>
<!ELEMENT serialize-mapping (field-name+, column-name)>
<!ELEMENT field-name (#PCDATA)>
<!ELEMENT column-name (#PCDATA)>
Oracle9i Application Server 環境でのグローバル・トランザクション
通常のグローバル・トランザクションでは、グローバル・トランザクションに組み込むそれぞれのデータ
ベースと接続をします。トランザクションが完了すると、トランザクション・マネージャは、すべての変
更をそのトランザクションに関連したすべてのデータベースに対してコミットします。
ただし、Oracle9i Application Server では、Oracle9iAS Database Cache がトランザクション・マネージャによ
って、誤ってグローバル・トランザクションのデータベースの 1 つとして取り扱われる可能性があります。
中間層でアクティブになっている EJB は、Oracle9iAS Database Cache とバックエンドの Oracle データベー
スの両方への接続を検索します。しかし、EJB は、バックエンド・データベースしか更新できません。ト
ランザクション・マネージャが Cache をそのトランザクションに関与する別のデータベースとして取り扱
わないようにする必要があります。そうしないとトランザクション・マネージャは、トランザクションが
終了したときに 2 フェーズ・コミットを実行します。2 フェーズ・コミット・プロセスは、コストも高く、
必須ではありません。バックエンド・データベースのみをグローバル・トランザクションに参加させるよ
うにしてください。すなわち、トランザクション・マネージャに、コストが高くない単一フェーズ・コミ
ットを実行させるようにします。
Cache がグローバル・トランザクションの参加データベースとして取り扱われることがないようにするには、
次のようにしてください。
1.
Oracle 固有ディプロイメント・ディスクリプタの<default-enlist>要素が、設定されていない、す
なわち、デフォルトで FALSE になっているか、または、FALSE に設定されるようにします。
第７章 Oracle9i Application Server への EJB の配置
131
2.
132
データベース Cache 用の DataSource を非 JTA タイプでバインドします。JTADataSource オブジ
ェクトのみを、自動的にグローバル・トランザクションに参加させることができます。
Oracle9i Application Server for Compaq Tru64 UNIX リリース・ノート
第８章 Oracle9iAS Database Cache
原典情報: Oracle Database Cache Readme, Release 1.0.2.1 for Sun SPARC Solaris (A88707-01)
はじめに
この章の目的
Oracle9iAS Database Cache は、複数層の環境で Oracle データベースにアクセスするアプリケーションのス
ケーラビリティとパフォーマンスを改善します。Oracle9iAS Database Cache では、頻繁にアクセスされるデ
ータを中間層にキャッシュすることにより、オリジナル・データベースへのネットワーク・ラウンドトリ
ップが減少し、バックエンド・データベースでより多くのユーザーをサポートすることが可能になります。
注意:
注意: 以前のリリースでは、
この製品は Oracle8i Cache あるいは Oracle Database Cache と呼ばれていました。
クイック・ツアー、ソフトウェアによって生成されるメッセージの一部、また Configuration Assistant
の画面の一部では、以前の名前が使用されています。
Oracle9iAS Database Cache は、中間層用の Oracle9iAS Database Cache サーバーと、クライアント層用の管理
インタフェースである Cache Manager（Oracle Enterprise Manager の一部）の 2 つのコンポーネントで構成さ
れています。
Oracle9iAS Database Cache は、複数層アーキテクチャの中間層に位置する、アプリケーションが実行される
ノードにインストールします。この複数層アーキテクチャの構造は次のとおりです。
オリジナル・データベースは、データの元の主要な記憶域で、データベース・サーバー層に存在しま
す。
Oracle9iAS Database Cache は、アプリケーション・サーバー層または Web サーバー層である中間層に
存在します。
エンド・ユーザーは、クライアント層から、通常は Web ブラウザを使用してアプリケーションにアク
セスします。
この章には、Oracle9iAS Database Cache のドキュメントに対する補足情報、または変更情報が含まれていま
す。このドキュメントには、次の情報が含まれています。
「Oracle9iAS Database Cache の既知の問題点および制限事項」では、Oracle9iAS Database Cache に関す
る既知の問題点と制限事項について説明します。
「Cache Manager の既知の問題点および制限事項」では、Cache Manager に関する既知の問題点と制限
事項について説明します。また、Oracle9iAS Database Cache に関する問題点および制限事項のうち、
Cache Manager を使用した場合のみ発生することが判明している点についても説明します。
Oracle9iAS Database Cache の既知の問題点および制限事項
Oracle9iAS Database Cache の PL/SQL API を使用するためにキャッシュに接続する場合、
SID ではなく、
サービス名を使用して構成された Net8 ネット・サービス名を使用して接続する必要があります。キャ
ッシュのサービス名の形式は、hostname-cache です。
次に、tnsnames.ora のエントリを示します。これをコピーして、リモート・ノードから接続することが
可能です。
# To access the cache from a remote client node, use this as a
# template for the client side tnsnames.ora entry. Fill in the
# appropriate host and port for this cache node.
#
# icache_db =
第８章 Oracle9iAS Database Cache
133
#
(DESCRIPTION =
#
(ADDRESS_LIST =
#
(ADDRESS = (PROTOCOL = TCP)
#
(HOST = <Cache Host Node>)
#
(PORT = <Cache Port Number, 1521>)
#
)
#
)
#
(CONNECT_DATA = (SERVICE_NAME = <Cache Host Node>-icache)
#
#
)
)
オリジナル・データベースの db_name が SID と異なる場合、インストールの開始前に、db_name に一
致するように SID を変更する必要があります。名前を確認するには、SQL*Plus で次の SQL 文を使用
します。
select value from V$parameter where name = 'db_name';
select instance_name from v$instance;
名前が一致していない場合、次のステップを実行します。
1.
オリジナル・データベースを停止します。
2.
ORACLE_SID 環境変数に、db_name と同じ値を設定します。
3.
init.ora ファイルの名前を変更して、新しい SID を使用するようにします。
init<new_sid>.ora
4.
必要な場合、新しい SID を使用するよう、listener.ora ファイルおよび tnsnames.ora ファイルを
編集します。
5.
データベースおよびリスナーを起動します。
コマンドラインから-create オプションを使用して Configuration Assistant を実行する必要がある場
合、まず、Oracle9iAS Database Cache の関連プロセスをすべて停止する必要があります。プロセスを
停止するには、oracle ユーザーでログインし、次のコマンドを使用して cachshut スクリプトを実行
します。
cd $ORACLE_HOME/bin
cachshut
次に、同じディレクトリから、次のコマンドを使用して Configuration Assistant を起動します。
wtacca -create -custom
Oracle9iAS Database Cache を 1 つのノードにインストールしている最中に、Cache Manager を使用して
同じオリジナル・データベースの他のキャッシュを管理しないでください。さらに、複数のノードか
ら同じオリジナル・データベースを使用する場合、Oracle9iAS Database Cache のインストール作業を
同時に実行しないでください。そうした場合、インストールが失敗する可能性があります。
1 つのノードには 1 つのキャッシュのみインストール可能です。
今回のリリースでは、中間層キャッシュは、1 つのオリジナル・データベースからのみデータを格納
できます。
今回のリリースでは、表全体をキャッシュする必要があります。
将来のリリースでは、表の一部や、オリジナル・データベースの複数の表のデータが含まれているデ
ータ・セットをキャッシュできるようになる予定です。
ご使用のアプリケーションで、Oracle Call Interface（OCI）
、
あるいは JDBC-OCI 、
ODBC または OLE/DB
などの OCI 上に構築されたアクセス・レイヤーを使用している必要があります。OCI は、リリース
8.1.6.1 以上である必要があります。
134
Oracle9i Application Server for Compaq Tru64 UNIX リリース・ノート
今回のリリースでは、
リクエストが Java ストアド・プロシージャである場合、
Oracle9iAS Database Cache
によりリクエストがオリジナル・データベースにルーティングされます。
今回のリリースでは、LONG、BFILE、LOB またはユーザー定義のデータ型が含まれていない表のみ
キャッシュ可能です。
完全同期化を実行した場合、スケジュールが設定されているかどうかに関係なく、同期化が完了する
まで、表にアクセスするユーザーにデータが表示されない可能性があります。この問題を最小限に抑
えるためには、負荷のピーク時を避けて完全同期化を実行してください。
Oracle9iAS Database Cache では、キャッシュの動作のモニターおよび統計の維持にスレッドを使用し
ます。そのため、OCI クライアント・アプリケーションは、マルチスレッド・モードでリンクされて
いる必要があります。Oracle クライアント・ライブラリに動的にリンクされているアプリケーション
の場合、自動的にマルチスレッド・モードでリンクされます。ただし、Oracle クライアント・ライブ
ラリに静的にリンクされているアプリケーションも、マルチスレッド・モードでリンクする必要があ
ります。
たとえば、Sun Solaris の場合、リンク行に-lthread オプションを使用します。
アプリケーションがマルチスレッド・モードでリンクされていない場合、Oracle9iAS Database Cache
が正しく実行されず、次のようなエラーが返される可能性があります。
Failed: Register Aggregate Stats Queue
Sun Solaris の場合、Oracle9iAS Database Cache で JDBC アプリケーションを使用するには、ネイティブ・
スレッドを使用して JDBC アプリケーションを実行する必要があります。
デフォルトは、実行している Java 開発環境により、ネイティブ・スレッドまたはグリーン・スレッド
のいずれかです。このキットに付属の Java 環境を使用している場合、デフォルトはネイティブ・スレ
ッドです。
それ以外の Java 環境を使用している場合、クライアントの起動時に-native オプションを使用し、
ネイティブ・スレッドが使用されていることを確認します。
java -native MyClient
OCI または OCI 上に構築されたアクセス・レイヤー（JDBC-OCI、ODBC、OLE/DB または Pro*C など）
を使用するアプリケーションで ALTER SESSION コマンドを実行すると、Oracle9iAS Database Cache
を使用するよう設定された環境でアプリケーションが実行されている場合でも、ALTER SESSION コ
マンドはオリジナル・データベースにのみ反映され、Oracle9iAS Database Cache サーバーには反映さ
れません。
たとえば、次のコマンドを実行し、このセッションの元の通貨設定が"$"である場合、このコマンドは
オリジナル・データベース・サーバーにのみ反映されます。
ALTER SESSION SET NLS_CURRENCY = 'Rs'
コマンドは、Oracle9iAS Database Cache サーバーには反映されません。このため、キャッシュされた
表に対する問合せは、ALTER SESSION コマンドによる影響を受けません。
システム所有の表はキャッシュできないため、システム所有の表に対する問合せはオリジナル・デー
タベースにルーティングされます。
ROWID を使用する問合せは、キャッシュにルーティングされます。ただし、ROWID は特定のデータ
ベース専用であるため、オリジナル・データベースの行を更新する際に、キャッシュから取得した
ROWID を使用しないでください。
使用した場合、
ROWID が見つからないためにエラーが返されるか、
または正しくない行が更新されてしまいます。
読込み専用リクエストのみが含まれた PL/SQL オブジェクトをキャッシュしてください。
読込み専用と、読込み/書込み文の両方が含まれている PL/SQL オブジェクトをキャッシュすると、こ
れらのオブジェクトに対するコールにより、非一貫性またはエラーが発生する可能性があります。
Oracle9iAS Database Cache では、キャッシュとオリジナル・データベース間の通信を容易にするため
に、オリジナル・データベースに次のユーザーが作成されます。
−
インストール中に、ORACACHE ユーザーが作成されます。
第８章 Oracle9iAS Database Cache
135
−
表をキャッシュに追加すると、Oracle9iAS Database Cache により、キャッシュされた表が含まれ
る各スキーマにユーザーが追加されます。ユーザー名は、次の形式で作成されます。
ORACACHE$n
n は 1 から 1000 までの整数を示します。
これらのユーザーをオリジナル・データベースから削除したり、パスワードを変更したり、その他の
変更を加えないでください。
Oracle9iAS Database Cache では、一部の UNIQUE 制約をサポートしている索引はキャッシュされませ
ん。
オリジナル・データベースの表の特定の列に UNIQUE 制約が含まれており、その制約の作成時に名前
が指定されなかった場合、Oracle9iAS Database Cache では、その制約をサポートする索引はキャッシ
ュされません。したがって、索引を使用する問合せの場合、Oracle9iAS Database Cache により、索引
を使用するかわりに別の方法で結果が取得されるため、結果が返されるまでに時間がかかります。こ
の問題を回避するには、オリジナル・データベースの UNIQUE 制約に必ず名前を指定してください。
Oracle9iAS Database Cache および Cache Manager では、Oracle 各国語サポート（NLS）機能をサポート
しており、文字データ型に様々なキャラクタ・セットを使用可能です。各国語サポート機能により、
シングルバイトおよびマルチバイトの文字データの処理、およびキャラクタ・セットの変換が可能で
す。
インストール中に、Oracle9iAS Database Cache はオリジナル・データベースのキャラクタ・セットを
読み込みます。表をキャッシュすると、表は、オリジナル・データベースと同じキャラクタ・セット
を使用してキャッシュに格納されます。ただし、次の制限事項があるため注意してください。
−
オリジナル・データベースのデータベース・キャラクタ・セットまたは各国語キャラクタ・セッ
トが US7ASCII の完全なスーパーセットではない場合、キャッシュに正しいキャラクタ・セット
が設定されません。たとえば、オリジナル・データベースのキャラクタ・セットが、US7ASCII
の完全なスーパーセットではない JA16EUCFIXED である場合、キャッシュに JA16EUCFIXED が
設定されません。キャッシュのキャラクタ・セットは US7ASCII になります。また、Oracle9iAS
Database Cache では、オリジナル・データベースの各国語キャラクタ・セットとして、固定幅キ
ャラクタ・セットをサポートしていません。
キャラクタ・セットおよびスーパーセットの詳細は、『Oracle8i NLS ガイド』を参照してくださ
い。
−
今回のリリースでは、すべてではありませんが、多くの Oracle9iAS Database Cache および Cache
Manager によって返されるメッセージが、英語以外の言語に翻訳されています。
これらの制限事項と合わせて、次の項で説明されている、Cache Manager に関する既知の問題点と制限事項
を参照してください。
Cache Manager の既知の問題点および制限事項
オリジナル・データベースのユーザーの追加、削除または変更を行った場合、それらのアクションは
自動的に Cache Manager に反映されません。Cache Manager を使用してユーザー・リストを更新する必
要があります。詳細は、『Oracle Database Cache コンセプトおよび管理者ガイド』を参照してくださ
い。
オリジナル・データベースから表を削除しても、その表はキャッシュから自動的に削除されません。
Cache Manager を使用して表をキャッシュから削除する必要があります。
Cache Manager では、常にキャッシュ内の表のサイズが正しく表示されるとは限りません。オリジナ
ル・データベースの表のサイズが変更されても、Cache Manager では、表の現在のサイズではなく、
キャッシュ当初のサイズが表示されます。スケジュールされた同期化によってキャッシュ内の表を同
期化しても、この問題は解決されません。表のサイズ情報を更新するには、「表同期化ウィザード」
を起動するか、「キャッシュ内の表」ページの「すぐに同期化しますか。」ボックスにチェックを付
けることによって、スケジュール外の同期化を実行します。同期化が完了すると、表のサイズ情報が
更新されます。
136
Oracle9i Application Server for Compaq Tru64 UNIX リリース・ノート
今回のリリースでは、Cache Manager では、ご使用の環境の地域設定に関わらず、日付情報は
DD-MMM-YYYY の書式で表示されます。DD は日付、MMM は地域固有の 3 文字の月の略称、YYYY
は年です。
キャッシュが Cache Manager のインストール先のノードと異なるタイム・ゾーンに存在する場合、「ヒ
ット/ミス統計」のリセット時間および「ユーザー・リストの最終更新時刻」の時間に表示される時間
は正しくありません。
DBA Studio でオリジナル・データベースに接続する際に、「接続モード」リストで「SYSDBA」を選
択した場合、ナビゲータ・ツリーでキャッシュを選択したときにエラーが返される可能性があります。
無効なユーザー名またはパスワードを入力したというエラーが返される可能性があります。この問題
を回避するには、「データベース接続情報」ダイアログ・ボックスの「接続モード」で「Normal」を
選択し、オリジナル・データベースに接続します。
今回のリリースでは、一部の新しい機能および変更された機能のヘルプ・トピックは、英語以外の言
語では使用できません。特定のトピックに関する情報は、『Oracle Database Cache コンセプトおよび
管理者ガイド』を参照してください。
今回のリリースでは、「パフォーマンス・モニター」ページの個別のチャートについては、ドロップ
ダウン・メニューのヘルプは使用できません。これらのチャートの一般的なヘルプは、「ヘルプ」ボ
タンをクリックすることによって参照可能です。チャートを右クリックして新しいウィンドウでヘル
プを開いても、ヘルプはウィンドウに表示されません。
Oracle9iAS Database Cache Configuration Assistant を使用する際の Net8 設定ファ
イルについて
Oracle9iAS Database Cache Configuration Assistant を使用する際に、Net8 設定ファイル(tnsnames.ora 、
listener.ora など) が下記の位置に配置されていると、Oracle9iAS Database CacheConfiguration Assistant が正
しく動作しません。<ORACLE_HOME>/network/admin にある Net8 設定ファイルが使用されます。
/var/opt/oracle もしくは/etc
TNS_ADMIN 環境変数で指定したディレクトリ
上記の位置に、Net8 設定ファイルが無いことを確認の上、Oracle9iAS Database Cache Configuration Assistant
を使用してください。
Oracle9iAS Database Cache の tnsnames.ora の設定について
Oracle9iAS Database Cache は、オリジナル・データベースに対して共有サーバー接続を行うように設定され
ている場合、ユーザーリスト更新を行うことができません。Oracle9iAS Database Cache は、オリジナル・デ
ータベースに対し必ず専用サーバー接続するように設定してください。具体的には、Database Cache がイン
ストールされている Oracle Home 上の tnsnames.ora 内の ORACLE_ICACHE_ORIGIN の設定に、
(SERVER =DEDICATED)
を追加してください。
設定例は次のようになります
ORA_ICACHE_ORIGIN =
(DESCRIPTION =
(ADDRESS_LIST =
(ADDRESS = (PROTOCOL = TCP)(HOST = www.myhost.com)(PORT = 1521))
)
(CONNECT_DATA =
(SERVICE_NAME = orcl.myhost.com)
(SERVER = DEDICATED)
<--- この行を追加してください
)
)
第８章 Oracle9iAS Database Cache
137
インストール中の Oracle9iAS Database Cache 構成ツールの不正な表示
(Bug#1791035)
Enterprise Edition がリリース 1.0.2.0 から 1.0.2.1 に移行され、さらに 1.0.2.2 に移行された場合、Oracle9iAS
Database Cache 構成ツールが選択されていなくても、
リリース 1.0.2.2 への移行が必要ないにもかかわらず、
インストールの最後に表示されます。「Cancel」を選択して構成ツールを終了します。その他のアクショ
ンは必要ありません。
Oracle9iAS Database Cache Configuration Assistant の"Detail"ボタンについて
ボタンについて
Oracle9i Application Server Enterprise Edition をインストール後に起動される、Oracle9iAS Database Cache
Configuration Assistant 画面の Details ボタンを押すと、
ダイアログ画面が表示されなくなる場合があります。
その場合でも、処理は正常に継続され、終了時にダイアログ画面が再表示されます。
DB Cache Configuration Assistant で WTE-03802 のエラー (Bug#1877274)
DB Cache をインストール後にオリジナル・データベースを変更する場合、再インストール時に以下のエラ
ーとなります。
[Thread-3][2001-5-30:16:17:31:689] Adding users to the cache failed.
Reason: WTE-03503 ユーザー・リストの更新エラー:
ユーザーのキャッシュ・ノードへのインポートが失敗し
OCI エラー - ORA-20001: WTE-03802 Too many database links found.
ORA-06512: "SYS.DBMS_ICACHE_OBJECT", 行 652
ORA-06512: 行 1
この現象が発生した場合、以下の対処を行ってください。
変更前のオリジナル・データベースの SID : oldDB
変更後のオリジナル・データベースの SID : newDB
1.
internal ユーザーで iCache データベースに接続して、データベース・リンクを検索します。
SQL> select owner,db_link from dba_db_links;
OWNER
DB_LINK
-------------------- ------------------------------
2.
SYS
OLDDB.JP.ORACLE.COM
SYS
NEWDB.JP.ORACLE.COM
データベース・リンクを削除します。
SQL> drop database link olddb.jp.oracle.com;
SQL> drop database link newdb.jp.oracle.com;
3.
再度 Cache Configuration を起動します。
Oracle9iAS Database Cache のパフォーマンスモニター表示に関する障害
このリリースでは、Cache Manager のパフォーマンス画面より、「CPU 使用チャート」「メモリー/スワッ
プ・データ・チャート」を参照することはできません。
138
Oracle9i Application Server for Compaq Tru64 UNIX リリース・ノート
また、Cache Manager のパフォーマンス画面を表示する時に、エラーメッセージ表示されたウィンドウが表
示され、同時に Cache Manager を起動したターミナルにも同様なメッセージが表示されます。パフォーマ
ンスモニターのその他の機能は正常に動作いたしますので、これらのエラーメッセージは無視してくださ
い。
Oracle9iAS Database Cache Manager のヘルプ文字化けについて(Bug#1973932)
のヘルプ文字化けについて
Oracle9iAS Database Cache Manager のヘルプが正しく表示されません。使用方法に関しましては、マニュア
ル「Oracle Database Cache コンセプトおよび管理者ガイド リリース 1.0.2.1」を参照してください。
SQL*Plus からの Oracle9iAS Database Cache 使用について
Oracle9iAS Database Cache 環境下で、
環境変数 ORA_OCI_CACHE を 1 に設定して、
SQL*Plus から Oracle9iAS
Database Cache に接続すると、次のようなエラーが数秒間隔で表示されます。
Unaligned access pid=345372 <sqlplus> va=0x14022ce25 pc=0x12048b644
ra=0x12048b620 inst=0x30800000
このような場合は、次のコマンドでメッセージを表示しないようにできます。
prompt> uac p noprint
索引つきの表のキャッシュについて
ユーザーリストの更新後に作成された索引は、表と一緒に自動的に Oracle9iAS Database Cache にキャッシ
ュされることはありません。Oracle9iAS Database Cache に索引つきの表をキャッシュする場合には、Origin
DB 上にあらかじめ索引が作成された状態でユーザーリストの更新を行ってください。その後、DBA Studio
の Cache Manager より「キャッシュ内の表の追加」処理を行うことで表と関連する索引も一緒にキャッシ
ュされます。（ただし、表定義に関連付けてある主キーは上記の限りではありません）
Oracle9iAS Database Cache の PL/SQL プログラムの例外処理に対する動作
PL/SQL プログラムから Oracle9iAS Database Cache を利用する場合、挿入、更新または削除などのキャッシ
ュで処理できないリクエストが要求されると、キャッシュに対するリクエストが失敗し、オリジナル・デ
ータベースにリクエストがルーティングされます。
ただし、PL/SQL プログラム内で例外処理を定義している場合は、キャッシュ内で処理が完了されるため、
リクエストはオリジナル・データベースにルーティングされません。
Oracle9iAS Database Cache のキャッシュ管理 API に関する制限(Bug#1834097)
に関する制限
当リリースの Oracle9iAS Database Cache では、GET_TABLE_SIZE プロシージャを利用することはできませ
ん。
Oracle9iAS Database Cache でサポートされないコンポーネント
本リリースでは、以下のコンポーネントは Oracle9iAS Database Cache との組合せで使用することはできま
せん。
Oracle9iAS Portal
Oracle9iAS Wireless
Oracle9iAS Forms Service
Oracle9iAS Reports Service
Oracle9iAS Discoverer
Oracle EJE(OSE,Java Stored Procedure,EJB)
第８章 Oracle9iAS Database Cache
139
mod_plsql
140
Oracle9i Application Server for Compaq Tru64 UNIX リリース・ノート
第９章 Oracle9iAS Web Cache
原典情報: Oracle Web Cache Relase Notes, Relase 2.0.0.1.0
はじめに
この章の目的
この章では、Oracle9iAS Web Cache とドキュメントに記載されている機能との相違点、および使用上の注
意点について説明します。Oracle9iAS Web Cache をご使用の前には、必ずお読みください。
この章では、次のトピックを取り扱います。
Oracle9iAS Web Cache の構成
Oracle9iAS Web Cache の制限事項
Netscape の制限事項
TCP のチューニング
Oracle9iAS Web Cache の Watchdog 機能
Oracle9iAS Web Cache のデフォルト・ポート
Oracle9iAS Web Cache 使用法の例
1024 以下のポートをリスニングするための Oracle9iAS Web Cache の構成方法
拡張機能
Oracle9iAS Web Cache のバージョン
Oracle9i Application Server の本リリースに含まれる、Oracle9iAS Web Cache のバージョンは 2.0.0.4 です。こ
の章に含まれるバージョン番号は、Oracle9iAS Web Cache のバージョン番号を示しています。
Oracle9iAS Web Cache の構成
次のように Oracle9iAS Web Cache の初期構成を開始してください。
1.
現在、Oracle9iAS Web Cache のコンピュータに、ログオンしていない場合、インストールを実行した
ユーザーのユーザーID でログインしてください。
2.
Oracle9iAS Web Cache を起動します。コマンドラインから、次のように入力します。
webcachectl start
3.
Oracle9iAS Web Cache Manager を次のように起動します。
a.
ブラウザで次の URL にアクセスします。
http://web_cache_hostname:4000/
b.
管理者のユーザーID とパスワードの入力をプロンプトで求められたら、ユーザー名に
「administrator」を入れ、正しいパスワードを入力します。初めてログインしたときには、パスワ
ードは「administrator」になっています。
参照:
構成についての詳細な説明は、『Oracle Web Cache 管理および配置ガイド』を参照してください。
第９章 Oracle9iAS Web Cache
141
注意:
Oracle9iAS Web Cache は、webcache.xml と internal.xml の 2 つの構成ファイルを使用します。これらの構成
ファイルを決して編集しないでください。構成の変更は、サポートされていないため、Oracle9iAS Web Cache
で問題が発生する可能性があります。（例外については、「Oracle9iAS Web Cache の Watchdog 機能」また
は 「Oracle9iAS Web Cache のデフォルト・ポート」を参照してください。)
Oracle9iAS Web Cache の制限事項
HTTP Range リクエストとマルチパートのレスポンス
HTTP ブラウザには、HTTP リクエストに Range ヘッダーを入れて送信するものがあります。このタイプの
リクエストに対するレスポンスとして、アプリケーション Web サーバーは、マルチパートのドキュメント
でレスポンスするか、またはそのまま 1 つのドキュメントでレスポンスします。
このリリースの Oracle9iAS Web Cache は、HTTP の Range リクエストに対する HTTP マルチパートのレス
ポンスをキャッシュできません。Oracle9iAS Web Cache が HTTP リクエストを送信する先のアプリケーシ
ョン Web サーバーから、マルチパート形式でドキュメントが返される場合は、Oracle9iAS Web Cache
Manager の「Administering Web Sites > Cacheability Rules」項目で、これらのドキュメントをキャッシュ不可
と設定してください。
たとえば、ブラウザの中には、PDF ドキュメントに対して Range リクエストを送信するものがあります。
そこで、すべての PDF ドキュメントについて、キャッシュ・ルールをキャッシュ不可と設定する必要があ
ります。
パーソナライズ・ページ
キャッシュ・ルールを設定するとき、オプションで、Oracle9iAS Web Cache が、キャッシュされたドキュ
メントのパーソナライズ情報を HTTP リクエスト内のユーザー固有のパーソナライズ情報と置換できるよ
うに指定できます。こうすることで、キャッシュされたパーソナライズ・ページが他のユーザーのために
再利用され、パフォーマンスが著しく向上します。
このパーソナライズ機能を有効にすることで、Oracle9iAS Web Cache で、HTTP のレスポンス内の特殊なタ
グの付いたパーソナライズ情報や、HTTP のレスポンス内のすべての HTML リンク（HREF として認識さ
れる）上のパーソナライズ情報を探し出せるように設定できます。このリリースの Oracle9iAS Web Cache
は、特殊なタグ内のパーソナライズ情報も HREF HTML リンク内のパーソナライズ情報もどちらも検索し
ます。そのため、キャッシュ・ルールの作成/編集中に、パーソナライズ・ページの項目で「YES」を選択
すると、そのサブセクションの選択は、常に「pages contain HREFs that are session encoded URLs」になりま
す。 一方のオプション「pages do not contain HREFs that are session encoded URLs」を選択しても無視され、
すべてのパーソナライズ・ページは、セッションがエンコードされた URL として常に解析されています。
Oracle9iAS Web Cache Manager での不十分な入力チェック
Oracle9iAS Web Cache Manager は、構成情報の入力データ受信の際、Oracle9iAS Web Cache が起動時に行う
チェックと同じレベルの整合性検査は行っていません。したがって、Oracle9iAS Web Cache Manager では構
成変更が受け入れられたのに、Oracle9iAS Web Cache が、その変更を反映した構成で起動しないという場
合があります。
これは、誤った構成変更を適用した後で、Admin Server 自身が（webcachectl stop を使用して）シャットダ
ウンされた場合に特に問題になります。この場合、Admin Server 自体が、起動することができなくなり、
Oracle9iAS Web Cache Manager にアクセスできなくなります。回避策として、次のようにしてください。
# webcachectl repair
これで、構成変更前のバージョンをリストアします。
Web サーバー・ステータスの報告
Web サーバー・ステータス・ページは、別に失敗を検知しなければ、構成された Web サーバーがすべて活
動中であるとして報告をするでしょう。それは、たとえ Web サーバー・ステータス・ページがそれらが活
142
Oracle9i Application Server for Compaq Tru64 UNIX リリース・ノート
動中だと報告しても、Oracle9iAS Web Cache が Web サーバーへのリクエストのルーティングをスタートす
るまでは、それらの Web サーバーの実際の状態は未確認であることを意味します。
Admin Server への IP アクセス
Admin Server への IP アクセスが Web Admin インターフェースを通して可能になる場合、Web Cache オペレ
ーション・ページによって Web Cache を再開することは十分ではありません。Admin Server は webcachectl
ユーティリティを使用して、コマンドラインから再開される必要があります。
Netscape の制限事項
Oracle9iAS Web Cache は、オプションで、キャッシュされたドキュメントを圧縮することができるため、
連続した HTTP リクエストの対応に必要となるネットワーク帯域幅を少なくすることができます。ただし、
Netscape Navigator ブラウザのバージョンによっては、圧縮した JavaScript ドキュメントおよび HTML 以外
のドキュメントをサポートしていません。このリリースは Oracle9iAS Web Cache では、Netscape Navigator
ブラウザ以外のブラウザに対してドキュイメントの圧縮機能をサポートしています。
ファイル記述子の制限事項
ほとんどの UNIX プラットフォームで、1 プロセスがオープンできるファイル記述子の数にハードウェア上
の制限があります。この数は、通常 1024 ですが、設定が可能です。この初期値をより大きなものに変更す
るためには、ルートあるいはルート権限でプロセスを実行しなければなりません。別の方法はプロセスを
ルートするために setuid ビットをセットすることです。このための手続きは下記と同じものです。
｢1024 以下のポートをリスニングするための Oracle9iAS Web Cache の構成方法｣
このリリースでは、Oracle9iAS Web Cache が使用するファイル記述子の最大数は、次の式によって計算さ
れます。
使用するファイル記述子の最大数=現在の最大接続数
（Web Cache Manage によって webcache.xml 中に指定された数）
+すべての構成された Web サーバー･インスタンスの合計値+50(内部使用)
上記の計算式に基づき、Web Cache サーバーは開始時にファイル記述子を確保しようとします。それが確
保できなかった場合、自動的により低い値にはならず、エラー・メッセージを記録して Web Cache サーバ
ーは開始に失敗します。1024 以上のファイル記述子が要求されたため Web Cache サーバーが開始できない
場合、ルートで実行するか、あるいはルート権限として実行できるように setuid を設定します。さらに、
Web Cache Manager の中の"Current Maximum Incoming Connections"に、サーバに同時接続するクライアント
の最大数を正確に反映させてください。任意の高い値にセットすると、それに対して Web Cache がシステ
ム資源を使用し、パフォーマンスに悪影響を及ぼすので注意して下さい。
TCP のチューニング
Oracle9iAS Web Cache で、同時に多数の HTTP リクエストを処理させる場合は、TCP 接続キューの最大の
長さなどの、オペレーティング・システムの TCP 設定を調整する必要があります。
特に、Oracle9iAS Web Cache に対するストレス・テストを実行し、1 つのクライアント・コンピュータから
Oracle9iAS Web Cache に TCP 接続を連続して数多くオープンする場合に、スループットが周期的に変動す
ることがあります。通常、これは、オペレーティング・システムでの TCP 接続の TIME_WAIT が原因で起
こります。実際の使用における配置では、1 つのクライアントが膨大な数の接続をすることはほとんどない
ので、これは問題にはなりません。
第９章 Oracle9iAS Web Cache
143
サービス・アタックを拒否した場合に、通常、オペレーティング・システムのネットワーク・レイヤーで
使用可能性の問題が生じます。たとえば、あるクライアントが多数の接続を生成する場合、TCP 接続の問
題は、オペレーティング・システムの中で起こります。
次に示すのは、Solaris 2.x 用に TCP パラメータを設定するシェル・スクリプトの例です。
#!/bin/sh -x
/usr/sbin/ndd -set /dev/tcp tcp_conn_req_max_q 10240 /usr/sbin/ndd
-set /dev/tcp tcp_conn_req_max_q0 10240 /usr/sbin/ndd -set /dev/tcp
tcp_xmit_hiwat 32768 /usr/sbin/ndd -set /dev/tcp tcp_recv_hiwat 32768
/usr/sbin/ndd -set /dev/tcp tcp_time_wait_interval 1000
Oracle9iAS Web Cache のデフォルト・ポート
インストール時に、Oracle9iAS Web Cache は、次のデフォルト TCP ポートを使用するように構成されます。
管理: 4000
HTTP リクエスト: 1100
失効化: 4001
統計: 4002
アプリケーション Web サーバー: localhost:7777
インストールの最後に、Oracle9iAS Web Cache は起動を試みます。お使いの環境によっては（ポートの競
合、ファイル/ディレクトリの権限など）、Oracle9iAS Web Cache Admin Server または Cache Server が起動
に失敗することがあります。
デフォルト管理ポートが実行中の他のアプリケーションによってすでに使用されているために、Admin
Server が起動できなかった場合は、$ORACLE_HOME/webcache/webcache.xml の中の管理ポートを変更する
必要があります。まず、次の行を検索してください。
<LISTEN IPADDR="ANY" PORT="4000" PORTTYPE="ADMINISTRATION"/>
この "4000" を未使用のポート（"3999"など）に変更します。それから、次のように実行して、Admin Server
と Cache Server を起動します。
$ORACLE_HOME/webcache/bin/webcachectl start
注意: Oracle9iAS Web Cache 構成ファイルを直接編集する必要があるのは、この場合のみです。この唯一の
状況を除いて、決して構成ファイルを編集しないでください。
Admin Server は起動しているのに、Cache Server が起動できなかった場合は、ブラウザで
http://<hostname>:<admin port>/にアクセスして、Cache Server を再構成してください。その後、WWW の管
理ページから Cache Server を起動します。
上記のポート設定が 1 つでもインストール済みコンピュータの既存設定と競合する場合は、
http://<hostname
of the installed computer>:<administration port>/で再構成してください。たとえば、Oracle9iAS Web Cache が
server1 という名前のコンピュータにインストールされている場合、http://server1:4000/で再構成することが
できます。
管理ポートを再構成した後に、Oracle9iAS Web Cache Admin Server を再起動する必要があることに注意して
ください。他のポートの再構成後も、Oracle9iAS Web Cache の Cache Server を開始する必要があります。
UNIX で Admin Server を再起動するには、次のコマンドを実行します。
$ORACLE_HOME/webcache/bin/webcachectl stop
$ORACLE_HOME/webcache/bin/webcachectl start
144
Oracle9i Application Server for Compaq Tru64 UNIX リリース・ノート
Oracle9iAS Web Cache 使用法の例
Oracle9iAS Web Cache の使用法の例は、
$ORACLE_HOME/webcache/examples/readme.examples.html
を参照してください。
1024 以下のポートをリスニングするための Oracle9iAS Web Cache の構成方法
ほとんどの UNIX プラットフォームで、ルート権限を持たないプロセスは、1024 以下のポートでリスニン
グすることができません。Oracle9iAS Web Cache が通常のポート 80 などの 1024 以下のポートでもリスニ
ングできるように構成し、しかも、Oracle9iAS Web Cache がルート権限をもったまま稼動し続けないよう
にするために、次の手順に従ってください。
1.
Web Cache Manager によって、プロセスの識別情報を、たとえば nobody/nobody などの希望する稼動プ
ロセスの識別情報に変更します。また、Oracle9iAS Web Cache のリスニング・ポートを、たとえば 80
などの希望するポートに変更します。
2.
ルートとしてログインします。
3.
実行可能な'webcached'の所有者を次のようにして、ルートに変更します。
$ chown root $ORACLE_HOME/webcache/bin/webcached
4.
実行可能な'webcached'のグループを、たとえば nobody などの希望する実行プロセスの識別情報のグル
ープ ID に、次のように変更します。
$ chgrp <groupid> $ORACLE_HOME/webcache/bin/webcached
5.
set-user-id 権限を実行可能な 'webcached' に、次のように追加します。
$ chmod a+s $ORACLE_HOME/webcache/bin/webcached
6.
ルートを終了します。
7.
webcachectl から、Oracle9iAS Web Cache を起動します。Oracle9iAS Web Cache が、希望するプロセス
の識別情報（nobody/nobody）で希望するポートをリスニングしている必要があります。
$ $ORACLE_HOME/webcache/bin/webcachectl start
Oracle9iAS Web Cache Manager の administrator パスワード紛失について
Oracle9iAS Web Cache Manager の管理者ページにアクセスするには管理者ユーザ administrator のパスワード
が必要です。もしパスワードを紛失して Oracle9iAS Web Cache Manager にアクセスできなくなった場合は
次の作業を行ってください。デフォルトのパスワード administrator でアクセスできるようになります。
1.
設定ファイル$ORACLE_HOME/webcache/webcache.xml を開きます。
2.
<USER TYPE="MONITORING" PASSWORDHASH="XXXXXXX"/>の行を編集して<USER
TYPE="MONITORING" PASSWORDHASH="-652229939"/>と書きかえます。
3.
webcachectl stop コマンドと webcachectl start コマンドにより再起動を行います。
Oracle9iAS Web Cache のキャッシュルール設定時の注意
キャッシュルール設定時に、Expiration Rules を設定することができます。その場合、コマンドラインから
webcache をリスタートする必要があります。Web Cache Manager からのリスタートでは Expiration Rules が
有効にならないことがありますので注意してください。
第９章 Oracle9iAS Web Cache
145
Oracle9iAS Web Cache キャッシュ失効機能について(Bug#1972673)
キャッシュ失効機能について
Web Cache Manager から Administering Oracle Web Cache - Cache Cleanup を選択することで、キャッシュの手
動失効が行えます。しかし、失効実施後に表示される失効されたドキュメント数(Number of Objects
Invalidated)が正しく表示されないことがあります。
Oracle9iAS Web Cache でサポートされないコンポーネント
本リリースでは、以下のコンポーネントは Oracle9iAS Web Cache との組合せで使用することはできません。
・Oracle9iAS Portal
・Oracle9iAS Wireless
・Oracle9iAS Forms Service
・Oracle9iAS Reports Service
・Oracle9iAS Discoverer
Basic 認証を必要とするページのキャッシュ指定について
Basic 認証のページに対しキャッシュの指定を行って、Web Cache 上にページがキャッシュされると次回の
アクセスから Web Cache 上からそのページが返されてしまう為、認証が行われずユーザー名、パスワード
の認証なしにコンテンツにアクセスが出来てしまいます。認証を必要とするページをキャッシュしない指
定にしてください。
拡張機能
バージョン 1.0.2.1.0 の拡張機能
watchdog 機能
前出の「watchdog 機能を使用可能にする」を参照してください。
Web Cache Manager を使用して、アクセスのロギングを使用不可にすることが可能
「Administering Web Sites > Access Logging」ページでアクセス・ログを無効にできます。
注意: オンライン・ヘルプは、この新機能を反映していません。
イベント・ログは、オプションで冗長モードをサポート
このモードは、使用可能にすると、通常のイベントに加えて、アプリケーション Web サーバー・リクエス
トに関連するイベントのログも記録します、冗長的なイベント・ログは、デバッグの目的で使用できます
が、オラクル・カスタマ・サポート･センターによって薦められた場合にのみ、使用可能にしてください。
Oracle9iAS Web Cache Manager の「Administering Oracle Web Cache > Event Logging」ページでこの冗長イベ
ント・ロギングを使用可能にすることができます。
バージョン 1.0.2.3.0 の拡張機能
リクエストに対する HTTP レスポンスをキャッシュから送信するときに (いわゆるキャッシュ・ヒットの
場合)、もしこのレスポンス・オブジェクトの本文にセッションがエンコード化された URL（たとえば、
URL にセッション値のある HTML リンクなど）や、パーソナライズ属性（たとえば、ログインのユーザー
名やそのアドレス情報など）があり、これらのセッション値やパーソナライズ属性のいずれかの代入値が
リクエストに存在しない場合、WebCache 1.0.2.2.0 以前のバージョンは、このリクエストを、キャッシュ・
ミスとみなし、キャッシュ・オブジェクトを使用せずにバックエンドのアプリケーション Web サーバーに
146
Oracle9i Application Server for Compaq Tru64 UNIX リリース・ノート
レスポンスをリクエストします。バージョン 1.0.2.3.0 の WebCache は、この代入において、可能なかぎり
の代入処理をして、欠けているパーソナライズ属性/セッション値は、そのまま空にしておきます。したが
って、このリクエストは、キャッシュ・ヒットになります。この機能を使用できなくする場合、すなわち、
必要なすべてのパーソナライズ属性/セッション値がリクエストに存在することをキャッシュ・ヒットの必
須条件とする場合は、それらのパーソナライズ属性/セッション値を、セッションとして定義して、そのよ
うなリクエストに対するルールを Oracle9iAS Web Cache Manager の「Administering Web Sites > Session
Related Caching Rules」項目で定義する必要があります。そのルールでは、リクエストにセッション値が含
まれている場合にのみレスポンスがキャッシュ可能になるように指定します。
バージョン 2.0.0.1 の拡張機能
キャッシュされたオブジェクトの TOP100 のリスト
Oracle9iAS Web Cache では、キャッシュで最もよく参照されたオブジェクトのトップ 100 のリストを見る
ことができます。トップ 100 のオブジェクトを見るためには、次のステップを実行してください。
Web Cache Manager を開始してください。
ブラウザで次の URL を入力してください:
http://web_cache_hostname:Admin_Port/webcacheadmin?SCREEN_ID=CGA.Top100&ACTION=Show
Web Cache Manager は、キャッシュが最後に開始されてからのキャッシュ中のトップ 100 のオブジェクトを
リストする、オブジェクト・スクリーンを表示します。ディスプレイ中のカラムは次の意味を表します。
Rank:1 から 100 までのオブジェクトのスコアに基づいたランキング。
「1」のランクは最も高いスコアのオブジェクト、つまり最もよく参照されたオブジェクトを表します。
Object Name:オブジェクトの URL。URL は、クッキーかセッション情報のような 付加的な情報を含んでい
る場合があります。
Score:ドキュメンテーションが Web Cache に置かれてから要求された回数によって決定されるオブジェク
トの点数。
Size:オブジェクトのサイズ。
サイズは、バイト、キロバイト(K)あるいはメガバイト(M)で表わされます。
キャッシュされたコンテンツのリスト
Web Cache Manager で、現在キャッシュ中のオブジェクトのすべての URL のリストを生成することができ
ます。これは、指定したキャッシュビリティ・ルールが保存されて、望むオブジェクトをキャッシュして
いることを確認するのに役立ちます。Web Cache のパフォーマンスを維持するために、非ピーク時間にこ
のオペレーションを実行するように注意してください。
テキストファイルに URL のリストを書いている間、
パフォーマンスは多少低下するかもしれません。Web Cache の内容のリストを生成するとき、Web Cache
Manager はテキストファイルに URL を書き出します。
リストを生成するためには、次のステップを実行してください。:
Web Cache Manager を開始します。
ブラウザに次の URL を入力してください:
http://web_cache_hostname:Admin_Port/webcacheadmin?SCREEN_ID=CGA.CacheDump&ACTION=S
how
第９章 Oracle9iAS Web Cache
147
Web Cache Manager はキャッシュ・コンテンツ・ページを表示します。このページは URL を書くファイル
をリストします。デフォルトでは、ファイルは Web Cache ログ・ディレクトリに書かれ、webcache_contents.txt
と命名されます。
"Submit"をクリックします：
Oracle9iAS Web Cache は、テキストファイルに URL のリストを書きます。リストを生成するごとに、既存
のファイルにデータが追加されます。それは、現在キャッシュされているオブジェクトの URL の後に続け
て、ファイルに追加れた日付をリストします。
次の例は、webcache_contents.txt ファイルの抜粋を示します:
Cache Contents at Wed Apr 11 11:47:03 2001
/images/lnav/lnav_products.gif
/images/rnav/rnav_red_line_1.gif
/images/bullets_and_symbols/blk_line_bullet_10.gif
.
.
.
Cache Contents at Wed Apr 11 13:01:24 2001
/images/white_spacer_xp.gif
/images/white_spacer.gif
/images/miniappsnet.gif
Oracle9iAS Web Cache の Watchdog 機能
Oracle9iAS Web Cache には、Admin Server と Cache Server の 2 つの主要なコンポーネントがあります。Admin
Server は、管理タスクを処理し、Cache Server は、キャッシングと HTTP リクエストの処理を行います。ま
た、Admin Server には、watchdog 機能があり、Cache Server の起動状態の確認を行ないます。Cache Server
が動作していない場合は、Watchdog は Cache Server を起動させます。
Admin Server プロセスは起動時に、Watchdog プロセスを起動させます。Watchdog プロセスは指定された間
隔で、指定された URL にリクエストを送ることによって Cache Server の動作確認を行います。それが Cache
Server に接続することができない場合、あるいは Cache Server が指定された時間内に応答しない場合、
Watchdog プロセスは Cache Server を再起動します。
Watchdog プロセスには、以下のような属性を指定することができます。
ENABLE: Enables the watchdog process. Accepted values are:
YES
NO
初期値は NO です。
PINGINTERVAL:Cache Server の動作確認を行う秒間隔。初期値は 5 秒です。
PINGTIMEOUT:Watchdog プロセスが Cache Server の応答を待つ秒数。初期値は 5 秒です。
PINGURL:Watchdog プロセスが Cache Server の動作確認をするための URL。初期値は「/」です。
Cache Server が、有効なアプリケーション Web サーバーで構成されていない場合、Watchdog 機能の ping
動作は毎回失敗し、その結果、イベント・ログにエラーを出力します。これを止めるためには、有効なア
プリケーション Web サーバーを構成するか、または、管理者ページ（http:// <hostname>:<admin port>/ ）
から Cache Server を停止してください。
148
Oracle9i Application Server for Compaq Tru64 UNIX リリース・ノート
このリリースでは、初期値を変更するために webcache.xml ファイルを編集しなければなりません。ファイ
ルは次のディレクトリに位置します:
$ORACLE_HOME/webcache
Watchdog プロセスの属性の値を指定するために次のフォーマットを使用します:
<WATCHDOG [ENABLE =value] [PINGINTERVAL =value] [PINGTIMEOUT =value] [PINGURL =value]
/>
フォーマットでは、次のシンタックス・ルールに注意してください:
属性名および「ENABLE」の値は大文字でなくてはなりません。
各値はダブル・コーテーション・マーク(”)で囲まれます。
空白は引用された値の中で、あるいは引用符と値の間で許可されません。
空白は開いた鍵括弧(<)と要素名「WATCHDOG」の間で許可されません。
空白はエレメントのの終わりのスラッシュ(/)と鍵括弧(>)の間で許可されません。
例外は、このリスト中で注意されるように、余白(タブと newlines を含んで)が許可されます。
例えば、下記は有効です:
<WATCHDOG
PINGINTERVAL
ENABLE
"YES"
=
"5"
=
/>
属性は任意の順にリストすることができます。
WATCHDOG 要素は webcache.xml ファイル中の最後のエレメントです。
例えば、Watchdog プロセスが 8 秒ごとに Cache Server を確認し、10 秒間 Cache Server の応答を待つこと
を定義するためには、webcache.xml ファイルの中の次の行を使用します:
<WATCHDOG ENABLE="YES" PINGINTERVAL="8" PINGTIMEOUT="10" PINGURL="/" />
キャッシュのヒット/ミス
キャッシュのヒット ミス
Oracle9iAS Web Cache により、キャッシュにリクエストされた各ドキュメントに対し、キャッシュ・ヒッ
トまたはキャッシュ・ミスの情報が HTTP レスポンス・メッセージの Server レスポンス・ヘッダー・フィ
ールドに追加されます。
例えばキャッシュ・ミスのレスポンスのサーバー・ヘッダー・フィールドは以下のようになります。
Server: Oracle9iAS Web Cache/2.0.0.1.0 M / Apache/1.3.12 (Unix) (Red Hat/Linux)
“Oracle9iAS Web Cache/2.0.0.1.0”の後の M はキャッシュミスを示します。
H はキャッシュ・ヒット、S は失効後のキャッシュ・ヒットを示します。
リスニングの保留/再開
リスニングの保留 再開
Oracle9iAS Web Cache は、すべてのキャッシュのリスニング・ポート(管理、統計あるいは失効ポートを含
まない)に関する HTTP リクエストを保留し再開することを可能にします。これは、フロントエンド・クラ
イアントへのキャッシュを停止したいが、Cache Server のメインメモリのキャッシュ内容を失いたくない場
合に役立ちます。
第９章 Oracle9iAS Web Cache
149
例えば、Web Cache の前にロードバランサを配置している場合、一時的に HTTP をキャッシュに送信した
くなければ、ロードバランサを再構成する代わりにこの機能を使用することで、キャッシュ内容を維持す
ることができます。
Web Cache のリスニング・ポートすべて (管理、失効、統計ポート以外)を保留するには、ブラウザに以下
の URL を入力してください。
"http://<cache host>:<statistics port>/stop_listen"
Web Cache のリスニング・ポートすべての再開(管理、失効、統計ポート以外)を再開するには、ブラウザに
以下の URL を入力してください。
"http://<cache host>:<statistics port>/start_listen".
150
Oracle9i Application Server for Compaq Tru64 UNIX リリース・ノート
第１０章 Oracle Enterprise Manager
はじめに
インストール
1. Enterprise Manager Web サイトをインストールする場合、「サマリー」ページに一覧表示される領域要件
に加えて、一時ディレクトリに 150∼200MB 程度の空き領域があることを確認してください。この領域
は、インストール中に Installer がファイルの中間処理を行うために使用します。Windows NT プラットフ
ォームでは、一時ディレクトリは TEMP システム環境変数で指定します。Solaris では、/tmp にあります。
（Bug#1357839）
2. サイレント・インストール中、リポジトリを作成/編集する Enterprise Manager Configurations Assistant
（EMCA）は自動的には起動しません。サイレント・インストール終了後、手動で EMCA ツールを起動
してください。（Bug#1379570）
互換性一覧
データベースの互換性
Oracle Management Pack リリース 2.2 は、7.3.4、8.0.6、8.1.x のバージョンの Oracle データベースで動作しま
す。
Intelligent Agent と Oracle Server
Oracle Intelligent Agent は、同一リリースまたは旧リリースのデータベースと互換性があります。しかし、
旧リリースの Intelligent Agent と、それより新しいリリースの Oracle データベースは互換性がありません。
新しいリリースの Intelligent Agent を使用して、旧リリースのデータベースを管理する場合、Intelligent Agent
は、それ自身の Oracle ホーム、または Intelligent Agent と同じバージョンの Oracle ホームにインストールす
る必要があります。
次の表に、Intelligent Agent の各リリースと Oracle Server の各リリースとの互換性を示します。Intelligent
Agent のリリースが特定のサーバー・リリースで動作することが確認されている場合、その項目に「あり」
と記されています。Agent が特定のサーバー・リリースで動作することが確認されていない場合、その項目
に「なし」と記されています。補足コメントは注記されています。
Oracle Server リリース番号
Intelligent Agent リリース番号
7.3.4 注 1
8.0.6
8.1.5
8.1.6
8.1.7
Intelligent Agent v7.3.4
あり
なし
なし
なし
なし
Intelligent Agent v8.0.4
あり
なし
なし
なし
なし
Intelligent Agent v8.0.5 注 2
あり
なし
なし
なし
なし
Intelligent Agent v8.0.6 注 2
あり
あり
なし
なし
なし
Intelligent Agent v8.1.5 注 2
あり
あり
あり
なし
なし
Intelligent Agent v8.1.6 注 2
あり
あり
あり
あり
なし
Intelligent Agent v8.1.7 注 2
あり
あり
あり
あり
あり
注 1: 個別にライセンス契約が必要な Management Pack の一部の機能は、7.3.4 以前のリリースでは使用できません。
制限の詳細は、各 Management Pack の項目を参照してください。
注 2: Intelligent Agent リリース 8.0.5、8.0.6 および 8.1.x には、データ収集サービス（Data Gatherer）が付属していま
す。
第１０章 Oracle Enterprise Manager
151
Enterprise Manager リリースと Intelligent Agent
Oracle Management Pack リリース 2.2 は、Intelligent Agent リリース 7.3.4 以上のバージョンで動作します。
ただし、
Windows NT で実行中の Intelligent Agent とともに Enterprise Manager リリース 2.x を実行するには、
リリース 8.1.5 以上の Intelligent Agent を使用するか、既存のリリース 7.3.x または 8.0.x の Intelligent Agent
を Intelligent Agent パッチ・リリース 7.3.4.1 または Intelligent Agent パッチ・リリース 8.0.5.1 にアップグレ
ードする必要があります。これらのパッチのいずれかを入手するには、オラクル社カスタマ・サポート・
センター担当者にご連絡ください。
Enterprise Manager 製品と Management Server / リポジトリ
Enterprise Manager コンソール、DBA Management Pack、個別にライセンス契約が可能な Management Pack、
Management Server およびリポジトリは、すべて同じリリースのものである必要があります。たとえば、リ
リース 2.1 の Management Server とリポジトリをリリース 2.2 のコンソールとともに使用することはできま
せん。また、リリース 2.1 の Management Server とリポジトリをリリース 2.2 の Management Pack とともに
使用することはできません。Enterprise Manager リリース 2.2 製品では、リリース 2.2 の Management Server
とリポジトリを使用する必要があります。これは、次のいずれかの製品が参照するためです。
Oracle Enterprise Manager コンソール
Oracle DBA Management Pack
Oracle Tuning Pack
Oracle Diagnostics Pack
Oracle Change Management Pack
Oracle Management Pack for Oracle Applications
Oracle Standard Management Pack
既存の Management Server とリポジトリのバージョンが古い場合は、最新のバージョンに移行またはアップ
グレードできます。
Management Server とリポジトリをリリース 2.2 に移行またはアップグレードする場合、
リポジトリとともに使用する Enterprise Manager 製品がすべてリリース 2.2 であることを確認してください。
たとえば、Diagnostics Pack リリース 2.1 や Change Management Pack リリース 2.1 をまだ使用しているので
あれば、Management Server とリポジトリはリリース 2.2 にアップグレードしないでください。使用するリ
リース 2.2 の Management Pack ソフトウェアを取得する前に、Management Server とリポジトリをリリース
2.2 にアップグレードすると、古い Management Pack 製品は使用できなくなります。
移行とアップグレードの詳細は、『Oracle Enterprise Manager 構成ガイド』を参照してください。
Oracle Enterprise Manager
新機能
Oracle Enterprise Manager リリース 2.2 には、次の機能が追加されました。
Enterprise Manager コンソール
コンソールのフォント・サイズ設定の変更。
コンソール内の全ノードのリフレッシュ方法の強化。
ノードおよびエージェントの詳細をコンソールのナビゲータから表示できます。この情報を表示するに
は、ナビゲータ・ツリーでノードを右クリックし、表示されたメニューから「プロパティ」を選択しま
す。ノードで Intelligent Agent リリース 8.1.7 が稼働している場合は、オペレーティング・システム情報
も表示されます。
152
Oracle9i Application Server for Compaq Tru64 UNIX リリース・ノート
パフォーマンスの向上
コンソールおよび DBA Studio のパフォーマンスを向上させるため、大幅な改良が加えられました。次の操
作を行う際のパフォーマンスが向上しています。
コンソールおよび DBA Studio の起動
コンソールのナビゲータ・ツリーの拡張
ナビゲータ・ツリーで選択したオブジェクトの詳細表示
ブラウザベースのコンソールの場合、Web サーバーに初めて接続する際には、jar ファイルをダウンロード
する間、進捗ダイアログが表示されます。
Apache Web サーバーおよび Apache for iAS Web サーバーのサポート
検出、ステータス・イベント、ジョブおよび通知などの新機能により、一般的な Apache および iAS Apache
Web サーバーの中間層環境を管理できます。パフォーマンス監視、拡張イベントおよびレポートなどの拡
張機能が Diagnostics Pack に組み込まれています。
基本的な管理およびイベントの詳細は、『Oracle Enterprise Manager 管理者ガイド』の第 2 章「ナビゲータ」
を参照してください。
拡張イベントおよびパフォーマンス監視の詳細は、『Oracle Enterprise Manager Oracle Diagnostics Pack スタ
ート・ガイド』の第 5 章「Oracle E-Business Management Tools」と第 7 章「Oracle Advanced Event Tests」を
参照してください。
ジョブ・システムおよびイベント・システム
イベント・システムに追加された新機能
新しいオペレーティング・システム固有のノード・イベント
拡張されたノードの動作・停止イベント
Intelligent Agent リリース 8.1.7 による重複イベントのサポート
イベント・テストの状況依存ヘルプ
ターゲット・サブコンポーネントの拡張された監視
詳細は『Oracle Enterprise Manager 管理者ガイド』の第 5 章「イベント」を参照してください。
ジョブ・システムの新機能
ジョブ・タスクの状況依存ヘルプ
電子メール通知にジョブ出力を含めるオプション
拡張通知
ポケットベル・サーバーが、Intelligent Agent を必要としない独立したサービスになりました。コンソー
ル内からポケットベル・サーバーを構成することもできます。
拡張通知（ポケットベルおよび電子メール）のコンテキストとフォーマットをコンソール内からカスタ
マイズできるようになりました。イベントおよびジョブ・ステータス通知に応じて、電子メールおよび
ポケットベルに異なるフィルタを指定することもできます。
詳細は、『Oracle Enterprise Manager 管理者ガイド』の第 1 章「コンソール」を参照してください。
エンタープライズ・レポート
Management Server で管理している全ターゲットの詳細を含む HTML レポートを生成できるようになりま
した。レポートに含まれる情報は、イベント警告、スケジュール済ジョブ、グループおよび検出済サービ
第１０章 Oracle Enterprise Manager
153
スです。ウィザードを使用して、これらのレポートが定期的に生成されるように設定できます。詳細は、
『Oracle Enterprise Manager 管理者ガイド』の第 1 章「コンソール」を参照してください。
また、オブジェクト定義、オブジェクト従属情報およびデータベース構成の HTML データベース・レポー
トや、カスタム問合せなどのその他のレポートも生成できます。詳細は、Enterprise Manager のオンライン・
ヘルプを参照してください。
DBA Studio
リソース管理の強化: リソース消費グループのリソース計画を作成するウィザード、リソース消費ア
クティビティのグラフィカル表示、リソース計画スケジューリングのサポート。
データベースへの接続時にアプリケーションが行った DDL および DML の全変更のロギング。
Replication Manager の強化: DBA Studio へのレプリケーション管理の統合、ツリーおよびプロパティ・
ページの直観的な新しいレイアウト。
JServer オブジェクトの参照、クラスの実行、リンクおよびディレクトリの作成、およびセキュリティ・
オプションの指定。
データベース・オブジェクトの DDL の表示。
分析ウィザードは、8i の新しい統計生成方法（DBMS_STATS）をサポートしており、データベースに
対して分析をただちに実行できます。
マテリアライズド・ビューの強化: ジョブ・システムを使用したマテリアライズド・ビューの作成/移
入、作成後に分析を行うオプション。
バックアップ・ウィザードでのイメージ・コピー。
従属オブジェクトをリストとツリーのいずれかで表示し、表示からオブジェクトを直接編集。
表への列権限の付与。
データ管理ウィザードでのジョブのエラーおよび警告に対する失敗と成功のインジケータ。
レンジ・パーティション化の新しいグラフィカル・インタフェース。
フォント設定の変更。
OMS チューニング用パラメータ
特殊な状況の下では、特定の OMS チューニングが必要な場合があります。チューニングを行うには、一部
の OMS 構成パラメータを設定します。
設定するパラメータは、次のとおりです。
- oms.vdp.ping_interval
- oms.vdg.max_out_conns
- oms.vdg.max_in_conns
- oms.repository.connect_timeout
- oms.repository.connect_numTries
詳細は、『Oracle Enterprise Manager 構成ガイド』を参照してください。
Intelligent Agent バージョン 8.1.7
複数のネットワーク・インタフェース・カード（NIC）の明確なサポート: この機能により、 Intelligent
Agent はマシン上の主 NIC で受信ジョブ/イベント要求をリスニングできます（デフォルト）。その他
のオプションを使用すると、Agent によるリスニングをユーザー指定の NIC と全 NIC のどちらで行うか
を構成できます。
重複イベントのサポート: この機能により、同じパラメータを持つ重複イベント・テストを同じターゲ
ット（データベース、リスナーなど）に対して登録できます。
154
Oracle9i Application Server for Compaq Tru64 UNIX リリース・ノート
データ収集用移行ユーティリティ: nmumigrate という新しいコマンド行ユーティリティにより、ユー
ザーは、既存 Intelligent Agent の Data Gatherer で実行されている既存のデータベース収集を、 Intelligent
Agent リリース 8.1.7 の Data Gatherer で認識される新しいフォーマットに移行できます。
Intelligent Agent リリース 8.1.7 へのアップグレード時に、既存の Enterprise Manager のジョブまたはイベ
ントを移行: この方法により、ユーザーは既存のジョブまたはイベントを手動で素早く移行すること
ができます。ジョブまたはイベント・ライブラリに保存してから、登録解除して再発行する必要はあり
ません。
MS Windows NT での自動スタートアップ: 特定の状況では、Intelligent Agent および Data Gatherer サー
ビスがインストール後に自動的に起動されます。
注意:
注意: これらの機能および強化の詳細は、 『Oracle Intelligent Agent ユーザーズ・ガイド』を参照してくだ
さい。
コンソール
1. コンソールの起動後に別のウィンドウを選択した場合、ログイン・ダイアログが手前に表示されません。
アクティブなウィンドウをすべて最小化するか、[Alt]+[Tab]を使用してコンソール・アプリケーション
を選択し、ログイン・ダイアログを手前に表示する必要があります。（Bug#806713）
2. コンソールからの接続用に Management Server 名を設定するときには、ノードの完全修飾名
（foo.us.oracle.com など）を使用することをお薦めします。完全修飾名を使用しないと、Management Server
と同じ DNS ドメインに属していないマシンでコンソールが実行されている場合に、一部の Management
Pack ツールをコンソールから起動できない可能性があります。完全修飾名を使用してもコンソールから
一部のツールを起動できない場合は、ローカルの'hosts'ファイルに、Management Server が実行されてい
るホストの IP アドレスを示すエントリを追加してください。
3. 1 つのウィンドウで項目を選択したときに、その前に選択した項目がクリアされないため、2 つの項目が
同時に選択されているように見えることがあります。最後に選択した項目が実際に選択されている項目
です。通常、新しいウィンドウで別の項目を選択すると、この問題を解決できます。（Bug#618771）
4. コンソールのトレース・パラメータにおける構文の変更
すべてのクライアント・トレース・パラメータから OEM.接頭辞が削除されました。現在のトレース・
パラメータは次のとおりです。
TRACING.ENABLED
TRACING.LEVEL
$ORACLE_HOME¥sysman¥config ディレクトリにある clientconfig.properties ファイルに、これらのパラメ
ータを追加してください。詳細は、『Oracle Enterprise Manager 構成ガイド』を参照してください。
5. コンソールおよび DBA Studio からデータベースを起動した場合、日本語環境では起動時刻やセッション
情報が文字化けする場合があります。一度データベースとの接続を切断し、再度接続していただくこと
で、正常に表示されます。
イベント・システムおよびジョブ・システム
1. イベントの手動消去
次の 5 つの拡張イベントは自動的に消去されません。
データベース警告
データ・ブロック破壊
セッション終了
アーカイバの停止
Data Gatherer 警告
つまり、これらのイベントのいずれかが発生し、問題が手動で解決された場合、問題が解決されたこと
を自動的に検出する方法がないため、イベントは自動的には消去されません。
第１０章 Oracle Enterprise Manager
155
したがって、イベント発生の原因となった問題の解決後には、次のようにしてイベントを手動で消去す
る必要があります。
a) EM コンソールにあるイベント画面の「警告」タブで、発生したイベントを「履歴」タブに移動し
ます。
b) 「履歴」タブで、このイベント発生を削除します。
これらのステップによりイベントが消去され、このイベントのために警告として設定されていたグルー
プ画面の赤い旗もリセット（緑に変わる）されます。
2. 重複イベント
Enterprise Manager 2.2 では、イベントが Intelligent Agent リリース 8.1.7 に対して登録されている場合は、
重複イベントを発行できます。重複イベントとは、同じパラメータを使用する同じイベント・テストを
持ち、同一ターゲットに登録されたイベントのことです。たとえば、警告しきい値が 80%、警戒しきい
値が 60%の表領域満杯テストを、同じ USERS 表領域に対して複数回登録できるということです。ただ
し、同じイベント内にこれと同じイベント・テストを持つことはできません。したがって、この例の場
合、重複する表領域満杯テストは、異なるイベントに属する必要があります。
重複イベントは、8.1.7 以前の Intellgent Agent では使用できません。特定のノード上で稼働している
Intelligent Agent のバージョンを調べるには、EM コンソールのナビゲータ・ツリーでそのノードを右ク
リックし、「プロパティ」を選択します。
8.1.6 以前の Intelligent Agent で稼働している Enterprise Manager リリース 2.1 では、重複イベントは使用
できません。
8.1.5 以前の Intelligent Agent で稼働している Enterprise Manager リリース 2.0.4 でも、重複イベントは使用
できません。
3. 同義イベント・テスト
同義イベント・テストは、同じイベント内で同じ測定基準を監視するテストですが、使用するパラメー
タは異なります。たとえば、異なる表領域に登録されているが、同じイベントに属しているという 2 つ
の表領域満杯イベント・テストがそれに当ります。
同義イベント・テストは、
Enterprise Manager 2.2 およびサポートされている全てのバージョンの Intelligent
Agent でサポートされます。
4. Enterprise Manager 2.0.4 リポジトリからの同義イベントの移行
Enterprise Manager リリース 2.0.4 リポジトリから Enterprise Manager リリース 2.2 リポジトリへアップグ
レードする際、Enterprise Manager リリース 2.0.4 に同義イベント（同一だが使用するパラメータが異な
るイベント・テストを複数持つイベント）がある場合、リポジトリのアップグレード後に、リリース 2.2
コンソールを起動してから、これらの同義イベントの登録を解除し、再登録する必要があります。
5. ジョブ履歴またはイベント履歴をリフレッシュする際、リフレッシュする履歴の量が多いと、最初は画
面に何も表示されません。この問題を解決するには、スクロール・バーの位置を調整してください。
（Bug#819774）
6. Windows 2000 のノードでのジョブの実行
Windows 2000 のノード上でジョブを実行する際、ジョブは「C:¥winnt¥temp¥21041345280.99 が見つかり
ません」というエラーで失敗する可能性があります。Windows 2000 では異なるオペレーティング・シス
テム・レベルのセキュリティを設定できるため、TEMP ディレクトリに対する権限が不十分なことから、
このエラーが生じます。この問題が発生した場合は、どのユーザーも TEMP ディレクトリ内でファイル
を作成、更新および削除できることを確認してください。TEMP ディレクトリは、TEMP 環境変数で表
されるディレクトリです。また、TEMP 環境変数で示されるディレクトリにも、作成、更新および削除
権限があることを確認してください。最後に、ジョブを再発行する必要があります。
7. Oracle Management Server 経由での、データベース起動はできません。DBA Studio をスタンドアロンで起
動し、データベース起動を行なってください。(Bug 1377901)
8. ローカル管理の表領域作成では、デフォルトでエクステント管理に「ローカル管理」が選択されていま
すが、実際にローカル管理表領域を作成するには一度「ディクショナリ管理」を選んで再度「ローカル
管理」を選んでください。ローカル管理の表領域を作成する場合は、SQL 表示ボタンを押し、生成され
156
Oracle9i Application Server for Compaq Tru64 UNIX リリース・ノート
た SQL 文に「EXTENTMANAGEMENT LOCAL」が含まれていることを確認してから実行・作成するこ
とを推奨します。（Bug#1478964）
9. マテリアライズド・ビュー作成ダイアログでジョブ発行ボタンを押した場合、エラーが発生し正しくジ
ョブが発行されません。（Bug#1479075）
10. ジョブを使用して、Intelligent Agent リリース 8.1.6 が稼動している Windows NT ノード上のデータベー
スを停止する場合、データベースの停止状態に関わらず、完了ステータスが「失敗」で返ってきます。
（Bug#1478931）
11. TCL ジョブの入力/出力データに日本語などのマルチバイト文字を伴う場合は、文字コード変換を行わ
ないと、ジョブが正常に動作しない場合があります。必ず、「convertin」および「convertout」関数を用
いて、明示的に文字コード変換を行ってください。
グループ
1. ナビゲータ・ツリーで「グループ」フォルダまたは特定のグループを選択した場合、ナビゲータのメイ
ン・メニューで「グループ作成」を選択しても、何も起こりません。これを回避するには、「グループ」
メイン・メニューの「グループ作成」メニュー項目を選択するか、または右クリックをして「作成」を
選択します。（Bug#1283307）
2. グループ作成時、背景に画像ファイルを指定しても、スクロールバーが表示されない場合があります。
OEM コンソールを再起動することで、正しくスクロールバーが表示されます。（Bug#1363847）
ポケットベルおよび電子メールのブラックアウト
1. ポケットベルと電子メールのブラックアウトを特定の曜日に設定し、指定した曜日の真夜中を超えるブ
ラックアウトを行うことはできません。たとえば、水曜日の午後 11 時 30 分に開始して木曜日の午前 1
時 30 分まで続く 2 時間のブラックアウトは作成できません。これを行うには、水曜日の午後 11 時 30
分から午前 12 時と、木曜日の午前 12 時 1 分から午前 1 時 30 分という、2 つの別々のブラックアウトを
作成する必要があります。（Bug#1036820）
2. 「間隔指定」で実行されるブラックアウトを定義する場合は、ブラックアウトの「有効期間」には終了
日を設定しないでください。（たとえば、有効期間は、「開始: 07/30/00
終了: <指定しない>」の
ように指定します。）終了日を指定すると、その期間の最終サイクルでブラックアウトが実行される問
題が発生します。終了日を指定しないままにして、この問題を回避してください。（Bug#1367312）
DBA Management Pack
1. スキーマ名にデリミタとして"."が含まれていると、このスキーマの下にあるオブジェクトを表示する際
に、詳細が空になります。（Bug#1055740）
2. サマリー・アドバイザ・ウィザードを使用するには、listener.ora ファイルおよび tnsnames.ora ファイルに
外部プロシージャ・エージェントを設定する必要があります。詳細は、『Oracle8i Net8 管理者ガイド』
を参照してください。
3. OS 認証は、データベースに直接接続しているとき（クライアント/サーバー・モード）にのみ機能しま
す。Management Server を介して接続しているときには、OS 認証はサポートされません。
4. SQL*Plus Worksheet の実行中に「SP2-0738 Restricted command」エラーが発生すると、SQL*Plus が OMS
に接続する際、サーバー側のファイル・システムにアクセスできません。この場合、OMS マシン上でス
クリプトの実行が試みられ、SQL*Plus プロセスが制限モードで実行されます。セキュリティ上の理由で、
クライアント側のスクリプトのみが、「ローカル・スクリプトの実行...」メニューにより実行できます。
詳細は、「SQL*Plus Worksheet ヘルプ」を参照してください。
5. レプリケーション（サーバー側）は、レプリケーション環境を定義するために、DBA Studio Replication
Management オプションを使用する前にインストールする必要があります。レプリケーションがインスト
ールされていないと、ウィザードで実行されるタスクはすべて失敗します。
6. LONG または LONG RAW データ型の列が含まれる索引構成表
（IOT）
はパーティション化できないため、
LONG または LONG RAW データ型の列が主キー列でない場合は、エラー・メッセージが正しく表示さ
れなくなり、パーティションが入力可能になります。IOT に LONG または LONG RAW データ型の列が
第１０章 Oracle Enterprise Manager
157
含まれ、それが主キーの場合は、「LONG/LONG RAW データ型列を持つ表はパーティション化できま
せん」というエラー・メッセージが正しく表示されます。
7. データベース・レポートのスケジューリングは、ユーザーが SYSDBA としてログインし、そのユーザー
のパスワードが NORMAL での接続時と SYSDBA での接続時で異なる場合は失敗します。これを回避す
るため、レポートのスケジューリングには NORMAL で接続してください。SYSDBA で接続すると、レ
ポートのスケジューリングでは無視されますので、注意してください。（Bug#1360896）
8. レプリケーション・ウィザードは、DBA Studio からのみ起動できます。Enterprise Manager コンソールを
使用する場合、まず DBA Studio を起動してからレプリケーション・ウィザードを起動してください。
（Bug#1365244）
9. DBA Studio で格納された構成を編集するとき、マウスの右クリックにより出現したメニューで「編集」
を選択し、さらに出現したダイアログで「OK」をクリックした場合、エラーが発生する場合があります。
この場合、変更はセーブされていますので、「取消」を選択してダイアログを終了してください。
（Bug#1377721）
10. SQL*Plus Worksheet を日本語環境でご使用の場合、
$ORACLE_HOME¥sysman¥config¥dbappscfg.properties
に次のパラメータを指定してください。
SQLPLUS_NLS_LANG=（お使いの環境に合わせた NLS_LANG 値）
SQLPLUS_SYSTEMROOT=（お使いの環境の%SystemRoot%環境変数の値）
※¥マークは、dbappfcfg.properties 内に記述されている例に従い¥¥としてください。
<例>
SQLPLUS_NLS_LANG=Japanese_Japan.JA16SJIS
SQLPLUS_SYSTEMROOT=C:¥¥WINNT
Oracle Management Server（
（OMS）
）
1. Windows での OMS サービスの作成
Windows NT および Windows 2000 では、サービスとしての OMS の作成は、Enterprise Manager
Configuration Assistant（EMCA）によって実行されるようになりました。つまり、OMS サービスは、イ
ンストール時に、新規リポジトリを作成または既存リポジトリを使用するために EMCA を使用した場合
にのみ作成されます。
OMS サービスは「手動」起動タイプで作成されます。これは、構成が不適切または不十分な OMS の自
動起動を防ぐために設計されました。OMS が適切に構成され、テストが行われると、OMS のサービス・
タイプを必要に応じて「自動」に変更できます。次の手順で、これを実行できます。
1) 「コントロール パネル」の「サービス」オプションを起動します。
2) OMS サービス（「Oracle<Oracle ホーム名>ManagementServer」という名前）を選択します。
3) 「スタートアップ」ボタンをクリックし、適切な「スタートアップの種類」タイプのラジオ・ボ
タンを選択します。
2. 強化された OMS 起動
oemctrl ユーティリティを介して OMS を起動すると、
OMS の起動時に進捗インジケータが表示されます。
OMS が完全に起動した場合にのみ、OMS が起動したことを示すメッセージが表示されます。OMS の起
動時に問題が生じた場合は、該当するエラーが発生します。oemctrl を使用して Windows NT または 2000
で OMS を起動し、起動が完了すると、「コントロール パネル」内の対応するサービスにも「開始」ス
テータスが反映されます。
Windows NT または 2000 上のサービスとして OMS を起動すると、OMS が完全に起動した後にのみ、ス
テータスが「開始」になります。
起動時に問題が発生した場合は、$ORACLE_HOME/sysman/log ディレクトリにある oms.nohup ファイル
を参照してください。
3. OMS の停止
158
Oracle9i Application Server for Compaq Tru64 UNIX リリース・ノート
Windows NT および 2000 上で、「コントロール パネル」からサービスとしての OMS を停止すると、停
止を実行するための接続情報を尋ねるダイアログ・ボックスが表示されます。指定する接続情報は、有
効な Oracle Enterprise Manager スーパーユーザー・アカウントです。
4. OMS のステータス
OMS のステータスを調べるには、新しい oemctrl オプション、oemctrl ping oms を使用できます。このオ
プションは OMS が使用可能かどうかを調べるのに適しています。接続情報は必要ありません。
5. Solaris から HP への接続
OMS が Solaris ノードで、EM リポジトリ・データベースが HP 10.20 ノードで稼働している場合は、次
の SQLNET.ORA パラメータを OMS ノードで設定する必要があります。
DISABLE_OOB=ON
SQLNET.ORA ファイルは、$ORACLE_HOME/network/admin ディレクトリにあります。$ORACLE_HOME
は、OMS がインストールされているディレクトリです。このパラメータは、Sun と HP の TCP 層による
同じソケットでの同時緊急メッセージの処理方法が異なるために生じる sqlnet 接続の停止を防ぎます。
このパラメータを設定した後、OMS を停止し、再起動する必要があります。
6. Oracle Management Server の状態表示
コマンドプロンプトで「oemctrl status oms <スーパー管理者名>/<パスワード>」コマンドを実行しても、
VXA-2009 エラーが発生し状態表示が行なえない場合があります。
Enterprise Manager Configuration Assistant
1. リリース 2.2 以前のリポジトリ
Oracle Enterprise Manager リリース 2.2 以前の既存リポジトリは、インストール時に自動的にアップグレ
ードされません。リポジトリに対するアップグレードは、各種 Enterprise Manager 製品でそのリポジトリ
を使用する既存ユーザーに影響を与えます。リポジトリのユーザー全員が、コンソール、DBA Studio、
Management Pack など、各自のソフトウェアをリリース 2.2 にアップグレードするまで、リポジトリのア
ップグレードは行わないでください。リポジトリのアップグレードに適した時期をスケジュールした後、
EMCA を使用してアップグレードを実行します。
2. EMCA によるリポジトリのアップグレード
リポジトリのアップグレードを実行するには、明示的に Configuration Assistant（EMCA）を実行し、「ア
ップグレード」オプションを選択する必要があります。「アップグレード」オプションを選択し、DBA
権限を持つアカウントを使用してログインすると、EMCA にはアップグレード可能な既存のリポジトリ
が表示されます。リポジトリがリストにない場合は、EMCA によってアップグレードできないことを意
味します。アップグレードするリポジトリを選択し、操作を継続します。
Windows NT または 2000 上で EMCA を実行中の場合は、EMCA のアップグレードにより、まだ作成さ
れていない OMS サービスも作成されます。
Enterprise Manager Migration Assistant
1. 一部のサービスについて、
優先接続情報リストをリリース 1.x リポジトリからリリース 2.2 リポジトリに
移行できない場合があります。この場合は、リリース 2.2 コンソールで、そのサービスの優先接続情報
リストを手動で設定する必要があります。（Bug#751627）
ブラウザベースの Enterprise Manager
1. ブラウザベースの Enterprise Manager にログインした後、コンソールが停止していることに気づいた場合
は、（1）使用している Web ブラウザでプロキシが設定されていないこと、および（2）使用されている
MSVCRT.DLL がバージョン 5.00.7303 より後のバージョンであることを確認してください。
MSVCRT.DLL のバージョンは、システム・パスでこの dll を検索することにより調べられます。パスで
見つかった最初の dll は、使用中のものではないことがときどきあります（この dll は
c:¥winnt40¥system32¥からロードされたものと考えられます）。使用中の dll を確認するには、コンソー
ルの停止中にその dll の名前を変更してみてください（Windows NT エクスプローラでは、使用中の dll
第１０章 Oracle Enterprise Manager
159
の名前を変更できません）。dll のバージョンは、プロパティを参照することで確認できます。dll を置
換するには、次の手順で行います。
DOS シェルからの場合:
1) dll が存在するディレクトリにディレクトリを変更します。
2) msvcrt.dll の名前を「_msvcrt.dll」に変更します。
3) 正しいバージョンの msvcrt.dll を元のディレクトリにコピーします。
4) マシンを再起動します。
2 Web サーバーに初めて接続すると、jar ファイルがダウンロードされます。ブラウザ・プロセスは、ダウ
ンロード時に多くのメモリーを消費するように見える場合があります。ダウンロードが完了した後、ブ
ラウザを終了し、EM コンソールを起動する前に再起動してください。
3. Enterprise Manager の起動ページから EM コンソール、DBA Studio または SQL Worksheet を起動すると、
選択したアプレットを実行するために別のブラウザ・ウィンドウが作成されます。これにより、元のブ
ラウザ・ウィンドウは別の目的に使用できます。
この別のブラウザ・ウィンドウは閉じないでください。閉じると、アプレットも停止してしまいます。
4. 複数の言語をインストールして複数の言語を使用して Web ブラウザから Enterprise Manager を使用する
には、以下の URL を使用してください。
http://<マシン名>:3339/EmWebSite_xx.html (xx は言語名、日本語は”ja”)
もし一つの言語で使用する場合は、EmWebSite_xx.html を EmWebSite.html にコピーし、「http://<マシン
名>:3339/ 」という URL を使用してください。
統合アプリケーション
Oracle interMedia Text Manager
1. Oracle interMedia Text Manager の起動時に現れるダイアログ・ボックスに無効なサービス名を入力すると、
interMedia Text Manager の動作が停止する場合があります。
2. 「作成 オブジェクト」ダイアログを取り消すと、interMedia Text Manager が終了する場合があります。
3. interMedia Text Manager を用いて、INDEX_SET プリファレンスを作成することはできません。
（Bug#1480444）
4. interMedia Text Manager を用いて、MULTI_STOPLIST を用いたテキスト索引の作成はできません。
MULTI_STOPLIST を用いてテキスト索引を作成する場合、コマンドラインから作成を行ってください。
（Bug#1480463）
5. interMedia Text Manager から ConText Server を起動すると、正常に起動したか否かに関わらず「Job failed:
Error Output from job xxx lost.」というメッセージが表示されます。OEM Console のジョブ履歴にも、
ConText Server 起動ジョブが失敗のステータスで記録されます。（Bug#1587092）
Oracle Forms Server Manager
1. Forms リスナー・ログ・ファイル内の日本語文字は文字化けしています。（Bug#1286040）
2. 「Forms リスナーの作成」ダイアログ内で、「ソケット」モードは選択できません。（Bug#1370422）
Oracle Enterprise Security Manager
1. Enterprise Security Manager の起動時にダイアログ・ボックスが現れますが、このダイアログ・ボックス
からヘルプを起動すると、ヘルプ・ダイアログは入力を全く受け付けない場合があります。この場合は、
Enterprise Security Manager 本体の「ヘルプ」メニューからオンライン・ヘルプを起動してください。
（Bug#1183164）
160
Oracle9i Application Server for Compaq Tru64 UNIX リリース・ノート
Oracle Parallel Server Manager
1. Parallel Server を含むノードをナビゲータから削除した場合、ナビゲータ内の表示が一部正常でなくなる
場合があります。その場合、ナビゲータを一旦最上位まで縮小し、それからナビゲータを拡張してくだ
さい。（Bug#1051444）
2. Parallel Server に対するデフォルト接続情報が設定されていない場合、Oracle Enterprise Manager はデータ
ベースのデフォルト接続情報を使用し、Parallel Server インスタンスに接続を試みます。その場合は、そ
の Parallel Server に対する優先接続情報、もしくは Parallel Server 一般のデフォルト接続情報を設定して
ください。（Bug#1051439）
3. Oracle Enterprise Manager 内に表示される Oracle Parallel Server のアイコンの表示が適切でない場合があり
ます。（Bug#1106032 および 1106004）
その他
1. Enterprise Manager、または Enterprise Manager に統合されているアプリケーションが Windows 95 または
Windows 98 で起動すると、そのアプリケーションと一緒に起動された DOS ウィンドウが現れます。DOS
ウィンドウは閉じないでください。DOS ウィンドウを閉じると、起動されていた Enterprise Manager ア
プリケーションが終了してしまいます。（Bug#1161051）
2. JRE は、各種 Oracle 製品によりインストールされます。ただし、共有 JRE は 1 システムにつき 1 つに限
られます。したがって、Enterprise Manager リリース 2.2 のインストール後に以前のリリースの Enterprise
Manager（リリース 2.0 または 2.1）をインストールすると、リリース 2.2 の一部としてインストールさ
れた JRE（Java Runtime Environment）が、自動的にダウングレードされ、エラー・メッセージは表示さ
れません。JRE リリース 1.1.7.30o から JRE リリース 1.1.7.5o または 1.1.7.24o へのダウングレードは、
Enterprise Manager リリース 2.2 の問題の原因となります。したがって、Enterprise Manager リリース 2.2
のインストール後に、Enterprise Manager リリース 2.0 または 2.1 をインストールしないでください。
8.1.7 以前の Oracle データベースをインストールしても、同様に JRE のダウングレードという問題が生
じます。
この状態になった場合は、Enterprise Manager リリース 2.2 をインストールした CD-ROM（ほとんどの場
合はリリース 8.1.7 CD-ROM）から JRE リリース 1.1.7.30o を再インストールすることにより、問題を回
避できます。Oracle Universal Installer を再インストールして、JRE をインストールし直します。Installer
は、JRE に依存しているためです。
3. Enterprise Manager の英語以外のバージョンでは、英語以外のオンライン・ヘルプで一部矛盾が生じる可
能性があります。最新情報は日本語リリース・ノートを参照してください。
既知の問題点
次の項目について説明します。
コンソールに関する問題
DBA Management Pack に関する問題
コンソールに関する問題
グループパネル
グループ作成時、背景に GIF ファイルを指定しても、グループペインにスクロールバーが表示されない場合
があります。OEM コンソールを再起動することで、正しくスクロールバーが表示されます。（Bug#1363847）
ジョブ・システムとイベント・システム
Intelligent Agent リリース 8.1.6 が稼動している Windows NT ノード上のデータベースをジョブを使用して停止
する場合、データベースが正しく停止したか否かに関わらず、完了ステータスが「失敗」で返ります。
（Bug#1478931）
第１０章 Oracle Enterprise Manager
161
TCL ジョブの入力／出力データに日本語などのマルチバイト文字を伴う場合は、文字コード変換を行わな
いと、ジョブが正常に動作しない場合があります。convertin および convertout 関数にて、明示的に文字コ
ード変換を行ってください。
DBA Management Pack に関する問題
コンソールおよび DBA Studio からデータベースを起動した場合、日本語環境では起動時刻やセッション情
報が文字化けする場合があります。一度データベースとの接続を切断し、再度接続することで、正常に表
示されます。
Oracle Management Server 経由で、データベースを起動することはできません。DBA Studio をスタンドアロ
ンで起動し、データベースを起動してください。（Bug#1377901）
HTML レポートを表示するには、Netscape Navigator 4.x 以上が必要です。また、PATH 環境変数に Netscape
をインストールしたディレクトリが含まれている必要があります。
表データ・エディタで、DATE 型の列に条件指定を行なっても、エラーVTOS-4845 が発生するか、フィル
タ機能が正しく動作しません。DATE 型の列に条件を指定して行を絞り込む場合は、フリーSQL モードを
使用して WHERE 句に条件を指定してください。（Bug#905721）
表領域の作成時には、デフォルトでエクステント管理に「ローカル管理」が選択されていますが、この指
定が SQL 文に反映されない場合があります。ローカル管理表領域を作成するには一度「ディクショナリ管
理」を選択し、再度「ローカル管理」を選択してください。ローカル管理表領域を作成する場合は、SQL
表示ボタンを押し、生成された SQL 文に「EXTENT MANAGEMENT LOCAL」が含まれていることを確認
してから実行／作成することをお薦めします。（Bug#1478964）
マテリアライズド・ビュー作成ダイアログ・ボックスでジョブ発行ボタンを押した場合、エラーが発生し
正しくジョブが発行されません。（Bug#1479075）
表作成ダイアログ・ボックスの「パーティション」タブ・ページには、レンジ・パーティション用の「自
動生成」ボタンが存在します。ご使用の環境によっては、初期ウィンドウ・サイズが小さいためにこのボ
タンが見えない場合があります。表作成ダイアログのサイズを横方向に拡大することで、このボタンが見
えるようになります。
SQLPLUS_NLS_LANG=（NLS_LANG 環境変数と同じ値）
SQLPLUS_LD_LIBRARY_PATH=（LD_LIBRARY_PATH 環境変数と同じ値）
SQLPLUS_ORACLE_HOME=（ORACLE_HOME 環境変数と同じ値）
例:
SQLPLUS_NLS_LANG=JAPANESE_JAPAN.JA16SJIS
SQLPLUS_LD_LIBRARY_PATH=/export/home1/o817c/app/oracle/product/8.1.7/lib
SQLPLUS_ORACLE_HOME=/export/home1/o817c/app/oracle/product/8.1.7
162
Oracle9i Application Server for Compaq Tru64 UNIX リリース・ノート
第１１章 Oracle9iAS Wireless
はじめに
この章の目的
この章では、Oracle9iAS Wireless をお使いになるにあたり、ドキュメントに記載された機能との相違点を説
明します。
この章では、次のトピックを取り扱います。
『Oracle9i Application Server for UNIX インストレーション・ガイド』の訂正
新機能
JDK/JRE 動作保証
Oracle9iAS Wireless クライアント・ツールのサポート OS
Oracle9iAS Wireless クライアント・ツールの CPU 要件
Oracle9iAS Wireless 1.1.1
Oracle9iAS Wireless のアップグレード
JServ.conf への追加点
Oracle9iAS Wireless の再インストール
Oracle9iAS Wireless サーバー・インストレーション
Oracle9iAS Wireless クライアント・インストレーション
システム Logger
Oracle9iAS Wireless 用の複数の VM のセットアップ
Oracle9iAS Wireless インスタンスのプロパティ設定について
既知の制限事項と制約事項
注意：以前のリリースでは、この製品およびコンポーネントは「Portal-to-Go」と呼ばれていました。ソフ
注意：
トウェアによって生成されるメッセージの一部、また Configuration Assistant やクライアント・ツー
ルの画面の一部では、以前の名前が使用されています。また、ここで使用されている「Oracle9iAS
Wireless」はコンポーネント名称を指し、「Oracle9i Application Server Wireless Option」は、製品名称
を指します。また、特別な指定がない場合のコンポーネントのバージョンは 1.1.1.0.0、製品のバー
ジョンは、リリース 1.0.2.2 のことを指します。
ライセンス
Oracle9iAS Wireless をご利用いただくためには、Oracle Internet Application Server Enterprise Edition および
Oracle Internet Application Server Wireless Option のライセンスが必要であることにご注意ください。
『Oracle9i Application Server for UNIX インストレーション・ガイド』の訂正
『Oracle9i Application Server for UNIX インストレーション・ガイド リリース 1.0.2.2』では、Oracle9i
Application Server のインストール手順を説明しています。この項では、インストールを正しく実行するた
めの追加情報を提供します。
第１１章 Oracle9iAS Wireless
163
Oracle9iAS Wireless の設定の検証
『Oracle9i Application Server for UNIX インストレーション・ガイド リリース 1.0.2.2』の付録 F-8 ページの
Oracle9iAS Wireless Personalization Portal の URL は正しくありません。Personalization Portal が正しく動作し
ているかどうかをテストするには、次の URL にアクセスしてください。
http://<ias_host_name>.<domain>:<listener_port>/portal/Login.jsp
jserv.conf ファイルの ApJServGroupMount エントリの例
『Oracle9i Application Server for UNIX インストレーション・ガイド リリース 1.0.2.2』の付録 F-4 ページお
よび F-7 ページには、jserv.conf ファイルを編集して Oracle9iAS Wireless 固有のマウント・ポイントを追加
するという作業が含まれています。次の ApJServGroupMount のセクションの例は、『Oracle9i Application
Server for UNIX インストレーション・ガイド リリース 1.0.2.2』に含まれていません。
# PTG Start
ApJServGroupMount /ptg balance://group1/root
# PTG End
新機能
Oracle9iAS Wireless の今回のリリースについての詳細は、『Oracle9i Application Server Wireless Edition イン
プリメンテーション・ガイドリリース 1.0.2.1』を参照してください。
JDK/JRE の動作保証
オラクル社では、Oracle9iAS Wireless は JDK/JRE 1.2.2 および JDK/JRE 1.3.0 上でのみ動作を保証していま
す。ただし、Oracle9iAS Wireless Web Integration Server、Oracle9iAS Wireless Web Integration Developer に関
しては、JDK/JRE 1.2.2 のみ保証しています。
Oracle9iAS Wireless クライアント・ツールのサポート OS
Oracle9iAS Wireless Service Designer および Oracle9iAS Wireless Web Integration Developer は下記 OS での動
作をサポートします。
Windows NT4.0 Service Pack 5 以上
Windows 2000 Service Pack 1 以上
Oracle9iAS Wireless クライアント・ツールの CPU 要件
Oracle9iAS Wireless Service Designer および Oracle9iAS Wireless Web Integration Developer は Pentium-4 プロセ
ッサを搭載したコンピュータではサポートされません。
Oracle9iAS Wireless 1.1.1
Oracle9iAS Wireless 1.1.1 は、Oracle9iAS Wireless 1.1（Oracle9i Application Server リリース 1.0.2.1 に付属）
のパッチです。Oracle9iAS Wireless 1.1.1 には、Oracle9iAS Wireless 1.1.1 パッチで修正された内容が含まれ
ています。
Oracle9iAS Wireless のアップグレード
Oracle9iAS Wireless 1.1.1（Oracle9i Application Server リリース 1.0.2.2 に付属）には、Oracle9iAS Wireless 1.1
（Oracle9i Application Server リリース 1.0.2.1 に付属）からのみアップグレード可能です。それより前のリ
リースから移行する場合、まず Oracle9iAS Wireless 1.1 にアップグレードし、その後、現在のリリースにア
ップグレードする必要があります。
164
Oracle9i Application Server for Compaq Tru64 UNIX リリース・ノート
JServ.conf への追加点
Oracle9iAS Wireless の以前のリリースからアップグレードする場合、jserv.conf ファイルを次のように変更
する必要があります。このファイルは、次の場所に存在します。
$ORACLE_HOME/Apache/Jserv/etc/jserv.conf
1.
ApJServMount /ptg /root をコメント化します。
2.
次の行を追加します。
# PTG 1.1.1 Begin
ApJServGroupMount /ptg balance://group1/root
# PTG 1.1.1 End
Oracle9iAS Wireless を新規インストールする場合:
1.
次の行を追加します 。
# PTG 1.1.1 Begin
ApJServGroupMount /ptg balance://group1/root
# PTG 1.1.1 End
Oracle9iAS Wireless の再インストール
Oracle9iAS Wireless のインストール時に、Wireless リポジトリが作成されます。Oracle9iAS Wireless をアン
インストールしても、データベース・スキーマは自動的に削除されません。そのため、Oracle9iAS Wireless
をアンインストール後に再インストールする場合（前回のインストール時と同じデータベース・ユーザー
名を使用して）、手動でデータベース・スキーマを削除する必要があります。データベース・スキーマを
削除する前に、データベース・スキーマ内のデータのバックアップを作成します。データベース・スキー
マを削除する方法の 1 つは、Wireless データベース・ユーザーを削除することです。たとえば、インストー
ル時に Wireless リポジトリの所有者を panama と指定したとします。
1.
System ユーザー（またはその他の DBA 権限をもつユーザー）として接続し、sqlplus を起動します。
2.
次のコマンドを発行します。
sqlplus>drop user panama cascade
sqlplus>commit
sqlplus>exit
Oracle9i Application Server Wireless サーバー・インストレーション
インストール・オプション
インストール・オプションは Minimal Edition、Standard Edition、Enterprise Edition のいずれでも可能です。
ただし、Minimal Edition を利用してインストールされる場合には別途リポジトリ・データベースが作成さ
れている必要があります。
非対話モードのインストールの非サポート
Oracle9iAS Wireless の非対話モードのインストールはサポートされていません。Oracle9iAS Wireless のイン
ストールでは、Oracle9iAS Wireless 固有の情報の入力および設定ファイルの手動による編集が必要です。詳
細は、『Oracle9i Application Server Wireless Edition コンフィグレーション・ガイドリリース 1.0.2.2』を参
照してください 。
第１１章 Oracle9iAS Wireless
165
データベース接続
インストール時に作成されるデフォルトのデータベースは、ご使用の環境に合わせて正しくチューニング
されていない可能性があります。「ORA-00020: maximum number of processes exceeded errors」というメッセ
ージが表示される場合があります。このメッセージの表示を回避するには、ご使用のシステムで
max_processes データベース・パラメータに十分に大きい値が設定されており、Oracle Net8 の使用不能プロ
セスの検出が設定されていることを確認してください。データベースの設定とパフォーマンスの詳細は、
Oracle8i のドキュメントを参照してください。
接続可能な Oracle データベース
Oracle9i Application Server リリース 1.0.2.2 において、Oracle9iAS Wireless では、Oracle 8.1.7 および 9.0.1 を
サポートしています。リポジトリに利用するデータベースは、Standard Edition オプションでインストール
されるデータベース・インスタンスをご利用ください。また、リポジトリとして使用するデータベースで
サポートされるキャラクタ・セットは JA16SJIS、JA16EUC、UTF8 になります。コンテンツとして利用す
るデータベースのサポートは、使用する JDBC ドライバのバージョンに依存します。また、この接続に関
するサポートはコンテンツになるデータベースのサポート契約に基づきます。
Oracle 9.0.1 に接続するための作業
コンテンツ・データベースとして、Oracle 9.0.1 を利用可能です。Oracle 9.0.1 に接続するためには、JDBC Thin
ドライバのパッチを適用する必要があります。このパッチの適用については、第１章「CD Pack に同梱さ
れるパッチの適用について」の「Oracle9i Database に JDBC Thin ドライバで接続する際の修正の適用」を参
照してください。
Oracle9i Application Server インストール後の設定
Oracle9i Application Server をインストールした後には下記の手順で Oracle9iAS Wireless サーバーおよび
Oracle9iAS Wireless Web Integration Server を構成変更してください。
1.
デフォルト・データベースのキャラクタ・セットの変更
Oracle9i Application Server リリース 1.0.2.2 では日本語環境でのインストールがサポートされています
ので、インストール時に作成されるデータベースのキャラクタ・セットは NLS_LANG で設定した内
容が反映されます。あらかじめ以下のような設定をしてください。
Solaris）
NLS_LANG=Japanese_Japan.JA16EUC
Windows）
必要なし
HP-UX）
NLS_LANG=Japanese_Japan.JA16SJIS
IBM AIX）
NLS_LANG=Japanese_Japan.JA16SJIS
Compaq Tru64 Unix）
NLS_LANG=Japanese_Japan.JA16SJIS
上記の設定で作成されるデータベースのキャラクタセットは、Solaris の場合は、EUC、その他は、
Shift_JIS になります。
2.
非同期通知機能(アラート)を使用する場合の init.ora への追加事項
非同期通知機能(アラート)を使用する場合は下記のパラメータをリポジトリ DB の init.ora に追加して
ください。
aq_tm_processes = 2
166
Oracle9i Application Server for Compaq Tru64 UNIX リリース・ノート
修正を反映させるために、データベースを再起動してください。
3.
upload.sh の修正
upload.sh を使用する場合は、下記の部分を事前に修正してください。
upload.sh は、ORACLE_HOME 内の panama/sample に存在します。
a.
rt.jar
修正前：${JAVA_HOME}/lib/rt.jar
修正後：${JAVA_HOME}/jre/lib/rt.jar
b.
servlet.jar
../lib/servlet.jar をフルパスで servlet.jar の位置を指定してください。
4.
リポジトリセットアップのマニュアル実行
Oracle9iAS Wireless のリポジトリ・ロードが実行されるタイミングでは、ORACLE EJE および Net8 リ
スナは構成されていません。Oracle Universal Installer の実行が終了後、手動で Oracle9iAS Wireless リポ
ジトリの構成を実行する必要があります。以下の二つのスクリプトを順に実行して下さい。
$ORACLE_HOME/panama/sql/create_aq.sh
$ORACLE_HOME/panama/setupconf/pa_java_inst.sh
注意：pa_java_inst.sh
実行中、下記のようなエラーが発生し、正しく実行できない場合があります。
注意：
oracle.panama.PanamaException:No such user ""
その場合は下記の修正を pa_java_inst.sh に加えて下さい。
a.
rt.jar
修正前：${JAVA_HOME}/lib/rt.jar
修正後：${JAVA_HOME}/jre/lib/rt.jar
b.
Administrator ユーザ ID の追加
修正前：oracle.panama.core.util.LoadXml -c0
修正後：oracle.panama.core.util.LoadXml -l Administrator/manager -c0
5.
リポジトリセットアップ後に必要な設定事項
Oracle9iAS Wireless のインストールでは、リポジトリが構成された後に Oracle9iAS Wireless 固有の情
報の入力および設定ファイルの手動による編集および設定変更が必要です。詳細は、『Oracle9i
Application Server Wireless Edition コンフィギュレション・ガイド リリース 1.0.2.2』を参照してくださ
い。
6.
Oracle9iAS Wireless Web Integration Server でマルチバイト・キャラクタ・セットをサポートするための
設定
Oracle9i Application Server リリース 1.0.2.2 では、
WindowsNT 環境において、
1 つの Web Integration Server
で同時に複数のロケールのデータソースを扱う事が可能です。これにより、Shift_JIS と EUC のサイト
を同時にサポートすることが可能です。以下の二つの設定を行ってください。
Web Integration Server の起動ロケールを英語環境にします。
Web Integration Adapter の InputEncoding をデータソースに合わせます。
具体的には、次の設定変更をサーバー側で適用します。
Windows NT の設定方法を以下に示します。
WE_HOME¥WebIntegration¥Server¥bin¥server.bat を書き換えて、起動オプションを ISO8859_1 に変更し
ます。以下に例を示します。
1) Web Integration Server 起動前に、コントロールパネルで地域を英語(US)に変更します。
第１１章 Oracle9iAS Wireless
167
2) WE_HOME¥WebIntegration¥Server¥bin¥server.bat を書き換えて、起動オプションを ISO8859_1 に変更
します。以下に例を示します。
:runserver
%SCMD% -Dfile.encoding=ISO8859_1 watt.app.server.Main %1 %2 %3 %4 %5 %6 %7 %8 %9
goto done
3) Web Intagration Server の起動後、コントロールパネルの設定を元に戻します。
Windows 2000 の JDK1.2 では上記のような地域の変更を行った場合の動作サポートはしていません。
Windows 2000 では地域変更を行わなずに Shift_JIS で起動された Web Integration Server のみサポートし
ます。
この場合の設定方法を以下に示します。
1) Web Integration Server の起動ロケールをデータソースと合わせます。
2) Web Integration Adapter の InputEncoding には何も指定しません。
この場合には以下の制限があります。
1) Web Integration Server は Shift_JIS しか扱う事が出来ません。
2) 検索系など、ユーザのフォーム入力に日本語を扱う事ができません。
注意：地域を変更する際には、地域を変更したことによる、Oracle9iAS Wireless Web Integration Server
以外のアプリケーションへの影響の有無を事前に十分に検証した上で、システム管理者の責任
で変更を行ってください。
7.
Oracle HTTP Server、Oracle9iAS Wireless Web Integration Server を再起動してください。
注意：Oracle9iAS Wireless Web Integration Server 管理ツール(http://HOST.DOMAIN:5555)でのサービス
のテストについて 7．の設定を行わずに作成されたサービスのテストを行うとエラーとなった
り、文字化けが発生します。問題が発生する場合は再度設定を見直してください。
Oracle9iAS Wireless クライアント・インストレーション
Oracle9iAS Wireless クライアントのインストールには、『Oracle9i Application Server Administrative and
Development Client CD-ROM』が必要です。これは CD-Pack に含まれます。また、このインストール手順の
詳細は、『Oracle9i Application Server for UNIX インストレーション・ガイド リリース 1.0.2.2』付録 B をご
参照ください。以下は、日本語 OS におけるインストレーションの補足事項やマルチバイト・キャラクタ・
セットのハンドリングの方法等を記述しています。
Oracle9iAS Wireless クライアントのセットアップの準備
Oracle9iAS Wireless クライアント・ツールでマルチバイト・キャラクタ・セットをサポートするには、国際
化バージョンの Java 実行環境が必要です。
1.
JavaSoft の Web サイトから、Java 実行時環境（JRE）の国際化（またはローカライズ）バージョン
をダウンロードします。
2.
JavaSoft の Java Runtime Environment（JRE）をインストールします。
3.
Java Virtual Machine（JVM）の font.properties ファイルを font.properties.<locale>に置き換えます。ク
ライアントの JVM のパスは次のとおりです。
%JREDIR%¥lib
Oracle9iAS Wireless Service Designer のセットアップ
Oracle9iAS Wireless Service Designer の起動用バッチファイル run.bat を書き換えます。ファイルパスは以下
のとおりです。
%ORACLE_HOME%¥panama¥ServiceDesigner¥run.bat
168
Oracle9i Application Server for Compaq Tru64 UNIX リリース・ノート
1.
JAVA12_HOME に JRE をインストールしたパスをセットし、コメントアウト(REM)を外して有効に
します。たとえば、次のようになります。
set JAVA12_HOME=D:¥jdk122¥jre
2.
起動する java コマンドのパスを JAVA12_HOME に変更します。
"%JAVA12_HOME%¥bin¥java" -version
"%JAVA12_HOME%¥bin¥java" -classpath %PASD_CP% oracle.panama.pasm.PASM
Oracle9iAS Wireless Web Integration Developer のセットアップ
Oracle9iAS Wireless Web Integration Developer でマルチバイト・キャラクタ・セットをサポートするには、
インストール済みクライアントに次の設定変更を適用します。（Oracle9iAS Wireless Web Integration
Developer 同梱の Java Virtual Machine（JVM）には i18n.jar および適切な font.properties ファイルが含まれて
いないため、マルチバイト・キャラクタ・セットはサポートされていません。）
1.
JDK1.2 使用時には developer.zip のクラス名解決に問題があるため、下記のように developer.zip を展
開します（これにより developer.zip に含まれる class が正しく検索されます）。developer.zip ファイ
ルを解凍します。このファイルのパスは次のとおりです。
%ORACLE_HOME%¥panama¥WebIntegration¥Developer¥lib¥developer.zip
ファイルを次の場所に解凍します 。
%ORACLE_HOME%¥panama¥WebIntegration¥Developer¥lib¥developer¥
2.
developer.bat ファイルを編集します。このファイルのパスは次のとおりです。
%ORACLE_HOME%¥panama¥WebIntegration¥Developer¥bin¥developer.bat
a.
次の行をコメント化（REM）します。
SET JDKDIR=C:¥OraHome1¥panama¥WebIntegration¥Developer¥jvm
b.
JRE1.2 のインストール先の新しい JRE ディレクトリを指すように JDKDIR を設定します。たと
えば、次のようになります。
REM SET JDKDIR=C:¥OraHome1¥panama¥WebIntegration¥Developer¥jvm
SET JDKDIR=c:¥jre1.2
c.
次の行をコメント化（REM）します。
SET CLASSPATH="%JDKDIR%¥LIB¥RT.JAR;%DEVDIR%¥LIB¥DEVELOPER.ZIP;
%DEVDIR%¥packages¥wmroot¥code¥classes"
d.
CLASSPATH を指定します。その際 DEVELOPER.ZIP を DEVELOPER に変更します。たとえば、
次のようになります。
REM SET CLASSPATH="%JDKDIR%¥LIB¥RT.JAR;%DEVDIR%¥LIB¥DEVELOPER.ZIP;%DEVDIR%¥
packages¥wmroot¥code¥classes"
SET CLASSPATH="%JDKDIR%¥LIB¥RT.JAR;%DEVDIR%¥LIB¥DEVELOPER;%DEVDIR%¥packages
¥wmroot¥code¥classes"
e.
次の行をコメント化（REM）します。
"%JDKDIR%¥bin¥jre" -ms16M -mx32M -classpath %CLASSPATH%
watt.app.watt.Main -config "%DEVDIR%¥config¥developer.cnf"
-home "%DEVDIR%" %1 %2 %3 %4 %5 %6 %7 %8 %9
3.
マルチバイト・キャラクタの対応
Oracle9iAS Wireless Web Integration Developer は同時に複数の文字コード形式をサポートできません
(例：EUC_JP で記述されたソースを正しく扱うには EUC_JP 対応で起動された Oracle9iAS Wireless Web
Integration Developer が必要になります）。起動バッチファイルを切り替えて、Shift_JIS と EUC_JP を
別々の Web Integration Developer で扱うことができます。Oracle9iAS Wireless Web Integration Developer
を使用して WEB サイトへアクセスする際、アクセスする WEB サイトが Shift_JIS で作成されている
か EUC で作成されているかによって、以下の設定を行ってください。
第１１章 Oracle9iAS Wireless
169
%ORACLE_HOME%¥panama¥WebIntegration¥Developer¥bin¥developer.bat に Oracle9iAS Wireless
Web Integration Developer 起動オプションとして java コマンドラインにアクセスする WEB サイト
に合わせたファイル・エンコーディング指定を追加します。
-Dfile.encoding=<encoding>
たとえば、Shift_JIS 用の設定は developer.bat の最後に次の行を追加します 。
"%JDKDIR%¥bin¥java" -Dfile.encoding=SJIS -ms16M -mx32M
-classpath %CLASSPATH% watt.app.watt.Main -config
"%DEVDIR%¥config¥developer.cnf" -home "%DEVDIR%"
%1 %2 %3 %4 %5 %6 %7 %8 %9
EUC 用の設定は developer.bat の最後に次の行を追加します 。
"%JDKDIR%¥bin¥java" -Dfile.encoding=EUC_JP -ms16M -mx32M
-classpath %CLASSPATH% watt.app.watt.Main -config
"%DEVDIR%¥config¥developer.cnf" -home "%DEVDIR%"
%1 %2 %3 %4 %5 %6 %7 %8 %9
Oracle9iAS Wireless Web Integration Developer 起動時の OS の地域指定をアクセスする WEB サイ
トに合わせて選択します。
Shift_JIS の場合：
日本語
EUC の場合：
英語
EUC_JP で起動する際の注意：
Windows NT の JDK1.2 では、file.encoding パラメータを有効にするためにはコントロールパネル
の地域を US に変更する必要があります。オペレーティング・システムの地域に"日本"が選択さ
れている場合は、EUC_JP を file.encoding に指定しても、その指定が無視され、結果的に Shift_JIS
の形式のソースしか扱うことができません。なお、地域を変更する際には、地域を変更したこと
による、Oracle9iAS Wireless クライアント以外のアプリケーションへの影響の有無を事前に十分
に検証した上で、システム管理者の責任で変更を行ってください。
Windows 2000 の JDK1.2 では上記のような地域の変更を行った場合の動作サポートはしていませ
ん。Windows 2000 では地域変更を行わなずに Shift_JIS で起動された Oracle9iAS Wireless Web
Integration Developer のみサポートします。
Oracle9iAS Wireless WebIntegration Server 管理ツール(http://HOST.DOMAIN:5555)でのサービスのテストに
ついて
上記 3．の設定を行わずに作成されたサービスのテストを行うとエラーとなったり、文字化けが発生
したりします。
問題が発生する場合は再度設定を見直してください。
Oracle9iAS Wireless クライアント・ツールのプログラム・フォルダの位置
すでに Oracle9i Application Server などをインストールしているマシンに「Oracle9i Application Server
Administrative and Development Client CD-ROM」から Oracle9iAS Wireless Service Designer と Oracle9iAS
Wireless Web Integration Developer をインストールすると、Windows のスタート→プログラム→Oracle for
Windows NT →Oracle9i Application Server Wireless Edition の下に起動用アイコンが配置されます。
システム Logger
これまでは、サービス・リクエストおよびセッションのロギング情報は、イベントが発生するたびにリポ
ジトリに記録されていましたが、負荷の大きい本番環境では、パフォーマンスが低下していました。今回
のリリースでは、システム Logger のインプリメンテーションが改善されました。ログ情報のキューおよび
170
Oracle9i Application Server for Compaq Tru64 UNIX リリース・ノート
データベースへのログの記録によって発生していたパフォーマンスの問題を回避するため、データベース
へのロギングを遅延するよう変更が加えられました。まず、データがファイルに記録され、別のプロセス
によってファイルからの読み込みおよびデータベースへのログの記録が実行されます。Logger により、次
のディレクトリが作成されます。
log - ファイル Logger がファイルを書き込むディレクトリ。
process - データベース Logger が作成時のタイムスタンプに基づいて記録を読み込むディレクトリ。
archive - 処理済みのファイルは、後の使用のためにすべてこのディレクトリに移動されます。
status - 処理済みファイルに関する情報、およびデータベースにログされた記録は、このディレクトリ
に記録されます（各 panama インスタンスごとに 1 ファイル）。
注意: ログ・ファイルの読み込みおよびデータベースのロギングは、panama サーブレットのパフォーマン
スを低下させずに、別々の JVM で実行可能です。デフォルトの設定では、データベース Logger は、
サーブレットとともに起動されます（System.properties ファイルでこの設定を変更可能です）。
追加設定の必要性
現在のリリースでは、次のパラメータを設定する必要があります。設定可能な新しいパラメータのほとん
どには、デフォルト値が存在します。ローカルの要件に合わせて、これらの値を管理者がリセットする必
要があります。
SystemLog.loggerOutputDirectory=xxx
（デフォルトは、log.directory プロパティの設定値と同じ値 ）
ログ、プロセスおよびアーカイブ・ディレクトリのルート・パス。これらは、このルート・ディレクトリ
の下に作成されます。デフォルトでは、システム Logger は、log.directory プロパティで指定されたディレ
クトリを使用します。このデフォルトは/tmp です。このパラメータは、空白のままでもかまいません。
SystemLog.maxLogFileSize=xxx
ログ・ディレクトリ内のファイルの最大サイズ。ログ・ファイルがこのファイル・サイズに達すると、ロ
ギング・プロセスはこのファイルを閉じ、ファイルを process ディレクトリに移動します。
SystemLog.logFileNamePrefix=xxx （デフォルト: ias_ ）
ユーザー定義のログ・ファイル名の接頭辞。デフォルトの接頭辞は iaswe です。一般的なファイル名は、
<SystemLog.logFileNamePrefix>_<ptginstancename>_<creationtimestamp>.log のようになります。
SystemLog.field.delimiter=xxx （デフォルト: #%=%# ）
ログに記録された名前と値のペアのデリミタ。システム Logger により、デフォルト値が使用されます。
SystemLog.record.delimiter=xxx （デフォルト: ~#$ ）
ログ内の記録のデリミタ。システム Logger により、デフォルト値が使用されます。
SystemLog.maxLogFileSize=xxx
各ログ・ファイル当たりのバイトの最大数。これには、適度に大きな数値を設定する必要があります 。
SystemLog.start.dbLogger=[true/false] （デフォルト: true ）
データベースへのロギングを使用するかどうかの指定。false の場合、ログの記録はファイルにのみ保存さ
れます。true の場合、記録がファイルから取得され、データベースに記録されます（つまり、DB Logger
スレッドが開始されます）。値は True または False です。
第１１章 Oracle9iAS Wireless
171
SystemLog.logger.wakeupFrequency=xxx （デフォルトは 1 分）
DB Logger スレッドが再開されてから process ディレクトリ内の新しいログ・ファイルの有無を調べるまで
の時間（分）。
SystemLog.logger.maxSize=xxx （デフォルト: 15 ）
データベース・ロギングのバッチ・サイズ
SystemLog.driver=xxx
（ユーザーが Logger 用に別のドライバの使用を指定しないかぎり、デフォルト値には、db.driver プロパテ
ィの値が使用されます。）
データベースの JDBC ドライバ。<String> は、"THIN" 、"V7" 、"V8" 、"INTERNAL"または"CUSTOM"
のいずれか 。
SystemLog.driver.class=xxx （デフォルトは Oracle のドライバを使用 ）
カスタマイズされた JDBC ドライバの<class_name>を使用して接続。バージョン 1 ではインプリメントされ
ていません。SystemLog.driver=CUSTOM の場合、設定する必要があります。
次に、oracle/panama/core/admin/System.properties ファイルの既存の設定パラメータのうち、保持されるもの
の一部を示します 。
SystemLog.enableServiceLogging=[true/ false]
サービスのロギングを使用可能にするかどうかを指定します。
SystemLog.enableSessionLogging=[true/ false]
セッションのロギングを使用可能にするかどうかを指定します。データベースに最後に記録されたログの
状態が、ステータス・ログ・ファイルに格納されます。ステータス・ログ・ファイルは、クラッシュ・リ
カバリの際に、最後に処理されたファイルとその記録を管理者が調べ、データベース Logger によって重複
するログが記録されないようにするために使用します。
データベース
データベース Logger の開始手順
デフォルトの設定では、DBLogger スレッドが panama サーブレットの起動時に開始されます。ただし、
SystemLog.start.dbLogger プロパティを false に設定することにより、これをオフに指定できます。データベ
ース Logger は、次のようにして、別のプロセスとして起動可能です。
prompt> java -classpath <needed panama classes> oracle.panama.core.admin.DbLogger
すべてのソフトウェアが d:¥内にインストールされている場合、起動コマンドは次のようになります。
java -classpath d:¥panama¥lib¥panama.zip;d:¥panama¥lib¥panama_core.zip;D:¥jsdk2.0¥li
b¥jsdk.jar;D:¥panama¥lib¥classes12.zip;d:¥panama¥lib¥jndi.jar;D:¥pan
ama¥lib¥xmlparserv2.jar oracle.panama.core.admin.DbLogger
Oracle9iAS Wireless 用の複数の VM のセットアップ
新しいグループ・ベースのロード・バランシング機能を活用するには、jserv.conf ファイルを次のように変
更する必要があります。
172
Oracle9i Application Server for Compaq Tru64 UNIX リリース・ノート
1.
新しい機能のディレクティブを有効にするには、ApJServManual が auto（on または off ではなく）
に設定されている必要があります。
2.
新しいロード・バランシング・アーキテクチャでは、複数のインスタンスをグループ化することが
可能です。グループとは、トラフィックのロード・バランシング先のインスタンスのセットのこと
です。グループのメンバーには、1 つ以上のマシンに存在するインスタンスを使用可能です。グル
ープは、次のディレクティブで定義されます。
ApJServGroup groupname nprocs weight propfile
詳細は、次のとおりです 。
groupname : グループ名
nprocs : ローカル・マシンでこのグループ用に起動するプロセスの数
weight : ホスト上のこのグループに割り当てられたトラフィック配分比率
propfile : jserv.properties ファイルのパス
例:
ApJServGroup group1 2 1
/private/ORACLE/10210PWE/Apache/Jserv/etc/jserv.properties
ApJServGroup group1 1 1
/private/ORACLE/10210PWE/Apache/Jserv/etc/jserv.properties
ApJServGroup group2 1 1
/private/ORACLE/10210PWE/Apache/Jserv/etc/jservSoap.properties
3.
グループを使用可能にするために、ApJServMount のかわりに次のディレクティブを使用する必要が
あります 。
ApJServGroupMount /mountpoint balance://groupname/zone
詳細は、次のとおりです 。
mountpoint : jserv-url をマウントする URI パスの名 前
groupname : ApJServGroup ディレクティブで定義されているグループの 1 つ
zone : このサーブレットが関連付けられているゾー ン
例:
ApJServGroupMount /ptg balance://group1/root
ApJServGroupMount /ptg balance://group1/root
ApJServGroupMount /ptg balance://group1/root
Oracle9iAS Wireless インスタンスのプロパティ設定について
Oracle9iAS Wireless の JServ インスタンスは処理の高速化のためにリポジトリオブジェクトを自身でキャッ
シュします。マスター・インスタンスは、この Wireless の各 JServ インスタンスのキャッシュ・オブジェク
トの同期を取るために実行される java プログラムです。各 JServ インスタンスは、マスター・インスタン
スとの RMI 通信を介して、他の JServ インスタンスにオブジェクトの更新情報を伝達します。Wireless の
複数インスタンスのプロパティファイルの設定例を以下にまとめます。
1) 各 JServ インスタンス用にクラスパスのコピーを作成します。
% cd $ORACLE_HOME/panama/server
% cp -r classes classes_X
X の部分を、1..N の番号を使用するなどして、各インスタンス毎に変更します。
2) 各 JServ インスタンスについて System.properties を修正します。
第１１章 Oracle9iAS Wireless
173
instance.identifier
各インスタンスの識別子
participateInCacheSyncronization
true
masterInstance.url
マスター・インスタンスのホスト、ポートを指定
管理上、ログファイル名(log.file.name)等も変更することを推奨します。
3) 各 JServ インスタンスについて、プロパティを変更し、ポートの競合を解消します。
core/admin/AsyncNotification.properties
core/admin/AsyncRequest.properties
core/adimn/Ftp.properties
core/adimn/Notification.properties
core/adimn/Rmi.properties
core/probe/www-server.properties
magent/config/MAgent.properties
4) マスター・インスタンスのためにクラスパスのコピーを作成します。
% cd $ORACLE_HOME/panama/server
% cp -r classes classes_m
5) マスター・インスタンスの Master.propterties を修正します。
% cd $ORACLE_HOME/panama/server/classes_m/oracle/pamana/master
% vi Master.properties
rmi.registry.port
マスター・インスタンスの RMI ポート
db.connect.string
リポジトリ DB の接続文字列
db.driver=V8
リポジトリ DB に接続するドライバのタイプ
ptgInstances.length
ptgInstanceX.rmi.host
同期に参加する JServ インスタンスの数
各 JServ インスタンスが稼動するホスト
ptgInstanceX.rmi.port=2001 各 JServ インスタンスの RMI ポート
ptgInstanceX.rmi.objectName CacheSyncClient(固定)
(X には、1 から ptgInstances.length まで、数値で繰り返します)
設定上の注意
−
(3)で設定する JServ インスタンスの各ポート、および(5)で設定するマスター・インスタンスの RMI
ポートには競合が発生しない様に注意して下さい。
−
各インスタンスの(2)で設定する masterInstance.url は、(5)の rmi.registory.port のポート番号の設定と一
致させてください。
−
(5)の ptgInstanceX.rmi.port には、(3)で設定する各 JServ インスタンスの Rmi.properties のポート番号と
一致させてください。
起動スクリプト
174
Oracle9i Application Server for Compaq Tru64 UNIX リリース・ノート
JServ インスタンスの起動スクリプトは『Oracle9i Application Server Wireless Edition コンフィグレーショ
ン・ガイドリリース 1.0.2.2』の 4.6.3 を参考にしてください。この例は起動スクリプトのパラメタで、以下
を切り替えている点にご留意ください。
−
クラスパスの server/classes_X にあたる個所が各 JServ インスタンス毎に異なる
−
jserv.properties の指定が各 JServ インスタンス毎に異なる
−
コンソールログファイルの指定が各 JServ インスタンス毎に異なる
---------------------------------------------------------------------------------------#!/bin/sh
JAVA12_HOME=${ORACLE_HOME}/Apache/jdk
if [ -z "$JAVA12_HOME" ]; then
test -x /usr/local/java/bin/java && JAVA12_HOME=/usr/local/java
test -x /usr/java1.1/bin/java && JAVA12_HOME=/usr/java1.1
test -x /usr/java1.2/bin/java && JAVA12_HOME=/usr/java1.2
test -x /usr/java/bin/java && JAVA12_HOME=/usr/java
else
echo "JAVA12_HOME already set." >&2
fi
test -z "${JAVA12_HOME}" && echo "Please set JAVA12_HOME first" && exit 1
echo "Running with JAVA12_HOME=¥"${JAVA12_HOME}¥"." >&2
LOGDIR=${ORACLE_HOME}/panama/logs
WELIBDIR=${ORACLE_HOME}/panama/lib
SYSLIB=${JAVA12_HOME}/lib/tools.jar
SYSLIB=${SYSLIB}:${JAVA12_HOME}/../Jserv/libexec/ApacheJServ.jar
SYSLIB=${SYSLIB}:${JAVA12_HOME}/../Jserv/libexec/dms2Server.jar
SYSLIB=${SYSLIB}:${JAVA12_HOME}/../jsdk/lib/jsdk.jar
WELIB=${WELIBDIR}/panama_core.zip
WELIB=${WELIB}:${WELIBDIR}/panama.zip
WELIB=${WELIB}:${WELIBDIR}/panama_papz.zip
WELIB=${WELIB}:${WELIBDIR}/panama_portal.zip
WELIB=${WELIB}:${WELIBDIR}/client.zip
WELIB=${WELIB}:${WELIBDIR}/server.zip
WELIB=${WELIB}:${WELIBDIR}/caboshare-opt.zip
WELIB=${WELIB}:${WELIBDIR}/marlin-opt.zip
WELIB=${WELIB}:${WELIBDIR}/ocelot-opt.zip
WELIB=${WELIB}:${WELIBDIR}/share-opt-1_1_7.zip
第１１章 Oracle9iAS Wireless
175
WELIB=${WELIB}:${WELIBDIR}/tecate-opt.zip
WELIB=${WELIB}:${WELIBDIR}/regexp.jar
WELIB=${WELIB}:${WELIBDIR}/sax2.jar
WELIB=${WELIB}:${WELIBDIR}/activation.jar
WELIB=${WELIB}:${WELIBDIR}/mail.jar
WELIB=${WELIB}:${WELIBDIR}/ldap.jar
WELIB=${WELIB}:${WELIBDIR}/ldapbp.jar
WELIB=${WELIB}:${WELIBDIR}/providerutil.jar
WELIB=${WELIB}:${WELIBDIR}/sdoapi101.jar
WELIB=${WELIB}:${WELIBDIR}/sdovis.jar
WELIB=${WELIB}:${WELIBDIR}/jai_core.jar
WELIB=${WELIB}:${WELIBDIR}/jpeg_codec.jar
WELIB=${WELIB}:${WELIBDIR}/ordimimg.jar
WELIB=${WELIB}:${WELIBDIR}/jservlet.jar
WELIB=${WELIB}:${WELIBDIR}/MapQuestX.jar
WELIB=${WELIB}:${WELIBDIR}/pop3.jar
WELIB=${WELIB}:${WELIBDIR}/RoutingJServerClient.jar
WELIB=${WELIB}:${WELIBDIR}/swingall.jar
WELIB=${WELIB}:${WELIBDIR}/jewt-opt-4_0_14.zip
WELIB=${WELIB}:${WELIBDIR}/jndi.jar
WELIB=${WELIB}:${ORACLE_HOME}/jdbc/lib/classes12.zip
WELIB=${WELIB}:${ORACLE_HOME}/jsp/lib/ojsp.jar
WELIB=${WELIB}:${ORACLE_HOME}/lib/xmlparserv2.jar
NLS_LANG=japanese_japan.utf8
export NLS_LANG
${JAVA12_HOME}/bin/java -classpath .:${SYSLIB}:${ORACLE_HOME}/panama/server/classes$1:${WELIB}
org.apache.jserv.JServ ${ORACLE_HOME}/Apache/Jserv/etc/jserv$1.properties > $LOGDIR/instance$1.log
----------------------------------------------------------------------------------------
マスター・インスタンスの起動スクリプトは、$ORACLE_HOME/panama/sample/rumMasterserver.sh を参考
にして下さい。ただし起動する Java クラス名は以下の様に修正してください。
誤 oracle.panama.MasterServer
正 oracle.panama.master.MasterServer
---------------------------------------------------------------------------------------#!/bin/sh
JAVA12_HOME=${ORACLE_HOME}/Apache/jdk
if [ -z "$JAVA12_HOME" ]; then
176
Oracle9i Application Server for Compaq Tru64 UNIX リリース・ノート
test -x /usr/local/java/bin/java && JAVA12_HOME=/usr/local/java
test -x /usr/java1.1/bin/java && JAVA12_HOME=/usr/java1.1
test -x /usr/java1.2/bin/java && JAVA12_HOME=/usr/java1.2
test -x /usr/java/bin/java && JAVA12_HOME=/usr/java
else
echo "JAVA12_HOME already set." >&2
fi
test -z "${JAVA12_HOME}" && echo "Please set JAVA12_HOME first" && exit 1
echo "Running with JAVA12_HOME=¥"${JAVA12_HOME}¥"." >&2
WELIBDIR=${ORACLE_HOME}/panama/lib
SYSLIB=${JAVA12_HOME}/lib/tools.jar:${JAVA12_HOME}/jre/lib/rt.jar
WELIB=${WELIBDIR}/panama_core.zip
WELIB=${WELIB}:${WELIBDIR}/panama.zip
WELIB=${WELIB}:${WELIBDIR}/xmlparserv2.jar
WELIB=${WELIB}:${ORACLE_HOME}/lib/servlet.jar
WELIB=${WELIB}:${ORACLE_HOME}/Apache/BC4J/lib/jndi.jar
WELIB=${WELIB}:${ORACLE_HOME}/jdbc/lib/classes12.zip
NLS_LANG=japanese_japan.utf8
export NLS_LANG
${JAVA12_HOME}/bin/java -classpath .:${ORACLE_HOME}/panama/server/classes_m:${SYSLIB}:${WELIB}
oracle.panama.master.MasterServer
----------------------------------------------------------------------------------------
既知の制限事項と制約事項
JDBC ドライバ
Oracle9iAS Wireless の今回のリリースでは、classes12.zip の JDBC ドライバのみサポートしています。
classes11.zip は、現在はサポートしていません。
ブートストラップ・リポジトリの
ブートストラップ・リポジトリの Provisioning Service
ブートストラップ・リポジトリの Provisioning Service を使用するには、まず、マスター・サービスの入力
パラメータで「User Customizable」をチェックする必要があります。
第１１章 Oracle9iAS Wireless
177
位置情報サービス
本バージョンでは、位置情報サービスの機能は、サポートしていません。位置情報サービスに関係するア
ダプタは以下のものがあります。
ジオコーディング・アダプタ
ルーティング・アダプタ
イエロー・ページ・アダプタ
ロケーション・ベース・サービス・アダプタ
また、Region Modeling Tool もサポートされません。
メール・アダプタ
メール・アダプタについては、以下の機能は使用できません。
マルチバイト・キャラクタを含んだメールの送信
マルチパート・メッセージの読み込み
メール・アダプタからのメールのヘッダ情報に日本標準時間以外が設定されている
メール・アダプタからのメールのヘッダ情報の Date フィールドに以下のような書式で日付が設定されてい
ますが、日本標準時間以外が設定されている場合があります。
Thu, 16 Aug 2001 02:26:29 -0700 (PDT)
この例の場合 PDT(Pacific Daylight Time)が設定されてますので日本標準時間との時差 16 時間を加算して読
んでください。PST(Pacific Standard Time)の場合は日本標準時間との時差 17 時間を加算して読んでくださ
い。
メール・アダプタのローカライゼーションの注意事項
メール・アダプタのローカライゼーションの際に JavaMail.PASSWRD パラメータを翻訳してしまうとメー
ル・サーバーへのログインページで入力したパスワードがそのまま表示されてしまいます。
Web Integration アダプタの文字コード設定
Web Integration アダプタのサービスで使用するソースの文字コードに合わせて Input Encoding に文字コード
を入力してください。詳細は「Oracle9iAS Wireless Web Integration Server でマルチバイト・キャラクタ・セ
ットをサポートするための設定」を参照してください。
SQL アダプタ・マスター・サービス
マスター・サービスの PL/SQL コードでは、数字の入力パラメータ名は使用できません。また、ユーザー
名およびパスワードを指定する JDBC 接続文字列は使用できません。たとえば、次のように指定すること
はできません。
jdbc:oracle:thin:user/password@hostname:port:sid
接続文字列情報は、次の形式にする必要があります 。
jdbc:oracle:thin:@hostname:port:sid
ユーザー名およびパスワードは、Service Designer の「User Name」および「Password」フィールドで指定す
る必要があります。
178
Oracle9i Application Server for Compaq Tru64 UNIX リリース・ノート
SQL アダプタを使用した半角カナデータの取得について
SQL アダプタを使用してデータベースから半角カナのデータを取り出す場合に正常にデータが取り出せな
いことがあります。これは JDBC ドライバの制限によるものです。
SQL アダプタの出力結果のキャプション
SQL アダプタの Output parameters の caption の変更が SQL アダプタのサービス実行結果に反映されません。
SQL アダプタの実行結果で列の名前に caption を設定する場合には、下記のように元となる SQL 文の列に
対して別名を設定してください。
例：select sysdate 日付 from dual
URL アダプタの文字コード設定について
URL アダプタで言語エンコーディングに関する問題に対処するために、Input_Encoding パラメータが追加
され、リモートの XML ページのキャラクタ・セットを指定可能になりました。これにより、Shift_JIS お
よび EUC の文字コードを判別可能です。
ストリッパ・アダプタにおける文字コード設定
ストリッパ・アダプタで言語エンコーディングに関する問題に対処するために、Input_Encoding パラメータ
が追加され、リモートの HTML ページのキャラクタ・セットを指定可能になりました。これにより、Shift_JIS
および EUC の文字コードを判別可能です。
ストリッパ・アダプタの外部サイトへのアクセス
本バージョンではプロキシサーバを使用してアクセスした外部サイトへのストリッパ・アダプタの使用は
サポートされません。プロキシサーバを使用しないでアクセス可能なサイトのみストリッパ・アダプタの
使用をサポートします。
LDAP アダプタのログオンについて
本バージョンでは LDAP アダプタを使用して LDAP サーバーにログオンできるのはユーザー名、パスワー
ドを必要としない Anonymous ユーザーのみとなります。ユーザー名、パスワードが必要とされるユーザー
が LDAP アダプタを通じて LDAP サーバーにログオンすることはサポートされません。
LDAP アダプタの日本語使用について
下記の部分では日本語使用はサポートされません。
LDAP アダプタサービスのエイリアス名、フォルダ名
問い合わせ文字列での「問い合わせ名」（例：
"EmployeeQuery[Filter=(cn.Name=?);SearchBase=;SearchScope=SUBTREE;ResultList=cn.CommonName]"
という問い合わせ文字列の場合、"EmployeeQuery"の部分を日本語にして使用することはできません。
ここで"Name","CommonName"には日本語を使用できます。）
Servlet アダプタの未サポートについて
本バージョンでは Servlet アダプタの使用はサポートされません。URL から目的の Servlet が実行できるよ
うに HTTP Server の構成を変更するなどして、Servlet アダプタを使用する代わりに URL アダプタを使用し
てください。
第１１章 Oracle9iAS Wireless
179
トランスフォーマ
HDML 、TINY_HTML および WML1.1 トランスフォーマは変更されました。デフォルトでは、これらの変
更後のトランスフォーマはリポジトリにロードされません。トランスフォーマをご自分で変更していない
場合、up11-111.xml をアップロードします。
1.
LoadXML ユーティリティ（up11-111.xml とともに、upload.sh を使用可能）を使用して新しいトラン
スフォーマをアップロードします。upload.sh スクリプト・ファイルは、ORACLE_HOME 内の
panama/sample に存在します。$ORACLE_HOME/panama/sample ディレクトリに移動し、次を実行し
ます。
prompt> upload.sh up11-111.xml
これらのトランスフォーマに変更を加えた場合、次の作業を実行します。
1.
相違点をマージします。
2.
LoadXML ユーティリティ（up11-111.xml とともに、upload.sh を使用可能）を使用して新しいトラン
スフォーマをアップロードします。upload.sh スクリプト・ファイルは、ORACLE_HOME 内の
panama/sample に存在します。$ORACLE_HOME/panama/sample ディレクトリに移動し、次を実行し
ます。
prompt> upload.sh up11-111.xml
LoadXML ユーティリティの詳細は、『Oracle9i Application Server Wireless Edition コンフィギュレーショ
ン・ガイド リリース 1.0.2.2』を参照してください。
Compact HTML トランスフォーマのサポートについて
標準で提供している Compact HTML トランスフォーマには、以下のような制限があります。
標準で提供している Compact HTML トランスフォーマの現在の仕様では、アクセスキーはサポートし
ていません。対応する場合は、カスタマイズが必要です。
Panasonic 製の端末の場合、うまく表示できない問題が確認されています。対応する場合は、カスタマ
イズが必要です。
なお、Compact HTML トランスフォーマは、i モード対応携帯電話およびドット i 対応 PHS が対象となりま
す。
HDML トランスフォーマのサポートについて
標準で提供している HDML トランスフォーマには、以下のような制限があります。
標準で提供している MML トランスフォーマの現在の仕様では、mailto を利用したメール送信機能は
サポートされていません。対応する場合は、カスタマイズが必要です。
インストール直後の Encoding 指定は、UTF-8 になっています。日本で使用する際には、このパラメー
タの指定を Shift_JIS に変更する必要があります。設定変更方法は、「KDDI au/Tu-Ka EZweb 用ロジカ
ル・デバイスの設定事項」を参照してください。
なお、HDML トランスフォーマは、EZweb 対応携帯電話を対象としています。
KDDI au/Tu-Ka EZweb 用ロジカル・デバイスの設定事項
KDDI au/Tu-Ka EZweb 用ロジカル・デバイスの設定事項は、次のとおりです。
180
1.
Oracle9iAS Wireless Service Designer を起動し、リポジトリ・データベースに接続します。
2.
使用するロジカル・デバイスを HDML に指定してください。
3.
Oracle9iAS Wireless サーバーの
$ORACLE_HOME/panama/server/classes/oracle/panama/core/Xform/Useragent.properties を編集します。
4.
Oracle9iAS Wireless Service Designer で、指定したロジカル・デバイスにある Encodeing パラメータを
Shift_JIS に設定してください。
Oracle9i Application Server for Compaq Tru64 UNIX リリース・ノート
SMS への対応
日本仕様の SMS(ショート・メッセージ・サービス)には対応していません。
プッシュ型通知機能(アラート
プッシュ型通知機能 アラート)
アラート
本機能を使用するにあたり、その注意事項を以下に記述します。
インターネットメール・サーバー(SMTP サーバーもしくはデーモン)が必要です。
Oracle9iAS Wireless のプッシュ型通知機能（AQ Daemon プロセス）を使用する場合、あるジョブでエ
ラーが発生して停止されると、そのジョブはジョブ・キューから削除されます。ジョブを継続して使
用するには、エラーを修正し、ジョブをスケジュールしなおしてください。
エンド・ユーザーが Personalization Portal からメールアドレスを設定する場合、指定するメールアド
レスを"<",">"で囲む必要がある場合があります。これは使用する SMTP サーバーによるものです。
アラート機能でメールの件名に日本語文字列を使用する場合は、JIS でエンコードした文字列をさらに
MIME64 フォーマットでエンコードしてから、Notification.properties の mail.subject に下記のように記
述してください。
mail.subject="=?ISO-2022-JP?B?<String>?="
ここで<String>はエンコードした文字列に置き換えてください。
プッシュ型通知機能(アラート
プッシュ型通知機能 アラート)の作成について
アラート の作成について
デバイス(ptg/rm)からのアラート作成は、デバイス(ptg/rm)->PAPZ->アラートを作成するサービス->Create
Alert でアラートのエントリを作成して、デバイス(ptg/rm)->PAPZ->作成したアラート
->Schedule->Frequency/Time to Run で頻度と開始時間を設定することでアラートの作成が完了します。ただ
し、Frequency、Time to Run ともに再度設定画面を表示しても現在の設定値は表示されませんので確認する
事はできません。
また、デバイスから作成したアラートを変更する場合、エントリのみが作成されているアラートを
portal/Login.jsp から編集をしようとすると以下のようなエラーとなります。
Error Message
The following error while loading the page:
An unexpected error happened, please contact the administrator. There might be
some setup problems.
ptg/rm からのアラートアドレスの変更が正常に行われない
(ptg/rm->)PAPZ->サービス->アラート->Address->アドレス一覧からアドレスの選択もしくは Create New
Address を選択する方法はサポートされていません。実行すると以下のようなエラーとなります。
Not implemented yet
アドレスの変更や新規アドレスの作成をしたい場合は、(ptg/rm->)PAPZ->User Profile->Alert Address->アド
レス選択もしくは Add を選択して行ってください。
詳細は、『Oracle9i Application ServerWireless Edition インプリメンテーション・ガイド リリース 1.0.2.1』
を参照してください。
アラート作成時のアラートアドレスのデフォルト表示について
アラート・アドレスを複数登録している場合、アラート作成時に表示されるデフォルトアドレスとデフォ
ルトに指定しているアドレスが異なります。デフォルトの指定は無効となり、アラート作成時にデフォル
ト表示されるのはアドレス編集ページで表示される一覧の一番上に表示されているアドレスとなります。
）からのアラートアドレス作成で
デバイス（ブラウザ、DoCoMo）
からのアラートアドレス作成で EMAIL を選択しても、
第１１章 Oracle9iAS Wireless
181
再度ページを表示すると SMS になってしまう
アラートアドレス作成時に EMAIL を選択してもアラートアドレスのページを開くと SMS が選択されてい
るような状態で表示されてしまいます。
portal/Login.jsp から確認すると正しく EMAIL が選択されています。
デバイス（UP.SDK、
、J-PHONE）からのアラートアドレス割り当てで
）からのアラートアドレス割り当てで EMAIL を選択し
デバイス（
ても、再度ページを表示すると空になってしまう
アラートアドレス作成時に EMAIL を選択してもアラートアドレスのページを開くと何も選択されていな
い状態で表示されてしまいます。portal/Login.jsp から確認すると正しく EMAIL が選択されています。
アラートメールのヘッダ情報に日本標準時間以外が設定されている場合がある
アラートメールのヘッダ情報の Date フィールドに以下のような書式で日付が設定されていますが、日本標
準時間以外が設定されている場合があります。
Thu, 16 Aug 2001 02:26:29 -0600 (MDT)
この例の場合 MDT(Mountain Daylight Time)が設定されてますので日本標準時間との時差 15 時間を加算し
て読んでください。
プッシュ型通知機能(アラート
プッシュ型通知機能 アラート)の開始時刻が
アラート の開始時刻が 13 時間遅れて表示される
ブラウザ(portal/Login.jsp)からのアラートの作成時に表示される Alert Starts At の時刻（デフォルトは現在時
刻）が約 13 時間遅れて表示されます。（新規作成時のみ）
回避策：jserv.properties ファイルに以下の定義を追加します。
wrapper.env=TZ=JST-9
デバッグ
サービスの Input parameter に PAdebug パラメータとその value を"1"で指定してもブラウザやデバイスなど
からサービスを実行した場合にデバッグ・モードで出力されません。デバッグの機能を有効にするために
は、サービス実行時に URL の末尾に&PAdebug=1 を追加してください。
また、デバッグを有効にするためには、現在のセッションのログイン・ユーザーは、Designer 権限または
Administrator 権限をもつ必要があります。Designer 権限または Administrator 権限の付与については、
『Oracle9i Application ServerWireless Edition インプリメンテーション・ガイド リリース 1.0.2.1』を参照し
てください 。
Oracle9iAS Wireless Web Integration Server の Shutdown でエラーが発生する
Netscape Navigator 4.x を使用して、Oracle9iAS Wireless Web Integration Server のシャットダウン操作を行う
と、Oracle9iAS Wireless Web Integration Server のシャットダウンは行われますがブラウザにエラーが表示さ
れることがあります。この問題は、Microsoft Internet Explore では発生しておりませんので、こちらを使用
することをお奨めします。
Oracle9iAS Wireless Web Integration Developer：起動時の
：起動時の Java エラー
JDK1.2.2 を使用して Oracle9iAS Wireless Web Integration Developer を起動するとコマンドプロンプト上に下
記のエラーが発生します。
Error loading L&F: java.lang.ClassCastException:
com.sun.java.swing.plaf.windows.WindowsLookAndFeel
これは JDK1.1.x と 1.2.x の仕様の違いにより起こるエラーです。
Oracle9iAS Wireless Web Integration Developer の外観が JDK1.1.x を使用した場合と異なる場合があります。
182
Oracle9i Application Server for Compaq Tru64 UNIX リリース・ノート
Oracle9iAS Wireless Web Integration Developer：文字入力時の注意
：文字入力時の注意
設定を反映させるためには、[Enter]キーを押下して入力する必要があります。[Enter]キーを押下しない場合、
その内容は確定しません。
Oracle9iAS Wireless Web Integration Developer：
：WIDL 作成時における日本語使用
WIDL 生成時、またはサービスのテスト時に入力が要求される値に日本語が含まれる場合、検索処理など
が正常に行われません。
Oracle9iAS Wireless Web Integration Developer：日本語変数名の使用について
：日本語変数名の使用について
Oracle9iAS Wireless WebIntegration Developer で使用するローカル変数名に日本語を使用することはできま
せん。Oracle9iAS Wireless Service Designer でサービスを作成する際に内部変数のキャプションに日本語を
使用できますが、Oracle9iAS Wireless WebIntegration Developer でローカル変数を作成する時に、キャプショ
ンに変換されるのを見越してあらかじめ日本語で変数名をつけると Oracle9iAS Wireless Web Integration
Developer 上では問題ありませんが Oracle9iAS Wireless Service Designer に取り込んだ時に文字化けします。
Oracle9iAS Wireless Web Integration Developer：正規表現の未サポートについて
：正規表現の未サポートについて
Oracle9iAS Wireless Web Integration Developer を使用して、正規表現を用いたサービスを作成することはサ
ポートされません。
Oracle9iAS Wireless Web Integration Server：正規表現の未サポートについて
：正規表現の未サポートについて
Oracle9iAS Wireless Web Integration Server に正規表現を使用した WIDL を登録し、動作させることはサポー
トされません。
Oracle9iAS Wireless Service Designer：文字コード設定
：文字コード設定
Oracle9iAS Wireless Service Designer では各ロジカル・デバイスの文字コードが設定できます。また、アダ
プタによっては Input Parameter に文字コード設定ができるものがあります。これらの文字コード名を指定
する際には Encoding.properties に記述されている IANA 対応の文字コード名を指定してください。
例：Shift_JIS に設定する場合は Shift_JIS と指定します(JAVA の文字コード名である SJIS ではありません)。
Oracle9iAS Wireless Service Designer：
：EMAIL ロジカル・デバイスの文字コード
日本語環境で使用する場合は、EMAIL ロジカル・デバイスの文字コードを iso-2022-jp にすることを推奨し
ます。
Oracle9iAS Wireless Service Designer：テスト・ウィザード
：テスト・ウィザード
Oracle9iAS Wireless Service Designer 内のテスト・ウィザードを使用するには、Designer ロールが存在する
必要があります。存在しない場合、サービスのテスト時に、デバイスの結果のみ表示されます。
Oracle9iAS Wireless Service Designer：
：Transformer Testing Tool
Windows NT で Service Pack 6 を使用している場合、Transformer Testing Tool の実行時に、次のエラーが発生
する可能性があります。
java.net.SocketException: JVM_SetSockOpt() TCP_NODELAY (code=10055)
この問題を解決するには、マイクロソフト社の Web サイトから Service Pack 6a を入手して適用します。
Service Pack 6a をインストールしてもこの問題が解決されない場合、Service Pack 6a を再インストールしま
す。これでも問題が解決されない場合、現在の Windows NT ユーザーを「Administrators」グループに追加
してください。
第１１章 Oracle9iAS Wireless
183
Oracle9iAS Wireless Service Designer：
：Transformer Testing Tool でのエラー
Transformer Testing Tool ではサービスのテスト時にエラーが発生する場合があります。この場合は
Oracle9iAS Wireless Service Designer を再起動してください。
Oracle9iAS Wireless Service Designer：
：Transformer Testing Tool における実行
URI
Transformer Testing Tool ではサービス実行時に Oracle9iAS Wireless サーバーへの接続情報を入力するダイア
ログが表示されます。ここで Server URI に正しいポート番号、アクセスポイントが指定されていないと、
下記のようなエラーが発生します。
java.net.ConnectException: Connection refused: no further information
このエラーが発生した場合は Server URI を入力した後に再度サービスを実行してください。
Oracle9iAS Wireless Service Designer：
：Transformer Testing Tool でのサービスの
テストで文字化けが発生する
Transformer Testing Tool での実行結果に日本語が含まれている場合、文字化けが発生します。
Oracle9iAS Wireless Service Designer：フォルダ内容の表示
：フォルダ内容の表示
Oracle9i Application Server リリース 1.0.2.2 では、Oracle9iAS Wireless Service Designer のナビゲーション・ツ
リーに表示されるオブジェクト数を制限することが可能です。この機能を使用するには、ptgsd.properties
ファイルを編集し、表示するオブジェクト数を設定します。
Oracle9iAS Wireless Service Designer：エイリアス作成ウィザード
：エイリアス作成ウィザード
Oracle9iAS Wireless Service Designer でエイリアス作成時に 2 枚目のダイアログで Input parameters が空白に
なっています。エイリアスの Input parameters は、エイリアスを一旦作成してから設定するようにしてくだ
さい。
Oracle9iAS Wireless Service Designer：
：XSLT エディタでの日本語入力
Oracle9iAS Wireless Service Designer で、トランスフォーマを編集する XSL エディタでは日本語が正しく入
力されません。日本語を入力し変更を適用すると「???」という文字列になります。XSL エディタでは日本
語を使用しないでください。
Oracle9iAS Wireless Service Designer：追加された新規の検索
：追加された新規の検索/ソート機能
：追加された新規の検索 ソート機能
「Master Services」ノードまたはフォルダ・ノードで右クリックすると、「Search/Sort」コマンドが表示さ
れます。サービス名（大・小文字の区別あり）の検索が可能で、ワイルド・カード（'%' など）も使用可能
です。検索結果は、名前、最終更新日付または順序番号によってソート可能です。多数のサービスをロー
ドする場合、この新しい検索機能が効果的です。検索結果は、フォルダの新しい子ノードとして表示され、
自動的にノードが展開されます。フォルダを縮小表示してから再び展開すると、デフォルトで、すべての
子がロードされます。いずれの場合も、結果セットが大きすぎ、ptgsd.properties の上限サイズを超えた場合、
警告が表示され、結果セットの一部のみロードされます。この結果、必要なサービスが表示されなかった
場合、検索条件を絞り込んで検索を再実行する必要があります。
Oracle9iAS Wireless Service Designer：
：Disp.Name に半角かなを使用しているユー
ザ名が登録されているとユーザー検索で全くヒットしない
ザ名が登録されているとユーザー検索で全くヒットしない
Oracle9iAS Wireless Service Designer 上でユーザーの検索を行う場合、ユーザーの表示名称(Disp.Name)に半
角かなが含まれているものが登録されていると表示名称(Disp.Name)での検索が正常に行なわれません。
184
Oracle9i Application Server for Compaq Tru64 UNIX リリース・ノート
Oracle9iAS Wireless Service Designer：ロジカルデバイス→
：ロジカルデバイス→PAPZ
エンコーディング
：ロジカルデバイス→
を SJIS に変更すると HTML ソースが壊れてタグが表示されてしまう
Internet Explorer を使用している場合、Service Designer より Logical Devices→PAPZ をクリックし General タ
ブの Encoding を Shift_JIS に設定し、全角ハイフン１文字のみの名称が含まれるページを表示するとページ
の最下段に"</html"と表示されます。
Oracle9iAS Wireless Service Designer：大きな
：大きな XML ファイルのロード・エラー
一部の XML スタイルシート（特に大きなファイルの場合）が Oracle9iAS Wireless Service Designer からロ
ードされる場合に破損するという問題が明らかになっています。これは、XML パーサーによるものです。
この問題はロードするファイルを分割することで回避することができます。
Oracle9iAS Wireless Service Designer：
：Master Service Creation Wizard : Name フ
ィールドに１文字の文字列が使用できない
Master Service Creation Wizard でサービスを作成する際のサービス名の入力で 1 文字のみのサービス名を指
定する場合、「Next」ボタンが有効にならない場合があります。たとえば「Create New Service Folder」を
実行した場合、「Creating Folder」画面の「Select a parent folder」セクションで親フォルダを選択して「Next」
ボタンをクリックする際、Name フィールドに入力する文字列が１文字の場合次ページへ遷移するための
「Next」ボタンが有効になりません。この問題を回避するためには、２文字以上の文字列を設定するか、
１文字のみのサービス名を指定する場合は２文字以上入力しバックスペースキーを使用して 1 文字にして
ください。
例)
'a'というサービス名にしたい場合、'aa[BS]'と入力し'a'としてください。
'あ'というサービス名にしたい場合、'ああ[BS]'と入力し'あ'としてください。
なお、上記の例の操作は、『Oracle9i Application Server Wireless Edition インプリメンテーション・ガイド リ
リース 1.0.2.1 』「9.3.1 作業 1:Master Service Creation Wizard の使用」の項番 3. a の操作にあたります。
Personalization Portal：
：PAPZ ベースの Personalization Portal のサポート
Oracle9iAS Wireless 1.1 より前にリリースされた PAPZ ベースの Personalization Portal は、
Oracle9i Application
Server リリース 1.0.2.2 では正式に推奨から外され、
次期リリースでは、
完全にサポート対象外となります。
ポータル・ベースの Personalization Portal の使用を推奨します。次期リリースでは、これが唯一のサポート
対象の Personalization Portal となります。
Personalization Portal:ログイン後の画面で
ログイン後の画面で HELP を参照できない
Personalization Portal にログイン後の画面で HELP を参照することができません。参照するためには以下の
手順で設定を変更してください。
1.
httpd.conf の Alias を ptgdoc から ptg-doc へ変更します。
2.
$ORACLE_HOME/panama/doc/javadoc/index.html のファイル名を index.htm へ変更します。
Personalization Portal：ブックマーク
：ブックマーク
Personalization Portal でブックマークを作成する際、URL に http://という接頭辞を含める必要があります。
たとえば、次のようになります。
http://domain_name.com
第１１章 Oracle9iAS Wireless
185
Personalization Portal：イメージの表示
：イメージの表示
Personalization Portal でイメージを正しく表示するには、jserv.properties ファイルの DISPLAY 環境変数を正
しく設定し、サーバーが稼動するホストへのアクセスを設定する必要があります。X サーバーが Oracle9iAS
Wireless サーバーと同じマシンで稼動している場合、jserv.properties ファイルの DISPLAY 環境変数はイン
ストール時に次のように設定されます。
wrapper.env=DISPLAY=localhost:0.0
X サーバーのホスト・マシン（次の例では x_server_host_name ）から、次のコマンドを実行します。
prompt>xhost + <x_server_host_name>
X サーバーが Oracle9iAS Wireless サーバーとは異なるマシンで稼動している場合（次の例では
x_server_host_name）、jserv.properties ファイルの DISPLAY 環境変数を次のように設定します。
wrapper.env=DISPLAY=<x_server_host_name>:0.0
X サーバーのホスト・マシンから、Oracle9iAS Wireless のホスト（次の例では wireless_edition_host_name）
を使用して、次のコマンドを実行します。
prompt>xhost + <wireless_edition_host_name>
どちらの場合も、xhost コマンドの実行中は、コンソールにログインしたままにします。ログオフすると、
xhost コマンドによって設定されたプロパティが失われ、イメージが Personalization Portal で正しく表示され
ない可能性があります。
Personalization Portal：アラート・アドレスの一意制約違反
：アラート・アドレスの一意制約違反
アラート・アドレスのアドレス（E-mail アドレスなど）はリポジトリ内で一意である必要があります。つ
まり、他のユーザーと同じアドレスでは作成できません。作成しようとすると下記のようなエラーが発生
します。
java.sql.SQLException: ORA-00001: (PANAMA.AGENT_ADDRESS)
Personalization Portal：マスター・サービスでのアラート
：マスター・サービスでのアラート
マスター・サービスに対してアラートは作成できません。アラートはサービスのエイリアスに対してのみ
作成できます。
Personalization Portal：サービス実行時の権限
：サービス実行時の権限
Administrator 権限を持つユーザーが所有するサービスを実行するユーザーは Administrator 権限を持つ必要
があります。サービスを実行するユーザーが適切な権限を持っていない場合、サービスが正しく実行され
ません（例えば実行時に画面に「submit」のみが表示されます）。
Personalization Portal：
：LocalStrings.properties の翻訳後のイメージ表示
$ORACLE_HOME/panama/server/classes/oracle/panama/webui/LocalString.properties に記述されている文字列
を日本語に翻訳した場合、ブラウザから表示される Personalization Portal でボタンやタブのイメージが正し
く表示されません。この場合、ボタンやタブに当たる文字列には英語を使用するようにしてください。
Personalization Portal：オブジェクトの順序変更で
：オブジェクトの順序変更で JAVA エラーが発生することがあ
る
オブジェクトの順序変更を行っているときに下記のようなエラーが発生することが極まれにあります。
java.sql.SQLException:ORA-01000:最大オープンカーソル数を超えました。ORA-06512:行 1
対処方法としては、サービスデザイナーを再起動して操作をやり直す必要があります。
186
Oracle9i Application Server for Compaq Tru64 UNIX リリース・ノート
Personalization Portal：フォルダの削除で
：フォルダの削除で JAVA エラーが発生することがある
フォルダの削除を行っているときに下記のようなエラーが発生することが極まれにあります。
java.sql.SQLException:ORA-01000:最大オープンカーソル数を超えました。ORA-06512:行 1
このエラーが発生した場合は、再度、操作をやりなおしてください。
Personalization Portal：サービスのコピーでコピー先のフォルダが
：サービスのコピーでコピー先のフォルダが'−
全角ハイフン)
：サービスのコピーでコピー先のフォルダが −'(全角ハイフン
全角ハイフン
という名称だとコピーに失敗する
サービスのコピーを実行する際に、名称が全角ハイフン１文字のフォルダをコピー先のフォルダに指定す
るとエラーは表示されませんがコピーは失敗します。
LocalStrings.properties の翻訳
メール・アダプタや Personalization Portal など、いくつかのインターフェースは、ResourceBundle を使用し
て LocalString.properties ファイルを読み込んでいます。これらを翻訳する場合には、以下の手順で行ってく
ださい。
1.
ユーザーのロケールに応じて、適切なファイル名にコピーする。
例) 日本語のユーザー用：LocalStrings_ja.properties
2.
コピーした LocalString_XX_XX.properties を翻訳する。
3.
JDK1.2.2 のコマンドの native2ascii などを利用して文字列を必ず UNICODE 形式に変換する。
各 LocalString.properties ファイルのパスは、『Oracle9i Application Server Wireless Edition コンフィギュレー
ション・ガイド リリース 1.0.2.2』の 6 章を参照してください。
SystemLog.enableServiceLogging パラメータについて
System.properties ファイルのパラメータ SystemLog.enableServiceLogging または
SystemLog.enableSessionLogging をコメントアウトや削除した場合は Oracle9iAS Wireless の機能が正しく動
作しません。値の省略はサポートされていません。必ず TRUE または FALSE を設定してください。
sys_panama.log ファイルのタイムスタンプが 13 時間遅れている
sys_panama.log に出力されるログ情報のタイムスタンプが実際の時間よりも約 13 時間遅れています。
回避策：jserv.properties ファイルに以下の定義を追加します。
wrapper.env=TZ=JST-9
第１１章 Oracle9iAS Wireless
187
第１２章 Edge Side Includes の JESI タグ
この章では、OracleJSP で提供される JESI（Edge Side Includes for Java）のタグ・ライブラリについて説明し
ます。これらのタグは Edge Side Includes（ESI）フレームワークを包括し、JSP アプリケーションの ESI キ
ャッシング機能を提供します。
この章には、次のトピックが含まれています。
Edge Side Includes テクノロジおよび処理の概要
JESI 機能の概要
OracleJSP JESI タグの説明
Edge Side Includes テクノロジおよび処理の概要
この項では、OracleJSP JESI タグの基礎となる基本的なテクノロジの一部についてのバックグラウンド情報
を提供します。
JSP ページの動的コンテンツをキャッシュ可能なコンポーネントに分割する JESI タグは、
Edge Side Includes
アーキテクチャおよび ESI マークアップ言語に基づいています。
JESI タグの仕様は特定の ESI プロセッサまたはキャッシング・システムに依存しているわけではありませ
んが、ほとんどの OracleJSP 顧客は Oracle9iAS Web Cache およびその ESI プロセッサを使用するものとみ
なしてよいでしょう。
この項では、次のトピックを説明します。
Edge Side Includes テクノロジ
Oracle9iAS Web Cache および ESI プロセッサ
ここでは ESI アーキテクチャと言語の簡単な概要についてのみ説明します。ESI テクノロジの詳細は、次の
Web サイトを参照してください。
http://www.edge-delivery.org
Edge Side Includes テクノロジ
この項では、ESI テクノロジの特長および ESI"サロゲート"（代理）の概念について紹介します。
ESI の概要
Edge Side Includes は XML 形式のマークアップ言語で、元の Web サーバーから離れた場所（ネットワーク
の"エッジ"）での動的コンテンツの組立てを可能にします。また、Web キャッシュや Content Delivery
Networks（CDN）など使用可能なツールの利点を活用して、エンド・ユーザーへのパフォーマンスを向上
することを目的として設計されています。
ESI では、ESI 言語を認識し、Web サーバーの代理で動作する、サロゲートまたはリバース・プロキシと呼
ばれる中間サーバーの利用を促進することで、Web サーバーおよびアプリケーション・サーバーのロード
を削減します。ESI コンテンツの処理は、コンテンツが元の Web サーバーを離れてエンド・ユーザーのブ
ラウザに表示されるまでの間に行われます。サロゲートは HTTP ヘッダーを介して指令を受けます。この
ようなサロゲートを"ESI プロセッサ"と呼び、Web キャッシュ機能の一部として含めることが可能です。
ESI では部分ページ・キャッシングの方法論が採用されており、Web ページの各動的部分を個別にキャッ
シュし、適切に抽出できるようにします。
ESI マークアップ・タグを使用すると、開発者は集計 Web ページおよびキャッシュ可能コンポーネントを
定義することができ、ESI プロセッサは必要に応じて HTTP クライアントでの表示用にこれらの抽出および
組立てを行います。エンド・ユーザーが指定する URL に関連付けられたリソースである集計ページは、ESI
タグで指定される抽出および組立て指示を含む組立コンテナと考えることができます。
188
Oracle9i Application Server for Compaq Tru64 UNIX リリース・ノート
注意: JESI ユーザーは、ESI タグを直接使用する必要がない（また通常は使用しようとしない）ことに注
意してください。JESI タグ・ハンドラが JESI タグを ESI タグに変換します。
サロゲートについて
サロゲートはページ・コンテンツが保持される Web サーバーの代理として動作するため、コンテンツ所有
者は動作を十分に制御できます。このようにして、他の方法では実現できないパフォーマンス向上の大き
な可能性が提供されます。
サロゲートのキャッシング・プロセスは、一般的な HTTP のキャッシング・プロセスと同様のフレッシュ
および検証メカニズムをベースに動作します。ただし、サロゲートには別の制御メカニズムが追加されて
います。
主要な ESI 機能
ESI 言語のバージョン 1.0 には、次のような主要エリアに関する機能があります。
組込み
ESI プロセッサは、ネットワークから抽出された動的コンテンツのフラグメントを集計ページに組み
立ててユーザーに出力します。各フラグメントは、それぞれのキャッシング動作を制御する独自のメ
タデータを持ちます。
変数のサポート
ESI は、
HTTP 要求属性に基づいた変数の使用をサポートします。
ESI 文は処理中に変数を使用するか、
または処理済のマークアップに変数を直接出力することができます。
条件処理
ESI では、ページの処理方法を決定する際に条件ロジックにブール比較を使用できます。
エラー処理および代替処理
一部の ESI タグは、
プライマリ・リソースが検出できない場合は代替 Web ページなどの代替リソース、
またはデフォルト・リソース(あるいはその両方)の指定をサポートします。
Oracle9iAS Web Cache および ESI プロセッサ
この項では、Oracle9iAS Web Cache とその ESI プロセッサの概要を説明します。詳細は、Oracle9i Application
Server ドキュメンテーション・ライブラリの『Oracle9iAS Web Cache 管理および配置ガイド』を参照してく
ださい。
Oracle9iAS Web Cache の概要
オラクルでは、E-Business における Web サイトのパフォーマンスの問題解決を支援する Oracle9iAS Web
Cache を提供しています。Oracle9iAS Web Cache はコンテンツ対応サーバー・アクセラレータ、すなわちリ
バース・プロキシで、Oracle9i Application Server 上で稼働する Web サイトのパフォーマンス、スケーラビ
リティおよび可用性を改善します。
Oracle9iAS Web Cache は頻繁にアクセスされる URL をメモリに格納することで、アプリケーション・サー
バーでこれらの URL に対する要求を繰り返して処理する必要性をなくします。静的ドキュメントのみを処
理する従来のプロキシ・サーバーと異なり、Oracle9iAS Web Cache は 1 つ以上のアプリケーション Web サ
ーバーの静的コンテンツおよび動的に生成されたコンテンツの両方をキャッシュします。より頻繁なキャ
ッシュ・ヒットにより、Oracle9iAS Web Cache は従来のプロキシ以上のパフォーマンス拡張を提供し、ア
プリケーション・サーバーのロードを大幅に削減します。
概念的には、Oracle9iAS Web Cache はアプリケーション Web サーバーの前面に位置し、コンテンツをキャ
ッシングしてそのコンテンツを要求元の Web ブラウザに提供します。Web ブラウザが Web サイトにアク
セスすると、
ブラウザは HTTP プロトコルまたは HTTPS プロトコル要求を Oracle9iAS Web Cache に送信し、
Oracle9iAS Web Cache はアプリケーション Web サーバーの仮想サーバーとして機能します。要求されたコ
ンテンツが期限切れだったり、失効されたりしてアクセス不能である場合、Oracle9iAS Web Cache はアプ
第１２章 Edge Side Includes の JESI タグ
189
リケーション・サーバーから新規コンテンツを抽出します。アプリケーション・サーバーは、コンテンツ
を Oracle データベースから抽出する場合もあります。
Web Cache 使用方法のステップ
標準的なブラウザと Oracle9iAS Web Cache の対話ステップは、次のとおりです。
1.
ブラウザが企業の Web サイトに要求を送信します。
この要求は、次に Web サイトの IP アドレスに対する Domain Name System（DNS）への要求を生成し
ます。
2.
DNS は Oracle9iAS Web Cache の IP アドレスを返します。
3.
ブラウザは、Web ページに対する要求を Oracle9iAS Web Cache に送信します。
4.
要求されたコンテンツがキャッシュにある場合は、Oracle9iAS Web Cache がコンテンツを直接ブラウ
ザに送信します。これはキャッシュ・ヒットと呼ばれます。
5.
Oracle9iAS Web Cache に要求されたコンテンツがない場合、あるいはコンテンツが失効または無効で
ある場合、Web キャッシュは要求をアプリケーション・サーバーに渡します。
6.
アプリケーション・サーバーは、Oracle9iAS Web Cache を介してコンテンツを送信します。
7.
Oracle9iAS Web Cache がクライアントにコンテンツを送信し、キャッシュにページのコピーを作成し
ます。
注意:
キャッシュに格納されたページは、ページが失効または期限切れになったときに削除されます。
Oracle9iAS Web Cache ESI プロセッサ
Oracle9iAS Web Cache リリース 2.0.0.0 には、キャッシングで Edge Side Includes マークアップ言語の使用を
サポートする ESI プロセッサが含まれています。（8-2 ページ「Edge Side Includes テクノロジ」を参照。）
Oracle9iAS Web Cache 環境の Web 開発者は、アプリケーションで ESI 言語を直接使用できます。ただし、
OracleJSP 開発者からすれば、ESI 言語への便利な JSP インタフェースとして提供される JESI タグ・ライブ
ラリを使用する理由はいくつかあります。（「JESI タグを使用する理由」を参照。）
JESI 機能の概要
この項では、次のトピックを含む JESI 機能および OracleJSP 実装の概要を説明します。
JESI タグを使用する理由
OracleJSP によって実装される JESI タグの概要
JESI 使用方法モデル
ページの失効化
ページのパーソナライズ
JESI 仕様には、次の Web サイトでアクセスできます。
http://www.edge-delivery.org
JESI タグを使用する理由
OracleJSP では、ESI タグへの便利なインタフェースとして JESI タグ・ライブラリが、また Web キャッシ
ングに Edge Side Includes 機能が提供されます。開発者はオプションで ESI タグを任意の Web アプリケーシ
ョンに直接使用できますが、JESI タグは JSP 環境に利便性を提供します。ESI タグを直接使用するかわり
に JESI タグを使用する主な利点は、次のとおりです。
標準 JSP フレームワークおよび便利な機能
190
Oracle9i Application Server for Compaq Tru64 UNIX リリース・ノート
JSP ページの使用または JSP IDE 環境での作業に慣れている開発者は、JESI タグで使い慣れた便利な
JSP プログラミング機能を使用できます。たとえば、完全な URL またはファイル・パスのかわりにペ
ージ関連またはアプリケーション関連の構文に含まれるページを参照できます。
JESI ショートカット構文
JESI タグは、必要に応じて明示的にページを失効化したり、Cookie 情報を使用してページをパーソナ
ライズすることで、メタデータ情報（キャッシュされたページの有効期限など）を指定する便利な構
文およびタグ属性をサポートします。
アプリケーション・レベルの構成ファイル
JESI タグ・ライブラリは、特定の環境に合わせた配置時パラメータおよびアプリケーションのデフォ
ルト設定を便利に指定できるように、アプリケーション・レベルの構成ファイルを使用できます。こ
のようにすると、多様なニーズを持つ異なる環境での配置を行い、アプリケーション・コードを変更
せずに適切なデフォルト値を設定することができます。
たとえば、無効化要求に対するキャッシュ・サーバーURL、ユーザー名およびパスワードを事前設定する
構成ファイルを使用できます。
OracleJSP によって実装される JESI タグの概要
標準 JavaServer Pages タグ・ライブラリ実装である OracleJSP JESI タグ・ライブラリは、
OracleJSP の ojsputil.jar
ファイルに含まれています。（OracleJSP ファイルの詳細は、「ファイルの要約」を参照。）
JESI の OracleJSP 実装は、標準 ESI フレームワークの上から行われます。
JESI タグ・ライブラリは標準実装であるため、次の点に注意してください。
任意の標準 JSP 環境で使用できます。OracleJSP コンテナには依存しません。
このドキュメントでは Oracle9iAS Web Cache およびその ESI プロセッサについて特に説明しています
が、
JESI タグ・ライブラリは特定のキャッシング環境または特定の ESI プロセッサには依存しません。
OracleJSP JESI タグ・ライブラリは次のタグをサポートします。
jesi:control、jesi:include、jesi:template および jesi:fragment−ページの設定およびコンテンツ
jesi:invalidate（およびサブタグ）−キャッシュ・オブジェクトの必要に応じた明示的な無効化
jesi:personalize−ページのパーソナライズ
タグ・ライブラリには、次のものが含まれています。
これらのタグのタグ・ハンドラ・クラス
これらのタグの標準タグ・ライブラリ記述ファイル（TLD）
JSP 開発者は、対応する ESI タグ（esi:include など）のかわりにこれらのタグ（jesi:include など）を使用し
ます。この有用性と利便性については、「JESI タグを使用する理由」で前述しています。
OracleJSP JESI タグ・ライブラリは標準ライブラリです。標準 JavaServer Pages タグ・ライブラリ・フレー
ムワークの一般的な情報は、「標準タグ・ライブラリ・フレームワーク」を参照してください。
JESI 使用方法モデル
集計ページおよびそのキャッシュ可能なコンポーネントを定義するための JESI タグの使用方法モデルは、
2 つ存在します。
control/include モデル
template/fragment モデル
この項ではこれらのモデルを説明し、最後に jesi:include タグの特別な注意について説明します。
第１２章 Edge Side Includes の JESI タグ
191
control/include モデル
JESI タグ・アプローチの 1 つはモジュラー・アプローチで、通常はほとんど（あるいはすべて）のキャッ
シュ可能コンテンツをインクルードされたページとして集計ページに含めます。jesi:control タグを使用して
キャッシング・パラメータを設定し、jesi:include タグで動的コンテンツを移入します。
タグは両方ともオプションですが、状況に応じて異なります。デフォルト・キャッシュ設定が十分であれ
ば、jesi:control タグは省略できます。また、jesi:include タグなしの jesi:control タグを持つこともできます。
実際、これは既存ページを JESI で使用するために変換する最も簡単な方法です。
各インクルード・ファイルは固有のキャッシュ可能オブジェクトであり（キャッシングはタグ設定によっ
て無効な場合があります）、集計ページの追加コンテンツも固有オブジェクトとなります。
このドキュメントでは、このモジュラー・アプローチを control/include モデルと言います。新規ページを開
発する場合に特に役立つアプローチです。
注意: 集計ページの jesi:control タグはインクルード・ページに影響しません。独自の jesi:control タグのな
いインクルード・ページは、デフォルトのキャッシュ設定を使用します。
タグの構文と例については、次の項を参照してください。
「JESI control タグ」
「JESI include タグ」
「例−control/include モデル」
template/fragment モデル
もう一方の JESI タグ・アプローチはコンテンツが集計ページそれ自身であるアプローチで、ページは必要
に応じてキャッシュ可能な別個のフラグメントに分割されます。
jesi:template タグを使用して、すべてのキャッシュ可能コンテンツの集計を囲みます。このタグは集計ペー
ジのキャッシング・パラメータ（フラグメント外部のすべて）を設定します。それ以外はデフォルト設定
が使用されます。必要に応じて jesi:fragment タグを使用して、別個にキャッシュされる集計内のフラグメ
ントを定義してください。集計ページと同じように、フラグメントはキャッシング・パラメータを設定す
るか、あるいはデフォルト設定を使用できます。
オプションで、テンプレート・レベルまたはフラグメント・レベルで jesi:include タグを使用できます。
jesi:template タグおよび jesi:fragment タグは常に一緒に使用されます。ページの別個のフラグメントが必要
ない場合は、jesi:template のかわりに jesi:control を使用してください。
各フラグメントは固有のキャッシュ可能オブジェクトであり、フラグメント外部のテンプレート・レベル
の動的コンテンツは固有のキャッシュ可能オブジェクトです。
このドキュメントでは、前述のシナリオを template/fragement モデルと言います。既存ページを JESI で使用
するために変換する場合に特に便利なモデルです。
タグの構文と例については、次の項を参照してください。
「JESI template タグ」
「JESI fragment タグ」
「JESI include タグ」
「例−template/fragment モデル」
JESI include に関する注意
いずれのモデルを使用する際も、jesi:include 文について次の点に注意してください。
ネストされた"インクルード"は、独自の jesi:include 文を持つページを含む jesi:include 文として、ある
いは jesi:fragment で定義されたフラグメント内部の jesi:include 文としてサポートされます。
192
Oracle9i Application Server for Compaq Tru64 UNIX リリース・ノート
後者の場合、たとえば ESI プロセッサは集計ページのコンテンツ、フラグメントのコンテンツ、フラ
グメント内のインクルード・ページのコンテンツの順番で要求を行います。
jesi:include および jsp:include は概念的には類似していますが、JSP ページをキャッシング用に変換する
場合は jesi:include は jsp:include の完全な代替とはなりません。ESI プロセッサは別個の HTTP 要求を
使用するため、HTTP 要求または応答オブジェクトを集計ページと jesi:include タグを介してインクル
ードされるページ間で渡すことはできません。インクルード・ページのコードが集計ページの要求ま
たは応答オブジェクトにアクセスする必要がある場合は、インクルード・ページ内ではなく、
jesi:fragment タグ（集計ページの jesi:template タグ内部）にコードを配置できます。
ページの失効化
データベースの関連データに対する変更など、外的要因からキャッシュされたオブジェクトを明示的に失
効化しなければならない状況が生じることがあります。また、1 つのページを実行することで、他のページ
に対応するキャッシュ・オブジェクトのデータが失効化されることもあります。
このため、JESI 仕様では jesi:invalidate タグおよびいくつかのサブタグが用意されています。これらのタグ
を使用すると、次のような適切な組合せに基づいてページを失効化することができます。
完全 URI または URI 接頭辞
Cookie の名前と値のペア（オプション）
HTTP/1.1 要求ヘッダーの名前と値のペア（オプション）
失効化メッセージは XML ベース・フォーマットで、失効化される URL を指定します。これらのメッセー
ジは、HTTP の POST メソッドによってキャッシュ・サーバーに転送されます。その後、キャッシュ・サー
バーは失効化の応答を HTTP で返します。
タグの構文と例については、8-21 ページ「ページの失効化タグおよびサブタグの説明」を参照してくださ
い。
ページのパーソナライズ
動的 Web ページは、ユーザーそれぞれに合わせてパーソナライズされた情報を頻繁に表示します。たとえ
ば、ウェルカム・ページにはユーザーの名前と特別な挨拶、またはユーザーが所有する現在の株価などが
表示されます。
このようなカスタマイズ出力では、Web ページは Cookie 情報に依存します。ESI プロセッサにこの依存性
を通知する特別なタグがないと、Web ページは ESI レベルで複数ユーザーで共有できません。
タグの構文と例については、8-27 ページ「ページのパーソナライズ・タグの説明」を参照してください。
OracleJSP JESI タグの説明
この項では、OracleJSP で提供される JESI タグの構文と属性について説明し、続いて使用例を説明します。
説明は次のカテゴリに編成されています。
構文における記号の表記および注意事項
ページの設定およびコンテンツ・タグの説明
ページの無効化タグおよびサブタグの説明
ページのパーソナライズ・タグの説明
JESI タグ処理および JESI から ESI への変換
OracleJSP JESI タグ・ライブラリ記述ファイル
構文における記号の表記および注意事項
タグ記述の構文ドキュメントでは、次の点に注意してください。
第１２章 Edge Side Includes の JESI タグ
193
イタリックは、値または文字列を指定する必要があることを示します。
オプション属性は、大カッコ（[...]）で囲みます。
一部のオプション属性のデフォルト値は、太字
太字で示されます。
太字
属性の指定方法における選択肢は、垂直線（ | ）で分けられます。
接頭辞"jesi:"を使用します。これは慣例であり、必須ではありません。taglib ディレクティブでは、任
意の接頭辞を指定できます。
JESI タグの属性に値または文字列を指定する場合は、適切な値または文字列に解決する JSP 式もサポ
ートされます。
注意: デフォルト設定（デフォルト保持期間など）は ESI プロセッサによって決定されます。Oracle9iAS
Web Cache ESI プロセッサの場合、デフォルト設定は Oracle9iAS Web Cache 構成ファイルによって
決定されます。
ページの設定およびコンテンツ・タグの説明
この項では次のタグの使用を要約し、タグの構文と属性を示します。
jesi:control
jesi:include
jesi:template
jesi:fragment
また、この項では control/include モデルと templage/fragment モデルの両方の例も提供されます。
ページの設定および使用方法モデルの要約
「JESI 使用方法モデル」で説明したように、JSP ページで JESI タグを使用するには 2 つのシナリオがあり
ます。
control/include−ページにキャッシュ設定を指定するには jesi:control タグを使用し、別個のキャッシュ
可能（またはタグ設定に応じてキャッシュ不可能）オブジェクトである動的ページを移入するには
jesi:include タグを使用します。
template/fragment−キャッシングを設定して集計ページのキャッシュ設定を指定するには jesi:template
タグを使用し、集計ページ内で個別のキャッシュ可能（またはキャッシュ不可能）オブジェクトを指
定するには jesi:fragment タグを使用します（必要に応じて代替キャッシュ設定を指定）。フラグメン
ト内部またはテンプレート全体内でも jesi:include タグを使用できます。
JESI control タグ
jesi:control タグは、
control/include 使用方法モデルの JSP ページのキャッシング特性を制御します。
jesi:control
タグは集計ページまたは任意のインクルード・ページで使用できますが、必須ではありません。デフォル
トのキャッシュ設定で十分であれば、jesi:control タグなしで jesi:include タグを使用できます。（「JESI 使
用方法モデル」を参照。）対応する HTTP ヘッダーがエッジ・アーキテクチャ仕様に従って設定されます。
jesi:control タグは、他の JESI タグまたはページのバッファ・フラッシュより前に可能なかぎりページの始
めに表示する必要があります。
次の点に注意してください。
単一 JSP ページで複数の jesi:control タグを使用しないでください。例外が発生します。
同一ページで jesi:control タグおよび jesi:template タグを使用しないでください。例外が発生します。
集計ページの jesi:control タグはインクルード・ページに影響しません。必要に応じて（デフォルトの
制御設定が十分でない場合に）、各インクルード・ページに jesi:control タグを使用してください。
194
Oracle9i Application Server for Compaq Tru64 UNIX リリース・ノート
構文
<jesi:control
[expiration = " value"]
[maxRemovalDelay = " value"]
[cache = "yes | no | no-remote"] />
注意: JESI 仕様では、jesi:control タグの control 属性が含まれます。この属性は ESI コントロール・ヘッダ
ーのパラメータを直接設定するためのものです。ただし、現行の Oracle 実装はコントロール・ヘッ
ダーmax-age パラメータのみの設定をサポートしています。この設定は不要ですが、jesi:control の
expiration および maxRemovalDelay 属性を設定しても同じことができます。したがって、このリリー
スでは control 属性については説明しません。（将来のリリースでは追加 ESI コントロール・ヘッダ
ーのパラメータ設定もサポートする予定で、control 属性についても説明されます。）
属性
expiration−キャッシュされたオブジェクトの存続期間を秒単位で指定します。デフォルトでは、オブ
ジェクトは期限切れになりません。
maxRemovalDelay−キャッシュされたオブジェクトの期限切れ後に ESI プロセッサがそのオブジェク
トを格納できる最大時間を秒単位で指定します。デフォルトは 0 で、すぐに削除されます。
cache−ページに対応するオブジェクトがキャッシュ可能かどうかを指定します。デフォルトは TRUE
ですが、cache を明示的に yes に設定することもできます。または、キャッシュ可能にしないページに
は no を設定するか、あるいは（リモート Web サーバーまたはコンテンツ転送ネットワークに対する
ものとして）ローカルにのみキャッシュ可能にするページには no-remote と指定できます。
ページをキャッシュ可能にしない 1 つの理由として、copyparam を有効にした jesi:include タグを使用
する場合があります。次の「JESI include タグ」を参照してください。
JESI include タグ
jesi:include タグは、標準の jsp:include タグと同じようにインクルード・ページの出力を集計ページの出力に
動的に挿入します。さらに、インクルード・ページが ESI プロセッサによって処理および組み立てられる
ように指示します。各インクルード・ページは個別のキャッシュ可能（タグ設定によってはキャッシュ不
可能）オブジェクトです。
このタグは、次のシナリオのいずれかで control/include および template/fragment 両方のモデルで使用できま
す。
JESI control タグまたは JESI template/fragment タグなしで単独使用
jesi:control タグの後に使用
フラグメント外部の jesi:template タグ内で使用
jesi:template タグ内で使用
（「JESI 使用方法モデル」を参照。）
jesi:include タグは使用方法において jsp:include タグと似ていますが、セマンティクスが異なるので要求や応
答オブジェクトを元のページとインクルード・ページ間に渡す必要のあるページ組込みには適していませ
ん。
構文
<jesi:include page = "uri_string"
[alt = "alt_uri_string"]
[ignoreError = "true | false"]
[copyparam = "true | false"]
[flush = "true | false"] />
第１２章 Edge Side Includes の JESI タグ
195
属性
page（必須）―ページ関連またはアプリケーション関連の構文いずれかを使って JSP ページの URI を
含めることを指定します。（ページ関連構文およびアプリケーション関連構文の詳細は、「JSP ペー
ジの間接要求」を参照してください。"http://..."または"https://..."の完全 URL もサポートされます。
alt−page 属性で指定されたページにアクセスできない場合に、代替ページの URI が含まれることを指
定します。構文は page 属性のものと同じです。
ignoreError−インクルード・ページに（page ページも alt ページも）アクセスできない場合でも、集計
ページの処理を続行する場合には TRUE に設定します。
copyparam−インクルード・ページに含めるページの HTTP 要求文字列からパラメータおよびその値を
コピーする場合は TRUE に設定します。
flush−この属性は無視されますが、jsp:include 構文からの移行を容易にするためにサポートされてい
ます。
注意:
要求パラメータは要求ごとに異なる可能性があるので、キャッシュ可能でないページでのみ
copyparam="true"を使用してください（jesi:control タグの cache="no"）。
将来のリリースでは jesi:param サブタグもサポートされる予定で、これは jsp:include で使用され
る jsp:param サブタグと概念的に類似しています。
例−control/include
モデル
例−
この項では、control/include モデルにおける JESI タグの使用例を提供します。
例 1: control/include
次の例では、デフォルトのキャッシュ設定が採用されています。jesi:control タグは必要がありません。
jesi:include タグは代替ファイルを指定せず、
「ファイルが見つかりません」
エラーは処理を停止します。flush
属性は使用できますが無視されます。
<%@ taglib uri="/WEB-INF/jesitaglib.tld" prefix="jesi" %>
<html>
<body>
<jesi:include page="stocks.jsp" flush="true" />
<p>
<hr>
<jesi:include page="/weather.jsp" flush="true" />
<p>
<hr>
<jesi:include page="../sales.jsp" flush="true" />
</body>
</html>
例 2: control/include
この例では、jesi:control タグを使用して maxRemovalDelay および expiration のデフォルト以外のキャッシュ
設定を指定します。さらに、ページのキャッシングはデフォルトですでに有効ですが、これを明示的に有
効にします。最初の jesi:include タグは ESI プロセッサによって order.jsp が抽出できない場合の代替ページ
を指定し、またどのページが抽出できない場合でも処理を続行することを指示します。2 番目の jesi:include
タグは代替ページを指定せず、ページが抽出できない場合は処理も停止されます。
「例 1: control/include」で使用される HTML タグは実際には必要ではありません。
<%@ taglib uri="/WEB-INF/jesitaglib.tld" prefix="jesi" %>
196
Oracle9i Application Server for Compaq Tru64 UNIX リリース・ノート
<jesi:control maxRemovalDelay="1000" expiration="300" cache="yes"/>
<jesi:include page="order.jsp" alt="alt.jsp" ignoreError="true"/>
<jesi:include page="commit.jsp" />
例 3: control/include
これは、出力が条件付きである集計ページの例です。Cookie は顧客の識別情報を表します。Cookie が見つ
からない場合、ユーザーには一般的な製品情報の汎用ウェルカム・ページが表示されます。Cookie が見つ
かった場合は、ユーザーにはユーザー・プロファイルに従った製品リストが表示されます。このリストは、
jesi:include 文によって移入されます。
jesi:control タグも maxRemovalDelay および expiration のデフォルト以外の値を設定して、ページのキャッシ
ングを明示的に有効にします。
<%@ taglib uri="/WEB-INF/jesitaglib.tld" prefix="jesi" %>
<jesi:control maxRemovalDelay="1000" expiration="300" cache="yes"/>
<%
String customerId=CookieUtil.getCookieValue(request,"customerid");
if (customerId==null) {
// some unknown customer
%>
<jesi:include page="genericwelcome.jsp" />
<%
}
else {
// a known customer; trying to retrieve recommended products from profiling
String recommendedProductsDescPages[]=
ProfileUtil.getRecommendedProductsDescURL(customerId);
for (int i=0; i < recommendedProductsDescPages.length; i++) {
%>
<jesi:include page="<%=recommendedProductsDescPages[i]%>" />
<%
}
}
%>
例 4: control/include
この例は、要求パラメータと jesi:include 文の使用を示したものです。メイン・ページが次の URL でアクセ
スされるものと仮定します。
http:// host:port/application1/main.jsp?p2=abc
メイン・ページはパラメータ設定 p2=abc を取ります。ページは次のようになります。
<%@ taglib uri="/WEB-INF/jesitaglib.tld" prefix="jesi" %>
<html>
第１２章 Edge Side Includes の JESI タグ
197
<jesi:control cache="no" />
<jesi:include page="a.jsp?p1=v1" />
<h3>hello ...</h3>
<jesi:include page="b.jsp" />
<h3>world ...</h3>
<jesi:include page="c.jsp?p1=v2" copyparam="true" />
</html>
a.jsp ページはパラメータ設定 p1=v1 を取ります。c.jsp ページは（copyparam 設定およびメイン・ページの
URL の p2 設定の結果として）、設定 p1=v2 ならびに設定 p2=abc を取ります。
さらに、このページは cache="no"設定に従ってキャッシュ可能ではありません。実際、要求属性は要求ご
とに変化するので、
キャッシュ可能ではないページでのみ copyparam 設定を使用するようにしてください。
また、cache="no"設定はインクルード・ページに影響を与えません。インクルード・ページはデフォルトに
よりまだキャッシュ可能です。（つまり、なんらかの理由でページのいずれかに cache="no"を持つ
jesi:control タグがない限りはキャッシュ可能です。）
JESI template タグ
jesi:template タグを使用して、template/fragment 使用方法モデルのページに対するキャッシング動作を指定
します。（「JESI 使用方法モデル」を参照。）対応する HTTP ヘッダーがエッジ・アーキテクチャ仕様に
従って設定されます。
jesi:template タグ内の開始タグと終了タグの間に jesi:fragment タグを 1 つ以上使用して、テンプレート内の
別個のキャッシュ可能フラグメントを指定します。jesi:template 開始タグは、可能なかぎりページの始めに
配置してください。このタグは、ページ内の他の JESI タグあるいはバッファ・フラッシュより前に表示さ
れる必要があります。jesi:template 終了タグは、可能なかぎりページの最後に配置してください。このタグ
は、ページ内の他の JESI タグより後に表示される必要があります。
集計コンテンツ（フラグメント外部）はキャッシュ可能オブジェクトであり、jesi:fragment タグと分けてお
かれる各フラグメントは別個のキャッシュ可能オブジェクトです。集計コンテンツと各フラグメントに対
しては、必要に応じてキャッシング・パラメータを設定するか、あるいはデフォルト設定を使用できます。
jesi:template タグの設定は、フラグメントには影響を与えません。
jesi:template タグは常に jesi:fragment タグとともに使用されます。別個のフラグメントが必要ない場合は、
jesi:template タグのかわりに jesi:control タグを使用してください。
次の点に注意してください。
単一 JSP ページで複数の jesi:template タグを使用しないでください。例外が発生します。
同一ページで jesi:control タグおよび jesi:template タグを使用しないでください。例外が発生します。
jesi:template タグの設定は囲まれたフラグメントには影響しません。フラグメントはそれぞれの設定を
提供（あるいはデフォルトを使用）する必要があります。
jesi:template タグの属性および使用方法は、jesi:control タグと同じです。
構文
<jesi:template
[expiration = "value"]
[maxRemovalDelay = "value"]
[cache = "yes | no | no-remote"] >
... page content, jesi:fragment tags, jesi:include tags...
</jesi:template>
198
Oracle9i Application Server for Compaq Tru64 UNIX リリース・ノート
属性
属性の説明は、「JESI control タグ」を参照してください。
JESI fragment タグ
template/fragment モデルで、jesi:template タグ内の開始タグと終了タグの間に jesi:fragment タグを 1 つ以上使
用してください。（8-8 ページ「JESI 使用方法モデルを参照」。）jesi:fragment タグは、キャッシング動作
に対する JSP コードの別個のフラグメントを必要に応じで定義します。各フラグメントは別個のキャッシ
ュ可能オブジェクトです。
特定のフラグメントが ESI メカニズムによって要求されると、ESI プロセッサはそのフラグメントのみを抽
出します。
各 jesi:fragment タグは、ESI プロセッサに対するそれぞれ独自の指示を指定します。jesi:fragment タグに指
定されないキャッシュ・プロパティは、デフォルト値によって設定されます。（jesi:template タグの周囲は
フラグメントに影響しません。）対応する HTTP ヘッダーがエッジ・アーキテクチャ仕様に従って設定さ
れます。
jesi:fragment タグの属性および使用方法は、jesi:control タグおよび jesi:template タグと同じです。
構文
<jesi:fragment
[expiration = "value"]
[maxRemovalDelay = "value"]
[cache = "yes | no | no-remote"] >
... JSP code fragment...
</jesi:fragment>
属性
属性の説明は、「JESI control タグ」を参照してください。
例−template/fragment
モデル
例−
この項には、template/fragment モデルの JESI タグ使用例が含まれています。
例 1: template/fragment
jesi:template タグおよび jesi:fragment タグの一般的な使用を示す例です。expiration 属性のみタグで指定され
ていますので、他の設定はデフォルトに従います。
jesi:template タグでは、集計コンテンツ（フラグメント外部）の有効期限は 3,600 秒です。HTML ブロック
はすべてフラグメント外部にあるので、この設定はすべての HTML ブロックに適用されます。JSP コード・
ブロック 1 は有効期限設定 60 でキャッシュされ、JSP コード・ブロック 2 はデフォルトの有効期限設定で
キャッシュされます。また JSP コード・ブロック 3 は有効期限設定 600 でキャッシュされます。
<%@ taglib uri="/WEB-INF/jesitaglib.tld" prefix="jesi" %>
<jesi:template expiration="3600">
... HTML blcck #1...
<jesi:fragment expiration="60">
... JSP code block #1...
</jesi:fragment>
... HTML block #2...
第１２章 Edge Side Includes の JESI タグ
199
<jesi:fragment>
... JSP code block #2...
</jesi:fragment>
... HTML block #3...
<jesi:fragment expiration="600">
... JSP code block #3...
</jesi:fragment>
... HTML block #4...
</jesi:template>
例 2: template/fragment
この例は、フラグメント内部の jesi:include タグを使用します。次に、このページのキャッシュ可能オブジ
ェクトを示します。
各インクルード・ページ
それぞれのインクルード・ページ外部の各フラグメント
すべてテンプレート・レベル（フラグメント外部）にある HTML ブロックの集計
<%@ taglib uri="/WEB-INF/jesitaglib.tld" prefix="jesi" %>
<jesi:template expiration="3600">
... HTML blcck #1...
<jesi:fragment expiration="60">
... JSP code block #1...
<jesi:include page="stocks.jsp" />
</jesi:fragment>
... HTML block #2...
<jesi:fragment>
... JSP code block #2...
<jesi:include page="/weather.jsp" />
</jesi:fragment>
... HTML block #3...
<jesi:fragment expiration="600">
... JSP code block #3...
<jesi:include page="../sales.jsp" />
</jesi:fragment>
... HTML block #4...
</jesi:template>
ページの失効化タグおよびサブタグの説明
jesi:invalidate タグおよび次のサブタグを適切に使用して、ESI プロセッサのキャッシュされたオブジェクト
を明示的に失効化してください。
jesi:object
jesi:cookie（jesi:object のサブタグ）
jesi:header（jesi:object のサブタグ）
概要は、「ページの失効化」を参照してください。
200
Oracle9i Application Server for Compaq Tru64 UNIX リリース・ノート
JESI invalidate タグ
jesi:invalidate タグをその jesi:object サブタグと一緒に使用して、1 つ以上のキャッシュ・オブジェクトを明
示的に失効化できます。
サブタグは、次のように使用してください。
必須 jesi:object サブタグを使用して、URI または URI 接頭辞に従って失効化対象を指定します。
オプションで jesi:object の jesi:cookie サブタグまたは jesi:header サブタグを使用して、Cookie または
HTTP ヘッダー情報に従ってさらに失効化の基準を指定します。
構文
<jesi:invalidate
[url = "url_string"
username = "username_string"
password = "password_string"]
[config = "configfilename_string"]
[output = "browser"] >
必須サブタグ（「JESI object サブタグ」で説明）：
<jesi:object ... >
jesi:object のオプション・サブタグ（「JESI cookie サブタグ」で説明）：
<jesi:cookie ... />
jesi:object のオプション・サブタグ（「JESI header サブタグ」で説明）：
<jesi:header ... />
</jesi:object>
</jesi:invalidate>
ユーザー、パスワードおよび URL を個別タグで指定するか、あるいはそれらすべてを config タグと呼ばれ
る構成ファイルで指定します。
注意: 1 つの invalidate タグ内に複数の object タグを持つことが可能です。
属性
url−キャッシュ・サーバーの URL を指定します。この属性を省略した場合は、JESI 構成ファイルに
URL を指定する必要があります。
username−キャッシュ・サーバーにログインするユーザー名を指定します。この属性を省略した場合
は、JESI 構成ファイルにユーザー名を指定する必要があります。
password−キャッシュ・サーバーにログインするパスワードを指定します。この属性を省略した場合
は、JESI 構成ファイルにパスワードを指定する必要があります。
config−JESI 構成ファイルを指定します。このファイルを使用して、対応するタグ属性を使用せずに
キャッシュ・サーバーURL、ユーザー名およびパスワード情報を提供することができます。"/"で始ま
るアプリケーション相対構文の位置を指定してください。（アプリケーション相対構文の一般的な情
報は、「JSP ページの間接要求」を参照してください。）
output−キャッシュ・サーバーから失効化応答を受信する出力デバイスをオプションで設定します。
現在サポートされる唯一の設定は browser で、
ユーザーに Web ブラウザにメッセージが表示されます。
このパラメータを設定しない場合は、確認メッセージはまったく表示されません。
第１２章 Edge Side Includes の JESI タグ
201
例: 構成ファイル
url、username および password 属性のかわりに、構成ファイルを使用して URL およびログイン情報の設定
する例を示します。
<?xml version="1.0" ?>
<ojsp-config>
<web-cache>
<url>http://yourhost.yourcompany.com:4001</url>
<username>invalidator</username>
<password>invpwd</password>
</web-cache>
</ojsp-config>
JESI object サブタグ
jesi:invalidate タグの必須 jesi:object サブタグを使用して、完全 URI または URI 接頭辞に従って失効化する
キャッシュ・オブジェクトを指定します。このサブタグの jesi:cookie サブタグまたは jesi:header サブタグを
オプションで使用して、Cookie または HTTP ヘッダー情報に基づいて失効化の基準をさらに指定します。
uri 属性設定で、完全 URI または URI 接頭辞のいずれかを指定します。このフィールドが完全 URI または
接頭辞のいずれとして解釈されるかは、prefix 属性の設定によって決まります。
構文
<jesi:object uri = "uri_or_uriprefix_string"
maxRemovalDelay = "value"
[prefix = "yes | no"] >
オプション・サブタグ（「JESI cookie サブタグ」で説明）：
<jesi:cookie ... />
オプション・サブタグ（「JESI header サブタグ」で説明）：
<jesi:header ... />
</jesi:object>
または（どちらのサブタグも使用しない場合）：
<jesi:object
[uri = "uri_or_uriprefix_string"]
[prefix = "yes | no"]
[maxRemovalDelay = "value"] />
注意:
1 つの invalidate タグ内に複数の object タグを持つことが可能です。
1 つの object タグ内に複数の cookie タグまたは header タグを持つことが可能です。
属性
uri−対応するキャッシュ・オブジェクトが失効化されるページの完全 URI（prefix="no"の場合）、ま
たは場所によって失効化される複数ページのオブジェクトを指定する URI 接頭辞（prefix="yes"の場
合）のいずれかです。
接頭辞が指定されると、その場所にあるすべてのページのキャッシュ・オブジェクトが失効化されま
す。たとえば、/abc/def の接頭辞設定では、対応するディレクトリおよびサブディレクトリにあるすべ
てのページのキャッシュ・オブジェクトが失効化されます。
202
Oracle9i Application Server for Compaq Tru64 UNIX リリース・ノート
prefix−uri 属性が URI 接頭辞としてのみ解釈される場合は yes に設定し、uri 属性が完全 URI として解
釈される場合は no に設定します。
maxRemovalDelay−キャッシュ・オブジェクトが失効化された後で、ESI プロセッサがそのオブジェク
トを格納できる最長時間を秒単位で指定します。デフォルトは 0（ゼロ）で、すぐに削除されます。
JESI cookie サブタグ
jesi:object タグ（jesi:invalidate のサブタグ）の jesi:cookie サブタグを使用して、失効化の基準として Cookie
情報を使用します。これは jesi:object タグの URI または URI 接頭辞設定の追加として、また jesi:header タ
グの追加としても使用されます。
構文
<jesi:cookie name = "name_string"
value = "value_string" />
注意: 1 つの object タグ内に複数の cookie タグを持つことが可能です。
属性
name（必須）−Cookie の名前です。
value（必須）−Cookie の値です。
キャッシュ・オブジェクトを失効化するには、
この名前と値に一致する Cookie が存在する必要があります。
JESI header サブタグ
jesi:object タグ（jesi:invalidate のサブタグ）の jesi:header サブタグを使用して、失効化の基準として HTTP/1.1
情報を使用します。これは jesi:object タグの URI または URI 接頭辞設定の追加として、また jesi:cookie タ
グの追加としても使用されます。
構文
<jesi:header name = "name_string"
value = "value_string" />
注意: 1 つの object タグ内に複数の header タグを持つことが可能です。
属性
name（必須）−HTTP/1.1 ヘッダーの名前です。
value（必須）−HTTP/1.1 ヘッダーの値です。
キャッシュ・オブジェクトを失効化するには、この名前と値に一致するヘッダーが存在する必要がありま
す。
例−ページの失効化
この項では、jesi:invalidate タグ、その jesi:object サブタグ、jesi:object タグの jesi:cookie サブタグを使用して、
ページを失効化する例を示します。
例 1: ページの失効化
この例では、完全 URI で指定された ESI プロセッサの単一オブジェクトを失効化します。（デフォルトで
は、uri によって URI 接頭辞ではなく完全 URI が指定されます。）jesi:invalidate タグはキャッシュ・サーバ
第１２章 Edge Side Includes の JESI タグ
203
ーの URL およびログイン用のユーザー名とパスワードも指定し、キャッシュ・サーバーからの失効化応答
がユーザーのブラウザで表示されることを指定します。
...
<jesi:invalidate url="http://yourhost.yourcompany.com:4001"
username="invalidator" password="invpwd"
output="browser">
<jesi:object uri="/images/logo.gif"/>
</jesi:invalidate>
...
例 2: ページの失効化
「例 1: ページの失効化」と同じですが、キャッシュ・サーバーURL およびログイン情報の指定に構成フ
ァイルを使用します。
...
<jesi:invalidate config="myconfig.xml" output="browser">
<jesi:object uri="/images/logo.gif"/>
</jesi:invalidate>
...
jesi:invalidate は構成ファイルの位置指定にページ相対構文を使用するので、myconfig.xml は JSP ページと同
じディレクトリにあると推定されます。例として、次のコンテンツがあると仮定してみます。
<?xml version="1.0" ?>
<ojsp-config>
<web-cache>
<url>http://yourhost.yourcompany.com:4001</url>
<username>invalidator</username>
<password>invpwd</password>
</web-cache>
</ojsp-config>
例 3: ページの失効化
この例では、URI 接頭辞"/"に従って ESI プロセッサのすべてのオブジェクトが失効化されます。失効化確
認メッセージがブラウザで表示されるように指定されていないため、メッセージはまったく表示されませ
ん。
...
<jesi:invalidate url="http://yourhost.yourcompany.com:4001"
username="invalidator" password="invpwd">
<jesi:object uri="/" prefix="yes"/>
</jesi:invalidate>
...
例 4: ページの失効化
この例では単一オブジェクトが失効化されますが、最高 30 分（1,800 秒）までこのオブジェクトの使用が
許可されます。
...
<jesi:invalidate url="http://yourhost.yourcompany.com:4001"
204
Oracle9i Application Server for Compaq Tru64 UNIX リリース・ノート
username="invalidator" password="invpwd">
<jesi:object uri="/images/logo.gif" maxRemovalDelay="1800"/>
</jesi:invalidate>
...
例 5: ページの失効化
この例では、「例 1: ページの失効化」と同じオブジェクトが失効化に指定されますが、Cookie user_type
および値 customer がある場合にのみ失効化が指定されます。
...
<jesi:invalidate url="http://yourhost.yourcompany.com:4001"
username="invalidator" password="invpwd">}
<jesi:object uri="/images/logo.gif">
<jesi:cookie name="user_type" value="customer"/>
</jesi:object>
</jesi:invalidate>
...
ページのパーソナライズ・タグの説明
動的ページのパーソナライズを行うには、ページの Cookie およびセッション情報によって ESI プロセッサ
に依存性が通知されている必要があります。たとえば、Cookie 値置換は Web ブラウザではなく ESI プロセ
ッサで行われます。
JESI personalize タグ
jesi:personalize タグを使用して、Cookie およびセッション情報の依存性を ESI プロセッサに通知することで
ページのパーソナライズを許可します。
構文
<jesi:personalize name = "name_string"
[value = "default_value_string"] />
属性
name（必須）−Cookie の名前を指定し、Cookie の値はページのパーソナライズ基礎として使用されま
す。
value−Cookie が見つからない場合のオプション・デフォルト値です。ESI プロセッサは Cookie を検索
するために Web サーバーに戻る必要がなくなります。
例−ページのパーソナライズ
jesi:personalize タグの使用例を次に示します。
<jesi:personalize name="user_id" value="guest" />
生成される対応 ESI タグにより、ESI プロセッサは必要な情報を検索できます。このとき、プロセッサは
user_id という Cookie とその値を検索してその値を抽出します。Cookie を検索できない場合は、デフォルト
値 guest が使用されます。この Cookie と値の置換を ESI プロセッサで処理することで、Web サーバーへの
要求の送信が回避されます。
第１２章 Edge Side Includes の JESI タグ
205
JESI タグ処理および JESI から ESI への変換
OracleJSP JESI タグ・ライブラリの一部として提供される JESI タグ・ハンドラ・クラスは、JSP 機能から
ESI 機能へのブリッジとなります。タグ・ハンドラでは、JESI タグの ESI タグへの変換、失効化に対する
HTTP 要求の生成、HTTP 応答ヘッダーの設定などが行われます。（ただし、JESI タグと ESI タグの間また
は JESI タグ属性と ESI タグ属性の間には、常に 1 対 1 のマッピングが存在するわけではないことに注意し
てください。）
例として、この章で前述した例にある次の JSP コードを考えてみましょう。
...
<jesi:include page="stocks.jsp" flush="true" />
<p>
<hr>
<jesi:include page="/weather.jsp" flush="true" />
<p>
<hr>
<jesi:include page="../sales.jsp" flush="true" />
...
jesi:include タグ・ハンドラは、次のような ESI マークアップを生成します。
...
<esi:include src="http://host:port/application1/dir2/dir3/stocks.jsp" />
<p>
<hr>
<esi:include src="http://host:port/application1/weather.jsp" />
<p>
<hr>
<esi:include src="http://host:port/application1/dir2/sales.jsp" />
...
OracleJSP JESI タグ・ライブラリ記述ファイル
この項では、OracleJSP JESI タグ・ライブラリの完全なタグ・ライブラリ記述ファイル（TLD）である
jesitaglib.tld のリストを提示します。
<?xml version="1.0" encoding="ISO-8859-1" ?>
<!DOCTYPE taglib
PUBLIC "-//Sun Microsystems, Inc.//DTD JSP Tag Library 1.1//EN"
"web-jsptaglib_1_1.dtd">
<!-- a tab library descriptor -->
<taglib>
<!-- after this the default space is
"http://java.sun.com/j2ee/dtds/web-jsptaglibrary_1_1.dtd"
-->
<tlibversion>1.0</tlibversion>
<jspversion>1.1</jspversion>
<shortname>simple</shortname>
206
Oracle9i Application Server for Compaq Tru64 UNIX リリース・ノート
<info>
A simple tab library for the jesi
</info>
<!-- Tags defining a connection/query/execute collection -->
<!-- connection tag -->
<tag>
<name>invalidate</name>
<tagclass>oracle.jsp.tags.jesi.InvalidationTag</tagclass>
<bodycontent>JSP</bodycontent>
<attribute>
<name>url</name>
<required>false</required>
<rtexprvalue>true</rtexprvalue>
</attribute>
<attribute>
<name>username</name>
<required>false</required>
<rtexprvalue>true</rtexprvalue>
</attribute>
<attribute>
<name>password</name>
<required>false</required>
<rtexprvalue>true</rtexprvalue>
</attribute>
<attribute>
<name>config</name>
<required>false</required>
<rtexprvalue>true</rtexprvalue>
</attribute>
<attribute>
<name>output</name>
<required>false</required>
<rtexprvalue>true</rtexprvalue>
</attribute>
</tag>
<tag>
<name>object</name>
<tagclass>oracle.jsp.tags.jesi.ObjectTag</tagclass>
<bodycontent>JSP</bodycontent>
<attribute>
<name>uri</name>
<required>true</required>
第１２章 Edge Side Includes の JESI タグ
207
<rtexprvalue>true</rtexprvalue>
</attribute>
<attribute>
<name>maxRemovalDelay</name>
<required>true</required>
<rtexprvalue>true</rtexprvalue>
</attribute>
<attribute>
<name>prefix</name>
<required>false</required>
<rtexprvalue>true</rtexprvalue>
</attribute>
</tag>
<tag>
<name>cookie</name>
<tagclass>oracle.jsp.tags.jesi.CookieTag</tagclass>
<bodycontent>JSP</bodycontent>
<attribute>
<name>name</name>
<required>true</required>
<rtexprvalue>true</rtexprvalue>
</attribute>
<attribute>
<name>value</name>
<required>true</required>
<rtexprvalue>true</rtexprvalue>
</attribute>
</tag>
<tag>
<name>header</name>
<tagclass>oracle.jsp.tags.jesi.HeaderTag</tagclass>
<bodycontent>JSP</bodycontent>
<attribute>
<name>name</name>
<required>true</required>
<rtexprvalue>true</rtexprvalue>
</attribute>
<attribute>
<name>value</name>
<required>true</required>
<rtexprvalue>true</rtexprvalue>
</attribute>
</tag>
208
Oracle9i Application Server for Compaq Tru64 UNIX リリース・ノート
<!-- connection tag -->
<tag>
<name>fragment</name>
<tagclass>oracle.jsp.tags.jesi.FragmentTag</tagclass>
<bodycontent>JSP</bodycontent>
<attribute>
<name>control</name>
<required>false</required>
<rtexprvalue>true</rtexprvalue>
</attribute>
<attribute>
<name>cache</name>
<required>false</required>
<rtexprvalue>true</rtexprvalue>
</attribute>
<attribute>
<name>expiration</name>
<required>false</required>
<rtexprvalue>true</rtexprvalue>
</attribute>
<attribute>
<name>maxRemovalDelay</name>
<required>false</required>
<rtexprvalue>true</rtexprvalue>
</attribute>
</tag>
<tag>
<name>include</name>
<tagclass>oracle.jsp.tags.jesi.IncludeTag</tagclass>
<bodycontent>JSP</bodycontent>
<attribute>
<name>page</name>
<required>true</required>
<rtexprvalue>true</rtexprvalue>
</attribute>
<attribute>
<name>ignoreError</name>
<required>false</required>
<rtexprvalue>true</rtexprvalue>
</attribute>
<attribute>
<name>alt</name>
<required>false</required>
<rtexprvalue>true</rtexprvalue>
</attribute>
第１２章 Edge Side Includes の JESI タグ
209
<attribute>
<name>copyparam</name>
<required>false</required>
<rtexprvalue>true</rtexprvalue>
</attribute>
<attribute>
<name>flush</name>
<required>false</required>
<rtexprvalue>true</rtexprvalue>
</attribute>
</tag>
<tag>
<name>control</name>
<tagclass>oracle.jsp.tags.jesi.ControlTag</tagclass>
<bodycontent>JSP</bodycontent>
<attribute>
<name>control</name>
<required>false</required>
<rtexprvalue>true</rtexprvalue>
</attribute>
<attribute>
<name>cache</name>
<required>false</required>
<rtexprvalue>true</rtexprvalue>
</attribute>
<attribute>
<name>expiration</name>
<required>false</required>
<rtexprvalue>true</rtexprvalue>
</attribute>
<attribute>
<name>maxRemovalDelay</name>
<required>false</required>
<rtexprvalue>true</rtexprvalue>
</attribute>
</tag>
<tag>
<name>template</name>
<tagclass>oracle.jsp.tags.jesi.TemplateTag</tagclass>
<bodycontent>JSP</bodycontent>
<attribute>
<name>control</name>
<required>false</required>
<rtexprvalue>true</rtexprvalue>
</attribute>
<attribute>
<name>cache</name>
210
Oracle9i Application Server for Compaq Tru64 UNIX リリース・ノート
<required>false</required>
<rtexprvalue>true</rtexprvalue>
</attribute>
<attribute>
<name>expiration</name>
<required>false</required>
<rtexprvalue>true</rtexprvalue>
</attribute>
<attribute>
<name>maxRemovalDelay</name>
<required>false</required>
<rtexprvalue>true</rtexprvalue>
</attribute>
</tag>
<tag>
<name>personalize</name>
<tagclass>oracle.jsp.tags.jesi.PersonalizeTag</tagclass>
<bodycontent>JSP</bodycontent>
<attribute>
<name>name</name>
<required>true</required>
<rtexprvalue>true</rtexprvalue>
</attribute>
<attribute>
<name>value</name>
<required>false</required>
<rtexprvalue>true</rtexprvalue>
</attribute>
</tag>
</taglib>
第１２章 Edge Side Includes の JESI タグ
211

新生銀行グループ7社の財務会計・管理会計

WebUnity-Plus カタログ

細 川 高 国 の 切 腹 と 大 物 ・ 富 松 ・ 京 都

(InterScan Web Security as a Service) (PDF:257KB

www.tintri.co.jp

日本のIDC事業を“輸出産業”にする、さくら社長 － ＠IT - NetEnrich

Oracle Database Appliance トータルサービス

BIG-IPとの連携 製品概要 - F5 Networks Inc.