• The wrapper does not like to work with multi-threaded apps that Juggler creates. So, in a bind you can run the RunDvgGL^? script with glxgears for a minute to get the state set for the boards and then simply run your app without the wrapper.

• DvgGL-four.cfg: Example DvgWrapper^? configuration file (2x2 Split).

Miscellaneous Issues

• Machine naming and resolving: In their default configurations, system utilities may not all return the same hostname information for a given DVG node due to the way networking, /etc/hosts, and various other settings of configured. This can cause some problems with VR Juggler clustering and with user-developed scripts.

• The wrapper settings can override and/or extend other graphics board specific settings. For example with nvidia Linux boards the antialiasing mode can be overridden by the wrapper configuration.

Written by: Infiscape Corporation
Aron Bierbaum and Allen Bierbaum

The purpose of this document is to explain how to run a VR Juggler cluster application on a ORAD DVG cluster. At the time of writing this document the ORAD system has only been tested with two compositing modes, Split Image and Multi-Sampling/Anti-Alias. This document will briefly explain the needed DvgWrapper and VR Juggler configuration files along with providing tips to help you along the way.

In order for the DvgWrapper to know how to set up the compositing chain you must provide a configuration file that specifies the compositing methods to be used. As the DVG documentation explains, there are multiple ways to specify a DVG wrapper configuration file. We recommend that you specify the configuration file by setting the DVG_GL_CONFIG environment variable. For example to use the attached example configuration file for a 4x4 tiled screen:

Before discussing the specific compositing methods and how you configure them it is worth noting a few key sections of the attached example configuration files that remain the same for all compositing methods. These sections will be explained briefly below.

Please see the dvg wrapper documentation for more detailed descriptions of all the following options. We will only discuss them as they pertain to VR Juggler operation.

There are a few X Server configuration settings that are recommended. The first MaximizeWindow forces any window opened to be full screen. This feature was tested, but seemed to only occasionally function. The last setting shown below, HideMouseCursor causes the X mouse curser to disappear.

To correctly configure the syncronization of the DVG cluster you must specify three things, SyncronizeDelay, SynchronizeOn, and a list of render nodes in your chain. The SyncronizeDelay attribute specifies the number of synchronization points that are initially skipped in order to ensure proper start-up of your application. The default value is 50, but smaller values will also work. The SynchronizeOn specifies which OpenGL command the DvgWrapper will wait for to initiate each synchronization barrier.

Misc Issues

There are several issues that we have run into that can be good to watch for.

• Machine naming and resolving: In their default configurations, system utilities may not all return the same hostname information for a given DVG node due to the way networking, /etc/hosts, and various other settings of configured. This can cause some problems with VR Juggler clustering and with user-developed scripts.

• The wrapper settings can override and/or extend other graphics board specific settings. For example with nvidia linux boards the antialiasing mode can be overridden by the wrapper configuration

Introduction

DVG Configuration Files

   setenv DVG_GL_CONFIG /home/aronb/dvgconfig/DvgGL-four.cfg

Before getting to the specific compositing methods and how to configure them it is worth noting a few key sections of the attached example configuration files do not change. These sections will be explained briefly below.

Basic DVG Settings

The first two lines shown below specify the video output format to be used. You must have the VideoMode attribute set to VR in order for the DvgWrapper to function properly. For more information about the VROutputFormat attribute consult your DVG documentation. The next attribute, GenlockSource specifies the signal coming into the chain to use for Genlock. This attribute should be set to None for proper operation. The PassThrough attribute disables all functionality of the wrapper and defaults to 0. The final attribute, SwapBarrier informs the wrapper if it should use its internal TCP/IP swap lock method. Since VR Juggler already provides a method to SwapLock the nodes, this should be disabled.

  <DvgConfig
    VideoMode        = "VR"
    VROutputFormat   = "60.02,1280,1328,1440,1688,1024,1025,1028,1066"
    GenlockSource    = "None"
    Multisample      = "0"   
    PassThrough      = "0"
    SwapBarrier      = "0"
  />

X Server Configuration

  <XConfig
    MaximizeWindow   = "1"
    HideMouseCursor  = "1"
  />

Synchronization Configuration

  <Synchronization>
    <Config SynchronizeDelay = "2" SynchronizeOn = "glXSwapBuffers" />
    <Renderer HostName = "dvg1-a" />
    <Renderer HostName = "dvg1-b" />
    <Renderer HostName = "dvg2-a" />
    <Renderer HostName = "dvg2-b" />
  </Synchronization>

VR Juggler Configuration Files

DisplayWindows will only be visible at the end of the DVG composite chain if they are opened on the proper section of the X Server and are of the correct size. For example lets assume that you have a single monitor attached to the last node in your DVG composite chain of four render nodes. Lets also assume that your final resolution is 1280x1024 and you want to split the image into four quadrants:

+---------------------+
|          |          |
|  Node 1  |  Node 2  |
|          |          |
+----------+----------+
|          |          |
|  Node 3  |  Node 4  |
|          |          |
+---------------------+

Since all nodes are drawing an equal sized section of the final image, on each node you must open a window at the origin with the proper size.

• Origin: (0,0)
• Size: (640, 512)

Important Environment Variables

   setenv DISPLAY :0
   ./runDvgGL myApp cluster.jconf

In order to see debug information from the DvgWrapper you can set the EB_MSG_LEVEL environment variable to one of the following settings.

• warning - Only display warnings and errors.
• info - Show a more verbose level of debug output.

The last environment variable discussed, DVG_NO_NOISE, disables the PC speaker that makes noises while initializing the DVG composite chain.

-- AronBierbaum - 09 Dec 2003