Skip Headers
Oracle® Application Server Portal Configuration Guide
10
g
Release 2 (10.1.4)
B19305-03
Home
Solution Area
Index
Next
Contents
List of Examples
List of Figures
List of Tables
Title and Copyright Information
Preface
Audience
Documentation Accessibility
Related Documents
Conventions
What's New in Oracle Application Server Portal Configuration?
New Features Introduced with OracleAS Portal 10
g
Release 2 (10.1.4)
New Features Introduced with OracleAS Portal 10g Release 2 (10.1.2)
Part I Concepts
1
Understanding the OracleAS Portal Architecture
1.1
What Is the Oracle Application Server?
1.1.1
What Are the Oracle Application Server Solutions and Components?
1.1.2
Overview of the Oracle Application Server Architecture
1.1.2.1
What Are the Middle-Tier Components?
1.1.2.2
What Are the Infrastructure Components?
1.2
Understanding the OracleAS Portal Architecture
1.2.1
How Does OracleAS Portal Integrate with Other Components?
1.2.2
How Do the Pieces Fit Together?
1.2.2.1
How Are Pages Assembled in OracleAS Portal?
1.2.2.2
How Does Communication Flow in OracleAS Portal?
1.3
Understanding Caching in OracleAS Portal
1.3.1
Understanding OracleAS Web Cache
1.3.2
Understanding Portal Cache
1.3.3
Understanding Cache Invalidation in OracleAS Portal
1.4
Understanding WSRP and JPS
1.4.1
What's Next?
2
Planning Your Portal
2.1
What Do I Need to Consider?
2.1.1
Which Topology Is Right for Me?
2.1.2
How Much Hardware Do I Need?
2.1.3
How Can I Maximize Performance?
2.1.4
How Can I Make My Portal Scale?
2.1.5
How Can I Make My Portal Highly Available?
2.1.6
How Can I Secure My Portal?
2.1.7
How Should I Configure My Hardware and Software?
2.1.7.1
Using a Single Computer
2.1.7.2
Using Multiple Computers
2.1.8
Getting the Most Out of Your Configuration
2.1.8.1
Load Balancing
2.1.8.2
Failover and Redundancy
2.1.8.3
Scalability
2.2
What Do I Need to Do?
2.2.1
Planning Your Portal
2.2.2
Upgrading OracleAS Portal
2.2.3
Verifying Pre-Installation Requirements
2.2.4
Installing Oracle Application Server
2.2.5
Performing Post-Installation Configuration
2.2.6
Performing Advanced Configuration
2.2.7
Securing OracleAS Portal
2.2.8
Monitoring OracleAS Portal
2.2.9
Troubleshooting OracleAS Portal
Part II Installation and Basic Configuration
3
Installing OracleAS Portal
3.1
What Is Installed and Configured By Default?
3.2
Accessing OracleAS Portal After Installation
3.3
Configuring OracleAS Portal During and After Installation
4
Performing Basic Configuration and Administration
4.1
Getting Started with OracleAS Portal Administration
4.1.1
Using the OracleAS Portal Administer Tab
4.1.2
Using Additional Administrative Tools
4.1.2.1
Oracle Enterprise Manager 10
g
Application Server Control Console
4.1.2.2
Portal Dependency Settings File and Tool
4.1.2.3
Portal Installation and Configuration Scripts
4.2
Finding Out Information About OracleAS Portal
4.2.1
Accessing OracleAS Portal in Your Browser
4.2.2
Finding Your OracleAS Portal Version Number
4.3
Performing Basic Page Administration
4.3.1
Setting a Default Home Page
4.3.1.1
Setting the System Default Home Page
4.3.1.2
Setting a Group's Default Home Page
4.3.1.3
Setting a User's Default Home Page
4.3.2
Setting the System Default Style
4.3.3
Creating Personal Pages
4.3.3.1
Automatically Creating a Personal Page for New Users
4.3.3.2
Creating a Personal Page for an Existing User
4.3.4
Setting the Total Space Allocated for Uploaded Files
4.3.5
Setting the Maximum File Size for Uploaded Files
4.3.6
Changing the Page Group Quota
4.3.7
Specifying an Error Message Page
4.3.8
Setting the Default Page for Non-Authenticated Users
4.3.9
Removing the Context-Sensitive Help Link
4.4
Configuring Self-Registration
4.5
Performing Basic Portal Administration
4.5.1
Simplifying the Full URL of an OracleAS Portal Instance
4.5.2
Configuring Oracle HTTP Server to Use the OracleAS Portal Home Page
4.5.3
Configuring a Portal DAD
4.5.4
Configuring the Portal Cache
4.5.5
Clearing the Portal Cache
4.5.6
Using a Custom Image Directory
4.6
Configuring Mobile Support in OracleAS Portal
4.6.1
What Is Installed By Default?
4.6.2
Configuring Mobile Settings in OracleAS Portal
4.6.2.1
Enabling Mobile Access
4.6.2.2
Configuring Mobile Home Pages
4.6.2.3
Displaying Page Titles in Mobile Banner Links
4.6.2.4
Displaying Enhanced Page Layouts on PDAs
4.6.2.5
Logging Mobile Responses
4.6.3
Manually Reconfiguring the Mobile Setup
4.6.3.1
Updating the OracleAS Portal Home Page URL References
4.6.3.2
Updating the OracleAS Wireless Portal Service URL Reference
4.6.4
Changing the Mobile Device Component of the Cache Key
4.7
Managing Users, Groups, and Passwords
4.8
Configuring Browser Settings
4.9
Configuring Language Support
4.9.1
Installing Languages After Installation
4.9.2
Enabling the Use of Territories
4.10
Configuring OracleAS Portal for WebDAV
4.10.1
Performing Basic WebDAV Configuration
4.10.2
Setting Up a WebDAV Client
4.10.3
WebDAV Clients and SSL
4.10.4
Checking the Version of OraDAV Drivers
4.10.5
Checking the Version of mod_oradav.so
4.10.6
Viewing Errors
4.11
Configuring Resource Proxying
Part III Advanced Configuration Topics
5
Performing Advanced Configuration
5.1
Changing the OracleAS Portal Port
5.2
Configuring SSL
5.3
Configuring Multiple Middle Tiers with a Load Balancing Router
5.3.1
Step 1: Install a Single Portal and Wireless Middle Tier (M1)
5.3.2
Step 2: Configure OracleAS Portal on M1 to Be Accessed Through the LBR
5.3.3
Step 3: Confirm That OracleAS Portal is Up and Running
5.3.4
Step 4: Install a New Portal and Wireless Middle Tier (M2)
5.3.5
Step 5: Configure the New Middle Tier (M2) to Run Your Existing Portal
5.3.6
Step 6: Configure Portal Tools and Web Providers (Optional)
5.3.7
Step 7: Enable Session Binding on OracleAS Web Cache
5.3.8
Step 8: Confirm the Completed Configuration
5.4
Configuring Virtual Hosts
5.4.1
Create Virtual Hosts
5.4.1.1
Create the Virtual Host for www.xyz.com
5.4.1.2
Create the Virtual Host for www.abc.com
5.4.1.3
Verify the httpd.conf File
5.4.1.4
Verify That the Virtual Hosts Are Configured Correctly
5.4.2
Configure OracleAS Web Cache
5.4.3
Register OracleAS Portal with OracleAS Single Sign-On
5.4.4
Verify the Configuration
5.5
Configuring OracleAS Portal to Use a Proxy Server
5.6
Configuring Reverse Proxy Servers
5.7
Configuring a Dedicated Intranet and Internet for OracleAS Portal
5.8
Managing OracleAS Portal Content Cached in OracleAS Web Cache
5.8.1
Managing Oracle Application Server Web Cache
5.8.2
Configuring Portal Web Cache Settings Using Application Server Control Console
5.8.3
Managing Portal Content Cached in OracleAS Web Cache
5.8.3.1
Clearing the Entire Web Cache
5.8.3.2
Clearing the Cache for a Particular User
5.8.3.3
Setting the Expiry Time for Invalidation-based Caching
5.8.3.4
Clearing the Cache for a Particular Portal Object
5.8.4
Clearing the Cache Invalidation Queue Through SQL*Plus
5.8.5
Managing the Invalidation Message Processing Job
5.9
Configuring OracleAS Portal to Use a Dedicated OracleAS Web Cache Instance
5.9.1
Understanding Installation Prerequisites and Requirements
5.9.2
Configuring a Dedicated OracleAS Web Cache
5.9.2.1
Task 1: Verify That the OracleAS Web Cache on the Dedicated Server Is Running
5.9.2.2
Task 2: Configure OracleAS Web Cache on the Dedicated Server
5.9.2.3
Task 3: Stop the Unused OracleAS Web Cache on the Middle-Tier Server
5.9.2.4
Task 4: Configure OracleAS Portal Middle Tier with OracleAS Web Cache Settings
5.9.2.5
Task 5: Configure Virtual Host Settings for Oracle HTTP Server
5.10
Changing the Infrastructure Services Used By a Middle Tier
5.11
Configuring OracleAS Wireless
5.12
Changing the OracleAS Portal Schema Password
6
Securing OracleAS Portal
6.1
About OracleAS Portal Security
6.1.1
OracleAS Portal Security Model
6.1.2
Classes of Users and Their Privileges
6.1.2.1
OracleAS Portal Default, Seeded User Accounts
6.1.2.2
OracleAS Portal Default, Seeded Groups
6.1.2.3
OracleAS Portal Default Schemas
6.1.3
Resources Protected
6.1.3.1
Global Privileges
6.1.3.2
Object Privileges
6.1.3.3
Granting Privileges to New Providers
6.1.3.4
Privileges to Create and Edit Web Providers and Provider Groups
6.1.3.5
Privileges to Create and Edit WSRP Producers
6.1.3.6
Privileges to Create and Edit URL and XML Portlets in the Portlet Repository
6.1.4
Authorization and Access Enforcement
6.1.5
Leveraging Oracle Application Server Security Services
6.1.6
Leveraging Oracle Identity Management Infrastructure
6.1.6.1
Relationship Between OracleAS Portal and OracleAS Single Sign-On
6.1.6.2
Relationship Between OracleAS Portal and Oracle Internet Directory
6.1.6.3
Relationship Between OracleAS Portal and Oracle Directory Integration Platform
6.1.6.4
Relationship Between OracleAS Portal and Oracle Delegated Administration Services
6.1.6.5
User Portlet
6.1.6.6
Portal User Profile Portlet
6.1.6.7
Group Portlet
6.1.6.8
Portal Group Profile Portlet
6.1.6.9
Oracle Delegated Administration Services Public Roles
6.1.7
Security for Portlets
6.1.7.1
Authentication
6.1.7.2
Authorization
6.1.7.3
Communication Security
6.1.7.4
Access Control Lists
6.1.7.5
OracleAS Portal Server Authentication
6.1.7.6
Securing the Portal Tools Provider Configuration Pages
6.1.7.7
Single Sign-On
6.1.7.8
Programmatic Portlet Security
6.1.7.9
Message Authentication
6.1.7.10
HTTPS Communication
6.1.7.11
Configuration of SSL
6.1.8
Securing the OmniPortlet and Simple Parameter Form
6.1.9
Securing the Web Clipping Provider
6.1.9.1
Adding Certificates for Trusted Sites
6.1.9.2
Configuring Oracle Advanced Security for the Web Clipping Provider
6.1.10
Securing the Federated Portal Adapter
6.1.11
Securing OraDAV
6.1.11.1
Session Cookie Expiration
6.1.11.2
SSL and OraDAV
6.2
Configuring OracleAS Security Framework for OracleAS Portal
6.2.1
Configuring OracleAS Security Framework Options for OracleAS Portal
6.2.2
Configuring Oracle Identity Management Options for OracleAS Portal
6.2.2.1
Setting the Appropriate Naming and Nickname Attributes
6.2.2.2
Configuring the Portal Administrator for Single Sign-On Administration
6.3
Configuring OracleAS Portal Security
6.3.1
Configuring OracleAS Portal Security Options
6.3.1.1
Changing Settings on the Global Settings Page
6.3.1.2
Enforcing Role-Based Access Control
6.3.1.3
Configuring Provider Message Authentication
6.3.2
Configuring Options for OracleAS Security Framework
6.3.2.1
Configuring SSL for OracleAS Portal
6.3.2.2
Securing the Connection to Oracle Internet Directory (Optional)
6.3.2.3
Post-Installation Security Checklist
6.3.3
Configuring OracleAS Portal Options for Database Security
7
Monitoring and Administering OracleAS Portal
7.1
Using the Grid Control Console
7.1.1
Monitoring Historical Trends
7.1.2
Comparing Metrics from Multiple Portal Targets
7.1.3
Setting Up Notifications for OracleAS Portal Metrics
7.1.4
Setting OracleAS Portal Metric Thresholds
7.1.5
Viewing Recent Alerts
7.1.6
Using Web Applications for Application Performance Monitoring
7.2
Using the Application Server Control Console
7.2.1
Accessing the Application Server Control Console
7.2.2
Using Application Server Control Console to Configure OracleAS Portal
7.3
Using Application Server Control Console to Monitor and Administer OracleAS Portal
7.3.1
General Status Information
7.3.2
OracleAS Metadata Repository Information
7.3.3
Portal Web Cache Settings Link
7.3.4
Portal Cache Settings Link
7.3.5
Portal DAD Settings Link
7.3.6
Component Status Table
7.3.6.1
HTTP Server
7.3.6.2
Parallel Page Engine Services
7.3.6.3
Providers
7.3.6.4
Ultra Search
7.3.7
Severity Status Table
7.3.8
Related Links
7.3.9
Logs Link
7.3.10
Topology Link
7.3.11
Additional Configuration Requirements
7.3.11.1
Updating Oracle Enterprise Manager Link in OracleAS Portal
7.3.11.2
Monitoring OracleAS Portal in an SSL Environment
7.4
Viewing OracleAS Portal Activity Reports
7.4.1
Logged Events
7.4.2
Choosing Which Events Are Logged
7.4.3
Activity Log Views
7.4.4
Accessing Activity Log Views Externally
7.5
Viewing Oracle Application Server Port Information
8
Configuring the Search Features in OracleAS Portal
8.1
Search Options in OracleAS Portal
8.1.1
OracleAS Portal Search
8.1.2
Oracle Ultra Search
8.1.3
Default Search Functionality
8.1.4
Deciding Which Search Options to Use
8.1.5
Differences Between Oracle Ultra Search and OracleAS Portal Search
8.2
Configuring OracleAS Portal Search Options
8.2.1
Configuring OracleAS Portal Search Portlets
8.2.1.1
Choosing Search Result Pages
8.2.1.2
Limiting the Number of Search Results on a Page
8.2.1.3
Choosing an Advanced Search Link (Basic/Custom Search Portlets)
8.2.1.4
Choosing an Internet Search Engine (Advanced/Custom Search Portlets)
8.2.2
Configuring Oracle Text Options in OracleAS Portal
8.2.2.1
Enabling and Disabling Oracle Text in OracleAS Portal
8.2.2.2
Setting Oracle Text Search Result Options
8.2.2.3
Setting a Base URL for Oracle Text
8.2.2.4
Configuring Proxy Settings for Oracle Text
8.2.3
Configuring Enterprise Search Engine Options
8.2.4
Configuring Oracle Ultra Search Options in OracleAS Portal
8.2.4.1
Accessing the Oracle Ultra Search Administration Tool
8.2.4.2
Registering OracleAS Portal as a Content Source
8.2.4.3
Registering the Ultra Search Provider with OracleAS Portal
8.3
Oracle Text
8.3.1
Understanding OracleAS Portal Searches with Oracle Text Enabled/Disabled
8.3.1.1
Searching With Oracle Text Disabled
8.3.1.2
Searching With Oracle Text Enabled
8.3.2
Oracle Text Prerequisites
8.3.3
Oracle Text Indexes
8.3.3.1
Oracle Text Index Overview
8.3.3.2
Oracle Text Index Preferences
8.3.3.3
Datastore Procedures
8.3.3.4
Granting CTXAPP Role to the OracleAS Portal Schema
8.3.3.5
Multilingual Functionality (Multilexer)
8.3.3.6
STEM Searching
8.3.3.7
Maximizing AUTO_FILTER Performance
8.3.4
Creating and Dropping Oracle Text Indexes
8.3.4.1
Creating All Oracle Text Indexes Using ctxcrind.sql
8.3.4.2
Creating a Single Oracle Text Index
8.3.4.3
Dropping All Oracle Text Indexes Using ctxdrind.sql
8.3.4.4
Dropping a Single Oracle Text Index
8.3.5
Maintaining Oracle Text Indexes
8.3.5.1
Synchronizing Oracle Text Indexes
8.3.5.2
Synchronizing an Oracle Text Index On Commit
8.3.5.3
Synchronizing All Oracle Text Indexes Manually
8.3.5.4
Scheduling Index Synchronization
8.3.5.5
Deciding How Often to Synchronize Oracle Text Indexes
8.3.5.6
Synchronizing All the Index Content
8.3.5.7
Optimizing Oracle Text Indexes
8.3.5.8
Scheduling Index Optimization
8.3.5.9
Choosing the Optimization Interval
8.3.6
Indexing and Searching URL Content
8.3.6.1
Relative URLs
8.3.6.2
Unsupported URLs
8.3.6.3
Supported URLs
8.3.6.4
URL Index Proxy Settings
8.3.7
Disabling Document and URL Indexing
8.3.8
Viewing the Status of Oracle Text Indexes
8.3.9
Monitoring Oracle Text Indexing Operations
8.3.9.1
Using start_log to Monitor Index Operations
8.3.9.2
Using logcrind.sql to Monitor Index Creation
8.3.10
Viewing Indexing Errors
8.3.11
Translating Indexing Errors to Objects in OracleAS Portal
8.3.11.1
Item Indexing Errors
8.3.11.2
Page Indexing Errors
8.3.11.3
Category Index Errors
8.3.11.4
Perspective Indexing Errors
8.3.11.5
Document Index Errors
8.3.11.6
URL Index Errors
8.3.12
Common Indexing Errors
8.3.12.1
Common Document Indexing Errors
8.3.12.2
Common URL Indexing Errors
8.3.13
Handling Indexing Hangs or Crashes
8.3.13.1
Identifying Whether an Index Operation is Hanging
8.3.13.2
Preventing Indexes From Hanging and Crashing
8.3.14
Troubleshooting Oracle Text Installation Issues
8.4
Oracle Ultra Search
8.4.1
Oracle Ultra Search Overview
8.4.1.1
About the Oracle Ultra Search Sample Query Applications
8.4.1.2
About the Oracle Ultra Search Administration Tool
8.4.1.3
About Oracle Ultra Search Configuration
8.4.2
Sample Oracle Ultra Search Portlet
8.4.2.1
Public Data Searching
8.4.2.2
Sample Portlet Files
8.4.2.3
Restrictions
9
Tuning Performance in OracleAS Portal
9.1
Setting the Number of Server Processes
9.2
Setting the Number of Idle Processes
9.3
Setting the Number of PPE Fetchers
9.4
Tuning the Oracle HTTP Server
9.5
Generating Performance Reports
9.6
Tuning File System Cache to Improve Caching Performance
9.7
Tuning Oracle Net Services
10
Exporting and Importing Content
10.1
Before You Start OracleAS Portal Export or Import
10.2
Export and Import in OracleAS Portal
10.2.1
What Do I Need to Check Before I Begin?
10.2.1.1
System Requirements
10.2.1.2
Additional Considerations
10.2.1.3
Privileges for Exporting and Importing Content
10.2.2
Examples of Using Export and Import
10.2.2.1
Case 1: Exporting and Importing Between Development and Production Instances
10.2.2.2
Case 2: Deploying Identical Content Across Multiple Portal Instances
10.2.2.3
Case 3: Consolidating Content from Multiple Sources
10.2.3
OracleAS Portal Export and Import - Recommended Method
10.2.3.1
How Does OracleAS Portal Export Work?
10.2.3.2
How Does OracleAS Portal Import Work?
10.2.3.3
How Do I Manage My Transport Sets?
10.2.4
OracleAS Portal Export and Import - Alternate Method
10.3
Behavior of Objects After Migration
10.3.1
Behavior of OracleAS Portal Objects
10.3.1.1
Page Groups
10.3.1.2
Attributes
10.3.1.3
Approvals
10.3.1.4
Items
10.3.1.5
Pages
10.3.1.6
Regions
10.3.1.7
Portal Templates
10.3.1.8
HTML Templates
10.3.1.9
Categories
10.3.1.10
Perspectives
10.3.1.11
Navigation Pages
10.3.1.12
Styles
10.3.1.13
Item Types
10.3.1.14
Page Types
10.3.2
Import Behavior of Child Objects
10.3.3
Behavior of DB Provider Objects
10.3.3.1
Seeded DB Providers
10.3.3.2
Portal DB Providers
10.3.3.3
Portal DB Provider Components
10.3.3.4
Shared Components
10.3.3.5
Registered Database Providers
10.3.4
Behavior of Portal DB Provider Reports Object Types
10.3.5
Behavior of Web Providers
10.3.5.1
OmniPortlet
10.3.5.2
Web Clipping Providers, WSRP Producers, and Other Web Providers
10.4
Recommended Best Practices When Exporting and Importing
10.4.1
Naming Convention for Replicated Tabs
10.4.2
Migrating Page Groups and Components
10.4.3
Migrating Portal DB Providers and Components
10.4.4
Migrating Search Components
10.4.4.1
Basic and Advanced Search Portlets
10.4.4.2
Custom Search Portlets
10.4.5
Migrating Content Between Upgraded OracleAS Portal Instances
10.4.6
Exporting and Importing in a Hosted Environment
10.4.7
Importing Data with Oracle Text Index Synchronization Turned Off
10.4.8
Migrating Users and Groups
11
Using the Federated Portal Adapter
11.1
About the Federated Portal Adapter
11.1.1
Overview
11.1.2
Differences Between Database Providers and Web Providers
11.1.3
Use of the Federated Portal Adapter
11.1.4
Security Issues
11.1.5
Federated Portal Adapter Related Portlet Modifications
11.2
Setting Up the Environment to Use the Federated Portal Adapter
11.2.1
Checking the PlsqlSessionCookieName Value
11.2.2
Federated Portal Adapter User Authentication Using HMAC
11.2.3
Setting the Cookie Domain
11.2.4
Sharing an OracleAS Single Sign-On and an Oracle Internet Directory Server
11.3
Registering a Provider Using the Federated Portal Adapter
11.4
Writing Custom Portlets Using the Federated Portal Adapter
11.4.1
Relative Links
11.4.2
Personalization
11.5
Troubleshooting Federated Portal Adapter
Part IV Appendixes
A
Using the Portal Dependency Settings Tool and File
A.1
Portal Dependency Settings Tool
A.1.1
Configuration Mode
A.1.2
Encryption Mode
A.1.3
Load Mode
A.2
Portal Dependency Settings File
A.2.1
Name and Location
A.2.2
Configuration Elements
A.2.3
Sample Portal Dependency Settings File
A.2.4
Updating the Portal Dependency Settings File
A.2.5
Post-Installation Mapping in the Portal Dependency Setting File
A.2.6
Common Configuration Mapping in the Portal Dependency Settings File
B
Configuring and Managing an Upgraded Oracle Application Server Portal Instance
B.1
Configuring and Managing the OracleAS Portal Instance
B.1.1
Changing the OracleAS Portal Schema Password
B.1.2
Changing Oracle Identity Management Services
B.1.3
Updating the Oracle Enterprise Manager 10
g
targets.xml File
B.1.4
Updating iasconfig.xml When the Database Containing the Portal Schema Has Been Reconfigured
B.1.5
Performing Advanced Configurations with ptlconfig
B.1.6
Conclusion
C
Using OracleAS Portal Installation and Configuration Scripts
C.1
Managing the Invalidation Message Processing Job Using cachjsub.sql
C.2
Configuring for IP Check During Session Cookie Validation
C.3
Using the secupoid.sql Script
C.4
Using the secjsdom.sql Script
C.5
Configuring the Portal Session Cookie
C.5.1
Configuring the Cookie Name
C.5.2
Configuring the Scope of the Cookie
C.5.3
Securing the Cookie
C.6
Managing the Session Cleanup Job
C.7
Timing and Caching Statistics
C.7.1
Portlet Statistics
C.7.1.1
Portlet Timing Information
C.7.1.2
Portlet Caching Information
C.7.2
Page Statistics
C.7.3
Additional Summary Statistics
C.8
Using the cfgiasw Script to Configure Mobile Settings
C.9
Using the cfgxodnc.pl Script to Change the Mobile Device Component of the Cache Key
C.9.1
Adding the PlsqlCGIEnvironmentList Parameter to the dads.conf File
C.9.2
Running the cfgxodnc.pl script
C.9.3
Adding the useDeviceNameCacheKeys parameter to the PPE Configuration file
C.9.4
Clearing Cached Data
C.10
Using the Category and Perspective Scripts
C.11
Using the PDK-Java Preference Store Migration and Upgrade Utility
C.12
Using the Schema Validation Utility
C.12.1
Using the Schema Validation Utility with OracleAS Portal Export and Import
C.12.2
Using the Standalone Schema Validation Utility
D
Configuring the Parallel Page Engine
D.1
Configuring PPE Parameters
D.1.1
Setting PPE Configuration Parameters
D.1.2
PPE Configuration Settings
E
Using Oracle Application Server Configuration Files
E.1
Oracle HTTP Server Configuration File (httpd.conf)
E.2
DAD Configuration File (dads.conf)
E.3
Oracle Database Connection Configuration
E.4
Web Cache Configuration Files
E.5
OracleAS Single Sign-On Configuration Table
E.6
OracleAS Single Sign-On's Partner Application Table
E.7
Local HOSTS File
E.8
Using Oracle Enterprise Manager 10
g
F
Integrating JavaServer Pages with OracleAS Portal
F.1
Using the JavaServer Page Configuration File
F.1.1
Contents of Your JavaServer Page Configuration File
F.1.1.1
The <jps> Tag
F.1.1.2
The <portal> Tag
F.1.1.3
The <database> Tag
F.1.1.4
The <url> Tag
F.1.1.5
The <cookie> Tag
F.1.1.6
The <pageGroups> Tag
F.1.1.7
The <pageGroup> Tag
F.1.2
Example JavaServer Page Configuration File
F.1.3
Location of Your JavaServer Page Configuration File
F.1.4
External JavaServer Page Login
F.2
Setting Up a JAZN File for External Communication
F.2.1
Setting Up mod_osso
F.2.2
Setting Up JAZN with LDAP
G
Using the wwv_context APIs
G.1
Procedures
G.1.1
add_attribute_section
G.1.2
commit_sync
G.1.3
create_index
G.1.4
create_missing_indexes
G.1.5
create_prefs
G.1.6
createindex
G.1.7
drop_all_indexes
G.1.8
drop_index
G.1.9
drop_invalid_indexes
G.1.10
drop_prefs
G.1.11
dropindex
G.1.12
optimize
G.1.13
set_parallel_degree
G.1.14
set_sync_memory
G.1.15
set_use_doc_index
G.1.16
set_use_url_index
G.1.17
sync
G.1.18
touch_index(p_indexes wwsbr_array)
G.1.19
touch_index
G.1.20
update_index_prefs
G.2
Functions
G.2.1
checkindex
G.2.2
doc_index
G.2.3
get_commit_sync
G.2.4
get_parallel_degree
G.2.5
get_sync_memory
G.2.6
get_use_doc_index
G.2.7
get_use_url_index
G.2.8
valid_doc_index
G.2.9
valid_url_index
G.2.10
url_index
G.3
Constants
G.3.1
Index Name Constants
G.3.2
Oracle Text AUTO_FILTER Format Constants
G.3.3
Oracle Text Job Constants
G.3.4
URL Unsuitable for Indexing Constant
G.4
Exceptions
H
Using TEXTTEST to Check Oracle Text Installation
H.1
When to Use TEXTTEST
H.2
Before Running TEXTTEST
H.3
Running TEXTTEST
H.4
Understanding TEXTTEST Results
H.5
Configuring TEXTTEST
H.5.1
Configuring Document Tests
H.5.2
Configuring URL Tests
H.5.3
URL Tests and Proxies
H.5.4
Specifying Proxies for Use with URL Indexing Tests
H.6
Descriptions of TEXTTEST Tests
H.6.1
Connect to Database as User sys
H.6.2
Create textcase Schema
H.6.3
Grant DBA Role to textcase Schema
H.6.4
Grant CTXAPP Role to textcase Schema
H.6.5
Disconnect From sys
H.6.6
Connect to textcase Schema
H.6.7
Create textcase Item Related Tables
H.6.8
Populate Item Tables
H.6.9
Create Document Table
H.6.10
Populate Document Table
H.6.11
Create URL Table
H.6.12
Populate URL Table
H.6.13
Create Oracle Text Datastore Procedure
H.6.14
Create Oracle Text Preferences
H.6.15
Create Lexer Preferences
H.6.16
Create Section Group and Zone Sections
H.6.17
Create Oracle Text Item Index
H.6.18
Create Oracle Text Document Index
H.6.19
Create Oracle Text URL Index
H.6.20
Touch All Item Content So That Pending
H.6.21
Touch All Document Content So That Pending
H.6.22
Touch All URL Content So That Pending
H.6.23
Synchronize Item Index
H.6.24
Synchronize Document Index
H.6.25
Synchronize URL Index
H.6.26
Drop Datastore Procedure from ctxsys
H.6.27
Disconnect From textcase Schema
H.6.28
Connect As User sys
H.6.29
Drop textcase Schema
H.6.30
Disconnect From Database
I
Configuring the Portal Tools Providers
I.1
Configuring Web Clipping
I.1.1
Configuring the Web Clipping Repository
I.1.2
Registering the Web Clipping Provider (PDK Only)
I.1.3
Configuring HTTP or HTTPS Proxy Settings
I.1.3.1
Configuring Proxy Settings Using the Web Clipping Test Page
I.1.3.2
Setting Proxy Settings Manually
I.1.3.3
Restricting Users from Clipping Content from Unauthorized External Web Sites
I.1.4
Configuring Caching
I.1.4.1
Configuring Caching Using the Web Clipping Test Page
I.1.4.2
Configuring Caching Manually
I.2
Configuring OmniPortlet
I.2.1
Configuring the OmniPortlet Provider
I.2.1.1
Configuring HTTP or HTTPS Proxy Settings
I.2.1.2
Configuring the Secured Data Repository (PDK only)
I.2.1.3
Configuring Caching (PDK Only)
I.2.1.4
Configuring OmniPortlet to Access HTTPS URLs
I.2.2
Performing Optional OmniPortlet Configurations
I.2.3
Registering the OmniPortlet Provider (PDK Only)
I.2.4
Configuring the OmniPortlet Provider to Access Other Relational Databases Using DataDirect JDBC Drivers
I.2.4.1
Installing DataDirect JDBC Drivers
I.2.4.2
Registering DataDirect Drivers in OmniPortlet
J
Setting Up and Maintaining a Virtual Private Portal
J.1
Overview of Hosting
J.1.1
Why Use Hosting?
J.1.2
Known Limitations
J.2
Overview of Steps to Perform for Virtual Private Portals
J.2.1
Enabling Hosting
J.2.2
Setting Up Users and Groups
J.2.3
Adding Subscribers
J.2.4
Removing Subscribers
J.2.5
Advanced Features
J.2.6
Pre-Installation Checklist
J.2.7
Using Oracle Directory Manager
J.3
Enabling Hosting on an Out-of-the-Box Portal
J.4
ASP Users And Groups
J.4.1
Setting Up ASP Users and Groups
J.4.2
Restrictions
J.5
Adding Subscribers
J.6
Advanced Operations on a Virtual Private Portal
J.6.1
Managing ASP Users and Groups
J.6.1.1
Password Sync
J.6.1.2
Delta (Structure Changes) Sync
J.6.1.3
Complete Sync
J.6.2
Removing Subscribers
J.6.3
Using WebDAV in the Virtual Private Portal
J.6.4
Using Oracle Ultra Search with the Virtual Private Portal
J.6.5
Setting Up Directory Integration Platform for the Virtual Private Portal
J.6.6
Partially Prepare (Pre-Cook) Subscribers
J.7
Restrictions
J.7.1
Scripts
J.7.2
ASP Users/Groups Support
J.7.3
Add Subscriber
J.7.4
Remove Subscriber
J.7.5
Upgrade
J.8
Parameters for the Scripts
K
Troubleshooting OracleAS Portal
K.1
Problems and Solutions
K.1.1
Unable to Access OracleAS Portal
K.1.2
Unable to Log In to OracleAS Portal
K.1.3
Problems with Oracle Application Server Integration Configuration
K.1.4
Problems Creating Category or Perspective Pages
K.1.5
Problems with Network Address Translation (NAT) Setup
K.1.6
User and Group Information in OracleAS Portal and Oracle Internet Directory Does Not Match
K.1.7
Problems with OracleAS Portal Performance
K.1.8
Error When Creating Web Folders
K.1.9
Create New Users and Create New Groups Portlets Do Not Appear
K.1.10
ORA-2000x Errors in the error_log File
K.1.11
Remote Web Providers Time Out in a Dynamic DNS Environment
K.1.12
Problems Related to Memory-Intense Operations
K.1.13
Problems with Oracle Text Installation
K.1.14
Unable to Create Oracle Text Indexes
K.1.15
Problems with MultiLanguage Support for Help
K.1.16
Stale Style-Sheet Data Is Displayed on Portal Pages
K.1.17
Stale Content Is Displayed on Portal Pages
K.1.18
Images Are Not Displayed on Portal Pages
K.1.19
Unhandled Exception Errors
K.1.20
Problems in Configuring the OmniPortlet Provider
K.1.21
Problems in Configuring OracleAS Web Cache for the OmniPortlet Provider
K.1.22
Problems in Accessing OracleAS Portal from a Mobile Device
K.1.23
Error During Export and Import After Upgrading from OracleAS Portal 3.0.9 or 9.0.4
K.2
Diagnosing OracleAS Portal Problems
K.2.1
Enabling ECID Logging
K.2.2
Generating Trace Files
K.2.2.1
Using PlsqlBeforeProcedure and PlsqlAfterProcedure
K.2.2.2
Setting the sql_trace Parameter
K.2.2.3
Setting Database Event 10046
K.2.3
Viewing the Diagnostic Output of Components
K.2.3.1
JPDK
K.2.3.2
Portal Services
K.2.3.3
Parallel Page Engine
K.2.3.4
Oracle Application Server Portal Developer Kit
K.2.3.5
OracleAS Metadata Repository
K.2.3.6
OracleAS Web Cache
K.2.4
Using Application Server Control Console Log Viewer
K.2.5
Using OracleAS Portal Diagnostics Assistant
K.2.6
Verifying the Portal Dependency Settings File
K.2.7
Analyzing Mobile-Related Problems in OracleAS Portal
K.3
Need More Help?
Index
