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.
19 These directions are written for CentOS 4.3 on an i386 machine; however,
20 you can substitute other versions as they become available.
27 Go to L<http://isoredirect.centos.org/centos/4/isos/i386/> and click the
32 Download C<CentOS-4.3-i386-bin1of4.iso> (you only need the first disk).
40 Insert the CD into your machine and power it up.
44 Hit C<Enter> at the C<boot:> prompt.
48 CD media test: you can either select C<OK> or C<Skip> depending on
49 whether or not you trust your burn.
53 The installation GUI should start. Click next at the "Welcome to
58 Select a language and click C<Next>.
62 Select a keyboard configuration and click C<Next>.
66 Select C<Custom> for the installation type and click C<Next>.
70 Leave C<Automatically partition> selected on the C<Disk Partitioning
71 Setup> and click C<Next>.
75 Uncheck C<Review (and modify if needed) the partitions created>, but
76 leave the rest of the default settings on the C<Automatic Partitioning>
77 screen. Then click C<Next>.
81 Click C<Yes> at the C<Are you sure you want to do this?> warning.
85 Click C<Next> on the C<Boot Loader Configuration> screen.
89 Update the C<Network Configuration> screen as necessary and click C<Next>.
93 Check C<Remote Login (SSH)> and click C<Next> on the C<Firewall
94 Configuration> screen.
98 Select additional languages as necessary. Click C<Next>.
102 Select the appropriate time zone and click C<Next>.
106 Enter a root password and click C<Next>.
110 Scroll to the bottom of the C<Package Group Selection> screen and check
111 C<Minimal> (the last option). Click C<Next>.
115 Click C<Next> at the C<About to Install> screen.
119 The installation will prepare the hard drive and then install the
120 required rpm packages.
124 Once the installation completes, remove the CD and click C<Reboot>.
128 Type C<vi /etc/sysconfig/iptables> and add the following line as the
129 third to last line of the file (I<above> the C<-A RH-Firewall-1-INPUT -j
130 REJECT --reject-with icmp-host-prohibited> line):
132 -A RH-Firewall-1-INPUT -m state --state NEW -m tcp -p tcp --dport 3000 -j ACCEPT
134 This will allow Catalyst to make use of port 3000 (the default for the
137 Type C<service iptables restart> to restart the iptables firewall using
138 the updated configuration.
142 Type C<yum -y update> to retrieve the latest patches.
147 =head1 INSTALL CATALYST
153 Type C<yum -y install gcc expat-devel sqlite3> to install several
154 packages used by Catalyst.
164 Are you ready for manual configuration? [yes] n
168 cpan shell -- CPAN exploration and modules installation (v1.7601)
169 ReadLine support available (try 'install Bundle::CPAN')
171 cpan> force install Module::Build
179 Type C<wget http://www.shadowcatsystems.co.uk/static/cat-install> to
180 retrieve a copy of the C<cat-install> script.
184 Type C<vi cat-install> to open the installer script, then insert the
185 following lines at the bottom of the file (after the
186 C<install('Catalyst');> line):
188 install('ExtUtils::ParseXS');
189 install('Digest::SHA1');
190 install('Digest::SHA');
191 install('Class::DBI');
192 install('DBIx::Class');
193 install('DBIx::Class::HTMLWidget');
194 install('Catalyst::Plugin::Session');
195 install('Catalyst::Plugin::Session::State::Cookie');
196 install('Catalyst::Plugin::Session::Store::FastMmap');
197 install('Catalyst::Plugin::Authorization::ACL');
198 install('Catalyst::Plugin::Authentication');
199 install('Catalyst::Plugin::Authorization::Roles');
200 install('Catalyst::Plugin::Authentication::Store::DBIC');
201 install('Catalyst::Plugin::DefaultEnd');
202 install('Catalyst::Plugin::StackTrace');
203 install('Catalyst::Plugin::Dumper');
204 install('Catalyst::Plugin::HTML::Widget');
205 install('Catalyst::Model::DBIC::Schema');
206 install('Catalyst::View::TT');
207 install('Test::WWW::Mechanize::Catalyst');
208 install('Test::Pod');
209 install('Test::Pod::Coverage');
213 Type C<perl cat-install>. It will take a while to complete.
217 You should now have a functioning Catalyst installation with the modules
218 and plugins required to run the Catalyst tutorial.
223 Kennedy Clark, C<hkclark@gmail.com>
225 Please report any errors, issues or suggestions to the author.
227 Copyright 2006, Kennedy Clark, under Creative Commons License
228 (L<http://creativecommons.org/licenses/by-nc-sa/2.5/>).