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