2 Administrating Oracle CEP Standalone-Server Domains

2.2.1 Creating an Oracle CEP Standalone-Server Domain Using the Configuration Wizard in Graphical Mode

The following procedure shows how to invoke and use the Configuration Wizard in graphical mode by executing the relevant command script for both Windows or Unix.

Start > All Programs > Oracle Complex Event Processing 10gR3 > Tools > Configuration Wizard

To create an Oracle CEP standalone-server domain using the Configuration Wizard in graphical mode:

1. Open a command window and set your environment as described in "Setting Your Development Environment" in the Oracle CEP Getting Started.

2. Change to the ORACLE_CEP_HOME/ocep_11.1/common/bin directory, where ORACLE_CEP_HOME refers to the main Oracle CEP installation directory, such as /oracle_cep:

   prompt> cd /oracle_cep/ocep_11.1/common/bin
   

3. Invoke the config.cmd (Windows) or config.sh (UNIX) command to invoke the wizard:

   prompt> config.sh
   

   After the Configuration Wizard has finished loading, you will see a standard Oracle Welcome window.

   Note:

   The Oracle CEP Configuration Wizard is self-explanatory; however, if you want more information about using the tool, continue reading this procedure.

4. Click Next.

5. In the Choose Create or Update Domain window, choose Create a New Oracle CEP Domain.

6. Click Next.

7. Enter the name of the administrator user for the default server of the domain.

8. Click Next.

9. Enter basic configuration information about the default server in the domain. In particular:

   • Enter the name of the default server. This name will also be used as the name of the directory that contains the default server files.

   • The listen port for Oracle CEP itself. Default is 9002.

   • The secure listen port. Default is 9003.

10. Click Next.

11. Enter and confirm the password for the Oracle CEP domain identity keystore.

    By default, the password for the certificate private key will be the same as the identity keystore; if you want it to be different, uncheck Use Keystore Password and enter the private key password.

12. Click Next.

13. Decide whether or not to update the JDBC datasource configuration:

    The Configuration Wizard bases the creation of a new domain on the Oracle CEP domain template; by default, this template does not configure any JDBC datasource for a domain. This means that, unless you change the default domain template used by the Configuration Wizard, if you choose No at this step, no JDBC data source is configured. If you want to configure a JDBC data source, choose Yes at this step to proceed to the page in which you can enter the data source information.

    1. To create a JDBC datasource:

       • Select Yes.

       • Click Next.

       • Enter the new JDBC datasource values in Configure Database Properties window.

         In the top section, enter the name of the datasource. Then select the database type (Oracle or Microsoft SQL Server) and corresponding drivers; you can also browse to new drivers using the Browse/Append button.

         In the lower section, enter the details about the database to which this data source connects, such as its name, the name of the computer that hosts the database server, the port, and the name and password of the user that connects to the database. The JDBC connection URL is automatically generated for you based on this information.

       • Click Next.

    2. To not create a JDBC datasource:

       • Select No.

       • Click Next.

14. In the Configure Server window, enter the name of the new domain and the full pathname of its domain location.

    The configuration wizard creates the domain using its domain name in the domain location directory.

    Note:

    Oracle recommends you always use the default domain location to create your domains:

    • On UNIX, the default domain is: ORACLE_CEP_HOME/user_projects/domains.

    • On Windows, the default domain is: ORACLE_CEP_HOME\user_projects\domains.

15. Click Create.

    If the creation of the domain succeeded, you will see a message similar to the following in the Creating Domain window:

    Domain created successfully!
    Domain location: C:\oracle_cep\user_projects\domains\ocep_domain
    

16. Click Done.

2.3.1 How to Update an Oracle CEP Standalone-Server Domain Using the Configuration Wizard in Graphical Mode

The following procedure shows how to invoke and use the Configuration Wizard in graphical mode by executing the relevant command script for both Windows or Unix.

Start > All Programs > Oracle Complex Event Processing 10gR3 > Tools > Configuration Wizard

For clarity, it is assumed in this section that you want to update a server called productionServer whose server-related files are located in the C:\oracle_cep\user_projects\domains\mydomain\productionServer directory.

To update an Oracle CEP standalone-server domain using the Configuration Wizard in graphical mode:

1. Open a command window and set your environment as described in "Setting Your Development Environment" in the Oracle CEP Getting Started.

2. Change to the ORACLE_CEP_HOME/ocep_11.1/common/bin directory, where ORACLE_CEP_HOME refers to the main Oracle CEP installation directory, such as /oracle_cep:

   prompt> cd /oracle_cep/ocep_11.1/common/bin
   

3. Invoke the config.cmd (Windows) or config.sh (UNIX) command to invoke the wizard:

   prompt> config.sh
   

   After the Configuration Wizard has finished loading, you will see a standard Oracle Welcome window.

   Note:

   The Oracle CEP Configuration Wizard is self-explanatory; however, if you want more information about using the tool, continue reading this procedure.

4. Click Next.

5. In the Choose Create or Update Domain window, select Update an existing Oracle CEP domain.

6. Click Next.

7. In the text box, enter the full pathname of the server directory that contains the files for the server you want to update.

   In this example, the value is C:\oracle_cep\user_projects\domains\mydomain\productionServer.

