Installation Guide

This guide provides the necessary information for installing the Aglets Software Development Kit.

Step 1. System Requirements

The Aglets Software Development Kit requires you to have installed
o

JDK 1.1 or later

If you don't have this software installed on your machine, please download these packages. Aglets Software Development Kit with JDK 1.1 is available for SPARC/Solaris 2.5, x86/Solaris, Windows 95/NT, AIX 4.1.4, and *OS/2 Warp 4.

Step 2: Setting Your Environment

If you do not use the installation program, set-up guides are available for
o o o o

Windows 95/Windows NT SPARC/Solaris, x86/Solaris, AIX OS/2 Mac OS (T.B.D)

Please note that you need further configuration to develop an aglet program.

Step 3: Please proceed to Getting Started

Environment Variables Setup Guide

Windows 95/Windows NT
Environments for Aglets Server To run the Aglets Software Development Kit, you need to set two environment variables (AGLET_HOME and PATH). (a) AGLET_HOME The AGLET_HOME variable must be set to the "Aglets1.0.3" directory of the directory in which you installed the Aglets Software Development Kit(ASDK). If you unpacked the ASDK package in the ROOT directory of drive C:, then it would need to be set as follows:

Example: C:\> set AGLET_HOME=C:\Aglets1.0.3 (b) PATH Your system PATH variable must include the \Aglets1.0.3\bin subdirectory of the ASDK installation (i.e., AGLET_HOME%\Aglets1.0.3%\bin) to run. Example: C:\> set PATH=%AGLET_HOME%\bin;%PATH%

(c) HOME The HOME variable must be specified to an existing directory. Under the directory, agletsd will make a sub-directry ".aglets". Example: C:\> set HOME=c:\

Environments for Developping Aglets To develop an aglet program, you need further configuration. To compile your program and run it, three additional environment variables (CLASSPATH, AGLET_PATH, and AGLET_EXPORT_PATH) to compile your program and run it. (d) CLASSPATH The CLASSPATH variable must include the 'lib' directory in which the Aglets library was installed. Example: C:\> set CLASSPATH=%AGLET_HOME%\lib\aglets.jar;%CLASSPAT H% (e) AGLET_PATH AGLET_PATH is the default look-up path for creating an aglet with no codebase. This is used when the null value is passed to createAglet API on the AgletContext class as an codebase argument. For example, If you're going to place your aglet classes at C:\ASDK\public, you could do so as follows:

Example: C:\> set AGLET_PATH=C:\ASDK\public (f) AGLET_EXPORT_PATH The AGLET_EXPORT_PATH is for files that can be fetched from remote sites. In most cases, it can be the same as AGLET_PATH. Example: C:> set AGLET_EXPORT_PATH=%AGLET_PATH% Note: If you are using Windows NT, you can make the above changes in the Control Panel. Start the Control Panel, select System icon, then edit the environment variables and apply.

SPARC/Solaris, x86/Solaris, AIX

Environments for Aglets Server To run the Aglets Software Development Kit, you need to three environment variables (AGLET_HOME and PATH). (a) AGLET_HOME The AGLET_HOME variable must be set to the "Aglets1.0.3" directory of the directory in which you installed the Aglets Software Development Kit. If you unpacked the ASDK package in your $HOME directory, then it would need to be set as follows: Example:(csh) % setenv AGLET_HOME=$HOME/Aglets1.0.3 Example:(ksh) % export AGLET_HOME=$HOME/Aglets1.0.3 (b) PATH Your system PATH variable must include the Aglets1.0.3\bin subdirectory of the ASDK installation (i.e., %AGLET_HOME%\Aglets%\bin) to run Example: (csh) % set path = ( $path $AGLET_HOME/bin ) Example: (ksh)

