Installation Guide

This guide provides the necessary information for installing Aglets Workbench.

Step 1. System Requirements

Aglets WorkBench requires you to have installed either of

• JDK 1.1 or later
• JDK 1.0.2 + RMI preBeta2

If you don't have these software installed on your machine, please Download these packages. Aglets Workbench with JDK1.0.2+RMI preBeta2 is qualified for SPARC/Solaris2.5, Windows95/NT. Aglets Workbench with JDK1.1 is qualified for SPARC/Solaris2.5, x86/Solaris(1.1beta4), Windows95/NT, AIX4.1.4(1.1FCS-beta).

For those platforms which have neither of them, like OS/2 or MacOS, Aglets Workbench provides ManualSerialization for temporary solution. To use ManualSerialization on these platforms, please refer to this and follows description for each platform. Aglets Workbench with JDK1.0.2+ManualSerialization is qualified for SPARC/Solaris2.5, x86/Solaris2.5, Windows95/NT, AIX4.1.4 and OS2 Warp4.

Note: If your environment is "JDK1.02 + RMI prebeta2", please make sure that rmi.zip file is specified before classes.zip in CLASSPATH setting. 

Step 2: Setting Your Environment

Set up guide is available for

• Windows95/WindowsNT
• SPARC/Solaris, x86/Solaris, AIX
• OS/2
• MacOS (T.B.D)

Step 3: Please proceed to Getting Started

---

Environment Variables Setup Guide

• Windows95/WindowsNT

To run Aglets Workbench, you need to two environment variable (AGLET_HOME and PATH).

(a) AGLET_HOME

The AGLET_HOME variable must be set to "Aglets" directory of the directory where you installed Aglets Workbench. If you unpacked the AWB package on the ROOT directory of drive C:, then it would need to be set as follows:

Example: 
C:\> set AGLET_HOME=C:\AWB\Aglets

(b) PATH 

Your system PATH variable must include the AWB\Aglets\bin subdirectory of the AWB installation (i.e., AGLET_HOME%\Aglets%\bin) to run.

Example: 
C:\> set PATH=%AGLET_HOME%\bin;%PATH% 


To develop an aglet program, you need further configuration. You need three additional environment variable (CLASSPATH, AGLET_PATH, AGLET_EXPORT_PATH) to compile your program and run it.

(c) CLASSPATH

The CLASSPATH variable must include the 'lib' directory where the Aglets library was installed.

Example: 
C:\> set CLASSPATH=%AGLET_HOME%\lib;%CLASSPATH%

(d) AGLET_PATH

AGLET_PATH is the default look up path for creating the 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:\aglets\public, you could set it to this as follows.

Example: 
C:\> set AGLET_PATH=C:\aglets\public

(e) AGLET_EXPORT_PATH

The AGLET_EXPORT_PATH is for files which can be fetched from remote site. In most case, this can be same as AGLET_PATH.

Example: 
C:> set AGLET_EXPORT_PATH=%AGLET_PATH% 


Note: If you are using Windows NT, you can make the changes above in the Control Panel. Start the Control Panel, select System icon, then edit the environment variables and apply.

---

• SPARC/Solaris, x86/Solaris, AIX
  
  To run Aglets Workbench, you need to two environment variable (AGLET_HOME and PATH). 
  
  

  (a) AGLET_HOME

  The AGLET_HOME variable must be set to "Aglets" directory of the directory where you installed Aglets Workbench. If you unpacked the AWB package on the your $HOME directory, then it would need to be set as follows
  
  Example:(csh) 
  % setenv AGLET_HOME=$HOME/AWB/Aglets
  Example:(ksh) 
  % export AGLET_HOME=$HOME/AWB/Aglets

  (b) PATH

  Your system PATH variable must include the AWB\Aglets\bin subdirectory of the AWB 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
  
  
  To develop an aglet program, you need further configuration. You need three additional environment variable (CLASSPATH, AGLET_PATH, AGLET_EXPORT_PATH) to compile you program and run it.

  (c) CLASSPATH

  The CLASSPATH variable must include the 'lib' directory where the Aglets library was installed.
  
  Example: 
  C:\> set CLASSPATH=%AGLET_HOME%\lib;%CLASSPATH%

  (d) AGLET_PATH

  AGLET_PATH is the default look up path for creating the 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:\aglets\public, you could set it to this as follows.
  
  Example: 
  C:\> set AGLET_PATH=<the directory where your aglets resides on>

  (e) AGLET_EXPORT_PATH

  The AGLET_EXPORT_PATH is for files which can be fetched from remote site. In most case, this can be same as AGLET_PATH.
  
  Example: 
  C:> set AGLET_EXPORT_PATH=%AGLET_PATH%
  
  

  ---

