GSP
Quick Navigator

Search Site

Unix VPS
A - Starter
B - Basic
C - Preferred
D - Commercial
MPS - Dedicated
Previous VPSs
* Sign Up! *

Support
Contact Us
Online Help
Handbooks
Domain Status
Man Pages

FAQ
Virtual Servers
Pricing
Billing
Technical

Network
Facilities
Connectivity
Topology Map

Miscellaneous
Server Agreement
Year 2038
Credits
 

USA Flag

 

 

VPS v2: PostgreSQL: Installation

bullet Introduction

To install PostgreSQL on your Virtual Private Server, connect to your server via Telnet or SSH as root and run the following command:

% vinstall pgsql

The PostgreSQL installation includes all the necessary PostgreSQL files, initializes a database with the same name as your user name, and activates the postmaster daemon. Several wrapper scripts are available for all PostgreSQL commands. The wrapper scripts are automatically created when PostgreSQL is installed.

PostgreSQL is installed in a version-specific directory (~/usr/local/pgsql-7.X.X) and a symlink named pgsql is created that points to that directory.

 

bullet Configuration

If you choose to configure PostgreSQL, add the following lines to your shell startup file, according to which shell your Virtual Private Server is running.

NOTE: To find out which shell your server is running, type:

% echo 
  • /bin/csh - If you are using /bin/csh or one of its variants, then add the following lines to the ~/.cshrc file on your Virtual Private Server.

    setenv PGDATA /usr/local/pgsql/data
    setenv PGLIB /usr/local/pgsql/lib
    set path = (/usr/local/pgsql/bin )
  • /bin/sh & /bin/bash - If you are using the Bourne shell (/bin/sh or /bin/bash) then add the following lines to the ~/.profile file on your server:

    PATH=:/usr/local/pgsql/bin
    PGDATA=/usr/local/pgsql/data
    PGLIB=/usr/local/pgsql/lib
    export PGDATA PGLIB

 

bullet The psql Client

The main tool for using PostgreSQL is the psql client. To start psql use this command:

% psql

The psql client will start up and you will be able to type in SQL code and ask for help.

NOTE: You may see the following error:

Connection to database '(null)' failed.
FATAL: PQsetdb: Unable to determine a Postgres username!

To resolve this, simply use the following command:

% vpwd_mkdb ~/etc/passwd

This program will read your password file at ~/etc/passwd and create a Berkeley DB format file. PostgreSQL uses this new file to look up user names and account information.

 

bullet Multi-Language Abilities in PostgreSQL

PostgreSQL allows for a number of languages by enabling specific character-sets in the databases. When you create a database in PostgreSQL, you can use the -E flag to enable support for a specific character set.

% initdb -E SET

The following is a list of the available character sets and the SET name to use to enable support for it.

SET

 

Description

SQL_ASCII

 

ASCII

EUC_JP

 

Japanese EUC

EUC_CN

 

Chinese EUC

EUC_KR

 

Korean EUC

EUC_TW

 

Taiwanese EUC

UNICODE

 

Unicode(UTF-8)

MULE_INTERNAL

 

Mule Internal Code

LATIN1 ISO 8859-1

 

English and some Europe Lang

LATIN2 ISO 8859-2

 

English and some Europe Lang

LATIN3 ISO 8859-3

 

English and some Europe Lang

LATIN4 ISO 8859-4

 

English and some Europe Lang

LATIN5 ISO 8859-5

 

English and some Europe Lang

KOI8

 

KOI8-R(U)

WIN

 

Windows CP1251

ALT

 

Windows CP866

 

bullet Removing PostgreSQL

To remove PostgreSQL from your server, connect to it via SSH prompt, as root and do the following:

% vuninstall pgsql

Edit your ~/etc/rc file, removing the line that contains postmaster.

Run the ps command, like this:

% ps -x

Determine the process ID of the PostgreSQL daemon and use kill to stop the PostgreSQL daemon:

% kill PROCESS-ID


Toll Free 1-866-GSP-4400 • 1-301-464-9363 • service@gsp.com
Copyright © 1994-2016 GSP Services, Inc.