Configuring Server Environment Using *.pvx XML Files: Difference between revisions

From KitwarePublic
Jump to navigationJump to search
(Add link to Immersive_ParaView page)
 
(5 intermediate revisions by 3 users not shown)
Line 23: Line 23:
       ------------------------------------------------------
       ------------------------------------------------------
     -->
     -->
     <Machine proc_id="<num>"
     <Machine name="hostname"
             Environment="DISPLAY=m1:0"
             Environment="DISPLAY=m1:0"
             LowerLeft="-1.0 -1.0 -1.0"
             LowerLeft="-1.0 -1.0 -1.0"
Line 32: Line 32:
         each one identifying the configuration for a process.  
         each one identifying the configuration for a process.  
         All attributes are optional.
         All attributes are optional.
         proc_id  : used to identify the process by process id.
         name="hostname"
                    If not present, it is assumed to be sequentially increasing.
         Environment: the environment for the process.
         Environment: the environment for the process.
         LowerLeft|LowerRight|UpperLeft : CAVE configuration parameters applicable
         LowerLeft|LowerRight|UpperLeft : CAVE configuration parameters applicable
Line 43: Line 42:
</pvx>
</pvx>
</source>
</source>
* Only 2 vectors ([LowerRight - LowerLef] and [UpperLeft - LowerLeft]) are needed, the third vector is computed from these 2.
== Cave Rendering ==
===Instructions===
* Turn on <code>PARAVIEW_USE_MPI</code> and <code>PARAVIEW_USE_ICE_T</code>
* run the servers using the pvx file: <code>mpiexec -np 2 pvserver cave.pvx</code>
* start and connect a client
=== Notes ===
* See below for an example of a cave configuration file
<source lang="xml">
<?xml version="1.0" ?>
<pvx>
<Process Type="client" />
<Process Type="server">
  <!-- 2 render windows will be created on the machine Erna:
      the first rendering has a camera looking forward,
      the second rendering has a camera looking backward -->
  <Machine Name="Erna"
          Environment="DISPLAY=:0"
          FullScreen="0" <!-- since version v3.98.0-201-g1ae250c -->
          ShowBorders="0" <!-- since version v3.98.0-201-g1ae250c -->
          Geometry="1024x768+0+0" <!-- since version v3.98.0-123-ge32eeed -->
          <!-- Camera looks forward:
                dx = 2, dy = 2, dz = -2
                Z = -2 defines the view angle  -->
          LowerLeft="-1 -1 -2"
          LowerRight="1 -1 -2"
          UpperLeft="-1  1 -2" />
  <Machine Name="Erna"
          Environment="DISPLAY=:0"
          <!-- Camera looks backward:
                dx = -2, dy = 2, dz = 2
                Z = 2 defines the distance from the camera to the view plane  -->
          LowerLeft="1 -1 2"
          LowerRight="-1 -1 2"
          UpperLeft="1  1 2" />
  </Process>
</pvx>
</source>
* See vtkCaveRenderManager::ComputeCamera for more information on how the coordinates are used to configure the cameras
* The rendering on the server is full screen by default. If you want the windows to be smaller for debugging, set the environment variable PV_ICET_WINDOW_BORDERS=1 on the client machine.
== Related Pages ==
* [[Immersive_ParaView]]

Latest revision as of 13:49, 7 August 2013

When running pvserver/pvdataserver or pvrenderserver on a cluster, users may want to configure some environment variables eg. DISPLAY in case of multi-headed nodes for the processes. This can be done using the PVX configuration XML file.

Where to specify this?

  • pvx file can be specified as the last command line argument for any of the server processes.
  • Typically the pvx file is specified for all the executables whose environment is being changed using the pvx file. In case of data-server/render-server configuration, if you are setting up the environment for the two processes groups, then the pvx file must be passed as a command line option to both the executables: pvdataserver and pvrenderserver.
  • When running in parallel the file is read on all nodes, hence must be present on all nodes.

Structure

<source lang="xml"> <?xml version="1.0" ?> <pvx> 

 <Process Type="server|dataserver|renderserver">
   <Machine name="hostname"
            Environment="DISPLAY=m1:0"
            LowerLeft="-1.0 -1.0 -1.0"
            LowerRight="1.0 -1.0 -1.0"
            UpperLeft="-1.0  1.0 -1.0">
   </Machine>
 </Process>

</pvx> </source>

  • Only 2 vectors ([LowerRight - LowerLef] and [UpperLeft - LowerLeft]) are needed, the third vector is computed from these 2.

Cave Rendering

Instructions

  • Turn on PARAVIEW_USE_MPI and PARAVIEW_USE_ICE_T
  • run the servers using the pvx file: mpiexec -np 2 pvserver cave.pvx
  • start and connect a client

Notes

  • See below for an example of a cave configuration file

<source lang="xml"> <?xml version="1.0" ?> <pvx> 

<Process Type="client" />
<Process Type="server">
 <Machine Name="Erna"
          Environment="DISPLAY=:0"
          FullScreen="0" 
          ShowBorders="0" 
          Geometry="1024x768+0+0" 
          LowerLeft="-1 -1 -2"
          LowerRight="1 -1 -2"
          UpperLeft="-1  1 -2" />
 <Machine Name="Erna"
          Environment="DISPLAY=:0"
          LowerLeft="1 -1 2"
          LowerRight="-1 -1 2"
          UpperLeft="1  1 2" />
 </Process>

</pvx> </source>

  • See vtkCaveRenderManager::ComputeCamera for more information on how the coordinates are used to configure the cameras
  • The rendering on the server is full screen by default. If you want the windows to be smaller for debugging, set the environment variable PV_ICET_WINDOW_BORDERS=1 on the client machine.

Related Pages

Retrieved from "https://public.kitware.com/Wiki/index.php?title=Configuring_Server_Environment_Using_*.pvx_XML_Files&oldid=53808"