2 Use Visualizer

This chapter describes how to start and set preferences for Oracle Event Processing Visualizer, a tool that can manage, configure, and monitor Oracle Event Processing server instances and the applications deployed to the server instances.

This chapter includes the following sections:

For more information, see Oracle Event Processing Visualizer.

2.1 Start Visualizer

Before you start Oracle Event Processing Visualizer, ensure that your system meets the minimum prerequisites as Prerequisites describes.

Choose how you want to start Oracle Event Processing Visualizer:

After you start Oracle Event Processing Visualizer, you are ready to begin using Oracle Event Processing Visualizer to manage, configure, and monitor Oracle Event Processing server instances and the applications deployed to the server instances. For information on typical tasks, see:

2.1.1 Prerequisites

Before starting Oracle Event Processing Visualizer, the following prerequisites must be met:

For best performance, install version 10,0,22,87 of the Adobe Flash Player.

For instructions on testing the current version of Flash Player installed on your computer, see the Version test for Adobe Flash Player Web site: http://kb.adobe.com/selfservice/viewContent.do?externalId=tn_15507.

For more information, see http://www.adobe.com/products/flashplayer/.
You must configure your computer display for a resolution of 1024x768 or higher.
Oracle recommends that you use Internet Explorer 7 or higher.
For some Oracle Event Processing Visualizer tasks, you must log into Oracle Event Processing Visualizer using an Oracle Event Processing server account configured for the administrator role. For more information, see User_ Group_ and Role Management.

2.1.2 Start Visualizer from a Browser

You can start the Oracle Event Processing Visualizer using any browser that meets the minimum perquisites as Prerequisites describes.

Note:

Do not use an IPV6-only browser because most Visualizer features are not supported.

Start Visualizer from a Browser

Confirm that your browser meets the necessary requirements.
See Prerequisites.
Invoke the following URL in your browser:
```
http://host:port/wlevs
```
where host refers to the name of the computer on which Oracle Event Processing is running and port refers to the Jetty NetIO port configured for the server (default value 9002).

The port number is configured in the config.xml file in the Oracle/Middleware/my_oep/user_projects/domains/DOMAIN_DIR/servername/config directory. The port number is the value of the port child element of the netio object configured for the Jetty server, as shown in the following example (only relevant parts shown):
```
    <netio>
        <name>NetIO</name>
        <port>9002</port>
    </netio>
    ...
    <jetty>
        <name>JettyServer</name>
        <network-io-name>NetIO</network-io-name>
        ...
    </jetty>
```
For example, if your browser is running on the same computer as Oracle Event Processing and you are using the default port, invoke the following URL:
```
http://localhost:9002/wlevs
```
If you want to use HTTPS to connect to Oracle Event Processing Visualizer, specify the SSL port number. This is the port assigned to the netio element referenced by the secure-network-io-name Jetty element. The default value is 9003.

For example, if you have the following configuration (only relevant parts shown):
```
    <netio>
        <name>sslNetIo</name>
        ...
        <port>9003</port>
    </netio>
    <jetty>
        ...
        <secure-network-io-name>sslNetIo</secure-network-io-name>
    </jetty>
```
use the following URL:
```
https://localhost:9003/wlevs
```
The Login screen appears as Figure 2-1 shows.

Figure 2-1 Oracle Event Processing Visualizer Login Screen

Description of "Figure 2-1 Oracle Event Processing Visualizer Login Screen"
In the Login screen, enter the user name and password for the administrator user you configured when you created the domain.
Note:
The security features of Oracle Event Processing Visualizer work only if you have security enabled for Oracle Event Processing server. If you disable Oracle Event Processing server security, then:
- Oracle Event Processing Visualizer does not provide default users, groups, and roles.
- You cannot create new users, groups, and roles.
- There is still a login page when you first enter Oracle Event Processing Visualizer, but you can enter anything for the user name and password.
For more information, see Oracle Fusion Middleware Administering Oracle Event Processing
Click Login.
Note that if you stop the server while Oracle Event Processing Visualizer is running, you might see informational messages about the service proxy. These are typically not errors.

2.1.3 Start Visualizer in a Multiserver Domain

You can use Oracle Event Processing Visualizer to administer a multiserver domain. As described in Start Visualizer from a Browser, Oracle Event Processing Visualizer works by connecting to one particular Oracle Event Processing server, based on its host and port.

In the case of a multiserver domain, you connect to one Oracle Event Processing server in the domain and then access the other servers from that server. All servers in a multiserver domain are candidates to host Oracle Event Processing Visualizer, from which you administer all the other servers in the domain. However, considering the performance factor, it is recommended that you select one server to host Oracle Event Processing Visualizer and disable Oracle Event Processing Visualizer access from all servers except for one in the multiserver domain.

