PLEXUM X4 Installation Manual

 

Before you begin the installation process, lets go through the installation checklist:

 

Current PLEXUM X4 Release:

 

  1. Make sure the software package you have downloaded is from Plexum.com and is the current release build.

  2. To download a licensed or a 15 day free trial copy click here.

 

Web Server:

 

  1. Minimum of 50 mg of web space.

  2. CGI script capability

  3. Pre-installed PERL 5.005 or newer

  4. Ability to set directory and file permissions

  5. MySQL server 3.23 or newer

  6. Sendmail Program, qmail with sendmail interface or SMTP Mail Server

  7. CronTab (not really required but good to have).

  8. DNS wildcard (only required if  you intend to use Sub-domain Module).

 

MySQL Database:

 

  1. A database with a minimum space of 20 mg.

  2. Must have database Hostname, Database Name, Username and Password.

  3. The database user must have full privileges to: (Lock/Unlock Table, Read/Write, Table Alter, Drop Table).

  4. Chosen database must only be used for PLEXUM X4 installation and contain no dash (-) use underscore (_) instead.

 

Pre-installed PERL Modules:

 

  1. DBI, DBD and mysql.pm, PERL interface to MySQL Server

  2. Digest::MD5

  3. libwww-perl 5.65 or newer

  4. URI.pm

  5. Net::SSLeay.pm for UNIX/LINUX (only required if  you intend to use AutoBill feature).

  6. Net::SSL for Windows (only required if  you intend to use AutoBill feature).

 

Any of the above PERL module can be downloaded from Cpan.org or ActiveState.com web site.

 

NOTE: if your server or web site do not meet the above checklist, please contact your web hosting provider.

 

You are now ready to start the installation!

 

Installation Help!

*************************************

Need help installing the software on your server?

Installation service is available for only $99.

Click here now! To purchase installation.

*************************************

 

Now let’s begin the installation process!

 

Modifying PERL Path:

 

  1. Open the following files named below, modify the PERL path to match your server PERL location,  in most cases, UNIX servers are (#!/usr/bin/perl or #!/usr/local/bin/perl) and Windows is (#!perl), please check with your server administrator.  Files to modify are: plexum.pl, plexum_setup.pl, plexum_task.pl, plexum_IPN.pl, plexum_IIPN.pl, and plexum_SIPN.pl

 

Directory Structures:

   

  1. Create the following directory structure on your server: /cgi-bin/ (if your server already contain a cgi-bin folder, do not create another one) and /plexum/ (plexum directory must be in your document root directory, not in the cgi-bin directory).

  2. Upload all the content in the cgi-bin directory from PLEXUM X4 package to your server /cgi-bin/ directory.

  3. Upload all the content in the plexum directory from PLEXUM X4 package to your server /plexum/ directory.

  4. NOTE: All files except the image files must be uploaded in ASCII Mode and images files in Binary Mode, image files are in the following directories: plexum/images/, plexum/member_img/, plexum/panel_logo/ and plexum/banner/

 

Setting Permissions (CHMOD) UNIX/LINUX server only:

 

  1. chmod all file ending with .pl to 755 (-rwxr-xr-x)

  2. chmod all file ending with .pm to 666 (-rw-rw-rw-)

  3. chmod all file ending with .lib to 666 (-rw-rw-rw-)

  4. chmod all HTML and image files to 666 (-rw-rw-rw-)

  5. chmod all PLEXUM folder to 755 (drwxr-xr-x or -rwxr-xr-x) or 777 (drwxrwxrwx or -rwxrwxrwx)

 

File Location:

 

  1. Files ending with .pl are located in /cgi-bin/ folder.

  2. Files ending with .pm are located in /cgi-bin/PlexumAPIs/ folder.

  3. Files ending with .lib are located in /cgi-bin/PlexumLib/ folder.

  4. HTML and image files are located in /plexum/ folder.

 

Final Installation Process:

 

  1. Run plexum_setup.pl via web browser i.e. http://www.yourdomain.com/cgi-bin/plexum_setup.pl and follow the instructions on the setup page.

  2. Check to make sure that the appropriate paths are in the input fields.

 

To fully setup and configure your system, go to the Quick Start help page.

 

Installation completed!

 

 

How To Handle Installation Error:

 

  1. DBI, DBD or mysql.pm error: please check to  be sure that the required PERL module to connect to MySQL server are properly installed.

  2. MySQL access denied error: make sure you are using the correct database name, username and password.

  3. Can't read or write error: make sure permissions are properly set on files and directories.

  4. If PlexumAPIs::LAPI cannot be loaded: open up plexum_setup.pl and edit line 42, uncomment it and replace the server path in; use lib qw('/usr/localhost/cgi-bin/ /usr/localhost/cgi-bin/PlexumAPIs');

  5. Directory or file not found error: open up plexum_setup.pl and comment out line 50 and un-comment line 51 then replace /usr/localhost/cgi-bin/ with your server cgi-bin path.

 

 

Accessing The Administrative Virtual Back Office:

 

 

NOTE: your default username is admin and password is what you have chosen on the installation setup page.

  

Accessing The Members Control Panel:

 

  

Re-installation

*********************************************

If you are re-installing PLEXUM X4 over an existing installation,

simply delete all PLEXUM X4 files from the cgi-bin and re-upload

from the PLEXUM X4 zip file archive and follow the installation

procedure, just as if you are installing a new copy.

*********************************************