2 Using Oracle Event Processing Visualizer

This chapter describes how to start and set preferences for Oracle Event Processing Visualizer, an application management tool provided with Oracle Event Processing.

This chapter includes the following sections:

For more information, see Chapter 1, "Overview of Oracle Event Processing Visualizer".

2.1 Starting the Oracle Event Processing Visualizer

Before you start Oracle Event Processing Visualizer, ensure that your system meets the minimum prerequisites as Section 2.1.1, "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 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:

2.1.2 How to Start Oracle Event Processing Visualizer Using a Browser

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

To start Oracle Event Processing Visualizer using a browser:

  1. Confirm that your browser meets the necessary requirements.

    See Section 2.1.1, "Prerequisites".

  2. 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_CEP_HOME/user_projects/domains/DOMAIN_DIR/servername/config directory, where ORACLE_CEP_HOME refers to the Oracle Event Processing installation directory (such as d:/oracle_cep), DOMAIN_DIR refers to the domain directory (such as my_domain), and servername refers to the server instance directory (such as server1). 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 Logon screen appears as Figure 2-1 shows.

    Figure 2-1 Oracle Event Processing Visualizer Logon Screen

    Description of Figure 2-1 follows
    Description of "Figure 2-1 Oracle Event Processing Visualizer Logon Screen"

  3. In the Logon screen, enter the name and password of 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 no login page when first entering Oracle Event Processing Visualizer.

    For more information, see "Enabling and Disabling Security" in the Oracle Fusion Middleware Administrator's Guide for Oracle Event Processing

  4. Click Logon.

    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 How to Start Oracle Event Processing Visualizer Using Oracle Event Processing IDE for Eclipse

Oracle provides an IDE targeted specifically to programmers that want to develop Oracle Event Processing applications. Oracle Event Processing IDE for Eclipse is a set of plugins for the Eclipse IDE designed to help develop, deploy, and debug applications for Oracle Event Processing. You can start the Oracle Event Processing Visualizer from within the Oracle Event Processing IDE for Eclipse to make using Oracle Event Processing Visualizer a seamless part of Oracle Event Processing application development.

For more information, see "How to Start the Oracle Event Processing Visualizer from Oracle Event Processing IDE for Eclipse" in the Oracle Fusion Middleware Developer's Guide for Oracle Event Processing for Eclipse.

2.1.4 How to Start Oracle Event Processing Visualizer in a Multi-Server Domain

You can use Oracle Event Processing Visualizer to administer a multi-server domain. As described in Section 2.1.2, "How to Start Oracle Event Processing Visualizer Using 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 multi-server 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 multi-server 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 multi-server 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 multi-server 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 multi-server domain are on different hosts and you plan to manage the multi-server 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 multi-server 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 "Introduction to Multi-Server Domains" in the Oracle Fusion Middleware Administrator's Guide for 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 multi-server domain.

To start Oracle Event Processing Visualizer in a multi-server domain:

  1. Create a multi-server domain.

    For example, assume you have a multi-server domain with three servers (defaultserver, server1, and server2). Each server directory is a child directory of the domain directory, which is /oracle_cep/user_projects/domains/myDomain.

    For more information, see "Multi-Server Domain Directory Structure" in the Oracle Fusion Middleware Administrator's Guide for Oracle Event Processing.

  2. Configure SSL to secure communication between the servers in the multi-server domain.

    For more information, see "Securing the Messages Sent Between Servers in a Multi-Server Domain" in the Oracle Fusion Middleware Administrator's Guide for Oracle Event Processing.

  3. Choose one Oracle Event Processing server in the multi-server domain to host Oracle Event Processing Visualizer access.

    In this example, defaultserver will host Oracle Event Processing Visualizer access.

  4. Specify the -disablevisualizer flag when you start the other servers in the multi-server 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_cep/user_projects/domains/myDomain/defaultserver
      prompt> startwlevs
      prompt> cd ../server1
      prompt> startwlevs -disablevisualizer
      prompt> cd ../server2
      prompt> startwlevs -disablevisualizer
    
  5. Configure SSL to secure communication between Oracle Event Processing Visualizer and defaultserver.

    For more information, see "How to Configure SSL in a Multi-Server Domain for Oracle Event Processing Visualizer" in the Oracle Fusion Middleware Administrator's Guide for Oracle Event Processing.

  6. Start Oracle Event Processing Visualizer.

    For more information, see:

2.2 Managing User Preferences

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

2.2.1 How to Manage User Preferences

You can use Oracle Event Processing Visualizer to manage user preferences.

To manage user preferences:

  1. 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 follows
    Description of "Figure 2-2 The Preference Screen"

  2. 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 Section 1.5, "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 5; 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 Section 2.3, "Improving Oracle Event Processing Visualizer 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 Section 2.3, "Improving Oracle Event Processing Visualizer Accessibility"


  3. Click Save.

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

2.3 Improving Oracle Event Processing Visualizer 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:

  1. Open the Oracle Event Processing Visualizer preferences panel.

    See Section 2.2, "Managing User Preferences".

  2. Set the Max Opened Panels option to 1.

  3. Uncheck the Enable Fullscreen option.

  4. Click Save.