Step-by-Step Installation Instructions
From DLXS Documentation
Main Page > Installing DLXS > Step-by-Step Installation Instructions
Note: Before starting, know that if for any reason the install is unsuccessful, you may repeat the process. Simply delete the $DLXSROOT directory (if it has been created) and run Installer again. In order to do a reconfiguration of a successful install simply rerun Installer again and answer R when prompted to do an initial install versus a reconfiguration.
You can choose to install
- Directly from the CD
- From a directory into which you have copied the installer and the gzipped middleware tarfiles
- From a directory where you have mounted the CDROM ISO image file
% cd /cdrom % perl Installer.pl
If installing from a directory on the hard drive into which you have copied the necessary files, enter the following:
% cd tarfile-dir % perl Installer.pl
If installing from a directory (somedir) where you have mounted the ISO image file, enter the following (assuming Linux syntax and the version in curly braces):
% mount -o loop dlxs_open_{version}.iso somedir % cd somedir % perl Installer.pl % umount somedir
The install program will run and prompt you to answer a number of questions. Note: Installer.pl does not hard-code a Perl hash bang so be sure to run it as an argument to the Perl command line as shown above.
What follows is an annotated version of the screen dialog from an actual run of Installer.pl. Because this installation was performed on a machine having all the necessary binaries and Perl modules supplied, most of the answers can be supplied by just hitting [RETURN]. Installer interactions look like
this
while annotations for the purposes of this documentation look like this.
Beginning of annotated screen dialogue:
Welcome to DLXS Installer. Press 'q' at any time to quit Compatible with DLXS Release 11. Which platform are you using? (SunOS/Linux) [SunOS]
The preceding is a check to make sure the platform is supported.
Where is Perl installed? [/usr/bin/perl]
Enter the full path to perl. The default is from the 'which' command..
Checking for Perl installation for required modules... All required modules were found.
All required Perl modules were found. If any were missing or if any differed from the recommended versions, the Installer would have listed them. We recommend installing them beforehand. You may abort the install at this point (Ctrl-C) and restart it later.
The next series of questions concerns where certain required binaries are installed in your system.
Enter full paths to the binaries you choose to install based on the middleware classes you chose to install as directed. See Installing Other Binaries.
Where is XPAT installed? [/l/local/bin/xpat] Do you want to use tif2web (required for TextClass page viewer)? [Y] Where is tif2web installed? [/l/local/bin/tif2web] Do you want to use c42pdf (required for TextClass page viewer)? [Y] Where is c42pdf installed? [/l/local/bin/c42pdf] Do you want to use MrSid (required for ImageClass)? [Y] Where is mrsid_retrieve installed? [/l/local/bin/mrsid_retrieve] Etc. ********************************** I m p o r t a n t ! ********************************** The next question allows you to pick between performing a first-time installation or reconfiguring an existing installation. For a FIRST-TIME INSTALLATION you will be asked where to install DLXS. You should supply a full path. For example, if you choose /l1/dlxs-release-11, the installer will: (1) create an install directory named /l1/dlxs-release-11 (2) mark it with a timestamp (3) extract the tarfiles into that directory. The directory path you choose will be known as DLXSROOT. This install directory is also inserted as a string into a number of working and configuration example files. For your webserver, the DLXSROOT variable and its value are written to an example file called DLXSROOT/bin/installer/config-examples/httpd.conf.dlxs. You may use that example configuration file to configure your Apache server environment. Or you may define DLXSROOT for your server using your own configuration. For your Unix shell, you should set the DLXSROOT environment variable to the path you choose so you can run various command line utilities which depend on it. For a RECONFIGURATION, you will be asked for the path you entered for the FIRST-TIME INSTALLATION directory. The directory must be one containing a completed installation of DLXS Release 9. Is this an I)nitial install or a R)econfiguration? (I/R) [I] Where would you like to install DLXS? [//] /l1/dlxstest
This is where you specify DLXSROOT as explained above. Note the option to "re-configure". If you choose it, you will be prompted for the location of a completed installation. The installer will then make another pass over the installed middleware .cfg files allowing you to change values you entered during the initial installation or subsequent reconfigurations. You can do this as many times as necessary.
Creating DLXSROOT... Unpacking tarball... Untarring all in /l/l1/INSTALL_CDROM into /l1/dlxstest... Untarring /l/l1/INSTALL_CDROM/Broker20_v1-1-0_rel11.tar.gz... Untarring /l/l1/INSTALL_CDROM/ImageClass_v3-0-0_rel11.tar.gz... Untarring /l/l1/INSTALL_CDROM/BibClass_v3-1-0_rel11.tar.gz... Untarring /l/l1/INSTALL_CDROM/Collmgr_v3-1-0_rel11.tar.gz... Untarring /l/l1/INSTALL_CDROM/TextClass_v3-2-0_rel11.tar.gz... Untarring /l/l1/INSTALL_CDROM/FindaidClass_v5-0-0_rel11.tar.gz... Untarring /l/l1/INSTALL_CDROM/Lib_v3-2-0_rel11.tar.gz... Untarring /l/l1/INSTALL_CDROM/XClass_v2-1-0_rel11.tar.gz... Untarring /l/l1/INSTALL_CDROM/Dlxsdocs_v1-2-0_rel11.tar.gz... Etc. ... Making symlinks...
Symlinks to the installed binaries are saved in $DLXSROOT/bin/symlinks so the middleware can find them easily and we can avoid many inline replacements at install-time.
Processing config-examples... Processing replacements in /l1/dlxstest/bin/installer/config-examples/crontab.dlxs Processing replacements in /l1/dlxstest/bin/installer/config-examples/httpd.conf.dlxs Etc. ...
Example files for the Apache server virtual host configuration and setting up cron jobs are automatically customized with your local settings and reside in $DLXSROOT/bin/installer/config-examples.
Processing ImageClass perl hashbangs... Processing replacements in /l1/release/13/bin/i/image/getFlds.pl Processing replacements in /l1/release/13/bin/i/image/imageprep Processing replacements in /l1/release/13/bin/i/image/putFlds.pl Processing replacements in /l1/release/13/bin/i/image/tab2html.pl Processing replacements in /l1/release/13/bin/i/image/droptable.pl Processing replacements in /l1/release/13/bin/i/image/fmpxml2mysql.pl Processing replacements in /l1/release/13/bin/i/image/icdbprep.pl Processing replacements in /l1/release/13/bin/i/image/load.pl Processing replacements in /l1/release/13/bin/i/image/makeRepeating.pl Processing replacements in /l1/release/13/bin/i/image/prep2prod.pl Processing replacements in /l1/release/13/bin/i/image/swaptables.pl Processing replacements in /l1/release/13/bin/i/image/tab2html.pl ImageClass thumb symlinking...
The preceding part of the script creates some needed directories and creates symlinks for image files.
Processing TextClass index replacements... Processing replacements in /l1/dlxstest/idx/s/sampletc/sampletc.dd Etc. ... [long] Processing BibClass index replacements... Processing replacements in /l1/dlxstest/idx/s/samplebc/samplebc.dd Processing FindaidClass index replacements... Processing replacements in /l1/dlxstest/idx/s/samplefa/samplefa.dd Processing FindaidClass Aids perl hashbangs... Processing replacements in /l1/dlxstest/bin/f/findaid/catsourcefiles.pl Processing replacements in /l1/dlxstest/bin/f/findaid/cleanfiles.pl Processing replacements in /l1/dlxstest/bin/f/findaid/inc.extra.dd.pl Processing replacements in /l1/dlxstest/bin/f/findaid/isolat128bit.pl Processing replacements in /l1/dlxstest/bin/f/findaid/output.dd.frag.pl Processing replacements in /l1/dlxstest/bin/f/findaid/validate.pl Processing replacements in /l1/dlxstest/bin/s/samplefa/validate.pl Processing FindaidClass /l1/dlxstest... replacements... Processing replacements in /l1/dlxstest/bin/s/samplefa/Makefile Processing miscellaneous bin utilities perl hashbangs... Processing replacements in /l1/dlxstest/bin/managesessions.pl
The preceding section on replacements details string replacements in files that have hard-coded paths to Perl and to $DLXSROOT.
Processing database utilities perl hashbangs... Processing replacements in /l1/release/13/bin/db/dbcmp Processing replacements in /l1/release/13/bin/db/dbdump Processing replacements in /l1/release/13/bin/db/dbmove Processing replacements in /l1/release/13/bin/db/dbconv Processing replacements in /l1/release/13/bin/db/upgrade_1_2 Processing replacements in /l1/release/13/bin/db/upgrade_2_3 Processing replacements in /l1/release/13/bin/db/upgrade_3_4 Processing replacements in /l1/release/13/bin/db/upgrade_4_5 Processing replacements in /l1/release/13/bin/db/upgrade_5_6 Making /l1/release/13/web/cache as cache directory Opening permissions to u+w g+w o+w on /l1/release/13/web/cache Processing replacements in /l1/release/13/bin/installer/README-postinstall
The preceding section on replacements details string replacements in files that have hard-coded paths to Perl and to $DLXSROOT. The cache (used to hold derived images and pdf files) is created and permissions on it are set.
Next the Middleware .cfg files Processing Begins ...
Configuring LibGlobals.cfg authentication system disabled: using Basic Auth
By default, we assume you do not have a URL to an authentication system at your site that is able to set the REMOTE_USER environment variable. We deliver an HTTP "Basic Auth" configuration in the virtual host example file $DLXSROOT/bin/installer/config-examples/ httpd.conf.dlxs file.
Setting Item-level restriction table name to NULL
By default, we assume you do not restrict some collection items on an individual basis. The RestrictedItems table is used for this purpose.
Enter MySQL database name [dlxs_v6] Enter MySQL database user name (middleware will connect as this user) [dlxs] Enter password for MySQL database user name [guest] Enter MySQL database password for the "dlxsadm" ADMINISTRATIVE user [guest] Enter MySQL database server name. [mysql.your.site.edu] Setting MySQL *development* database server name to NULL Enter the virtual host of the idresolver cgi. [images.umdl.umich.edu] >
CSV databases are no longer supported. The default is MySQL. Consult dbmove utility for instructions on how to create an upgradable MySQL database from a CSV database.
Enter the virtual host of the idresolver cgi. [images.umdl.umich.edu]
At DLPS we have a CGI that maps image IDs to URLs so ImageClass can serve images maintained outside the usual ImageClass img directories. Here, if you choose to use the DLXS idresolver cgi, enter the virtual host under which it will run. Otherwise enter a blank.
Select sendmail or smtp to deliver mail. (sendmail/smtp) [sendmail] Enter the email address from which the generated (e.g. BookBag) mail will be sent ["UMDL Mailer" <umdl-help@umich.edu>] Enter your Help email HTML href [mailto:umdl-help@umich.edu] Enter your Help email text string [umdl-help@umich.edu]
Your local email addresses that will appear in several of the HTML templates.
Configuring BookBag.cfg
The mail host to use when mailing BookBag contents.
Enter the email address from which the BookBag mail will be sent ["UMDL Mailer" <umdl-help@umich.edu>] Configuring collmgr.cfg (Collection Database Manager) no logout URL: using Basic Auth
As explained above, the collmgr needs to have REMOTE_USER set by some mechanism. By default we supply HTTP "Basic Auth".
Configuring textclass.cfg Enter your name resolver URL or an empty string, if you do not have one. [http://name.umdl.umich.edu/] Setting POD-permitted table name to NULL Pring On Demand host set to null.
At DLPS we use a CGI to resolve item ids to URLs. Its URL is http://name.umdl.umich.edu. We have P)rint O)n D)emand functionality. By default this is turned off in a DLXS installation.
Configuring bibclass.cfg Configuring imageclass.cfg Enter the image file server host name. If it is the same as the host serving image-idx, enter '/', otherwise enter e.g. imageserver.umdl.umich.edu [/] not using a development host
Imageclass may be configured to use a different machine to serve image data (i.e., as opposed to the machine running the middleware). Certain content metadata searches cannot be performed with older versions of MySQL.
enabling Portfolios enabling Portfolio export/download (when Portfolios enabled)
The preceding status message indicated that ImageClass portfolio functionality is installed enabled by default.
Configuring broker20.cfg ...
broker20 is the CGI program that allows collection metadata to be served using the OAI protocol.
Configuring sru.cfg ...
sru is the CGI program that allows collection metadata to be served using the SRU protocol.
Done. Please refer to /l1/dlxstest/bin/installer/README-postinstall for post-installation directions. Would you like to view the post-installation directions now? [Y] ** NOTE: This installation was performed using version 13 of the DLXS Installer ** etc.
The installation is complete. Please follow the post install steps.