How to run Tahiti

• Note

  In this document $(ASDK) indicates the directory path under where you installed ASDK, and $(JDK) indicates the directory path under where you installed JDK.

  For example, $(ASDK) might be

  • C:\Aglets1.1b1 (Win95, 98, NT, OS/2)
  • $HOME/Aglets1.1b1 (Unix)
  and $(JDK) might be,
  • C:\JDK1.1.7B (Win95, 98, NT, OS/2)
  • /usr/local/JDK1.1.7B (Unix)
  
  
• Setting up environment variables

  To use startup script(batch file or shell script), you need to set up two environment variables, AGLET_HOME and JDK_HOME.

  The startup script file can be found at the directory named bin under where you installed ASDK. The name of the startup script file is,
  • $(ASDK)\bin\agletsd.bat(Win95, 98, NT)
  • $(ASDK)\bin\agletsd.cmd(OS/2)
  • $(ASDK)/bin/agletsd(Unix)

  There may be two ways to set environment variables for ASDK. One is to insert the following two lines at the beginning of the script file. For example,

  • Windows(95, 98, NT), OS/2

    set JDK_HOME=$(JDK)
    set AGLET_HOME=$(ASDK)
    

  • Unix(sh, ksh, bash)

    JDK_HOME=$(JDK)
    AGLET_HOME=$(ASDK)
    export JDK_HOME AGLET_HOME
    

  • Unix(csh, tcsh)

    setenv JDK_HOME $(JDK)
    setenv AGLET_HOME $(ASDK)
    

  Though we recommend this, you may set these environment variables in your initial set up script, such as AUTOEXEC.BAT(Win95,98), .profile(Unix-sh), .cshrc(Unix-csh). Or it can be set from your command prompt just prior to call the startup script.

• Starting up Tahiti

  Create a command prompt window and start the daemon by executing a script in the aglets package:

  $(ASDK)\bin\agletsd
  or
  $(ASDK)/bin/agletsd (on Unix platforms)
  

  This daemon will listen for agents on the default port number, 4434.

• Registration - if you are not registered, yet

  The first time you run Tahiti it will ask you to register - please do so to continue.

  

• User Authentication (Login)

  Just after starting up Tahiti, a login dialog box may be shown to prompt authentication of yourself. Then, input your id and password. If you registered yourself with no password, this dialog will not shown (no password login).

  

  At this moment, Tahiti appear on your screen. Tahiti is a desktop interface to manage running agents.

  When Tahiti window is open, confirm its title bar. Its title bar should include full host.domain name of the server with specified portnumber.

  

  Remark: If there is another server is running, which is specified with same host.domain name and port number. It shows "NOT RUNNING" message.

  

  In this case, you should stop execution of the server, which is "not running."
  
  

• Run multiple Tahitis on a single server

  User can run multiple Tahiti sessions on the same computer by following the procedures.

  Step 1: Create a command prompt window and start the daemon:

  $(ASDK)\bin\agletsd
  or
  $(ASDK)/bin/agletsd (on Unix platforms)
  

  This daemon will listen for agents on the default port number, 4434.

  Step 2: Create another command prompt window and start another daemon here:

  $(ASDK)\bin\agletsd -port 2000
    or
  $(ASDK)/bin/agletsd -port 2000 (on Unix platforms)
  

  This daemon will listen for agents on another port - in this case port number 2000. You can actually choose any port that is 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.