view release on metacpan or  search on metacpan

docs/Install.pod  view on Meta::CPAN

  <Location /cpanxr>
   PerlHandler CPANXR::Apache
   SetHandler  perl-script
  </Location>
 </VirtualHost>

=head2 Installing the HTML files

 % cp -R setup/html /var/www/cpanxr.mycompany.com
 % chmod -R 755 /var/www/cpanxr.mycompany.com
 % chown nobody:nogroup /var/www/cpanxr.mycompany

Change the path I</var/www/cpanxr.mycompany.com> to whatever you specified in your httpd.conf. Change nobody:nogroup to the user and group that apache is configured to runs as.

=head2 Installing and configuring the config file

 % cp setup/conf/cpanxr.conf /etc
 
Now, open I</etc/cpanxr.conf> and change to configuration to match your host. If your Apache runs under chroot, it is probablly wise to put XrRoot under the DocumentRoot.

=head2 Put some distributions in the XrRoot directory

The following assumes you have downloaded some Acme- modules and unpacked them into /var/cpan/

 % cp -R /var/cpan/Acme-* /var/cpanxr/dists/
 % chmod -R 755 /var/cpanxr/dists/
 % chown -R nobody:nogroup /var/cpanxr/dists

=head2 Install the database

 % mysql -uroot -p < setup/setup-mysql.sql

Will create a database named B<cpanxr>.

=head2 Run the indexer