Oracle9i Application Server Administrator's Guide Release 2 (9.0.2) Part Number A92171-02 |
|
If you change a configuration value for a component, for example, the port number for Web Cache or the host for Oracle Internet Directory, your change may affect other components. You may need to update parameters in other components to ensure that all the components still function.
Each section in this chapter describes a component and its parameters that can affect other components.
J2EE and Web Cache install type:
Portal and Wireless install type:
Infrastructure
Parameters for Oracle HTTP Server are defined in .conf files in the ORACLE_HOME
/Apache
area. For example:
ORACLE_HOME
/Apache/Apache/conf/httpd.conf
ORACLE_HOME
/Apache/Apache/conf/mod_oc4j.conf
ORACLE_HOME
/Apache/modplsql/conf/dads.conf
ORACLE_HOME
/Apache/modplsql/conf/plsql.conf
ORACLE_HOME
/Apache/oradav/conf/moddav.conf
You need to use Oracle Enterprise Manager Web site to edit the configuration files. If you edit them manually, you need to run
Note:
dcmctl
with the updateConfig
parameter so that the updated values are copied into the DCM repository. See "About Manually Editing HTTP Server and OC4J Configuration Files" for details.
For detailed information on Oracle HTTP Server and its parameters, see the Oracle HTTP Server Administration Guide.
If you change this: | You affect these components: |
---|---|
Listener port number (
Host (
|
Oracle9iAS Web Cache:
Oracle Internet Directory:
Change the (continued in next row) |
Listener port number (
Host (
|
Oracle9iAS Single Sign-On:If you change the host, port, or protocol for Oracle HTTP Server, you need to update these values for Oracle9iAS Single Sign-On. When you make these changes in Single Sign-On, you affect the partner applications (Portal, Wireless, and mod_osso) in Single Sign-On. You then have to re-register the partner applications with Single Sign-On using the new host, port, or protocol.
(continued in next row) |
Listener port number (
Host (
|
Oracle9iAS Single Sign-On (continued):
If the name of the machine running the metadata repository database changes, you need to update the
Note that if you have multiple repository database instances, Oracle9iAS Single Sign-On uses only one of the instances. You need to update the Oracle9iAS Wireless:
(continued in next row) |
Listener port number (
Host (
|
Oracle9iAS Portal:
mod_osso:Re-register the mod_osso partner application with Single Sign-On. See the section "Oracle9iAS Single Sign-On" for details. Oracle Enterprise Manager:Create a virtual host with the original hostname. You can do this by adding the following lines to httpd.conf: NameVirtualHost * <VirtualHost *> ServerName original_hostname DocumentRoot /path_to_default_document_root </VirtualHost> Oracle9iAS Reports Services:Oracle9iAS Discoverer:If the hostname or port for the HTTP Server is changed, then it affects the Oracle9iAS Discoverer Portlet Provider. You should update the registration of the Discoverer Portlet Provider with Oracle Portal. For details, see the Oracle9iAS Discoverer Configuration Guide. (continued in next row) |
Listener port number (
Host ( Protocol (HTTP or HTTPS) |
OPMN:JServ:No changes required. |
Log directory ( |
Oracle9iAS Clickstream Intelligence:
Update the |
(Specified in the Note: Changing this directive is not recommended. |
Oracle9iAS Containers for J2EE:
The host and port used for the |
Any |
mod_oradav:
If you make any configuration changes in Oracle HTTP Server, you should not have to make any changes in |
You manage Web Cache using Oracle Web Cache Manager, which is a Web-based administration tool. You can use this tool to change the various Web Cache port numbers and passwords. See the Oracle9iAS Web Cache Administration and Deployment Guide for a full description of the tool.
If you change this: | You affect these components: |
---|---|
Administration port |
Oracle9iAS Portal:
(UNIX)
(Windows)
in midtier mode (that is,
For details on |
Listener port or machine running Web Cache |
Oracle9iAS Wireless:In the Wireless site configuration section of Oracle Enterprise Manager Web site, update the URL to reflect the new host and port settings. Oracle9iAS Reports Services:Manually update your reports links. Oracle9iAS Portal:
Portal (JPDK): Modify the configuration file for the JPDK invalidation API. |
Invalidation port |
Oracle9iAS Wireless:In the Wireless site configuration section of Oracle Enterprise Manager Web site, update the Web Cache Invalidation Port field to reflect the new value. Oracle9iAS Portal:
(UNIX)
(Windows)
in midtier mode (that is,
For details on Portal (JPDK): Modify the configuration file for the JPDK invalidation API. |
Invalidation password |
Oracle9iAS Wireless:In the Wireless site configuration section of Oracle Enterprise Manager Web site, update the Web Cache Invalidation Password field to reflect the new value. Oracle9iAS Portal:
(UNIX)
(Windows)
in midtier mode (that is,
For details on |
Web Cache timeout (OSRECV_TIMEOUT parameter in webcache.xml) |
Oracle9iAS Wireless:In the Wireless site configuration section of Oracle Enterprise Manager Web site, update the Web Cache Timeout field to reflect the new value. Oracle9iAS Portal:
Update the PPE (Portal Parallel Page Engine) |
Oracle Process Management Notification (OPMN) keeps track of Oracle9iAS processes. It uses the configuration file ORACLE_HOME
/opmn/conf/opmn.xml
.
The Portal feature in Oracle9iAS enables you to aggregate pages from different data sources and display them on a single page. Users can customize the pages that they want to see on their page. For details on Portals, see the Oracle9iAS Portal Configuration Guide.
If you change this: | You affect these components: |
---|---|
Mobile gateway URL |
Oracle9iAS Wireless:
(UNIX)
(Windows) to reregister the mobile gateway parameter with Portal. Syntax: portalregistrar.{sh,bat} <wireless_admin_user> <new_wireless_portal_URL> Example: portalregistrar.sh orcladmin http://new.myCompany.com/ptg/rm |
Portal database schema password (using Portal UI or SQL*Plus) |
HTTP Server (mod_plsql):
Oracle Internet Directory and DIP (Directory Integration Profile) Synchronization:
(UNIX)
(Windows) to modify (or delete or recreate) the Portal's provisioning profile to update the password that is maintained in Oracle Internet Directory so the DIP agent can connect to the portal to send the notifications. |
Moving Portal to a different database |
Oracle Enterprise Manager:
Add the new database target to the |
Portal port, DAD name, URL of Home Page |
Oracle9iAS Wireless and Oracle9iAS Single Sign-On:
|
A Web provider owns portlets that can be placed on portal pages. Web provider details are maintained using the Add/Edit Provider screens in the portal. These pages are used to maintain both Web Providers and Database Providers.
If you change this: | You affect these components: |
---|---|
Web provider URL or port |
Oracle9iAS Portal:Update provider registration information with new URL or port. |
Web provider service ID |
Oracle9iAS Portal:Update provider registration information with new service ID. |
Web provider mount point |
Oracle9iAS Portal:Update provider registration information with new mount point. |
Adding Web Cache in front of Web provider |
Oracle9iAS Portal:Do one of the following:
|
Removing Web Cache from Web provider |
Oracle9iAS Portal:Do one of the following: |
Moving Web Cache to a different host or port |
Oracle9iAS Portal:Update the Web Cache configuration file with the new host or port. |
Changing the service name or location of the database that stores provider preference |
Oracle9iAS Containers for J2EE:
Update the OC4J |
Changing domain of portal or Web provider |
Oracle9iAS Portal:If you have applications that rely on "same cookie domain" (where portal delegates Web provider cookie management to the browser), you have to change the scope of the Web provider cookie so that both portal and Web provider listeners fall within the domain or change the Web provider to create "authenticated links" for any deep links from portlets to external or partner applications. Partner applications would have to be treated as external applications. |
Moving provider UI servlet |
Oracle9iAS Portal:Update location of the provider UI in General Settings. |
A provider group is a grouping of Portal Web providers. A provider group lets you publish information about many providers in a simple way. The provider group may be published from a portal, or it could be established independent of any portal. A portal administrator can register a provider group with a portal and view the contents (that is, the Web providers) of the group. The portal administrator can then selectively register one or more providers from the provider group with the portal and then use that provider as if it had been registered normally.
You manage Oracle9iAS Wireless using Oracle Enterprise Manager Web site. The management pages enable you to perform tasks such as starting and stopping the wireless server, setting the number of connections in the connection pool, setting up logging, and configuring devices.
See the Oracle9iAS Wireless Getting Started and System Guide for details.
If you change this: | You affect these components: |
---|---|
Add a new service to refer to portal |
Oracle9iAS Portal:Go to the Mobile tab of Global Settings and update the registered URL. |
Oracle9iAS Single Sign-On enables users to sign in only once for all applications for which they are authorized to access. Oracle9iAS Single Sign-On is commonly used with portals, which can display multiple applications on a single page. Users enter their username and password only once to access the applications on the page.
You configure Oracle9iAS Single Sign-On using a Web-based interface. You can perform tasks such as setting the maximum session length, adding partner applications, and changing the administrator password.
See the Oracle9iAS Single Sign-On Administrator's Guide for details.
If you change this: | You affect these components: |
---|---|
Hostname, Port, or Protocol (HTTP or HTTPS)
|
If you change the hostname, port, or protocol of Oracle HTTP Server, this affects Single Sign-On. See the section "Oracle HTTP Server" for details. Oracle9iAS Portal:
Three cases are possible (for details on Case 1: If you are running Portal and Oracle9iAS Single Sign-On on the same machine, and you changed the name of the machine, you need to run the script:
(UNIX)
(Windows) in SSOPARTNERCONFIG mode: ptlasst.csh -i typical -mode SSOPARTNERCONFIG -s portal -sp portal -c webdbsvr2.us.oracle.com:1521:s901dev3 -sdad portal -o orasso -odad orasso -host webdbsvr1.us.oracle.com -port 3000 -silent -verbose -sso_c webdbsvr2.us.oracle.com:1521:s901dev3 -sso_h webdbsvr1.us.oracle.com -sso_p 3000 -pa orasso_pa -pap orasso_pa -ps orasso_ps -pp orasso_ps -pd portal_dblink -p_tns websso_ps -s_tns portal -iasname myIAS
Note: Running (continued in next row) |
Hostname, Port, or Protocol (HTTP or HTTPS) |
Oracle9iAS Portal (continued):Case 2: If you are running Portal and the Oracle9iAS Single Sign-On server on separate machines and you just changed the name of the Oracle9iAS Single Sign-On machine (the name of the Portal machine did not change), you need to run the script: (UNIX) in SSOPARTNERCONFIG mode. Specify the new Oracle9iAS Single Sign-On server name and port in the Oracle9iAS Single Sign-On server name and port parameters: ptlasst.csh -i typical -mode SSOPARTNERCONFIG -s portal -sp portal -c webdbsvr2.us.oracle.com:1521:s901dev3 -sdad portal -o orasso -odad orasso -host webdbsvr1.us.oracle.com -port 3000 -silent -verbose -sso_c webdbsvr2.us.oracle.com:1521:s901dev3 -sso_h webdbsvr1.us.oracle.com -sso_p 3000 -pa orasso_pa -pap orasso_pa -ps orasso_ps -pp orasso_ps -pd portal_dblink -p_tns websso_ps -s_tns portal -iasname myIAS Case 3: If you are pointing a Portal instance from one Oracle9iAS Single Sign-On server to another one, you need to do the following:
Case 2 and Case 3 above assume that the Oracle Internet Directory server that the Oracle9iAS Single Sign-On servers point to is the same. If not, you also need to run (continued in next row) |
Hostname, Port, or Protocol (HTTP or HTTPS) |
mod_osso:Run the Single Sign-On registration tool to re-register mod_osso. See the section "Reregistering the Oracle HTTP Server with the Single Sign-On Server" in the Oracle9iAS Single Sign-On Release Notes for details. Note: Running the registration tool creates a new row for the partner application instead of updating the existing row. This does not prevent the application from working, but it can become a usability issue when the list of partner applications builds up on the Global Logout screen and some links might break. Oracle9iAS Wireless:The registration tool for the Wireless partner application is:
(UNIX)
(Windows) Syntax: reRegisterSSO.{sh,bat} <new_host_URL> <ORACLE_HOME> Example: reRegisterSSO.sh http://new.myco.com:4567/ptg/rm /private/OraHome
Note: Running |
You can change the password using the SSO Administration page or SQL*Plus. |
Oracle HTTP Server and Oracle9iAS Portal:
Oracle9iAS Portal:
Update the |
Password of ORASSO_PS schema |
Oracle9iAS Portal:No changes required if Portal uses the Metadata Repository API to retrieve the password. If Portal stores the password in a database table, then it has to update the table. |
Password of the lightweight SSO administrator (DN: cn=orcladmin, cn=users, o=company, dc=com) |
No repercussions on other components. |
Logout_url, success_url, failure_url, or home_url of partner applications, including mod_osso module |
Oracle9iAS Single Sign-On:You can change these URLs through the SSO Server Administration Page. |
Disable Oracle9iAS Single Sign-On |
Oracle9iAS Reports Services:
Edit |
Any |
DAS:Changes to Oracle9iAS Single Sign-On are reflected by mod_osso, from which DAS gets Oracle9iAS Single Sign-On information. |
Oracle9iAS Single Sign-On application entry password, which is stored in Oracle Internet Directory at: orclApplicationCommonName=ORASSO, cn=SSO, cn=Products, cn=OracleContext You can change the password by changing the userPassword attribute using ODM or a command-line utility. |
Oracle9iAS Single Sign-On:
Run |
Load balancing |
Oracle HTTP Server and Load Balancer:
If Oracle HTTP Server for the Oracle9iAS Single Sign-On server is behind a load balancer, you need to set the |
Oracle Internet Directory enables you to manage entities such as users and applications. You change configuration parameters for Oracle Internet Directory using Oracle Directory Manager or command-line tools such as oidpasswd
.
See the Oracle Internet Directory Administrator's Guide for details.
The metadata repository database contains schemas owned by various components. The database is installed when you install the Infrastructure for Oracle9i Application Server. Typically, you do not change anything in this database directly. Instead, you use provided interfaces, such as Oracle Enterprise Manager or utilities.
|
Copyright © 2002 Oracle Corporation. All Rights Reserved. |
|