To avoid a single point of failure, consider enabling Oracle Event Processing Visualizer on a small subset of n machines in the domain.

When using Oracle Event Processing Visualizer in a multiserver domain, the navigation tree in the left pane is automatically refreshed to reflect changes in the domain. For example, when a new server joins the domain, it automatically shows up in the navigation tree. Conversely, if the server leaves the domain, the server automatically disappears from the navigation tree.

Note:

The server-host-name element is mandatory if one or more Oracle Event Processing servers in your multiserver domain are on different hosts and you plan to manage the multiserver domain using the Oracle Event Processing Visualizer. It is also mandatory if a server is deployed on a host machine that has multiple IP addresses configured (whether in a multiserver or standalone-server environment). You must configure cluster element child element server-host-name in the config.xml of each Oracle Event Processing server.

For more information, see Oracle Fusion Middleware Administering Oracle Event Processing.

You can perform configuration management, of both the servers and applications, and operation management (such as diagnostics and event record and playback) on all servers in the multiserver domain.

Start Visualizer in a Multiserver Domain

Create a multiserver domain.
For example, assume you have a multiserver domain with three servers (defaultserver, server1, and server2). Each server directory is a child directory of the domain directory, which is /Oracle/Middleware/my_oep/user_projects/domains/myDomain.

For more information, Oracle Fusion Middleware Administering Oracle Event Processing.
Configure SSL to secure communication between the servers in the multiserver domain.
For more information, see Oracle Fusion Middleware Administering Oracle Event Processing.
Choose one Oracle Event Processing server in the multiserver domain to host Oracle Event Processing Visualizer access.
In this example, defaultserver will host Oracle Event Processing Visualizer access.
Specify the -disablevisualizer flag when you start the other servers in the multiserver domain that will not provide access to Oracle Event Processing Visualizer.
You want the defaultserver to host Oracle Event Processing Visualizer and thus must disable access to Oracle Event Processing Visualizer from the other two servers. In this case, you would start each server as follows:
```
  prompt> cd /Oracle/Middleware/my_oep/user_projects/domains/myDomain/defaultserver
  prompt> startwlevs
  prompt> cd ../server1
  prompt> startwlevs -disablevisualizer
  prompt> cd ../server2
  prompt> startwlevs -disablevisualizer
```
Configure SSL to secure communication between Oracle Event Processing Visualizer and defaultserver.
For more information, see Oracle Event Processing Oracle Fusion Middleware Administering Oracle Event Processing.
Start Oracle Event Processing Visualizer.
For more information, see Start Visualizer from a Browser

2.2 Manage User Preferences

Oracle Event Processing Visualizer allows you to customize its behavior using user preferences.

To manage user preferences:

Click the Preference button at the top-right corner of any Oracle Event Processing Visualizer screen. The Preference screen appears in the right panel, as shown in Figure 2-2.
Figure 2-2 The Preference Screen

Description of "Figure 2-2 The Preference Screen"

Update the preferences as Table 2-1 describes:

Table 2-1 Oracle Event Processing Visualizer Preferences Attributes

Attribute	Description
`Select Language`	Select the language that Oracle Event Processing Visualizer uses. Default: English. For more information, see National Language Support.
`Client Idle Timeout: (Minutes)`	Set the time, in minutes, after which the client (browser) times out and automatically logs you out. Default value is 20 minutes, maximum 30.
`Max Opened Panels`	Set the maximum number of open items that will appear in the Open Items frame in the lower left corner. Default value is 8; maximum value is 10. NOTE: For users that require accessibility, set the maximum open items to 1 to make keyboard navigation easier to use. For more information, see Improve Accessibility.
`Expand All Tree Nodes at Start`	Click whether you want the domain tree in the left panel to be fully expanded every time you start Oracle Event Processing Visualizer
`Enable Fullscreen`	Click whether you want to enable the full screen function in Oracle Event Processing Visualizer. NOTE: For users that require accessibility, uncheck this item. For more information, see Improve Accessibility

Click Save.
When the preferences have been successfully modified, a confirmation message appears momentarily.

2.3 Improve Accessibility

Oracle Event Processing Visualizer is a Web application that uses Adobe Flex. This section describes how to improve the accessibility of Oracle Event Processing Visualizer when using a screen reader like JAWS.

For more information, see:

To improve Oracle Event Processing Visualizer accessibility:

Open the Oracle Event Processing Visualizer preferences panel.
See Manage User Preferences.
Set the Max Opened Panels option to 1.
Uncheck the Enable Fullscreen option.
Click Save.