Note that when prompted for input, hitting "enter" will select the default (given in square brackets [] at the end of each question). If you're unsure which option to select, use the default. Note also that Install.sh prints out information on any commands it runs on your system in the form "--> Install.sh: [command]". It is assumed throughout this installation procedure that you have a webserver installed on your system. For later reference the output of this install script will be recorded in a file called INSTALL_RECORD in the directory into which you choose to install Greenstone. Continue? [y] > Which directory should Greenstone be installed to? Make sure that this directory is on a partition with sufficient free disk space for the installation options you intend selecting. * A linux binary installation requires approximately 70Mb. * Compiling Greenstone from source code requires approximately 155Mb. * Optional Greenstone demonstration collections may use up to a further 135Mb (you'll be told the size of each individual collection before you install it). * Online documentation requires a further 4Mb. * Enabling Greenstone's "CD exporting" function requires a further 24Mb. Enter directory to install Greenstone into. A gsdl directory will be created in this directory. [/usr/local] > --> Install.sh: [mkdir -p "/usr/local/gsdl"] --> Install.sh: [chmod u+rwx "/usr/local/gsdl"] If this installation fails or is cancelled, run the uninstall script (/usr/local/gsdl/Uninstall.sh) to clean up the partial installation. Continue? [y] > Installing Greenstone directory structure to /usr/local/gsdl --> Install.sh: [cp -r "/root/GS/gsdl-2.72-unix/gsdl/"* "/usr/local/gsdl"] --> Install.sh: [cp "/root/GS/gsdl-2.72-unix/src/Unix/setup."* "/usr/local/gsdl"] --> Install.sh: [mkdir -p "/usr/local/gsdl/tmp"] --> Install.sh: [chmod u+rwx "/usr/local/gsdl/collect"] Setting permissions ... --> Install.sh: [chmod -R u+rw "/usr/local/gsdl"] --> Install.sh: [chmod a+x "/usr/local/gsdl/bin/script/"*] --> Install.sh: [chmod a+w "/usr/local/gsdl/etc/error.txt"] --> Install.sh: [chmod a+w "/usr/local/gsdl/etc/key.db"] --> Install.sh: [chmod a+w "/usr/local/gsdl/etc/users.db"] --> Install.sh: [chmod a+w "/usr/local/gsdl/etc/main.cfg"] --> Install.sh: [chmod a+w "/usr/local/gsdl/etc/history.db"] --> Install.sh: [chmod a+w "/usr/local/gsdl/etc/usage.txt"] In order for end-user collection building to be enabled the Greenstone cgi program must be able to write to the /usr/local/gsdl/collect and /usr/local/gsdl/tmp directories. On most systems this means they must be globally writable. Make these directories globally writable? [y] > --> Install.sh: [chmod -R a+w "/usr/local/gsdl/collect"] --> Install.sh: [chmod -R a+w "/usr/local/gsdl/tmp"] You may either install pre-compiled, statically linked linux [b]inaries (i386 only) or install and [c]ompile the Greenstone source code Enter "[b]" or "c" > b Installing linux binaries --> Install.sh: [cp -r "/root/GS/gsdl-2.72-unix/Unix/bin/linux" "/usr/local/gsdl/bin"] --> Install.sh: [chmod a+x "/usr/local/gsdl/bin/linux/"*] --> Install.sh: [chmod -R u+rw "/usr/local/gsdl/bin/linux"] --> Install.sh: [mv "/usr/local/gsdl/bin/linux/library" "/usr/local/gsdl/cgi-bin"] --> Install.sh: [mv "/usr/local/gsdl/bin/linux/oaiserver" "/usr/local/gsdl/cgi-bin"] Greenstone needs a valid cgi executable directory (normally called cgi-bin on unix systems) from which to run. This may be either: 1. The default Greenstone cgi-bin directory (/usr/local/gsdl/cgi-bin). If you use the Greenstone default you will need to configure your webserver to treat this directory as a cgi executable directory. For the Apache webserver you use the ScriptAlias directive to do this (details of how to configure your webserver will be displayed at the end of this installation procedure). 2. An existing cgi-bin directory. Normally a cgi-bin directory is created when your webserver is installed. Typically, this might be /home/httpd/cgi-bin, or /usr/local/apache/cgi-bin, or /var/lib/apache/cgi-bin. Enter "[1]" or "2" > Don't forget to configure your webserver to treat /usr/local/gsdl/cgi-bin as a cgi executable directory. Don't worry, you'll be reminded of this again at the end of the installation procedure Please enter the web address of the /usr/local/gsdl/cgi-bin directory. Typically this might be http://localhost/cgi-bin, or http://127.0.0.1/cgi-bin, or http://your-computer-name/cgi-bin, or http://nnn.nnn.nnn.nn/cgi-bin. [http://ganimede.provincia.ps.it/gsdl/cgi-bin] > --> Install.sh: [mv "/usr/local/gsdl/bin/linux/oaiserver" "/usr/local/gsdl/cgi-bin"] 2. Provide an existing web accessible directory from which a symbolic link (ln -s) will be made to /usr/local/gsdl. When your server was installed a web accessible directory will have been created (the Apache webserver uses the DocumentRoot directive to define this directory). Typically this directory might be /home/httpd/html, or /usr/local/apache/htdocs, or /var/lib/apache/htdocs. Note that your web server will need to be configured to allow symbolic links from within this directory. For the Apache server that means this directory must be configured with the SymLinksIfOwnerMatch or FollowSymLinks option (most Apache installations are configured this way by default). Enter "[1]" or "2" > Don't forget to configure your webserver to make /usr/local/gsdl accessible from the web. You'll be reminded of this again at the end of this installation procedure. Enter the web address of the /usr/local/gsdl directory. This may be a relative url (e.g. "/gsdl") or a complete url (e.g. "http://ganimede.provincia.ps.it/gsdl") [/gsdl] > In order to use end-user collection building or to access certain parts of the administration pages you must have a password. A user with the username "admin" will be created for you with the password you provide (i.e. to enter any pages requiring user authentication enter the "admin" username and the password you set here). Greenstone installation completed successfully. * Don't forget to configure your webserver to treat /usr/local/gsdl/cgi-bin as a cgi executable directory. For the Apache webserver this means adding the following ScriptAlias directive to your httpd.conf configuration file. ScriptAlias /gsdl/cgi-bin/ "/usr/local/gsdl/cgi-bin/" AllowOverride None Options None Order allow,deny Allow from all * Don't forget to configure your webserver to treat /usr/local/gsdl as a web accessible directory. For the Apache webserver this means adding the following Alias directive to your httpd.conf configuration file. Alias /gsdl/ "/usr/local/gsdl/" Options Indexes MultiViews FollowSymLinks AllowOverride None Order allow,deny Allow from all The output of this script has been recorded for you at /usr/local/gsdl/INSTALL_RECORD. You may remove Greenstone from your system at any time by running the /usr/local/gsdl/Uninstall.sh script. Access Greenstone by pointing a web browser at http://ganimede.provincia.ps.it/gsdl/cgi-bin/library