Uda Wiki Web

OpenLink Single-tier Components (*nix) for Progress

Aims and Intentions

This guide is intended to enable competent system administrators to install and configure OpenLink Multi-tier client side components on *nix style operating systems in a few steps as possible.

This guide does not explain any of the non-pertinent features encountered along the way. Such explanations may be found in the full documentation.

Prerequisites

• You MUST be proficient in using a Unix shell.
  
• You MUST be proficient in using a Unix editor such as vi
  
• You MUST be in possession of relevant database connectivity details such as Database name, Username, password, etc.
  
• You MUST have installed, and available either; a full installation of Progress or an installation of the Progress Client Networking components.
  
• You MUST be aware of the differences between Progress 4GL/SQL-89 and Progress SQL-92 features and that the Single-tier (Lite Edition) drivers on *nix OSs are only available to make SQL-92 type connections.

Installation

1. Log onto the machine and create a suitable OpenLink installation directory <OPENLINK_INSTALL>
   
   
2. Copy all relevant components to <OPENLINK_INSTALL>
   
   At bare minimum, these will be the OpenLink ODBC Driver for Progress, OpenLink Http Administration Assistant and OpenLink license file.
   
   
3. Install using the "install.sh" shell script --
   
   

   
    #sh install.sh
   
   

   
   
4. You should take care to enter correct information when prompted pertaining to ports, passwords, etc and ensure that you note these down for future use.
   
   
5. The installation should finish without error.

Configuration

Environment

Open the file <OPENLINK_INSTALL>/openlink.sh with a suitable text editor such as vi.

Locate the section that deals with the location of shared libraries pertaining to your system (LD_LIBRARY_PATH, LIBPATH or SHLIB_PATH) and add to it the location of your Informix lib and lib/esql directories --

 
 LD_LIBRARY_PATH="<OPENLINK_INSTALL>/lib:/progress/v10.1b/lib:$LD_LIBRARY_PATH"
  

Driver Specific

Open the file <OPENLINK_INSTALL>/openlink.ini with a suitable text editor such as vi.

Locate the [Environment Progress xxx] section that deals with the driver specific Progress configuration and edit to reflect your Progress installation --

 
 [Environment Progress 100SQL]
 DLC                = /progress/v10.1b
 PROCFG             = /progress/v10.1b/progress.cfg
 CURSOR_SENSITIVITY = LOW        ; Set to HIGH after loading oplrvc.sql
 ;SQL_CLIENT_CHARSET     = UTF-8         ; Unicode connection

Data Souce

Open the file <OPENLINK_INSTALL>/bin/odbc.ini with a suitable text editor such as vi.

Locate and edit the sample OpenLink Progress ODBC data source (DSN) created during the installation process and edit as follows--

Sample Progress 10 Data Source (SQL-92 only)

 
 [prs100la]
 Driver          = <OPENLINK_INSTALL>/lib/prs100_st_lt.so
 ServerType      = Progress 100SQL
 Options         = <-S test91d -N tcp -H oplusosf51>
 Database        = </progress/wrk10.1b/demo92.db>
 Username        = <progress>
 Password        = <**********>
 FetchBufferSize = 99
 ReadOnly        = no
 DeferLongFetch  = no
 JetFix          = no
 Description     = Sample Progress 10 SQL-92 Lite Connection

Testing

Use the iodbctest tool which is packaged with the HTTP-based OpenLink ODBC Administrator as follows --

 
 #cd <OPENLINK_INSTALL>
 #. ./openLink.sh
 # iodbctest progress
 iODBC Demonstration program
 This program shows an interactive SQL processor
 Driver Manager: 03.52.0507.0105
 Driver: 06.02.1217 OpenLink Generic ODBC Driver (prs100_st_lt.so) 

 SQL>

You should now be able to issue SQL statements directly against the target database.

Additional Information

• The bitness of the ODBC Driver for Progress is determined by the bitness of your ODBC client application.
  
  That is, if your ODBC client application is 32-bit then the Generic ODBC Driver component MUST also be 32-bit.