An Oracle Event Processing standalone-server domain contains a single Oracle Event Processing server. By default, the Configuration Wizard creates a standalone-server domain, which can be the starting point for a multiserver domain.
This chapter includes the following sections:
The Configuration Wizard is an administration tool that enables you to create a new domain or update an existing domain. You can use the Configuration Wizard in graphical mode (interactive) or silent mode.
Silent mode is non-interactive and requires an XML properties file for selecting configuration options. You can run silent-mode configuration as part of a script or from the command line. The advantage to silent-mode configuration is that if you plan to create a multiserver domain, you can set the domain configuration options once and use the same options to set the configuration on the other servers.
The following procedures show how to perform the create and update operations in graphical mode and in silent mode. You can update only the listen port and the JDBC data source configuration of a standalone-server domain.
Use the Configuration Wizard to create a new domain to which to deploy your applications. The Configuration Wizard creates a single default server in the domain. All of the server files are in a subdirectory of the domain directory. The domain directory has the same name as the server. You also configure the following:
Server administration user name and password.
A database or database driver that is different from the default.
Server listen port.
Password for the identity keystore and private keystore.
Once launched, the Configuration Wizard in graphical mode is self-explanatory, but the full procedure is provided here for your information.
Go to the /Oracle/Middleware/my_oep/
oep/common/bin
directory.
Run the config
command to start the wizard:
UNIX: ./config.sh Windows: config.cmd
The Oracle Welcome screen displays.
Click Next.
The Choose Create or Update Domain screen displays.
In the Choose Create or Update Domain window, select Create a New OEP Domain and click Next.
The Configure Administrator Username and Password screen displays.
In the Configure Administrator Username and Password screen, enter the following:
User name: oepadmin User password: welcome1 Confirm user password: welcome1
Click Next.
Enter basic configuration information about the default server in the domain. In particular:
The Configure Server screen displays.
Enter the name of the default server. This name is also used for the name of the directory that contains the default server files.
The listen port for Oracle Event Processing itself. Default is 9002.
In the Configure Server screen, enter the server name and listen port as follows:
Server name: The name of the default server. This name is also the name of the directory that contains the default server files.
Server listen port: The port where Oracle Event Processing listens for events. The default is 9002.
Click Next.
The Configure Domain Identity Keystore screen displays.
In the Configure Domain Identity Keystore screen, enter the following:
Keystore file: Accept the default. Keystore password: welcome1. Confirm keystore password: welcome1.
By default, the password for the certificate private key is the same as the password for the domain identity keystore.
Click Next.
The Configuration Options screen displays.
In the Configuration Options screen, decide whether or not to update the JDBC data source configuration.
If you select No, no JDBC data source is configured. If select Yes, you proceed to the page in which you can enter the JDBC data source information.
To create a JDBC data source:
Select Yes and Click Next.
The Configure Database Properties screen displays.
In the Configure Database Properties screen, enter the new JDBC data source values.
In the top section, enter the data source name, type, driver name and location.
In the lower section, enter information about the data base to which this data source connects.The JDBC connection URL is generated based on the information you enter.
Click Next.
The Create OEP Domain screen displays
To not create a JDBC data source, select No and click Next.
The Create OEP Domain screen displays.
In the Create OEP Domain screen, enter the following information:
Domain name: The name of the new domain. Domain location: Accept the default.
The Configuration Wizard creates the domain in the domain location directory with the domain name that you specified
Click Create.
The Creating Domain screen displays.
If the creation of the domain succeeds, a message similar to the following displays in the information window:
Domain created successfully! Domain location: C:\Oracle\Middleware\my_oep\user_projects\domains\oep_domain
Click Done to exit Configuration Wizard.
Go to the domain location to see the domain you just created.
This section describes the procedure to create a standalone-server domain in silent mode.
Silent mode is a non-interactive way to update a domain and requires an XML properties file for selecting configuration options.
When you run in silent mode, the Configuration Wizard generates exit codes that indicate the success or failure of the creation and configuration of the domain. These exit codes are shown in the following table.
Table 2-2 Exit Codes
Code | Description |
---|---|
0 |
Configuration Wizard execution completed successfully |
-1 |
Configuration Wizard execution failed due to a fatal error |
-2 |
Configuration Wizard execution failed due to an internal XML parsing error |
The following example provides a sample Windows command file that runs the Configuration Wizard in silent mode and echoes the exit codes to the command window from which the script is executed.
rem Execute the Configuration Wizard in silent mode @echo off config.cmd -mode=silent -silent_xml=c:\scripts\silent.xml -log=C:\logs\create_domain.logs @rem Return an exit code to indicate success or failure set exit_code=%ERRORLEVEL% @echo. @echo Exitcode=%exit_code% @echo. @echo Exit Code Key @echo --------------- @echo 0=Configuration Wizard completed successfully @echo -1=Configuration Wizard failed due to a fatal error @echo -2=Configuration Wizard failed due to an internal XML parsing error @echo.
Use the Configuration Wizard to update an existing standalone-server domain. You can update only the listen port and the JDBC data source configuration.
Once launched, the Configuration Wizard in graphical mode is self-explanatory, but the full procedure is provided here for your information.
Go to the /Oracle/Middleware/my_oep/oep/common/bin
directory.
Run the config
command to start the wizard:
UNIX: ./config.sh Windows: config.cmd
The Oracle Welcome screen displays.
Click Next.
The Choose Create or Update Domain screen displays.
In the Choose Create or Update Domain window, select Updating an existing Oracle Event Processing domain.
Click Next.
The Choose an Existing OEP domain screen displays.
In the Choose an Existing OEP domain screen text box, enter or browse for the full path name to the server directory for the server that you want to update.
In this example, the value is C:\Oracle\Middleware\my_oep\user_projects\domains\myDomain\productionServer
.
Click Next.
The Choose an Existing OEP Domain screen displays.
In the Choose an Existing OEP Domain screen, select the path to the domain that you want to update from the drop-down list and click Next
.
The Configure Server screen displays. The Server name field is grayed out, but you can change the value in the Server listen port field.
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.
In the Configure Server screen, either change the listen port and click Next or click Next without changing the listen port.
The Configuration Options screen displays.
In the Configuration Options screen, decide whether to update the JDBC data source configuration.
To update the JDBC data source configuration:
In the Configuration Options screen, select Yes and click Next.
The Configure Database Properties screen displays.
In the Configure Database Properties screen, enter your changes and click Next.
The Create OEP Domain screen displays.
To leave the JDBC data source configuration unchanged:
In the Configuration Options screen, select No.
Click Next.
The Create OEP Domain screen displays.
In the Create OEP Domain screen, click Update to update the server.
You can start and stop an Oracle Event Processing standalone-server with any of the command-line scripts or with Oracle Event Processing Visualizer. For information about Visualizer, see Oracle Fusion Middleware Using Visualizer for Oracle Event Processing.
Each Oracle Event Processing server directory contains a command script that starts a server instance. By default, the script is called startwlevs.cmd
(Windows) or startwlevs.sh
(UNIX).
Note:
On HP-UX, to avoid an OutOfMemoryError
, you might need to increase the MaxPermSize
to 256 in startwlevs.sh
. For example: -XX:MaxPermSize=256m
.
Each Oracle Event Processing server directory contains a command script that stops a server instance; by default, the script is called stopwlevs.cmd
(Windows) or stopwlevs.sh
(UNIX).
Note:
The following procedure does not stop an Oracle Event Processing stand-alone server running in SSL mode. To stop an Oracle Event Processing stand-alone server running in SSL mode, run the wlevs.Admin utility, as described in Run wlevs.Admin Utility in SSL Mode.