
Free SOLID Desktop 2.2 for Linux		          readme.txt
--------------------------------------------------------------------

Free SOLID Desktop 2.2 for Linux is a special campaign version of
SOLID Desktop 2.2 for Linux, which is restricted to SOLID Server 
version 2.2 and allows 2 local concurrent connections from the 
same computer where the server is running.


Contents of this document
-------------------------

This document is divided into the following parts:
- System requirements
- Supported communication protocols
- Product files inventory
- Installation instructions
- Note for evaluators
- How to order SOLID Server
- More information on SOLID Server


SOLID Server System Requirements
--------------------------------
SOLID Server 2.2 requires:
- about 3.5 MB of disk space
- about 6.5 MB of virtual memory in the default configuration
- adequate disk space for the database and log files. 
  An empty database requires about 500 KB of disk space.
- adequate disk space for backup files. Backups require at most
  twice the space occupied by database and log files.

For information about the supported operating system versions, 
please check the file relnotes.txt in this same directory.


Supported Communication Protocols
---------------------------------
Supported communication protocols are UNIX Pipes and TCP/IP.

With Desktop license you can only use UNIX Pipes.

Please refer to the chapter COMMUNICATION PROTOCOLS in SOLID 
Server Administrator's Guide for details.


Product Package Contents
------------------------

The product package : 

   sf22<ooo>.tar.Z

, where <ooo> stands for the operating system mnemonic, is a 
compressed tar archive that contains the following files:

   orderme.txt		runtime license ordering instructions
   relnotes.txt		SOLID version specific information
   server.txt		installation instructions (this file)
   setup		shell script to help in start-up tasks

   bin/			executables
	solid		SOLID Server - database server program
	solcon		Remote Control - teletype administration
	solsql   	SQL Interpreter - SQL script execution
	solinst		Install - license & config creation

   database/		SOLID Server databases subdirectory
	default/	a sample database directory
           solidlic.txt	evaluation license terms
           default.ini	configuration file 
           default.lic	evaluation license, 
			database age limit: 30 days
	   log/		default db logfiles(move to another drive!)
	   backup/	default db backups (move to another drive!)
	
   public_html/		SOLID documentation
       	admingui/	SOLID Server Administrator's Guide	
	   admguide.htm	AG Table of Contents
	   aguide*.htm 	AG chapters
	   gaguide/*.gif AG images

       	techdesc/	SOLID Server Technical Description	
	   techd.htm	TD Table of Contents
	   td000*.htm 	TD chapters
	   gtd/*.gif	TD images

   samples/
	procedur.sql	Database procedure creation samples
	sample.sql	SQL data definition language (DDL) sample
	solidsrv.ini	SOLID Server configuration file sample


Installation Instructions
------------------------------------------------------------------

1) Create an appropriate directory in your environment for SOLID
   files, and copy the product package there. 
	mkdir solid
	cp sf22*.Z solid
	cd solid

2)  Uncompress the product package there with commands:
	uncompress sf22*.Z
	tar xvf sf22*.tar

3) Create license and configuration files by starting the script
	setup
   and following the instructions.


NOTE. The default configuration suggested is intended to be an 
      'Express Installation to Get Started Quickly'.
 
      It is strongly recommended for production databases
      to change the configuration as follows:
      - log files and database files to separate physical devices
      - backup directory and database to separate physical devices 

      You may change the configuration later by editing the 
      file 'solid.ini' or by using SOLID Remote Control. 
      Please see SOLID Server Administrator's Guide for 
      details.


How to Create a New Database
----------------------------
1) Create a new subdirectory under <soliddir>/database for the new 
   database. For example, if you would like to establish a database
   for your customer and order records, you might name it the 
   'customer' database:
	cd <soliddir>/database
	mkdir customer
	
2) Copy the following files from any existing database directory:
	- license file		(solid.lic)
	- configuration file	(solid.ini)
   and make any necessary modifications to the configuration file.
   At least the listening name must be different from any previous 
   SOLID Server process listening at the same host computer (or 
   within the whole network, depending on the protocol used).
   I.e., change the value of the following parameter:
	[Com] Listen=tcp 1234

3) Design the database structures and write CREATE TABLE and 
   other SQL DDL statements into an SQL file in the new database 
   directory (e.g. customer.sql).

4) Create an empty database with the right table structure
	cd <soliddir>/database/customer
	../../bin/solid -U<username> -P<passwd> 
			-x execute:customer.sql -x exit

5) Include the starting command of SOLID Server into to UNIX host 
   boot scripts:
	<soliddir>/bin/solid -c<soliddir>/database/customer 

6) Insert any base data that your applications need with the 
   teletype SQL Editor (solsql) or with the SOLID SpeedLoader 
   tool (solload(s)).   


For more instructions on how to manage SOLID Server or how to use 
the tool programs, please see the Administrator's Guide using any 
HTML browser.


Note for Evaluators
--------------------
The evaluation license does not allow you to use databases that 
are older than 30 days. The expiration of the evaluation license 
causes the following message to appear when trying to start 
SOLID Server:
	SOLID Utility Fatal Error 11015:
	Evaluation license expired.
	See orderme.txt for instructions on 
	how to order a license for SOLID Server,
	exiting from SOLID Server...


How to Order SOLID Server
-------------------------
To place an order for SOLID licenses, please see the file 
orderme.txt in the solid directory. 


How to Install the SOLID Server License
---------------------------------------
Once you have purchased a license you may update your license file.

Enter the Software Enable Key received in an activation letter 
with the command solinst in the default database directory:
	cd <soliddir>/database/default
	../../bin/solinst -l
to create a new license file solid.lic. Then you can copy the 
license file to all the appropriate database directories. E.g.:
	cp solid.ini ../customer

After this, your evaluation copy of SOLID Server is ready for 
continuous development or production use. You can immediately 
continue using the databases you have created during the evaluation
period without losing any data.


More Information on SOLID Server
--------------------------------
Latest product information and technical documentation are 
available from Solid Online Services. You can access our Web 
server at:

	http://www.solidtech.com/

Alternatively, you may address questions to:

	info@solidtech.com


Operating System Specific Information, Linux 2.0.X
==================================================

Linux version
-------------

SOLID Server for Linux is built using the 2.0.0 version of Linux.
This version has also been used in testing.

The SOLID Server for Linux has been used succesfully in development
and production in Linux versions 1.2.13 or greater and in 2.0.X.


