Changeset 4921
- Timestamp:
- Aug 30, 2005, 4:07:13 PM (21 years ago)
- Location:
- trunk
- Files:
-
- 2 edited
-
Nebulous-Server/docs/setup.txt (modified) (8 diffs)
-
Nebulous/docs/setup.txt (modified) (8 diffs)
Legend:
- Unmodified
- Added
- Removed
-
trunk/Nebulous-Server/docs/setup.txt
r4889 r4921 5 5 =head2 Create a UNIX group for Nebulous 6 6 7 All Nebulous user's need to be in the same UNIX group as the Nebulous server. 8 7 9 groupadd -g 877 nebulous 8 10 … … 15 17 usermod -G nebulous foouser 16 18 19 =head2 Setup directory permissions for the nebulous group 20 21 As root: 22 23 mkdir /po01/nebulous 24 mkdir /po02/nebulous 25 mkdir /po03/nebulous 26 mkdir /po04/nebulous 27 chown nobody:nebulous /po0?/nebulous 28 chmod 0770 /po0?/nebulous 29 17 30 =head2 Build and install the Nebulous Perl modules (see: README) 18 31 19 32 =head2 Create and initialize the database (see: docs/database_setup.txt) 20 33 21 =head2 Install Apache with mod_perl 22 23 Nebulous will work with both Apache 1.3 & 2.x. 34 =head2 Install Apache2 with mod_perl 35 36 =head3 Minimum software requirements: 37 38 Nebulous will work with both Apache 1.3 & 2.x. However, this guide will only 39 cover configuraton with Apache 2.x and mod_perl 2.x. 40 41 =over 4 42 43 =item * Apache2 >= 2.0.54 44 45 =item * mod_perl >= 2.0.0 46 47 =item * Apache::DBI >= '0.97' [*] 48 49 =back 50 51 [*] required for connect_on_init() to work under mod_perl >= 2.0.1 24 52 25 53 =head3 Apache 1.x … … 33 61 =head3 Apache 2.x 34 62 35 To use Nebulous with Apache2 you must have Apache2 >= 2.0.54 and mod_perl >=36 2.0.037 38 Apache::DBI >= '0.97' is required for connect_on_init() to work under mod_perl >= 2.0.139 40 63 =head4 removing Apache on RHEl3 64 65 On RHEL3 I had to remove these packages in order to fully remove MySQL. 41 66 42 67 As C<root>: … … 96 121 cd .. 97 122 123 =head4 installing mod_perl 2.x 124 98 125 tar -zxvf mod_perl-2.0.1.tar.gz 99 126 cd mod_perl-2.0.1 … … 109 136 Syntax OK 110 137 111 =head3 Common Apache Setup 138 =head4 installing and configuring Nebulous 139 140 tar -zvxf Nebulous-0.01.tar.gz 141 cd Nebulous-0.01 142 perl Build.PL -axps /usr/sbin/apxs 143 ./Build 144 ./Build test 145 su 146 ./Build install 147 148 149 vi /etc/apache2/conf/startup.pl 150 (change Group to "Group nebulous") 151 152 cp fooconf /etc/apache2/conf/startup.pl 153 echo "PerlPostConfigRequire /etc/apache2/conf/startup.pl" >> /etc/apache2/conf/apache2.conf 154 155 =head4 initilizing the Nebulous server database 156 157 mysql -u root mysql -p 158 (enter your MySQL root password) 159 160 DROP DATABASE IF EXISTS nebulous; 161 CREATE DATABASE nebulous; 162 GRANT ALL PRIVILEGES ON *.* TO 'nebulous'@'localhost' 163 IDENTIFIED BY '@neb@'; 164 FLUSH PRIVILEGES; 165 exit 166 167 export NEB_DB=nebulous 168 export NEB_USER=nebulous 169 export NEB_PASS=@neb@ 170 171 neb-initdb 172 neb-addvol --name po01 --uri file:/po01/nebulous 173 neb-addvol --name po02 --uri file:/po02/nebulous 174 neb-addvol --name po03 --uri file:/po03/nebulous 175 neb-addvol --name po04 --uri file:/po04/nebulous 176 . 177 . 178 179 =head3 configurating Apache to act as a Nebulous/SOAP server 112 180 113 181 =item * add the "nebulous" group to /etc/group 114 182 =item * configure Apache to run as the nebulous group. 115 183 184 cat <<END >> /etc/apache2/conf/apache2.conf 185 <Location /nebulous> 186 SetHandler perl-script 187 PerlResponseHandler Apache2::SOAP 188 PerlSetVar dispatch_to "PerlHandler Nebulous::Server::SOAP" 189 PerlSetVar options "compress_threshold => 10000" 190 </Location> 191 END 192 193 apachectl configtest 194 Syntax OK 116 195 117 196 # out of date from here down... … … 164 243 You can test your configuration with the C<telnet> utility. 165 244 166 telnet localhost 80245 $ telnet localhost 80 167 246 Trying 127.0.0.1... 168 Connected to localhost. 247 Connected to localhost.localdomain (127.0.0.1). 169 248 Escape character is '^]'. 170 GET / cgi-bin/imageserver.plHTTP/1.0171 172 HTTP/1.1 411 Length Required173 Date: Tue, 28 Sep 2004 21:15:58GMT174 Server: Apache/2.0. 49 (Gentoo/Linux)175 Content-Length: 0249 GET /nebulous HTTP/1.0 250 251 HTTP/1.1 500 Internal Server Error 252 Date: Wed, 31 Aug 2005 01:10:47 GMT 253 Server: Apache/2.0.54 (Unix) mod_perl/2.0.1 Perl/v5.8.6 254 Content-Length: 645 176 255 Connection: close 177 Content-Type: text/plain; charset=ISO-8859-1 256 Content-Type: text/html; charset=iso-8859-1 257 . 258 . 178 259 179 260 Connection closed by foreign host. … … 181 262 If you get an HTTP 5xx code check your apache error_log 182 263 183 =head2 Directory Permissions 184 185 mkdir /po01/nebulous 186 chown root:nebulous /po01/nebulous 187 chmod 0770 /po01/nebulous 188 189 =head2 MySQL Configuration 264 265 =head2 MySQL Configuration/tuning 190 266 191 267 in /etc/mysql/my.cnf … … 194 270 max_connections = 200 195 271 272 Nebulous makes heavy use of MySQL's C<innodb> table type. Try configuring 273 MySQL with these parameters: 274 275 innodb_log_files_in_group = 2 276 innodb_buffer_pool_size = as big as possible (512M+) 277 innodb_log_buffer_size= 16M 278 innodb_log_file_size=10M 279 196 280 =cut -
trunk/Nebulous/docs/setup.txt
r4889 r4921 5 5 =head2 Create a UNIX group for Nebulous 6 6 7 All Nebulous user's need to be in the same UNIX group as the Nebulous server. 8 7 9 groupadd -g 877 nebulous 8 10 … … 15 17 usermod -G nebulous foouser 16 18 19 =head2 Setup directory permissions for the nebulous group 20 21 As root: 22 23 mkdir /po01/nebulous 24 mkdir /po02/nebulous 25 mkdir /po03/nebulous 26 mkdir /po04/nebulous 27 chown nobody:nebulous /po0?/nebulous 28 chmod 0770 /po0?/nebulous 29 17 30 =head2 Build and install the Nebulous Perl modules (see: README) 18 31 19 32 =head2 Create and initialize the database (see: docs/database_setup.txt) 20 33 21 =head2 Install Apache with mod_perl 22 23 Nebulous will work with both Apache 1.3 & 2.x. 34 =head2 Install Apache2 with mod_perl 35 36 =head3 Minimum software requirements: 37 38 Nebulous will work with both Apache 1.3 & 2.x. However, this guide will only 39 cover configuraton with Apache 2.x and mod_perl 2.x. 40 41 =over 4 42 43 =item * Apache2 >= 2.0.54 44 45 =item * mod_perl >= 2.0.0 46 47 =item * Apache::DBI >= '0.97' [*] 48 49 =back 50 51 [*] required for connect_on_init() to work under mod_perl >= 2.0.1 24 52 25 53 =head3 Apache 1.x … … 33 61 =head3 Apache 2.x 34 62 35 To use Nebulous with Apache2 you must have Apache2 >= 2.0.54 and mod_perl >=36 2.0.037 38 Apache::DBI >= '0.97' is required for connect_on_init() to work under mod_perl >= 2.0.139 40 63 =head4 removing Apache on RHEl3 64 65 On RHEL3 I had to remove these packages in order to fully remove MySQL. 41 66 42 67 As C<root>: … … 96 121 cd .. 97 122 123 =head4 installing mod_perl 2.x 124 98 125 tar -zxvf mod_perl-2.0.1.tar.gz 99 126 cd mod_perl-2.0.1 … … 109 136 Syntax OK 110 137 111 =head3 Common Apache Setup 138 =head4 installing and configuring Nebulous 139 140 tar -zvxf Nebulous-0.01.tar.gz 141 cd Nebulous-0.01 142 perl Build.PL -axps /usr/sbin/apxs 143 ./Build 144 ./Build test 145 su 146 ./Build install 147 148 149 vi /etc/apache2/conf/startup.pl 150 (change Group to "Group nebulous") 151 152 cp fooconf /etc/apache2/conf/startup.pl 153 echo "PerlPostConfigRequire /etc/apache2/conf/startup.pl" >> /etc/apache2/conf/apache2.conf 154 155 =head4 initilizing the Nebulous server database 156 157 mysql -u root mysql -p 158 (enter your MySQL root password) 159 160 DROP DATABASE IF EXISTS nebulous; 161 CREATE DATABASE nebulous; 162 GRANT ALL PRIVILEGES ON *.* TO 'nebulous'@'localhost' 163 IDENTIFIED BY '@neb@'; 164 FLUSH PRIVILEGES; 165 exit 166 167 export NEB_DB=nebulous 168 export NEB_USER=nebulous 169 export NEB_PASS=@neb@ 170 171 neb-initdb 172 neb-addvol --name po01 --uri file:/po01/nebulous 173 neb-addvol --name po02 --uri file:/po02/nebulous 174 neb-addvol --name po03 --uri file:/po03/nebulous 175 neb-addvol --name po04 --uri file:/po04/nebulous 176 . 177 . 178 179 =head3 configurating Apache to act as a Nebulous/SOAP server 112 180 113 181 =item * add the "nebulous" group to /etc/group 114 182 =item * configure Apache to run as the nebulous group. 115 183 184 cat <<END >> /etc/apache2/conf/apache2.conf 185 <Location /nebulous> 186 SetHandler perl-script 187 PerlResponseHandler Apache2::SOAP 188 PerlSetVar dispatch_to "PerlHandler Nebulous::Server::SOAP" 189 PerlSetVar options "compress_threshold => 10000" 190 </Location> 191 END 192 193 apachectl configtest 194 Syntax OK 116 195 117 196 # out of date from here down... … … 164 243 You can test your configuration with the C<telnet> utility. 165 244 166 telnet localhost 80245 $ telnet localhost 80 167 246 Trying 127.0.0.1... 168 Connected to localhost. 247 Connected to localhost.localdomain (127.0.0.1). 169 248 Escape character is '^]'. 170 GET / cgi-bin/imageserver.plHTTP/1.0171 172 HTTP/1.1 411 Length Required173 Date: Tue, 28 Sep 2004 21:15:58GMT174 Server: Apache/2.0. 49 (Gentoo/Linux)175 Content-Length: 0249 GET /nebulous HTTP/1.0 250 251 HTTP/1.1 500 Internal Server Error 252 Date: Wed, 31 Aug 2005 01:10:47 GMT 253 Server: Apache/2.0.54 (Unix) mod_perl/2.0.1 Perl/v5.8.6 254 Content-Length: 645 176 255 Connection: close 177 Content-Type: text/plain; charset=ISO-8859-1 256 Content-Type: text/html; charset=iso-8859-1 257 . 258 . 178 259 179 260 Connection closed by foreign host. … … 181 262 If you get an HTTP 5xx code check your apache error_log 182 263 183 =head2 Directory Permissions 184 185 mkdir /po01/nebulous 186 chown root:nebulous /po01/nebulous 187 chmod 0770 /po01/nebulous 188 189 =head2 MySQL Configuration 264 265 =head2 MySQL Configuration/tuning 190 266 191 267 in /etc/mysql/my.cnf … … 194 270 max_connections = 200 195 271 272 Nebulous makes heavy use of MySQL's C<innodb> table type. Try configuring 273 MySQL with these parameters: 274 275 innodb_log_files_in_group = 2 276 innodb_buffer_pool_size = as big as possible (512M+) 277 innodb_log_buffer_size= 16M 278 innodb_log_file_size=10M 279 196 280 =cut
Note:
See TracChangeset
for help on using the changeset viewer.
