Skip Headers
Oracle® Application Server Portal Configuration Guide
10g Release 2 (10.1.2)
Part No. B14037-01
  Go To Documentation Library
Home
Go To Product List
Solution Area
Go To Table Of Contents
Contents
Go To Index
Index

Previous
Previous
Next
Next
 

4 Performing Basic Configuration and Administration

This chapter assumes that OracleAS Portal has been installed as part of the Oracle Application Server and addresses the basic tasks that the portal administrator can perform after installation is complete.

This chapter contains the following sections:

4.1 Getting Started with OracleAS Portal Administration

Basic OracleAS Portal configuration can be performed on the Administer tab available from OracleAS Portal. Additionally, there are other administrative tools available to configure OracleAS Portal, and its related components.

This section will introduce you to the various different administrative tools:

4.1.1 Using the OracleAS Portal Administer Tab

The OracleAS Portal framework provides administrative services, such as access to monitoring and configuration tools, single sign-on, directory integration, caching, and security. A lot of the features needed to manage users and groups, to set up security and search features, and to administer the portal and database are incorporated into a series of dialog boxes accessed through portlets on a Portal page.

After you have installed OracleAS Portal, you need to log in as an administrator, to perform various administrative functions.

After you have logged in to OracleAS Portal, the Portal Builder page is displayed to you, as shown in Figure 4-1:

Figure 4-1 The Portal Builder Page

Description of cg_sshot_builder.gif follows
Description of the illustration cg_sshot_builder.gif

Click the Administer tab to view all the sub-tabs and portlets that help you administer the Portal. The Administer tab is shown in Figure 4-2.

Figure 4-2 The Administer Tab on the Portal Builder Page

Description of cg_sshot_administer_tab.gif follows
Description of the illustration cg_sshot_administer_tab.gif

You will see the following sub-tabs in the Administer tab screen:

  • Portal - This sub-tab enables you to create users and groups, administer the SSO server, and administer other services including Oracle Internet Directory, Oracle Ultra Search, Oracle Application Server Web Cache, proxy settings, and so on.

  • Portlets - This sub-tab enables you to view the Portlet repository and its refresh log file contents, and register remote providers and provider groups.

  • Database - This sub-tab enables you to create and edit database schemas, create and edit database roles, and monitor database information like database parameters, memory consumption, and database storage details.

Portal

This sub-tab under the Administer tab in the Builder page contains the portlets shown in Table 4-1. This sub-tab is displayed by default when you click the Administer tab.

Table 4-1 Portlets in the Portal Sub-Tab

Portlet Name Enables You to
Services
  • Specify default home page, default style, and so on.
  • Administer users and groups in the Oracle Internet Directory or configure the directory settings.

  • Administer log registry.

  • Establish basic and advanced search features.

  • Specify Proxy Server settings.

  • Administer and monitor the performance of OracleAS Portal and its dependent components such as the Oracle HTTP Server, mod_plsql Services, Parallel Page Engine Services, OracleAS Web Cache, OracleAS Metadata Repository, Oracle Ultra Search, and providers using the Oracle Enterprise Manager 10g Application Server Control Console.

See Chapter 7, "Monitoring and Administering OracleAS Portal" for more information on administering the log registry and monitoring Portal performance.

SSO Server Administration
  • Edit SSO Server configuration.
  • Create or edit configuration information for partner applications.

  • Create or edit configuration information for external applications.

See Chapter 6, "Securing OracleAS Portal" for more information.

Note: You will need to login as an Oracle Application Server administrator, such as orcladmin, to change SSO settings. The Portal administrator (portal) does not have sufficient privileges to edit components other than OracleAS Portal.

Export/Import Transport Set
  • Export a transport set.
  • Import a transport set.

  • Browse the status of, download scripts for, reuse, or delete transport sets.

See Chapter 10, "Exporting and Importing Content" for more information.

User
  • Create new users and specify account information.
  • Edit or delete users.

Portal User Profile
  • Establish the user's preferences and global privilege information in the Portal.
Group
  • Create groups, assign users to them, and designate group administrators.
  • Edit or delete groups.

Portal Group Profile
  • Establish the group's preferences and privilege information in the Portal.

Portlets

This sub-tab under the Administer tab in the Builder page contains the portlets shown in Table 4-2.

Table 4-2 Portlets in the Portlets Sub-Tab

Portlet Name Enables You To
Portlet Repository
  • View and refresh all local and remote portlets.
  • Refresh information about all the portlets in the repository.

  • View Portlet Repository refresh log.

Remote Providers
  • Add a provider to the portlet repository.
  • Change configuration and access information about a provider.

Remote Provider Group
  • Register multiple providers with a single URL.
  • Edit a Provider Group registration.


Database

This sub-tab under the Administer tab in the Builder page contains the portlets shown in Table 4-3.

Table 4-3 Portlets in the Database Sub-Tab

Portlet Name Enables You To
Schemas
  • Create new database schemas, or edit existing schemas.
Roles
  • Create new database roles, or edit existing roles.
Database Information
  • Monitor and view various database related information and parameters.
Database Memory Consumption, Transactions and Locks
  • Monitor database jobs.
  • View reports and charts of memory consumption and transactions.

  • Monitor session and locks.

  • Terminate undesirable user sessions.

Database Storage
  • Monitor and view various database storage related information.

4.1.2 Using Additional Administrative Tools

For some administrative tasks that cannot be performed through the OracleAS Portal Administer tab, you may need to use one of the following tools:

4.1.2.1 Oracle Enterprise Manager 10g Application Server Control Console

The Oracle Enterprise Manager 10g Application Server Control Console is included when you install Oracle Application Server. From OracleAS Portal's perspective, consider this to be the administration console for the Oracle Application Server. The Application Server Control Console enables you to perform the following administration and configuration operations:

  • Enable and disable components

  • Administer clusters

  • Start and stop services

  • View logs and ports

  • Perform real-time monitoring

  • Modify the OracleAS Infrastructure services used by an Oracle Application Server middle-tier.

These functions of the Application Server Control Console are described in more detail in Chapter 7, "Monitoring and Administering OracleAS Portal".

4.1.2.2 Portal Dependency Settings File and Tool

OracleAS Portal is dependent on the components: Oracle Application Server Web Cache and Oracle Internet Directory. It may be necessary to fine tune, or configure these components after Oracle Application Server is installed.

To simplify configuration changes, OracleAS Portal introduces the Portal Dependency Settings File. This file stores configuration data from all the dependent components in a central place and the content of the file is updated when there are configuration changes.

You can use the Portal Dependency Settings file to:

  • Check settings used by an OracleAS Portal instance.

  • Update settings in the Oracle Application Server Metadata Repository.

