Oracle® Application Server Administrator's Guide 10g Release 3 (10.1.3.2.0) Part Number B32196-01 |
|
|
View PDF |
This chapter contains information and tasks to help you get started managing Oracle Application Server after installation.
It contains the following topics:
Oracle Application Server 10g Release 3 (10.1.3.2.0) provides a complete Java 2, Enterprise Edition (J2EE) 1.4-compliant environment.
Depending on the installation type, it includes Oracle HTTP Server, Oracle Containers for J2EE (OC4J), Oracle Process Manager and Notification Server (OPMN), Application Server Control Console, OC4J Java Single Sign-On, Oracle WebCenter Framework, Oracle Content DB, and Oracle Business Rules.
You can use this release with Release 10.1.4 or Release 2 (10.1.2) Oracle Identity Management Services and Release 2 (10.1.2) Oracle Application Server Web Cache.
When you installed Oracle Application Server, you were logged in to your operating system as a particular user. You should always log in as this user to manage your installation because this user has permission to view and modify the files in your installation's Oracle home.
To use Oracle Application Server, you must set environment variables as shown in the following tables:
Table 1-1 Environment Variables for UNIX
Environment Variable | Value |
---|---|
Beginning with Oracle Application Server 10g, very few tools, such as |
|
On Solaris, make sure the value contains the following directory: $ORACLE_HOME/lib32 On Linux, make sure the value contains the following directory: $ORACLE_HOME/lib On HP-UX, make sure the value contains the following directory: $ORACLE_HOME/lib On IBM AIX, make sure this environment variable is not set. |
|
If the calling application is a 32-bit application, make sure the value contains the following directory: $ORACLE_HOME/lib32 If the calling application is a 64-bit application, make sure the value contains the following directory: $ORACLE_HOME/lib |
|
Make sure the value contains the following directory: $ORACLE_HOME/lib |
|
Make sure the value contains the following directory: $ORACLE_HOME/lib32 |
|
Set to the full path of the installation's Oracle home. (When you run root.sh as the root user during the installation, this variable is set.) |
|
Make sure the value contains the following directories, which contain basic commands used by all installations: $ORACLE_HOME/bin $ORACLE_HOME/opmn/bin When you start to work with specific components, you may want to add additional directories to your path, as recommended by the component documentation. |
Table 1-2 shows the environment variables for Windows.
Table 1-2 Environment Variables for Windows
Environment Variable | Value |
---|---|
Set to the full path of the installation's Oracle home. The value is automatically set by Oracle Universal Installer. |
|
Set to your temp directory, for example, |
|
Set to your temp directory, for example, |
Best Practices for Multiple Installations on a UNIX Host
If you have multiple installations of Oracle Application Server on a UNIX host, it is very important to completely set your environment when managing a particular installation.
Some Oracle Application Server commands use the ORACLE_HOME environment variable to determine which installation to operate on, and some use the directory location of the command. It is, therefore, not sufficient to simply reset your environment variables or cd
to a different Oracle home as you move between installations. You must fully change to the new installation as follows:
Log in as the user who installed the installation you want to work on.
On UNIX hosts, you may also use the su
command to switch to the user, but be sure to use the dash (-
) option so your environment is set the same as it would have been had you actually logged in as that user. For example:
su - user
Set the correct environment variables for the installation, as described in Table 1-1.
Execute commands in the Oracle home of the correct installation.
Multiple Installations by the Same User If you installed multiple installations as the same user, make sure that you are in the correct Oracle home and have the correct environment variables set when working on a particular installation. You may want to set up some scripts to make it easy to change from one installation to another.
The Oracle Application Server Welcome Page is a great starting point for managing your application server. It includes the following:
An overview of this release
A link to the Oracle Enterprise Manager 10g Application Server Control Console—a Web-based tool for managing Oracle Application Server
Links to additional resources
Figure 1-1 shows part of the Welcome Page for a Basic Installation.
Figure 1-1 Oracle Application Server Welcome Page
Accessing the Welcome Page
You can locate the URL for accessing the Welcome Page on the End of Installation Screen text, which is stored in the following file:
(UNIX) ORACLE_HOME/install/readme.txt (Windows) ORACLE_HOME\install\readme.txt
To view the Welcome Page, connect to it using the HTTP listener port on your installation. For example:
http://hostname.domain:port
If you select the Basic installation option, the default port is 7777 on UNIX and 80 on Windows.
Tip If you cannot access the Welcome Page, try the following:
Check readme.txt
and make sure you are using the correct URL (hostname and port number).
Try restarting Oracle HTTP Server:
(UNIX) ORACLE_HOME/opmn/bin/opmnctl stopproc ias-component=HTTP_Server (UNIX) ORACLE_HOME/opmn/bin/opmnctl startproc ias-component=HTTP_Server (Windows) ORACLE_HOME\opmn\bin\opmnctl stopproc ias-component=HTTP_Server (Windows) ORACLE_HOME\opmn\bin\opmnctl startproc ias-component=HTTP_Server
During installation, Oracle Application Server assigned port numbers to various components and services. It is important to check these port numbers because:
You need to know these port numbers in order to start managing your application server.
Oracle Application Server takes several measures to ensure that port number assignments are unique. However, it is possible that a port assignment could conflict with a non-Oracle Application Server process on your host that was not running during the installation. If you determine there is a conflict, stop the non-Oracle Application Server process and continue with the tasks in this chapter. Once you have completed the tasks in this chapter and have verified that your installation is running properly, you can consider changing Oracle Application Server port numbers.
See Also:
Chapter 4 for information on changing port numbersYou can find the list of port numbers used by typing the following command:
(UNIX) ORACLE_HOME/opmn/bin/opmnctl status -l (Windows) ORACLE_HOME\opmn\bin\opmnctl status -l
The following shows the output from an installation on Linux (some columns are not shown to improve readability):
Processes in Instance: orcl10132.myhost.ora.com --------------------------+----------------------+--------+-----+------------------------------------------- ias-component | process-type | pid- | ... | ports --------------------------+----------------------+--------+-----+------------------------------------------- OC4JGroup:default_group | OC4J:OC4J_Content | 27769 | ... | jms:12602,ajp:12502,rmis:12702,rmi:12402 OC4JGroup:default_group | OC4J:OC4J_WebCent~ | 27501 | ... | jms:12601,ajp:12501,rmis:12701,rmi:12401 OC4JGroup:default_group | OC4J:home | 27394 | ... | jms:12603,ajp:12503,rmis:12703,rmi:12403 HTTP_Server | HTTP_Server | 26928 | ... |https1:4443,http2:7200,http1:7777 ASG | ASG | N/A | ... | N/A
You should leave the port numbers as they are until you have completed the tasks in this chapter and confirmed that all of your components are running properly. Then, you can consider changing port numbers. Note that some port numbers cannot be changed, and some require additional steps for updating other components.
On Windows, you can view the port numbers from the Windows Start menu. For example on Windows 2000, select Start > Programs > Oracle - Oracle_home_name > Oracle Process Manager > Oracle Assigned Port Numbers.
This section describes how to begin managing components. It includes instructions for accessing component administration tools and pointers to more information. It contains the following topics:
See Also:
Appendix C for a quick reference on how to access componentsOracle Process Manager and Notification Server (OPMN) manages and monitors most Oracle Application Server components. It is installed and configured in every middle-tier installation and is essential for running Oracle Application Server.
OPMN provides the opmnctl
command. The executable file is located in the following directory:
(UNIX) ORACLE_HOME/opmn/bin (Windows) ORACLE_HOME\opmn\bin
To get started with OPMN, use the opmnctl
command to query the status of the components in your installation:
(UNIX) ORACLE_HOME/opmn/bin/opmnctl status (Windows) ORACLE_HOME\opmn\bin\opmnctl status
Example 1-1 shows sample output from the command. It displays the component name, process type, operating system process ID (PID), and status of each process.
Example 1-1 Sample Output from opmnctl status Command
Processes in Instance: orcl10132.myhost.ora.com ------------------------+--------------------+---------+--------- ias-component | process-type | pid | status ------------------------+--------------------+---------+--------- OC4JGroup:default_group | OC4J:OC4J_Content | 27769 | Alive OC4JGroup:default_group | OC4J:OC4J_WebCent~ | 27501 | Alive OC4JGroup:default_group | OC4J:home | 27394 | Alive HTTP_Server | HTTP_Server | 26928 | Alive ASG | ASG | N/A | Down
You can use OPMN to start and stop your application server, monitor components, configure event scripts, and perform many other tasks related to process management. For example, you can use the following commands on UNIX to start and stop OPMN and all OPMN-managed processes, such as Oracle HTTP Server and OC4J instances:
ORACLE_HOME/opmn/bin/opmnctl startall ORACLE_HOME/opmn/bin/opmnctl stopall
On Windows, you can invoke these commands from the Windows Start menu. For example to start all processes, on Windows 2000, select Start > Programs > Oracle - Oracle_home_name > Oracle Process Manager > Start Oracle Process Manager.
Note that the ASG process, which is the OracleAS Guard server, is not started after you finish installing Oracle Application Server. If you are using OracleAS Guard, you can start it after installation.
Oracle HTTP Server is installed and configured when you install the following installation types:
Basic Installation
Advanced Installation: Oracle WebCenter Framework with Oracle HTTP Server
Advanced Installation: Oracle Content Database
Advanced Installation: Oracle HTTP Server
You can access Oracle HTTP Server as follows:
http://hostname.domain:port
In the example, port
is the Oracle HTTP Server Listen port number, which is listed in the output from the opmnctl status -l
command.
The following example assumes that the port is 7777:
http://hostname.domain:7777
When you access Oracle HTTP Server, you see the Oracle Application Server Welcome Page. Click Application Server Control to log in to Application Server Control Console. Then, navigate to the Application Server:server_name Home page to see the status of the HTTP server.
Oracle Containers for J2EE (OC4J) is a complete Java 2 Enterprise Edition (J2EE) environment.
When you install Oracle Application Server, the home
OC4J instance is created. This is the default OC4J instance that comes with every middle-tier installation. If you install Oracle WebCenter Framework, an OC4J instance, named OC4J_WebCenter
, is created. If you install Oracle Content DB, another OC4J instance, named OC4J_Content
, is created.
You can use Application Server Control Console to manage OC4J instances by navigating to the Home page for the instance.
Oracle WebCenter Framework is a part of Oracle WebCenter Suite. Oracle WebCenter Suite is a set of tools and services that you can use to quickly and easily build transactional, analytical, and dynamic applications. You get portlets, content, runtime customization, presence, collaboration, and search—everything you need to maximize the potential of your service-oriented applications.
Oracle WebCenter Framework enables you to build portal features directly into your Java EE 5 applications and bring traditional portal capabilities, like portlet and page customization, to your users. Oracle WebCenter Framework is the first offering that enables you to interweave those portal capabilities directly into a JavaServer Faces page using standard Faces constructs.
Oracle Content DB is a consolidated, database-centric content management application that provides a comprehensive, integrated solution for file and document lifecycle management.
You can use Application Server Control Console to manage Oracle Content DB. Navigate to Application Server Control Console from the Welcome page. From the Cluster Topology page, expand the OC4J_Content instance, and click content. Then, click Content DB Extension.
During installation, SSL is not configured for some components. If you would like to enable SSL, refer to Part IV, "Secure Sockets Layer (SSL)".