An Oracle Stream Analytics standalone-server domain contains a single Oracle Stream Analytics 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.
You can Create New Domain with Samples and Update Domain with Samples similar to Create New Domain and Update Domain. See Create a Standalone-Server Domain and Update a Standalone-Server Domain.
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_osa/
osa/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 OSA 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: osaadmin 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 Stream Analytics 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 Stream Analytics 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 you 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 OSA Domain screen displays
To not create a JDBC data source, select No and click Next.
The Create OSA Domain screen displays.
In the Create OSA 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_osa\user_projects\domains\osa_domain
Click Done to exit Configuration Wizard.
Go to the domain location to see the domain you just created.
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_osa/osa/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 Stream Analytics domain.
Click Next.
The Choose an Existing OSA domain screen displays.
In the Choose an Existing OSA 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_osa\user_projects\domains\myDomain\productionServer
.
Click Next.
The Choose an Existing OSA Domain screen displays.
In the Choose an Existing OSA 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 OSA Domain screen displays.
To leave the JDBC data source configuration unchanged:
In the Configuration Options screen, select No.
Click Next.
The Create OSA Domain screen displays.
In the Create OSA Domain screen, click Update to update the server.
You can start and stop an Oracle Stream Analytics standalone-server with any of the command-line scripts or with Oracle Stream Analytics Visualizer.
For information about Visualizer, see Using Visualizer for Oracle Stream Analytics.
Each Oracle Stream Analytics 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 Stream Analytics 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 Stream Analytics stand-alone server running in SSL mode. To stop an Oracle Stream Analytics stand-alone server running in SSL mode, run the wlevs.Admin
utility, as described in Run wlevs.Admin Utility in SSL Mode.