The Portal Dependency Settings file is described in more detail in Appendix A, "Using the Portal Dependency Settings Tool and File".

4.1.2.3 Portal Installation and Configuration Scripts

There are also various scripts, copied to your ORACLE_HOME during the installation of OracleAS Portal, These scripts may be needed to perform administrative actions, and are described in more detail in Appendix C, "Using OracleAS Portal Installation and Configuration Scripts".

4.2 Finding Out Information About Portal

This section covers the following topics:

4.2.1 Accessing OracleAS Portal in Your Browser

After OracleAS Portal is installed, access it by entering the following URL in your browser:

http://<hostname>:<portnumber>/pls/<dad>

For an explanation of the URL components, see Table 3-1, "Portal URL Descriptions".

4.2.2 Finding Your OracleAS Portal Version Number

To find your Portal version number:

  1. In the Portal Builder, click the Administer tab.

  2. Click the Portal sub-tab.

  3. In the Services portlet, click the Global Settings link.

    The version number for your OracleAS Portal is shown at the bottom of the page.

4.3 Performing Basic Page Administration

This section covers the following topics:

4.3.1 Setting a Default Home Page

The home page is the first page that is displayed to a user after logging in to Oracle Portal. Here's how the logic works:

  • If the user has specified a personal home page, that page is displayed when the user logs on.

  • If the user has not selected a personal home page, but the portal administrator has set one for him or her, the default home page specified for that user is displayed.

  • If the user has not selected a personal home page, but belongs to a default group, the default home page specified for that group is displayed.

  • If there is no default home page for the user's default group, the system default home page is displayed.

If mobile support is enabled, you can specify a default mobile home page to display when a user accesses the portal from a mobile device.


Note:

You must be the portal administrator to define a default home page for the system, a group, or a user.

4.3.1.1 Setting the System Default Home Page

If there is no default home page for the user's default group, the system default home page is displayed.

To set the system default home page:

  1. In the Services portlet, click Global Settings.

    By default, the Services portlet is on the Portal sub-tab of the Administer tab on the Portal Builder page.

  2. Next to the Default Home Page field, click the Browse Pages icon to see a list of pages from which to choose.


    Note:

    You cannot enter a value in this field; you must select one from the list.

  3. Click Return Object next to the page you want to make the system default home page.

  4. Click OK.


    Note:

    To check that you set the system default home page correctly, log out of the portal and log back in again. When you log back in, you should be taken the page that you specified as the system default home page.

4.3.1.2 Setting a Group's Default Home Page

If the user has not selected a personal home page, but belongs to a default group, the default home page specified for that group is displayed.

To set a group's default home page:

  1. In the Portal Group Profile portlet, in the Name field, enter the name of the group for which you want to assign a default home page.

    By default, the Portal Group Profile portlet is on the Administer tab of the Builder page.


    Note:

    If you are not sure of the group name, click the Browse Groups icon and select from the list provided.

  2. Click Edit.

  3. Next to the Default Home Page field, click the Browse Pages icon to see a list of pages from which to choose.


    Note:

    You cannot enter a value in this field; you must select one from the list.

  4. Click Return Object next to the page you want to make the default home page for this group.

  5. Click OK.


    Note:

    Click Reset to reset the group's default home page to the system default home page.

4.3.1.3 Setting a User's Default Home Page

If the user has not selected a personal home page, but you have set one for him or her, the default home page specified for that user is displayed.

To set a user's default home page:

  1. In the Portal User Profile portlet, in the Name field, enter the username of the user for whom you want to assign a default home page.

    By default, the Portal User Profile portlet is on the Administer tab of the Builder page.


    Note:

    If you are not sure of the username, click the Browse Users icon and select from the list provided.

  2. Click Edit.

  3. Next to the Default Home Page field, click the Browse Pages icon to see a list of pages from which to choose.


    Note:

    You cannot enter a value in this field; you must select one from the list.

  4. Click Return Object next to the page you want to make the default home page for this user.

  5. Click OK.


    Note:

    Click Reset to reset the user's default home page to the system default home page.

4.3.2 Setting the System Default Style

If you are the portal administrator, you are responsible for selecting a style to serve as the system default.

When a style is deleted, all pages and item regions that used the style revert to the page group default style. If the page group default style is <None>, all pages and regions revert to the system default style.


Note:

To set the system default style, you must be the portal administrator.

To set the system default style:

  1. In the Portal Builder, click the Administer tab.

  2. Click the Portal sub-tab.

  3. In the Services portlet, click the Global Settings link.

    By default, the Services portlet is on the Portal sub-tab of the Administer tab on the Portal Builder page.

  4. In the Default Style section, choose a style from the Display Name list.


    Note:

    The list includes all public styles in the Shared Objects page group.

  5. Click OK to return to the Portal Builder.

4.3.3 Creating Personal Pages

A personal page provides an area within OracleAS Portal where authorized users can store and share their own content. Personal pages are located under the Shared Objects page group, and are organized alphabetically by user name.


Note:

To create personal pages for users, you must be the portal administrator.

This section covers the following topics:

4.3.3.1 Automatically Creating a Personal Page for New Users

To configure OracleAS Portal to automatically create a personal page for new users:

  1. In the Services portlet, click Global Settings.

    By default, the Services portlet is on the Portal sub-tab of the Administer tab on the Portal Builder page.

  2. Ensure that you are on the Main tab.

  3. Select Create Personal Pages for New Users.

  4. Click OK.

Whenever a new user logs on for the first time, a personal page is automatically created for that user.


Notes:

  • Personal pages are automatically created when new users log on for the first time (that is, when the user record is created for the user), not for users that already exist.

  • If you create a new user and then edit that user's profile before he or she logs on for the first time, a personal page will not be created when that user logs on for the first time. This is because editing the user's profile creates the user record, so when the user logs in, he or she is not considered a new user.


4.3.3.2 Creating a Personal Page for an Existing User

To configure OracleAS Portal to create a personal page for an existing user:

  1. In the Portal User Profile portlet:

    1. In the Name field, enter the name of the user for whom you want to create a personal page.


      Note:

      If you are not sure of the name of the user, click the Browse Users icon and select from the list provided.

    2. Click Edit.

    By default, the Portal User Profile portlet is on the Administer tab of the Builder page.

  2. Ensure that you are on the Preferences tab.

  3. Select Create Personal Page.


    Note:

    If you do not see this check box, the user already has a personal page.

  4. Click OK.


    Notes:

    • Personal pages are accessible from the Navigator in the Shared Objects page group. Any authorized user can drill down into the Personal Pages area of the Shared Objects page group, but they can only view their own personal page, or those personal pages to which they have been granted access.

    • Personal pages for users with user names that do not begin with an alphabetic character are located under the Others area of Personal Pages.

    • Personal pages cannot be deleted.


