2 Use Visualizer

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

This chapter includes the following sections:

For more information, see Oracle Stream Analytics Visualizer.

2.1 Start Visualizer

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

Choose how you want to start Oracle Stream Analytics Visualizer:

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

2.1.1 Prerequisites

Before starting Oracle Stream Analytics 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 Stream Analytics Visualizer tasks, you must log into Oracle Stream Analytics Visualizer using an Oracle Stream Analytics 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 Stream Analytics 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 Stream Analytics 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 Stream Analytics 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 Stream Analytics 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 Stream Analytics Visualizer Login Screen

Description of "Figure 2-1 Oracle Stream Analytics 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 Stream Analytics Visualizer work only if you have security enabled for Oracle Stream Analytics server. If you disable Oracle Stream Analytics server security, then:
- Oracle Stream Analytics 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 Stream Analytics Visualizer, but you can enter anything for the user name and password.
For more information, see Users, Groups, and Roles in Administering Oracle Stream Analytics.
Click Login.

Note that if you stop the server while Oracle Stream Analytics 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 Stream Analytics Visualizer to administer a multiserver domain. As described in Start Visualizer from a Browser, Oracle Stream Analytics Visualizer works by connecting to one particular Oracle Stream Analytics server, based on its host and port.

In the case of a multiserver domain, you connect to one Oracle Stream Analytics server in the domain and then access the other servers from that server. All servers in a multiserver domain are candidates to host Oracle Stream Analytics 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 Stream Analytics Visualizer and disable Oracle Stream Analytics Visualizer access from all servers except for one in the multiserver domain.

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

When using Oracle Stream Analytics 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 Stream Analytics servers in your multiserver domain are on different hosts and you plan to manage the multiserver domain using the Oracle Stream Analytics 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 Stream Analytics server.

For more information, see config.xml in Administering Oracle Stream Analytics.

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, config.xml in Administering Oracle Stream Analytics.
Configure SSL to secure communication between the servers in the multiserver domain.

For more information, see Multiserver Administration in Administering Oracle Stream Analytics.
Choose one Oracle Stream Analytics server in the multiserver domain to host Oracle Stream Analytics Visualizer access.

In this example, defaultserver will host Oracle Stream Analytics Visualizer access.
Specify the -disablevisualizer flag when you start the other servers in the multiserver domain that will not provide access to Oracle Stream Analytics Visualizer.
You want the defaultserver to host Oracle Stream Analytics Visualizer and thus must disable access to Oracle Stream Analytics 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 Stream Analytics Visualizer and defaultserver.

For more information, see Oracle Stream Analytics Multiserver Administration in Administering Oracle Stream Analytics.
Start Oracle Stream Analytics Visualizer.

For more information, see Start Visualizer from a Browser.

2.2 Manage User Preferences

Oracle Stream Analytics 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 Stream Analytics 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 Stream Analytics Visualizer Preferences Attributes

Attribute	Description
`Select Language`	Select the language that Oracle Stream Analytics 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 Stream Analytics Visualizer
`Enable Fullscreen`	Click whether you want to enable the full screen function in Oracle Stream Analytics 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 Stream Analytics Visualizer is a Web application that uses Adobe Flex. This section describes how to improve the accessibility of Oracle Stream Analytics Visualizer when using a screen reader like JAWS.

For more information, see:

http://www.adobe.com/accessibility/products/flex/jaws.html

To improve Oracle Stream Analytics Visualizer accessibility:

Open the Oracle Stream Analytics Visualizer preferences panel.

See Manage User Preferences.
Set the Max Opened Panels option to 1.
Uncheck the Enable Fullscreen option.
Click Save.