Description
Note:This Manual is only for Tahiti of ASDK V1.0.
Tahiti is an application program that runs as an agent server.
You can run multiple servers (Tahiti) on a single computer by assigning
them different port numbers. Tahiti provides a user interface for
monitoring, creating, dispatching, and disposing of agents and for setting
the agent access privileges for the agent server.
How to run Tahiti
- Run the first Tahiti
Create a command prompt window and start the daemon by executing
a script in the aglets package:
agletsd
or
agletsd -port 9000 (on Unix platform)
This daemon will listen for agents on the default port 434 - a port
reserved for mobile agents or port 9000 (on Unix). It also makes Tahiti
appear on your screen. Tahiti is a desktop interface to manage
running agents. The first time you run Tahiti it will ask you
to register - please do so to continue.
- Run multiple Tahitis on a single server
Create a command prompt window and start the daemon in the atp package:
agletsd
or
agletsd -port 9000 (on Unix platform)
This daemon will listen for agents on the default port 434 -
a port reserved for mobile agents.
Create another command prompt window and start another daemon here:
agletsd -port 500
or
agletsd -port 10000 (on Unix platform)
This daemon will listen for agents on another port - in this case
port 500 or port 10000(on Unix). You can actually
choose any port that is currently not occupied by some other application
and its operating system. The daemon also makes Tahiti appear
on your screen. Tahiti is a desktop interface for managing
running agents. The first time you run Tahiti it will ask you
to register - please do so to continue.
Option settings
There are four setting options in Tahiti.
- General Preference
Font: Defines the size of the font in Tahiti. Whether
the change of the setting becomes effective immediately or on the next
Tahiti invocation depends on the version of Java you are running.
Startup: You can specify an aglet that automatically starts
up when Tahiti is started. (The Launch Startup Aglet check box
enables this function.)
Cache Control: Clearing up the class cache.
User Information: Registered user information. You can check
and modify your name and organization, which are registered in Tahiti
and referred to by aglets as the properties of the AgletContext.
- Network Preference
Http Proxy: In case you are protected by a firewall, you can
specify a http proxy server to access the information at the outside
of the firewall.
Subscription: - Sorry. This is under construction. -
- Security Preference
As a security option, you can specify the access control details
for each aglet security category (trusted and untrusted
are defined as security categories, now) on the resouce categories
(FileSystem, Network, Property, and Ohters).
- A trusted aglet is an agent that is created on a server
by using the "Create Aglet" panel as a local aglet. A
trusted aglet has the privilege of creating another trusted aglet
on the same aglet server.
- An untrusted aglet is one that comes from an external server
or that is generated as an instance of an aglet class located at
a remote site. In general, the access control setting is specified
more strictly for an untrusted aglet than for a trusted one.
File Access Control: The file access path is specified as
a list of a single or multiple directory path(s).
Network Access Control: Specified <port number>s are
kept in the Listen list box. Aglets in the current aglet security
category is enabeled to listen to these ports. Specified <hostname:port
number>s are kept in the Connect list box. Aglets in the
current aglet security category is enabeled to connect to these ports.
Properties: T.B.D.
Others: Warning Message, Open Window, JDBC, RMI Client, and RMI
Server access can be specified on this panel.
Handling Agents
All the agents are displayed in the list box in Tahiti. By
selecting one of the list items, you can control the corresponding agent
(by dispatching it, deleting it, requesting a dialog with it, etc.).
- Create: Creates a new aglet. A dialog window for the aglet's
URL specification will appear. (Detailed information on creating an
aglet is here )
- Dialog: Sends a request to an aglet to open its dialog panel.
(When this button is clicked, an onDialog() message is sent to the aglet.)
- Properties: Shows the properties of the agent.
- Dispose: Destroys the agent.
- Clone: Make a copy of the agent.
- Dispatch: Sends the agent to another server. You can specify
whether to keep the original agent on the current server or not. The
protocol for the destination URL is Agent Transfer Protocol. Please
specify it as in the following example:
atp://aglets.trl.ibm.com:434
- Retract: Retracts a dispatched agent from a remote server.
Menu Items
Tahiti provides you the functions for handling agents and for controlling
the server. Please try these menu items.
Troubleshooting
Most of the troubles on initial setting of Tahiti are related to the
setting of its environment variables.
- If you are using Windows95 or WindowsNT, check whether you have properly
set the CLASSPATH and other environment variables.
- Check that your machine successfully converts the host-name into an
Internet address. (You can use the ping command for this test.)
|
Tahiti user's guide