Commit 623ce789 authored by Russ Fish's avatar Russ Fish
Browse files

Tell people to build from sources for now instead of using a binary tarball.

parent 2e684a08
......@@ -16,13 +16,17 @@
</li>
</ol>
<h3><a name="intro"></a>Introduction</h3>
We have wrapped HyperViewer in a wxGlade Python graphical user
interface, and connected it to the Emulab database via XML-RPC to read
This is a client program which runs on your computer, and shows a 3D
view of the
network
topologies.<br>
topologies for Emulab experiments.&nbsp; In detail, we have wrapped the
HyperViewer in a wxGlade Python graphical user
interface, and connected it to the Emulab database via XML-RPC over SSH.<br>
<br>
The <a href="http://graphics.stanford.edu/papers/h3cga/">HyperViewer</a>
software was developed by Tamara Munzner at Stanford.&nbsp; It is
software was developed by <a
href="http://graphics.stanford.edu/%7Emunzner">Tamara Munzner at
Stanford</a>.&nbsp; It is
useful for
visualizing relationships within large graphs such as network
topologies, and is freely distributed as a <a
......@@ -50,44 +54,70 @@ tilings</a>.<br>
style="border: 2px solid ; width: 106px; height: 106px;" alt=""
title="Click for full-size image" src="LW436-thumb.jpg"></a><br>
<h3><a name="install"></a>Installing hypview</h3>
Getting and unpacking the tarball:<br>
Getting and unpacking the binary tarball:<br>
<ul>
<li>It's in ~fish/flux/testbed/hyperviewer/hyperviewer.tgz on BAS for
<li>Note: There are .so compatibility problems with .so shared
libraries used by wxPython, which we are working on.&nbsp; Meanwhile,
as this is Very Alpha Software now, your best bet is to jump to the
next section on building from sources.<br>
</li>
<li>The binary tarball is in
~fish/flux/testbed/hyperviewer/hyperviewer.tgz on BAS for
now.</li>
<li>There is a top-level hyperviewer directory in the tarball, so
just unpack with:<br>
</li>
</ul>
<div style="margin-left: 80px;">
<pre><big>tar xvzf ~fish/flux/testbed/hyperviewer/hyperviewer.tgz</big><br></pre>
<pre><big>tar xvzf ~fish/flux/testbed/hyperviewer/hyperviewer.tgz<br><br></big></pre>
</div>
Building from sources - This avoids shared library compatibility
problems, but requires that you have wxPython and its dependencies
installed on your machine first.<br>
<ul>
<li>To build the hypviewer C++ library and the _hv.so that is loaded
into Python:</li>
</ul>
<pre style="margin-left: 80px;"><big>cd testbed/hyperviewer<br>gmake -f GNUMakefile</big></pre>
<ul>
<li>See
the ROADMAP file if you want to know more about internals.</li>
</ul>
There are a couple of example files included:
<ul>
<li>There are a couple of example files included:</li>
</ul>
<div style="margin-left: 80px;">
<pre><big>cd hyperviewer<br>./hypview.py BigLan.hyp</big>
<br></pre>
<pre><big>cd testbed/hyperviewer<br>./hypview.py BigLan.hyp</big><big><br>./hypview.py ts600.hyp</big>
</pre>
</div>
Supported platforms:<br>
<ul>
<li>FreeBSD</li>
<li>FreeBSD - The first target.<br>
</li>
<ul>
<li>Run it on the old machines and ignore the Radeon text bug for
now.</li>
<li>Building it on the new machines has revealed a bug:
glPolygonOffsetEXT is missing.</li>
<li>If you want to rebuild, checkout testbed/hyperviewer and see
the ROADMAP.</li>
<li>There is a bug in the Radeon DRI driver which "tatters" bitmap
text.</li>
<li>There are different problems in the nVidia drivers.</li>
<li>Turning off hardware acceleration of OpenGL rendering is ugly
but works.</li>
</ul>
</ul>
<pre style="margin-left: 80px;"><big>cvs co testbed/hyperviewer</big><big><br>cd testbed/hyperviewer<br>gmake -f GNUMakefile</big></pre>
<ul>
<li>Linux and Windows as needed later.<br>
<li>Linux - Pretty much untested.</li>
<ul>
<li>Edit the GNUMakefile to select CPU=linux before building,</li>
<li>and also select the include of Makefile.linuxglut in
hypviewer/Makefile.main .<br>
</li>
</ul>
<li>Windows - Coming soon.</li>
<li>Please send problem reports to <a href="mailto:fish@cs.utah.edu">Russ
Fish</a>.<br>
</li>
</ul>
Package dependencies: <br>
<div style="margin-left: 40px;">It needs wxPython, gtk, glX,
OpenGL...&nbsp; and wxGlade on top if you want to modify the GUI.<br>
OpenGL...; and wxGlade on top if you want to modify the GUI.<br>
</div>
<h3><a name="run"></a>Running hypview as a script<br>
</h3>
......
Supports Markdown
0% or .
You are about to add 0 people to the discussion. Proceed with caution.
Finish editing this message first!
Please register or to comment