3 Catalyst::Manual::Installation::CentOS4 Catalyst Installation on CentOS 4
9 This document provides directions on how to install CentOS 4 (a rebuild of RedHat Enterprise 4) and then install Catalyst.
11 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.
16 These directions are written for CentOS 4.3 on an i386 machine; however, you can substitute other versions as they become available.
23 Go to L<http://isoredirect.centos.org/centos/4/isos/i386/> and click the nearest mirror.
27 Download C<CentOS-4.3-i386-bin1of4.iso> (you only need the first disk).
35 Insert the CD into your machine and power it up.
39 Hit C<Enter> at the C<boot:> prompt.
43 CD media test: you can either select C<OK> or C<Skip> depending on whether or not you trust your burn.
47 The installation GUI should start. Click next at the "Welcome to CentOS-4" screen.
51 Select a language and click C<Next>.
55 Select a keyboard configuration and click C<Next>.
59 Select C<Custom> for the installation type and click C<Next>.
63 Leave C<Automatically partition> selected on the C<Disk Partitioning Setup> and click C<Next>.
67 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>.
71 Click C<Yes> at the C<Are you sure you want to do this?> warning.
75 Click C<Next> on the C<Boot Loader Configuration> screen.
79 Update the C<Network Configuration> screen as necessary and click C<Next>.
83 Check C<Remote Login (SSH)> and click C<Next> on the C<Firewall Configuration> screen.
87 Select additional languages as necessary. Click C<Next>.
91 Select the appropriate time zone and click C<Next>.
95 Enter a root password and click C<Next>.
99 Scroll to the bottom of the C<Package Group Selection> screen and check C<Minimal> (the last option). Click C<Next>.
103 Click C<Next> at the C<About to Install> screen.
107 The installation will prepare the hard drive and then install the required rpm packages.
111 Once the installation completes, remove the CD and click C<Reboot>.
115 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):
117 -A RH-Firewall-1-INPUT -m state --state NEW -m tcp -p tcp --dport 3000 -j ACCEPT
119 This will allow Catalyst to make use of port 3000 (the default for the development server).
121 Type C<service iptables restart> to restart the iptables firewall using the updated configuration.
125 Type C<yum y update> to retrieve the latest patches.
130 =head1 INSTALL CATALYST
136 Type <yum -y install gcc expat-devel sqlite3> to install several packages used by Catalyst.
146 Are you ready for manual configuration? [yes] n
150 cpan shell -- CPAN exploration and modules installation (v1.7601)
151 ReadLine support available (try 'install Bundle::CPAN')
153 cpan> force install Module::Build
161 Type C<wget http://www.shadowcatsystems.co.uk/static/cat-install> to retrieve a copy of the C<cat-install> script.
165 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):
167 install('Class::DBI');
168 install('DBIx::Class');
169 install('DBIx::Class::HTMLWidget');
170 install('Catalyst::Plugin::Session');
171 install('Catalyst::Plugin::Session::State::Cookie');
172 install('Catalyst::Plugin::Session::Store::FastMmap');
173 install('Catalyst::Plugin::Authorization::ACL');
174 install('Catalyst::Plugin::Authentication');
175 install('Catalyst::Plugin::Authorization::Roles');
176 install('Catalyst::Plugin::Authentication::Store::DBIC');
177 install('Catalyst::Plugin::DefaultEnd');
178 install('Catalyst::Plugin::StackTrace');
179 install('Catalyst::Plugin::Dumper');
180 install('Catalyst::Model::DBIC::Schema');
181 install('Catalyst::View::TT');
182 install('Test::WWW::Mechanize::Catalyst');
186 Type C<perl cat-install>. It will take a while to complete.
190 You should now have a functioning Catalyst installation with the modules and plugins required to run the Catalyst tutorial.
196 Kennedy Clark, C<hkclark@gmail.com>
198 Please report any errors, issues or suggestions to the author.
200 Copyright 2006, Kennedy Clark, under Creative Commons License (L<http://creativecommons.org/licenses/by-nc-sa/2.5/>).