3 Catalyst::Manual::Installation::CentOS4 - Catalyst Installation on CentOS 4
9 This document provides directions on how to install CentOS 4 (a rebuild
10 of RedHat Enterprise 4) and then install Catalyst.
12 If you already have a functioning install of CentOS, RHEL, or a
13 comparable Linux OS, you should be able to skip this first section and
14 go straight to the C<INSTALL CATALYST> section.
16 B<NOTE:> You might want to consult the latest version of this document. It
18 L<http://dev.catalyst.perl.org/repos/Catalyst/trunk/Catalyst-Runtime/lib/Catalyst/Manual/Installation/CentOS4.pod>
24 These directions are written for CentOS 4.3 on an i386 machine; however,
25 you can substitute other versions as they become available.
32 Go to L<http://isoredirect.centos.org/centos/4/isos/i386/> and click the
37 Download C<CentOS-4.3-i386-bin1of4.iso> (you only need the first disk).
45 Insert the CD into your machine and power it up.
49 Hit C<Enter> at the C<boot:> prompt.
53 CD media test: you can either select C<OK> or C<Skip> depending on
54 whether or not you trust your burn.
58 The installation GUI should start. Click next at the "Welcome to
63 Select a language and click C<Next>.
67 Select a keyboard configuration and click C<Next>.
71 Select C<Custom> for the installation type and click C<Next>.
75 Leave C<Automatically partition> selected on the C<Disk Partitioning
76 Setup> and click C<Next>.
80 Uncheck C<Review (and modify if needed) the partitions created>, but
81 leave the rest of the default settings on the C<Automatic Partitioning>
82 screen. Then click C<Next>.
86 Click C<Yes> at the C<Are you sure you want to do this?> warning.
90 Click C<Next> on the C<Boot Loader Configuration> screen.
94 Update the C<Network Configuration> screen as necessary and click C<Next>.
98 Check C<Remote Login (SSH)> and click C<Next> on the C<Firewall
99 Configuration> screen.
103 Select additional languages as necessary. Click C<Next>.
107 Select the appropriate time zone and click C<Next>.
111 Enter a root password and click C<Next>.
115 Scroll to the bottom of the C<Package Group Selection> screen and check
116 C<Minimal> (the last option). Click C<Next>.
120 Click C<Next> at the C<About to Install> screen.
124 The installation will prepare the hard drive and then install the
125 required rpm packages.
129 Once the installation completes, remove the CD and click C<Reboot>.
133 Type C<vi /etc/sysconfig/iptables> and add the following line as the
134 third to last line of the file (I<above> the C<-A RH-Firewall-1-INPUT -j
135 REJECT --reject-with icmp-host-prohibited> line):
137 -A RH-Firewall-1-INPUT -m state --state NEW -m tcp -p tcp --dport 3000 -j ACCEPT
139 This will allow Catalyst to make use of port 3000 (the default for the
142 Type C<service iptables restart> to restart the iptables firewall using
143 the updated configuration.
147 Type C<yum -y update> to retrieve the latest patches.
152 =head1 INSTALL CATALYST
158 Type C<yum -y install gcc expat-devel sqlite3> to install several
159 packages used by Catalyst.
169 Are you ready for manual configuration? [yes] n
173 cpan shell -- CPAN exploration and modules installation (v1.7601)
174 ReadLine support available (try 'install Bundle::CPAN')
176 cpan> force install Module::Build
184 Type C<wget http://www.shadowcatsystems.co.uk/static/cat-install> to
185 retrieve a copy of the C<cat-install> script.
189 Type C<vi cat-install> to open the installer script, then insert the
190 following lines at the bottom of the file (after the
191 C<install('Catalyst');> line):
193 install('Catalyst::Devel');
194 install('ExtUtils::ParseXS');
195 install('Digest::SHA1');
196 install('Digest::SHA');
197 install('Class::DBI');
198 install('DBIx::Class');
199 install('DBIx::Class::HTMLWidget');
200 install('Catalyst::Plugin::Session');
201 install('Catalyst::Plugin::Session::State::Cookie');
202 install('Catalyst::Plugin::Session::Store::FastMmap');
203 install('Catalyst::Plugin::Authorization::ACL');
204 install('Catalyst::Plugin::Authentication');
205 install('Catalyst::Plugin::Authorization::Roles');
206 install('Catalyst::Plugin::Authentication::Store::DBIC');
207 install('Catalyst::Plugin::DefaultEnd');
208 install('Catalyst::Plugin::StackTrace');
209 install('Catalyst::Plugin::Dumper');
210 install('Catalyst::Plugin::HTML::Widget');
211 install('Catalyst::Model::DBIC::Schema');
212 install('Catalyst::View::TT');
213 install('Test::WWW::Mechanize::Catalyst');
214 install('Test::Pod');
215 install('Test::Pod::Coverage');
219 Type C<perl cat-install>. It will take a while to complete.
223 You should now have a functioning Catalyst installation with the modules
224 and plugins required to run the Catalyst tutorial.
229 Kennedy Clark, C<hkclark@gmail.com>
231 Please report any errors, issues or suggestions to the author. The
232 most recent version of the Catalyst Tutorial can be found at
233 L<http://dev.catalyst.perl.org/repos/Catalyst/trunk/Catalyst-Runtime/lib/Catalyst/Manual/Tutorial/>.
235 Copyright 2006, Kennedy Clark, under Creative Commons License
236 (L<http://creativecommons.org/licenses/by-nc-sa/2.5/>).