Nethence Newdoc Olddoc Lab Your IP BBDock  


Warning: those guides are mostly obsolete, please have a look at the new documentation.

UnixWindowsOracleObsoleteHardwareDIYMechanicsScriptsConfigs

werc web framework install and config
 
 
Introduction
Tested on RHEL5. But it should also work on BSD systems.
 
 
Prerequesites
For "Plan9 from User Space", make sure this package is installed,
rpm -q libXt-devel libXext-devel
Note. otherwise you would get those at build time,
error: X11/IntrinsicP.h: No such file or directory
error: X11/StringDefs.h: No such file or directory
/usr/bin/ld: cannot find -lXext
 
 
Installation
Fetch, deploy and build "Plan9 from User Space" (http://swtch.com/plan9port/),
wget http://swtch.com/plan9port/plan9port.tgz
tar xzf plan9port.tgz
mv plan9/ /usr/local/
cd /usr/local/plan9/
./INSTALL
Note. no need to edit your system PATH, werc has got it built-in.
 
Fetch and deploy werc (http://werc.cat-v.org/download/),
wget http://werc.cat-v.org/download/werc-1.4.0.tar.gz
tar xzf werc-1.4.0.tar.gz
mv werc-1.4.0/ /usr/werc/
 
 
Apache2 configuration
Create an Apache2 virtual host,
cd /etc/httpd/conf.d/
vi werc.example.com.conf
like,
<VirtualHost *>
RewriteEngine On
ServerName werc.example.com
ServerAlias ac.werc.example.com
AddHandler cgi-script .rc
AddHandler cgi-script .cgi
<Directory /usr/werc/bin>
Options ExecCGI
</Directory>
<IfModule mod_dir.c>
DirectoryIndex /werc.rc
</IfModule>
 
RewriteRule (.*) /usr/werc/sites/%{HTTP_HOST}/$1
 
RewriteCond %{REQUEST_FILENAME} !-f
RewriteRule .* /usr/werc/bin/werc.rc
 
RewriteRule /werc.rc /usr/werc/bin/werc.rc
DocumentRoot /usr/werc/bin/
ErrorDocument 404 /werc.rc
</VirtualHost>
note. change werc.example.com accordingly
apply,
service httpd reload
 
If you point your browser to werc.example.com at this point, you'll see werc but with some kind of 404.
 
 
werc configuration
Eventually edit the general settings,
cd /usr/werc/etc/
sed '/^$/d; /^#/d;' initrc > initrc.local
vi initrc.local
 
 
werc site configuration
Create a werc virtual host based the test suite,
cd /usr/werc/sites/
cp -Rp tst.cat-v.org werc.example.com
chown -R apache:wheel werc.example.com/
 
Eventually edit the site settings,
cd /usr/werc/sites/werc.example.com/
cd _werc/
vi config
Ref. http://werc.cat-v.org/docs/config-options
 
Prevent favicon httpd 404 error logs,
cd /usr/werc/sites/werc.example.com/
touch favicon.ico
 
 
Ready to go
Point your browser to your virtual host,
http: //werc.example.com
 
 
References
http://werc.cat-v.org/
http://werc.cat-v.org/docs/
http://swtch.com/plan9port/
http://swtch.com/plan9port/man/man1/install.html
http://werc.cat-v.org/docs/web-server-setup/apache2
 
 
Other references
http://www.gnu.org/software/gawk/manual/gawkinet/html_node/CGI-Lib.html#CGI-Lib
http://thedailywtf.com/Articles/Announcing-APDB-The-Worlds-Fastest-Database.aspx
 

(obsolete, see the new doc)