README ObjectSpace Voyager Version 3.1 ====================================================================== CONTENTS ====================================================================== Overview of Voyager Welcome To Voyager! Compatibility System Requirements Changes from Previous Versions Contents of the Distribution Packaging of the Distribution Support Contacting ObjectSpace Reporting Defects and Suggestions ====================================================================== OVERVIEW OF VOYAGER ====================================================================== Welcome to Voyager! ------------------- ObjectSpace Voyager is the ObjectSpace product line designed to help developers produce high-impact distributed systems quickly. Voyager is 100% Java and is designed to use the Java language object model. Voyager allows you to use regular message syntax to construct remote objects, send them messages, and move them between programs. This reduces learning curves, minimizes maintenance, and, most importantly, speeds your time to market for new advanced systems. Voyager’s architecture is designed to provide developers full flexibility and powerful expansion paths. COMPATIBILITY ---------------------------------------------------------------------- Previous Versions ----------------- Voyager 3.1 is not backward compatible with previous versions at runtime, but is backward compatible with the 3.0 API. It will be necessary to recompile your application for Voyager 3.1. If you are using pgen or cgen, it is also necessary to regenerate any code created with these utilities. JDKs ---- Voyager 3.1 is fully compatible with JDK 1.1 and JDK 1.2. A Voyager application can be deployed in a mixed-mode environment. Browsers -------- Applet support is currently limited to browsers which support JDK 1.1; however, it is possible to run a Voyager 3.1 server on a JDK 1.2 system and have browsers accessing it. Note that Voyager Transactions does not support applet environments at this time. Platforms --------- Voyager 3.1 has been tested with and is compatible with Windows NT, and with Solaris 2.6 (Sparc) and Solaris 7 (Sparc). Voyager 3.1 should be compatible with any compliant JDK 1.1 or JDK 1.2 environment, however. SYSTEM REQUIREMENTS ---------------------------------------------------------------------- Voyager 3.1 requires JDK 1.1 or JDK 1.2 to be installed for development, and a JRE 1.1 or JRE 1.2 compatible runtime environment. Additional packages required by Voyager that do not ship with the base JDK installation can be found in the lib/ directory under the installation root. These packages must be added to the CLASSPATH after installation. If you require RMI services, you must use a JVM and environment which support RMI. Dynamic XML requires the IBM XML parser, XML4J. This product may be downloaded free from the IBM website at http://www.alphaworks.ibm.com/tech/xml4j. Voyager's COM/DCOM support requires the classes in the com.ms.com package, which is distributed with the Microsoft SDK for Java 3.2. LDAP support requires an LDAP implementation jar file. See the JNDI web site (http://java.sun.com/products/jndi/) for further information. CHANGES FROM PREVIOUS VERSIONS ---------------------------------------------------------------------- For a detailed list of changes please see the changes.html document. CONTENTS OF THE DISTRIBUTION ---------------------------------------------------------------------- This distribution contains .jar files, documentation, API references, tools, and examples for one or more of the following products: Voyager 3.1 ORB --------------- The Voyager ORB provides a powerful, intuitive tool for creating high-impact distributed applications quickly. Voyager is 100% Java and is designed to use the Java language object model. Voyager allows you to use regular message syntax to construct remote objects, send them messages, and move them between programs. This reduces learning curves, minimizes maintenance, and, most importantly, speeds your time to market for new advanced systems. Voyager’s architecture is designed to provide developers full flexibility and powerful expansion paths. This product contains the core features and architecture of the platform, including a full-featured, intuitive ORB with support for mobile objects and autonomous agents. ObjectSpace Voyager technology is everything you need to get started building high-impact distributed systems in Java today. The Voyager Management Console utility, provided with Voyager ORB Professional, provides the Voyager server administrator with a powerful tool for managing Voyager servers and the services they provide. Using VMC, administrators can configure Voyager servers and manage running Voyager servers. Server profiles are stored in a central Voyager Directory Server, and the Voyager Management Console provides a graphical way to administer the directory and to monitor and configure Voyager servers and services. Voyager add-on services such as Voyager Transactions, Voyager Security, and Voyager Application Server, are managed through VMC. You can also create your own services and management screens by extending the same frameworks upon which Voyager's add-ons are built. Additional utilities packaged with the Voyager ORB product include: igen Create interface files for classes cgen Converts between Java and IDL pgen Create proxy classes at compile time (ORB Professional) voyager A commandline tool to start a Voyager server console The Voyager Management Console (ORB Professional) xgen Generates Java interfaces used by Dynamic XML There are many new features available with Voyager 3.1 ORB. For a brief list, see the changes.html document. For complete details, please refer to the developer documentation and API references. Following are the products that can be purchased in conjunction with Voyager ORB Professional. Voyager Security ---------------- The Voyager Security product provides a powerful framework for security services, including authentication and authorization; data privacy and integrity; and secure communications. This open framework lets you design custom implementations providing the level of security you need for your application. Voyager Security also provides an implementation of this framework suitable for applications requiring basic security services. Voyager Security also provides implementations of the SOCKS 4, SOCKS 5, and HTTP tunneling protocols to provide secure communications across the Internet. Voyager Transactions -------------------- The Voyager Transactions product provides transparent distributed transaction support for your application. Voyager Transactions supports the ACID model (Atomicity, Consistency, Isolation, Durability). It is also OTS compliant (note that it requires OTS clients to support synchronization). Voyager Transactions uses the standard two-phase commit model. Voyager Application Server -------------------------- The Voyager Application Server is a complete implementation of the Enterprise JavaBeans server component model. EJB is an architecture for writing distributed, transactional, secure, component-based server applications in Java. In addition to the management tools provided by Voyager ORB Professional, VAS adds development tools to automate creation and packaging of EJB components. VAS can support Voyager, CORBA, or RMI clients for maximum architectural flexibility. PACKAGING OF THE DISTRIBUTION ---------------------------------------------------------------------- Following is a brief summary of how the Voyager product family is packaged. More detailed information about each directory follows. voyager/ Base installation directory voyager/lib .jar files voyager/examples Example source code voyager/idl CORBA idl files voyager/bin Utilities voyager/doc Documentation and API references voyager/voyagerdb Simple persistent store for use with Activation voyager/ -------- The installation root contains the following files: README.TXT This document INSTALL.TXT Installation instructions COPYRIGHT.TXT Copyright information LICENSE.TXT License information index.html Documentation root RELNOTES.TXT Last-minute release notes environment.txt Information for setting your environment voyager/lib/ ------------ This directory contains Voyager class files and third-party classes. These .jar files should be added to your CLASSPATH after installation on an as-needed basis. You will need one of lightjndiclient.jar, lightclient.jar, or voyager.jar. If you are using lightjndiclient.jar, you will also need jndi.jar. If you are using voyager.jar, the third- party .jar's you need will depend on what features you use. The following .jar files are provided: voyager.jar Voyager ORB Professional lightjndiclient.jar JNDI-client classes lightclient.jar "Light Client" classes swingall.jar JFC (SwingSet) 1.1 classes jndi.jar JNDI 1.1.1 classes security.jar Voyager Security transaction.jar Voyager Transactions jdbc-ext.jar JDBC 2.0 Extension classes jta.jar JTA 0.9 classes vas.jar Voyager Application Server ejb.jar Sun EJB 1.0 classes com-classes.jar Support for COM (required only on non-Microsoft VMs) com-serializers.jar Support for COM (required on all VMs) voyager/examples/ ----------------- The examples directory contains all examples in various subdirectories. (Note that a subdirectory may have several examples.) If you intend to run the examples you should put the installation root (e.g. c:\voyager) in your CLASSPATH. voyager/idl/ ------------ This directory contains CORBA .idl files for CORBA support. voyager/bin/ ------------ This directory contains Voyager utilities. You should add this directory to your PATH after installation. The following utilities are provided: voyager Voyager server launcher igen Interface file generator cgen Convert between Java and IDL pgen Proxy class file generator console Startup program for Voyager Management Console ejbstudio Startup program for EJB Studio application xgen Generates Java interfaces used by Dynamic XML aclinst ACL installation utility VoyagerBridge* COM component interface to Universal Directory voyager/doc/ ------------ The documentation directory contains the API references and developer guides for each of the products provided in this distribution. voyager/voyagerdb/ ------------------ This directory contains VoyagerDb, a simple persistent store integrated with Activation. ====================================================================== SUPPORT ====================================================================== Please refer to your license agreement for information regarding support of Voyager 3.1. ---------------------------------------------------------------------- CONTACTING OBJECTSPACE ---------------------------------------------------------------------- For additional information on ObjectSpace technology and services, contact our North American headquarters. ObjectSpace, Inc. 14850 Quorum Drive, Suite 500 Dallas, Texas 75240 Phone: 972.726.4100 or 1.800.OBJECT.1 Fax: 972.715.9099 E-Mail: info@objectspace.com Web Site: http://www.objectspace.com ---------------------------------------------------------------------- REPORTING ISSUES TO SUPPORT ---------------------------------------------------------------------- ObjectSpace support may be contacted in the following ways: Email: vsupport@objectspace.com (preferred) Phone: 972-726-4500 Fax : 972-726-4200 When submitting an incident, please provide the following information: Support ID Voyager version as given by the output of 'voyager -v' Platform/OS and development environment A complete description of the issue Any exceptions or stack traces (set VERBOSE or EXCEPTION logging) Please note we can provide only limited support to non-paying customers. If you have purchased support for Voyager, please provide your support ID. ---------------------------------------------------------------------- Copyright (c) 1997-1999 ObjectSpace, Inc.