Installing OpenGuides on cPanel

This doc assumes OpenGuides v0.56, cPanel X, and a shell account and mySQL database on a separate *nix machine. It also assumes very basic knowledge of Perl/CPAN, and linux knowledge.

  1. Download OpenGuides and extract.
  2. Create the database - I suggest you follow the cPanel (username_name) conventions for names.
  3. Create ~/openguides/, ~/openguides/templates/ and ~/openguides/indexes/, -- or something similar. This is where you'll install your guide on your own computer.
  4. Make sure you have all the prerequisites installed on both boxes. (All good hosts will install any needed modules for you, if they won't, this isn't a problem. Just download the tarballs, we'll upload these later).
  5. You should now be able to go through the build commands as documented in the INSTALL file. In the install paths, use the directory structure you created in step 3.
  6. If all went well, upload the resulting files to your webserver. I recommend entering ~/openguides and using zip -r to compress them into one file. Make sure you include .htaccess
  7. Use mysqldump to dump the database schema created by the install. Use > to redirect STDOUT.
  8. Edit the schema to remove "ENGINE=MyISAM DEFAULT CHARSET=latin1;" from any lines.
  9. Create your mySQL database and user on your web server, using the same details you used on your own computer.
  10. Using phpmyadmin import your database dump.
  11. Your webserver's directory structure should be something like /public_html/templates, /public_html/indexes, etc. Create /public_html/lib/
  12. Now to install the missing libraries. Untar any modules you needed to download, and grab the lib directorie structures and .PM files. Use zip to upload these into /public_html/lib/
  13. Go into the OpenGuides tarball (the one you downloaded), and grab the lib/ directory. You'll need those modules. Put them into /public_html/lib/
  14. Edit all the .cgi files on your webserver, and add the two lines below the #!/usr/bin/perl: 
     use CGI::Carp qw( fatalsToBrowser );
 use lib "lib";
    This will make your browser output any errors you may get, and tell the server to look for any modules in your new directory.
  15. Edit your wiki.conf
  16. Check all your file permissions -- .cgi files should be 755.