After Installing Pervasive PSQL Vx Server for Linux

After Installing Pervasive PSQL Vx Server for Linux

The following topics are useful to review after you install Pervasive PSQL Vx Server:

•

Verifying Installed Products With RPM

•

Server Configuration

•

Client Configuration

•

Increasing the Limit for Session Count or Data In Use

•

Common Questions After Installation

Verifying Installed Products With RPM

The following table provides commands with which you can verify which packages the RPM packager installed. The commands are case sensitive.

Table 25

RPM Commands To Verify Pervasive PSQL Vx Server Packages Installed

Pervasive PSQL Vx Server Package

RPM Command to Verify Installation

rpm -q Pervasive.SQL-Vx

rpm -q Pervasive.SQL-Client

The command returns the specific client version installed (Pervasive.SQL-Client-release-build).

rpm -q Pervasive-Backup-Agent

rpm -qa | grep Pervasive

Verifying Database Engine is Running

Optionally, after the installation script finishes, you can verify that the database engine is running with the Linux ps utility. Type the following at the command line:

ps -e | egrep mkded

Server Configuration

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

If you want to explore all of the configuration settings, see the chapter Configuration Reference in Advanced Operations Guide.

Client Configuration

All configuration settings for the Linux client are discussed in Linux Client Configuration Parameters in the Advanced Operations Guide.

In this guide, see also Installing Pervasive PSQL Clients for Windows and Configuring Network Communications for Clients for additional information about clients.

Linux Clients and the Monitor Utility

This information applies only to Linux clients that use a static IP address. Ignore this subsection if you use DHCP and have a DSN to resolve named addresses.

When you monitor Linux clients using the Pervasive PSQL Monitor utility, the client IP address that gets transmitted across the network originates from the “hosts” file. If the system name and IP have not been added to the “hosts” file, network communication uses the local host's IP address, which is 127.0.0.1 or ::1 (an IPv6 loopback address).

If you change the loopback address to the correct IP, or if you add the system’s name and IP to the “hosts” file on the Linux client, the client name correctly displays when in the Monitor utility.

Increasing the Limit for Session Count or Data In Use

At some point after installation, you may want to increase session count or data in use beyond the initial amount provided by the product key. See Increasing Session Count Limit and Data In Use Limit in Pervasive PSQL User's Guide.

Common Questions After Installation

If you are have problems with your installation, see Troubleshooting After Installation or get help online from the Pervasive Knowledge Base at the Pervasive Web site. The following are common questions after installation of the products:

•

Where Do Files Reside After Installing Pervasive PSQL Vx Server?

•

How Do I Access the Documentation?

•

What If I Get Errors Trying To Start the Utilities?

Where Do Files Reside After Installing Pervasive PSQL Vx Server?

The following table lists the primary directories and files that result from installing the Pervasive PSQL Vx Server products on Linux. $PVSW_ROOT refers to the root directory where the files are installed. By default it is set to /usr/local/psql. Unless otherwise noted, the primary directories and files are the same for 32-bit and 64-bit products.

For an upgrade installation, your existing Pervasive PSQL files were updated to the latest versions.

Table 26

Primary Directories and Files for Pervasive PSQL Vx Server Products Installed on Linux

Path from $PVSW_ROOT

Applies to Installation of

License information

Binary files, executable utilities and so forth

Server and Client

A directory pertaining to files for the utilities and documentation

Server and Client

./data/DEMODATA

Sample Pervasive PSQL Vx Server database

Sample Btrieve files, alternate collating sequence file and the DefaultDB system database

Server and Client

Pervasive registry of configuration settings (this directory and its subordinate directories)

User passwords file

Master table of database names

Server and Client

Shell scripts for the following:

•

pre-product installation

•

post-product installation

•

pre-product uninstall

•

post-product uninstall

Server and Client

Library of 32-bit shared objects

Server and Client

Library of 64-bit shared objects

Note: This directory exists only if you install the 64-bit Server or Client

Server and Client

Transaction log files directory

Server and Client

Man pages for the command-line utilities

Server and Client

Files and directories for Pervasive Backup Agent

Pervasive Backup Agent

How Do I Access the Documentation?

The documentation installed with Pervasive PSQL Vx Server includes the following:

•

Man pages for the command-line utilities

•

Pervasive PSQL Documentation Library, which includes the Pervasive PSQL Vx Product Guide

•

Pervasive PSQL Vx Server Release Notes

Man pages are provided for the command-line utilities. To make these man pages available, add $PVSW_ROOT/man to your MANPATH environment variable.

Note that the man pages are installed with Pervasive PSQL Vx Server Server and with Pervasive PSQL Client. They are not installed as part of the user documentation.

Documentation Library

The Pervasive PSQL Documentation Library contains the complete set of user documentation, including the user documentation for the Pervasive PSQL engine and software developer’s kit, as well as a glossary of database terminology.

►

To view the Pervasive PSQL Documentation Library

1

Open a terminal window.

2

Run one of the following:

a.

/usr/local/psql/bin/pcc

b.

As the psql user

Note that the viewer for the documentation library is integrated into Pervasive PSQL Control Center (PCC). The documentation library is accessed through the PCC interface on the Welcome view, in the Help menu, by pressing F1 (Windows) or Shift F1 (Linux).

The release notes in readme_psqlvx.htm contain late-breaking news that could not be included as part of the user documentation. The release notes file is located in the /usr/local/psql/docs/ directory.

What If I Get Errors Trying To Start the Utilities?

See Starting PCC On Linux in Pervasive PSQL User's Guide and Starting DDF Builder from a Command Line in DDF Builder User’s Guide.

How Do I Use Pervasive Backup Agent?

See the topic “Using Backup Agent on Linux” in Pervasive Backup Agent Guide.