19 Managing and Monitoring OracleAS Reports Services

Oracle Enterprise Manager 10g, included with Oracle Application Server, provides managing and monitoring services for OracleAS Reports Services.

• The Oracle Enterprise Manager 10g Application Server Control provides both administration and real-time performance monitoring functions for your Reports Server.

• The Oracle Enterprise Manager 10g Grid Control provides more monitoring functions, but does not provide administration functionality. It provides additional management capabilities, including historical data collection for trending and analysis, J2EE application diagnostics, and insight into your applications' end-user experience.

This chapter describes how to configure the Reports Server for Oracle Enterprise Manager 10g, and how to navigate to the Reports Server pages to enable you to manage and monitor OracleAS Reports Services using Oracle Enterprise Manager 10g. It includes the following main sections:

• Configuring the Reports Server for Oracle Enterprise Manager 10g

• Navigating to the Reports Server Home Page

• Managing and Monitoring Reports Servers

Note: The Reports Server pages in Oracle Enterprise Manager 10g include context-sensitive online Help topics that provide information about the items that appear on each page. Click the Help link on each page to display the corresponding help topic.

See Also: For more information on Oracle Enterprise Manager 10g, refer to the Oracle Application Server Administrator's Guide, available on the Oracle Application Server documentation CD.

19.1 Configuring the Reports Server for Oracle Enterprise Manager 10g

Reports Servers are automatically configured in Oracle Process Manager and Notification Server (OPMN) and registered with Oracle Enterprise Manager 10g during installation of Oracle Application Server. If you add any Reports Servers after installing Oracle Application Server, you must register the new server(s) in:

• The Oracle Enterprise Manager 10g's targets.xml file. Refer to Section 3.8, "Configuring Oracle Reports to Communicate with Oracle Workflow" for more information on the targets.xml file and its usage.

• The OPMN's opmn.xml file. Refer to Section 3.7.1, "opmn.xml" for more information on the opmn.xml file and its usage.

  
  

  Note: Use addNewServerTarget.sh (UNIX) or addNewServerTarget.bat (Windows) to add a Reports Server target to targets.xml and opmn.xml. Then, restart OPMN for the change to take effect.

  
  
  
  

  Warning: If you change the port number of the Oracle Reports network or Oracle Reports bridge, the changed port number is not reflected in Oracle Enterprise Manager 10g, as these Oracle Reports components are not controlled through Oracle Enterprise Manager 10g. For example: If you edit the network configuration file, rwnetwork.conf, to update the port attribute of the multicast and namingService elements, start Reports Server, then log in to the Oracle Enterprise Manager 10g Application Server Control, the "Ports" page still shows the original port number. If you edit the Oracle Reports bridge configuration file, repbrg_your_bridge_name.conf, to update the port attribute, start the bridge, then log in to the Oracle Enterprise Manager 10g Application Server Control, the "Ports" tab for "Reports Bridge" port still shows the original port number.

  
  

19.2 Navigating to the Reports Server Home Page

This section describes how to display the Reports Server Home page in Oracle Enterprise Manager 10g:

• Navigating to the Reports Server Home Page in the Application Server Control

