File: PB9WebEasyDemoInstallation.txt
Size: 4862
Date: Fri, 21 Dec 2007 00:35:19 +0100
Type: txt
-------------------------------------------------------------------------------------
PB Web Easy Quick Demo Installation                    copyright dwox.com 2006 - 2007
-------------------------------------------------------------------------------------


-------------------------------------------------------------------------------------
Requirements
-------------------------------------------------------------------------------------

- Apache Web Server 2.2x is up and running

- PowerBuilder 9 Runtimes are in the system's path or will be later copied
  into the cgi-bin directory.

- DB Connection to 'EAS Demo DB V9' with the following DBParms can be established
  via DBParm="ConnectString='DSN=EAS Demo DB V9;UID=dba;PWD=sql'"

  (see also pwe.ini -> [pwedemodb] section).

-------------------------------------------------------------------------------------
Installation and configuration
-------------------------------------------------------------------------------------
1.) Create a directory where the PB Web Easy Example (pb9webeasy.zip) is copied into:

Example:

c:\wrk\pb9webeasy
       |
       +-- cgi-bin (CGI Files)
       |
       +-- DBInstall (Optional SQL and Data files for MS SQL Server) 
       |
       +-- PBL (PowerBuilder Application and Libraries) 
       |
       +-- sessions (Directory to store session status/informations)
       |
       +-- temp (Directory to store temp files (used for PDF output)
       |
       +-- WebTarget ( .html .js .gif ..)
           |
           +-- Source
               |
               +-- (misc directories)


2.) Apache Server Configuration


a.) Move or copy the files from cgi-bin to Apache's 'cgi-bin' directory.
    Files: pwe.exe, pweio.dll, pwe.ini


b.) Add the following lines to the apache http server configuration file 'httpd.conf' 
in the Apache's 'conf' directory.

-------------------------------------------------------------------------------------

# /pb9webeasy/ mapped to the WebTarget's Source directory
Alias /pb9webeasy "c:/wrk/pb9webeasy/WebTarget/Source"

<Directory "c:/wrk/pb9webeasy/WebTarget/Source">
    Options Indexes FollowSymLinks
    AllowOverride None
    Order allow,deny
    Allow from all
</Directory>

-------------------------------------------------------------------------------------

Restart the Apache Server - and you are ready to run!


-------------------------------------------------------------------------------------
Intallation Test
-------------------------------------------------------------------------------------

Check general CGI Call:
http://localhost/cgi-bin/pwe.exe

Check application's CGI Call:
http://localhost/cgi-bin/pwe.exe/pb9webeasy/cgienv/of_printcgienv?A=TEST&B=ME

Check application's Demo Index:
http://localhost/pb9webeasy
or
http://localhost/pb9webeasy/Index.html

-------------------------------------------------------------------------------------
Additional options/features
-------------------------------------------------------------------------------------

Be sure to check the pwe.ini settings pointing to the right PBLs and paths.
If you are using the directory structure "c:\wrk\pb9webeasy" no changes are needed.

You can 'host' multiple PowerBuilder Applications and different Runtimes.
(Of cource you be also able to run PBDs).

The sessions and temp directory can exist elsewhere in the filesystem and is related
to the powerbuilder application's name section (see pwe.ini)

Feel free to implement your own (saver) session handling. 

-------------------------------------------------------------------------------------
PDF Generation
-------------------------------------------------------------------------------------
Because of problems with ghostscript on a hosted server (pbwebeasy.org), 
a different approach was used. 

At first, a PS Printer Driver is used to print into a file and after that,
a command will be executed to run ghostscript.

See the pwe.ini for configuration, this should be self-explanatory,

[config]
PSPrintername="HP Color LaserJet PS"
ps2pdf="f:\...\gs\gs8.56\bin\gswin32c.exe ... -sOutputFile=$OUTPUT $INPUT"
ps2png="f:\...\gs\gs8.56\bin\gswin32c.exe ... -sOutputFile=$OUTPUT $INPUT"

-------------------------------------------------------------------------------------
IIS Configuration
-------------------------------------------------------------------------------------
IF you are using IIS you have to setup a virutal /cgi-bin and /pb9webeasy directory.
Also make sure that IIS is configured in pwe.ini
[config]
servertype="IIS"

This is necessary for correct HTTP Header Redirection.

-------------------------------------------------------------------------------------
PB Web Easy Quick Demo Installation                    copyright dwox.com 2006 - 2007
-------------------------------------------------------------------------------------