omniORB for i386 and PCC

CC='gcc -arch ppc -arch i386 -isysroot /Developer/SDKs/MacOSX10.4u.sdk -mmacosx-version-min=10.4' CXX='g++ -arch ppc -arch i386 -isysroot /Developer/SDKs/MacOSX10.4u.sdk -mmacosx-version-min=10.4'  CPP='gcc -E -traditional-cpp' CXXCPP='g++ -E' ./configure --prefix=...
make

Tips for Using configure.pl

When specifying multiple JAR files, separate them using the local shell's path separator character. In other words, if you are using a UNIX-style shell, use ':' (colon) to separate each JAR file. In DOS/Win32, use ';' (semi-colon). Whatever string you pass in is handed directly to the Java compiler and runtime, so the path must be valid for that specific version.

The steps are simple:

Dependencies

Boost

Documentation for compiling Boost can be found on the Boost website. That documentation will not be duplicated here as it is quite extensive and may change in the future.

NSPR

• Windows
• Solaris

How to Build It

We have found that it's best to use the absolute path to configure.pl when configuring a build. On Linux, this helps DDD (and possibly other tools) get its bearings so that debugging can be done effectively. Relative paths to source files tend to confuse DDD, and using the absolute path causes the source directories in the makefiles to appear as absolute paths.

The array returned by the user-defined Perl subroutine is merged with @ARGV. Arguments in @ARGV take precedence over default arguments. Thus, an argument given on the command line will always be used regardless of any default setting.

Dependencies

NSPR

• Windows
• Solaris

NSPR is optional on all other platforms. Binary distributions of NSPR can be downloaded from http://www.mozilla.org/projects/nspr/

JDOM

As of October 15, 2003, JDOM comes with the VR Juggler source tree. There is no need to download it separately. People interested in exploring the use of JDOM on their own can go the the JDOM website:

• omniORB: C++ CORBA ORB -- http://omniorb.sf.net/

You can get it here: http://sourceforge.net/project/showfiles.php?group_id=51138

• OpenORB: configure Tweek with --with-java-orb=OpenORB (recommended for JDK 1.3 users)
• JacORB: configure Tweek with --with-java-orb=JacORB

OpenORB used to be maintained by the Exolab Group, but it now exists a community project on SourceForge:

• avalon-framework.jar
• logkit.jar

IDL-to-Java Compiler

To compile the IDL code to Java, the Juggler source tree includes the JacORB IDL compiler, which is implemented entirely in Java. This makes it highly portable and very convenient. Using JacORB's IDL-to-Java compiler is highly recommended since it is the default and requires no special options to the configure script.

How to Build It

We have found that it's best to use the absolute path to configure.pl when configuring a build. On Linux, this helps DDD (and possibly other tools) get its bearings so that debugging can be done effectively. Relative paths to source files tend to confuse DDD, and using the absolute path causes the source directories in the makefiles to appear as absolute paths.

Tips for Using configure.pl

When specifying multiple JAR files, separate them using the local shell's path separator character. In other words, if you are using a UNIX-style shell, use ':' (colon) to separate each JAR file. In DOS/Win32, use ';' (semi-colon). Whatever string you pass in is handed directly to the Java compiler and runtime, so the path must be valid for that specific version.

IRIX SPROC (MIPSpro, 64-bit)

IRIX POSIX (MIPSpro, 32-bit)

IRIX POSIX (MIPSpro, 64-bit)

Red Hat Linux 8.0 (POSIX)

Win32

• Requires NSPR

Win32 Annoyances

Advanced Uses

Platform-Specific Gotchas

Solaris

• Requires NSPR
  • Solaris headers define system calls such as connect(2) and listen(2) as preprocessor #defines. This munges class declarations in VPR, and there is no easy workaround.

• The default compiler is the Sun Forte C++ compiler. While this compiler is not actually capable of compiling the code, this is done for consistency with other operating systems (IRIX, Windows, HP-UX) where the primary compiler is not GCC. To use GCC as the compiler, you must specify --with-gcc when running the configure script(s).

Win32

Below are some example calls to configure.pl that demonstrate how to provide paths for optional features (primarily the Java code). On IRIX and Linux (Red Hat, anyway), it should be possible to run configure.pl with no options and get a usable build of the C++ code base.