4.3.4 Setting the Total Space Allocated for Uploaded Files

You can limit the amount of space provided in your database to store documents uploaded to page groups. If you want to limit the amount of space provided for a single page group, see Section 4.3.6, "Changing the Page Group Quota".

You can also limit the size of individual files that content contributors can upload to page groups. See Section 4.3.5, "Setting the Maximum File Size for Uploaded Files" for more information.

When a user uploads a file to the portal, the upload is monitored in the middle-tier to detect if the total space or maximum file size are exceeded. If either of these limits is exceeded, the upload is terminated and an error message is displayed.


Note:

To set the total space allocated for uploaded files, you must be the portal administrator.

To set the total space allocated for uploaded files:

  1. In the Services portlet, click Global Settings.

    By default, the Services portlet is on the Portal sub-tab of the Administer tab on the Portal Builder page.

  2. Make sure you are on the Main tab.

  3. In the Total Space Allocated radio group, select Limit To to limit the amount of space provided to store files uploaded to the page groups in this portal.

  4. In the field, enter the maximum amount of megabytes provided for uploaded files across the whole portal. When this limit is reached, users will no longer be able to upload files to page groups in the portal.


    Notes:

    • Select No Limit if you do not want to impose a limit for uploaded files.

    • The Used Space field displays the amount of space currently used by documents uploaded to page groups in this portal.


  5. Click OK.

4.3.5 Setting the Maximum File Size for Uploaded Files

You can limit the size of individual files that users can upload to the page groups in your portal.

You can also limit the total amount of space provided in your database to store documents uploaded to page groups. See Section 4.3.4, "Setting the Total Space Allocated for Uploaded Files" for more information.

When a user uploads a file to the portal, the upload is monitored in the middle-tier to detect if the maximum file size or portal file quota is exceeded. If either of these limits is exceeded, the upload is terminated and an error message is displayed.


Note:

To set the maximum file size for uploaded files, you must be the portal administrator.

To set the maximum file size for uploaded files:

  1. In the Services portlet, click Global Settings.

    By default, the Services portlet is on the Portal sub-tab of the Administer tab on the Portal Builder page.

  2. Make sure you are on the Main tab.

  3. In the Maximum File Size radio group, select Limit To to specify the maximum size allowed for individual files uploaded to the portal.

  4. In the field, enter the maximum size (in MB) for each individual file uploaded to the portal. If a content contributor attempts to upload a file larger than this size, an error is displayed.


    Note:

    Select No Limit if you do not want to impose a maximum file size.

  5. Click OK.

4.3.6 Changing the Page Group Quota

You can limit the amount of space provided in your page group to store uploaded documents.


Note:

To change the page group quota, you must have at least one of the following privileges:
  • Portal administrator

  • Manage all privileges on the page group

  • Manage all global privileges on all page groups


To change the page group quota:

  1. In the Portal Navigator page, click the Page Groups tab.

  2. Click Properties next to the page group with which you want to work.

  3. In the Page Group Quota section, select Limit to to limit the amount of space provided to store uploaded documents.

  4. In the field provided, enter the size limit (in MB) for uploaded documents in the page group. When this limit is reached, users will no longer be able to upload documents to the page group.


    Note:

    Select No limit if you do not want to impose a limit for uploaded documents.

  5. Click OK.

4.3.7 Specifying an Error Message Page

OracleAS Portal enables you to choose the error message page that you want to display to users. You can choose the default system error page, or you can specify your own customized error page.

OracleAS Portal includes an error message page (called Sample Error Page) that you can edit to match the look and feel of the other pages in your portal. The Sample Error Page is available under the Portal Design-Time page group and includes a portlet that displays all the diagnostic information. Alternatively, you can create your own error message page in any of your page groups. To do this, you must include the Error Message Portlet on the page and turn caching off.


Note:

By default, the Error Message Portlet is located under the Administration Portlets page of the Portlet Repository.

To specify an error message page:

  1. In the Services portlet, click Global Settings.

    By default, the Services portlet is on the Portal sub-tab of the Administer tab on the Portal Builder page.

  2. In the Error Page section, select one of the following:

    • System Error Page to use the system error page to display full-page error messages to users. The system error page automatically includes all the diagnostic information.

    • Error Page to use your own page to display full-page error messages to users. Click the Browse Pages icon to select the error message page that you want to use.

  3. Click OK.

4.3.8 Setting the Page Users See When They Log Out

You can specify the page that is displayed to users after they have logged out by setting the default home page for the PUBLIC (that is, non-authenticated) user.


Note:

You must be the portal administrator to define a default home page.

To set the page users see when they log out:

  1. In the Portal User Profile portlet, in the Name field, enter PUBLIC.

    By default, the Portal User Profile portlet is on the Administer tab of the Builder page.

  2. Click Edit.

  3. Next to the Default Home Page field, click the Browse Pages icon to see a list of pages from which to choose.


    Note:

    You cannot enter a value in this field; you must select one from the list.

  4. Click Return Object next to the page you want to be displayed when users log out.

  5. Click OK.


    Note:

    Click Reset to remove this setting.

4.3.9 Removing the Context-Sensitive Help Link

If you have access to SQL*PLUS, you can suppress the Context-sensitive Help link that appears in the banner in OracleAS Portal wizards, dialog boxes, alerts, and so on. Note that you cannot suppress the "?" icon that appears in the blue bar of wizards, dialog boxes, and alerts.

You cannot perform this task through the UI; it must be done programmatically through SQL*PLUS.


Note:

You must make the following API calls in both the portal schema and in the portal SSO schema.

To remove the context-sensitive help icon:

  1. Access SQL*PLUS.

  2. Enter:

    exec wwui_api_body.set_display_help (wwui_api_body.DISPLAY_HELP_OFF);
    
    

To re-instate the context-sensitive help icon:

  1. Access SQL*PLUS.

  2. Enter:

    exec wwui_api_body.set_display_help (wwui_api_body.DISPLAY_HELP_ON);
    commit;
    

4.4 Configuring Self-Registration

To enable users to create their own portal user accounts, you must configure the self-registration feature. After completing this process the self-registration link is exposed in the Login portlet.

You can set up an approval process for self-registered users so that they cannot log in until their accounts have been approved. When the account has been approved or rejected, the user is notified by e-mail.

If you do not require approval for self-registered users, the user will be able to log in to the portal immediately after registering.


Note:

To set up self-registration, you must be the portal administrator.

