Update revision numbers in 'svn co' commands.
[catagits/Catalyst-Runtime.git] / lib / Catalyst / Manual / Installation / CentOS4.pod
index 1b12864..e0619c8 100644 (file)
@@ -1,26 +1,36 @@
 =head1 NAME
 
-Catalyst::Manual::Installation::CentOS4 – Catalyst Installation on CentOS 4
+Catalyst::Manual::Installation::CentOS4 - Catalyst Installation on CentOS 4
 
 
 
 =head1 DESCRIPTION
 
-This document provides directions on how to install CentOS 4 (a rebuild of RedHat Enterprise 4) and then install Catalyst.
+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 C<INSTALL CATALYST> section.
+
+B<NOTE:> You might want to consult the latest version of this document.  It
+is available at:
+L<http://dev.catalyst.perl.org/repos/Catalyst/trunk/Catalyst-Runtime/lib/Catalyst/Manual/Installation/CentOS4.pod>
 
-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 C<INSTALL CATALYST> section.
 
 
 =head1 INSTALL CENTOS
 
-These directions are written for CentOS 4.3 on an i386 machine; however, you can substitute other versions as they become available.
+These directions are written for CentOS 4.3 on an i386 machine; however,
+you can substitute other versions as they become available.
 
 
 =over 4
 
 =item * 
 
-Go to L<http://isoredirect.centos.org/centos/4/isos/i386/> and click the nearest mirror.
+Go to L<http://isoredirect.centos.org/centos/4/isos/i386/> and click the
+nearest mirror.
 
 =item * 
 
@@ -40,11 +50,13 @@ Hit C<Enter> at the C<boot:> prompt.
 
 =item * 
 
-CD media test: you can either select C<OK> or C<Skip> depending on whether or not you trust your burn.
+CD media test: you can either select C<OK> or C<Skip> depending on
+whether or not you trust your burn.
 
 =item * 
 
-The installation GUI should start.  Click next at the "Welcome to CentOS-4" screen.
+The installation GUI should start.  Click next at the "Welcome to
+CentOS-4" screen.
 
 =item * 
 
@@ -60,11 +72,14 @@ Select C<Custom> for the installation type and click C<Next>.
 
 =item * 
 
-Leave C<Automatically partition> selected on the C<Disk Partitioning Setup> and click C<Next>.
+Leave C<Automatically partition> selected on the C<Disk Partitioning
+Setup> and click C<Next>.
 
 =item * 
 
-Uncheck C<Review (and modify if needed) the partitions created>, but leave the rest of the default settings on the C<Automatic Partitioning> screen.  Then click C<Next>.
+Uncheck C<Review (and modify if needed) the partitions created>, but
+leave the rest of the default settings on the C<Automatic Partitioning>
+screen.  Then click C<Next>.
 
 =item * 
 
@@ -80,7 +95,8 @@ Update the C<Network Configuration> screen as necessary and click C<Next>.
 
 =item * 
 
-Check C<Remote Login (SSH)> and click C<Next> on the C<Firewall Configuration> screen.
+Check C<Remote Login (SSH)> and click C<Next> on the C<Firewall
+Configuration> screen.
 
 =item * 
 
@@ -96,7 +112,8 @@ Enter a root password and click C<Next>.
 
 =item * 
 
-Scroll to the bottom of the C<Package Group Selection> screen and check C<Minimal> (the last option).  Click C<Next>.
+Scroll to the bottom of the C<Package Group Selection> screen and check
+C<Minimal> (the last option).  Click C<Next>.
 
 =item * 
 
@@ -104,7 +121,8 @@ Click C<Next> at the C<About to Install> screen.
 
 =item * 
 
-The installation will prepare the hard drive and then install the required rpm packages.
+The installation will prepare the hard drive and then install the
+required rpm packages.
 
 =item * 
 
@@ -112,17 +130,21 @@ Once the installation completes, remove the CD and click C<Reboot>.
 
 =item * 
 
