How to install GDWGraph.

Requirements.

To use this module you must have already installed:

• The GD Library
• The GD::Graph Perl module
• Optionally, to use 3D graphs, the GD::Graph3d Perl module

Note for Windows users.

This module has been tested under Windows 2000 with IIS4 and ActivePerl 5.8.1 but should work with other versions. To install GD library using the ppm (ActiveState Perl Package Manager) you must remember that this module currently isn't available in the ActiveState PPM repository. To install it you must usean external repository (includes GD library dll).

01. Add the externl repository to your repositories list:

    C:> ppm repository add http://theoryx5.uwinnipeg.ca/ppms/

02. Install GD module:

    C:> ppm install GD

03. Install the pre-requisite GD::TextUtil:

    C:> ppm install GDTextUtil

04. Install the GD::Graph module:

    C:> ppm install GDGraph

05. Optionally install the GD::Graph3d module:

    C:> ppm install GD-Graph3d

Install GDWGraph.

01. Download the package source here:

    root@devel# wget .../GDWGraph-xx-yy-zz.tar.gz

02. Enter into you WebGUI root directory (default is /data/WebGUI)

    root@devel# cd /data/WebGUI

03. Extract GDWGraph into this directory

    root@devel# tar zxvf /dir/where/you/saved/GDWGraph.xx.yy.zz.tar.gz

These files will be installed:

• read1st-GDWGraph.txt

• docs/GDWGraph/create.sql

• docs/GDWGraph/create_01_pre_06_01.sql

• docs/GDWGraph/install.txt

• docs/GDWGraph/readme.txt

• docs/GDWGraph/uninstall.sql

• docs/GDWGraph/changelog/00.xx.xx.txt

• docs/GDWGraph/upgrades/upgrade_00.00.04_00.00.05.sql

• lib/WebGUI/Wobject/GDWGraph.pm

• lib/WebGUI/i8n/English/GDWGraph.pm

• lib/WebGUI/i8n/Italian/GDWGraph.pm

04. Execute sql query script (change the WebGUI database name to your database name)

    root@devel# mysql -p WebGUI < docs/GDWGraph/create.sql

05. If your WebGUI version is prior than 06.01.xx you must also execute this script

    root@devel# mysql -p WebGUI < docs/GDWGraph/create_01_pre_06_01.sql

06. Edit WebGUI.conf file to add GDWGraph module to Wobject list

    root@devel# vi /data/WebGUI/etc/WebGUI.conf

    ...
    wobjects = Article, EventsCalendar, ExtraColumn, FAQ, FileManager, \
    HttpProxy, Item, LinkList, DataForm, MessageBoard, Poll, Product, \
    SiteMap, SQLReport, Survey, SyndicatedContent, USS, WobjectProxy, \
    GDWGraph
    ...
 

07. Restart web server (this shouldn't be necessary...)

How to upgrade.

01. Extract GDWGraph into your WebGUI directory

    root@devel# tar zxvf /dir/where/you/saved/GDWGraph.xx.yy.zz.tar.gz

02. Execute every sql scripts available in docs/GDWGraph/upgrades from your previous version until current version.

    root@devel# mysql -p WebGUI < docs/GDWGraph/upgrades/.....sql

Uninstall GDWGraph

01. Delete all GDWGraph elements from your site pages

02. Execute uninstall.sql script

    root@devel# mysql -p WebGUI < docs/GDWGraph/uninstall.sql

03. Delete every file listed in read1st-GDWGraph.txt file