JRun SDK Guide
Introduction to the SDK

SDK file group

The SDK consists of prebuilt filesets, which are installed under the sdk_root directory. The following table briefly describes these top-level directories:

Directory	Description
filesets	Contains the core components of JRun and localization files. For more information on the contents of the sdk_root/filesets directory, see "JRun components".
src	Contains source code for some components of JRun, including the JMC and web server connectors. For more information on the contents of the sdk_root/src directory, see "JRun source code".
docs	Contains documentation specific to the SDK. For more information on the contents of the sdk_root/docs directory, see "SDK documentation".
installers	Contains merge modules and BIN files for use in installer development environments, and the Windows Installer wrapper. For more information on the contents of the sdk_root/installers directory, see "JRun installers".

The following sections describe the contents of these top-level directories in the SDK.

Core components

The sdk_root/filesets/all directory contains the non-platform-specific filesets for JRun, organized by functional component. You use these filesets if you are preparing a custom JRun installation in a non-Windows Installer environment. For more information on creating custom installers, see "Building a customized version of JRun".

The following table describes the files in the sdk_root/filesets/all directory of the SDK:

Subdirectory	Description
core	Includes the basic files to run JRun and serve J2EE applications. Also includes the migration tool, XMLScript, and the JSPC compiler.
default-server	Includes all files used by the default JRun server, including the default application.
flashgateway	Contains the files necessary to run the Macromedia Flash Remoting service that is installed in the retail version of JRun by default.
jmc	Includes the files used by the JMC applications. The JMC provides access to JRun settings through a web-based GUI. In the retail version, JRun hotdeploys this component as an EAR file. The source code of the JMC is also included in the sdk_root/src fileset.
jrunwizard	Includes the JRun EJB Deployment Wizard stand-alone tool and the tool's GUI installer.
macromedia_drivers	Includes the JRun JDBC drivers.
webservices	Includes all files used to implement Web Services on JRun.
xdoclet	Contains files for using the XDoclet XML generation tool with JRun.

JRun components

The sdk_root/filesets directory contains filesets for all JRun components. It also contains subdirectories for each supported platform with a binary code base for each of the following JRun tools:

• JRun EJB Deployment Wizard
• Web Services
• Web Server Configuration tool

The subdirectories contain the compiled classes and resource files, separated into functional groups. The directories take the following form:

{os_or_language}/{module_name}/{jrun_dirs}

The sdk_root/filesets directory also contains a build.xml file which lets you create a custom JRun installation using different combinations of modules, OS-specific files, and language-specific files. You must have Ant to use the build.xml file. For more information on building a custom version of JRun using the build.xml file, see "Building a customized version of JRun".

The following table describes the files in the sdk_root/filesets directory of the SDK:

Subdirectory	Description
all	Contains the non-platform-specific filesets for JRun, organized by functional component. For more information on the contents of the subdirectories of the sdk_root/filesets/all directory, see "Core components".
alpha-osf1	Contains binaries for the Alpha flavor of UNIX.
english	Contains localization files for the English language.
french	Contains localization files for the French language.
intel-linux	Contains binaries for the Linux platform.
intel-win	Contains binaries for the Windows platform.
japanese	Contains localization files for the Japanese language.
pa_risc-hpux	Contains binaries for the HPUX flavor of UNIX.
ppc-aix	Contains binaries for the AIX flavor of UNIX.
sparc-solaris	Contains binaries for the Sun Sparc flavor of UNIX.

JRun source code

The JRun SDK includes source code for a subset of JRun tools. This gives you the most granular level of control over the JRun components. The source code is in the sdk_root/src directory in the SDK.

The following table describes the files in the sdk_root/src directory of the SDK:

Subdirectory	Description
C	Contains the source code for the following JRun components: Launcher Windows services JAAS Windows login module
Connectors	Contains the source code for web server connectors for the following web servers: Apache IIS (including metabase tools for configuration) Netscape Also contains source code for the OpenSSL toolkit.
JMC	Contains the source code for the JRun Management Console (JMC) application.

Working with the JRun tools' source code is beyond the scope of this book. However, some information on working with the JMC source code is included in "Rebranding the JMC".

JRun installers

The SDK includes files for OEMs to build custom JRun installers in the sdk_root/installers directory. For general information about the JRun installer creation tools, see Chapter 2, "JRun Installer Overview".

The following table describes the subdirectories in the sdk_root/installers directory of the SDK:

Subdirectory	Description
windows	Contains the Windows Installer merge modules for building installers in the Windows Installer development environments. Also contains the Windows merge modules that closely correspond to the JRun components described in "Core components". The merge modules can be used with any Windows Installer-aware application. For more information about creating a Windows JRun installer, see Chapter 3, "Windows JRun Installers".
all	Contains the BIN files that you can use as part of your installer project. These BIN files closely correspond to the JRun components described in "Core components". For more information about creating a UNIX JRun installer, see Chapter 4, "Platform-Independent JRun Installers".

SDK documentation

The docs directory contains this SDK Guide and JRun API Javadocs for the jrunx.jmc packages. The Javadocs for these packages are not included in the retail installation of JRun.

Release notes containing last-minute updates to the documentation, known issues, and workarounds for issues are in the sdk_root directory.

RSS feed | Send me an e-mail when comments are added to this page | Comment Report

Current page: http://livedocs.adobe.com/jrun/4/JRun_SDK_Guide/about4.htm

Add Comment