XDA 4.1 Tutorials

Additional Software:

Software Version	Abbreviation
SunOS 5.8; Forte Developer 7 C++ 5.4 Patch 111715-03	(Forte)
Windows XP Professional; Microsoft Development Environment 2003 Version 7.1 Visual C++ .NET	(.NET)
Java 2 Standard Edition 1.4.1	(Java)
ACE+TAO x.3.1	(ACE+TAO)
JacORB 1.4.1	(JAC)
Apache Ant version 1.5	(ANT)
MySQL 4.0.x	(MySQL)
MyODBC 3.51.x	(MyODBC)
JDBC 3.0.x	(JDBC)
iODBC 3.0 or later (Unix only)	(iODBC)
XercesC 2.3.0	(XERCES)
XalanC 1.6.0	(XALAN)

Environment Variables:

Name	Description	Unix example	WinXP example
XDA_ROOT	Directory where XDA 4.1 is installed (vc71tao, sun54tao)	/proj/xda4.1/sun54tao	C:\vc71tao
ACE_ROOT	Root of the directory where you keep the ACE wrapper source tree.	/proj/ACE+TAO/x.3.1/sun54/ACE_wrappers	C:\ACE_wrappers
TAO_ROOT	Root of the directory where you keep the TAO source tree.	/proj/ACE+TAO/x.3.1/sun54/ACE_wrappers/TAO	C:\ACE_wrappers\TAO
JAVA_HOME	Directory where Java 1.4.1 is installed.	/proj/xda/j2sdk1.4.1_01	C:\j2sdk1.4.1_02
ANT_HOME	Directory where ANT 1.5 is installed.	/proj/xda/jakarta-ant-1.5.1	D:\jakarta-ant-1.5
JACORB_HOME	Directory where JacORB 1.4.1 is installed.	/proj/xda/JacORB_1_4_1	D:\JacORB_1_4_1

Installation instructions:

1. Create a root directory (that will serve as your $(XDA_ROOT). For an example Windows PC environment, one can use C:\vc70tao. For a typical Unix user, one can use /home/user/sun54tao. Note that the Java XDA release in included in both the Microsoft Visual Studio .NET 2003 and Sun Forte 7 (5.4) releases of XDA 4.1.
2. Set the above enivronment variables for your particular operating system.
3. When running on Windows XP, %XDA_ROOT%/XDA/bin must be in your PATH environment variable so that XDA components can locate the Xalan and Xerces dynamic linked libraries (DLLs) stored there. When running on UNIX, $XDA_ROOT/XDA/lib must be set in your LD_LIBRARY_PATH so that XDA components can locate the Xalan and Xerces dynamic libraries (.so's).
4. Copy $(XDA_ROOT)/share/bin/template.xdaorb.properties to $(XDA_ROOT)/share/bin/xdaorb.properties and modify as needed. The default settings are configured for Windows PC.
5. Use the Configuration Utility as specified in Setting up the configuration properties file or Setting up the configuration GTO. Note that the sample configuration file $(XDA_ROOT)/share/data/usr/xdausr_config_sample.gto contains representative entries for both the Unix and PC environments.
6. Decide whether you want to run Persistent or Transient XDA CORBA components. Refer to Runinng Transient XDA CORBA Components for more information about this setting.
7. If you have any legacy Task1 or Task2 tasks or jobs, they must be converted to Task3 tasks or jobs, respectively to work with XDA 4.1. Refer to Running the Convert Task Utility for instructions on using this tool.
8. New for XDA 4.1 A: If you are using the xdaorb.properties file and the configuration gto, please use the Properties Conversion tool as specified in Converting Properties Files. These instructions show how to simplify the configuration process.
9. To test your installation of XDA, run the Tutorial Examples listed below.

General instructions:
Using the Configuration Properties File.
Using the Configuration GTO.
Running Transient XDA CORBA Components
Running the Convert Task Utility
Running ACE+TAO
Running XDA (C++)
Running JacORB
Running XDA (Java)
TaskMaster QuickStart Guide

Tutorial examples:
Compiling the geom_ont.gto (C++)
No CORBA (C++)
XDAsimple (C++)
XDAsimple To XDAsimple (C++)
Compiling the geom_ont.gto (Java)
No CORBA (Java)
XDASimple (Java)
XDAsimple to XDAsimple (Java)
Java XDAsimple to C++ XDAsimple
C++ XDAsimple to Java XDAsimple
Database Simple
Database Dborb and Geomsrc