System Requirements

TSpaces is pure Java and will run on any system that has a Java Version 1.1, 1.2 or 1.3 Virtual Machine. We have tested it on the following systems:

• JDK 1.1.6 (AIX)
• JDK 1.1.8 (Win95, WinNT)
• JDK 1.2 (Win95, WinNT,Linux)
• JDK 1.3 (WinNT)

There is one fairly important detail having to do with JDK release levels. We have included an admistrative tool(AdminApp) that uses Java Foundation Classes. Because of a recent package name change (com.sun.java. -> javax.) in the JFC classes, we can not distribute a single version of AdminApp that will run on any level. So we have chosen to distribute AdminApp so that it will run on the most recent versions of the JDK as follows:

• JDK 1.2 RC 1 and all future releases
• JDK 1.1
  • JDK 1.1.6 and all following releases
  • JFC Swing 1.1 Beta 3 and all following releases

Download

Follow the instructions for how to download and unzip TSpaces.

You will now have a new directory structure that looks like this:

c:\java\
   tspaces\
      index.html
      tspaces.cfg
      ...
       bin\
         tspaces.bat
         tspaces.sh
         ...
       html\
         ...
         javadoc\
       classes\
       contrib\
       examples\
       lib\
         tspaces.jar
         tspaces_client.jar

Configuring TSpaces

The options that control the TSpaces features are contained in a Configuration file that is read when you start the server. By default this is tspaces.cfg which is found in the current directory. You can change this by specifing "-c filename" on the command line.

The following features are disabled by default and must be enabled by modifying the configuration file:

• Persistant TupleSpaces/Checkpointing
• Security checking
• URLCopy - copying files from client->server->client

The distributed tspaces.cfg file has comments describing the various options. Currently this is the only documentation for this.

Testing TSpaces

• Change directories to the "tspaces" directory created above.
• Start a TSpaces server with the command:

     "bin\tspaces.bat" 
  or
     "sh bin/tspaces.sh"
  

• Read the User's Guide to learn more about TSpaces.
• Run the example programs.

• Read the Programmer's Guide to learn how to use TSpaces in your applications.

Migrating to a new version

• If necessary, startup the old server.

• Start the Migrate utility with the "Old" parameter.

    For example:
      
      cd  \tspaces203\tspaces
      bin\migrate.bat old adminuser/password c:\tmp 
           
           old indicates that the Tuples should be read from the
           server and written to temporary files.
           
           adminuser/password is the userid and password for the 
           TSpace Admin user.  This is specified in the tspace.cfg file or 
           was changed via the admin process. 
            
           c:\tmp is an existing directory that will be used to 
           temporarily store the Tuples from the old server.  
           
  

• Stop the old server.

• Startup the new server specifing the -B parameter so that the new server is started without using any old checkpoint data.

• Start the Migrate utility with the "New" parameter.

    For example:
      
      cd  \tspaces212\tspaces
      bin\migrate.bat -A new adminuser/password c:\tmp 
           
           -A is a flag that will cause the Userid and group structure
           from the old server to replace the Userid and group structure 
           on the new server.  Normally this would be desired.
           
           new indicates that the Tuples should be read from the
           temporary files and written to the server.
  
           adminuser/password is the userid and password for the 
           TSpace Admin user.  This is specified in the tspace.cfg file or 
           was changed via the admin process. 
            
           c:\tmp is an existing directory that contains the Tuples 
           from the old server.  
           
  

  
  
  

  ---

  [ TSpaces home page ]