• OS/2
  
  To run Aglets Workbench, you need to two environment variable (AGLET_HOME and PATH).

  (a) AGLET_HOME

  The AGLET_HOME variable must be set to "Aglets" directory of the directory where you installed Aglets Workbench. If you unpacked the AWB package on the ROOT directory of drive C:, then it would need to be set as follows
  
  Example: 
  C:\> set AGLET_HOME=C:\AWB\Aglets

  (b)PATH

  Your system PATH variable must include the AWB\Aglets\bin subdirectory of the AWB installation (i.e., %AGLET_HOME%\Aglets%\bin) to run
  
  Example: 
  C:\> set PATH=%AGLET_HOME%\bin;%PATH% 
  
  
  To develop an aglet program, you need further configuration. You need three additional environment variable (CLASSPATH, AGLET_PATH, AGLET_EXPORT_PATH) to compile you program and run it.

  (c) CLASSPATH

  The CLASSPATH variable must include the 'lib' directory where the Aglets library was installed.
  
  Example: 
  C:\> set CLASSPATH=%AGLET_HOME%\lib;%CLASSPATH%

  (d) AGLET_PATH

  AGLET_PATH is the default look up path for creating the 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:\aglets\public, you could set it to this as follows.
  
  Example: 
  C:\> set AGLET_PATH=<the directory where your aglets resides on>

  (e) AGLET_EXPORT_PATH

  The AGLET_EXPORT_PATH is for files which can be fetched from remote site. In most case, this can be same as AGLET_PATH.
  
  Example: 
  C:> set AGLET_EXPORT_PATH=%AGLET_PATH%
  
  

  ---

• MacOS
  
  T.B.D.

---

Download JDK and related software

AgletsWorkbench requires JDK(Java Development Kit)1.1 iinstalled on your machine or JDK1.0.2 and RMI package installed on your mahcine. If you have neither of these packages, please download and install these packages by following the corresponding links in the following table. Make sure that these packages are installed properly by running the supplied demos and examples.

Download side for JDK1.1 (or later) package

Platform	JDK1.1 Package
Windows 95/NT SPARC/Solaris x86/Solaris	JDK 1.1 or later
AIX	JDK 1.1
OS/2	N.A.
Macintosh	N.A.

Download site for JDK1.0.2 and RMI prebeta2

Platform	JDK1.0.2 package	RMI prebata2 package
Windows 95/NT	JDK 1.0.2	RMI prebeta2
SPARC/Solaris	JDK 1.0.2	RMI prebeta2
x86/Solaris (ManualSerialization)	JDK 1.0.2	rmi.zip file in RMIprebeta2 is required to use ManualSerialization. Please download RMIprebeta2 for x86/Solaris and follow this instruction.
AIX (ManualSerialization)	JDK 1.0.2	rmi.zip file in RMIprebeta2 is required to use ManualSerialization. Please download RMIprebeta2 for x86/Solaris and follow this instruction.
OS/2 (Manual Serialization)	JDK 1.0.2	rmi.zip file in RMIprebeta2 is required to use ManualSerialization. Please download RMIprebeta2 for Windows and follow this instruction.
MacOS (Manual Serialization)	MRJ1.0 (or later)	rmi.zip file in RMIprebeta2 is required to use ManualSerialization. Please download RMIprebeta2 for Windows and follow this instruction.

---

Set up guide for ManualSerialization.

Assuming that you've downloaded the correct RMI package. Please unpack RMIpreBeta2 package. There should exists %RMI_HOME%\lib\rmi.zip (Win95/NT) or $RMI_HOMR/lib/rmi.zip file(Unix). Then, you need to modify CLASSPATH environment variable like:
Example:OS/2 

set CLASSPATH=%RMI_HOME%\lib\rmi.zip;%CLASSPATH%

Example:Unix(csh) 

setenv CLASSPATH $RMI_HOME/lib/rmi.zip:$CLASSPATH

Example:Unix(ksh) 

export CLASSPATH=$RMI_HOME/lib/rmi.zip:$CLASSPATH