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.
- Download OpenGuides and extract.
- Create the database - I suggest you follow the cPanel (username_name) conventions for names.
- Create ~/openguides/, ~/openguides/templates/ and ~/openguides/indexes/, -- or something similar. This is where you'll install your guide on your own computer.
- 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).
- 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.
- 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
- Use mysqldump to dump the database schema created by the install. Use > to redirect STDOUT.
- Edit the schema to remove "ENGINE=MyISAM DEFAULT CHARSET=latin1;" from any lines.
- Create your mySQL database and user on your web server, using the same details you used on your own computer.
- Using phpmyadmin import your database dump.
- Your webserver's directory structure should be something like /public_html/templates, /public_html/indexes, etc. Create /public_html/lib/
- 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/
- 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/
- 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.
- Edit your wiki.conf
- Check all your file permissions -- .cgi files should be 755.