To set up self-registration:

  1. In the Services portlet, click Global Settings.

    By default, the Services portlet is on the Portal sub-tab of the Administer tab on the Portal Builder page.

  2. In the Self-Registration Options section, select Enable Self-Registration.

  3. Select No Approval Required if self-registered users can log on to the portal immediately after registering.

  4. Select Approval Required if self-registered users need to be approved before they can log on to the portal.

    1. Click Configure to set up the approval process.

    2. In the Recipients field, enter the names of the users or groups that you want to approve self-registered users.


      Note:

      Use a semicolon (;) as the separator between multiple users or groups. Each step of the approval routing can include both users and groups.

    3. In the Routing Method radio group, choose:

      • One at a time, all must approve if you want each user or group to be notified in turn and every user or group must approve self-registered users before they can log on.

      • All at the same time, all must approve if you want all the users and groups to be notified at the same time and every user or group must approve self-register users before they can log on.

      • All at the same time, only one must approve if you want all the users and groups to be notified at the same time, but only one user or group member must approve self-registered users before they can log on.

    4. Click Add Step.

    5. Repeat steps a to d to add more steps to the approval process.


      Notes:

      • You do not need to change any other settings on this tab, or any of the settings on the other tabs in this screen.

      • The final approver, in the approval chain, must have an e-mail address defined in Oracle Internet Directory, along with the privilege to enable self-registration users. To do this, grant Allow account management privilege to the approver. In the case of Oracle Internet Directory or Oracle Delegated Administration Services versions older than 10.1.2, grant Allow user editing privilege to the approver.


    6. Click OK to return to the Global Settings screen.

    7. In the E-Mail (SMTP) Host section, enter the Host Name and Port of your e-mail server so that self-registered users can be informed by e-mail when their accounts are accepted or rejected.

  5. Click OK.

  6. Go to the home page of your portal.

  7. Switch to Edit mode.

  8. If the home page of your portal does not already contain a Login portlet, add the Login portlet to the page.

    By default, the Login portlet can be found in the SSO/OID page under the Administration page in the Portlet Repository.

  9. Next to the Login portlet, click the Actions icon.

  10. Click Edit Defaults.

  11. Select Enable Self-Registration.

  12. In the Self-Registration Link Text field, enter the text that you want users to click to register with the portal.

  13. Leave the Self-Registration URL field blank to use OracleAS Portal's own self-registration screen.

    If you have created your own self-registration screen, enter the URL in this field.

  14. Click OK.

4.5 Performing Basic Portal Administration

This section covers the following topics:

4.5.1 Simplifying the Full URL of an OracleAS Portal Instance

You can simplify the full URL created by the OracleAS Portal installation to a more memorable or meaningful URL using the Redirect directive. In this way, end users can access OracleAS Portal by entering a simple URL.

By default, the URL for a new OracleAS Portal installation requires you to enter:

http://<hostname>:<portnumber>/pls/dad

You can simplify this URL to:

http://<hostname>/redirectpath


Note:

Do not simplify the OracleAS Portal URL to http://host:port/portal. This is because OracleAS Portal is already mounted on /portal.

  1. Open the Oracle HTTP Server configuration file, httpd.conf. This file is located in the following directory:

    ORACLE_HOME/Apache/Apache/conf/
    
    
  2. Enter the redirect path as follows:

    Redirect /DADnamepath http://hostname:portnumber/pls/dad
    
    

    For example:

    Redirect /portalhome http://mysite.oracle.com/pls/portal
    
    

    In this example, end users can enter:

    http://mysite.oracle.com/portalhome
    
    

    to access the full URL, which is:

    http://mysite.oracle.com/pls/portal
    
    

    Note:

    • The example http://mysite.oracle.com/portalhome assumes that the default port 80 is being used. If the default port is not being used, then the user would have to enter the URL with the port number, http://mysite.oracle.com:<port>/portalhome.

    • You can also edit the httpd.conf file using the Oracle Enterprise Manager 10g Application Server Control Console.

    If the httpd.conf file is updated manually, you must synchronize the manual configuration changes done on the middle-tier by running ORACLE_HOME/dcm/bin/dcmctl as follows:

    dcmctl updateConfig -ct ohs

    Finally, restart Oracle HTTP Server, by running the following command from ORACLE_HOME/opmn/bin:

    opmnctl restartproc type=ohs


4.5.2 Configuring Oracle HTTP Server to Use the OracleAS Portal Home Page

To set the OracleAS Portal home page as the Oracle HTTP Server's default home page:

  1. In the directory ORACLE_HOME/Apache/Apache/htdocs/, make a backup copy of the files index.html.html and index.html.<lang>, where <lang> is the language code. For example, index.html.en is the index HTML file for English.

  2. Edit index.html.<lang> by replacing the entire contents of the file with the following HTML redirection code:

    <HTML>
    <SCRIPT LANGUAGE=JavaScript>
    document.location="http://host.domain:port/pls/portal"
    </SCRIPT>
    </HTML>
    
    

    Notes:

    • Do not specify a port number if you are running OracleAS Portal on port 80.

    • If you plan to support other languages, you need to have the language-specific index HTML files with the redirection code, for these languages.


4.5.3 Configuring a Portal DAD

mod_plsql provides support for building and deploying PL/SQL-based applications on the Web. PL/SQL stored procedures can retrieve data from database tables and generate HTTP responses containing formatted data and HTML code to display in a Web browser.

A Database Access Descriptor (DAD) is a set of values that specify how an application connects to an Oracle Database to fulfill an HTTP request. The information in the DAD includes the user name (which also specifies the schema and the privileges), password, connect-string and Globalization Support language of the database.

There are two types of DADs: general DADs and Portal DADs. An OracleAS Portal middle-tier uses a Portal DAD to access the OracleAS Metadata Repository, which is discussed in this section. For information on general DADs, refer to the Oracle HTTP Server Administrator's Guide.

You configure DAD information from the mod_plsql Services page in the Oracle Enterprise Manager 10g Application Server Control Console. See Figure 4-3.

Figure 4-3 Application Server Control Console - DAD Configuration

Description of cg_basic_sshot_createdad.gif follows
Description of the illustration cg_basic_sshot_createdad.gif

You can access the mod_plsql Services page from:

  • Application Server Control Console - As described next.

  • OracleAS Portal - Select Portal Service Monitoring in the Services portlet (Administer tab) to access the Application Server Control Console. Then select mod_plsql Services from the Component Status table.

