Aglets Software Development Kit

ASDK Home 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 JDK 1.1.x

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. (At this moment, Aglets does not run on Java2(JDK1.2) environment.)

Step 2: Configure server properties

To specify server properties, please create a file which is read by aglets server launcher. A sample file("sample_aglets.props") is included in the distribution package. In that file, you are required to specify "aglets.home". You can leave other properties unspecified because they have a default value.

Example: contents of the file "my_aglets.props"

(A backslash "\" must be replaced with two backslashes "\\" in the property file.)

Please see Server Properties Guide or the sample file "sample_aglets.props" to get information about other server properties.

Step 3: Start server

There is a startup script("agletsd") in the distribution package. Prior to running the script, please set "JDK_HOME" to your JDK's directory, and set "AGLET_HOME" to your ASDK installation directory.

Example:

You can get help message by specifing "-help" to the argument. For example,

Note: You may insert environment variable settings in the agletsd batch file, or shell scrip file. Note: If your experience any problem, please try without JIT. You can disable JIT compiler by setting JAVA_COMPILER environment avariable to NONE. 
C:> set JAVA_COMPILER=NONE

Step 3: Please proceed to Getting Started

ASDK Home Server Properties Guide

Note: In the property file, backslash(\\) character itself must be specified as "\\"

aglets.home (mandatory)

A path under where ASDK is installed.

Example:

user.home (optional)

User's home directory under where ".aglets" directory is created.

default: $HOME (unix), %HOME% (win32)

java.policy

File path of "aglets.policy" file.

default: (user.home)/.aglets/security/aglets.policy

maf.protocol

Protocol used by the server.

default: atp
choices: atp, rmi

maf.port

Port number used by aglets server.

default: 4434

maf.finder.host

Host name at where Finder resides. If it was not specified or it was null string, the server will not cooperate with Finder.

default: (null)

maf.finder.port

Port number of Finder.

default: 4435

maf.finder.name

Registry name of the Finder.

default: MAFFinder

verbose

To get verbose outputs, please set true.

default: false
choices: true, false

aglets.class.path

Default look-up path list for creating an aglet with no codebase. This is used when the null value is passed to createAglet() on the AgletContext class as an codebase argument.

default: (aglets.home)/public
choices: any path list separated by ';'(windows, os/2), or ':' (unix)

aglets.public.root

A directory which are exported to other aglets servers. Only the class files under this directory can be fetched from other servers. (This is formally known as AGLET_EXPORT_PATH)

default: (aglets.home)/public
choices: any directory path

aglets.public.aliases

Comma(,) spearated list of aliases used for codebase of aglets. Aliases must begin with tilda(~). For example, if this property is set as the following, 
aglets.public.aliases=~tai=/home/tai/public_aglets
Class files of an aglet whose codebase is atp://myhost/~tai will be fetched from under the directory /home/tai/public_aglets/

aglets.secure

If this property is set to false, every activity of aglets in the server is allowed.

default: true
choices: true, false

aglets.viewer

Class name of the context viewer which is a subclass of AgletContextListener. To run the server with no UI, please set null string.

default: com.ibm.aglets.tahiti.Tahiti
choices:

aglets.startup

Comma(,) separated list of URLs(or class names) of aglets which should be created just after the server starts.

aglets.resolve

If this is set to true, the server tries to resolve the domain name of the host by querying DNS server.

default: false

aglets.domain

TCP/IP domain name of the host.

aglets.offline

If this is set to true, the server's hostname should be "localhost". This will be useful if the host does not have any network adapter.

default: false

aglets.authentication

If this is set to true, the aglet server will authenticate whether the contacting aglet server belongs to a certain security domain. The aglet server will send aglets only to the authenticated servers. In the default case(without authentication), the aglet server will trust any other aglet servers. See the subsection "Domain Authentication" in aglets specification for more detail.

default: false

aglets.secureseed

If this is set to true, the aglet server uses the one provided by JDK(java.security.SecureRandom) for the pseudo random seed generation. The pseudo random seed is used for server authentication, integrity check, and login password generation. In case of JDK's pseudo random seed generation does not work well, for example, it is too slow, you can use the one which is provided with ASDK by setting false to this property. But it is unsecure to use ASDK's one.

default: true

ASDK Home Download site for JDK 1.1.x package