*************************************************************
                C O N C E P T B A S E

              RWTH Aachen, Informatik V
               Prof.Dr. Matthias Jarke
                    Ahornstr. 55
                 52056 Aachen, Germany
               Tel.: ++49+241 80 21 501
               Fax   ++49+241 8888 321
      email: CB@picasso.informatik.rwth-aachen.de
http://www.informatik.rwth-aachen.de/I5/CBdoc/cbflyer.html

*************************************************************

                InstallationGuide

*************************************************************


CONTENTS:
=========

1. System Requirements
2. Files 
3. Installation
4. Decoding ConceptBase 
5. Starting ConceptBase 
6. Important additional remarks
7. Contact

1. System Requirements:
=======================
Computer: SUN4/Sparc with Internet
Main memory: 8 MB (16 recommended)
Free swap space: >= 30 MB (40 recommended)
Free space on disk: >= 18 MB
Operating System: Solaris 2.3
Environment: X11 R5 

For obtaining ConceptBase via ftp you additionally need  8 MB free
disk space.

To run the ConceptBase Usage Environment on your Solaris system, the 
Binary Compatibility package must be installed. You can check this with
the 'pkginfo' command.

In order to uncompress the CB tar file you need the
'gunzip' utility which is available for free on many ftp-servers.

2. Files:
=========

cbase33.tar.gz: tar-File, containing the executable code of ConceptBase
CB_install: ConceptBase installation script


3. Installation:
================

To obtain the system, please  transfer CB_install and 
cbase33.tar.gz to your local system.
Before running the installation script you should 

-	create an installation-directory for ConceptBase
-	Install a group "cbase" in /etc/groups and assign each 
	ConceptBase user to it

To install the system, ensure that the script "CB_install" is executable. 
If not, change the permission mode.  
Then enter "CB_install". This script will ask you for an installation
directory and will install ConceptBase 3.3 in this directory afterwards.
The script will create the file "cshrc.new" , which contains the settings of 
all necessary environment variables.

4. Decoding ConceptBase:
========================

Before ConceptBase can be started, you have to decode it.
To do this, please perform the following steps:
Send an email after installing 
ConceptBase to :
CB@picasso.informatik.rwth-aachen.de 

This email MUST contain 

	-	the full postal adress of your institution
	-	the contents of the file"creation_date",
	 	placed  in $CB_HOME/CB_Exe/KSV_Exe 

Read the license agreement, placed in 
$CB_HOME/CB_Exe/doc, sign it and send it to

ConceptBase-Team
c/o Rene Soiron
RWTH Aachen - Informatik V
D-52056 Aachen - Germany


You will get a keynumber as answer via email.
To decode ConceptBase with this key, you must start
the program decode.
This program is placed in the directory
$CB_HOME/CB_Exe/KSV_Exe. 
Change to this directory, run decode and enter the 
keynumber when  requested, then ConceptBase will 
be decoded.


5. Starting ConceptBase:
========================

5.1 Starting the ConceptBase Server
-----------------------------------

You have to use a C-Shell (/bin/csh) to start ConceptBase. Start the server by

	$CB_HOME/CB_Exe/KSV_Exe/CBserver -p 4001 -d DB

The number 4001 is the port (or "socket") number that is used to connect 
 clients to the server process. You can specify any number between 2000 and 
99999. The default value is 4001 (if you omit the '-p' option). The parameter 
-d specifies the database (sometimes called "application" in the user manual) 
to be loaded by the server at startup time. If a path is omitted (as above) 
then the database is loaded from the current directory. If there is no 
database with the specified name (here:DB) then it is created and initialized
with the system classes of O-Telos, the object model of ConceptBase.
After successfully loading the server reports

          This is ConceptBase (CBserver) ...

 with some additional information. 

Please note that no two servers can use the same port number on the same 
machine. In this case you get the error message 

	IPC Error: Unable to bind socket to name

and the server won't start up. You should then either start the server on a 
different machine or use another port number.

Other command line parameters are


	-d  <db>	
		The database <db> is loaded at server startup time. This 
		parameter is MANDATORY.

	-u  <upd>
		Set <upd> to nonpersistent if your updates shall be
		valid only for the current session. Otherwise, set it to 
		persistent (default).

	-t  <trace>
		This parameter controls the amount of tracing on the
		CBserver terminal. Possible settings are:
      		none: (nearly) no tracing  
      		low:  only interface calls (default)
       		high: intermediate steps of transformations
       		veryhigh: many-many-many lines of output

	-q  <quev>
		Queries and deductive rules can be evaluated backwardly
		(SLDNF) by Prolog-like resolution and "forwardly" (Magic).
 		We recommend SLDNF (default).

	-o  <opt>	
		The optimization of integrity constraints by using structural
		axioms can be turned on (structural) or off (noopt).

	-r  <repdelay>
		If the server crashes it will be restarted after <repdelay>
		seconds.

Specified parameters must be separated by blanks.



5.2 Starting the ConceptBase Usage Environment
----------------------------------------------


Start the X11 usage environment of ConceptBase in a C-Shell by

	% $CB_HOME/CB_Exe/XI_Exe/sun4/CBinterface

Successfully starting is indicated by the appearing ConceptBase Tool Bar.


5.3 Connecting Server and Usage Environment
-------------------------------------------


After starting server and usage environment of CB the first step is to 
establish the connection between them. This is done by selecting menu item

          Connect CB server

from the System menu of the tool bar. In the appearing interaction window the 
host name and port number of the CBserver must be specified and as a result 
the connection is established.


Example:


           1. 	start server on machine alpha with port number 5000 (see above)

           2. 	start usage environment on machine beta (see above)

           3. 	connect usage environment on beta to the server on alpha
              	by selecting Connect CB server and specifying

	  		name of the host machine   : alpha

	  		portnumber : 5000


Whenever a new connection from an usage environment to a CBserver is created a 
possibly existing 'old' one is disconnected. Please note that the machines 
alpha and beta can be located anywhere in the Internet. You can also start 
both processes on the same machine. 



6. Important additional remarks:
================================

A CBserver may only be stopped by a client if the name of the user of the 
client is the same as the one who started the CBserver. Use menu item Report 
clients of the usage environment to display the user names. This behavior is 
not an error but a security measure.

The communication between the client tools and the error window is based on 
the UNIX IPC message service. Hence, the kernel of each machine has to be 
configured with the IPCMESSAGE option set. Otherwise, errors will be lost and 
not reported.

We hope the system is useful for your application. We recommend to start with
the ConceptBaseTutortial (in CB_Exe/CB_Manual) for getting used to the
language and the system.

Reports on ConceptBase can be obtained from ftp.informatik.rwth-aachen.de.
Download the file pub/reports/CONTENTS for more information.



7. Contact
==========

ConceptBase-Team
c/o Rene Soiron
RWTH Aachen - Informatik V
D-52056 Aachen - Germany

Tel./Fax: +49-241 80 21 501 / +49-241-8888321
email: CB@picasso.informatik.rwth-aachen.de 
href="http://www.informatik.rwth-aachen.de/I5/CBdoc/cbflyer.html"