To configure a Portal DAD from the Application Server Control Console:

  1. Navigate to the Application Server Control Console.

    Typically, http://<host>.<domain.com>:1812. For more information, see Section 7.2, "Using the Application Server Control Console".

  2. Navigate to the Application Server instance where you would like to add the DAD.

  3. Select HTTP Server from the System Components table.

  4. Click Administration.

  5. Click PL/SQL Properties.

  6. In the DADs section, click Create to configure a new DAD.

    From the DADs section you can also maintain existing DADs. To edit an existing DAD, click the DAD Name. To delete a DAD, select the DAD Name and click Delete.

  7. For DAD Type, choose Portal and then click Continue.

  8. For DAD Name or Location, specify the path that points to the default DAD.


    WARNING:

    Do not enter non-ASCII (such as multibyte) characters for the DAD Name.


  9. Enter Database Connection information (see Figure 4-3):

    • Username - Enter the Oracle database account username.

    • Password - Enter the Oracle database account password. The password is typically set at installation, but you can change it by typing a new password in this field.

      If you leave the Oracle User Name and Oracle Password fields blank, the user is prompted to enter a username and password when first logging in.

    • Connect String - Enter the connection string (if the database is remote) and then use the Connection String Format property to specify the format of the connect string you have entered here.

      Leave this field blank if the database is local.

    • Connect String Format - Specify the format used for the Connect String property.

      If the Connection String Format is not specified, mod_plsql assumes the connect string format is either SIDFormat (host:port:sid) or, resolvable as NetServiceNameFormat. The differentiation between the two is made by the presence of colon characters (:) in the connect string.

      For database installations like Real Application Clusters (RAC), it is recommended that users configure the connect string using the NetServiceNameFormat such that the lookup is through LDAP. This allows database nodes to be for added/removed without having to reconfigure each Oracle Application Server middle-tier separately to recognize added/removed nodes.

    • NLS Language - Enter the NLS (Globalization Support) language that is represented throughout the DAD, that is, the Globalization Support language of the back-end Database. Use the format <NLS_LANGUAGE>_<NLS_TERRITORY>.<NLS_CHARACTERSET>, for example, American_America.UTF8.

      To obtain these values, query the nls_database_parameters table as follows:

      select value, parameter from nls_database_parameters where 
      parameter in ('NLS_LANGUAGE','NLS_TERRITORY','NLS_CHARACTERSET');
  10. Click Apply.

  11. Restart the Oracle HTTP Server.

    Once restarted, the new DAD is accessible from the Oracle HTTP Server.

4.5.4 Clearing the Portal Cache

Sometimes you must clear the portal cache (the OracleAS Portal File System Cache). For example, if you change the character set of the OracleAS Metadata Repository. In such cases, the existing content in the Portal cache will be invalid, as it will continue to have content configured to use the older character set.

To clear the Portal cache:

  1. Navigate to the Portal cache directory. The default path is ORACLE_HOME/Apache/modplsql/cache.

  2. Perform a recursive delete of all the files under this directory. For example, on UNIX platforms, issue the following command:

    rm -rf * 
    
    

    WARNING:

    Ensure that you are in the correct directory before issuing this command. Do not delete the cache directory.


4.5.5 Using a Custom Image Directory

To avoid losing custom images stored in the OracleAS Portal images directory (which is ORACLE_HOME/portal/images by default) during a future upgrade, it is recommended that you create your own images directory and set up an appropriate Oracle HTTP Server alias for this directory.

For example, add an entry, similar to the one shown next, to the file ORACLE_HOME/portal/conf/portal.conf. It is recommended that you use the local Oracle Enterprise Manager 10g Application Server Control Console instance to make this change. For more information, refer to the Oracle HTTP Server Administrator's Guide or the Oracle Application Server Web Cache Administrator's Guide.

Alias /mycompany/images/ "/opt/app/myportal/images/"
<Directory "/opt/app/myportal/images/">
     AllowOverride None
     Order allow,deny
     Allow from all
     ExpiresActive on
     ExpiresDefault A2592000
  <Files *>
     Header set Surrogate-Control 'max-age=2592000'
  </Files>
</Directory>

You do not need to perform any specific OracleAS Web Cache configuration as OracleAS Web Cache is already configured to globally cache .bmp, .gif, .png, .jpg, and .jpeg files.

4.6 Configuring Mobile Support in OracleAS Portal

This section discusses how OracleAS Portal and Oracle Application Server Wireless are configured to operate together. OracleAS Portal pages can be viewed from a wide variety of devices including desktop browsers, mobile phones, and PDAs. OracleAS Portal uses OracleAS Wireless to provide wireless functionality to receive requests from wireless devices, and transform content provided by the portal into an appropriate format.

In this section we will describe the following:

4.6.1 What Is Installed By Default?

Performing a standard Oracle Application Server installation of OracleAS Portal and Oracle Application Server Wireless configures mobile support in Portal as follows:

  • A master service that provides mobile device access to the installed Portal is created, which refers to the Portal home page URL. As mobile access to Portal is mediated by OracleAS Wireless, a mobile device must communicate with OracleAS Wireless to access content on OracleAS Portal.

  • OracleAS Wireless service's URL refers to OracleAS Portal. Users that access this OracleAS Wireless service will be directed to the public home page of the Portal. When a mobile browser contacts OracleAS Portal through the home URL, the request will be redirected to the OracleAS Wireless service.

4.6.2 Configuring Mobile Settings in OracleAS Portal

You can change most of these mobile settings using a standard desktop browser.

To modify mobile settings:

  1. In the Services portlet, click Global Settings.

    By default, the Services portlet is on the Portal sub-tab of the Administer tab on the Portal Builder page.

  2. Click the Mobile tab.

Figure 4-4 The Mobile Tab in the Global Settings Page

Description of cg_iasw_mobiletab.gif follows
Description of the illustration cg_iasw_mobiletab.gif

All the options for setting mobile options for OracleAS Portal are found here.


Note:

In a hosted environment, you can control each subscriber individually. The exception to this is the OracleAS Wireless service URL setting. When OracleAS Portal is operating in hosted mode (with multiple subscribers), any change to the OracleAS Wireless service URL must be made by the hosting administrator, using a command line script, as it affects all subscribers.

In the Mobile Settings page, you can perform the following actions:

4.6.2.1 Enabling Mobile Access

This setting controls the response of OracleAS Portal to mobile clients that request portal pages by connecting through OracleAS Wireless.

If you want OracleAS Portal to be able to return pages and portlets in response to mobile requests, you must select the Enable Mobile Access option in the Mobile tab. If you do not select this option, OracleAS Portal responds to mobile requests with a message stating that it is not mobile enabled.

To enable mobile access:

  1. In the Services portlet, click Global Settings.

    By default, the Services portlet is on the Portal sub-tab of the Administer tab on the Portal Builder page.

  2. Click the Mobile tab.

  3. Select the Enable Mobile Access option.

  4. Click OK.

More on OTN

You'll find additional information about how OracleAS Portal responds to mobile requests, in the article "Life Cycle of a Mobile Request," on Oracle Technology Network (OTN), http://www.oracle.com/technology/.

When mobile friendly Portal pages are created, an option to preview the page as it would display in a mobile device, is available in the page editor. Selecting the Enable Mobile Access option in the Mobile tab enables the display of the Mobile: Preview option in the page editor.