-Type C<vi /etc/sysconfig/iptables> and add the following line as the third to last line of the file (I<above> the C<-A RH-Firewall-1-INPUT -j REJECT --reject-with icmp-host-prohibited> line):
+Type C<vi /etc/sysconfig/iptables> and add the following line as the
+third to last line of the file (I<above> the C<-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).
+This will allow Catalyst to make use of port 3000 (the default for the
+development server).
 
-Type C<service iptables restart> to restart the iptables firewall using the updated configuration.
+Type C<service iptables restart> to restart the iptables firewall using
+the updated configuration.
 
 =item * 
 
-Type C<yum –y update> to retrieve the latest patches.
+Type C<yum -y update> to retrieve the latest patches.
 
 =back
 
@@ -133,7 +155,8 @@ Type C<yum 
 
 =item * 
 
-Type <yum -y install gcc expat-devel sqlite3> to install several packages used by Catalyst.
+Type C<yum -y install gcc expat-devel sqlite3> to install several
+packages used by Catalyst.
 
 =item * 
 
@@ -149,7 +172,7 @@ Type the following:
     
     cpan shell -- CPAN exploration and modules installation (v1.7601)
     ReadLine support available (try 'install Bundle::CPAN')
-    
+        
     cpan> force install Module::Build
     
     ...
@@ -158,12 +181,19 @@ Type the following:
 
 =item * 
 
-Type C<wget http://www.shadowcatsystems.co.uk/static/cat-install> to retrieve a copy of the C<cat-install> script.
+Type C<wget http://www.shadowcatsystems.co.uk/static/cat-install> to
+retrieve a copy of the C<cat-install> script.
 
 =item * 
 
-Type C<vi cat-install> to open the installer script, then insert the following lines at the bottom of the file (after the C<install('Catalyst');> line):
+Type C<vi cat-install> to open the installer script, then insert the
+following lines at the bottom of the file (after the
+C<install('Catalyst');> line):
 
+    install('Catalyst::Devel');
+    install('ExtUtils::ParseXS');
+    install('Digest::SHA1');
+    install('Digest::SHA');
     install('Class::DBI');
     install('DBIx::Class');
     install('DBIx::Class::HTMLWidget');
@@ -177,9 +207,12 @@ Type C<vi cat-install> to open the installer script, then insert the following l
     install('Catalyst::Plugin::DefaultEnd');
     install('Catalyst::Plugin::StackTrace');
     install('Catalyst::Plugin::Dumper');
+    install('Catalyst::Plugin::HTML::Widget');
     install('Catalyst::Model::DBIC::Schema');
     install('Catalyst::View::TT');
     install('Test::WWW::Mechanize::Catalyst');
+    install('Test::Pod');
+    install('Test::Pod::Coverage');
 
 =item * 
 
@@ -187,17 +220,17 @@ Type C<perl cat-install>.  It will take a while to complete.
 
 =back
 
-You should now have a functioning Catalyst installation with the modules and plugins required to run the Catalyst tutorial.
-
+You should now have a functioning Catalyst installation with the modules
+and plugins required to run the Catalyst tutorial.
 
 
 =head1 AUTHOR
 
 Kennedy Clark, C<hkclark@gmail.com>
 
-Please report any errors, issues or suggestions to the author.
-
-Copyright 2006, Kennedy Clark, under Creative Commons License (L<http://creativecommons.org/licenses/by-nc-sa/2.5/>).
-
-Version: .01
+Please report any errors, issues or suggestions to the author.  The
+most recent version of the Catlayst Tutorial can be found at
+L<http://dev.catalyst.perl.org/repos/Catalyst/trunk/Catalyst-Runtime/lib/Catalyst/Manual/Tutorial/>.
 
+Copyright 2006, Kennedy Clark, under Creative Commons License
+(L<http://creativecommons.org/licenses/by-nc-sa/2.5/>).