Red Hat Linux 8.0 (POSIX)

Fedora Core 1 (POSIX)

Make an Argument Defaults File

The array returned by the user-defined Perl subroutine is merged with @ARGV. Arguments in @ARGV take precedence over default arguments. Thus, an argument given on the command line will always be used regardless of any default setting.

NOTE: At this time, using the IDL compiler that comes with the JDK, idlj, is not supported. The Tweek build system includes a makefile that ssumes that the JacORB compiler is going to be used. The options used are not compatible with idlj, and invalid code will be generated. To fix this, the options need to be pushed into the Tweek configure script so that they are replaced automatically to match the IDL-to-Java compiler the user chose.

Compiling

How to Build It

IRIX SPROC (MIPSpro)

IRIX POSIX (POSIX)

Red Hat Linux 8.0 (POSIX)

Fedora Core 1 (POSIX)

Make an Argument Defaults File

The array returned by the user-defined Perl subroutine is merged with @ARGV. Arguments in @ARGV take precedence over default arguments. Thus, an argument given on the command line will always be used regardless of any default setting.

VR Juggler's build system relies upon using several UNIX-based tools and scripting methods. Because of this, Cygwin is required to compile from source. It is not required to compile applications against binary releases of VR Juggler.

Make sure to install:

IRIX SPROC (MIPSpro)

IRIX POSIX (POSIX)

Red Hat Linux 8.0 (POSIX)

JDOM

• JDOM: Java DOM API -- http://www.jdom.org/

CORBA Implementation for C++

The Tweek module makes use of CORBA to facilitate communication between Java and C++ code. To use the Tweek C++ API (which is optional and probably always will be), you have to have a C++ implementation of CORBA. So far, we have done all of our testing with omniORB, which can be downloaded from the following site:

• omniORB: C++ CORBA ORB -- http://omniorb.sf.net/

You can get it here: http://sourceforge.net/project/showfiles.php?group_id=51138

IRIX SPROC (MIPSpro)

Make an Argument Defaults File

Win32 Annoyances

Compiling (Quick Reference)

Compiling under Win32 is a little different, but it's not too bad if you follow these rules:

NOTE: A binary build of NSPR can be found on the Mozilla website.

Advanced Uses

This section details interesting tidbits about the VR Juggler build system that are not documented anywhere else at this time. These pieces are not documented for one or more of the following reasons:

The array returned by the user-defined Perl subroutine is merged with @ARGV. Arguments in @ARGV take precedence over default arguments. Thus, an argument given on the command line will always be used regardless of any default setting.

Example configure.pl Calls

Make an Argument Defaults File

You can find Java for most platforms at: http://java.sun.com/j2se/

VR Juggler's build system relies upon using several UNIX-based tools and scripting methods. Because of this, Cygwin is required to compile from source. It is not required to compile applications against binary releases of VR Juggler.

• OpenSSH

In addition, a subset of Cygwin is included in

NSPR

To use the Tweek JAVA API (which is required if you want to build VRJConfig), you must have a Java implementation of CORBA. At this time, the Tweek build system supports three such implementations:

• JacORB: configure Tweek with --with-java-orb=JacORB

Java IDL comes with the JDK, but you must use JDK 1.4 or newer. Previous versions of Java IDL will not work.

• OpenORB: Java CORBA ORB -- http://openorb.sourceforge.net/

At this time, we are not making use of any of the OpenORB extra services, so there is no need to download them. At some point, this may change, especially if we start to make use of SSL with CORBA.

Using cvs-gather.pl

cvs-gather allows us to automatically checkout source code from several projects that VR Juggler depends upon. It is meant to simplify a developer's life by automating the tasks of source code collection.

Win32

• Requires NSPR

Win32 Annoyances

• The %PATH% environment variable inside a Cygwin shell needs to have the UNIX-style paths instead of the style above.

Visual C++ Environment Variables

mkdir build.win32
cd build.win32

JDOM Path

Advanced Uses

1. Inclusion in the general documentation may cause unnecessary confusion
2. The documentation is still in development and not ready for widespread public consumption

Default Arguments for configure.pl

The array returned by the user-defined Perl subroutine is merged with @ARGV. Arguments in @ARGV take precedence over default arguments. Thus, an argument given on the command line will always be used regardless of any default setting.