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