Skip Headers

Oracle9iAS Reports Services Publishing Reports to the Web
Release 2 (9.0.2)

Part Number A92102-01
Go To Table Of Contents
Contents
Go To Index
Index

Go to previous page Go to next page

2
Starting and Stopping Oracle9 i AS Reports Services

This chapter provides information on starting and stopping Oracle9iAS Reports Services. It includes the following main sections:

If you plan to run reports on the Web, you must first start the Oracle HTTP Server. You'll find information on doing this in your Oracle9iAS documentation. When you follow any of the procedures in this chapter, we assume you have already started the Oracle HTTP Server.

2.1 Starting the Reports Server

You have these options for running the Reports Server:

The following subsections tell you how to set up each of these options.

2.1.1 Installing and Starting the Reports Server as a Service (Windows NT/2000)

By default, the Reports Server is installed as an in-process server, but, if you wish, you can install the Reports Server as a service on a Windows NT/2000 machine. To do so, at the command prompt enter:

                                 
rwserver -install <
                                
server_name> [batch=yes/no] [autostart=yes/no]
                                 

                              

For batch, the default is no. Enter yes if you don't want to be prompted for confirmation during installation. For autostart, the default is no. Enter yes if you want the service to start automatically at reboot without requiring a user to logon and manually start the Reports Server.

Add the cluster name to this command if this server will be a member of a cluster. For example:

                                 
rwserver -install <
                                
server_name>.<
                                
cluster_name> [batch=yes/no] [autostart=yes/no]
                                 

                              

To learn more about clustering servers together, see Chapter 6, "Reports Server Clusters".

To start your Reports Server on Windows NT/2000:

  1. On the machine that hosts the Reports Server, choose Start > Settings > Control Panel and double-click in the Control Panel folder.

  2. In the Services dialog box, choose Oracle Reports Server [ repserver ], where < repserver > is the name of the Reports Server instance, and click Startup. The Services dialog window displays.

  3. In the Services dialog window, select This Account in the Log On As section, and select an operating system user name and password. This specifies the user account under which the server process is run.

  4. Set the Startup Type of the service to Automatic when the system is started.

  5. Click OK.

  6. Click Start.

    A Service Control message box indicates when your Reports Server has started.

2.1.2 Starting the Reports Server as a Servlet (Windows and UNIX)

If you are using the Reports Server as an in-process server (the default configuration), just sending a request starts up the servlet; however, if you are sending a request via a command line, the servlet must be invoked via a URL first. When you have successfully started the servlet, this also means you have successfully started the HTTP Server.

To start the Reports Servlet from a URL, enter the following from your Web browser:

                                 
http://<
                                
your_machine_name>:<
                                
your_port_num>/reports/rwservlet
                              

2.1.3 Starting the Reports Server from a Command Line (Windows and UNIX)

You can also start the Reports Server as a stand-alone server on Windows NT/2000 using the following command:

                                 
rwserver server=<
                                
server_name>
                                 


                              

Add the BATCH command line keyword to start up the server without displaying dialog boxes or messages.

                                 
rwserver server=<
                                
server_name> batch=yes
                                 

                              

You can run this command on UNIX using the following syntax:

                                 
rwserver.sh server=<
                                
server_name>
                                 

                              

Or:

                                 
rwserver.sh server=<
                                
server_name> batch=yes
                                 

                              

You can run this command from any directory as long as the executable can be reached in your PATH environment variable.

2.2 Verifying the Reports Servlet and Server Are Running

To verify that the Oracle9iAS Reports Servlet is running, navigate to the following URL:

                                 
http://<
                                
your_machine_name>.<
                                
domain_name>:<
                                
your_port_
number>/reports/rwservlet/help
                                 

                              

Note that the URL is case sensitive. If this URL executes successfully, you should get a help page describing the rwservlet command line arguments.

To verify that the Reports Server is running, navigate to the following URL:

                                 
http://<
                                
your_machine_name>.<
                                
domain_name>:<
                                
your_port_
number>/reports/rwservlet/showjobs?server=<
                                
server_name>
                                 

                              

The server=< server_name > argument is not required if you are using the default Reports Server name ( rep_< machine_name >) or the Reports Server specified in the servlet configuration file, rwservlet.properties ( ORACLE_HOME \reports\conf\). If this URL executes successfully, you should see a listing of the job queue for the specified Reports Server.

2.3 Verifying that the Oracle HTTP Server Is Running

To verify that the Oracle HTTP Server is running, in your browser, navigate to the following URL:

                                 
http://<
                                
server_name>.<
                                
domain>:<
                                
port_number>/
                              

2.4 Stopping the Reports Server

This section discusses how to stop the Reports Server on Windows NT/2000 and UNIX.

The keywords used with the rwserver command are described in Appendix A, "Command Line Arguments".