IBM Skip to main content ShopIBM Support Downloads
Spacer
IBM Home Products Consulting Industries News About IBM
Search
 
 
 
 
 
  Computer Science  
     
  Cyberspace  
  TSpaces  
    Introduction  
    Licensing  
    Research activities  
    Press  
    Papers & presentations  
    Developer resources  
    Project members  
    Employment  
 
   Related links:  
    Almaden Research  
    CS Research  
   IBM Research  
 

TSpaces - Intelligent Connectionware

TSpaces Requirements
  TSpaces is the support for software communication, like a brigde, it connects business in the information highway
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,Win2000,Linux)
- JDK 1.3 (WinNT,Win2000)

We have also had a numerous people install and test TSpaces and have heard that it also runs on Solaris, OS/2 and Apple.

Downloading TSpaces

TSpaces is obtained from the IBM AlphaWorks site. There are two paths to the TSpaces download image on Alphaworks. You can start at the alphaworks home page and work your way down, or you can go directly to the TSpaces page and click on the download button.

We created both a zip file (which is compressed down to about 1500kb at last count) and a tar file (which is left uncompressed at about 5000kb) for those few remaining folks that don't have zip. These zip or tar files contain the required jar files for the server and the clients plus the JavaDoc API information and the source for a number of example clients.

Installing TSpaces
For both the tar and zip files, the TSpaces project files will expand out into a tspaces directory and other subdirectories.

For the Zip file distribution, unzip the file tspaces.zip onto your system into a directory of your choice.

After extracting the tspaces files, under a directory of your choice, there will be a new tspaces directory that has the structure shown below. If, for example, you unziped into c:\java\ on your Windows system, then you would have:

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

To start the TSpaces server, you would make the above tspaces directory the current directory and then run:

   "bin\tspaces.bat"
or
   "sh bin/tspaces.sh"
Service Pack 1
We have provided a cumulative "ServicePack 1" that will fix some of the problems that have been discovered and fixed. To install the ServicePack, download: tspaces212sp1.zip from AlphaWorks and unzip it into the same directory where you unziped the original tspaces212.zip file.
The distributed tspaces.bat will automatically cause the fixes to be used. If you are using your own procedures to start TSpaces then update the classpath for your server so that ./lib/tspaces_fixes.jar is the first entry and restart the server. If you do this correctly, the informational message displayed by the server at startup will indicate that it is running
"Version = 2.1.2 ServicePack 1".

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"
- Run the example programs.
- Read the programmer's guide to learn how to use TSpaces in your applications.
- Use the JavaDoc API information to write your TSpaces applications.

Migrating to a new version
If you are already running an older Version of TSpaces (Version 2.1.1) you can install the new Version 2.1.2 release and migrate the tuplespaces from the old server to the new server using the Migrate utility.

- 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>
Where:
- 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
Where:
- -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.

 

 

Developer resources
News
alphaworks
Install
Examples
FAQ
Mailing list
Programmers guide
JavaDoc
   

Download TSpaces

     

If you have any feedback or questions, respond to tspaces@almaden.ibm.com.

   

 

   
Privacy Legal Contact