Oracle9i Application Server Installation Guide Release 1.0.2 for Windows NT Part Number A86240-01 |
|
This chapter guides you through the installation steps for the Enterprise Edition of Oracle9i Application Server. The following topics provide detailed installation steps, and basic postinstallation tasks:
The installation process is divided into two parts:
The following instructions prepare your machine for the installation of Oracle9i Application Server.
The Welcome screen provides information about the Oracle Universal Installer.
The following function buttons appear on the installation screens.
The File Locations screen allows you to enter the full path for the source and destination locations of Oracle9i Application Server.
products.jar
file from which the product will be installed. The installer detects and uses the default values of the products.jar
file of the installation program. Do not change the path.
- Name: This is the name Windows uses to identify your ORACLE_HOME.
- Path: This is the full path of the ORACLE_HOME.
The Installation Types screen allows you to select the Oracle9i Application Server installation option that you are licensed to use.
The following are the installation options:
Insufficient Disk Space screen appears only if you do not have enough disk space on your selected drive to install Oracle9i Application Server. You can:
The Component Configuration and Startup screen allows you to select the components that you want the installer to configure and automatically start after installation. This screen offers two configuration options:
You can select or de-select multiple components by holding down the Control key while clicking on the component name.
The System Reboot screen informs you that after the installer copies the necessary files required to install Oracle9i Application Server, your machine will reboot to allow the configuration changes to take effect. When the machine starts up again, Oracle Universal Installer appears and begins the installation process of the Oracle9i Application Server.
The Install screen appears while Oracle Universal Installer installs required configuration files for Oracle9i Application Server. It also displays the full path of the installation log.
Your machine will reboot once the configuration files are copied. Do not attempt to restart the installer after reboot. It will launch automatically.
Once your machine starts up after rebooting, the Oracle Universal Installer appears and proceeds to install Oracle9i Application Server. The following instructions guide you through the installation process.
Changing Disks: During the installation process, the Disk Location dialog appears and prompts you to change disks. Insert the requested disk into your disk drive, or specify an alternative location, and click OK
.
The following screen appears as Oracle Universal Installer relaunches.The installer may take up to several minutes to start, and might pause if some screensavers are activated.
This screen appears only under the following condition(s):
The Component Locations screen allows you to select alternative locations for some components.
Click individual components to view and change destination location path. The installer enables you to change the destination location of the components displayed on the screen.
The Origin Database Connection Information screen enables you to identify the origin database for the middle-tier cache.
tnsnames.ora
file on the local cache node.
For example, if oasdocs
is the database name and us.oracle.com
is the network domain in which the database is located, then the service name is oasdocs.us.oracle.com
.
The Apache Listener Configuration for Oracle Portal DAD screen allows you to enter the name of the Database Access Descriptor (DAD) that will be used to access Oracle Portal, and the name of the database schema where Oracle Portal will be installed. It also enables you to enter the TNS connect string if Oracle Portal and Oracle HTTP Server are installed in different Oracle homes. The information you enter here is used to create the PL/SQL Gateway settings which you can access upon installation from the following location: http://<machine_name>:<port>/pls/admin_/gateway.htm
portal30
.
portal30
.
The Apache Listener Configuration for Oracle Portal screen allows you to enter the Login Server DAD and Schema Name, with a _sso
extension for easy recognition. The Login Server provides an enterprise-wide Single Sign-On (SSO) mechanism that enables an Oracle Portal user to log in securely to Oracle Portal and any partner and external applications using a single user name and password. It also enables you to enter the TNS Connect String if Oracle Portal and Oracle HTTP Server are installed in different Oracle homes.
portal30_sso
.
portal30_sso
.
For more information on these fields, refer to the previous screen.
The Portal-to-Go Repository Information screen allows you to enter the hostname, Net8 Listener port number, and SID of the database where you will install the Portal-to-Go repository.
The Portal-to-Go Schema Information screen allows you to create a database user to store the Portal-to-Go repository.
SYSTEM
password of the database, and click Next.
The System Password screen allows you to enter and confirm the SYSTEM
password of the database where you are loading the Portal-to-Go repository.
SYSDBA
name and password and click Next. This screen will appear only if you have selected Oracle Database Cache in the Component Configuration and Startup screen.
The Origin Database User Information screen allows you to enter the SYSDBA
information created for the origin database.
The Summary screen allows you to review all the settings before the actual installation process. These settings include source, destination, installation type, product language, space requirements, and a list of components.
When you click Install, the installation process begins.
The Install screen appears while the product is installing. Installation operations include executing actions such as file copy and linking, and executing decision points and calculations. It also displays the full path of the installation log.
The following screen indicates that Oracle Installer is installing Oracle Forms Services, Oracle Reports Services, and Oracle Discoverer 3i Viewer. No user input is required.
The Configuration Tools screen lists the configuration tools for all installed components.
Scroll down the list to review the configuration status of each tool. The status changes as each component is configured.
The installer performs the following functions in this screen:
Configuration Tools
Depending on the components you select in the Configuration and Startup screen, the following configuration tools launch:
Oracle Database Cache Configuration Assistant - It enables you to configure your middle-tier caches.
See Also:
"Oracle Database Cache" for instructions on running Oracle Database Cache Configuration Assistant. |
Note: If you are installing Oracle Database Cache on the same machine as the origin database, then be sure to follow the instructions as listed in Appendix C, "Installing Oracle Database Cache on the Origin Database System". |
Oracle Web Cache Configuration Assistant - This launches the service to start Oracle Web Cache. Oracle Web Cache service starts up automatically by default. If you choose not to use Oracle Web Cache, you will need to stop the service manually.
Oracle Portal Configuration Assistant - It loads necessary database objects for Oracle Portal to run.
Starting Oracle HTTP service- It starts the Oracle HTTP Server.
Oracle HTTP Server starts up in a DOS window. In that window, you can test the Oracle HTTP Server installation.
To administer the Oracle HTTP service from the Control Panel
, reboot your machine after Oracle9i Application Server installation completes. Then, Oracle HTTP service will start automatically and you will no longer need to start it in a DOS window.
The End of Installation screen appears at the end of the installation process. It notifies you whether the installation was successful or unsuccessful.
You have successfully installed the Enterprise Edition installation option of Oracle9i Application Server. Proceed to "Postinstallation" to complete the installation process.
The following instructions guide you through the basic postinstallation tasks for Oracle9i Application Server. Before performing these tasks, be sure to install Oracle Portal-to-Go client from the Oracle9i Application Server Administrative and Development Client CD included in the Oracle9i Application Server CD pack.
The postinstallation contains the following sections:
Table 5-1 lists the environment variables that must be set for Enterprise Edition installation option:
Table 5-2 lists the default port numbers on which requests are received for each component.
This section contains postinstallation tasks for the following components:
You must run the Oracle Internet File System Configuration Assistant to configure Oracle Internet File System.
See Also:
"Oracle Internet File System" for instructions on running Oracle Internet File System Configuration Assistant. |
You must run the Oracle Enterprise Manager Configuration Assistant to configure Oracle Management Server.
See Also:
"Oracle Management Server" for instructions on running Oracle Enterprise Manager Configuration Assistant. |
Be sure to perform the following postinstallation steps for Oracle Database Cache:
When you install Oracle Database Cache, the installation procedure installs files that are specific to Oracle Database Cache and files that are updates to Oracle8i Server or Client release 8.1.6.1. These files contain the Oracle Database Cache functionality, as well as bug fixes to files usually installed with the Oracle8i Server or Client.
To use Oracle Database Cache, you must make sure that your applications are using the files and libraries installed for Oracle Database Cache. You can do this in the following ways:
"Using a Previous Oracle8i Release 8.1.6 Oracle Home" for a description of the steps you must take.
See Also:
OCI
libraries that are installed by Oracle Database Cache.
"Relinking Applications That Use Releases Previous to Release 8.1.6" for more information.
See Also:
To run your application from the Oracle home in which you installed Oracle Database Cache, you must take the following steps:
ORA_OCI_CACHE
to "1" so that all applications started from the process will use the cache. (Alternatively, you can use parameters within OCI
applications to control which applications or statements use the cache.
TNS_ADMIN
, make sure that it is set to the <ORACLE_HOME>\network\Admin
directory in the Oracle home for Oracle Database Cache.
PATH
so that the Oracle Database Cache library directory (<ORACLE_HOME>\lib
) precedes other Oracle library directories.
CLASSPATH
environment variable, set it to the Oracle home in which you installed Oracle Database Cache.
TNS_ADMIN
, make sure that it is set to the <ORACLE_HOME>\network\Admin
directory in the Oracle home for Oracle Database Cache. The registry parameter is located in the following location:
HKEY_LOCAL_MACHINE\SOFTWARE\ORACLE\HOME
id
Oracle for Windows NT
-> Oracle Home Selector
. Then, select the Oracle home in which you installed Oracle Database Cache.
tnsnames.ora
file, you must copy that entry to the tnsnames.ora
file used by Oracle Database Cache.
The tnsnames.ora
file is located in the <ORACLE_HOME>\network\Admin
directory. Copy the entry from the file in the previously existing Oracle home to the tnsnames.ora
file in the Oracle home in which you installed Oracle Database Cache.
Note that the Oracle Database Cache installation creates an entry for the origin database in the tnsnames.ora
file on the local cache node. It assigns the alias ora_icache_ origin. Do not modify or delete the ora_icache_origin entry. To assign a different alias for another purpose, edit the tnsnames.ora
file and add another entry. The Oracle Database Cache installation also creates an entry, ora_icache, for the cache. Do not modify or delete this entry.
If you previously ran your application from the Oracle home for Oracle8i Server or Client release 8.1.6 or 8.1.6.1 and you continue to need to run your application from that Oracle home, you must take the following steps:
<ORACLE_HOME>\bin\oraclient8.dll
<ORACLE_HOME>\bin\orageneric8.dll
(not required for 8.1.6.1)
<ORACLE_HOME>\bin\orawtc8.dll
<ORACLE_HOME>\bin\orawtc8.lib
Oracle for Windows NT
-> Oracle Home Selector
. Then, select the Oracle home for the Oracle8i server or client that your application uses.
ORA_OCI_CACHE
to "1" so that all applications started from the process will use the cache. (Alternatively, you can use parameters within OCI
applications to control which applications or statements use the cache.)
TNS_ADMIN
, make sure it points to the Oracle home that your application uses.
tnsnames.ora
file from the Oracle home in which you installed Oracle Database Cache to the tnsnames.ora
file in the Oracle home for the Oracle8i server or client that your application uses.
If your application was compiled and linked using a release prior to Oracle8i Server or Client release 8.1.6, you must relink your application using the OCI
libraries that are installed by Oracle Database Cache.
Then, you must take the steps described in "Using the Oracle Database Cache Home" .
The Oracle Database Cache installation creates a cache using the same database character set as the origin database. However, it does not set other National Language Support (NLS) features, such as date format or currency symbols.
If the initialization file (init
SID
.ora
) of your origin database specifies NLS parameters, you must copy those parameters to the initialization file (initicache.ora
) of the cache. (NLS parameters begin with "NLS_".)
For example, if the initialization file of your origin database contains the following parameters, copy them to initicache.ora
:
NLS_LANGUAGE = JAPANESE
NLS_CALENDAR = "Japanese Imperial"
NLS_DATE_FORMAT = "E YY-MM-DD"
initicache.ora
is located in the ORACLE_HOME
\Admin\icache\pfile
directory.
Oracle Corporation recommends that you configure Oracle Database Cache files, directories, and registry settings to allow only authorized database administrators to have full control. The following sections describe how to perform these tasks.
See your Windows NT documentation for more information about modifying NTFS file system and Windows NT registry settings.
Oracle Database Cache uses files to store data and configuration information. To do this, the Oracle Database Cache process runs under a security account. This security account (the account under which you installed Oracle Database Cache) includes the ability to create and access these files. The security account is assigned to the service that Oracle Database Cache uses (in the Control Panel). This account requires full file system permissions to create, read, write, delete, and execute files.
To ensure that only authorized users have full file system permissions:
ORACLE_HOME\bin
), Oracle Database Cache directories, and files for the cache (in ORACLE_HOME\dbs
).
Oracle Corporation recommends that you remove write permissions in the NT registry from users who are not DBAs or system administrators.
To remove write permissions:
HKEY_LOCAL_MACHINE\SOFTWARE\ORACLE
.
This section guides you through configuring Oracle Database Cache to use SSL and Oracle 8i JVM.
These steps guide you through the SSL configuration for the following:
Oracle Database Cache
To configure Oracle Database Cache to use SSL, remove the comment characters (#) from the following entry in the listener.ora
file:
For secure connections over SSL, uncomment the following lines:
# (DESCRIPTION = # Secure TCP connections # (ADDRESS = # (PROTOCOL = TCPS) (HOST = <host_name>) (PORT = 2484) # ) # )
The listener will listen for all SSL requests.
Oracle Servlets Engine for Java
To configure Oracle Servlets for Java to use SSL, (in addition to removing the comment characters from the appropriate line in the initialization file) you must remove the comment characters (#) from the following entry in the tnsnames.ora
file:
# Support for mod_ose over TCP with SSL connections. # inst1_https = # (DESCRIPTION = # (ADDRESS = # (PROTOCOL=TCPS) # (HOST=<host_name>) # (PORT=2484) # ) # (CONNECT_DATA= # (SERVICE_NAME=MODOSE) # (SERVER=shared) # (PRESENTATION=http://admin) # ) # )
Distributed CORBA Applications and Enterprise Java Beans
To configure distributed CORBA application and Enterprise Java Beans to use SSL, (in addition to removing the comment characters from the appropriate line in the initialization file) you must remove the comment characters (#) from the following entry in the listener.ora
file:
For secure IIOP connections over SSL, uncomment the following lines:
# (DESCRIPTION = # Secure IIOP Connections # (PROTOCOL_STACK = # (PRESENTATION=GIOP) # (SESSION=RAW) # ) # (ADDRESS=(PROTOCOL=TCPS)(HOST=% s_host_name%)(PORT=2482)) # )
These steps guide you through configuring Oracle Database Cache as a Multi-threaded server for the following applications:
Oracle Servlets Engine for Java
To configure Oracle Database Cache as a multi-threaded server (MTS) for Oracle Servlets Engine for Java, you must make one or both of the following changes to your initialization file (inst
SID
.ora
):
# mts_dispatcher = "(PROTOCOL=TCP)(SERV=MODOSE)"
# mts_dispatcher = "(PROTOCOL=TCPS)(SERV=MODOSE)"
Distributed CORBA Applications and Enterprise Java Beans
To configure Oracle Database Cache as a multi-threaded server (MTS) for distributed CORBA applications and Enterprise Java Beans, you must make the following changes in your initialization file (inst
SID
.ora
):
# mts_dispatcher = "(PROTOCOL=TCP)(PRE=oracle.aurora.server.SGiopServer)"
# mts_dispatcher = "(PROTOCOL=TCPS)(PREoracle.aurora.server.SGiopServer)"
The following section describes postinstallation configuration instructions for Oracle Portal-to-Go:
To load the bootstrap repository in the Oracle Portal-to-Go schema:
ORACLE_HOME\panama\setupconf
directory.
Set JAVA_HOME=ORACLE_HOME\Apache\jdk
pa_java_inst
Oracle Portal-to-Go Web Integration Server hosts services that applications can use to exchange data and information sources via the Web. The Web Integration Server is installed with the Oracle Portal-to-Go components.
The following steps guide you through the configuration process of the Web Integration Server:
Web Integration Server is installed as a service. Select Oracle Web Integration Server from the Services
dialog, and click the Start button.
http://
host_name
.
domain
:5555
Administrator
, and password manage
, which is the default password.
httpd.conf
file.
The httpd.conf
file is in the ORACLE_HOME
\Apache
\Apache
\conf
directory.
Create a Personalization Portal (papz) alias. This is needed so that the application server can find the
http://hostname/papz/login.jsp
.
Add a line at the end of the Alias section:
# PTG Start Alias /papz/ "<ORACLE_HOME>\panama\server\papz\" # PTG End
jserv.conf
file.
The jserv.conf
file is in the ORACLE_HOME
\Apache\
Jserv\
conf
directory.
In the ApJServMount section, add the Oracle Portal-to-Go specific mount point:
# PTG Start ApJServMount /ptg /root # PTG End
jserv.properties
file.
The jserv.properties
file is in the ORACLE_HOME\
Apache\
Jserv\
conf
directory.
Next to the other "wrapper.classpath
" entries, add all the required Oracle Portal-to-Go files to the classpath.
# PTG Start wrapper.classpath=<ORACLE_HOME>\panama\server\classes wrapper.classpath=<ORACLE_HOME>\panama\lib\panama_core.zip wrapper.classpath=<ORACLE_HOME>\panama\lib\panama_papz.zip wrapper.classpath=<ORACLE_HOME>\panama\lib\client.zip wrapper.classpath=<ORACLE_HOME>\panama\lib\server.zip # PTG End
zone.properties
file.
The zone.properties
file is in the
ORACLE_HOME
\Apache
\Jserv
\servlets
directory.
# PTG Start repositories=<ORACLE_HOME>\Apache\Jserv\servlets,<ORACLE_HOME>\panama\ server\papz # PTG End
# PTG Start servlets.startup=oracle.panama.ParmImpl # PTG End
# PTG Start servlet.rm.code=oracle.panama.ParmImpl # PTG End
After installation, you can verify that individual Oracle Portal-to-Go components are properly configured:
http://
host_name
.domain/papz/test.jsp
"Hello World" should appear on the screen.
http://host_name.domain/papz/login.jsp
The login page should appear. The Personalization Portal prompts you to enter a user name and a password. You can log in using "Administrator" as the user name and "manager" as the password.
http://host_name.domain/ptg/rm
You can manually start and stop a component by doing the following:
For further information on postinstallation and configuration tasks, refer to component-specific documentation. For information on viewing and installing the documentation, refer to Appendix E, "Installing Documentation Library".
|
Copyright © 2000 Oracle Corporation. All Rights Reserved. |
|