Installing PXN8 Software

(The PXN8 Manual is online at http://sxoop.wordpress.com/pxn8-manual)

Prerequisites

If your webserver is Apache and your Operating System is either Linux or FreeBSD then most likely you will already have all of the required software to use PXN8. To verify that all of the required prerequisites are already present on your machine, try the following commands...

$ perl -MLWP::Simple -e 0
If you get an error like this "Can't locate LWP::Simple in @INC..." then you need to install the 'LWP::Simple' perl module (see next section).

$ perl -MImage::Magick -e 0
If you get an error like this "Can't locate Image::Magick in @INC..." then you need to install ImageMagick (see the ImageMagick section below).

If both of these commands return successfully then you are ready to install and run PXN8. Proceed to the "Installation" section.

Perl 5.8

PXN8 is written in Perl. The target machine should have perl 5.8 installed. Perl comes as standard on Linux and FreeBSD. For windows we recommend using ActiveState's Perl. A commercial license for ActiveState Perl for Windows can be purchased from ActiveState.com.

The following perl modules are required by PXN8...
  1. LWP::Simple

This module may not come as standard on FreeBSD. This module can be installed from the command line using the following command...

perl -MCPAN -e "shell"
> install LWP::Simple

ImageMagick

The latest version (6.2.5) should be installed prior to installing PXN8. ImageMagick can be installed on Linux, FreeBSD and Windows. Installing the Binary Release is recommended. Binary downloads are available from the following location...

http://www.imagemagick.com/www/binary-releases.html

Once Perl and ImageMagick are installed you can verify the installation by issuing the following command...

perl -MImage::Magick -e "print 'OK'"

... If an error occurs then ImageMagick and/or PerlMagick (the Perl API for ImageMagick) may not have been installed correctly.

Apache web server version 1.3 or 2.0

PXN8 uses regular CGI to handle client requests. Ensure that apache is configure to handle perl scripts by adding the following line to httpd.conf...

AddHandler cgi-script .pl

Also, in the DocumentRoot directory entry, ensure that 'ExecCGI' appears on the same line as 'Options'

Options ... ExecCGI ...

...or Microsoft Internet Information Server

For information on Running perl CGI scripts on IIS please refer to the following article...
http://support.microsoft.com/default.aspx?scid=kb;en-us;245225 The preferred method for IIS is to use the Perl.exe executable. There have been reported problems with perliis.dll and loading of Perl modules.

Installation

PXN8 is distributed as a compressed archive. It can be decompressed using the following command on Linux/FreeBSD...

tar -xvzf pxn8.tar.gz

... On windows, decompress the archive using Winzip.

N.B. By default you should change the current working to the webroot folder before executing the tar -xvzf pxn8.tar.gz command. On Linux/Unix/FreeBSD with Apache this will usually be /var/www/html. On Windows with IIS this will usually be c:\inetpub\wwwroot. With Tomcat this will usually be c:\Tomcat\webapps\ROOT. PXN8 assumes that it has been installed in a folder called 'pixenate' in the webroot folder.PXN8 will not overwrite any existing files in the webroot folder.

If you installed PXN8 in a folder other than the webroot you will need to change the PXN8.root javascript variable in the following files...

The decompressed archive will have the following directory structure... 
   pixenate/
        lib/
		      Sxoop/
				      PXN8/
						     plugins/
        javascript/
        styles/
        images/
               samples/
               icons/
        cache/
        themes/
               default/
               slick/
                     images/
               memphis/
                       images/
               toolbar1/
               toolbar2/
               shared/
                      images/

Post Install / Configuration

After unzipping the pxn8.tar.gz file you might need to change the permissions on the pixenate/cache/ folder.

The permissions for the pixenate/cache/ folder should be drwxrwxrwx (Everyone should be able to write to the folder - PXN8 stores working images in this folder).

Run the following command ...
ls -la pixenate/
To ensure that the cache folder has the correct permissions.

By default, PXN8 does not support saving the image to the server because each customer stores photos in different locations. If you want your users to be able to save images to your server's gallery then you will need to add this feature.

Trying it out...

You can try out PXN8 by going to any of the following URLs...

If you have any problems please email walterh@rocketmail.com.