Figure 4-6 Mobile Preview Option in the Page Editor

Description of cg_iasw_mobilepreview.gif follows
Description of the illustration cg_iasw_mobilepreview.gif

4.6.2.2 Enabling Mobile Page Design

This option enables page designers to create and edit pages using the mobile page editor, and also to specify mobile home pages. Pages of type Mobile are typically referred to as mobile pages.

To enable mobile page design:

  1. In the Services portlet, click Global Settings.

    By default, the Services portlet is on the Portal sub-tab of the Administer tab on the Portal Builder page.

  2. Click the Mobile tab.

  3. Select the Enable Mobile Page Design option.

    Figure 4-7 Enabling Mobile Page Design

    Description of cg_iasw_enablemobilepage.gif follows
    Description of the illustration cg_iasw_enablemobilepage.gif

  4. Click OK.

More on OTN

You'll find additional information about the dedicated mobile page editor, in the article "Using the Mobile Page Editor," on Oracle Technology Network, http://www.oracle.com/technology/.

In addition, if you select this option, the following screens display an extra field that allows the selection of a home page specific to mobile access of the OracleAS Portal:

  • Main tab in the Global Settings page of the Services portlet.

  • Preferences tab in the Portal User Profile portlet

  • Preferences tab in the Portal Group Profile portlet.

  • Edit Account Information page, accessed using the Account Info link.


    Notes:

    • Once a mobile page is created, it is possible to edit the page using the mobile page editor, even if the Enable Mobile Page Design option is not selected.

    • If the Enable Mobile Page Design option is not selected, page designers cannot create dedicated mobile pages. But if the option is selected, OracleAS Portal still supports mobile requests for standard pages (that is, pages that were not designed using the mobile page editor).


4.6.2.3 Logging Mobile Responses

This setting controls the logging of OracleAS Portal mobile portlet responses.

To enable logging of mobile responses:

  1. In the Services portlet, click Global Settings.

    By default, the Services portlet is on the Portal sub-tab of the Administer tab on the Portal Builder page.

  2. Click the Mobile tab.

  3. Select the Log Mobile Responses option.

    Figure 4-8 Logging Mobile Responses

    Description of cg_iasw_logresponses.gif follows
    Description of the illustration cg_iasw_logresponses.gif

  4. Click OK.

Portlet responses are logged if all the following conditions are met:

  • The Log Mobile Responses option is selected.

  • The user making the request is logged on.

  • The request is either from a mobile device, or it is for a mobile page.

More on OTN

You'll find additional information in the article "Provider Debugging Techniques: Using the Mobile Log Viewers," on Oracle Technology Network, http://www.oracle.com/technology/.


Note:

Enabling or disabling the Log Mobile Responses option results in all the currently cached page data being invalidated. It is recommended that you do not change this option frequently after your OracleAS Portal has been deployed for general access.

4.6.3 Manually Reconfiguring the Mobile Setup

An Oracle Application Server reconfiguration that has resulted in a change to the Oracle Application Server Wireless service URL or OracleAS Portal home page URL, requires the changes to be reflected in the stored information in OracleAS Portal, and the OracleAS Wireless service definition that refers to OracleAS Portal. You should reconfigure OracleAS Wireless and OracleAS Portal to ensure that the communication between them is not affected.

You have to manually reconfigure OracleAS Wireless and OracleAS Portal to update the values of the following referenced URLs, as required:

4.6.3.1 Updating the OracleAS Portal Home Page URL References

The OracleAS Portal home page URL is the address that OracleAS Wireless service definition refers to. If the home page URL has changed, you need to update the following references to it:

4.6.3.1.1 The Oracle Application Server Wireless Service Definition

Use the OracleAS Wireless Webtool to update the Portal service definition. Edit the URL value displayed in the Basic Info section of the OracleAS Wireless service definition that references OracleAS Portal. This section is accessible from the Services tab of the OracleAS Wireless Webtool. You access the Wireless Tools at:

http://server:port/mobile/
4.6.3.1.2 OracleAS Portal's Internal Reference to Itself

To change OracleAS Portal's own reference to its home page URL, use the script cfgiasw.csh (UNIX) or cfgiasw.cmd (Windows) to manually update the value. The script files are located here:

ORACLE_HOME/assistants/opca/cfgiasw.csh

To run the script, use the following command:

cfgiasw.csh -s portal -sp portal -c portal_db -h 'http://my_portal_server.com/pls/portal/portal.home'

The preceding example is specific to a UNIX machine. For more information on the cfgiasw script, see Section C.8, "Using the cfgiasw Script to Configure Mobile Settings".

4.6.3.2 Updating the OracleAS Wireless Portal Service URL Reference

Oracle Application Server Wireless is used by OracleAS Portal as an intermediary in providing access to mobile devices. To provide this access, OracleAS Portal must know the URL to the OracleAS Wireless service on which the Portal is registered. If the OracleAS Wireless service URL has changed, its reference within OracleAS Portal needs to be updated. This reference can be updated in either of the following ways:

4.6.3.2.1 Specify the OracleAS Wireless Portal Service URL Using the Global Settings Page

To update the value of the OracleAS Wireless Portal Service URL:

  1. In the Services portlet, click Global Settings.

    By default, the Services portlet is on the Portal sub-tab of the Administer tab on the Portal Builder page.

  2. Click the Mobile tab.

  3. Enter the URL in the OracleAS 10g Wireless Portal Service URL field.

    Figure 4-9 Specifying the OracleAS Wireless Portal Service URL

    Description of cg_iasw_wirelessurl.gif follows
    Description of the illustration cg_iasw_wirelessurl.gif

  4. Click OK.

You can change the OracleAS 10g Wireless Portal Service URL setting only when OracleAS Portal is not operating with multiple subscribers.

The Portal home page URL and Portal character set fields are for information only. If OracleAS Portal is operating with multiple subscribers, only the hosting administrator should change the value of OracleAS 10g Wireless Portal Service URL.

4.6.3.2.2 Use the cfgiasw Script to Update the OracleAS Wireless Service URL Reference

If you need to change OracleAS Portal's reference to the URL of Oracle Application Server Wireless Portal service, you can use the script cfgiasw.csh (UNIX) or cfgiasw.cmd (Windows) to manually set the value. The script files are located here:

ORACLE_HOME/assistants/opca/cfgiasw.csh

To run the script, use the following command:

cfgiasw.csh -s portal -sp portal -c portal_db -w 'http://my_iasw_server.com/ptg/rm?PAoid=12345'

The preceding example is specific to a UNIX machine. For more information on the cfgiasw script, see Section C.8, "Using the cfgiasw Script to Configure Mobile Settings".

