After Installation

Chapter contents

The post-installation script performs the following tasks:

Creates user psql and group pvsw

Sets user:group ownership to psql:pvsw for the installed files

Stops Pervasive PSQL daemons if they are running

Applies a 10 user, 30 day limited license

Launches the Pervasive PSQL daemon - mkded

Creates a new ODBC DSN (data source name) for the DEMODATA test database

Creates a new Samba share PSQLDATA if Samba configuration file is found

Creates startup/shutdown scripts for Pervasive PSQL daemons

After the installation script is finished, you should verify that the engine daemon (mkded) is running with the Linux ps utility:

Type the following at the command prompt:

ps -e | egrep `mkded'

User Count License

Once you have completed installation, you may need to update your user count license by using the clilcadm utility. The update can be done anytime before using Pervasive PSQL from a client. Information about how to do this can be found in Pervasive PSQL User's Guide (see License Administrator ). Detailed information about clilcadm can also be found in the man pages and in the documentation for clilcadm located in the "Linux Supplementary Documentation" section of Pervasive PSQL User's Guide.

Note
You must be a member of group pvsw to run the clilcadm utility. See Pervasive PSQL Account Management on Linux for more information.

Accessing README File Information

The README file, readme.htm, contains late-breaking product news that could not be included as part of the JavaHelp documentation.

You can access the README file from two different locations:

The root directory on the distribution media.

In the following directory: /usr/local/psql/bin/plugins/com.pervasive.help.ui_1.0.0 (provided you install the JavaHelp documentation).

Configuration

Generally, the default configuration settings for Pervasive PSQL Server are sufficient. See Configuration for settings that you may want or need to set.

Common Questions After Installation

If you are have problems with your installation, see Chapter 19, Troubleshooting After Installation or get help online from our Knowledge Base website at http://support.pervasive.com/eSupport.

How Do I Read the Online Documentation?

The only documentation installed with Pervasive PSQL Server is a set of man pages for the command-line utilities. The Pervasive PSQL manuals, in JavaHelp format, must be installed separately. See Installing PCC and Documentation on Linux .

Where Do Files Reside After Installing The Server Engine?

For a given OS platform, installing the Server engine creates the directories listed in the table below. For certain directories, the table also lists the primary files. $PVSW_ROOT refers to the root directory where Pervasive PSQL files are installed. By default it is set to the following:

Default $PVSW_ROOT

/usr/local/psql


Path from $PVSW_ROOT	File	Description
./	LICENSE	License information
./bin
	bcfg	Configuration utility
	bdu	Bulk data import utility
	bmon	Monitor utility
	btadmin	Add Pervasive user and passwords
	butil	Btrieve maintenance utility
	clilcadm	License administrator utility
	dbmaint	Database maintenance utility
	dsnadd	Add DSN utility
	event.log	Pervasive PSQL event log
	instwrap
	isql	ODBC client utility
	mkded	Btrieve database server daemon
	odbcci.so	ODBC driver shared object
	psregsvr	Pervasive Services
	pvdbpass	Database password utility
	pvddl	Data dictionary language utility.
	pvswauth
./bin/plugins		An empty directory that is used for for PCC and JavaHelp documentation if you install them. They are separate installations.
./data/DEMODATA		Sample University database
	billing.mkd	Billing table
	class.mkd	Class table
	course.mkd	Course table
	dept.mkd	Department table
	enrolls.mkd	Enrolls table
	faculty.mkd	Faculty table
	field.ddf	Field DDF file
	file.ddf	File DDF file
	index.ddf	Index DDF file
	person.mkd	Person table
	room.mkd	Room table
	student.mkd	Student table
	tuition.mkd	Tuition table
./data/samples
	sample.btr	Sample Btrieve file
	upper.alt	Alternate collating sequence
./etc
	.PSRegistry	This directory, and its subordinate directories, comprise the Pervasive registry, where configuration settings are retained
	btpasswd	User passwords file
	dbnames.cfg	Master table of database names
	odbc.ini	ODBC settings
	preinstall.sh	Shell script that runs before product installation
	postinstall.sh	Shell script that runs after product installation
	preuninstall.sh	Shell script that runs before product removal
	postuninstall.sh	Shell script that runs after product removal
	psregistry.ini	Registry information for server
./lib		Library shared objects
./log		Log files directory
./man/man1		Directory that includes man pages for the command-line utilities

What to Do Next?

To install the Pervasive PSQL Client for Linux, see Installing Pervasive PSQL Client for Linux .

See Using Pervasive PSQL on Linux for information on using the Pervasive PSQL products after you install them.

If you are having difficulties after installing, see Chapter 19, Troubleshooting After Installation.

For information about user licenses, see Pervasive PSQL User's Guide - Chapter 4, License Administrator.