Dubious Object Store Instructions

November 11, 1998
November 13, 1998
November 24, 1998
December 7, 1998

The contents of these instructions originally appeared in the class newsgroup (git.cc.class.8113d).

November 11, 1998.

Date: Wed, 11 Nov 1998 21:24:01 -0500
From: Wai Gen Yee 
Newsgroups: git.cc.class.8113d
Subject: Some Object Store Instructions.

Yes, I don't know much about sys nor db admin, so bear with me,
and give me advice/criticism/PRAISE if you think of any.

By the way, I haven't run anything but configuration test 
programs on Object Store, so I probably won't be able to answer
questions based on any experience.

Object Store (OS) is located at a machine called:

yangtze.cc.gatech.edu

This is a Sparcstation 5, I think.  It's rather slow to be a
server.  Be nice to it.

The actual OS files are located at:

/ad12/ODI

OS itself is in a subdirectory named
/ad12/ODI/ostore.

The documentation is located in /ad12/ODI/ostore/doc

I suppose you can look at it via 'lynx,' but, running

/ad12/ODI/ossearch

starts up a Web server on yangtze and spawns a browser which
points to the documentation automatically.

A couple of environment variables you may need to set are:

OS_ROOTDIR   <--  /ad12/ODI/ostore
LD_LIBRARY_PATH  <--  $OS_ROOTDIR/lib:$LD_LIBRARY_PATH

November 13, 1998.

Date: Fri, 13 Nov 1998 22:10:07 -0500
From: Wai Gen Yee 
Newsgroups: git.cc.class.8113d
Subject: Inspector Set Up

Inspector's up.  Look in:

/net/ad12/ODI/OSI3.0

The docs are, of course, included.

The /net mounted drive is accessible from the COC subnet.  Otherwise,
telnet to yangtze.

Also, remember to send your papers/slides.

November 24, 1998.

Ok, I have written a c shell (csh) script that should set your environment variables correctly. Just download it and type:

source osscript.csh

This should install the variables into your environment.

Now, to start up a Web server and view Object Store documentation, you can type:

$OS_ROOTDIR/../ossearch

Note: You must be logged into a COC Sun machine running machine Solaris (SunOS 5.5.1 or higher). These machines can be found in the Sun room on the first floor of the COC next to the NT lab. If you need accounts to log into these machines, contact Prof. Navathe or Peter Wan.

I hope to have better instructions on how to actually use Object Store by tonight. In the meantime, if you decide to read the instructions, and figure it out on your own, please let me know and/or post your discoveries on the newsgroup.

December 7, 1998.

For the brave souls trying to use ostore, here are some more instructions on running examples. There are 4 parts to this. I tried running hello2 and query from the /net/ad12/ODI/ostore/examples directory on one of the Solaris machines in the CoC's Sun lab, and discovered that there are a couple of environment variables that have not been properly set. They are:

OS_CACHE_DIR
OS_COMMSEG_DIR

They should point to directories that will contain Object Store's cache and communications segment, whatever those are. Set them by typing:

setenv OS_CACHE_DIR /tmp/ostore
setenv OS_COMMSEG_DIR /tmp/ostore

/tmp is Unix's temporary file directory that is freely writable by any user. Go to that directory, and see if there is a /tmp/ostore directory which is globally readable/writable. If not, do this:

cd /tmp
mkdir ostore
chmod 777 ostore

Now, ossg, when run, should use that directory to place temporary files. I have updated the osscript.csh file to reflect this. Again, to run the ooscript.csh file, type:

source osscript.csh

A copy of this file exists in /net/ad12/waigen.

To run the Object Store web server and spawn a browser, do this:

source osscript.csh

$OS_ROOTDIR/../ossearch

Only if you start up your Object Store instruction browsing in this way will you be able to use the "search" facility of the Web pages.

Again, here are the basic instructions on how I would go about running sample Object Store code. After doing all of the above, assume that I want to run the "query" example.

0. Log onto any Sun Solaris machine in the Sun Lab

1. Run osscript.csh

source osscript.csh

2. Go to your directory on yangtze:

cd /net/ad12/waigen

3. Copy files from the example directory to your directory:

cp -r $OS_ROOTDIR/examples/query .

4. Make the query directory world readable/writable//

chmod 777 query

5. Make the files in the query directory world readable/writable

cd query
chmod 777 *

6. In the file "doall" in the query directory, change all references to "make" to "gmake." Use your favorite text editor to do this.

7. In the file "makefile," change the variable CCC from CCC=CC to CCC=/opt/SUNWspro5.1/bin/CC using your favorite editor.

8. Run doall

doall

9. You should be done now.

I'm still trying to figure out how to use Inspector. If you have any questions, you can write to akshai@cc, bajaj@cc, minaxi@cc, waigen@cc. (Hehe, I didn't ask the other 3 for permission to put their names here, but I'm sure they'll forgive me.)

[CS8113D]

Wai Gen Yee

Last modified: Tue Nov 24 12:12:37 EST 1998