4.7 Managing Users, Groups, and Passwords

For more information on managing users, groups and passwords, refer to Chapter 6, "Securing OracleAS Portal".

4.8 Configuring Browser Settings


See Also:

The Browser Recommendations section in the Preface of the Oracle Application Server Portal User's Guide.

4.9 Configuring Language Support

OracleAS Portal is designed to allow application development and deployment in different languages. This allows developers to work in their own language when they build portals. In addition, the self-service content management supports multiple languages so that end users can provide documents and other content in different languages.

OracleAS Portal is configured with the languages that are selected in the Oracle Universal Installer (OUI) during the Oracle Application Server middle-tier installation. Languages that are configured show up in the Set Language portlet. You can use OracleAS Portal in the language that corresponds to the language setting in the browser, or to the language you have selected in the Set Language portlet. The Set Language portlet is not available by default, and has to be added to the Portal Builder page. To configure additional languages after installation, you must use the ptllang tool.

Table 4-4 shows the languages that are available for OracleAS Portal.

Table 4-4 OracleAS Portal Languages and Language Abbreviations

Language Language Abbreviation
Arabic ar
Brazilian-Portuguese ptb
Canadian French frc
Czech cs
Danish dk
Dutch nl
English us
Finnish sf
French f
German d
Greek el
Hebrew iw
Hungarian hu
Italian i
Japanese ja
Korean ko
Latin American Spanish esa
Norwegian n
Polish pl
Portuguese pt
Romanian ro
Russian ru
Simplified Chinese zhs
Slovak sk
Spanish e
Swedish s
Thai th
Traditional Chinese zht
Turkish tr

To install languages, after you have installed OracleAS Portal, run ptllang. You must run ptllang for each language that you want OracleAS Portal to support.


Caution:

During login operations, information is sent to Oracle Application Server Single Sign-On. The language used in the authentication request is sent back to OracleAS Portal. OracleAS Single Sign-On must have all languages installed that exist on the OracleAS Portal, so that the selected language is recognized. If OracleAS Single Sign-On does not have the selected language installed, it will default to US English. This is the language that would be asserted to any OracleAS Portal that requested authentication in a language that is not available on OracleAS Single Sign-On.

The Set Language portlet in OracleAS Portal sets a language and a Persistent Language cookie on OracleAS Single Sign-On and OracleAS Portal.

If there are multiple portals configured to use the same OracleAS Single Sign-On, and the portals have different languages installed, all the combined languages must exist on the OracleAS Single Sign-On to accommodate a Set Language request from any of the portals.


Environment

Assumptions

The OracleAS Metadata Repository is already installed, and the respective databases are up.

Usage

ptllang  -lang lang_code [-i install_type] [ -s portal_schema] [-sp portal_schema_password] [-c portal_db_connect_string] 

Table 4-5 lists and describes parameters supported for the LANGUAGE mode.

Table 4-5 List of Supported Parameters for the LANGUAGE Mode

Parameter Definition
-i Installation type.

This can be set to typical and custom. In the typical mode, the script automatically connects to the registered OracleAS Metadata Repository. For Portal schemas in a customer database, use the custom mode.

Default: typical

-s OracleAS Portal schema name.

Default: portal

-sp OracleAS Portal schema password.
-c Connect string to the target database where OracleAS Metadata Repository is installed. The format must be DbHostName:DbPortNumber:DbServiceName.
-lang Abbreviation for the language to install. Refer to Table 4-4, "OracleAS Portal Languages and Language Abbreviations" for a list of all the supported abbreviations.

Usage example

Typical installation (-i typical)

Gets the details of the OracleAS Portal schema in the configured OracleAS Metadata Repository. The following example loads the Dutch language strings into the OracleAS Metadata Repository.

ptllang -lang nl 

Usage example

Custom installation (-i custom)

This example passes in the input provided on the command line. The example loads the Dutch language strings into the OracleAS Metadata Repository.

ptllang -i custom -s portal -sp portal -c  myDBhost.domain.com:1521:dbServiceName  -lang nl  

Enabling the Use of Territories

Once a language is installed into OracleAS Portal, the end user can select the language to be used from the languages displayed in the Set Language portlet.

OracleAS Portal's globalization support enables you to define the preferred Locale and Territory to be used for a given language. For example, Australian English, or Canadian French.

The Set Language portlet is not available by default, and has to be added to the Portal Builder page.

Adding the Set Language Portlet to the Portal Builder Page

To add the Set Language portlet to the Portal Builder page:

  1. Log in to OracleAS Portal as the Portal schema owner.

  2. Click the Administer tab in the Portal Builder page.

  3. Click Edit on top of the page.

  4. Select the column where you want to add the portlet, and click the Add Portlet icon located at the top of that column.

  5. In the Portlet Repository, click Portal Content Tools.

  6. Click Set Language in the Available Portlets area, and click OK.

    The Set Language portlet is now available in the Administer tab screen of the Portal Builder page.


    Note:

    If you add the Set Language portlet to a page and subsequently install another language, the new language is not displayed when you view the page. As a workaround, remove the portlet and add it to the page again.

  7. Click View Page to return to View mode.

Enabling the Use of Territories and Locales

To enable the use of territories and locales:

  1. Log in to OracleAS Portal as the Portal schema owner.

  2. Click the Edit Defaults icon for the Set Language portlet.

  3. In the Edit Set Language Portlet Settings screen shown, select the Enable Territory Selection option. The Edit Set Language Portlet Settings screen is shown in Figure 4-10.

    Figure 4-10 The Edit Set Language Portlet Settings screen

    Description of cg_basic_sshot_setlanguage.gif follows
    Description of the illustration cg_basic_sshot_setlanguage.gif

  4. Click OK.

By selecting the Enable Territory Selection option, the appropriate locales for each registered language are displayed. The locales are listed after the languages in the Set Language portlet, as shown in Figure 4-11.

Figure 4-11 The Set Language Portlet

Description of cg_basic_sshot_setlang.gif follows
Description of the illustration cg_basic_sshot_setlang.gif


Note:

The OracleAS Portal online help system, which uses Oracle Help for the Web, relies on certain fonts to render the Online Help User Interface in different languages. To get the correct fonts installed, you must select all the languages in which you want to render the online help, at the time of installation of the middle-tier server. To do this, click the Product Languages button, and select your languages on the Select a Product to Install screen, during the installation.

Additionally, you must make sure that the languages that are installed on the Application Server middle-tier correspond with the languages that are installed on the Oracle Application Server Infrastructure, to avoid problems with the Set Language request issued to OracleAS Single Sign-On.

Installing all languages increases the time required for the middle-tier installation.


4.10 Configuring OracleAS Portal for WebDAV

