App::installguide::hosted 0.964

App::installguide::hosted is a Perl module to instructions on installing the App::Context framework in a web-hosting (non-root) environment.

These are instructions on installing the App::Context framework in a web-hosting (non-root) environment.

ASSUMPTIONS

* You get command line access but not root.
* You have access to a MySQL database engine (and permissions to create at least 3 databases)

SET UP THE CPAN SHELL

Installing software from CPAN into a non-system area requires a little setup.

* Find CPAN/Config.pm and make a local copy of it to MyConfig.pm
* Modify MyConfig.pm to use local directories

The first thing to do is to find CPAN/Config.pm.

> which perl
/usr/bin/perl

Since perl is installed in /usr/bin, the perl libraries are most likely stored in /usr/lib/perl5.

> find /usr/lib/perl5 -name Config.pm -print
/usr/lib/perl5/site_perl/5.8.7/x86_64-linux/Template/Config.pm
/usr/lib/perl5/site_perl/5.8.7/Apache/Admin/Config.pm
/usr/lib/perl5/5.8.5/CPAN/Config.pm
/usr/lib/perl5/5.8.5/Net/Config.pm
/usr/lib/perl5/5.8.7/x86_64-linux/Encode/Config.pm
/usr/lib/perl5/5.8.7/x86_64-linux/Config.pm
/usr/lib/perl5/5.8.7/CPAN/Config.pm
/usr/lib/perl5/5.8.7/Net/Config.pm

Now make a copy of CPAN::Config.

mkdir ~/.cpan
mkdir ~/.cpan/CPAN
cp /usr/lib/perl5/5.8.7/CPAN/Config.pm ~/.cpan/CPAN/MyConfig.pm

Now edit it.

vi ~/.cpan/CPAN/MyConfig.pm

There might be lines like the following.

build_dir => q[/root/.cpan/build],
cpan_home => q[/root/.cpan],
histfile => q[/root/.cpan/histfile],
keep_source_where => q[/root/.cpan/sources],
makepl_arg => q[],
make_install_arg => q[UNINST=1],
mbuildpl_arg => q[],

Change them to something like the following.

build_dir => q[/home/username/.cpan/build],
cpan_home => q[/home/username/.cpan],
histfile => q[/home/username/.cpan/histfile],
keep_source_where => q[/home/username/.cpan/sources],
makepl_arg => q[PREFIX=/home/username],
make_install_arg => q[],
mbuildpl_arg => q[install_base=/home/username],

Then fire up the CPAN shell and install something. Then verify that it installed.

# perl -MCPAN -e shell
cpan> install App::Options
cpan> exit
# find ~/lib -name Options.pm -print
/home/username/lib/perl5/site_perl/5.8.7/App/Options.pm

Yay. Success. We used the CPAN shell to install modules into our private perl library directory.