NAME

Catalyst::Manual::Installation::CentOS4 - Catalyst Installation on CentOS 4

DESCRIPTION

This document provides directions on how to install CentOS 4 (a rebuild of RedHat Enterprise 4) and then install Catalyst.

If you already have a functioning install of CentOS, RHEL, or a comparable Linux OS, you should be able to skip this first section and go straight to the INSTALL CATALYST section.

INSTALL CENTOS

These directions are written for CentOS 4.3 on an i386 machine; however, you can substitute other versions as they become available.

• Go to http://isoredirect.centos.org/centos/4/isos/i386/ and click the nearest mirror.
• Download CentOS-4.3-i386-bin1of4.iso (you only need the first disk).
• Burn the .iso to CD.
• Insert the CD into your machine and power it up.
• Hit Enter at the boot: prompt.
• CD media test: you can either select OK or Skip depending on whether or not you trust your burn.
• The installation GUI should start. Click next at the "Welcome to CentOS-4" screen.
• Select a language and click Next.
• Select a keyboard configuration and click Next.
• Select Custom for the installation type and click Next.
• Leave Automatically partition selected on the Disk Partitioning Setup and click Next.
• Uncheck Review (and modify if needed) the partitions created, but leave the rest of the default settings on the Automatic Partitioning screen. Then click Next.
• Click Yes at the Are you sure you want to do this? warning.
• Click Next on the Boot Loader Configuration screen.
• Update the Network Configuration screen as necessary and click Next.
• Check Remote Login (SSH) and click Next on the Firewall Configuration screen.
• Select additional languages as necessary. Click Next.
• Select the appropriate time zone and click Next.
• Enter a root password and click Next.
• Scroll to the bottom of the Package Group Selection screen and check Minimal (the last option). Click Next.
• Click Next at the About to Install screen.
• The installation will prepare the hard drive and then install the required rpm packages.
• Once the installation completes, remove the CD and click Reboot.
• Type vi /etc/sysconfig/iptables and add the following line as the third to last line of the file (above the -A RH-Firewall-1-INPUT -j REJECT --reject-with icmp-host-prohibited line):

      -A RH-Firewall-1-INPUT -m state --state NEW -m tcp -p tcp --dport 3000 -j ACCEPT

  This will allow Catalyst to make use of port 3000 (the default for the development server).

  Type service iptables restart to restart the iptables firewall using the updated configuration.

• Type yum -y update to retrieve the latest patches.

INSTALL CATALYST

• Type yum -y install gcc expat-devel sqlite3 to install several packages used by Catalyst.
• Type the following:

      perl -MCPAN -e shell
      
      ...
      
      Are you ready for manual configuration? [yes] n
      
      ...
      
      cpan shell -- CPAN exploration and modules installation (v1.7601)
      ReadLine support available (try 'install Bundle::CPAN')
      
      cpan> force install Module::Build
      
      ...
      
      cpan> quit

• Type wget http://www.shadowcatsystems.co.uk/static/cat-install to retrieve a copy of the cat-install script.
• Type vi cat-install to open the installer script, then insert the following lines at the bottom of the file (after the install('Catalyst'); line):

      install('Digest::SHA1');
      install('Class::DBI');
      install('DBIx::Class');
      install('DBIx::Class::HTMLWidget');
      install('Catalyst::Plugin::Session');
      install('Catalyst::Plugin::Session::State::Cookie');
      install('Catalyst::Plugin::Session::Store::FastMmap');
      install('Catalyst::Plugin::Authorization::ACL');
      install('Catalyst::Plugin::Authentication');
      install('Catalyst::Plugin::Authorization::Roles');
      install('Catalyst::Plugin::Authentication::Store::DBIC');
      install('Catalyst::Plugin::DefaultEnd');
      install('Catalyst::Plugin::StackTrace');
      install('Catalyst::Plugin::Dumper');
      install('Catalyst::Model::DBIC::Schema');
      install('Catalyst::View::TT');
      install('Test::WWW::Mechanize::Catalyst');

• Type perl cat-install. It will take a while to complete.

You should now have a functioning Catalyst installation with the modules and plugins required to run the Catalyst tutorial.

AUTHOR

Kennedy Clark, hkclark@gmail.com

Please report any errors, issues or suggestions to the author.

Copyright 2006, Kennedy Clark, under Creative Commons License (http://creativecommons.org/licenses/by-nc-sa/2.5/).

Version: .01