Subsections


2.5 Installing By Hand

If you choose not to use the install.pl script to install Scoop, it can be done by hand. These instructions assume you have installed perl, mysql, apache/mod_perl, and the required perl modules as described in previous sections.

First, make sure you have the Scoop distribution unpacked in its directory.


2.5.1 Configure the Database

You'll have to log in to the database as root (database root, not system root) or as another database user with the ability to grant privileges to other users, as well as the ability to create and modify databases. If you have just set up MySQL, please make sure that the database root account has a password on it - MySQL allows you to get away without one, but it's very bad practice.

You may substitute values to suit your setup for the words in <brackets>, as needed; for example, if you are running more than one Scoop site, you won't want to call either of them `scoop'. And definitely change <password> to something more secure.

shell$ mysql -u root -p
Enter password: 
mysql> create database <scoop>;
mysql> grant insert, update, delete, select on <scoop>.* 
    -> to <nobody>@<localhost> identified by '<password>';
mysql> exit

Note: the grant statement might have to be modified if you run MySQL 3.22.x, but if you have a choice, you shouldn't run that version.

Once the database is created, you need to dump the scoop.sql file into your new database. In the struct/ directory, issue the following command (it will prompt you for the password):

shell$ mysql -u root -p <scoop> < scoop.sql

If you are doing a path-based install (http://www.mysite.org/scoop/ instead of http://scoop.mysite.org/) you'll have to set the path in the database.

mysql> update vars set value='/<path>' where name='rootdir';

<path> should reflect your URL path; using the above example, '/<path>' should be '/scoop' (do not add a trailing slash!) If you are doing a virtual-host install, do not do this step.

Other important settings are described in section 3.1; rootdir is the only one that cannot be set through Scoop's normal administrative interface, and it must be set before starting Apache.


2.5.2 Configure Apache

Once MySQL has the Scoop database set up with the proper permissions, Apache needs to know about it, as well as several other things.

If you will run Scoop as a virtual host or as the sole website on the server, open etc/httpd-vhost.conf; if you will run Scoop in a subdirectory, open etc/httpd-location.conf. The files are pretty well self-documented; read the one you chose carefully to set all the variables and options properly.

Some extra notes on the options:

Once you've set all the variables to fit your requirements, copy the entire file into your httpd.conf file, or include it in your httpd.conf with

Include /path/to/httpd-<blah>.conf

Once Apache is configured, make sure MySQL is running (it should be, you've just been messing around in it) and start Apache. Using your web browser, go to the URL you set up in your httpd.conf file as Scoop's main page.

If the page comes up and you see the headline ``Welcome to Scoop!'' then you successfully installed Scoop, and you should go on to section 3 to finish setting up and start customizing.

If it doesn't, review the install procedure to make sure you didn't forget anything, check to see if your problem is described in section 2.8, then if you still can't figure it out, ask for help at one of the places listed in section 1.4.


janra
2004-03-26