• Navigating to the Reports Server Home Page in the Grid Control

  
  

  Note: Before you can monitor a Reports Server in the Grid Control, you must first install and configure a Management Service. For instructions on how to do this, see the Oracle Enterprise Manager Grid Control Installation and Basic Configuration guide, available on the Oracle Application Server documentation CD and on the Oracle Technology Network (http://www.oracle.com/technology/index.html).

  
  

19.2.1 Navigating to the Reports Server Home Page in the Application Server Control

You can display the Reports Server Home page in a variety of ways. The following steps describe the procedure to display the Reports Server Home page from the Application Server Control:

1. Launch the Application Server Control. For more information on how to launch the console, refer to your Oracle Enterprise Manager 10g documentation.

2. The console opens on the Farm page as shown in Figure 19-1, which displays the available Oracle Application Server instances.

   Figure 19-1 Farm Page in Application Server Control

   
   Description of "Figure 19-1 Farm Page in Application Server Control"
   
   

3. Click the Oracle Application Server instance that contains the Reports Server you want to view. This link takes you to the Home page for that instance as shown in Figure 19-2.

   Figure 19-2 Oracle Application Server Home Page in Oracle Enterprise Manager 10g

   
   Description of "Figure 19-2 Oracle Application Server Home Page in Oracle Enterprise Manager 10g"
   
   

4. Choose the Reports Server you wish to view from the list of components. This link takes you to the Reports Server Home page, which should look similar to Figure 19-3.

   Figure 19-3 Reports Server Home Page in Oracle Enterprise Manager 10g

   
   Description of "Figure 19-3 Reports Server Home Page in Oracle Enterprise Manager 10g"
   
   

19.2.2 Navigating to the Reports Server Home Page in the Grid Control

You can display the Reports Server Home page in a variety of ways. The following steps describe the procedure to display the Reports Server Home page from the Grid Control:

1. Launch the Grid Control. For more information on how to launch the console, refer to your Oracle Enterprise Manager 10g documentation. The console should look similar to Figure 19-4. The Home page provides a high-level view of your entire enterprise.

   Figure 19-4 Grid Control Console

   
   Description of "Figure 19-4 Grid Control Console"
   
   

2. Click the Targets tab.

3. Click the Application Servers subtab. It should look similar to Figure 19-5.

   Figure 19-5 Grid Control Console, Targets, Application Servers Tab

   
   Description of "Figure 19-5 Grid Control Console, Targets, Application Servers Tab"
   
   

4. Click the Oracle Application Server instance that contains the Reports Server you want to view. The page should look similar to Figure 19-6.

   Figure 19-6 Grid Control Console, Application Server Page

   
   Description of "Figure 19-6 Grid Control Console, Application Server Page"
   
   

5. The Reports Server should appear in the list of components for that Oracle Application Server instance. Click it. This link takes you to the Reports Server Home page. It should look similar to Figure 19-3.

19.3 Managing and Monitoring Reports Servers

To manage and monitor Reports Servers in Oracle Enterprise Manager 10g, refer to the step-by-step procedures in the online Help.

To access the online Help in Oracle Enterprise Manager 10g:

1. On any Oracle Enterprise Manager 10g page, click the Help link to display the online Help.

2. In the online Help window:

   • If you are using the Application Server Control, click the Contents link.

   • If you are using the Grid Control, click the Help Contents link.

3. On the Contents tab, click Managing OracleAS Reports Services to display the online Help topics pertinent to Reports Servers.

Application Server Control

Expand Using the Oracle Enterprise Manager Application Server Control to Manage OracleAS Reports Services to display the following topics:

• About Monitoring Reports Services Using the Application Server Control Console

• Configuring/Adding a New Reports Server to Oracle Enterprise Manager

• Starting, Stopping, and Restarting Reports Servers

• Viewing and Managing Job Queues

  • Viewing and Managing the Current Jobs Queue

  • Viewing and Managing the Scheduled Jobs Queue

  • Viewing and Managing the Finished Jobs Queue

  • Viewing and Managing the Failed Jobs Queue

• Viewing and Changing the Reports Server Configuration Files

• Viewing and Linking to Server Cluster Members

• Viewing Port Numbers

• Changing Your Middle-Tier

Grid Control

Expand Using the Oracle Enterprise Manager Grid Control to Monitor OracleAS Reports Services to display the following topics:

• About Monitoring OracleAS Reports Services Using the Grid Control Console

• Viewing General Information About a Reports Server

• Viewing the Performance of Your Reports Server

• Viewing the Performance of Your Jobs

Note: In addition to the task online Help topics, the Reports Server pages in Oracle Enterprise Manager 10g include context-sensitive online Help topics that provide information about the items that appear on each page. Click the Help link on each page to display the corresponding help topic.