WebDAV is a protocol extension to HTTP 1.1 that supports distributed authoring and versioning. With WebDAV, the Internet becomes a transparent read and write medium, where content can be checked out, edited, and checked in to a URL address. mod_dav is an implementation of the WebDAV specification. The standard mod_dav implementation supports read and write access to files.

The term OraDAV refers to the capabilities available through the mod_oradav module. mod_oradav is the Oracle module that is an extended implementation of mod_dav, and is integrated with the Oracle HTTP Server. mod_oradav can read and write to local files, but also to an Oracle Database. The Oracle Database must have an OraDAV driver installed. The OraDAV driver is installed by default on installation of OracleAS Portal. mod_oradav calls this driver to map WebDAV activity to database activity. mod_oradav enables WebDAV clients to connect to an Oracle Database, read and write content, and query and lock documents in various schemas.

When Oracle Application Server is installed, all required OraDAV parameters are set with values that enable access to Oracle Database content through a Web browser or a WebDAV client. If necessary, you can modify parameter values if the default values do not meet your needs.

Similar to the Portal DAD configuration file, WebDAV has it own configuration file (ORACLE_HOME/Apache/oradav/conf/oradav.conf) that contains the OraDAV parameters, and start with DAV and DAVParam. These parameters are specified within a <Location> directive. The oradav.conf file is included in the httpd.conf file in an include statement.

4.10.1 Performing Basic WebDAV Configuration

After OracleAS Portal has been installed as part of the Oracle Application Server installation, the oradav.conf file should be populated with a <Location> directive that points to the portal schema. In the following example, the location /dav_portal/portal will be OraDAV-enabled and will (once populated with the correct values) connect to the portal schema so that users can use WebDAV clients to access portal data.

Example 4-1 Configuration Parameters for Portal Access

<Location /dav_portal/portal>
   DAV Oracle
   DAVParam ORACONNECT dbhost:dbport:dbsid
   DAVParam ORAUSER portal_schema
   DAVParam ORAPASSWORD portal_schema_password
   DAVParam ORAPACKAGENAME portal_schema.wwdav_api_driver
</Location>

By default, the OracleAS Portal DAV URL is:

http://hostname:port/dav_portal/portal/

For example:

http://mysite.oracle.com:7777/dav_portal/portal

The dav_portal part of the URL is the default name of a virtual directory used to differentiate between portal access through a WebDAV client and portal access that uses the pls virtual directory. portal is the DAD of the portal installation. You can also configure virtual hosts to provide a different, simpler, or easier to remember URL for WebDAV access, if need be.

Users connect to a portal in WebDAV clients using the same user name and password that they use to log in to the portal itself. If the portal is in a hosted environment, users also need to add their company information to their user name, as follows:

<username>@<company>

Authentication

Due to the way some WebDAV clients behave, users might experience authentication requests multiple times. To avoid this, the portal administrator can enable the cookie option by adding the following line to the oradav.conf file:

DAVParam ORACookieMaxAge <seconds>

where seconds is the amount of time in seconds before the cookie expires.

For example a value of 28800 is 8 hours and means that once a user has logged on through a WebDAV client, he or she will not be prompted for a user name and password again until 8 hours has passed.


Note:

Some WebDAV clients, for example, Dreamweaver, do not support cookies, so even if the cookie option is enabled, users may still be prompted for their passwords multiple times.

If you are using the SQL*Net Advanced Security Option (ASO), the ORACONNECT parameter in the oradav.conf file must be replaced with ORASERVICE dbhost as shown next:

<Location /dav_portal/portal>
  DAV Oracle
  DAVParam ORASERVICE dbhost
  DAVParam ORAUSER portal_schema
  DAVParam ORAPASSWORD portal_schema_password
  DAVParam ORAPACKAGENAME portal_schema.wwdav_api_driver
  Options Indexes
</Location>

This allows the database alias to be resolved by the tnsnames.ora file.


Notes:

  • When you add a new DAD without specifying the username and password, or if you change the Portal database schema username or password, using SQL*Plus, you will need to update the dads.conf and oradav.conf files manually.

  • Whenever you make changes to the oradav.conf file, Oracle HTTP Server must be restarted before the new settings will take effect.


4.10.2 Setting Up a WebDAV Client

The steps required to set up a WebDAV client to connect to OracleAS Portal varies depending on the client. All clients will eventually request a URL. The Portal DAV URL is very similar to the URL you use to access the portal itself in your Web browser, and uses the following format:

http://<hostname>:<port>/<dav_location>

If you experience problems while connecting to OracleAS Portal from a WebDAV client, refer to the WebDAV troubleshooting section in the Oracle Application Server Portal Error Messages Guide.

4.10.3 WebDAV Clients and SSL

Although OraDAV does support Secure Socket Layer (SSL), some WebDAV clients do not. Refer to the WebDAV client's documentation for details.

4.10.4 Checking the Version of OraDAV Drivers

You can check the version of the OraDAV drivers from any Web browser, as shown in the following example:

http://<machine>:<port>/<dav location>/~OraDAV-Version

The output will be like the following example:

Version 1.0.3.2.3-0030 
Using Container Version 1.5

4.10.5 Checking the Version of mod_oradav.so

You can check the version of mod_oradav.so by running the oversioncheck binary and specifying mod_oradav.so as its argument, as shown subsequently:

ORACLE_HOME/Apache/Apache/bin/oversioncheck ORACLE_HOME/Apache/oradav/lib/mod_oradav.so

4.10.6 Viewing Errors

Any errors that occur when a user performs actions on a portal using a WebDAV client are recorded in an error log that is created in that user's personal page (as an item titled My Error Log) the first time an OracleAS Portal related WebDAV error occurs. This can be very helpful for interpreting the error messages reported in WebDAV clients, such as the message 'An error has occurred while trying to complete this operation' that is often displayed in Web Folders, or HTTP error numbers reported in Cadaver.

All errors are also recorded in the Apache error log file (ORACLE_HOME/Apache/Apache/logs), so if the user does not have a personal page, or is a public user, the errors can still be examined.

For more verbose error reporting in the Apache error log file, add the following parameter to the oradav.conf file:

DAVParam ORATraceLevel 1


Notes:

  • Remember that Oracle HTTP Server needs restarting whenever a change is made to the oradav.conf file. For information about how to do this, refer to the Oracle HTTP Server Administrator's Guide.

    You can also refer to the section "OraDAV Configuration Parameters" in the Oracle HTTP Server Administrator's Guide for details of other OraDAV parameters.

  • The error log is not truncated and may become quite a large file. We recommend that you periodically delete this file. The next time an error is encountered a new file will be created.

  • "Not Found" messages are sometimes seen in the error log because the client computer checks for the existence of a filename. If the file does not exist, the error log correctly displays a 404 error message.