Commit | Line | Data |
4d583dd8 |
1 | =head1 NAME |
2 | |
64ccd8a8 |
3 | Catalyst::Manual::Installation::CentOS4 - Catalyst Installation on CentOS 4 |
4d583dd8 |
4 | |
5 | |
6 | |
7 | =head1 DESCRIPTION |
8 | |
64ccd8a8 |
9 | This document provides directions on how to install CentOS 4 (a rebuild |
10 | of RedHat Enterprise 4) and then install Catalyst. |
4d583dd8 |
11 | |
64ccd8a8 |
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. |
4d583dd8 |
15 | |
d645910d |
16 | B<NOTE:> You might want to consult the latest version of this document. It |
17 | is available at: |
18 | L<http://dev.catalyst.perl.org/repos/Catalyst/trunk/Catalyst-Runtime/lib/Catalyst/Manual/Installation/CentOS4.pod> |
19 | |
20 | |
4d583dd8 |
21 | |
22 | =head1 INSTALL CENTOS |
23 | |
64ccd8a8 |
24 | These directions are written for CentOS 4.3 on an i386 machine; however, |
25 | you can substitute other versions as they become available. |
4d583dd8 |
26 | |
27 | |
28 | =over 4 |
29 | |
30 | =item * |
31 | |
64ccd8a8 |
32 | Go to L<http://isoredirect.centos.org/centos/4/isos/i386/> and click the |
33 | nearest mirror. |
4d583dd8 |
34 | |
35 | =item * |
36 | |
37 | Download C<CentOS-4.3-i386-bin1of4.iso> (you only need the first disk). |
38 | |
39 | =item * |
40 | |
41 | Burn the .iso to CD. |
42 | |
43 | =item * |
44 | |
45 | Insert the CD into your machine and power it up. |
46 | |
47 | =item * |
48 | |
49 | Hit C<Enter> at the C<boot:> prompt. |
50 | |
51 | =item * |
52 | |
64ccd8a8 |
53 | CD media test: you can either select C<OK> or C<Skip> depending on |
54 | whether or not you trust your burn. |
4d583dd8 |
55 | |
56 | =item * |
57 | |
64ccd8a8 |
58 | The installation GUI should start. Click next at the "Welcome to |
59 | CentOS-4" screen. |
4d583dd8 |
60 | |
61 | =item * |
62 | |
63 | Select a language and click C<Next>. |
64 | |
65 | =item * |
66 | |
67 | Select a keyboard configuration and click C<Next>. |
68 | |
69 | =item * |
70 | |
71 | Select C<Custom> for the installation type and click C<Next>. |
72 | |
73 | =item * |
74 | |
64ccd8a8 |
75 | Leave C<Automatically partition> selected on the C<Disk Partitioning |
76 | Setup> and click C<Next>. |
4d583dd8 |
77 | |
78 | =item * |
79 | |
64ccd8a8 |
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>. |
4d583dd8 |
83 | |
84 | =item * |
85 | |
86 | Click C<Yes> at the C<Are you sure you want to do this?> warning. |
87 | |
88 | =item * |
89 | |
90 | Click C<Next> on the C<Boot Loader Configuration> screen. |
91 | |
92 | =item * |
93 | |
94 | Update the C<Network Configuration> screen as necessary and click C<Next>. |
95 | |
96 | =item * |
97 | |
64ccd8a8 |
98 | Check C<Remote Login (SSH)> and click C<Next> on the C<Firewall |
99 | Configuration> screen. |
4d583dd8 |
100 | |
101 | =item * |
102 | |
103 | Select additional languages as necessary. Click C<Next>. |
104 | |
105 | =item * |
106 | |
107 | Select the appropriate time zone and click C<Next>. |
108 | |
109 | =item * |
110 | |
111 | Enter a root password and click C<Next>. |
112 | |
113 | =item * |
114 | |
64ccd8a8 |
115 | Scroll to the bottom of the C<Package Group Selection> screen and check |
116 | C<Minimal> (the last option). Click C<Next>. |
4d583dd8 |
117 | |
118 | =item * |
119 | |
120 | Click C<Next> at the C<About to Install> screen. |
121 | |
122 | =item * |
123 | |
64ccd8a8 |
124 | The installation will prepare the hard drive and then install the |
125 | required rpm packages. |
4d583dd8 |
126 | |
127 | =item * |
128 | |
129 | Once the installation completes, remove the CD and click C<Reboot>. |
130 | |
131 | =item * |
132 | |
64ccd8a8 |
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): |
4d583dd8 |
136 | |
137 | -A RH-Firewall-1-INPUT -m state --state NEW -m tcp -p tcp --dport 3000 -j ACCEPT |
138 | |
64ccd8a8 |
139 | This will allow Catalyst to make use of port 3000 (the default for the |
140 | development server). |
4d583dd8 |
141 | |
64ccd8a8 |
142 | Type C<service iptables restart> to restart the iptables firewall using |
143 | the updated configuration. |
4d583dd8 |
144 | |
145 | =item * |
146 | |
64ccd8a8 |
147 | Type C<yum -y update> to retrieve the latest patches. |
4d583dd8 |
148 | |
149 | =back |
150 | |
151 | |
152 | =head1 INSTALL CATALYST |
153 | |
154 | =over 4 |
155 | |
156 | =item * |
157 | |
97ed9466 |
158 | Type C<yum -y install gcc expat-devel sqlite3> to install several |
64ccd8a8 |
159 | packages used by Catalyst. |
4d583dd8 |
160 | |
161 | =item * |
162 | |
163 | Type the following: |
164 | |
165 | perl -MCPAN -e shell |
166 | |
167 | ... |
168 | |
169 | Are you ready for manual configuration? [yes] n |
170 | |
171 | ... |
172 | |
173 | cpan shell -- CPAN exploration and modules installation (v1.7601) |
174 | ReadLine support available (try 'install Bundle::CPAN') |
315ba149 |
175 | |
4d583dd8 |
176 | cpan> force install Module::Build |
177 | |
178 | ... |
179 | |
180 | cpan> quit |
181 | |
182 | =item * |
183 | |
64ccd8a8 |
184 | Type C<wget http://www.shadowcatsystems.co.uk/static/cat-install> to |
185 | retrieve a copy of the C<cat-install> script. |
4d583dd8 |
186 | |
187 | =item * |
188 | |
64ccd8a8 |
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): |
4d583dd8 |
192 | |
fcf42995 |
193 | install('Catalyst::Devel'); |
315ba149 |
194 | install('ExtUtils::ParseXS'); |
97ed9466 |
195 | install('Digest::SHA1'); |
315ba149 |
196 | install('Digest::SHA'); |
4d583dd8 |
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'); |
315ba149 |
210 | install('Catalyst::Plugin::HTML::Widget'); |
4d583dd8 |
211 | install('Catalyst::Model::DBIC::Schema'); |
212 | install('Catalyst::View::TT'); |
213 | install('Test::WWW::Mechanize::Catalyst'); |
315ba149 |
214 | install('Test::Pod'); |
215 | install('Test::Pod::Coverage'); |
4d583dd8 |
216 | |
217 | =item * |
218 | |
219 | Type C<perl cat-install>. It will take a while to complete. |
220 | |
221 | =back |
222 | |
64ccd8a8 |
223 | You should now have a functioning Catalyst installation with the modules |
224 | and plugins required to run the Catalyst tutorial. |
4d583dd8 |
225 | |
226 | |
227 | =head1 AUTHOR |
228 | |
229 | Kennedy Clark, C<hkclark@gmail.com> |
230 | |
d645910d |
231 | Please report any errors, issues or suggestions to the author. The |
232 | most recent version of the Catlayst Tutorial can be found at |
233 | L<http://dev.catalyst.perl.org/repos/Catalyst/trunk/Catalyst-Runtime/lib/Catalyst/Manual/Tutorial/>. |
4d583dd8 |
234 | |
64ccd8a8 |
235 | Copyright 2006, Kennedy Clark, under Creative Commons License |
236 | (L<http://creativecommons.org/licenses/by-nc-sa/2.5/>). |