8. Click Next.

9. Update the listen ports for the server.

   Note:

   To prevent any conflicts when all servers are running at the same time, be sure that you do not enter the same values used by other servers in the domain.

10. Click Next.

11. Decide whether or not to update the JDBC datasource configuration:

    1. To update the JDBC datasource configuration:

       • Select Yes.

       • Click Next.

       • Enter the new JDBC datasource values.

    2. To leave the JDBC datasource configuration unchanged:

       • Select No.

       • Click Next.

12. Click Update to update the server.

2.4.1 How to Start an Oracle CEP Standalone-Server Using the startwlevs Script

Each Oracle CEP server directory contains a command script that starts a server instance; by default, the script is called startwlevs.cmd (Windows) or startwlevs.sh (UNIX).

To start an Oracle CEP standalone-server using the startwlevs script:

1. Ensure that the JAVA_HOME variable in the server start script points to the correct Oracle JRockit JDK. If it does not, edit the script.

   The server start script is located in the server directory under the main domain directory. For example, the default server directory of the HelloWorld domain is located in ORACLE_CEP_HOME/ocep_11.1/samples/domains/helloworld_domain/defaultserver, where ORACLE_CEP_HOME refers to the main Oracle CEP installation directory, such as /oracle_cep.

   1. If using the Oracle JRockit JDK installed with Oracle CEP, the JAVA_HOME variable should be set as follows:

      For UNIX:

      JAVA_HOME=ORACLE_CEP_HOME/jrockit-R27.6.0-50-1.6.0_05
      

      For Windows:

      set JAVA_HOME=ORACLE_CEP_HOME\jrockit-R27.6.0-50-1.6.0_05
      

      where ORACLE_CEP_HOME refers to the installation directory of Oracle CEP 10.3, such as /oracle_cep (UNIX) or c:\oracle_cep (Windows).

   2. If using the Oracle JRockit JDK installed with Oracle JRockit Real Time 3.0, the JAVA_HOME variable should be set as follows:

      For UNIX:

      JAVA_HOME=ORACLE_RT_HOME/jrrt-3.0.0-1.6.0
      

      For Windows:

      set JAVA_HOME=ORACLE_RT_HOME\jrrt-3.0.0-1.6.0
      

      where ORACLE_RT_HOME refers to the installation directory of Oracle JRockit Real Time 3.0, such as /jrockit (UNIX) or c:\jrockit (Windows).

2. Open a command window and change to the server directory of the domain directory. For example, to start the HelloWorld sample server:

   prompt> cd C:\oracle_cep\ocep_11.1\samples\domains\helloworld_domain\defaultserver
   

3. Execute the startwlevs.cmd (Windows) or startwlevs.sh (UNIX) script:

   prompt> startwlevs.cmd
   

   If you are using the Oracle JRockit JDK included in Oracle JRockit Real Time 3.0, enable the deterministic garbage collector by passing the -dgc parameter to the command:

   prompt> startwlevs.cmd -dgc
   

2.4.2 How to Stop an Oracle CEP Standalone-Server Using the stopwlevs Script

Each Oracle CEP server directory contains a command script that stops a server instance; by default, the script is called stopwlevs.cmd (Windows) or stopwlevs.sh (UNIX).

To stop an Oracle CEP standalone-server using the stopwlevs script:

1. Open a command window and change to the server directory. For example, to stop the running HelloWorld sample server:

   prompt> cd C:\oracle_cep\ocep_11.1\samples\domains\helloworld_domain\defaultserver
   

2. Execute the stopwlevs.cmd (Windows) or stopwlevs.sh (UNIX) script.

   Use the -url argument to pass the URL that establishes a JMX connection to the server you want to stop. This URL takes the form service:jmx:msarmi://host:port//jndi/jmxconnector, where host refers to the computer hosting the server and port refers to the server's JNDI port, configured in config.xml file. For example:

   prompt> stopwlevs.sh -url service:jmx:msarmi://ariel:9002/jndi/jmxconnector
   

   In the example, the host is ariel and the JMX port is 9002. The 9002 port is the netio port defined in the Oracle CEP server config.xml configuration file. MSA security uses it for JMX connectivity.

   See Section A.6, "Connection Arguments" for additional details about the -url argument.

2.5.1 How to Deploy an Application to an Oracle CEP Standalone-Server Using the Oracle CEP Visualizer

The simplest way to deploy an Oracle CEP application to a standalone-server domain is to use the Oracle CEP Visualizer.

For more information, see "Deploying an Application" in the Oracle CEP Visualizer User's Guide.

2.5.2 How to Deploy an Application to an Oracle CEP Singleton Server Group Using the Deployer Utility

If you do not specify a group when you deploy an application, Oracle CEP deploys the application to the singleton server group that includes only the specific server to which you deploy the application. This is the standard case in single-server domains.

The following example shows how to deploy to a singleton group; note that the command does not specify a -group option:

prompt> java -jar wlevsdeploy.jar -url http://ariel:9002/wlevsdeployer -install myapp_1.0.jar

In the example, the myapp_1.0.jar application will be deployed to the singleton server group that contains a single server: the one running on host ariel and listening to port 9002.