Implementation of Electronic Reserves on an Apache Server By Kelly Vickery http://www.uky.edu/~kmvick0/Reserves 1 Organization of Ereserves: • Searchable database: • Commercial Ereserve Management System. • Direct access from Integrated Library System. • Home developed Ereserve System. • Web page structure: • Flat web page structure. • Tiered web page structure. 2 Apache Authentication, Authorization, & Access Control • Authentication – who are you? • Authorization – what may you access? • Access control – under what conditions? Apache provides several utilities that can implement these controls in a variety of ways. The process involves: 3 Apache Utilities • Authorization file - .htaccess files – Contains directives that control access to the directory. • Password utilities – htpasswd – htdigest – dbmmanage 4 .htaccess Directives • AuthType Basic/Digest. • AuthName “Enter browser prompt text.” • AuthUserFile path to the password file. • AuthGroupFile path to the group file. • Require requirement directives. Examples: • • • • • • • AuthDigestFile AuthDigestGroupFile AuthDBUserFile AuthDBGroupFile Order allow,deny Allow from IP/domain Satisfy any/all – Require valid-user – Require group students 5 How .htaccess uses htpasswd files Root directory Password directory Password file 1 Password file 2 Password file 3 Course Ereserve 1 .htaccess file htdocs directory Other directories Reserves directory Other web directories Course Ereserve 2 .htaccess file Course Ereserve 1 .htaccess file 6 How .htaccess uses htpasswd files AuthType Basic AuthName "Students in History 554." AuthUserFile /usr/PW/his554.txt Require valid-user “usr” directory “PW” directory eco101.txt ant325.txt his554.txt “Reserves” directory History_554 ereserves .htaccess file 7 UK .htaccess example AuthType Basic AuthName "Students in Popkin's HON 102 class (Please contact your instructor for User Name and Password)." AuthUserFile /usr/www/htdocs/PW/yopohon102.web Require valid-user But how do you create the file pointed to by the “AuthUserFile” directive? 8 htpasswd function • htpasswd [-cmdps] passwordfile username • htpasswd -b[cmdps] passwordfile username password • -c Create a new file. • -n Don't update file; display results on stdout. • -m Force MD5 encryption of the password. • -d Force CRYPT encryption of the password (default). • -p Do not encrypt the password (plaintext). • -s Force SHA encryption of the password. • -b Use the password from the command line rather than prompting for it. 9 dbmmanage function • dbmmanage – database management • htdigest – encrypted ID & password Best to check www.apache.org 10 Password prompts Variations based on Browsers Internet Explorer 6.0 Netscape 7.0 & 4.78 Site and Realm are always Listed. Realm = AuthName 11 Distribution of Ereserves • Create and serve digital files • Point to files purchased from Aggregators 12 13 14 Direct Links to EbscoHost Articles Using Persistent Links. Steps 1. Find desired ereserve article in EbscoHost. 2. Persistent link is provided in citation. 3. Use this link as the ereserve link. 15 16 Direct Links to Articles InfoTrac using “InfoMarks”. 1. 2. 3. 4. 5. Steps Find desired ereserve article in InfoTrac. Identify its PURL {everything after “purl=“. Place the PURL after “InfoMark” prefix: http://infotrac.galegroup.com/itw/infomark /1/1/1/purl= Use this link as the ereserve link. 17 InfoMark example http://infotrac.galegroup.com/itw/infomark/1/1/1/purl= rc1_EAIM_0_A8282965&dyn=9!xrn_1_0_A8282965&bkm_9_1?sw_aep={account ID} 18 Direct Link to Articles Ovid (Jump Start) • http://gateway.ovid.com/ovidweb.cgi?T=JS&PAG E=fulltext&D=ovft&NEWS=N&AN=00005205200105000-00009 – – – – – http://gateway.ovid.com/ovidweb.cgi?T=JS &PAGE=fulltext (indicates show the full text page) &D=ovft (indicates which Ovid database) &NEWS=N (indicates skip the news screen) &N=… (…is where the article accession number is entered) 19 Ovid Jump Start example http://gateway.ovid.com/ovidweb.cgi?T=JS&PAGE=fulltext&D=ovft&NEWS=N&AN=00005205-200105000-00009 20 Direct Links to Articles Science Direct (etc.) using DOI • D.O.I. Is a Digital Object Identifier. • Example: – doi:10.1016/S0091-2182(98)00062-7 • Used to identify a specific digital object. • Corporation for National Research Initiatives (http://www.cnri.reston.va.us): – C.N.R.I. - CrossRef - HandleSystem - DOI 21 CrossRef Members -- sample • Association of American Publishers • Elsevier Science • International Publishers Association • John Wiley & Sons • McGraw-Hill, Educational and Professional Publishing Group • Springer Verlag • American Chemical Society • Association for Computing Machinery • Cambridge University Press • Copyright Clearance Center • EDP Sciences • Wolters Kluwer International Health & Science • New England Journal of Medicine • Nielsen BookData • IEEE 22 Direct Links to Articles Science Direct (etc.) using DOI 1. 2. 3. 4. 5. STEPS Find desired ereserve article Identify the DOI number in the article. Place the DOI number after the central Handle System prefix: http://dx.doi.org/ Use this link as the ereserve link. 23 Science Direct (DOI) example http://dx.doi.org/10.1016/S0091-2182(98)00062-7 24 UK Ereserve System Fall 2002 • • • • • • Four different Libraries or units. Seventeen different curriculums. Forty-nine courses using ereserves. Delivering 484 ereserve files. Server space used 630,885,663 bytes. 15,104 documents delivered in Fall ‘02 25 UK Ereserve System Spring (to March 2003) • • • • • • Six different Libraries or units. Twenty-two different curriculums. Fifty-one courses using ereserves. Delivering 650 ereserve files. Server space used 700,818,201 bytes 12,069 in January-February of Spring ‘02 26 Percent increase of usage. Libraries (or dept.) 4 6 150% Courses 49 51 104% Server Space 630,885,663 700,818,201 111% Number of documents 484 650 134% Files Served 15,104 12,069 80% 27 References • http://www.mville.edu/Administration/staff/Jef f_Rosedale/ • http://www.cni.org/Hforums/arl-ereserve/ • Managing Electronic Reserves. Jeff Rosedale, editor. ALA, Chicago. 2002. • www.uky.edu/Libraries/Reserves 28