Show
Ignore:
Timestamp:
04/20/04 10:39:43 (5 years ago)
Author:
patrickh
Message:

Regenerate.

Files:

Legend:

Unmodified
Added
Removed
Modified
Copied
Moved

  • trunk/juggler/INSTALL.html

    r14773 r14775  
    11<html><head> 
    22      <meta http-equiv="Content-Type" content="text/html; charset=ISO-8859-1"> 
    3    <title>Building and Installing the Juggler Project (Version 1.1/2.0)</title><link rel="stylesheet" href="base_style.css" type="text/css"><meta name="generator" content="DocBook XSL Stylesheets V1.65.1"></head><body bgcolor="white" text="black" link="#0000FF" vlink="#840084" alink="#0000FF"><div class="article" lang="en"><div class="titlepage"><div><div><h1 class="title"><a name="d0e1"></a>Building and Installing the Juggler Project (Version 1.1/2.0)</h1></div><div><div class="authorgroup"><div class="author"><h3 class="author"><span class="othername">The Juggler Team</span></h3></div></div></div><div><p class="pubdate">$Date$</p></div></div><div></div><hr></div><div class="toc"><p><b>Table of Contents</b></p><dl><dt><span class="section"><a href="#d0e15">Introduction</a></span></dt><dd><dl><dt><span class="section"><a href="#d0e32">Important Notes for IRIX Users</a></span></dt><dt><span class="section"><a href="#d0e116">Important Note for Win32 Users</a></span></dt></dl></dd><dt><span class="section"><a href="#source.code.section">Getting the Source Code and the Dependencies</a></span></dt><dd><dl><dt><span class="section"><a href="#d0e198">How to Get the Juggler Suite from CVS</a></span></dt><dt><span class="section"><a href="#d0e208">Downloading Binary Dependencies</a></span></dt></dl></dd><dt><span class="section"><a href="#compile.section">Compiling</a></span></dt><dd><dl><dt><span class="section"><a href="#d0e313">Important Note Regarding Compiling</a></span></dt><dt><span class="section"><a href="#d0e324">Compiling the Juggler Suite of Tools</a></span></dt><dt><span class="section"><a href="#compile.individual.section">Tips for Compiling Individual Tools in the Juggler Suite</a></span></dt></dl></dd></dl></div><div class="section" lang="en"><div class="titlepage"><div><div><h2 class="title" style="clear: both"><a name="d0e15"></a>Introduction</h2></div></div><div></div></div><p>You have downloaded the source code for Version 1.1 of the Juggler 
     3   <title>Building and Installing the Juggler Project (Version 1.1/2.0)</title><link rel="stylesheet" href="base_style.css" type="text/css"><meta name="generator" content="DocBook XSL Stylesheets V1.65.1"></head><body bgcolor="white" text="black" link="#0000FF" vlink="#840084" alink="#0000FF"><div class="article" lang="en"><div class="titlepage"><div><div><h1 class="title"><a name="d0e1"></a>Building and Installing the Juggler Project (Version 1.1/2.0)</h1></div><div><div class="authorgroup"><div class="author"><h3 class="author"><span class="othername">The Juggler Team</span></h3></div></div></div><div><p class="pubdate">$Date$</p></div></div><div></div><hr></div><div class="toc"><p><b>Table of Contents</b></p><dl><dt><span class="section"><a href="#d0e15">Introduction</a></span></dt><dd><dl><dt><span class="section"><a href="#d0e32">Important Notes for IRIX Users</a></span></dt><dt><span class="section"><a href="#d0e116">Important Note for Win32 Users</a></span></dt></dl></dd><dt><span class="section"><a href="#source.code.section">Getting the Source Code and the Dependencies</a></span></dt><dd><dl><dt><span class="section"><a href="#d0e191">How to Get the Juggler Suite from CVS</a></span></dt><dt><span class="section"><a href="#d0e201">Downloading Binary Dependencies</a></span></dt></dl></dd><dt><span class="section"><a href="#compile.section">Compiling</a></span></dt><dd><dl><dt><span class="section"><a href="#d0e306">Important Note Regarding Compiling</a></span></dt><dt><span class="section"><a href="#d0e317">Compiling the Juggler Suite of Tools</a></span></dt><dt><span class="section"><a href="#compile.individual.section">Tips for Compiling Individual Tools in the Juggler Suite</a></span></dt></dl></dd></dl></div><div class="section" lang="en"><div class="titlepage"><div><div><h2 class="title" style="clear: both"><a name="d0e15"></a>Introduction</h2></div></div><div></div></div><p>You have downloaded the source code for Version 1.1 of the Juggler 
    44    Project. This is the code that will become VR Juggler 2.0, and it is the 
    55    code that is used to create the VR juggler 2.0 pre-releases. Please be 
    …… 
    8888        A C++ implementation of CORBA 2.3, required for the Tweek C++ API.</p></li></ul></div><p>In the following subsections, we describe how to get all of the 
    8989    above except Boost, CppDOM, the JDK, OpenORB, omniORB, and NSPR. These 
    90     must be downloaded separately from the sites listed above. You may also 
     90    must be downloaded individually from the sites listed above. You may also 
    9191    have to compile one or more of the packages if binary distributions are 
    9292    not available. Which packages you download depends on what you already 
    9393    have installed. Note carefully which packages are needed based on the 
    9494    software you have installed and what versions of tools (such as the JDK) 
    95     that you download.</p><p>This remainder of this section is <span class="emphasis"><em>only</em></span> for 
    96     those users who want to get the Juggler Project source code from the CVS 
    97     repository on SourceForge. Those users who have downloaded a pre-packaged 
    98     version of the source should skip ahead to <a href="#using.configure.pl" title="Using configure.pl">the section called &#8220;Using configure.pl&#8221;</a>.</p><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="d0e198"></a>How to Get the Juggler Suite from CVS</h3></div></div><div></div></div><p>You can optionally get the Juggler Project as a source code 
     95    that you download.</p><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="d0e191"></a>How to Get the Juggler Suite from CVS</h3></div></div><div></div></div><p>You can optionally get the Juggler Project as a source code 
    9996      tarball from the website (<a href="http://www.vrjuggler.org/" target="_top">http://www.vrjuggler.org/</a>) 
    10097      or you can execute the following commands from a shell to get the code 
    10198      from our CVS repository:</p><pre class="screen">cvs -d :pserver:anonymous@cvs.vrjuggler.sourceforge.net:/cvsroot/vrjuggler login 
    102 cvs -z3 -d :pserver:anonymous@cvs.vrjuggler.sourceforge.net:/cvsroot/vrjuggler co juggler</pre></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="d0e208"></a>Downloading Binary Dependencies</h3></div></div><div></div></div><p>In addition to source the dependencies acquired through CVS, there 
     99cvs -z3 -d :pserver:anonymous@cvs.vrjuggler.sourceforge.net:/cvsroot/vrjuggler co juggler</pre></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="d0e201"></a>Downloading Binary Dependencies</h3></div></div><div></div></div><p>In addition to source the dependencies acquired through CVS, there 
    103100      are some third-party dependencies that must be installed separately. 
    104101      Remember that no Java code in VR Juggler can be used without the JDK and 
    105102      a working Java version of CORBA (either from OpenORB, JacORB, or the JDK 
    106       itself).</p><div class="section" lang="en"><div class="titlepage"><div><div><h4 class="title"><a name="d0e213"></a>Boost</h4></div></div><div></div></div><p>The minimum required version of Boost, as of this writing, is 
     103      itself).</p><div class="section" lang="en"><div class="titlepage"><div><div><h4 class="title"><a name="d0e206"></a>Boost</h4></div></div><div></div></div><p>The minimum required version of Boost, as of this writing, is 
    107104        1.31.0. The Boost source can be downloaded from <a href="http://www.sf.net/projects/boost/" target="_top">http://www.sf.net/projects/boost/</a>. 
    108105        To compile and install Boost, refer to its installation documentation 
    109106        (<a href="http://www.boost.org/more/getting_started.html#Build_Install" target="_top">http://www.boost.org/more/getting_started.html#Build_Install</a>). 
    110107        Note that you need the command <span><b class="command">bjam</b></span> (referred to as 
    111         &#8220;<span class="quote">boost-jam</span>&#8221; on the Boost download page) to build Boost.</p></div><div class="section" lang="en"><div class="titlepage"><div><div><h4 class="title"><a name="d0e230"></a>CppDOM</h4></div></div><div></div></div><p>For XML processing, we use CppDOM 0.3.2 or newer. The source and 
     108        &#8220;<span class="quote">boost-jam</span>&#8221; on the Boost download page) to build Boost.</p></div><div class="section" lang="en"><div class="titlepage"><div><div><h4 class="title"><a name="d0e223"></a>CppDOM</h4></div></div><div></div></div><p>For XML processing, we use CppDOM 0.3.2 or newer. The source and 
    112109        binary distributions for some platforms can be downloaded from <a href="http://www.sf.net/projects/xml-cppdom/" target="_top">http://www.sf.net/projects/xml-cppdom/</a>. 
    113110        If a binary version is not available for your operating system you 
    114111        must compile and install CppDOM yourself. Note that you need SCons (<a href="http://scons.sourceforge.net/" target="_top">http://scons.sourceforge.net/</a>) 
    115         to build and install CppDOM.</p></div><div class="section" lang="en"><div class="titlepage"><div><div><h4 class="title"><a name="d0e241"></a>GMTL</h4></div></div><div></div></div><p>For high-level mathematical operations, we use GMTL 0.3.2 or 
     112        to build and install CppDOM.</p></div><div class="section" lang="en"><div class="titlepage"><div><div><h4 class="title"><a name="d0e234"></a>GMTL</h4></div></div><div></div></div><p>For high-level mathematical operations, we use GMTL 0.3.2 or 
    116113        newer. The source distribution can be downloaded from <a href="http://www.sf.net/projects/ggt/" target="_top">http://www.sf.net/projects/ggt/</a>. 
    117114        Note that you need SCons (<a href="http://scons.sourceforge.net/" target="_top">http://scons.sourceforge.net/</a>) 
    118         to build and install GMTL.</p></div><div class="section" lang="en"><div class="titlepage"><div><div><h4 class="title"><a name="d0e252"></a>Netscape Portable Runtime (NSPR)</h4></div></div><div></div></div><p>Our operating system abstraction, VPR, can make use of NSPR for 
     115        to build and install GMTL.</p></div><div class="section" lang="en"><div class="titlepage"><div><div><h4 class="title"><a name="d0e245"></a>Netscape Portable Runtime (NSPR)</h4></div></div><div></div></div><p>Our operating system abstraction, VPR, can make use of NSPR for 
    119116        operating system primitives. On some platforms (IRIX, FreeBSD, Linux), 
    120117        the use of NSPR is strictly optional. On others (Win32, Mac OS X, and 
    121         Solaris), it is required. Based on your local system you should decide 
    122         whether you need NSPR. Binary versions of NSPR can be downloaded from 
    123         <a href="ftp://ftp.mozilla.org/pub/mozilla.org/nspr/releases" target="_top">ftp://ftp.mozilla.org/pub/mozilla.org/nspr/releases</a>. 
    124         At this time, we recommend the use of version 4.2 or newer.</p></div><div class="section" lang="en"><div class="titlepage"><div><div><h4 class="title"><a name="d0e260"></a>Java Developer Kit (also called the J2SE SDK)</h4></div></div><div></div></div><p>We make use of the Java programming language in addition to C++. 
     118        Solaris), it is required. Based on your local system, you should 
     119        decide whether you need NSPR. Binary versions of NSPR can be 
     120        downloaded from <a href="ftp://ftp.mozilla.org/pub/mozilla.org/nspr/releases" target="_top">ftp://ftp.mozilla.org/pub/mozilla.org/nspr/releases</a>. 
     121        At this time, we recommend the use of version 4.2 or newer.</p></div><div class="section" lang="en"><div class="titlepage"><div><div><h4 class="title"><a name="d0e253"></a>Java Developer Kit (also called the J2SE SDK)</h4></div></div><div></div></div><p>We make use of the Java programming language in addition to C++. 
    125122        Java is used exclusively for GUIs such as Tweek and VRJConfig (which 
    126123        is a JavaBean that is loaded into Tweek). To compile the Java code, a 
    …… 
    128125        recommend version 1.4 or newer. The Java Standard Edition can be 
    129126        downloaded from <a href="http://java.sun.com/j2se/" target="_top">http://java.sun.com/j2se/</a>. 
    130         More information can be found at <a href="http://java.sun.com/" target="_top">http://java.sun.com/</a>.</p></div><div class="section" lang="en"><div class="titlepage"><div><div><h4 class="title"><a name="d0e271"></a>OpenORB</h4></div></div><div></div></div><p>OpenORB is a pure-Java implementation of CORBA 2.3. It is 
     127        More information can be found at <a href="http://java.sun.com/" target="_top">http://java.sun.com/</a>.</p></div><div class="section" lang="en"><div class="titlepage"><div><div><h4 class="title"><a name="d0e264"></a>OpenORB</h4></div></div><div></div></div><p>OpenORB is a pure-Java implementation of CORBA 2.3. It is 
    131128        required in order to compile the Tweek Java API (and hence VRJConfig) 
    132129        if you are using a version of the JDK older than 1.4.0. OpenORB 1.3.0 
    …… 
    135132        <tt class="filename">avalon-framework.jar</tt>, and <tt class="filename">logkit.jar</tt>. 
    136133        All three come with a standard OpenORB distribution. We will show how 
    137         to tell the configure scripts about these JAR files later.</p></div><div class="section" lang="en"><div class="titlepage"><div><div><h4 class="title"><a name="d0e290"></a>omniORB</h4></div></div><div></div></div><p>omniORB is a C++ implementation of CORBA 2.3. It is required in 
     134        to tell the configure scripts about these JAR files later.</p></div><div class="section" lang="en"><div class="titlepage"><div><div><h4 class="title"><a name="d0e283"></a>omniORB</h4></div></div><div></div></div><p>omniORB is a C++ implementation of CORBA 2.3. It is required in 
    138135        order to compile the Tweek C++ API. At this time, the Tweek C++ API is 
    139136        not required for VR Juggler, but this situation will change in the 
    …… 
    148145        details on this.</p></div></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h2 class="title" style="clear: both"><a name="compile.section"></a>Compiling</h2></div></div><div></div></div><p>In this section, we describe how to compile the Juggler Project. We 
    149146    focus on VR Juggler as a whole, but information about some of the 
    150     individual components is provided later.</p><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="d0e313"></a>Important Note Regarding Compiling</h3></div></div><div></div></div><p>You have downloaded <span class="emphasis"><em>developmental</em></span> code. It 
     147    individual components is provided later.</p><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="d0e306"></a>Important Note Regarding Compiling</h3></div></div><div></div></div><p>You have downloaded <span class="emphasis"><em>developmental</em></span> code. It 
    151148      may not be stable, and it may not even compile. Compiling VR Juggler 
    152149      itself can be a little complicated for anyone who does not have some 
    153150      background in using CVS, Autoconf, C++, and <span><b class="command">make</b></span> or 
    154       Visual Studio.</p></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="d0e324"></a>Compiling the Juggler Suite of Tools</h3></div></div><div></div></div><p>This section explains how to get, configure, and compile all of 
     151      Visual Studio.</p></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="d0e317"></a>Compiling the Juggler Suite of Tools</h3></div></div><div></div></div><p>This section explains how to get, configure, and compile all of 
    155152      the tools that make up VR Juggler. Each tool compiles to its own library 
    156153      and can be installed individually. (Refer to the <tt class="filename">README</tt> 
    …… 
    215212          members of the Juggler team configure VR Juggler. It also has 
    216213          information on more advanced uses of <span><b class="command">configure.pl</b></span> 
    217           that are beyond the scope of this document.</p></div><div class="section" lang="en"><div class="titlepage"><div><div><h5 class="title"><a name="d0e478"></a>Using Locally Installed Software</h5></div></div><div></div></div><p>As noted in <a href="#source.code.section" title="Getting the Source Code and the Dependencies">the section called &#8220;Getting the Source Code and the Dependencies&#8221;</a>, VR Juggler 
     214          that are beyond the scope of this document.</p></div><div class="section" lang="en"><div class="titlepage"><div><div><h5 class="title"><a name="d0e471"></a>Using Locally Installed Software</h5></div></div><div></div></div><p>As noted in <a href="#source.code.section" title="Getting the Source Code and the Dependencies">the section called &#8220;Getting the Source Code and the Dependencies&#8221;</a>, VR Juggler 
    218215          depends on several external software packages. As an example, 
    219216          consider the case where the GMTL library is installed in