TSIMMIS Source Installation

Content

TSIMMIS - Source Installation
TSIMMIS - Setting up Wrappers and Clients
TSIMMIS - Source Structure

TSIMMIS - Source Installation

Please follow these steps to install the TSIMMIS source:

After getting the gzip'ed tar'ed file of TSIMMIS, extract the files using
```
 gunzip Tsimmis.tar.gz
 tar xvf Tsimmis.tar
```
Change your working directory to Tsimmis and set the following environment variables to build the executables on a UNIX platform:
```
 cd Tsimmis
 setenv OSTYPE `uname -s | tr "[A-Z]" "[a-z]"`
 setenv TSIMMIS_HOME `pwd`
 setenv TM_DIST $TSIMMIS_HOME/tmdist.$OSTYPE
```
Customize the UNIX environment by modifying the files in the directory src/setup. The platform specific makefile is _$OSTYPEmk.m
Run the make command in the source directory to build the executables:
```
 cd src
 make install>& ${OSTYPE}1.install
```
All the files required for running the TSIMMIS wrappers and clients are copied into the TM_DIST area.

TSIMMIS - Setting up Wrappers and Clients

 In the following discussion TM_DIST is assumed to be set to /u/tsimmis/tmdist.public
 Make sure that $TM_DIST/tmp exists and is writable by all.
 ( mkdir $TM_DIST/tmp; chmod 777 $TM_DIST/tmp )
 The TSIMMIS wrappers (servers) and clients use IONA Technologies' Orbix, an
 implementation of the CORBA standard, to communicate with each other.
 For Orbix, $OSTYPE has to be set to 'sunoscc', because it
 requires Solaris' native C, C++ compilers. The client/server interface is
 based on the I3 protocol developed at Stanford.
 The Orbix daemon needs to be brought up with the -u option. For example the
 relevant line in /etc/rc2.d/S99orbixd should read
 ...
 IT_DEFAULT_COMMS=tcp
 IT_DEFAULT_CODE=xdr
 export IT_DEFAULT_COMMS
 export IT_DEFAULT_CODE
 /opt/Orbix_2.2MT/corba2/bin/orbixd -u> /tmp/Orbix_Daemon_Output 2>&1 &
 ...

instead of

 ...
 /opt/Orbix_2.2MT/corba2/bin/orbixd> /tmp/Orbix_Daemon_Output 2>&1 &
 ...

A wrapper object (e.g., biblio) can be registered with Orbix using the following commands:

 putit biblio "/u/tsimmis/tmdist.public/bin/biblio_wrap -s biblio -o TM_DIST:/u/tsimmis/tmdist.public"
 chmodit i+all biblio
 chmodit l+all biblio

Once a wrapper is registered with Orbix, Orbix automatically starts the wrapper (if the wrapper is not already running) when a client program is executed. The clients can talk to a TSIMMIS wrapper in two ways:

Using the text based client

 A module called 'tmclient', available in the $TM_DIST/bin area, can be used to
 talk to a TSIMMIS wrapper. It is invoked by:
 $TM_DIST/bin/tmclient -s server_name

where server_name is the name of the wrapper, e.g., biblio.

Using the web browser
```
 This method makes use of Mobie, the web-based interface to TSIMMIS.
 The following links need to be setup in the cgi-bin directory
 (e.g., in /u/tsimmis/public_html/cgi-bin):
 cd /u/tsimmis/public_html/cgi-bin
 ln -s /u/tsimmis/tmdist.public tmdist
```
One may also need to create a link in the /httpd/cgi-bin area.
```
 cd /httpd/cgi-bin
 ln -s /u/tsimmis/public_html/cgi-bin tsimmis
```
The file $TM_DIST/mobie/stk_mediator.demo contains the configuration information for Mobie, details about the supported wrappers, and sample queries for various wrappers. This file may need to be modified to suit the environment and requirements. Mobie can be invoked in a html page as a cgi command:

"http://herring.stanford.edu/cgi-bin/tsimmis/tmdist/mobie/mobie_server?-c+stk_mediator.demo+-v1"

TSIMMIS - Source Structure

 src - contains all the TSIMMIS source files
 src/clients - contains simple client, mobie client and other
 mobie support files
 src/common - contains client/server common files, OEM_Object files
 src/files - contains data files such as bibliographic files
 src/mediators - contains engine, mediator-kernel components
 src/orbix - contains Orbix interface files
 src/setup - contains platform specific, common makefile
 components
 src/tests - contains test driver, sample queries for
 various components
 src/wrappers - contains various wrappers, matcher, parser and
 driver components