NOTE: The TIBCO Hawk data source may not be licensed in your RTView installation.

By default, the Display Builder and Display Viewer Application communicate with TIBCO Hawk using the TIBCO Rendezvous Daemon (rvd) process. The rvd process is automatically started by TIBCO Hawk whenever it is needed and runs as a background service. Due to security restrictions, TIBCO Hawk does not allow applets to communicate with TIBCO Hawk using rvd. You must either use the TIBCO Rendezvous Agent Process (rva) or, starting in TIBCO Hawk version 4.5, an EMS transport. If you use rva, this process must be started manually and must be configured for your daemon connection. The rva process must already be running before the Display Viewer Applet is started.

If you do not want to use the rva process, you may use an EMS transport or you may redirect TIBCO data through the Data Server. Using the Data Server also eliminates the requirement to run the Display Viewer Applet from a web server. Using an EMS transport requires that you are running TIBCO Rendezvous version 7.2+ and TIBCO Hawk 4.5+.

In order to facilitate testing, you may run the Display Builder and Display Viewer Application using rva. As with the Display Viewer Applet, the rva process must already be running before the Display Builder or Display Viewer Application are started in rva mode.

Running the TIBCO Rendezvous Agent Process
The rva process must be running in order for the Display Viewer Applet to communicate with TIBCO Hawk. It must also be running for the Display Builder or Display Viewer Application to communicate with TIBCO Hawk if they are running in rva mode. RTView assumes that rva is running on your local machine using the default port. If rva is running on a different host or port, you will need to specify both the host and the port either in the Application Options dialog or on the command line.

Review the appropriate section below to determine what host and port parameters you will need to specify. If you are not sure which section applies to you, contact your TIBCO Hawk system administrator.

If you have never run rva, you must configure rva with your daemon connection.

If rva is already running on your local machine
You do not need to specify a host. You do not need to specify a port if rva is running on the default port. Otherwise, you will need to specify a port either in the Application Options dialog or on the command line. Please refer to TIBCO Rendezvous documentation for more information on running rva.

If you have not configured the daemon connection, you will need to Configure the TIBCO Rendezvous Agent Process in order to communicate with TIBCO Hawk.

If rva is running on another machine on your network
You need to specify the name of the host that is running rva. You do not need to specify a port if rva is running on the default port. Otherwise, you will need to specify both the host and the port either in the Application Options dialog or on the command line. Please refer to TIBCO Rendezvous documentation for more information on running rva.

If you have not configured the daemon connection, you will need to Configure the TIBCO Rendezvous Agent Process in order to communicate with TIBCO Hawk.

If rva is not already running
You need to start rva on your local machine:

1. Open a Command Prompt window, go to <rendezvous installation>\bin and type

    rva -store rvafilename

where rvafilename is the name of the file where your rva settings are stored. If you have never run rva this file will not exist. In this case, rva will create a file by the name you specify and save the rva settings to that file.

2. This will start rva and print some information regarding rva to the console.  Note the following information:

         RVA: Http interface:
         RVA Listen:
         RVA Host:

RVA Listen will be the port and RVA Host will be the host that you will use to run RTView. The RVA Http interface (e.g.: http://hostname:7680/) is necessary to configure rva to work with messages sent by the data simulator.

3. If the RVA Listen is 7600 and RVA Host is the name of the machine you are running on, you will not need to specify either parameter. Otherwise, you will need to specify the host and/or the porteither in the Application Options dialog or on the command line. Please refer to TIBCO Rendezvous documentation for more information on running rva.

4. Since you have never run rva, you must Configure the TIBCO Rendezvous Agent Process  for you daemon connection.
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Configuring the TIBCO Rendezvous Agent Process

To configure the TIBCO Rendezvous Agent Process (rva) for your daemon connection:

1. Open a browser to the rva http interface address. If you do not know the rva http interface, the default is

       http://host:7680/

where host is the name of your machine.  If this does not work, contact your TIBCO Hawk system administrator.  Your setup may be running with a different http interface or you may not have permission to change the rva settings.  The browser interface should look similar to the following:

2. Click on the connection link to go to the Connection Configuration screen.

Type your service, network and daemon settings. If you do not know your settings, use the default settings or contact your TIBCO Hawk system administrator. The default settings are
        service: 7474
        network: ;
        daemon: tcp:7474

3. Click the Submit button.

4. Click on the subjects link to go to the Subjects Configuration screen.

Type the following character into the Add Subject field: >

5. Click the Add for Import and Export button.

6. Click on the change state link.

7. Click the button marked Change state to idle. Click the button marked Change state to running.

Once rva has been setup, the daemon configuration information will be stored in the specified settings file. Please refer to your TIBCO Rendezvous documentation for more information regarding configuring rva.