By far, the easiest way to install is with the install script. It does everything except installing Apache, mod_perl, and MySQL, which you can find instructions for doing in the previous sections. Also, be sure you've installed expat, as outlined above. After you've installed and configured these, then become root and switch to the ``scoop/scripts/'' directory. From there, just run ``install.pl''.
First, the install script will do some checks, then ask if you want to install Perl modules. You'll probably want to, just to be sure, since if everything is already up to date, then it will skip over all of them.
You'll also want to do this, unless you're upgrading, in which case re-configuring your database will drop all the data in it. You'll need to provide the installer with a username, password, host, and port so that it can connect to the database, though most of the defaults will work fine. Note that the user you provide will need to be able to create a database. At the next step, you'll probably want to choose option 1 (Create a new database), since if you rebuild, it'll just drop a current one. Unless you have a specific reason to change it, the default database name will work just fine.
After this, however, you'll need to make some choices. First is the path to Scoop on the webserver. What you put here depends on how you want to run Scoop. If you intend to run it on a domain or sub-domain (so that ``http://www.mysite.com/'' will access it), then put ``/'' in for the URL path. However, if you're running it in a separate ``directory'' (so that ``http://www.mysite.com/scoop/'' will access it), then put whatever you want the path to be in (which would be ``/scoop'' for our example). The next prompt asks simply for the email address of the admin (probably yours).
Finally, you need to choose a password for the initial user (which will be called ``scoop''). This must be at least 8 characters long. After this, the database will be built (or re-built, depending on which option you chose).
The final stage in installation is configuring Apache. First, you need to choose if you'll be using a location-based install or a virtual host install. This is related to the database configuration, where you chose the URL path to Scoop. Basically, if you want to run Scoop from a sub-domain, choose virtual host. Otherwise choose location.
You'll be prompted for the sample config file, which should be autodetected. Then you'll need to enter your version of MySQL (either 3.22 or 3.23). If you've installed recently, then it'll be 3.23. At this point, if you have already configured the database, then the installer will use the values you entered previously. Otherwise, you will be prompted for a username, password, host, port, and database name to store in the config file, so that Scoop can connect to the database.
After that, you need to choose a site name, which is only used to name the config file uniquely (this eases administration when you have many Scoop sites). The default will work just fine usually.
Next is the cookie host, which you need to set correctly, or you'll
have a world of trouble. This must contain at least two dots, and
should be your hostname. For example, if your site is ``www.mysite.com'',
then this should be set to ``.mysite.com'', and if your site is
``scoop.mysite.com'', you should set this to ``scoop.mysite.com''
(so that it doesn't overlap with ``
The siteid, which follows, is mainly used internally to separate data
from different sites. However, it is also used in the cookie that
is set, so you may want to use something such as ``mysitecom''
for ``www.mysite.com''. Almost any string of characters will work,
though.
If you're doing a location based install, then you can skip to this
last paragraph of this section.
For a virtual host, you still need to specify the IP address of the
site you're setting up, and you need to indicate if you have any other
hosts that use the same IP. Then enter the name of the server (which
is what the user types in, so ``scoop.mysite.com'' for our example),
along with the location of the error and access logs (default will
probably be fine). Now, you're also finished.
All that's left is to place the line that the installer gives you
into Apache's httpd.conf and restart Apache (the line will be something
like ``Include /path/to/httpd-<sitename>.conf''). If you installed
Apache in ``/usr/local/apache'', then your httpd.conf will be
``/usr/local/apache/conf/httpd.conf''.
Next: 2.5 Doing It By
Up: 2 Installation
Previous: 2.3 Getting Scoop