Index: /trunk/Nebulous-Server/docs/setup.txt =================================================================== --- /trunk/Nebulous-Server/docs/setup.txt (revision 4920) +++ /trunk/Nebulous-Server/docs/setup.txt (revision 4921) @@ -5,4 +5,6 @@ =head2 Create a UNIX group for Nebulous +All Nebulous user's need to be in the same UNIX group as the Nebulous server. + groupadd -g 877 nebulous @@ -15,11 +17,37 @@ usermod -G nebulous foouser +=head2 Setup directory permissions for the nebulous group + +As root: + + mkdir /po01/nebulous + mkdir /po02/nebulous + mkdir /po03/nebulous + mkdir /po04/nebulous + chown nobody:nebulous /po0?/nebulous + chmod 0770 /po0?/nebulous + =head2 Build and install the Nebulous Perl modules (see: README) =head2 Create and initialize the database (see: docs/database_setup.txt) -=head2 Install Apache with mod_perl - -Nebulous will work with both Apache 1.3 & 2.x. +=head2 Install Apache2 with mod_perl + +=head3 Minimum software requirements: + +Nebulous will work with both Apache 1.3 & 2.x. However, this guide will only +cover configuraton with Apache 2.x and mod_perl 2.x. + +=over 4 + +=item * Apache2 >= 2.0.54 + +=item * mod_perl >= 2.0.0 + +=item * Apache::DBI >= '0.97' [*] + +=back + +[*] required for connect_on_init() to work under mod_perl >= 2.0.1 =head3 Apache 1.x @@ -33,10 +61,7 @@ =head3 Apache 2.x -To use Nebulous with Apache2 you must have Apache2 >= 2.0.54 and mod_perl >= -2.0.0 - -Apache::DBI >= '0.97' is required for connect_on_init() to work under mod_perl >= 2.0.1 - =head4 removing Apache on RHEl3 + +On RHEL3 I had to remove these packages in order to fully remove MySQL. As C: @@ -96,4 +121,6 @@ cd .. +=head4 installing mod_perl 2.x + tar -zxvf mod_perl-2.0.1.tar.gz cd mod_perl-2.0.1 @@ -109,9 +136,61 @@ Syntax OK -=head3 Common Apache Setup +=head4 installing and configuring Nebulous + + tar -zvxf Nebulous-0.01.tar.gz + cd Nebulous-0.01 + perl Build.PL -axps /usr/sbin/apxs + ./Build + ./Build test + su + ./Build install + + + vi /etc/apache2/conf/startup.pl + (change Group to "Group nebulous") + + cp fooconf /etc/apache2/conf/startup.pl + echo "PerlPostConfigRequire /etc/apache2/conf/startup.pl" >> /etc/apache2/conf/apache2.conf + +=head4 initilizing the Nebulous server database + + mysql -u root mysql -p + (enter your MySQL root password) + + DROP DATABASE IF EXISTS nebulous; + CREATE DATABASE nebulous; + GRANT ALL PRIVILEGES ON *.* TO 'nebulous'@'localhost' + IDENTIFIED BY '@neb@'; + FLUSH PRIVILEGES; + exit + + export NEB_DB=nebulous + export NEB_USER=nebulous + export NEB_PASS=@neb@ + + neb-initdb + neb-addvol --name po01 --uri file:/po01/nebulous + neb-addvol --name po02 --uri file:/po02/nebulous + neb-addvol --name po03 --uri file:/po03/nebulous + neb-addvol --name po04 --uri file:/po04/nebulous + . + . + +=head3 configurating Apache to act as a Nebulous/SOAP server =item * add the "nebulous" group to /etc/group =item * configure Apache to run as the nebulous group. + cat <> /etc/apache2/conf/apache2.conf + + SetHandler perl-script + PerlResponseHandler Apache2::SOAP + PerlSetVar dispatch_to "PerlHandler Nebulous::Server::SOAP" + PerlSetVar options "compress_threshold => 10000" + + END + + apachectl configtest + Syntax OK # out of date from here down... @@ -164,16 +243,18 @@ You can test your configuration with the C utility. - telnet localhost 80 + $ telnet localhost 80 Trying 127.0.0.1... - Connected to localhost. + Connected to localhost.localdomain (127.0.0.1). Escape character is '^]'. - GET /cgi-bin/imageserver.pl HTTP/1.0 - - HTTP/1.1 411 Length Required - Date: Tue, 28 Sep 2004 21:15:58 GMT - Server: Apache/2.0.49 (Gentoo/Linux) - Content-Length: 0 + GET /nebulous HTTP/1.0 + + HTTP/1.1 500 Internal Server Error + Date: Wed, 31 Aug 2005 01:10:47 GMT + Server: Apache/2.0.54 (Unix) mod_perl/2.0.1 Perl/v5.8.6 + Content-Length: 645 Connection: close - Content-Type: text/plain; charset=ISO-8859-1 + Content-Type: text/html; charset=iso-8859-1 + . + . Connection closed by foreign host. @@ -181,11 +262,6 @@ If you get an HTTP 5xx code check your apache error_log -=head2 Directory Permissions - - mkdir /po01/nebulous - chown root:nebulous /po01/nebulous - chmod 0770 /po01/nebulous - -=head2 MySQL Configuration + +=head2 MySQL Configuration/tuning in /etc/mysql/my.cnf @@ -194,3 +270,11 @@ max_connections = 200 +Nebulous makes heavy use of MySQL's C table type. Try configuring +MySQL with these parameters: + + innodb_log_files_in_group = 2 + innodb_buffer_pool_size = as big as possible (512M+) + innodb_log_buffer_size= 16M + innodb_log_file_size=10M + =cut Index: /trunk/Nebulous/docs/setup.txt =================================================================== --- /trunk/Nebulous/docs/setup.txt (revision 4920) +++ /trunk/Nebulous/docs/setup.txt (revision 4921) @@ -5,4 +5,6 @@ =head2 Create a UNIX group for Nebulous +All Nebulous user's need to be in the same UNIX group as the Nebulous server. + groupadd -g 877 nebulous @@ -15,11 +17,37 @@ usermod -G nebulous foouser +=head2 Setup directory permissions for the nebulous group + +As root: + + mkdir /po01/nebulous + mkdir /po02/nebulous + mkdir /po03/nebulous + mkdir /po04/nebulous + chown nobody:nebulous /po0?/nebulous + chmod 0770 /po0?/nebulous + =head2 Build and install the Nebulous Perl modules (see: README) =head2 Create and initialize the database (see: docs/database_setup.txt) -=head2 Install Apache with mod_perl - -Nebulous will work with both Apache 1.3 & 2.x. +=head2 Install Apache2 with mod_perl + +=head3 Minimum software requirements: + +Nebulous will work with both Apache 1.3 & 2.x. However, this guide will only +cover configuraton with Apache 2.x and mod_perl 2.x. + +=over 4 + +=item * Apache2 >= 2.0.54 + +=item * mod_perl >= 2.0.0 + +=item * Apache::DBI >= '0.97' [*] + +=back + +[*] required for connect_on_init() to work under mod_perl >= 2.0.1 =head3 Apache 1.x @@ -33,10 +61,7 @@ =head3 Apache 2.x -To use Nebulous with Apache2 you must have Apache2 >= 2.0.54 and mod_perl >= -2.0.0 - -Apache::DBI >= '0.97' is required for connect_on_init() to work under mod_perl >= 2.0.1 - =head4 removing Apache on RHEl3 + +On RHEL3 I had to remove these packages in order to fully remove MySQL. As C: @@ -96,4 +121,6 @@ cd .. +=head4 installing mod_perl 2.x + tar -zxvf mod_perl-2.0.1.tar.gz cd mod_perl-2.0.1 @@ -109,9 +136,61 @@ Syntax OK -=head3 Common Apache Setup +=head4 installing and configuring Nebulous + + tar -zvxf Nebulous-0.01.tar.gz + cd Nebulous-0.01 + perl Build.PL -axps /usr/sbin/apxs + ./Build + ./Build test + su + ./Build install + + + vi /etc/apache2/conf/startup.pl + (change Group to "Group nebulous") + + cp fooconf /etc/apache2/conf/startup.pl + echo "PerlPostConfigRequire /etc/apache2/conf/startup.pl" >> /etc/apache2/conf/apache2.conf + +=head4 initilizing the Nebulous server database + + mysql -u root mysql -p + (enter your MySQL root password) + + DROP DATABASE IF EXISTS nebulous; + CREATE DATABASE nebulous; + GRANT ALL PRIVILEGES ON *.* TO 'nebulous'@'localhost' + IDENTIFIED BY '@neb@'; + FLUSH PRIVILEGES; + exit + + export NEB_DB=nebulous + export NEB_USER=nebulous + export NEB_PASS=@neb@ + + neb-initdb + neb-addvol --name po01 --uri file:/po01/nebulous + neb-addvol --name po02 --uri file:/po02/nebulous + neb-addvol --name po03 --uri file:/po03/nebulous + neb-addvol --name po04 --uri file:/po04/nebulous + . + . + +=head3 configurating Apache to act as a Nebulous/SOAP server =item * add the "nebulous" group to /etc/group =item * configure Apache to run as the nebulous group. + cat <> /etc/apache2/conf/apache2.conf + + SetHandler perl-script + PerlResponseHandler Apache2::SOAP + PerlSetVar dispatch_to "PerlHandler Nebulous::Server::SOAP" + PerlSetVar options "compress_threshold => 10000" + + END + + apachectl configtest + Syntax OK # out of date from here down... @@ -164,16 +243,18 @@ You can test your configuration with the C utility. - telnet localhost 80 + $ telnet localhost 80 Trying 127.0.0.1... - Connected to localhost. + Connected to localhost.localdomain (127.0.0.1). Escape character is '^]'. - GET /cgi-bin/imageserver.pl HTTP/1.0 - - HTTP/1.1 411 Length Required - Date: Tue, 28 Sep 2004 21:15:58 GMT - Server: Apache/2.0.49 (Gentoo/Linux) - Content-Length: 0 + GET /nebulous HTTP/1.0 + + HTTP/1.1 500 Internal Server Error + Date: Wed, 31 Aug 2005 01:10:47 GMT + Server: Apache/2.0.54 (Unix) mod_perl/2.0.1 Perl/v5.8.6 + Content-Length: 645 Connection: close - Content-Type: text/plain; charset=ISO-8859-1 + Content-Type: text/html; charset=iso-8859-1 + . + . Connection closed by foreign host. @@ -181,11 +262,6 @@ If you get an HTTP 5xx code check your apache error_log -=head2 Directory Permissions - - mkdir /po01/nebulous - chown root:nebulous /po01/nebulous - chmod 0770 /po01/nebulous - -=head2 MySQL Configuration + +=head2 MySQL Configuration/tuning in /etc/mysql/my.cnf @@ -194,3 +270,11 @@ max_connections = 200 +Nebulous makes heavy use of MySQL's C table type. Try configuring +MySQL with these parameters: + + innodb_log_files_in_group = 2 + innodb_buffer_pool_size = as big as possible (512M+) + innodb_log_buffer_size= 16M + innodb_log_file_size=10M + =cut