% export PATH=$PATH:$AGLET_HOME/bin Environments for Developping Aglets To develop an aglet program, you need further configuration. To compile your program and run it, you need three additional environment variables (CLASSPATH, AGLET_PATH, and AGLET_EXPORT_PATH) to compile you program and run it. (c) CLASSPATH The CLASSPATH variable must include the 'lib' directory in which the Aglets library was installed. Example:(csh) % setenv CLASSPATH=$AGLET_HOME/lib/aglets.jar:$CLASSPATH Example:(ksh) % export CLASSPATH=$AGLET_HOME/lib/aglets.jar:$CLASSPATH (d) AGLET_PATH AGLET_PATH is the default look-up path for creating an aglet with no codebase. This is used when the null value is passed to createAglet API on the AgletContext class as an codebase argument. For example, If you're going to place your aglet classes somewhere, you could set AGLET_PATH as follows. Example:(csh) % setenv AGLET_PATH=<the directory in which your aglets resides> Example:(ksh) % export AGLET_PATH=<the directory in which your aglets resides> (e) AGLET_EXPORT_PATH The AGLET_EXPORT_PATH is for files that can be fetched from remote sites. In most cases, it can be the same as AGLET_PATH. Example:(csh) % setenv AGLET_EXPORT_PATH=$AGLET_PATH Example:(ksh) % export AGLET_EXPORT_PATH=$AGLET_PATH

OS/2
Environments for Aglets Server To run the Aglets Software Development Kit, you need to set two environment variables (AGLET_HOME and PATH). (a) AGLET_HOME The AGLET_HOME variable must be set to the "Aglets1.0.3" directory of the directory in which you installed the Aglets Software Development Kit(ASDK). If you unpacked the ASDK package in the ROOT directory of drive C:, then it would need to be set as follows: Example: C:\> set AGLET_HOME=C:\Aglets1.0.3 (b) PATH Your system PATH variable must include the \Aglets1.0.3\bin subdirectory of the ASDK installation (i.e., AGLET_HOME%\Aglets1.0.3%\bin) to run. Example: C:\> set PATH=%AGLET_HOME%\bin;%PATH%

(c) HOME The HOME variable must be specified to an existing directory. Under the directory, agletsd will make a sub-directry ".aglets". Example: C:\> set HOME=c:\

Environments for Developping Aglets To develop an aglet program, you need further configuration. To compile your program and run it, three additional environment variables (CLASSPATH, AGLET_PATH, and AGLET_EXPORT_PATH) to compile your program and run it. (d) CLASSPATH The CLASSPATH variable must include the 'lib' directory in which the Aglets library was installed.

Example: C:\> set CLASSPATH=%AGLET_HOME%\lib\aglets.jar;%CLASSPAT H% (e) AGLET_PATH AGLET_PATH is the default look-up path for creating an aglet with no codebase. This is used when the null value is passed to createAglet API on the AgletContext class as an codebase argument. For example, If you're going to place your aglet classes at C:\ASDK\public, you could do so as follows: Example: C:\> set AGLET_PATH=C:\ASDK\public (f) AGLET_EXPORT_PATH The AGLET_EXPORT_PATH is for files that can be fetched from remote sites. In most cases, it can be the same as AGLET_PATH. Example: C:> set AGLET_EXPORT_PATH=%AGLET_PATH% Note: If you are using Windows NT, you can make the above changes in the Control Panel. Start the Control Panel, select System icon, then edit the environment variables and apply. Note: If your experience any problem, please try without JIT. You can disable JIT compiler by setting JAVA_COMPILER environment avariable to xxx .
C:> set JAVA_COMPILER=xxx

MacOS
T.B.D.

Download JDK and related software

The Aglets Software Development Kit requires JDK (Java Development Kit) 1.1 to have been installed on your machine. If you do not have the package, please download and install it by following one of the links in the following table. Make sure that these packages are installed properly by running the supplied demos and examples.

Download side for JDK 1.1 (or later) package Platform Windows 95/NT SPARC/Solaris x86/Solaris AIX OS/2 Macintosh JDK 1.1 Package JDK 1.1 or later JDK 1.1 JDK 1.1 N.A.