Index: doc-rnd/misc/install_cgi.html =================================================================== --- doc-rnd/misc/install_cgi.html (nonexistent) +++ doc-rnd/misc/install_cgi.html (revision 758) @@ -0,0 +1,45 @@ + + +

Installation of the footprint CGIs

system requirements, 3rd party software

+ The following software needs to be installed on the system + that will host the scripts: +

/bin/bash (did not test with POSIX shell) +
awk (tested with gawk, may work with other modern implementation) +
common binutils, e.g. ls, find +
animator, the svn HEAD version; NOTE: it is possible to manually compile animator into a static executable (useful on dedicated web servers) +
a web server that can execute plain old CGI scripts +
a full checkout of pcb-rnd/trunk from svn://repo.hu/pcb-rnd/trunk +

+ +

Installation

+Since the CGIs are just demo scripts for repo.hu and are not really installed +anywhere else normally, there is no install script but a manual installation +process. For both the parametric and the static footprint CGI: +

check out pcb-rnd/trunk in a directory readable (but not writable) by www-data (or whatever user the CGI will run with) +
copy the config file pcblib.cgi.conf from pcb-rnd/trunk/util to /etc +
edit the config file; ignore setting sdir for now +
hardlink, copy, or wrap the cgi files from under pcb-rnd/trunk/util into the web server's CGI directory +

+For the static footprint CGI (set up the map cache): +

cd to trunk/util/pcblib-map in the checkout and run make - NOTE: some awk scripts have hardwired CGI paths yet (TODO) +
copy this directory to a web-accessible directory +
set sdir to the absolute path of the web-accessible copy in /etc/pcblib.cgi.conf +

+ +

Tips and tricks

cgi wrapping

+Making the checkout directly into the cgi-bin dir is not a good idea. Using +a hard link on each CGI between the checkout and the cgi-bin dir is better, +but an svn up will silently break the link leaving the old version live. +The most stable solution is placing a wrapper script in the cgi-bin dir: +

+#!/bin/bash
+. /full/path/to/the/checkout/util/pcblib-param.cgi
+

+ +