Content-type: text/html Installation Instructions for UNIX

Home
WebGroove is no longer supported. These docs are reference only.


Installation Instructions for UNIX
The following instructions come with the distribution.

INSTALLING WebGroove
--------------------

First, follow these easy steps:

1. Unpack the WebGroove archive into a directory of your choice.
   'VERSION' will be something like '2.02-linux-mysql'.

   gunzip -c webgroove-VERSION.tgz | tar xvf -

2. Configure the build for your system.

   perl Makefile.PL

   For a list of configuration options append --help

3. Build everything (*)

   make

   (*) This assumes a version of make that supports the -C flag.  GNU
   make supports this.

4. Install it all

   make install

5. View the intro page at http://localhost/webgroove/introduction.html


INSTALLING DATABASE MODULE
--------------------------

If you already have the Msql-Mysql-modules from CPAN installed on your
system, you're already set to go.  If not, it is included in this
archive under the 'Msql-Mysql-modules-' subdirectory.  Follow
the instructions in that directory to install these modules.  If you
have an older version of the database modules, we recommend that you
upgrade to the version included.

This does assume that you already have either mSQL, MySQL, or both
installed on your system.  You can get them at these URLs:

MySQL: http://www.tcx.se/
mSQL:  http://www.hughes.com.au/

CONFIGURING APACHE
------------------

Just add these lines to your srm.conf:

Action webgroove-agent /cgi-bin/webgroove/wga
AddHandler webgroove-agent .wga
Action webgroove-compiler /cgi-bin/webgroove/wgc
AddHandler webgroove-compiler .wgp

Of course, change /cgi-bin/webgroove to your installation path if it's
different.  If you installed to a directory outside of the web tree, you
will need to create some links within the web tree for both 'wga' and
'wgc'.  The web path to these links is what you would use in these Apache
directives.

CONFIGURING OTHER WEB SERVERS
-----------------------------

In short, you need to map the extension '.wga' to the 'wga' executable
and '.wgp' to the 'wgc' executable.  These types of mappings are often
called filters.  If you successfully configure WebGroove to run on
a web server not listed in this document, please email your configuration
notes to support@webgroove.com so it can be included in future releases.

WEBGROOVE LIBRARY
-----------------

In some rare cases, you may need to help WebGroove find it's macro
library.  You can do so by setting the environment variable WGROOT to
the main WebGroove installation directory which contains the 'lib'
directory.  You can also define the compiler token //lib/ within a
WebGroove project to override the default library path.

DOCUMENTATION??
---------------

Visit our web site at http://www.webgroove.com/ for online documentation,
macros, and more.

$Revision: 1.3 $ $Date: 1998/08/05 20:52:49 $


Up To
Installing on UNIX


WebGroove® is a registered trademark of Creativision Publishing Corporation