Code4Lib - User contributions [en]

Umlaut wishlist

2010-10-21T16:38:17Z

128.220.205.186:

[[Category:Umlaut]]

Some actual current future plans:

* Fix HathiTrust adapter to use new HT plugin, including not showing fulltext for just portions of a serial. (Or showing it in 'see also' section only)

* Rails3

* Internet Archive -- use new OL/IA api, discover search-inside-the-book.

* WorldCat, use new api, link directly to nearest public library in 'see also' or elsewhere.

* CiteSeerX -- source of 'cited by' info, AND, most excitingly, open access pre-prints. But their Atom/RSS feeds (the only API I could find) don't seem to advertise enough info to actually use these features. Would need to talk to developer team -- possibly offer to help code? Also not entirely clear how big their corpus actually is, if it's worth it.

* Try screen-scraping Google Scholar (and maybe Microsoft Academic) to get the open access full text links they find.

* When no full text is found, provide link to search on Google Scholar, or Bing Academic? Need to have sufficient metadata to create the search. Oct 2010 Library Technolgoy Reports article has some ideas, I think.

'''old''' Desired or planned features.

* Check for similar articles from: http://biosemantics.org/jane/faq.php#api

* Full-text availability check from http://chroniclingamerica.loc.gov/ -- check by title/city, check by lccn (?), able to check particular dates/link to particular dates and/or pages of paper?

* Allow a service_response to have a tree relationship to children, so for instance alternate versions of a text can be attached as children of the main link, expandable by the user.

* http://export.arxiv.org/api_help/ !!!!

* PubMed Central full text lookup http://www.ncbi.nlm.nih.gov/entrez/query/static/esearch_help.html (SFX may already do this?)

* Journal ToC from CiteULike

* Parsing of formatted references from an entry screen. Use http://wing.comp.nus.edu.sg/parsCit/ package. Very interesting! Or a similar UCOP package: http://purl.net/net/egh/hmm-citation-extractor/ See list of such packages here under "Other Parsing Tools" http://freecite.library.brown.edu/

* LibraryThing open knowledge API for more data. http://www.librarything.com/blog/2008/08/free-web-services-api-to-common.php

* Connect to internet linked movie database on movies: http://www.linkedmdb.org/

* Add information about the conversation happening around an article with Scintilla if we have a URL, PMID or DOI (Alf at Scintilla would prefer us NOT to use the API for high-traffic. But we can copy his techniques internally to Umlaut. CrossRef and PubMed for "cited by" on DOI and PMID identifiers are a good idea. He has also reverse engineered the Scopus javascript api to allow server-side json access. http://hublog.hubmed.org/archives/001512.html):
http://hublog.hubmed.org/archives/001609.html
Unofficially it will return json:
http://scintilla.nature.com/conversations?uri=info%3Adoi%2F10.1371%2Fjournal.pmed.0020124&format=json

* Rochester “Getting Users Fulltext” style code to skip right to the full text, skipping content-provider metadata pages.

* UMich Mirlyn for metadata enrichment?
http://webservices.itcs.umich.edu/mediawiki/MLibraryAPI/index.php/Mirlynapi:Home

* xISBN/thingISBN use. (Some thought is required in how to integrate this while avoiding false positives). Bowker ISSN service for metadata enhancement. OCLC xISSN? Integrate preceding/succeeding title information from OPAC or xISSN?

* LibraryLookup: http://xisbn.worldcat.org/liblook/index.htm At least until xISBN is baked in we could provide a link to this service. Increases the chances of finding a desired book in the catalog through work set grouping. Used by LibX.
http://xisbn.worldcat.org/liblook/resolve.htm?res_id=http://www.iucat.iu.edu&rft.isbn=0451530942&url_ver=Z39.88-2004&rft_val_fmt=info:ofi/fmt:kev:mtx:book

* Journal covers from Ulrich's via screen-scraping (or Ulrich's/sersol built in api?)

* Connotea integration

* Fetch ToC from LC. Screen scrape, I guess? Or z3950? Any other content from LC?

* Link to Books In Print ala Notre Dame.
http://www.library.nd.edu/eresources/findit/findit.cgi?doc_num=001939269&aleph_session=U5AVHRXD5QB1CGDFDSVJ9DSY2UA6QNCGVEU8EYRX9NNMIQ429Q-54668%22
example

* bip search url? :
http://www.booksinprint.com/merge_shared/Search/advsearch.asp%3FdateState%3DY%26txtAction%3D%26BooleanSearch%3D%26SType%3Dadv%26collection%3DBIP%26QueryMode%3DSimple%26ResultCount%3D25%26ResultTemplate%3Dmbbookresult_fl.hts%26navPage%3D1%26SrchFrm%3DAdv%26ScoreThreshold%3D0%26Criteria1%3DISBN%26CriteriaText1%3D0838935370

* SFX plugin: Notice when first title given is non-roman, and look for roman title to enhance metadata with when so.

* HIP and other OPAC searchers should pull ToC from MARC 505 when present. And 856's judged to be ToC in ToC, not full text.

* Fix Umlaut Referent to more easily allow multiple authors. Architectural change neccessary to get a lot of this stuff working right.

* "Cited by" service. Scopus via screen scraping? (scopus javascript api? http://www.scopus.com/scsearchapi/ See also http://hublog.hubmed.org/archives/001512.html ) ISI Web of Science is too hard to even screen scrape the interface is such a mess, but Scopus looks do-able. Google scholar?

* Enhance metadata to have full metadata for a refworks etc export. Using: CrossRef? Metalib? Anything else?

* A general purpose responsecache. Schema: Date, service/source, key. Use for caching image urls, ToC urls from LC, etc.

* Fix Worldcat registry auto-discovery.

* Add a Worldcat search that uses API, instead of screen scrape.

* Switch OCA search to use OCA native APIs, instead of indexdata mirror index.

* fix unapi in umlaut. unapi to rsi? For zotero.

* Change background to use Spawn plugin instead of manual threading. Investigating using spawn with fork instead of thread (terry reese on limited pool of forks).

* Crazy idea for an abstract interface/architecture to support querying web service apis that require client side javascript, like Google Books and Scopus.

* Integrate my various local document delivery services into menu of options when full text isn’t available. More generally, a clear architecture for providing localized doc delivery services in addition to a single ILL link.

* SFX adaptor: Add a "rollup" feature that pays attention to dates to avoid eliminating coverage.

Umlaut wishlist

2010-10-21T16:28:05Z

128.220.205.186:

[[Category:Umlaut]]

Some actual current future plans:

* Fix HathiTrust adapter to use new HT plugin, including not showing fulltext for just portions of a serial. (Or showing it in 'see also' section only)

* Rails3

* Internet Archive -- use new OL/IA api, discover search-inside-the-book.

* WorldCat, use new api, link directly to nearest public library in 'see also' or elsewhere.

* CiteSeerX -- source of 'cited by' info, AND, most excitingly, open access pre-prints. But their Atom/RSS feeds (the only API I could find) don't seem to advertise enough info to actually use these features. Would need to talk to developer team -- possibly offer to help code? Also not entirely clear how big their corpus actually is, if it's worth it.

* When no full text is found, provide link to search on Google Scholar, or Bing Academic? Need to have sufficient metadata to create the search. Oct 2010 Library Technolgoy Reports article has some ideas, I think.

'''old''' Desired or planned features.

* Check for similar articles from: http://biosemantics.org/jane/faq.php#api

* Full-text availability check from http://chroniclingamerica.loc.gov/ -- check by title/city, check by lccn (?), able to check particular dates/link to particular dates and/or pages of paper?

* Allow a service_response to have a tree relationship to children, so for instance alternate versions of a text can be attached as children of the main link, expandable by the user.

* http://export.arxiv.org/api_help/ !!!!

* PubMed Central full text lookup http://www.ncbi.nlm.nih.gov/entrez/query/static/esearch_help.html (SFX may already do this?)

* Journal ToC from CiteULike

* Parsing of formatted references from an entry screen. Use http://wing.comp.nus.edu.sg/parsCit/ package. Very interesting! Or a similar UCOP package: http://purl.net/net/egh/hmm-citation-extractor/ See list of such packages here under "Other Parsing Tools" http://freecite.library.brown.edu/

* LibraryThing open knowledge API for more data. http://www.librarything.com/blog/2008/08/free-web-services-api-to-common.php

* Connect to internet linked movie database on movies: http://www.linkedmdb.org/

* Add information about the conversation happening around an article with Scintilla if we have a URL, PMID or DOI (Alf at Scintilla would prefer us NOT to use the API for high-traffic. But we can copy his techniques internally to Umlaut. CrossRef and PubMed for "cited by" on DOI and PMID identifiers are a good idea. He has also reverse engineered the Scopus javascript api to allow server-side json access. http://hublog.hubmed.org/archives/001512.html):
http://hublog.hubmed.org/archives/001609.html
Unofficially it will return json:
http://scintilla.nature.com/conversations?uri=info%3Adoi%2F10.1371%2Fjournal.pmed.0020124&format=json

* Rochester “Getting Users Fulltext” style code to skip right to the full text, skipping content-provider metadata pages.

* UMich Mirlyn for metadata enrichment?
http://webservices.itcs.umich.edu/mediawiki/MLibraryAPI/index.php/Mirlynapi:Home

* xISBN/thingISBN use. (Some thought is required in how to integrate this while avoiding false positives). Bowker ISSN service for metadata enhancement. OCLC xISSN? Integrate preceding/succeeding title information from OPAC or xISSN?

* LibraryLookup: http://xisbn.worldcat.org/liblook/index.htm At least until xISBN is baked in we could provide a link to this service. Increases the chances of finding a desired book in the catalog through work set grouping. Used by LibX.
http://xisbn.worldcat.org/liblook/resolve.htm?res_id=http://www.iucat.iu.edu&rft.isbn=0451530942&url_ver=Z39.88-2004&rft_val_fmt=info:ofi/fmt:kev:mtx:book

* Journal covers from Ulrich's via screen-scraping (or Ulrich's/sersol built in api?)

* Connotea integration

* Fetch ToC from LC. Screen scrape, I guess? Or z3950? Any other content from LC?

* Link to Books In Print ala Notre Dame.
http://www.library.nd.edu/eresources/findit/findit.cgi?doc_num=001939269&aleph_session=U5AVHRXD5QB1CGDFDSVJ9DSY2UA6QNCGVEU8EYRX9NNMIQ429Q-54668%22
example

* bip search url? :
http://www.booksinprint.com/merge_shared/Search/advsearch.asp%3FdateState%3DY%26txtAction%3D%26BooleanSearch%3D%26SType%3Dadv%26collection%3DBIP%26QueryMode%3DSimple%26ResultCount%3D25%26ResultTemplate%3Dmbbookresult_fl.hts%26navPage%3D1%26SrchFrm%3DAdv%26ScoreThreshold%3D0%26Criteria1%3DISBN%26CriteriaText1%3D0838935370

* SFX plugin: Notice when first title given is non-roman, and look for roman title to enhance metadata with when so.

* HIP and other OPAC searchers should pull ToC from MARC 505 when present. And 856's judged to be ToC in ToC, not full text.

* Fix Umlaut Referent to more easily allow multiple authors. Architectural change neccessary to get a lot of this stuff working right.

* "Cited by" service. Scopus via screen scraping? (scopus javascript api? http://www.scopus.com/scsearchapi/ See also http://hublog.hubmed.org/archives/001512.html ) ISI Web of Science is too hard to even screen scrape the interface is such a mess, but Scopus looks do-able. Google scholar?

* Enhance metadata to have full metadata for a refworks etc export. Using: CrossRef? Metalib? Anything else?

* A general purpose responsecache. Schema: Date, service/source, key. Use for caching image urls, ToC urls from LC, etc.

* Fix Worldcat registry auto-discovery.

* Add a Worldcat search that uses API, instead of screen scrape.

* Switch OCA search to use OCA native APIs, instead of indexdata mirror index.

* fix unapi in umlaut. unapi to rsi? For zotero.

* Change background to use Spawn plugin instead of manual threading. Investigating using spawn with fork instead of thread (terry reese on limited pool of forks).

* Crazy idea for an abstract interface/architecture to support querying web service apis that require client side javascript, like Google Books and Scopus.

* Integrate my various local document delivery services into menu of options when full text isn’t available. More generally, a clear architecture for providing localized doc delivery services in addition to a single ILL link.

* SFX adaptor: Add a "rollup" feature that pays attention to dates to avoid eliminating coverage.

Umlaut wishlist

2010-09-27T20:39:57Z

128.220.205.186:

[[Category:Umlaut]]

Some actual current future plans:

* Fix HathiTrust adapter to use new HT plugin, including not showing fulltext for just portions of a serial. (Or showing it in 'see also' section only)

* Rails3

* Internet Archive -- use new OL/IA api, discover search-inside-the-book.

* WorldCat, use new api, link directly to nearest public library in 'see also' or elsewhere.

'''old''' Desired or planned features.

* Check for similar articles from: http://biosemantics.org/jane/faq.php#api

* Full-text availability check from http://chroniclingamerica.loc.gov/ -- check by title/city, check by lccn (?), able to check particular dates/link to particular dates and/or pages of paper?

* Allow a service_response to have a tree relationship to children, so for instance alternate versions of a text can be attached as children of the main link, expandable by the user.

* http://export.arxiv.org/api_help/ !!!!

* PubMed Central full text lookup http://www.ncbi.nlm.nih.gov/entrez/query/static/esearch_help.html (SFX may already do this?)

* Journal ToC from CiteULike

* Parsing of formatted references from an entry screen. Use http://wing.comp.nus.edu.sg/parsCit/ package. Very interesting! Or a similar UCOP package: http://purl.net/net/egh/hmm-citation-extractor/ See list of such packages here under "Other Parsing Tools" http://freecite.library.brown.edu/

* LibraryThing open knowledge API for more data. http://www.librarything.com/blog/2008/08/free-web-services-api-to-common.php

* Connect to internet linked movie database on movies: http://www.linkedmdb.org/

* Add information about the conversation happening around an article with Scintilla if we have a URL, PMID or DOI (Alf at Scintilla would prefer us NOT to use the API for high-traffic. But we can copy his techniques internally to Umlaut. CrossRef and PubMed for "cited by" on DOI and PMID identifiers are a good idea. He has also reverse engineered the Scopus javascript api to allow server-side json access. http://hublog.hubmed.org/archives/001512.html):
http://hublog.hubmed.org/archives/001609.html
Unofficially it will return json:
http://scintilla.nature.com/conversations?uri=info%3Adoi%2F10.1371%2Fjournal.pmed.0020124&format=json

* Rochester “Getting Users Fulltext” style code to skip right to the full text, skipping content-provider metadata pages.

* UMich Mirlyn for metadata enrichment?
http://webservices.itcs.umich.edu/mediawiki/MLibraryAPI/index.php/Mirlynapi:Home

* xISBN/thingISBN use. (Some thought is required in how to integrate this while avoiding false positives). Bowker ISSN service for metadata enhancement. OCLC xISSN? Integrate preceding/succeeding title information from OPAC or xISSN?

* LibraryLookup: http://xisbn.worldcat.org/liblook/index.htm At least until xISBN is baked in we could provide a link to this service. Increases the chances of finding a desired book in the catalog through work set grouping. Used by LibX.
http://xisbn.worldcat.org/liblook/resolve.htm?res_id=http://www.iucat.iu.edu&rft.isbn=0451530942&url_ver=Z39.88-2004&rft_val_fmt=info:ofi/fmt:kev:mtx:book

* Journal covers from Ulrich's via screen-scraping (or Ulrich's/sersol built in api?)

* Connotea integration

* Fetch ToC from LC. Screen scrape, I guess? Or z3950? Any other content from LC?

* Link to Books In Print ala Notre Dame.
http://www.library.nd.edu/eresources/findit/findit.cgi?doc_num=001939269&aleph_session=U5AVHRXD5QB1CGDFDSVJ9DSY2UA6QNCGVEU8EYRX9NNMIQ429Q-54668%22
example

* bip search url? :
http://www.booksinprint.com/merge_shared/Search/advsearch.asp%3FdateState%3DY%26txtAction%3D%26BooleanSearch%3D%26SType%3Dadv%26collection%3DBIP%26QueryMode%3DSimple%26ResultCount%3D25%26ResultTemplate%3Dmbbookresult_fl.hts%26navPage%3D1%26SrchFrm%3DAdv%26ScoreThreshold%3D0%26Criteria1%3DISBN%26CriteriaText1%3D0838935370

* SFX plugin: Notice when first title given is non-roman, and look for roman title to enhance metadata with when so.

* HIP and other OPAC searchers should pull ToC from MARC 505 when present. And 856's judged to be ToC in ToC, not full text.

* Fix Umlaut Referent to more easily allow multiple authors. Architectural change neccessary to get a lot of this stuff working right.

* "Cited by" service. Scopus via screen scraping? (scopus javascript api? http://www.scopus.com/scsearchapi/ See also http://hublog.hubmed.org/archives/001512.html ) ISI Web of Science is too hard to even screen scrape the interface is such a mess, but Scopus looks do-able. Google scholar?

* Enhance metadata to have full metadata for a refworks etc export. Using: CrossRef? Metalib? Anything else?

* A general purpose responsecache. Schema: Date, service/source, key. Use for caching image urls, ToC urls from LC, etc.

* Fix Worldcat registry auto-discovery.

* Add a Worldcat search that uses API, instead of screen scrape.

* Switch OCA search to use OCA native APIs, instead of indexdata mirror index.

* fix unapi in umlaut. unapi to rsi? For zotero.

* Change background to use Spawn plugin instead of manual threading. Investigating using spawn with fork instead of thread (terry reese on limited pool of forks).

* Crazy idea for an abstract interface/architecture to support querying web service apis that require client side javascript, like Google Books and Scopus.

* Integrate my various local document delivery services into menu of options when full text isn’t available. More generally, a clear architecture for providing localized doc delivery services in addition to a single ILL link.

* SFX adaptor: Add a "rollup" feature that pays attention to dates to avoid eliminating coverage.

Umlaut wishlist

2010-09-27T20:39:39Z

128.220.205.186:

[[Category:Umlaut]]

Some actual current future plans:

* Fix HathiTrust adapter to use new HT plugin, including not showing fulltext for just portions of a serial. (Or showing it in 'see also' section only)

* Rails3

* Internet Archive -- use new OL/IA api, discover search-inside-the-book.

* WorldCat, use new api, link directly to nearest public library in 'see also' or elsewhere.

*old* Desired or planned features.

* Check for similar articles from: http://biosemantics.org/jane/faq.php#api

* Full-text availability check from http://chroniclingamerica.loc.gov/ -- check by title/city, check by lccn (?), able to check particular dates/link to particular dates and/or pages of paper?

* Allow a service_response to have a tree relationship to children, so for instance alternate versions of a text can be attached as children of the main link, expandable by the user.

* http://export.arxiv.org/api_help/ !!!!

* PubMed Central full text lookup http://www.ncbi.nlm.nih.gov/entrez/query/static/esearch_help.html (SFX may already do this?)

* Journal ToC from CiteULike

* Parsing of formatted references from an entry screen. Use http://wing.comp.nus.edu.sg/parsCit/ package. Very interesting! Or a similar UCOP package: http://purl.net/net/egh/hmm-citation-extractor/ See list of such packages here under "Other Parsing Tools" http://freecite.library.brown.edu/

* LibraryThing open knowledge API for more data. http://www.librarything.com/blog/2008/08/free-web-services-api-to-common.php

* Connect to internet linked movie database on movies: http://www.linkedmdb.org/

* Add information about the conversation happening around an article with Scintilla if we have a URL, PMID or DOI (Alf at Scintilla would prefer us NOT to use the API for high-traffic. But we can copy his techniques internally to Umlaut. CrossRef and PubMed for "cited by" on DOI and PMID identifiers are a good idea. He has also reverse engineered the Scopus javascript api to allow server-side json access. http://hublog.hubmed.org/archives/001512.html):
http://hublog.hubmed.org/archives/001609.html
Unofficially it will return json:
http://scintilla.nature.com/conversations?uri=info%3Adoi%2F10.1371%2Fjournal.pmed.0020124&format=json

* Rochester “Getting Users Fulltext” style code to skip right to the full text, skipping content-provider metadata pages.

* UMich Mirlyn for metadata enrichment?
http://webservices.itcs.umich.edu/mediawiki/MLibraryAPI/index.php/Mirlynapi:Home

* xISBN/thingISBN use. (Some thought is required in how to integrate this while avoiding false positives). Bowker ISSN service for metadata enhancement. OCLC xISSN? Integrate preceding/succeeding title information from OPAC or xISSN?

* LibraryLookup: http://xisbn.worldcat.org/liblook/index.htm At least until xISBN is baked in we could provide a link to this service. Increases the chances of finding a desired book in the catalog through work set grouping. Used by LibX.
http://xisbn.worldcat.org/liblook/resolve.htm?res_id=http://www.iucat.iu.edu&rft.isbn=0451530942&url_ver=Z39.88-2004&rft_val_fmt=info:ofi/fmt:kev:mtx:book

* Journal covers from Ulrich's via screen-scraping (or Ulrich's/sersol built in api?)

* Connotea integration

* Fetch ToC from LC. Screen scrape, I guess? Or z3950? Any other content from LC?

* Link to Books In Print ala Notre Dame.
http://www.library.nd.edu/eresources/findit/findit.cgi?doc_num=001939269&aleph_session=U5AVHRXD5QB1CGDFDSVJ9DSY2UA6QNCGVEU8EYRX9NNMIQ429Q-54668%22
example

* bip search url? :
http://www.booksinprint.com/merge_shared/Search/advsearch.asp%3FdateState%3DY%26txtAction%3D%26BooleanSearch%3D%26SType%3Dadv%26collection%3DBIP%26QueryMode%3DSimple%26ResultCount%3D25%26ResultTemplate%3Dmbbookresult_fl.hts%26navPage%3D1%26SrchFrm%3DAdv%26ScoreThreshold%3D0%26Criteria1%3DISBN%26CriteriaText1%3D0838935370

* SFX plugin: Notice when first title given is non-roman, and look for roman title to enhance metadata with when so.

* HIP and other OPAC searchers should pull ToC from MARC 505 when present. And 856's judged to be ToC in ToC, not full text.

* Fix Umlaut Referent to more easily allow multiple authors. Architectural change neccessary to get a lot of this stuff working right.

* "Cited by" service. Scopus via screen scraping? (scopus javascript api? http://www.scopus.com/scsearchapi/ See also http://hublog.hubmed.org/archives/001512.html ) ISI Web of Science is too hard to even screen scrape the interface is such a mess, but Scopus looks do-able. Google scholar?

* Enhance metadata to have full metadata for a refworks etc export. Using: CrossRef? Metalib? Anything else?

* A general purpose responsecache. Schema: Date, service/source, key. Use for caching image urls, ToC urls from LC, etc.

* Fix Worldcat registry auto-discovery.

* Add a Worldcat search that uses API, instead of screen scrape.

* Switch OCA search to use OCA native APIs, instead of indexdata mirror index.

* fix unapi in umlaut. unapi to rsi? For zotero.

* Change background to use Spawn plugin instead of manual threading. Investigating using spawn with fork instead of thread (terry reese on limited pool of forks).

* Crazy idea for an abstract interface/architecture to support querying web service apis that require client side javascript, like Google Books and Scopus.

* Integrate my various local document delivery services into menu of options when full text isn’t available. More generally, a clear architecture for providing localized doc delivery services in addition to a single ILL link.

* SFX adaptor: Add a "rollup" feature that pays attention to dates to avoid eliminating coverage.

Umlaut Deployment

2010-09-27T14:03:54Z

128.220.205.186: /* Apache Setup */

[[Category:Umlaut]]

So you have your Umlaut running by executing "./scripts/server" in the Umlaut directory, and then it launches on port 3000 by default, and you connect to port 3000. This is fine for some initial confirmation that you've got your setup working, and for development, but how do you actually deploy it?

Turns out there are several possible deploy environments for a Rails application. There is not necessarily one standard or best one at the moment, different people use different ones in different circumstances.

Jonathan Rochkind at Hopkins uses mongrel, mongrel_cluster and Apache mod_proxy and mod_proxy_balancer on a unix system for his deploy environment. He went down this road because it was what was recommended by the [http://www.pragprog.com/titles/rails2 Rails Agile Development book]. We may explore other deploy enviroments (such as 'passenger') in the future. We would definitely not be optimistic about running Umlaut on Windows. *Lately mod_rails/Passenger is clearly the preferred Rails deployment in general, and jrochkind wants to find time to set it up and test it, but hasn't yet.*

Since jrochkind is writing this documentation, he can only tell you how to do it how he did. You do need to have a verison of Apache that includes mod_proxy_balancer (> apache 2.2? ), but if you do, jrochkind is fairly happy with the solution.

These two pages from the mongrel website on [http://mongrel.rubyforge.org/wiki/Apache Apache Best Practice Deployment] and [http://mongrel.rubyforge.org/docs/mongrel_cluster.html Using Mongrel Cluster] are pretty good how-tos for mongrel. But we will also take you through it here, with specific directions and Umlaut recommendations and pit-falls we ran into.

== Quick start 'wizard' ==

New! A Rails generator to set up config files for you, and make deployment with mongrel cluster and apache much easier.

=== Prerequisites ===

* Install 'mongrel' and 'mongrel_cluster' gems.
* Apache needs mod_proxy and mod_proxy_balancer (which means it needs to be apache >2.2 I think, and have those modules turned on).
* You need to have access to an apache conf file to add some statements to hook your mongrel cluster up to the web.

=== To run ===

You can simply run ./script/generate mongrel_deploy_files to generate config files for an Umlaut mongrel cluster deployment. This makes some assumptions, detailed below--to change all of these options, run ./script/generate mongrel_deploy_files --help to see command line arguments, if you aren't happy with these defaults.

You can run this command at any time. It will interactively prompt you if you want to overwrite your existing files, and give you a diff. (Or you can say --force to force overwriting of existing files). You can also run ./script/destroy mongrel_deploy_files to remove anything created by the generator.

This process will add two files in umlaut_config/deploy, and one file in $UMLAUT/script/local/. Next, you need to hook up apache, and start your mongrels.

=== default assumptions ===

Several mongrel processes are being configured. By default, this is four mongrel processes on internal ports beginning at port 4001. Both of these things can be changed.

By default these mongrel processes will be run as unix user 'umlaut', group 'umlaut'. So either create such a user or group, or add arguments to choose other user/group.

By default the generator assumes that you are going to be deploying at 'document root' (/) in a particular apache (virtual) host. If you'd like to instead install at a sub-path, use the --prefix argument.

=== Hook up apache ===

A file was created for you in umlaut_config/deploy/umlaut_http.conf. You need to edit your apache conf file to "Include" this umlaut_http.conf in the virtual host of your choice (or main host). You need to set up the virtual host yourself, if you want one. Then simply "Include /path/to/umlaut/config/umlaut_config/deploy/umlaut_http.conf".

=== Start mongrels ===

Apache is now pointing to a balanced cluster of mongrels on the ports specified by the generator, from the path specified by the generator. But those mongrels aren't running yet. You need to start them. You can do this by running:

<pre>
sudo mongrel_rails cluster::start -C /path/to/umlaut/config/umlaut_config/deploy/mongrel_cluster.yml
</pre>

Or, for convenience, the generator installed a little bash script to do this all for you:

<pre>
$UMLAUT/script/local/my_mongrel_ctl (start|stop|restart|status)
</pre>

You can set things up to auto-start your mongrels on boot, see:
[http://mongrel.rubyforge.org/wiki/MongrelCluster#OnBootInitializationSetup]

== The details: Umlaut Deployment with Mongrel and Apache ==

There are basically two parts to getting Umlaut (or any Rails app) deployed in this setup. First is getting your Rails app running, and second is configuring Apache to connect to it properly.

There are a few decisions to make. Run just one instance of Umlaut, or run multiple load balancing instances? Because of the nature of the way Umlaut works, we strongly recommend running multiple Umlaut instances regardless of how little traffic you expect. Even in a low-traffic environment, the fact that Umlaut can take several seconds to respond to a request means that multiple instances are a good idea to keep Umlaut from seeming even slower than it is. We're completely guessing, but 3 is probably a pretty good number for just about any Umlaut site, from low to high traffic.

Also think about whether you what unix account you want to run Umlaut (recommended to create a special low-priv account). And whether your Umlaut URLs can be the base urls for a host (Ie, findit.library.jhu.edu points directly to umlaut), or whether you use a 'prefix' (ie, findit.library.jhu.edu/some/path/findit). Using apache virtual hosts and mounting Umlaut at the base is typical, but the prefix can work too.

=== Setting up mongrel_cluster ===

First you've got to install mongrel and mongrel_cluster:

:sudo gem install mongrel

:sudo gem install mongrel_cluster

'''Reccommend you make sure you have mongrel >= 1.1.4 and mongrel_cluster >= 1.0.5. Recommend you do NOT have previous versions installed. When I had mongrel_cluster 1.0.3 simultaneously installed, it was being used, even though it shouldn't be, and its bugs were effecting me'''

The point of mongrel_cluster is to save configuration information for multiple mongrel instances in one configuration file, and then you can start, stop, or restart them all with one command, and without having to remember that config information each time (and possibly get it wrong or typod).

By default, mongrel_cluster keeps that configuration file in a Rails app's config/mongrel_cluster.yml. You could do that with Umlaut, but we like to keep your local config files in $Umlaut/config/umlaut_config instead (see [[Umlaut Local Configuration Architecture]]), so we recommend putting it in $Umlaut/config/umlaut_config. You can use the mongrel_rails command to write this config for you (see [http://mongrel.rubyforge.org/wiki/MongrelCluster Using Mongrel Cluster]; make sure to use the -C argument to put the config file in umlaut_config, if that's what you want), but here we'll just give you our actual mongrel_cluster.yml config, annotated. (You are certainly allowed to write it by hand).

<pre>

# Unix account to run your processes as:\\
user: umlaut

#Unix group to run processes as:
group: umlaut

# Install dir of Umlaut you want to run from:
cwd: /data/web/findit/Umlaut
log_file: log/mongrel.log # Leave like this.

# Start port for your instances. Any high port will do. Does NOT need need
# to be open through firewall externally.
port: 8000
environment: production # Leave like this
address: 127.0.0.1 # Leave like this
pid_file: tmp/pids/mongrel.pid # Leave like this

# How many instances to run. port: 8000 with servers:3 means you'll
# have a server on 8000, 8001, and 8002.
servers: 3

# Only if you want to start at web path other than base / :
prefix: /findit # for instance. Start with slash, and don't end with one.

</pre>

Now you can start all three of these mongrel instances by executing:

:sudo mongrel_rails cluster::start -C $Umlaut/config/umlaut_config/mongrel_rails

The 'sudo' is necessary because we've told mongrel_cluster to start apps as user 'umlaut' ; first need to be root before you can start a process as another user. Also cluster::stop, cluster::restart, and cluster::status

We're still not sure exactly how many mongrels are neccesary to handle a given sized umlaut installation.

:See below to automate the startup of these processes on boot.

If you are choosing to start as a particular unix account, make sure your install dir can be read by that account! log and tmp dirs need to be writeable too. Easiest thing to do is just "sudo chgrp -R umlaut", or whatever other group you are choosing, your entire $Umlaut installation. Note that the parent directory (and all of it's parents) needs to have "x" permission for the user/group too.

=== Apache Setup ===

Now we set up apache using mod_proxy to 'reverse proxy' to our mongrel instances, with clustered load balancing. Make sure you have mod_proxy and mod_proxy_balancer installed and configured. Now, in your apache conf, proably in the specific virtual host you want to use for Umlaut:

<pre>
# Very important, make sure you aren't inadvertantly making an open proxy with mod_proxy
ProxyRequests off

# Set up the mod_proxy blanacer, with our three instances running on 8000-8002
# Note: Do not put trailing / on these
<Proxy balancer://umlaut_cluster>
BalancerMember http://127.0.0.1:8000
BalancerMember http://127.0.0.1:8001
BalancerMember http://127.0.0.1:8002
</Proxy>

# Set up ProxyPass directive to reverse proxy to SFX for handling SFX journal subscription cgi posts
# This should come before the cluster ProxyPass directive.
ProxyPass /resolve/cgi/core/journal_subscription.cgi http://your.sfx.host.edu:port/your_instance/cgi/core/journal_subscription.cgi
ProxyPassReverse /resolve/cgi/core/journal_subscription.cgi http://your.sfx.host.edu:port/your_instance/cgi/core/journal_subscription.cgi

# Now set up the ProxyPass directives to reverse proxy to that cluster
# Note: DO put trailing / on these.

ProxyPass / balancer://umlaut_cluster/
ProxyPassReverse / balancer://umlaut_cluster/
ProxyPreserveHost on

# Or, if you were using a prefix, these would look like, eg:
# ProxyPass /findit balancer://umlaut_cluster/findit/
# ProxyPassReverse /findit balancer://umlaut_cluster/findit/
</pre>

====SSL/https====

If you are setting up apache to allow https requests, it should still proxy to an http mongrel as above, because mongrel doesn't speak http. However, you should include this line in the relevant SSL virtual host, to set the request header to let the Rails app know it's fronted by ssl:

RequestHeader set X_FORWARDED_PROTO 'https'

=== Dealing with bad query strings: More Apache Setup ===

Mongrel refuses to accept a mal-formed query string. EBSCOHost, however, insists on sending such---for example, query strings with unescaped greater-than or less-than chars in them. We want to take care of this by putting directives in the apache config to rewrite these bad urls into proper escaped urls. The apache mod_redirect external map function is most convenient to use here, and a program to serve as an external map is included with umlaut. The following apache directives will take care of rewriting bad URLs. As always, $Umlaut stands for your Umlaut install dir.

<pre>
# We want to re-write URLs with 'bad' < and > chars in the query
# string (eg from EBSCO) to escape them.
RewriteEngine on
RewriteMap query_escape prg:$umlaut/distribution/script/rewrite_map.pl
RewriteLock /var/lock/subsys/apache.rewrite.lock
RewriteCond %{query_string} ^(.*[\>\<].*)$
RewriteRule ^(.*)$ $1?${query_escape:%1} [R,L,NE]
</pre>

Note: Due to a bug in Apache, ampersand chars in query string end up 'double escaped' when put through the map. We have code in a before filter in application_controller to take care of this.

=== Start at Boot? ===

Follow the directions at [http://mongrel.rubyforge.org/wiki/MongrelCluster#OnBootInitializationSetup Using Mongrel Cluster], which are basically:

<pre>
sudo mkdir /etc/mongrel_cluster
sudo ln -s $UMLAUT/config/umlaut_config/mongrel_cluster.yml /etc/mongrel_cluster/umlaut.yml
sudo cp /path/to/mongrel_cluster_gem/resources/mongrel_cluster /etc/init.d/
sudo chmod +x /etc/init.d/mongrel_cluster</pre>

Now your cluster will start at boot, and you can also start, stop, or restart it (and any other clusters you link into /etc/mongrel_cluster) with:

<pre>
sudo /etc/init.d/mongrel_cluster {start|stop|restart}
</pre>

====NOTE/WARNING====
There is a problem in mongrel_cluster that will prevent mongrels from starting up again if your machine (or mongrels) die ungracefully leaving stale pids. See http://www.ruby-forum.com/topic/105849

My better fix: Edit the /etc/init.d/mongrel_cluster bash script you installed above. Change line:

<pre>
mongrel_cluster_ctl start -c $CONF_DIR
</pre>

to:
<pre>
mongrel_cluster_ctl start -c $CONF_DIR --clean
</pre>

Note the addition of the --clean argument.

I know this works with mongrel 1.1.4 and mongrel_cluster 1.0.5. An earlier mongrel_cluster did not respect the --clean argument properly--and I found that having a simultaenous install of the earlier mongrel_cluster for some reason caused it to be used instead of the later one. gem isn't supposed to work that way. But best make sure you have no mongrel_clusters earlier than 1.0.5 installed.

== SFX Configuration ==

=== Institute Feature ===

This only matters if you use the SFX institute feature. Umlaut sends a req.ip=[client ip] param, which SFX is supposed to use to treat the request as if it came from that IP, not umlaut's ip. That works if the req.ip matches an SFX institute. But if it does not match any institute, you want SFX to treat the request as if it did not match any institute. Instead it consults the actual umlaut server IP and connects THAT to an institute. This is bad.

As a work around, define an institute in SFX that is listed first alphabetically (eg, "aaa_umlaut_server") that matches the Umlaut server's IP address(es). Now if req.ip doesn't match anything, SFX will decide the request matches "aaa_umlaut_server" institute--which won't effect anything, will be treated just like a non-local address--instead of matching on umlaut server address which might match a wrong institute.

This bug has been reported to Ex Libris.

Umlaut Deployment

2010-09-27T14:02:44Z

128.220.205.186:

[[Category:Umlaut]]

So you have your Umlaut running by executing "./scripts/server" in the Umlaut directory, and then it launches on port 3000 by default, and you connect to port 3000. This is fine for some initial confirmation that you've got your setup working, and for development, but how do you actually deploy it?

Turns out there are several possible deploy environments for a Rails application. There is not necessarily one standard or best one at the moment, different people use different ones in different circumstances.

Jonathan Rochkind at Hopkins uses mongrel, mongrel_cluster and Apache mod_proxy and mod_proxy_balancer on a unix system for his deploy environment. He went down this road because it was what was recommended by the [http://www.pragprog.com/titles/rails2 Rails Agile Development book]. We may explore other deploy enviroments (such as 'passenger') in the future. We would definitely not be optimistic about running Umlaut on Windows. *Lately mod_rails/Passenger is clearly the preferred Rails deployment in general, and jrochkind wants to find time to set it up and test it, but hasn't yet.*

Since jrochkind is writing this documentation, he can only tell you how to do it how he did. You do need to have a verison of Apache that includes mod_proxy_balancer (> apache 2.2? ), but if you do, jrochkind is fairly happy with the solution.

These two pages from the mongrel website on [http://mongrel.rubyforge.org/wiki/Apache Apache Best Practice Deployment] and [http://mongrel.rubyforge.org/docs/mongrel_cluster.html Using Mongrel Cluster] are pretty good how-tos for mongrel. But we will also take you through it here, with specific directions and Umlaut recommendations and pit-falls we ran into.

== Quick start 'wizard' ==

New! A Rails generator to set up config files for you, and make deployment with mongrel cluster and apache much easier.

=== Prerequisites ===

* Install 'mongrel' and 'mongrel_cluster' gems.
* Apache needs mod_proxy and mod_proxy_balancer (which means it needs to be apache >2.2 I think, and have those modules turned on).
* You need to have access to an apache conf file to add some statements to hook your mongrel cluster up to the web.

=== To run ===

You can simply run ./script/generate mongrel_deploy_files to generate config files for an Umlaut mongrel cluster deployment. This makes some assumptions, detailed below--to change all of these options, run ./script/generate mongrel_deploy_files --help to see command line arguments, if you aren't happy with these defaults.

You can run this command at any time. It will interactively prompt you if you want to overwrite your existing files, and give you a diff. (Or you can say --force to force overwriting of existing files). You can also run ./script/destroy mongrel_deploy_files to remove anything created by the generator.

This process will add two files in umlaut_config/deploy, and one file in $UMLAUT/script/local/. Next, you need to hook up apache, and start your mongrels.

=== default assumptions ===

Several mongrel processes are being configured. By default, this is four mongrel processes on internal ports beginning at port 4001. Both of these things can be changed.

By default these mongrel processes will be run as unix user 'umlaut', group 'umlaut'. So either create such a user or group, or add arguments to choose other user/group.

By default the generator assumes that you are going to be deploying at 'document root' (/) in a particular apache (virtual) host. If you'd like to instead install at a sub-path, use the --prefix argument.

=== Hook up apache ===

A file was created for you in umlaut_config/deploy/umlaut_http.conf. You need to edit your apache conf file to "Include" this umlaut_http.conf in the virtual host of your choice (or main host). You need to set up the virtual host yourself, if you want one. Then simply "Include /path/to/umlaut/config/umlaut_config/deploy/umlaut_http.conf".

=== Start mongrels ===

Apache is now pointing to a balanced cluster of mongrels on the ports specified by the generator, from the path specified by the generator. But those mongrels aren't running yet. You need to start them. You can do this by running:

<pre>
sudo mongrel_rails cluster::start -C /path/to/umlaut/config/umlaut_config/deploy/mongrel_cluster.yml
</pre>

Or, for convenience, the generator installed a little bash script to do this all for you:

<pre>
$UMLAUT/script/local/my_mongrel_ctl (start|stop|restart|status)
</pre>

You can set things up to auto-start your mongrels on boot, see:
[http://mongrel.rubyforge.org/wiki/MongrelCluster#OnBootInitializationSetup]

== The details: Umlaut Deployment with Mongrel and Apache ==

There are basically two parts to getting Umlaut (or any Rails app) deployed in this setup. First is getting your Rails app running, and second is configuring Apache to connect to it properly.

There are a few decisions to make. Run just one instance of Umlaut, or run multiple load balancing instances? Because of the nature of the way Umlaut works, we strongly recommend running multiple Umlaut instances regardless of how little traffic you expect. Even in a low-traffic environment, the fact that Umlaut can take several seconds to respond to a request means that multiple instances are a good idea to keep Umlaut from seeming even slower than it is. We're completely guessing, but 3 is probably a pretty good number for just about any Umlaut site, from low to high traffic.

Also think about whether you what unix account you want to run Umlaut (recommended to create a special low-priv account). And whether your Umlaut URLs can be the base urls for a host (Ie, findit.library.jhu.edu points directly to umlaut), or whether you use a 'prefix' (ie, findit.library.jhu.edu/some/path/findit). Using apache virtual hosts and mounting Umlaut at the base is typical, but the prefix can work too.

=== Setting up mongrel_cluster ===

First you've got to install mongrel and mongrel_cluster:

:sudo gem install mongrel

:sudo gem install mongrel_cluster

'''Reccommend you make sure you have mongrel >= 1.1.4 and mongrel_cluster >= 1.0.5. Recommend you do NOT have previous versions installed. When I had mongrel_cluster 1.0.3 simultaneously installed, it was being used, even though it shouldn't be, and its bugs were effecting me'''

The point of mongrel_cluster is to save configuration information for multiple mongrel instances in one configuration file, and then you can start, stop, or restart them all with one command, and without having to remember that config information each time (and possibly get it wrong or typod).

By default, mongrel_cluster keeps that configuration file in a Rails app's config/mongrel_cluster.yml. You could do that with Umlaut, but we like to keep your local config files in $Umlaut/config/umlaut_config instead (see [[Umlaut Local Configuration Architecture]]), so we recommend putting it in $Umlaut/config/umlaut_config. You can use the mongrel_rails command to write this config for you (see [http://mongrel.rubyforge.org/wiki/MongrelCluster Using Mongrel Cluster]; make sure to use the -C argument to put the config file in umlaut_config, if that's what you want), but here we'll just give you our actual mongrel_cluster.yml config, annotated. (You are certainly allowed to write it by hand).

<pre>

# Unix account to run your processes as:\\
user: umlaut

#Unix group to run processes as:
group: umlaut

# Install dir of Umlaut you want to run from:
cwd: /data/web/findit/Umlaut
log_file: log/mongrel.log # Leave like this.

# Start port for your instances. Any high port will do. Does NOT need need
# to be open through firewall externally.
port: 8000
environment: production # Leave like this
address: 127.0.0.1 # Leave like this
pid_file: tmp/pids/mongrel.pid # Leave like this

# How many instances to run. port: 8000 with servers:3 means you'll
# have a server on 8000, 8001, and 8002.
servers: 3

# Only if you want to start at web path other than base / :
prefix: /findit # for instance. Start with slash, and don't end with one.

</pre>

Now you can start all three of these mongrel instances by executing:

:sudo mongrel_rails cluster::start -C $Umlaut/config/umlaut_config/mongrel_rails

The 'sudo' is necessary because we've told mongrel_cluster to start apps as user 'umlaut' ; first need to be root before you can start a process as another user. Also cluster::stop, cluster::restart, and cluster::status

We're still not sure exactly how many mongrels are neccesary to handle a given sized umlaut installation.

:See below to automate the startup of these processes on boot.

If you are choosing to start as a particular unix account, make sure your install dir can be read by that account! log and tmp dirs need to be writeable too. Easiest thing to do is just "sudo chgrp -R umlaut", or whatever other group you are choosing, your entire $Umlaut installation. Note that the parent directory (and all of it's parents) needs to have "x" permission for the user/group too.

=== Apache Setup ===

Now we set up apache using mod_proxy to 'reverse proxy' to our mongrel instances, with clustered load balancing. Make sure you have mod_proxy and mod_proxy_balancer installed and configured. Now, in your apache conf, proably in the specific virtual host you want to use for Umlaut:

<pre>
# Very important, make sure you aren't inadvertantly making an open proxy with mod_proxy
ProxyRequests off

# Set up the mod_proxy blanacer, with our three instances running on 8000-8002
# Note: Do not put trailing / on these
<Proxy balancer://umlaut_cluster>
BalancerMember http://127.0.0.1:8000
BalancerMember http://127.0.0.1:8001
BalancerMember http://127.0.0.1:8002
</Proxy>

# Set up ProxyPass directive to reverse proxy to SFX for handling SFX journal subscription cgi posts
# This should come before the cluster ProxyPass directive.
ProxyPass /resolve/cgi/core/journal_subscription.cgi http://your.sfx.host.edu:port/your_instance/cgi/core/journal_subscription.cgi
ProxyPassReverse /resolve/cgi/core/journal_subscription.cgi http://your.sfx.host.edu:port/your_instance/cgi/core/journal_subscription.cgi

# Now set up the ProxyPass directives to reverse proxy to that cluster
# Note: DO put trailing / on these.

ProxyPass / balancer://umlaut_cluster/
ProxyPassReverse / balancer://umlaut_cluster/
ProxyPreserveHost on

# Or, if you were using a prefix, these would look like, eg:
# ProxyPass /findit balancer://umlaut_cluster/findit/
# ProxyPassReverse /findit balancer://umlaut_cluster/findit/
</pre>

=== Dealing with bad query strings: More Apache Setup ===

Mongrel refuses to accept a mal-formed query string. EBSCOHost, however, insists on sending such---for example, query strings with unescaped greater-than or less-than chars in them. We want to take care of this by putting directives in the apache config to rewrite these bad urls into proper escaped urls. The apache mod_redirect external map function is most convenient to use here, and a program to serve as an external map is included with umlaut. The following apache directives will take care of rewriting bad URLs. As always, $Umlaut stands for your Umlaut install dir.

<pre>
# We want to re-write URLs with 'bad' < and > chars in the query
# string (eg from EBSCO) to escape them.
RewriteEngine on
RewriteMap query_escape prg:$umlaut/distribution/script/rewrite_map.pl
RewriteLock /var/lock/subsys/apache.rewrite.lock
RewriteCond %{query_string} ^(.*[\>\<].*)$
RewriteRule ^(.*)$ $1?${query_escape:%1} [R,L,NE]
</pre>

Note: Due to a bug in Apache, ampersand chars in query string end up 'double escaped' when put through the map. We have code in a before filter in application_controller to take care of this.

=== Start at Boot? ===

Follow the directions at [http://mongrel.rubyforge.org/wiki/MongrelCluster#OnBootInitializationSetup Using Mongrel Cluster], which are basically:

<pre>
sudo mkdir /etc/mongrel_cluster
sudo ln -s $UMLAUT/config/umlaut_config/mongrel_cluster.yml /etc/mongrel_cluster/umlaut.yml
sudo cp /path/to/mongrel_cluster_gem/resources/mongrel_cluster /etc/init.d/
sudo chmod +x /etc/init.d/mongrel_cluster</pre>

Now your cluster will start at boot, and you can also start, stop, or restart it (and any other clusters you link into /etc/mongrel_cluster) with:

<pre>
sudo /etc/init.d/mongrel_cluster {start|stop|restart}
</pre>

====NOTE/WARNING====
There is a problem in mongrel_cluster that will prevent mongrels from starting up again if your machine (or mongrels) die ungracefully leaving stale pids. See http://www.ruby-forum.com/topic/105849

My better fix: Edit the /etc/init.d/mongrel_cluster bash script you installed above. Change line:

<pre>
mongrel_cluster_ctl start -c $CONF_DIR
</pre>

to:
<pre>
mongrel_cluster_ctl start -c $CONF_DIR --clean
</pre>

Note the addition of the --clean argument.

I know this works with mongrel 1.1.4 and mongrel_cluster 1.0.5. An earlier mongrel_cluster did not respect the --clean argument properly--and I found that having a simultaenous install of the earlier mongrel_cluster for some reason caused it to be used instead of the later one. gem isn't supposed to work that way. But best make sure you have no mongrel_clusters earlier than 1.0.5 installed.

== SFX Configuration ==

=== Institute Feature ===

This only matters if you use the SFX institute feature. Umlaut sends a req.ip=[client ip] param, which SFX is supposed to use to treat the request as if it came from that IP, not umlaut's ip. That works if the req.ip matches an SFX institute. But if it does not match any institute, you want SFX to treat the request as if it did not match any institute. Instead it consults the actual umlaut server IP and connects THAT to an institute. This is bad.

As a work around, define an institute in SFX that is listed first alphabetically (eg, "aaa_umlaut_server") that matches the Umlaut server's IP address(es). Now if req.ip doesn't match anything, SFX will decide the request matches "aaa_umlaut_server" institute--which won't effect anything, will be treated just like a non-local address--instead of matching on umlaut server address which might match a wrong institute.

This bug has been reported to Ex Libris.

Umlaut URL parameters

2010-09-27T14:00:07Z

128.220.205.186:

[[Category:Umlaut]]

Umlaut has a few custom URL parameters (can also be sent in a POST request) to control Umlaut behavior. All start with the prefix "umlaut.". These are generally added onto an OpenURL GET request.

===umlaut.request_id===

Specify an already created OpenURL request to act upon. Without this, Umlaut will still try to connect to an already created request *within the same session* based on a cache of OpenURLs seen in that session. But this process is not perfect. With umlaut.request_id, you can assure you are operating on the same request, and even if the client does not have cookies or a session.

===umlaut.referent_id===

Specify an Umlaut Referent object to re-use. Umlaut referent object represents a particular citation. Unlike umlaut.request_id, won't re-use an entire request (with responses and state), but only the specified citation.

===umlaut.skip_resolve_menu===

Set to "false" to override umlaut's configuration for conditionally skipping the the resolve menu and going straight to content. umlaut.skip_resolve_menu=false forces display of full resolve menu.

===umlaut.skip_resolve_menu_for_type===

Set to the name(s) of [http://umlaut.rubyforge.org/svn/trunk/db/orig_fixed_data/service_type_values.yml Umlaut service types] (comma delimited), to force menu skipping (direct linking) for the first response found from any of the service types named.

===umlaut.link_with_frameset===

Set to "false" to force direct linking *without* the banner/frameset, just direct to vendor url.

===umlaut.response_format===

Generally used for API requests, value can be "xml", "json", or "jsonp". In case of jsonp, umlaut.jsonp=jsFunctionName can be used to determine the js function name that will be generated with the [http://ajaxian.com/archives/jsonp-json-with-padding jsonp output]

Umlaut URL parameters

2010-09-20T20:18:45Z

128.220.205.186:

[[Category:Umlaut]]

Umlaut has a few custom URL parameters (can also be sent in a POST request) to control Umlaut behavior. All start with the prefix "umlaut.". These are generally added onto an OpenURL GET request.

===umlaut.force_https_link===

When present and set to any value, causes all absolute urls to be generated with https, even if the Umlaut app doesn't think it was accessed over https. Useful for certain kinds of reverse proxy deployment where it really is being accessed https, but the Rails app doesn't know it.

===umlaut.request_id===

Specify an already created OpenURL request to act upon. Without this, Umlaut will still try to connect to an already created request *within the same session* based on a cache of OpenURLs seen in that session. But this process is not perfect. With umlaut.request_id, you can assure you are operating on the same request, and even if the client does not have cookies or a session.

===umlaut.referent_id===

Specify an Umlaut Referent object to re-use. Umlaut referent object represents a particular citation. Unlike umlaut.request_id, won't re-use an entire request (with responses and state), but only the specified citation.

===umlaut.skip_resolve_menu===

Set to "false" to override umlaut's configuration for conditionally skipping the the resolve menu and going straight to content. umlaut.skip_resolve_menu=false forces display of full resolve menu.

===umlaut.skip_resolve_menu_for_type===

Set to the name(s) of [http://umlaut.rubyforge.org/svn/trunk/db/orig_fixed_data/service_type_values.yml Umlaut service types] (comma delimited), to force menu skipping (direct linking) for the first response found from any of the service types named.

===umlaut.link_with_frameset===

Set to "false" to force direct linking *without* the banner/frameset, just direct to vendor url.

===umlaut.response_format===

Generally used for API requests, value can be "xml", "json", or "jsonp". In case of jsonp, umlaut.jsonp=jsFunctionName can be used to determine the js function name that will be generated with the [http://ajaxian.com/archives/jsonp-json-with-padding jsonp output]

Umlaut

2010-05-06T15:02:57Z

128.220.205.186: /* APIs */

Umlaut is [[OpenURL]] link resolving middleware that adds functions and services to commercial link resolving software such as [[SFX]].

[[Category:Umlaut]]

==More information==

[[About Umlaut]] - A gentle introduction to what Umlaut is and what it can do for you.

[http://bibwild.wordpress.com/2008/10/16/umlaut-digital-book/ Digital Text Features] - A tour of some of the 'advanced' digital text features, with a demos pointing to JHU site, hosted on jrochkind's blog.

[http://rubyforge.org/mail/?group_id=4382 Umlaut Listserv]

[http://umlaut.rubyforge.org/ Rubyforge home page for developers]

[[Umlaut wishlist]]

==Installation and Configuration==

[[Umlaut Installation]]

[[Umlaut Setup]]

[[Umlaut_Deployment]]

==Documentation==

===Overview===

[http://umlaut.rubyforge.org/api/ Umlaut API Documentation]

[[Umlaut Technical Overview]]

[[Umlaut_Deployment]]

[[Umlaut Local Configuration Architecture]]

===Specific Topics===

[[Umlaut URL parameters]]

[[Umlaut logging]]

[[Umlaut SFX statistics gotchas]]

====APIs====

[[Umlaut full API]]

[[Umlaut partial html API]]

[[Umlaut partial html API javascript helper]]

[[JQuery HTML Updater]]

====Developer Notes====
[[Notes for a User/Auth architecture]]

Code4Lib Journal Voting

2010-03-18T20:14:02Z

128.220.205.186:

''See also [[Code4Lib Journal Deadlines]]''

Articles and proposals need at least two yes votes and two more yes votes than no votes to be approved. Abstentions are not counted at all (same as not voting at all).

* 2 yes, 2 no => Fails
* 2 yes, 1 no => Fails
* 2 yes, 0 no => Passes
* 3 yes, 1 no => Passes
* 1 yes, 0 no => Fails

This is the general voting method we use for most decisions that require a vote.

[[Category: Code4Lib Journal]]

C4L2010 social activities

2010-02-17T15:42:30Z

128.220.205.186: /* Newcomer Dinner Signup */

==Code4Lib 2010 social activities ==

==Ideas==
[http://www.citizen-times.com/apps/pbcs.dll/article?AID=2009912010314 New breweries opening]

[http://digital.library.appstate.edu/code4lib2010.html Original Proposal (suggests some nearby events)]

[http://ashevilletwitterhashtags.blogspot.com/2009/09/asheville-beer-avlbeer.html Asheville Beer Hashtag]

==Planned events==

Plan one if you like! Either on your own or you can [[Committees_sign-up_page|join the social activities committee]].

== Asheville Brews Cruise ==

"Experience a taste of Asheville’s thriving local beer scene with an exclusive tour of three of our award-winning microbreweries." - http://www.brewscruise.com/asheville/

A big shout out to [http://www.talis.com Talis] for stepping up and sponsoring a portion of this event. Our first stop on the cruise will be a brewery slash pizza joint and Talis has generously offered to pay for our pizza. Yay!

==== Itinerary ====

# Pickup from the hotel is tentatively scheduled for 6:15pm. Those who haven't pre-paid should try to get there a little early.
# Stop #1 will be the Asheville Pizza & Brewing Co. where we will sample 16-20 different beers and consume our delicious, alcohol-absorbing, [http://www.talis.com Talis]-sponsored pizza.
# Stop #2 will be Highland Brewing Company, "Asheville's 1st and largest brewing company"
# Stop #3 will be the French Broad Brewery which "specializes in a variety of European style beers."
# Expected return to the hotel is around 9:30-10pm

==== Cost & Payment ====

The cost for the cruise is $40 per person. You have two options for paying:

# Pay in advance by sending me $40 via [http://paypal.com PayPal].
# Bring $40 with you on the night of the cruise. I've been told they have a hand-held credit card machine for the cash-strapped.

Anyone who wants to can pay via PayPal, but I need at least 16 people to choose this option because the tour company wants to pre-bill my credit card for a minimum of 16 guests. There should be no fees involved if the money comes from your PayPal account or an associated bank account. The deadline for paying in advance is EOD Sunday, February 21st.

# Go to [http://paypal.com PayPal]
# Click on "Send Money"
# Enter lbjay@reallywow.com in the "To" field
# Enter your own address in the "From" field (unless you're logged in)
# Click the "Personal" tab and choose "Payment owed" from the options
# Click "Continue"
# On the next page you can specify a message Subject of "Brews Cruise"

==== Signup ====

'''Sorry, the event is full!''' We were forced to set a limit of 48 persons due to that's the max number of folks that will fit into two party buses, plus we don't want to overwhelm the staffs at the breweries. There is, however, is a waitlist that someone started below.

# Jay Luker (organizing, not driving)
# Mike Giarlo (inebriator)
# Rob Casson (drunk)
# Declan Fleming (beer receptacle)
# Jim Safley (recovering teetotaler)
# Ian Walls (epicurean of ale)
# Christopher Spalding (thirsty)
# Jon Gorman (imbiber of that which is good)
# Lori Stethers (token female)
# Carol Ou (beer enthusiast)
# Cristóbal Palmer (Reinheitsgebot skeptic)
# Tod Olson (enabler)
# Mark Matienzo (alefounder)
# Sibyl Schaefer (barfly)
# Tania Fersenheim (Gold Medalist - Ithaca Beerlympics - Summer 1993)
# Melissa Manolis (Beer lacky and Librarian Groupie)
# Greg McClellan (master of beerology and beeronomy)
# Cary Gordon (hip hoppist)
# Mark Gallagher (Thing 1)
# Matt Bachtell (Thing 2)
# Sarah Kahn (has no title)
# Thom Cox (afraid of rectangles)
# Eric James (pour)
# Ray Schwartz (mighty thirsty)
# Jason Stirnaman (all about the stout)
# Mike Flakus (ipa all the way)
# Ben Florin (sounds neat--what's "beer"?)
# Ryan Wick (it comes in pints?)
# Sam Kome (have churchkey, will travel)
# Joe Atzberger
# Brendan Gallagher
# Chris Beer
# Tom Keays (growler)
# Ross Singer (empty vessel waiting to be filled)
# Eric Hellman (49 IBU)
# Paul Joseph (i bike leer)
# Cody Hennesy (don't mind if i do)
# Michael Vandenburg
# Stephen Meyer (Wisconsinite)
# Antonio Barrera
# Andrew Nagy
# Rosalyn Metz
# Esmé Cowles
# Dea Rice (Duchess of Ales)
# Sean Hannan (Peer Pressured)
# Scott Garrison (just made it by the froth of his beer?)
# Dan Suchy ( [no longer] late and now full of gratitude) (berick: Dan, you get my spot. you better get double drunk for me!)
# Brad Westbrook

'''There is a max of 48 persons for this event. Sorry!'''

===== Wait List =====

I'll try to monitor the waitlist and add folks automatically if someone else drops out. Would be a good idea to specify an email address or some other means of contact so that I can notify you if you make it in.

# Spencer Lamm (slamm1 at swarthmore.edu)
# Robert Haschart

== 12 Bones BBQ Dinner Excursion ==
(was a lunch excursion)

[http://www.12bones.com/ 12 Bones BBQ] is widely considered the best BBQ in Asheville [[http://www.yelp.com/biz/12-bones-smokehouse-asheville *]]. However it is only open from 11-4, M-F. We would like to organize a group so that we can rent out the place on Wednesday night. If we get at least 50 people, it will be doable.

'''When:''' Wednesday, February 24th

'''Time:''' 6:30pm

'''Where:''' 5 Riverside Drive Asheville NC, 28801

==== BBQ Excursion Signup ====

For the time being please indicate interest in the BBQ excursion by adding your name to the list below. We'll figure out a way to coordinate and communicate the details somewhere down the line.

# Rosalyn Metz (the new organizer)
# Jay Luker (demoted but still devoted)
# Mike Giarlo (consumer)
# Rob Casson (glutton)
# Declan Fleming (condor)
# Erik Hatcher (carnivore)
# Christopher Spalding (digs swine)
# Mike Durbin (Porkaholic)
# Jeremy Frumkin (alloftheabove)
# Jon Gorman (Aficionado of smoke, flame, and good sauces)
# Michael Klein (EAT PIG)
# Mark Matienzo (saucy fellow)
# Cary Gordon (do they have vegan pig?)
# Sibyl Schaefer (finger licker)
# Greg McClellan (Mmmm... Pig)
# Ranti Junus (beef and chicken cheerleader)
# Tania Fersenheim (can't think of any non-vulgar tag lines)
# Matt Bachtell (hope they have vinegar based BBQ)
# Ray Schwartz (I eat vegetarians)
# Dileshni Jayasinghe (I just like to eat)
# Joe Atzberger (con carne)
# Michael Doran (a YES for Wednesday night)
# Thom Cox (ancho pepper addict)
# Chris Strauber (meat and flame!)
# Cindy Harper (I'm sorry, Babe)
# Brendan Gallagher
# Chris Beer
# Alexander O'Neill
# Bess Sadler
# Joyce Ouchida
# Ross Singer (Some Pig)
# Tod Olson (omnivore sans dilemma)
# Paul Joseph
# Vinita Tuteja
# Robin Hitch
# Ryan Wick
# Becky Yoose (bringing the wetwipe napkins)
# Joyce Chapman
# Andrew Darby
# Cory Lown
# Peter Murray (who knows that NC BBQ means one has to actually add the BBQ sauce)
# Jean Rainwater
# Matt Cordial
# Carol Ou (dinnertime excursion works for me)
# Karen Coombs
# Dan Lucas
# Gerald Snyder
# Michael Silver
# Julia Bauder (dinner partier)
# Jørn Thøgersen
# Michael Poltorak Nielsen
# Toke Eskildsen
# Mads Villadsen (the Danes are coming for Wednesday night BBQ!)
# Andreas Orphanides (I want to go to there.)
# Michael Vandenburg
# Wendy Huot
# David Bucknum
# Jason Casden
# Graham Stewart
# Joseph Ryan
# Dhanushka Samarakoon
# Eric Crenshaw
# Katherine Lynch
# Stephen Meyer
# Antonio Barrera (whats a BBQ without me)
# Ron Peterson
# Andrew Nagy (no witty comment)
# Corey Harper (Mmmmmm..... Carolina Pulled Pig)
# Eric Palmitesta
# Ben Florin
# Emily Lynema (pulled pork delicious)
# Erik Mitchell (Who could turn down an 80 person dinner experience?)
# Mike Flakus (pulled-porker)
# Matt Connolly (Memphian)
# Ian Walls
# Benjamin Young (BBQ is a noun)
# Esmé Cowles
# Tim Dennis
# Harry Kaplanian

'''Sorry there is an 80 person limit for this event'''

'''Wait List'''
# Ryan Scherle
# Amy McGuire
# Jason Battles
# Hong Ma
# Vanessa Meireles
# Mark Diggory
# Jonathan Rochkind
# Robert Haschart

==Vegetarian Dinner (Weds, AKA BBQ night)==

[http://opheliasworldcafe.info/ Ophelia's World Cafe and Bar] does vegetarian, vegan, raw, gluten-free, sustainable seafood, and locally-raised meat products, with a focus on local and organic. Also, a full bar. [http://www.yelp.com/biz/ophelias-world-cafe-and-bar-asheville yelp reviews].

* max of 30 people
* meet at hotel to walk together - 6:30pm
* We are confirmed with the restaurant - reservation is at 6:45
* email Anna3LC if you have any questions - gmail

# Jodi Schneider
# Maccabee Levine (token male)
# Eric Hellman (token carnivore)
# Carol Bean
# Sam Kome (omnivorous w/exception of BBQ)
# Dea Rice (Socialite)
# Sean Hannan (token token collector)
# Vidhya Arvind
# Cristóbal Palmer
# Lori Stethers
# Rick Johnson
# Anna Headley
# Kevin Clarke
# Gabriel Farrell
# Eric James
# Betsy Coles
# Harish Maringanti
# Emily Molanphy
# Shawn Averkamp
# Kevin Reiss
# Birkin
# Jon Stroop
# Birong Ho
# William Denton
# Gretchen Gueguen
# Steven Shelton
# Banurekha Lakshminarayanan
# Dan Brubaker Horst
# Martin Mehrling
# Dan Chudnov
# '''We're full!'''

'''Wait List'''
# Erin Germ
# Naomi Dushay
# Shekhar Krishnan
# Schuyler Erle

== Newcomer Dinner ==
First time at code4lib? Join fellow c4l newbies and veterans for an evening of food, socializing, and stimulating discussions about the many uses of bacon.

Code4Lib veterans, you're invited too. Join us in welcoming the newcomers!

'''Tentative plans (more information to come)'''
* When: Monday evening
* Time: 6 PM
* Where: Meet in the hotel lobby. Restaurants - Look below
* Mastermind (if you have any questions): [mailto:yoosebj@muohio.edu Becky Yoose]

=== Newcomer Dinner Signup ===

Clarification - you can still sign up if you didn't intially list your name the first time around. Sorry for any misunderstandings on my part. -_-;

'''Restaurants'''

''Guidelines:''
*Max of '''8''' per location
**Please, no waitlisting :(
*ID yourselves so we can get a good mix of new people and veterans
**New folks - n
**c4l vets - v
*One leader needed for each location (code4lib vets only)
**Leader duties
***Make reservations if required; otherwise make sure that the restaurant can handle a group of 8 rowdy library coders
***Herd folks from hotel to restaurant (know where you're going!)

'''Spots still available below! 2/11 - added a couple more restaurants to make sure everyone has a spot!'''

[http://www.ichibanwasabi.com/ Wasabi Japanese Restaurant & Sushi Bar] (Japanese)
# [Leader] Ranti Junus - v
# Caitlin Shanley - n
# Erin White - n
# Chris Strauber - n
# Jodi Schneider - v
# Joyce Chapman - n
# Susan Teague Rector (sort of a newb...)

[http://www.trippsrestaurants.com/ Tripps Restaurant] (Steakhouse)
# [Leader]
#

[http://tableasheville.com/page/276-home Table] (“New American”)
# [Leader] Devon Smith - v
# Anna Headley - n
# Cory Rockliff - n
# Jeff Sherwood - n
# Emily King - n
# Laurie Sutherland - n
# Jonathan Rochkind - v

[http://www.mellowmushroom.com/ Mellow Mushroom Pizza Bakers] (Pizza)
# [Leader]
#

[http://limonesrestaurant.com/page/1240-Home Limones] (Mexican)
# [Leader]
#

[http://www.salsas-asheville.com/ Salsas] (Mexican-Caribbean)
# [Leader] Jay Luker - v
# Gabriel Farrell - v
# Sean Hannan - v
# Scot Colford - v
# Chrissy Rissmeyer - n

[http://www.bistro1896.com/index.php?option=com_content&task=view&id=14&Itemid=42 Bistro 1896] (Bistro)
# [Leader]
# Yuka Egusa - n
# Masao Takaku - n

[http://www.jackofthewood.com/ Jack of the Wood] (another pub for y'all)
# [Leader]
#

'''Sorry, these are full'''

[http://www.vincenzos.com/ Vincenzo's] (Italian)
# [Leader] Bess Sadler - v
# Thom Cox - n
# Alexander O'Neill - n
# Leland Deeds - n
# Erin Germ - n
# Joe Atzberger - v
# Cindy Harper - n
# Vinita Tuteja - n
# '''Sorry - full'''

[http://www.doccheys.com/menu/ Doc Chey’s Noodle House] (Asian)
# [Leader] Emily Lynema - v
# Julia Bauder - n
# Joe Marquez - n
# Jason Battles - n
# Jill Ellern - n
# Michael Vandenburg -n
# Shekhar Krishnan
# Schuyler Erle
# '''Sorry - full'''

[http://ashevillebouchon.com/page/2511-Home Bouchon French Bistro] (French)
# [Leader] Ben Florin -v
# Gwen Exner - n
# Joel Richard - n (super-green!)
# Dan Lucas - n
# Hong Ma - n
# Vanessa Meireles - n
# Mark Diggory - n (but not green)
# David Woodbury - n
# '''Sorry - full'''

[http://www.melaasheville.com/ Mela Indian Restaurant] (Indian) (reservation made for 6:15 under Darby)
# [Leader] Andrew Darby - v
# Joyce Ouchida - n
# Eric Celeste (spy) - n
# Kossivi (Jean-Paul) Bessou - n
# Steven Shelton - n
# Jeff Silvis - n
# Ya'aqov Ziso - n
# Banurekha - n
# '''Sorry - full'''

[http://rosettaskitchen.com/our-menu Rosetta's Kitchen] (Vegetarian)
# [Leader] Rosalyn Metz -v
# Cody Hennesy - n
# Sam Kome - n
# John Yorio - n
# Shawn Averkamp - n
# Sarah Kahn- n
# Cory Lown - n
# Maccabee Levine - n
# '''Sorry - full'''

[http://www.suwanathaiorchid.com/index.php Suwana's Thai Orchid Restaurant] (Thai)
# [Leader] Becky Yoose - v
# Andy Mardesich - n
# Amy McGuire
# Birong HO
# Ryan Scherle - n
# Mark Mounts - n
# Dan Brubaker Horst -n
# Rick Johnson - n
# '''Sorry - full'''

[http://thelobstertrap.biz/ The Lobster Trap] (Seafood)
# [Leader] Michael Klein - v
# Janis Mathewson - n
# Karen Schwentner - n
# Tom Bennett - n
# Carol Ou - v
# Kenny Ketner - n
# Mike Flakus - n
# Michael Doran - v
# '''Sorry - full'''

[http://www.ashevillebiergarden.com/ The Bier Garden (Pub)]
# [Leader] Mike Giarlo - v
# Dileshni Jayasinghe - n
# David Bucknum - n
# Sean Chen - n
# Sibyl Schaefer - n
# Dan Suchy - n
# Mark Matienzo - v
# Declan Fleming - v
# '''Sorry - full'''
# Eric Palmitesta -n (WAITLISTED!) - (BY note - Hi Eric, can you please choose from the available list above? Thanks! [Hey, Eric, you might sign up for Jack of the Wood. Good beer there as well! -MJG])

Cut and paste your name to the restaurant of your choice :)
* Ross Singer
* Monica Claassen-Wilson
* Brendan Gallagher
* Schuyler Erle
* Tim Shearer
* Michael Silver
* Jason Stirnaman
* Patrick Hochstenbach
* David Chandek-Stark
* David Kennedy
* Paul Joseph
* Clint Bellanger
* Wendy Huot
* Robin Hitch
* Cary Gordon (likes anything that involves food)
* Graham Stewart
* David Woodbury
* Antonio Barrera
* Andrew Nagy
* Harry Kaplanian
* Scott Garrison
* Kevin Reiss

== Werewolf! ==
It wouldn't be a tech conference unless we got together one evening to turn into a gang of murdering beasts and hyper-suspicious victims. Facilitated by the one and only mbklein.

* When: Wednesday evening
* Time: 8 PM
* Where: TBA. Watch this space.

=== About Werewolf ===

Werewolf (also known as Mafia) is a parlor game that has become [http://www.wired.co.uk/wired-magazine/archive/2010/03/features/werewolf.aspx the obsession of techie conferences everywhere]. At it's most basic, it's a game of information asymmetry -- a battle between an uninformed majority (the townspeople) and an informed minority (the werewolves who live and hunt among them). At its best, it's an off-the-wall paranoid screaming match. There are dozens of variations -- we'll start with the basics, and depending on everyone's stamina and desire to keep playing, save the tricky stuff for later. Hopefully by the end of the evening all the participants will be jibbering, jumpy, sleep-deprived lunatics incapable of trusting even their closest friends.

In other words, ''good times.''

=== Werewolf signup ===
* Michael Klein
* Alexander O'Neill
* Bess Sadler
* Leland Deeds
* Jean Rainwater
* Chris Beer
* Wendy Huot
* Jon Gorman
* Jodi Schneider
* Birkin (will arrive after the veggie-dinner, and hoping BBQ-ers will have time to make it, too)
* Harish (ditto)
* Jon Stroop
* Joel Marchesoni (tentative)
* Martin Mehrling
* Michael Vandenburg
* Scot Colford
* Chrissy Rissmeyer

== Working Out ==

Gotta make up for those beer and BBQ excursions somehow. Let's work out! Ideas: hiking, jogging, [http://www.crossfitasheville.com CrossFitting], surfing,...

=== CrossFit Asheville ===
[http://www.crossfitasheville.com CrossFit Asheville]
Contacted the gym, we're invited to the Monday night 6:30pm slot.

Who's in?
* Erik Hatcher (crossfit newb), can carpool three others
* Michael Vandenburg (Crossfit curious)
* Jeff Sherwood (I'd be into getting in a Crossfit WOD or maybe a run)
* Jason Stirnaman (hiking, biking - don't mind the weather, lifting, cross-fitting)
* Jodi Schneider (CrossFitting sounds fun if we can fit in their schedule, yoga, walking, hiking)

=== Jogging ===
Meet in lobby at 6:30am any day next week.

* Monday: Erik Hatcher (too cold? I'll do the treadmill instead; 2-3 miles max)
* Tuesday:
* Wednesday: Erik Hatcher (2-3 miles max)
* Thursday:

=== Interested Parties for various exercise activities ===

* Erik Hatcher (game for both short, like 2 mile, jogs on Monday/Wednesday and CrossFitting, bring it!)
* Erik Mitchell (Run downtown asheville or the parkway? - great 12 mile climb up the parkway around Pisgah Mtn.), How about a Code4Lib half-marathon? (Why NOT! Let's do a Half Marathon) - Ray Schwartz
**Bike riding - yes might be sketchy given our current weather
**Hike up Looking Glass Rock [http://www.hikewnc.info/trailheads/pisgah/pisgah/guidedhikes/lookingglassrock.html]
* Emily Lynema (game for jogging, hiking, walking, jumping jacks; not crazy enough for parkway running!)
* Ray Schwartz (game for a run - why not a half marathon?!).
* Rick Johnson (Looking to fit in a 10, 12 ,and 8 mile run while in town. Was originally thinking I would go early in the morning: 6:30 or 7. May not be able to run together everytime but definitely looking for suggestions on good routes)
* Thom Cox (lifting, cardio, yoga--all good)
* Jason Stirnaman (hiking, biking - don't mind the weather, lifting, cross-fitting)
* Jean Rainwater (need to get some runs in where the footing's not treacherous and the temp is above freezing)
* Gerald Snyder (a couple mornings jogging would be good, but only 4 or 5 miles for me thanks)
* Jodi Schneider (CrossFitting sounds fun if we can fit in [http://www.crossfitasheville.com/schedule/ their schedule], yoga, walking, hiking)
* Becky Yoose (hiking (intermediate level max), walking, cheer others on while they run a half marathon)
* Carol Bean (does shivering in the cold count as exercise?)
* John Barneson (I'm game for a.m. runs 5-10 miles. I would love a nice scenic route and I don't mind trail running)
* Gabriel Farrell (running, yoga, pickup soccer?)
* Kevin Reiss (running/hiking)
* Jeff Sherwood (I'd be into getting in a Crossfit WOD or maybe a run)
* Nick Hanssens (yoga; I teach if there is space and interest)
* Michael Vandenburg (Crossfit curious)
* Ranti Junus (yoga, walking, thumb wrestling - maybe)
* Mark Diggory (surfing,... kinda hard to find good waves in Asheville... will settle for a little hiking)

== Sitting in a room together and half the time talking to each other out loud and half the time talking in IRC ==

Because you know it's going to happen

* William Denton
* Mike Giarlo (fulfiller of destinies)
* /ignore mjgiarlo
* Antonio Barrera (trying to avoid a repeat of Portland)
* Jodi Schneider (one of the highlights!!!)
* Bess Sadler (can it be in the hospitality suite at 4am? That's the best!)
* Mark Matienzo
* Ranti Junus (hoping somebody can help me hacking my chumby one to install [http://elinks.or.cz/ elinks] or [http://www.qtweb.net/ qtweb])
* Dan Chudnov (hoping for in-same-room IRC chat to be an olympic medal event in 2014)

[[Category: Code4Lib2010]]

C4L2010rideshare

2010-02-16T22:05:56Z

128.220.205.186: /* Asheville/Arden Regional Airport */

== Rideshare Info ==

Several people have made vague but curious noises about trying to share transportation to and from Asheville. This page will attempt to organize the details relevant to help attendees make appropriate travel/transportation plans.

Each table below represents a group of attendees with relatively common transportation needs. Feel free to combine/split/add tables to suit different needs. The columns should be self-explanatory, with '''Driving?''' indicating that you're willing/able to share the driving (even if it's someone else's car/rental), and '''Van?''' indicating whether you would be interested in taking one of the App. State vans (if it were to make a couple runs to the airport).

=== Charlotte Douglas International Airport ===
{| border="1" cellpadding="5" class="sortable"
|- style="text-align: left;"
! Name !! Arriving !! Departing !! Renting Car? !! Share rental cost? !! Gas? !! Driving? !! Van?
|-
| <strike>Julia Bauder</strike> || <strike>2010-02-21 (Sunday; mid-afternoon)</strike> || <strike>2010-02-25 (Thursday; late afternoon)</strike> || || || || ||
|-
| <strike>Michael Klein</strike> || <strike>2010-02-21 (Sunday; late afternoon/evening)</strike> || <strike>2010-02-26 (Friday)</strike> || || || || ||
|-
| Tim Dennis || 2010-02-21 (Sunday; 4pm) || 2010-02-25 (Thurs. 5pm) || No || Yes || Yes || Yes || Yes
|-
| [http://alphagconsulting.com/mailform.php John Craig] || 2010-02-21 (Sunday; 5pm) || 2010-02-25 (Thurs. 4pm) || Yes || Yes || Yes || Me || No
|-
| [mailto:rosalynmetz@gmail.com Rosalyn Metz] || 2010-02-22 (Monday; 1pm) || 2010-02-25 (Thurs. 8pm) || Yes || Yes || Yes || Me || No
|-
| [mailto:jbowen@library.rochester.edu Jennifer Bowen] || 2010-02-22 (Monday; 11am) || 2010-02-25 (Thurs. 4pm) || Yes || Yes || Yes || Me || No
|}

=== Asheville/Arden Regional Airport ===

'''[[Asheville Airport to Hotel Van Manifest]]'''

{| border="1" cellpadding="5" class="sortable"
|- style="text-align: left;"
! Name !! Arriving !! Departing !! Renting Car? !! Share rental cost? !! Gas? !! Driving? !! Van? !! Confirmed on Manifest
|-
| [mailto:scolford@bpl.org Scot Colford] || 2010-02-21 (Sunday) 12:15pm || 2010-02-25 (Thursday) 2:26pm || Yes || Yes || Yes || Yes || No || N/A
|-
| Mark Matienzo || 2010-02-21 (Sunday) 11:38am || 2010-02-25 (Thursday) 3:21pm || No || Yes || Yes || Yes || Yes || Arrival Y
|-
| Edward Corrado || 2010-02-21 (Sunday) 11:38am || 2010-02-26 (Thursday) 4:35pm || No || Yes || Yes || No || Yes || Arrival Y
|-
| Mike Giarlo || 2010-02-21 (Sunday) 11:38am || 2010-02-26 (Friday) 12:03pm || No || Yes || Yes || No || Yes || Arrival Y
|-
| Daniel Lovins || 2010-02-21 (Sunday) 11:57am || 2010-02-25 (Thursday) 2:21pm || No || Yes || Yes || Yes || Yes || Arrival Y
|-
| Tom Keays || 2010-02-21 (Sunday) 12:09pm || 2010-02-25 (Thursday) 12:55pm || No || Yes || Yes || No || Yes || Arrival Y
|-
| Jean Rainwater || 2010-02-21 (Sunday) 12:15pm || 2010-02-26 (Thursday) 4:00pm || No || Yes || Yes || No || Yes || Arrival Y
|-
| Yvonne Federowicz || 2010-02-21 (Sunday) ? || 2010-02-26 (Thursday) ? || No || Yes || Yes || No || Yes || No times
|-
| Chris Beer || 2010-02-21 (Sunday) 3:44pm || 2010-02-26 (Friday) 12:55pm || No || No || Yes || No || Yes || Arrival Y
|-
| Andy Kohler || 2010-02-21 (Sunday) 3:50pm || 2010-02-25 (Thursday) 4:17pm || No || No || No || No || Yes || Arrival ??
|-
| Tod Olson || 2010-02-21 (Sunday) 3:50pm || 2010-02-25 (Thursday) 4:17pm || No || No || No || No || Yes || Arrival Y (c)
|-
| Betsy Coles || 2010-02-21 (Sunday) 3:50pm || 2010-02-25 (Thursday) 4:17pm || No || No || No || No || Yes || Arrival Y
|-
| Monica Claassen-Wilson || 2010-02-21 (Sunday) 4:05pm || 2010-02-25 (Thursday) 4:30pm || No || No || No || No || Yes || Arrival ??
|-
| Michael Doran || 2010-02-21 (Sunday) 6:14pm || 2010-02-26 (Friday) 11:25am || No || No || No || No || Yes || Arrival Y
|-
| Roy Tennant || 2010-02-21 (Sunday) 6:14pm || 2010-02-25 (Thursday) 12:55pm || No || No || No || No || Yes || Arrival Y
|-
| Andrew Darby || 2010-02-21 (Sunday) 6:15pm || 2010-02-26 (Friday) 11:25am || No || Yes || Yes || No || Yes || Arrival Y
|-
| Jason Stirnaman (+1) || 2010-02-21 (Sunday) 6:34pm || 2010-02-27 (Saturday) 12:55pm || No || Yes || Yes || No || Yes || Arrival Y
|-
| Sam Kome || 2010-02-21 (Sunday) 7:50pm || 2010-02-25 (Thursday) 4:30pm || No || Yes || Yes || Yes || Yes || Arrival Y
|-
| Anjanette Young || 2010-02-21 (Sunday) 7:50pm || 2010-02-25 (Thursday) 3:21pm || No || Yes || Yes || No || Yes || Arrival Y (c)
|-
| Dhanushka S || 2010-02-21 (Sunday) 8:39pm || 2010-02-25 (Thursday) 2:26pm || No || Yes || Yes || Yes || Yes || Arrival Y
|-
|<strike> Tim McGeary</strike> || <strike>2010-02-22 (Monday) 9:35pm</strike> || <strike>2010-02-25 (Thursday) 4:30pm</strike> || || || || || ||
|-
| Cody Hennesy || 2010-02-21 (Sunday) 9:55pm || 2010-02-25 (Thursday) 4:17pm || No || Yes || Yes || No || Yes || Arrival Y
|-
| Lori Stethers || 2010-02-21 (Sunday) 10:55pm || 2010-02-25 (Thursday) 2:15pm || No || Yes || Yes || Yes || Yes || Arrival Y
|-
| Carol Bean || 2010-02-21 (Sunday) 11:56am || 2010-02-25 (Thursday) 2:15pm || No || Yes || Yes || Yes || Yes || Arrival Y
|-
| Ranti Junus || <strike>2010-02-21 (Sunday) 11:30am</strike><br/> 2010-02-20 (Saturday) 11:30am || 2010-02-25 (Thursday) 4:30pm || No || Yes || Yes || No || Yes || *
|-
| Julia Bauder || 2010-02-21 (Sunday) 2:56pm || 2010-02-25 (Thursday) 2:15pm || No || Yes || Yes || Yes || Yes || Arrival Y
|-
| Matt Connolly || 2010-02-22 (Monday) 3:34pm || 2010-02-25 (Thursday) 4:06pm || No || Yes || Yes || Yes || Yes || Arrival Y
|-
| Eric Hellman || 2010-02-22 (Monday) 3:34pm || 2010-02-25 (Thursday) 4:06pm || No || Yes || Yes || Yes || Yes || Arrival Y
|-
| Jon Gorman || 2010-02-21 (Sunday) 3:50pm || NA || No || Yes (for Sunday) || Yes (for Sunday) || Yes (for Sunday) || Yes || Arrival Y
|-
| Joe Atzberger || 2010-02-21 (Sunday) 4:05pm || 2010-02-25 (Thursday) 4:35pm || No || Yes || Yes || No || Yes || Arrival Y
|-
| Joe Marquez || 2010-02-21 (Sunday) 11:48pm || 2010-02-25 (Thursday) 2:15pm || No || No || Yes || No || Yes || Arrival Y (c)
|-
| Matt Cordial || 2010-02-21 (Sunday) 6:34pm || 2010-02-25 (Thursday) 2:15pm || No || Yes || Yes || Yes || Yes || Arrival Y
|-
| David Bucknum || 2010-02-21 (Sunday) 12:09pm || 2010-02-25 (Thursday) 4:00pm || No || No || No || No || Yes || Arrival Y
|-
| Janis Mathewson || 2010-02-21 (Sunday) 11:38am || 2010-02-25 (Friday) 12:05pm || No || Yes || Yes || No || Yes || Arrival Y
|-
| Karen Schwenter || 2010-02-21 (Sunday) 11:38am || 2010-02-25 (Friday) 12:05pm || No || Yes || Yes || No || Yes || Arrival Y
|-
| Ryan Wick || 2010-02-21 (Sunday) 3:50pm || 2010-02-25 (Thursday) 5:35pm || No || Yes || Yes || No || Yes || Arrival Y
|-
| Declan Fleming || 2010-02-21 (Sunday) 9:54pm || 2010-02-25 (Friday) 2:26pm || No || Yes || Yes || No || Yes || Arrival Y
|-
| Sibyl Schaefer || 2010-02-21 (Sunday) 10:55pm || 2010-02-24 (Thursday) 12:05pm || No || No || No || No || Yes || Arrival Y
|-
| Maccabee Levine || 2010-02-21 (Sunday) 11:38am || 2010-02-25 (Thursday) 4:35pm || No || No || No || No || Yes || Arrival Y
|-
| [mailto:Michael.Klein@oregonstate.edu Michael Klein] || 2010-02-18 (Thursday) || 2010-02-26 (Friday) 5:35pm || No || No || No || No || Yes || *
|-
| Karen Coombs || 2010-02-21 (Sunday) 6:34pm || 2010-02-25 (Thursday) 6:57pm || No || No || No || No || Yes || Arrival Y? (c)
|-
| Mike Lindsey || 2010-02-21 (Sunday) 4:05pm || 2010-02-24 (Thursday) 11:00am || No || No || Yes|| Yes || Yes || Arrival Y
|-
| Rick Johnson || 2010-02-21 (Sunday) 3:51pm || 2010-02-25 (Thursday) 04:17pm || No || No || No || No || Yes || Arrival Y
|-
| Banurekha Lakshminarayanan || 2010-02-21 (Sunday) 5:09pm || 2010-02-25 (Thursday) 04:30pm || No || No || No || No || Yes || Arrival Y
|-
| Dan Brubaker Horst || 2010-02-21 (Sunday) 3:51pm || 2010-02-25 (Thursday) 04:17pm || No || No || No || No || Yes || Arrival Y
|-
| Tania Fersenheim || 2010-02-20 (Saturday) 3:34pm || 2010-02-25 (Thursday) 2:26pm || No || No || No || No || Yes || *
|-
| Greg McClellan || 2010-02-20 (Saturday) 3:34pm || 2010-02-25 (Thursday) 2:26pm || No || No || No || No || Yes || *
|-
| Matthew Beacom || 2010-02-22 (Monday) 11:57am || 2010-02-25 (Thursday) 3:21pm || No || No || yes || No || Yes || Arrvial Y (c)
|-
| Hong Ma || 2010-02-21 (Sunday) 11:57am || 2010-02-25 (Thursday) 4:30pm || No || No || No || No || Yes || Arrival Y? (c)
|-
| Vanessa Meireles || 2010-02-21 (Sunday) 11:57am || 2010-02-25 (Thursday) 4:30pm || No || No || No || No || Yes || Arrival Y? (c)
|-
| Spencer Lamm || 2010-02-21 (Sunday) 8:49pm || 2010-02-25 (Thursday) 2:26pm || No || No || No || No || Yes || Arrival Y
|-
| Kevin Reiss || 2010-02-21 (Sunday) 12:15pm || 2010-02-25 (Thursday 4:06pm || No || No || No || No || Yes || Arrival Y? (c)
|-
| Antonio Barrera || 2010-02-21 (Sunday) 12:15pm || 2010-02-25 (Thursday 4:06pm || No || No || No || No || Yes || Arrival Y? (c)
|-
| <strike>Jon Stroop</strike> || 2010-02-21 (Sunday) 12:15pm || 2010-02-25 (Thursday 4:06pm || No || No || No || No || Yes ||
|-
| Cory Rockliff || 2010-02-20 (Saturday) 12:15pm || 2010-02-25 (Thursday) 4:06pm || No || No || No || No || Yes || *
|-
| Corey Harper || 2010-02-22 (Monday) 12:30pm || 2010-02-26 (Friday) 1:07pm || No || No || No || No || Yes || *
|-
| Carol Ou || 2010-02-22 (Monday) 2:56pm || 2010-02-25 (Thursday) 4:30pm || No || Yes || Yes || No || Yes || Arrival Y
|-
| Eric James || 2010-02-21 (Monday) 12:15pm || 2010-02-25 (Thursday) 4:06pm || No || Yes || Yes || Yes || Yes ||
|-
| Jonathan Rochkind || 2010-02-20 (Sunday) 6:15pm || 2010-02-25 (Thursday) 4:00pm || || || || || ||
|}

=== Northeast (VA/DC/MD/DE/PA/NJ/NY/New England) ===
{| border="1" cellpadding="5" class="sortable"
|- style="text-align: left;"
! Name !! Traveling From !! Plan to Arrive !! Plan to Depart !! Car? !! Share rental cost? !! Gas? !! Driving?
|-
| Ray Schwartz || New York City Metro || Before Preconferences || Thurs aftn || no, willing to rent || Yes || Yes || Yes
|-
| <strike>Cory Rockliff</strike> || New York City Metro || Before Preconferences || Thurs aftn || no, willing to rent || Yes || Yes || No
|-
| Yitzchak Schaffer || NJ (near Secaucus) || Monday (not for precon), negotiable || Thurs aftn || no, willing to rent || yes || yes || yes
|-
| Jodi Schneider || NJ Turnpike/Philly Metro || Before Preconferences || Thurs aftn || no || Yes || Yes || No
|-
| Erin Germ || DC/Baltimore/Annapolis || Monday Evening || Thurs aftn || Yes || no || Yes || Yes
|}

=== Kentucky/Michigan/Ohio/West Virginia ===
{| border="1" cellpadding="5" class="sortable"
|- style="text-align: left;"
! Name !! Traveling From !! Plan to Arrive !! Plan to Depart !! Car? !! Share rental cost? !! Gas? !! Driving?
|-
| Peter Murray || Columbus, OH || Monday afternoon || Thursday after conference close || Yes || Yes || Yes || Yes
|-
| Becky Yoose || Oxford, OH || Sunday afternoon (before preconference) || Thursday after conference close || Yes || N/A || Yes || Yes
|-
| Devon Smith || Columbus, OH || Monday early || Friday || Yes (rental) || Yes || Yes || Yes
|}

=== North Carolina ===
{| border="1" cellpadding="5" class="sortable"
|- style="text-align: left;"
! Name !! Traveling From !! Plan to Arrive !! Plan to Depart !! Car? !! Share rental cost? !! Gas? !! Driving?
|-
| <strike>Sean Chen</strike>|| <strike>Chapel Hill, NC</strike> || <strike>Sunday</strike> || <strike>Thursday</strike>|| <strike>Yes</strike> || <strike>Yes </strike> || <strike>Yes</strike> || <strike>Yes</strike>
|-
| Erin White || Triangle, NC || Sunday || Thursday or Friday || Yes || Yes || Yes || Yes
|}

=== Southeast (South Carolina, Georgia, Florida) ===
{| border="1" cellpadding="5" class="sortable"
|- style="text-align: left;"
! Name !! Traveling From !! Plan to Arrive !! Plan to Depart !! Car? !! Share rental cost? !! Gas? !! Driving?
|-
| Benjamin Young || Greenville, SC || Early Tuesday morning (pre-8 am) || Thursday after conference close || Yes || No || Yes || Yes
|-
| Chris Strauber || Spartanburg SC || || Thursday after conference close || No || Yes || Yes--will buy gas and lunch || Yes
|-
| Esmé Cowles || Gainesville, FL || Sunday || Thursday after conference close || Yes || No || Yes || Yes
|}

[[Category: Code4Lib2010]]

Asheville Airport to Hotel Van Manifest

2010-02-16T22:00:59Z

128.220.205.186: /* Asheville Airport to Hotel (Arrivals) */

Manifest for Van shuttle for Asheville Airport to/from Hotel.

== Instructions ==
We have two minivans (WCU and ASU) that can hold a maximun of 6 passengers with their bags per trip. Based on then information provided by the attendees on the Rideshare Wiki as of Feb 10, 2010, we create 10 arrival loads (currently there is no Load 5 but it can be added back if need be). These arrival loads are numbered. We also created 11 departure loads. These are lettered. It may be possible to add loads but '''please...don't add loads yourself to the tables.''' Add your info to the bottom of the rideshare page indicating that you are not in the manifest and we will see if we can add additional loads. Email Jill Ellern directly if you have any questions.

If your already on this list, '''please make sure your flight information is correct''' on both the arrival and the departure list. Passengers need to '''send an email to confirm their slot''' (check the email about this service sent to the big Code4Lib list). Once Kevin has receive this email, we will update the "Confirmed" column.

If you wish to use an empty slot in a load, please add your information both in this manifest and the rideshare table. Make sure to send the email to confirm your slot with your email and cell phone information. The email list we create from your sent information will be used to send further instructons about gathering locations at the airport and hotel. We might need to contact your cell phone if there are delays and problems.

== Asheville Airport to Hotel (Arrivals) ==

'''* approximate times depending upon traffic and flight delays'''

{| border="1" cellpadding="5" style="text-align: left;"
|- style="background:lightgrey;"
! Day !! Load Run Number !! Leaving Hotel !! Arriving Airport* !! Leaving Airport* !! At Hotel !! Passenger !! Arrival Time* !! Sent email/cell to committee !! Confirmed
|-

| Sunday || Load 1 (ASU) || 11:00 AM || 11:30 AM || 12:00 PM || 12:30 PM || Matienzo || 11:38 AM || Yes || Yes
|-
| Sunday || Load 1 (ASU) || 11:00 AM || 11:30 AM || 12:00 PM || 12:30 PM || Corrado || 11:38 AM || Yes || Yes
|-
| Sunday || Load 1 (ASU) || 11:00 AM || 11:30 AM || 12:00 PM || 12:30 PM || Giarlo || 11:38 AM || Yes || Yes
|-
| Sunday || Load 1 (ASU) || 11:00 AM || 11:30 AM || 12:00 PM || 12:30 PM || Mathewson || 11:38 AM || Yes || Yes
|-
| Sunday || Load 1 (ASU) || 11:00 AM || 11:30 AM || 12:00 PM || 12:30 PM || Schwenter || 11:38 AM || Yes || Yes
|-
| Sunday || Load 1 (ASU) || 11:00 AM || 11:30 AM || 12:00 PM || 12:30 PM || Levine || 11:38 AM || Yes || Yes
|- style="background:lightgrey;"
! Day !! Load Run Number !! Leaving Hotel !! Arriving Airport* !! Leaving Airport* !! At Hotel !! Passenger !! Arrival Time* !! Sent email/cell to committee !! Confirmed
|-

| Sunday || Load 2 (WCU) || 11:30 AM || 12:00 PM || 12:45 PM || 1:15 PM || Bean || 11:56 AM || Yes || Yes
|-
| Sunday || Load 2 (WCU) || 11:30 AM || 12:00 PM || 12:45 PM || 1:15 PM || Lovins || 11:57 AM || Yes || Yes
|-
| Sunday || Load 2 (WCU) || 11:30 AM || 12:00 PM || 12:45 PM || 1:15 PM || Keays || 12:09 PM || Yes || Yes
|-
| Sunday || Load 2 (WCU) || 11:30 AM || 12:00 PM || 12:45 PM || 1:15 PM || Bucknum || 12:09 PM || Yes || Yes
|-
| Sunday || Load 2 (WCU) || 11:30 AM || 12:00 PM || 12:45 PM || 1:15 PM || Rainwater || 12:15 PM || Yes || Yes
|-
| Sunday || Load 2 (WCU) || 11:30 AM || 12:00 PM || 12:45 PM || 1:15 PM || Meyer || 11:38 AM || Yes || Yes
|- style="background:lightgrey;"
! Day !! Load Run Number !! Leaving Hotel !! Arriving Airport* !! Leaving Airport* !! At Hotel !! Passenger !! Arrival Time* !! Sent email/cell to committee !! Confirmed
|-

| Sunday || Load 2b (ASU) || 12:45 pM || 1:15 PM || 1:30 PM || 2:00 PM || Ma || 11:57 AM || No || No
|-
| Sunday || Load 2b (ASU) || 12:45 pM || 1:15 PM || 1:30 PM || 2:00 PM ||Meireles || 11:57 AM || No || No
|-
| Sunday || Load 2b (ASU) || 12:45 pM || 1:15 PM || 1:30 PM || 2:00 PM ||Reiss || 12:15 PM || No || No
|-
| Sunday || Load 2b (ASU) || 12:45 pM || 1:15 PM || 1:30 PM || 2:00 PM ||Barrera || 12:15 PM || No || No
|-
| Sunday || Load 2b (ASU) || 12:45 pM || 1:15 PM || 1:30 PM || 2:00 PM || || || No || No
|-
| Sunday || Load 2b (ASU) || 12:45 pM || 1:15 PM || 1:30 PM || 2:00 PM || || || No || No
|- style="background:lightgrey;"
! Day !! Load Run Number !! Leaving Hotel !! Arriving Airport* !! Leaving Airport* !! At Hotel !! Passenger !! Arrival Time* !! Sent email/cell to committee !! Confirmed
|-
| Sunday || Load 3 (ASU) || 2:30 PM || 3:00 PM || 3:30 PM || 4:00 PM || Bauder || 2:56 PM || Yes || Yes
|-
| Sunday || Load 3 (ASU) || 2:30 PM || 3:00 PM || 3:30 PM || 4:00 PM || || || No || No
|-
| Sunday || Load 3 (ASU) || 2:30 PM || 3:00 PM || 3:30 PM || 4:00 PM || || || No || No
|-
| Sunday || Load 3 (ASU) || 2:30 PM || 3:00 PM || 3:30 PM || 4:00 PM || || || No || No
|-
| Sunday || Load 3 (ASU) || 2:30 PM || 3:00 PM || 3:30 PM || 4:00 PM || || || No || No
|-
| Sunday || Load 3 (ASU) || 2:30 PM || 3:00 PM || 3:30 PM || 4:00 PM || || || No || No
|- style="background:lightgrey;"
! Day !! Load Run Number !! Leaving Hotel !! Arriving Airport* !! Leaving Airport* !! At Hotel !! Passenger !! Arrival Time* !! Sent email/cell to committee !! Confirmed
|-
| Sunday || Load 3b (Car?) || 3:30 pm|| 4:00 PM || 4:30 PM || 5:00 PM ||Kohler || 3:50 pm || No || No
|-
| Sunday || Load 3b (Car?) || 3:30 pm|| 4:00 PM || 4:30 PM || 5:00 PM ||Claasen-Wilson || 4:04 || No || No
|-

|- style="background:lightgrey;"
! Day !! Load Run Number !! Leaving Hotel !! Arriving Airport* !! Leaving Airport* !! At Hotel !! Passenger !! Arrival Time* !! Sent email/cell to committee !! Confirmed
|-
| Sunday || Load 4 (WCU) || 3:15 PM || 3:45 PM || 4:30 PM || 5:00 PM || Beer || 3:44 PM || Yes || Yes
|-
| Sunday || Load 4 (WCU) || 3:15 PM || 3:45 PM || 4:30 PM || 5:00 PM || Olson || 3:50 PM || Yes || Yes
|-
| Sunday || Load 4 (WCU) || 3:15 PM || 3:45 PM || 4:30 PM || 5:00 PM || Wick || 3:50 PM || Yes || Yes
|-
| Sunday || Load 4 (WCU) || 3:15 PM || 3:45 PM || 4:30 PM || 5:00 PM || Coles || 3:50 PM || Yes || Yes
|-
| Sunday || Load 4 (WCU) || 3:15 PM || 3:45 PM || 4:30 PM || 5:00 PM || Gorman || 3:50 PM || Yes || Yes
|-
| Sunday || Load 4 (WCU) || 3:15 PM || 3:45 PM || 4:30 PM || 5:00 PM || Garrison || 3:50 PM || Yes || No
|- style="background:lightgrey;"
! Day !! Load Run Number !! Leaving Hotel !! Arriving Airport* !! Leaving Airport* !! At Hotel !! Passenger !! Arrival Time* !! Sent email/cell to committee !! Confirmed
|-

| Sunday || Load 5 (ASU) || 4:15 PM || 4:45 PM || 5:15 PM || 5:45 PM || Lindsey || 4:05 PM || Yes || Yes
|-
| Sunday || Load 5 (ASU)|| 4:15 PM || 4:45 PM || 5:15 PM || 5:45 PM || Atzberger || 4:05 PM || Yes || Yes
|-
| Sunday || Load 5 (ASU) || 4:15 PM || 4:45 PM || 5:15 PM || 5:45 PM || Johnson || 3:51 PM || Yes || Yes
|-
| Sunday || Load 5 (ASU) || 4:15 PM || 4:45 PM || 5:15 PM || 5:45 PM || Lakshminarayanan || 5:09 PM || Yes || Yes
|-
| Sunday || Load 5 (ASU) || 4:15 PM || 4:45 PM || 5:15 PM || 5:45 PM || Brubaker Horst || 3:51 PM || Yes || Yes
|-
| Sunday || Load 5 (ASU) || 4:15 PM || 4:45 PM || 5:15 PM || 5:45 PM || Kohler || || Yes || Yes
|- style="background:lightgrey;"
! Day !! Load Run Number !! Leaving Hotel !! Arriving Airport* !! Leaving Airport* !! At Hotel !! Passenger !! Arrival Time* !! Sent email/cell to committee !! Confirmed|-
|-
| Sunday || Load 6 (WCU) || 5:45 PM || 6:15 PM || 7:00 PM || 7:30 PM || Tennant || 6:14 PM || Yes || Yes
|-
| Sunday || Load 6 (WCU) || 5:45 PM || 6:15 PM || 7:00 PM || 7:30 PM || Doran || 6:14 PM || Yes || Yes
|-
| Sunday || Load 6 (WCU) || 5:45 PM || 6:15 PM || 7:00 PM || 7:30 PM || Darby || 6:15 PM || Yes || Yes
|-
| Sunday || Load 6 (WCU) || 5:45 PM || 6:15 PM || 7:00 PM || 7:30 PM || Stirnaman (1) || 6:34 PM || Yes || Yes
|-
| Sunday || Load 6 (WCU) || 5:45 PM || 6:15 PM || 7:00 PM || 7:30 PM || Stirnaman (2) || 6:34 PM || Yes || Yes
|-
| Sunday || Load 6 (WCU) || 5:45 PM || 6:15 PM || 7:00 PM || 7:30 PM || Cordial || 6:34 PM || Yes || Yes
|- style="background:lightgrey;"
! Day !! Load Run Number !! Leaving Hotel !! Arriving Airport* !! Leaving Airport* !! At Hotel !! Passenger !! Arrival Time* !! Sent email/cell to committee !! Confirmed
|-
| Sunday || Load 6a (ASU) || 6:00 PM || 6:30 PM || 7:15 PM || 7:45 PM ||Coombs || 6:34 pm || No || No
|-
| Sunday || Load 6a (ASU) || 6:00 PM || 6:30 PM || 7:15 PM || 7:45 PM || J. Rochkind|| 6:15 pm || No || No
|-
| Sunday || Load 6a (ASU) || 6:00 PM || 6:30 PM || 7:15 PM || 7:45 PM || || || No || No
|-
| Sunday || Load 6a (ASU) || 6:00 PM || 6:30 PM || 7:15 PM || 7:45 PM || || || No || No
|-
| Sunday || Load 6a (ASU) || 6:00 PM || 6:30 PM || 7:15 PM || 7:45 PM || || || No || No
|-
| Sunday || Load 6a (ASU) || 6:00 PM || 6:30 PM || 7:15 PM || 7:45 PM || || || No || No
|- style="background:lightgrey;"
! Day !! Load Run Number !! Leaving Hotel !! Arriving Airport* !! Leaving Airport* !! At Hotel !! Passenger !! Arrival Time* !! Sent email/cell to committee !! Confirmed
|-
| Sunday || Load 7 (WCU) || 8:00 PM || 8:30 PM || 9:00 PM || 9:30 PM || Kome || 7:50 PM || Yes || Yes
|-
| Sunday || Load 7 (WCU) || 8:00 PM || 8:30 PM || 9:00 PM || 9:30 PM || Young || 7:50 PM || No || No
|-
| Sunday || Load 7 (WCU) || 8:00 PM || 8:30 PM || 9:00 PM || 9:30 PM || Dhanushka || 8:39 PM || Yes || Yes
|-
| Sunday || Load 7 (WCU) || 8:00 PM || 8:30 PM || 9:00 PM || 9:30 PM || Crenshaw || 8:39 PM || Yes || Yes
|-
| Sunday || Load 7 (WCU) || 8:00 PM || 8:30 PM || 9:00 PM || 9:30 PM || Harish || 8:39 PM || Yes || Yes
|-
| Sunday || Load 7 (WCU) || 8:00 PM || 8:30 PM || 9:00 PM || 9:30 PM || Lamm || 8:39 PM || Yes || Yes
|- style="background:lightgrey;"
! Day !! Load Run Number !! Leaving Hotel !! Arriving Airport* !! Leaving Airport* !! At Hotel !! Passenger !! Arrival Time* !! Sent email/cell to committee !! Confirmed
|-

| Sunday || Load 8 (ASU) || 9:30 PM || 10:00 PM || 10:30 PM || 11:00 PM || Fleming || 9:54 PM || Yes || Yes
|-
| Sunday || Load 8 (ASU) || 9:30 PM || 10:00 PM || 10:30 PM || 11:00 PM || Hennesy || 9:55 PM || Yes || Yes
|-
| Sunday || Load 8 (ASU) || 9:30 PM || 10:00 PM || 10:30 PM || 11:00 PM || || || No || No
|-
| Sunday || Load 8 (ASU) || 9:30 PM || 10:00 PM || 10:30 PM || 11:00 PM || || || No || No
|-
| Sunday || Load 8 (ASU) || 9:30 PM || 10:00 PM || 10:30 PM || 11:00 PM || || || No || No
|-
| Sunday || Load 8 (ASU) || 9:30 PM || 10:00 PM || 10:30 PM || 11:00 PM || || || No || No
|- style="background:lightgrey;"
! Day !! Load Run Number !! Leaving Hotel !! Arriving Airport* !! Leaving Airport* !! At Hotel !! Passenger !! Arrival Time* !! Sent email/cell to committee !! Confirmed
|-

| Sunday || Load 9 (WCU) || 10:30 PM || 11:00 PM || 11:30 PM || 12:00 AM || Stethers || 10:55 PM || Yes || Yes
|-
| Sunday || Load 9 (WCU) || 10:30 PM || 11:00 PM || 11:30 PM || 12:00 AM || Schaefer || 10:55 PM || Yes || Yes
|-
| Sunday || Load 9 (WCU) || 10:30 PM || 11:00 PM || 11:30 PM || 12:00 AM || Huot || 10:55 PM || Yes || Yes
|-
| Sunday || Load 9 (WCU) || 10:30 PM || 11:00 PM || 11:30 PM || 12:00 AM || Vandenburg || 10:55 PM || Yes || Yes
|-
| Sunday || Load 9 (WCU) || 10:30 PM || 11:00 PM || 11:30 PM || 12:00 AM || || || No || No
|-
| Sunday || Load 9 (WCU) || 10:30 PM || 11:00 PM || 11:30 PM || 12:00 AM || || || No || No
|- style="background:lightgrey;"
! Day !! Load Run Number !! Leaving Hotel !! Arriving Airport* !! Leaving Airport* !! At Hotel !! Passenger !! Arrival Time* !! Sent email/cell to committee !! Confirmed
|-

| Sunday || Load 10 (ASU) || 11:15 PM || 11:45 PM || 12:15 AM || 12:45 AM || Marquez || 11:48 PM || No || No
|-
| Sunday || Load 10 (ASU) || 11:15 PM || 11:45 PM || 12:15 AM || 12:45 AM || || || No || No
|-
| Sunday || Load 10 (ASU) || 11:15 PM || 11:45 PM || 12:15 AM || 12:45 AM || || || No || No
|-
| Sunday || Load 10 (ASU) || 11:15 PM || 11:45 PM || 12:15 AM || 12:45 AM || || || No || No
|-
| Sunday || Load 10 (ASU) || 11:15 PM || 11:45 PM || 12:15 AM || 12:45 AM || || || No || No
|-
| Sunday || Load 10 (ASU) || 11:15 PM || 11:45 PM || 12:15 AM || 12:45 AM || || || No || No
|- style="background:lightgrey;"
! Day !! Load Run Number !! Leaving Hotel !! Arriving Airport* !! Leaving Airport* !! At Hotel !! Passenger !! Arrival Time* !! Sent email/cell to committee !! Confirmed
|-

| Monday || Load 11 (WCU) || 11:30 AM || 12:00 PM || 12:30 PM || 1:00 PM || Beacon ||11:48 || No || No
|-
| Monday || Load 11 (WCU) || 11:30 AM || 12:00 PM || 12:30 PM || 1:00 PM || || || No || No
|-
| Monday || Load 11 (WCU) || 11:30 AM || 12:00 PM || 12:30 PM || 1:00 PM || || || No || No
|-
| Monday || Load 11 (WCU) || 11:30 AM || 12:00 PM || 12:30 PM || 1:00 PM || || || No || No
|-
| Monday || Load 11 (WCU) || 11:30 AM || 12:00 PM || 12:30 PM || 1:00 PM || || || No || No
|-
| Monday || Load 11 (WCU) || 11:30 AM || 12:00 PM || 12:30 PM || 1:00 PM || || || No || No
|-|- style="background:lightgrey;"
! Day !! Load Run Number !! Leaving Hotel !! Arriving Airport* !! Leaving Airport* !! At Hotel !! Passenger !! Arrival Time* !! Sent email/cell to committee !! Confirmed
|-
| Monday || Load 12 (ASU) || 3:00 PM || 3:30 PM || 4:00 PM || 4:30 PM || Connolly || 3:34 PM || Yes || Yes
|-
| Monday || Load 12 (ASU) || 3:00 PM || 3:30 PM || 4:00 PM || 4:30 PM || Hellman || 3:34 PM || Yes || Yes
|-
| Monday || Load 12 (ASU)) || 3:00 PM || 3:30 PM || 4:00 PM || 4:30 PM || Ou || 2:56PM || Yes || Yes
|-
| Monday || Load 12 (ASU) || 3:00 PM || 3:30 PM || 4:00 PM || 4:30 PM || || || No || No
|-
| Monday || Load 12 (ASU) || 3:00 PM || 3:30 PM || 4:00 PM || 4:30 PM || || || No || No
|-
| Monday || Load 12 (ASU) || 3:00 PM || 3:30 PM || 4:00 PM || 4:30 PM || || || No || No
|-

|}

== Hotel to Asheville Airport (Departures) ==

''' * Allows for 1.5 hours at airport before earliest departure of occupants'''

{| border="1" cellpadding="5" style="text-align: left;"
|- style="background:lightgrey;"
! Day !! Load Run Number !! Leaving Hotel* !! Arriving Airport !! Leaving Airport !! Back to Hotel !! Passenger !! Departure Time * !! Leave by !! Sent email/cell to committee !! Confirmed
|-
| Thursday || Load A (WCU) || 10:00 AM || 10:30 AM || 10:40 AM || 11:10 AM || Schaefer || 12:05 PM || 10:05 AM || Yes || Yes
|-
| Thursday || Load A (WCU) || 10:00 AM || 10:30 AM || 10:40 AM || 11:10 AM || Keays || 12:55 PM || 10:55 AM || Yes || Yes
|-
| Thursday || Load A (WCU) || 10:00 AM || 10:30 AM || 10:40 AM || 11:10 AM || Vandenburg || 12:25 PM || 10:30 AM || Yes || Yes
|-
| Thursday || Load A (WCU) || 10:00 AM || 10:30 AM || 10:40 AM || 11:10 AM || Meyer || 12:05 PM ||10:05 AM || Yes || Yes
|-
| Thursday || Load A (WCU) || 10:00 AM || 10:30 AM || 10:40 AM || 11:10 AM || || || || No || No
|-
| Thursday || Load A (WCU) || 10:00 AM || 10:30 AM || 10:40 AM || 11:10 AM || || || || No || No
|- style="background:lightgrey;"
! Day !! Load Run Number !! Leaving Hotel* !! Arriving Airport !! Leaving Airport !! Back to Hotel !! Passenger !! Departure Time * !! Leave by !! Sent email/cell to committee !! Confirmed
|-
| Thursday || Load B (ASU) || 12:15 PM || 12:45 PM || 12:55 PM || 1:25 PM || Stethers || 2:15 PM || 12:15 PM || Yes || Yes
|-
| Thursday || Load B (ASU) || 12:15 PM || 12:45 PM || 12:55 PM || 1:25 PM || Bean || 2:15 PM || 12:15 PM || Yes || Yes
|-
| Thursday || Load B (ASU) || 12:15 PM || 12:45 PM || 12:55 PM || 1:25 PM || Bauder || 2:15 PM || 12:15 PM || Yes || Yes
|-
| Thursday || Load B (ASU) || 12:15 PM || 12:45 PM || 12:55 PM || 1:25 PM || Marquez || 2:15 PM || 12:15 PM || No || No
|-
| Thursday || Load B (ASU) || 12:15 PM || 12:45 PM || 12:55 PM || 1:25 PM || Cordial || 2:15 PM || 12:15 PM || Yes || Yes
|-
| Thursday || Load B (ASU) || 12:15 PM || 12:45 PM || 12:55 PM || 1:25 PM || Crenshaw || 2:26 PM || 12:26 PM || Yes || Yes
|- style="background:lightgrey;"
! Day !! Load Run Number !! Leaving Hotel* !! Arriving Airport !! Leaving Airport !! Back to Hotel !! Passenger !! Departure Time * !! Leave by !! Sent email/cell to committee !! Confirmed
|-

| Thursday || Load C (WCU) || 12:20 PM || 12:50 PM || 1:00 PM || 1:30 PM || Lovins || 2:21 PM || 12:21 PM || Yes || Yes
|-
| Thursday || Load C (WCU) || 12:20 PM || 12:50 PM || 1:00 PM || 1:30 PM || Dhanushka || 2:26 PM || 12:26 PM || Yes || Yes
|-
| Thursday || Load C (WCU) || 12:20 PM || 12:50 PM || 1:00 PM || 1:30 PM || Harish || 2:26 PM || 12:26 PM || Yes || Yes
|-
| Thursday || Load C (WCU) || 12:20 PM || 12:50 PM || 1:00 PM || 1:30 PM || Huot || 2:26 PM || 12:21 PM || Yes || Yes
|-
| Thursday || Load C (WCU) || 12:20 PM || 12:50 PM || 1:00 PM || 1:30 PM || Fersenheim || 2:26 PM || 12:26 PM || Yes || Yes
|-
| Thursday || Load C (WCU) || 12:20 PM || 12:50 PM || 1:00 PM || 1:30 PM || McClellan || 2:26 PM || 12:26 PM || Yes || Yes
|- style="background:lightgrey;"
! Day !! Load Run Number !! Leaving Hotel* !! Arriving Airport !! Leaving Airport !! Back to Hotel !! Passenger !! Departure Time * !! Leave by !! Sent email/cell to committee !! Confirmed
|-

| Thursday || Load D (ASU) || 1:20 PM || 1:50 PM || 2:00 PM || 2:30 PM || Matienzo || 3:21 PM || 1:21 PM || Yes || Yes
|-
| Thursday || Load D (ASU) || 1:20 PM || 1:50 PM || 2:00 PM || 2:30 PM || Young || 3:21 PM || 1:21 PM || No || No
|-
| Thursday || Load D (ASU) || 1:20 PM || 1:50 PM || 2:00 PM || 2:30 PM || Rainwater || 4:00 PM || 2:00 PM || Yes || Yes
|-
| Thursday || Load D (ASU) || 1:20 PM || 1:50 PM || 2:00 PM || 2:30 PM || Bucknum || 4:00 PM || 2:00 PM || Yes || Yes
|-
| Thursday || Load D (ASU) || 1:20 PM || 1:50 PM || 2:00 PM || 2:30 PM || Beacom || 3:21 PM || 1:30 PM || Yes || Yes
|-
| Thursday || Load D (ASU) || 1:20 PM || 1:50 PM || 2:00 PM || 2:30 PM || Johnson || 4:17 PM || 2:00 PM || Yes || Yes
|- style="background:lightgrey;"
! Day !! Load Run Number !! Leaving Hotel* !! Arriving Airport !! Leaving Airport !! Back to Hotel !! Passenger !! Departure Time * !! Leave by !! Sent email/cell to committee !! Confirmed
|-

| Thursday || Load E (WCU) || 2:10 PM || 2:40 PM || 2:50 PM || 3:20 PM || Hennesy || 4:17 PM || 2:17 PM || Yes || Yes
|-
| Thursday || Load E (WCU) || 2:10 PM || 2:40 PM || 2:50 PM || 3:20 PM || Kohler || 4:17 PM || 2:17 PM || Yes || Yes
|-
| Thursday || Load E (WCU) || 2:10 PM || 2:40 PM || 2:50 PM || 3:20 PM || Olson || 4:17 PM || 2:17 PM || No || No
|-
| Thursday || Load E (WCU) || 2:10 PM || 2:40 PM || 2:50 PM || 3:20 PM || Coles || 4:17 PM || 2:17 PM || Yes || Yes
|-
| Thursday || Load E (WCU) || 2:10 PM || 2:40 PM || 2:50 PM || 3:20 PM || Connolly || 4:06 PM || || Yes || Yes
|-
| Thursday || Load E (WCU) || 2:10 PM || 2:40 PM || 2:50 PM || 3:20 PM || Brubaker Horst || 4:17 PM || 2:15 PM || Yes || Yes
|- style="background:lightgrey;"
! Day !! Load Run Number !! Leaving Hotel* !! Arriving Airport !! Leaving Airport !! Back to Hotel !! Passenger !! Departure Time * !! Leave by !! Sent email/cell to committee !! Confirmed
|-

| Thursday || Load F (ASU) || 2:30 PM || 3:00 PM || 3:10 PM || 3:40 PM || Lakshminarayanan || 4:30 PM || 2:30 PM || Yes || Yes
|-
| Thursday || Load F (ASU) || 2:30 PM || 3:00 PM || 3:10 PM || 3:40 PM || Kome || 4:30 PM || 2:30 PM || Yes || Yes
|-
| Thursday || Load F (ASU) || 2:30 PM || 3:00 PM || 3:10 PM || 3:40 PM || Junus || 4:30 PM || 2:30 PM || Yes || Yes
|-
| Thursday || Load F (ASU) || 2:30 PM || 3:00 PM || 3:10 PM || 3:40 PM || Corrado || 4:35 PM || 2:35 PM || Yes || Yes
|-
| Thursday || Load F (ASU) || 2:30 PM || 3:00 PM || 3:10 PM || 3:40 PM || Levine || 4:35 PM || 2:35 PM || Yes || Yes
|-
| Thursday || Load F (ASU) || 2:30 PM || 3:00 PM || 3:10 PM || 3:40 PM || Garrison || 4:17 PM || 2:30 PM || Yes || No
|- style="background:lightgrey;"
! Day !! Load Run Number !! Leaving Hotel* !! Arriving Airport !! Leaving Airport !! Back to Hotel !! Passenger !! Departure Time * !! Leave by !! Sent email/cell to committee !! Confirmed
|-

| Thursday || Load G (WCU) || 3:30 PM || 4:00 PM || 4:10 PM || 4:40 PM || Wick || 5:35 PM || 3:35 PM || Yes || Yes
|-
| Thursday || Load G (WCU) || 3:30 PM || 4:00 PM || 4:10 PM || 4:40 PM || Coombs || 6:57 PM || 4:58 PM || Yes || Yes
|-
| Thursday || Load G (WCU) || 3:30 PM || 4:00 PM || 4:10 PM || 4:40 PM || || || || No || No
|-
| Thursday || Load G (WCU) || 3:30 PM || 4:00 PM || 4:10 PM || 4:40 PM || || || || No || No
|-
| Thursday || Load G (WCU) || 3:30 PM || 4:00 PM || 4:10 PM || 4:40 PM || || || || No || No
|-
| Thursday || Load G (WCU) || 3:30 PM || 4:00 PM || 4:10 PM || 4:40 PM || || || || No || No
|- style="background:lightgrey;"
! Day !! Load Run Number !! Leaving Hotel* !! Arriving Airport !! Leaving Airport !! Back to Hotel !! Passenger !! Departure Time * !! Leave by !! Sent email/cell to committee !! Confirmed
|-

| Thursday || Load H (ASU) || 9:00 PM || 9:30 PM || 9:40 PM || 10:10 PM || Tennant || 10:55 PM || 8:55 PM || Yes || Yes
|-
| Thursday || Load H (ASU) || 9:00 PM || 9:30 PM || 9:40 PM || 10:10 PM || || || || No || No
|-
| Thursday || Load H (ASU) || 9:00 PM || 9:30 PM || 9:40 PM || 10:10 PM || || || || No || No
|-
| Thursday || Load H (ASU) || 9:00 PM || 9:30 PM || 9:40 PM || 10:10 PM || || || || No || No
|-
| Thursday || Load H (ASU) || 9:00 PM || 9:30 PM || 9:40 PM || 10:10 PM || || || || No || No
|-
| Thursday || Load H (ASU) || 9:00 PM || 9:30 PM || 9:40 PM || 10:10 PM || || || || No || No
|- style="background:lightgrey;"
! Day !! Load Run Number !! Leaving Hotel* !! Arriving Airport !! Leaving Airport !! Back to Hotel !! Passenger !! Departure Time * !! Leave by !! Sent email/cell to committee !! Confirmed
|-

| Friday || Load I (WCU) || 9:30 AM || 10:00 AM || 10:10 AM || 10:40 AM || Doran || 11:25 AM || 9:25 AM || Yes || Yes
|-
| Friday || Load I (WCU) || 9:30 AM || 10:00 AM || 10:10 AM || 10:40 AM || Darby || 11:25 AM || 9:25 AM || Yes || Yes
|-
| Friday || Load I (WCU) || 9:30 AM || 10:00 AM || 10:10 AM || 10:40 AM || Giarlo || 12:03 PM || 10:03 AM || Yes || Yes
|-
| Friday || Load I (WCU) || 9:30 AM || 10:00 AM || 10:10 AM || 10:40 AM || Mathewson || 12:05 PM || 10:05 AM || Yes || Yes
|-
| Friday || Load I (WCU) || 9:30 AM || 10:00 AM || 10:10 AM || 10:40 AM || Schwenter || 12:05 PM || 10:05 AM || Yes || Yes
|-
| Friday || Load I (WCU) || 9:30 AM || 10:00 AM || 10:10 AM || 10:40 AM || || || || No || No
|- style="background:lightgrey;"
! Day !! Load Run Number !! Leaving Hotel* !! Arriving Airport !! Leaving Airport !! Back to Hotel !! Passenger !! Departure Time * !! Leave by !! Sent email/cell to committee !! Confirmed
|-

| Friday || Load J (ASU) || 11:00 AM || 11:30 AM || 11:40 AM || 12:10 PM || Beer || 12:55 PM || 10:55 AM || Yes || Yes
|-
| Friday || Load J (ASU) || 11:00 AM || 11:30 AM || 11:40 AM || 12:10 PM || Fleming || 2:26 PM || 12:26 PM || Yes || Yes
|-
| Friday || Load J (ASU) || 11:00 AM || 11:30 AM || 11:40 AM || 12:10 PM || McGuire || 2:15 PM || || No || No
|-
| Friday || Load J (ASU) || 11:00 AM || 11:30 AM || 11:40 AM || 12:10 PM || Harper || 1:07 PM || || Yes || Yes
|-
| Friday || Load J (ASU) || 11:00 AM || 11:30 AM || 11:40 AM || 12:10 PM || || || || No || No
|-
| Friday || Load J (ASU) || 11:00 AM || 11:30 AM || 11:40 AM || 12:10 PM || || || || No || No
|- style="background:lightgrey;"
! Day !! Load Run Number !! Leaving Hotel* !! Arriving Airport !! Leaving Airport !! Back to Hotel !! Passenger !! Departure Time * !! Leave by !! Sent email/cell to committee !! Confirmed
|-

| Friday || Load K (WCU) || 3:30 PM || 4:00 PM || 4:10 PM || 4:40 PM || Klein || 5:35 PM || 3:35 PM || Yes || Yes
|-
| Friday || Load K (WCU) || 3:30 PM || 4:00 PM || 4:10 PM || 4:40 PM || || || || No || No
|-
| Friday || Load K (WCU) || 3:30 PM || 4:00 PM || 4:10 PM || 4:40 PM || || || || No || No
|-
| Friday || Load K (WCU) || 3:30 PM || 4:00 PM || 4:10 PM || 4:40 PM || || || || No || No
|-
| Friday || Load K (WCU) || 3:30 PM || 4:00 PM || 4:10 PM || 4:40 PM || || || || No || No
|-
| Friday || Load K (WCU) || 3:30 PM || 4:00 PM || 4:10 PM || 4:40 PM || || || || No || No

|}

Omitted: (Departure, Hellman, flight time: 4:06PM Thu)

[[Category: Code4Lib2010]]

C4L2010 social activities

2010-02-15T16:27:00Z

128.220.205.186: /* BBQ Excursion Signup */

==Code4Lib 2010 social activities ==

==Ideas==
[http://www.citizen-times.com/apps/pbcs.dll/article?AID=2009912010314 New breweries opening]

[http://digital.library.appstate.edu/code4lib2010.html Original Proposal (suggests some nearby events)]

[http://ashevilletwitterhashtags.blogspot.com/2009/09/asheville-beer-avlbeer.html Asheville Beer Hashtag]

==Planned events==

Plan one if you like! Either on your own or you can [[Committees_sign-up_page|join the social activities committee]].

== Asheville Brews Cruise ==

"Experience a taste of Asheville’s thriving local beer scene with an exclusive tour of three of our award-winning microbreweries." - http://www.brewscruise.com/asheville/

This activity will be Tuesday night starting at 6pm and leaving from the hotel. First stop will be the Asheville Pizza & Brewing Co. to sample 16-20 different beers and eat some pizza (food billed separately). Then two more stops at the French Broad Brewery and the Highland Brewing Company for more beer sampling and learning about their brewery process.

The cost will be $40/person (not including pizza). The minimum number of folks we need is 16. <s>There is no maximum.</s> Due to logistics of transportation and size of the establishments we'll be visiting I've had to set a max of 48 persons.

==== Beer Cruise Signup ====

Please indicate interest in the Beer Cruise by adding your name to the list below. We'll figure out a way to coordinate and communicate the details somewhere down the line.

# Jay Luker (organizing, not driving)
# Mike Giarlo (inebriator)
# Rob Casson (drunk)
# Declan Fleming (beer receptacle)
# Jim Safley (recovering teetotaler)
# Ian Walls (epicurean of ale)
# Christopher Spalding (thirsty)
# Jon Gorman (imbiber of that which is good)
# Lori Stethers (token female)
# Carol Ou (beer enthusiast)
# Cristóbal Palmer (Reinheitsgebot skeptic)
# Tod Olson (enabler)
# Mark Matienzo (alefounder)
# Sibyl Schaefer (barfly)
# Laney McGlohon (brewmaster's assistant)
# Tania Fersenheim (Gold Medalist - Ithaca Beerlympics - Summer 1993)
# Melissa Manolis (Beer lacky and Librarian Groupie)
# Greg McClellan (master of beerology and beeronomy)
# Cary Gordon (hip hoppist)
# Mark Gallagher (Thing 1)
# Matt Bachtell (Thing 2)
# Sarah Kahn (has no title)
# Thom Cox (afraid of rectangles)
# Eric James (pour)
# Ray Schwartz (mighty thirsty)
# Jason Stirnaman (all about the stout)
# Mike Flakus (ipa all the way)
# Ben Florin (sounds neat--what's "beer"?)
# Ryan Wick (it comes in pints?)
# Sam Kome (have churchkey, will travel)
# Joe Atzberger
# Brendan Gallagher
# Chris Beer
# Tom Keays (growler)
# Ross Singer (empty vessel waiting to be filled)
# Eric Hellman (49 IBU)
# Paul Joseph (i bike leer)
# Cody Hennesy (don't mind if i do)
# Michael Vandenburg
# Stephen Meyer (Wisconsinite)
# Antonio Barrera
# Andrew Nagy
# Rosalyn Metz
# Esmé Cowles
# Dea Rice (Duchess of Ales)
# Sean Hannan (Peer Pressured)
# Scott Garrison (just made it by the froth of his beer?)
# Dan Suchy ( [no longer] late and now full of gratitude) (berick: Dan, you get my spot. you better get double drunk for me!)

'''There is a max of 48 persons for this event. Sorry!'''

'''Wait List'''

# Brad Westbrook
# Spencer Lamm

== 12 Bones BBQ Dinner Excursion ==
(was a lunch excursion)

[http://www.12bones.com/ 12 Bones BBQ] is widely considered the best BBQ in Asheville [[http://www.yelp.com/biz/12-bones-smokehouse-asheville *]]. However it is only open from 11-4, M-F. We would like to organize a group so that we can rent out the place on Wednesday night. If we get at least 50 people, it will be doable.

'''When:''' Wednesday, February 24th

'''Time:''' 6:30pm

'''Where:''' 5 Riverside Drive Asheville NC, 28801

==== BBQ Excursion Signup ====

For the time being please indicate interest in the BBQ excursion by adding your name to the list below. We'll figure out a way to coordinate and communicate the details somewhere down the line.

# Rosalyn Metz (the new organizer)
# Jay Luker (demoted but still devoted)
# Mike Giarlo (consumer)
# Rob Casson (glutton)
# Declan Fleming (condor)
# Erik Hatcher (carnivore)
# Christopher Spalding (digs swine)
# Mike Durbin (Porkaholic)
# Jeremy Frumkin (alloftheabove)
# Jon Gorman (Aficionado of smoke, flame, and good sauces)
# Michael Klein (EAT PIG)
# Mark Matienzo (saucy fellow)
# Cary Gordon (do they have vegan pig?)
# Sibyl Schaefer (finger licker)
# Greg McClellan (Mmmm... Pig)
# Ranti Junus (beef and chicken cheerleader)
# Tania Fersenheim (can't think of any non-vulgar tag lines)
# Matt Bachtell (hope they have vinegar based BBQ)
# Ray Schwartz (I eat vegetarians)
# Dileshni Jayasinghe (I just like to eat)
# Joe Atzberger (con carne)
# Michael Doran (a YES for Wednesday night)
# Thom Cox (ancho pepper addict)
# Chris Strauber (meat and flame!)
# Cindy Harper (I'm sorry, Babe)
# Brendan Gallagher
# Chris Beer
# Alexander O'Neill
# Bess Sadler
# Joyce Ouchida
# Ross Singer (Some Pig)
# Tod Olson (omnivore sans dilemma)
# Paul Joseph
# Vinita Tuteja
# Robin Hitch
# Ryan Wick
# Becky Yoose (bringing the wetwipe napkins)
# Joyce Chapman
# Andrew Darby
# Cory Lown
# Peter Murray (who knows that NC BBQ means one has to actually add the BBQ sauce)
# Jean Rainwater
# Matt Cordial
# Carol Ou (dinnertime excursion works for me)
# Karen Coombs
# Dan Lucas
# Gerald Snyder
# Michael Silver
# Julia Bauder (dinner partier)
# Jørn Thøgersen
# Michael Poltorak Nielsen
# Toke Eskildsen
# Mads Villadsen (the Danes are coming for Wednesday night BBQ!)
# Andreas Orphanides (I want to go to there.)
# Michael Vandenburg
# Wendy Huot
# David Bucknum
# Jason Casden
# Graham Stewart
# Joseph Ryan
# Dhanushka Samarakoon
# Eric Crenshaw
# Katherine Lynch
# Stephen Meyer
# Antonio Barrera (whats a BBQ without me)
# Ron Peterson
# Andrew Nagy (no witty comment)
# Corey Harper (Mmmmmm..... Carolina Pulled Pig)
# Eric Palmitesta
# Ben Florin
# Emily Lynema (pulled pork delicious)
# Erik Mitchell (Who could turn down an 80 person dinner experience?)
# Mike Flakus (pulled-porker)
# Matt Connolly (Memphian)
# Ian Walls
# Benjamin Young (BBQ is a noun)
# Esmé Cowles
# Tim Dennis
# Harry Kaplanian

'''Sorry there is an 80 person limit for this event'''

'''Wait List'''
# Ryan Scherle
# Amy McGuire
# Jason Battles
# Hong Ma
# Vanessa Meireles
# Mark Diggory
# Jonathan Rochkind

==Vegetarian Dinner (Weds, AKA BBQ night)==

[http://opheliasworldcafe.info/ Ophelia's World Cafe and Bar] does vegetarian, vegan, raw, gluten-free, sustainable seafood, and locally-raised meat products, with a focus on local and organic. Also, a full bar. [http://www.yelp.com/biz/ophelias-world-cafe-and-bar-asheville yelp reviews].

* max of 30 people
* meet at hotel to walk together - 6:30pm
* We are confirmed with the restaurant - reservation is at 6:45
* email Anna3LC if you have any questions - gmail

# Jodi Schneider
# Maccabee Levine (token male)
# Eric Hellman (token carnivore)
# Carol Bean
# Sam Kome (omnivorous w/exception of BBQ)
# Dea Rice (Socialite)
# Sean Hannan (token token collector)
# Vidhya Arvind
# Cristóbal Palmer
# Lori Stethers
# Rick Johnson
# Anna Headley
# Kevin Clarke
# Gabriel Farrell
# Eric James
# Betsy Coles
# Harish Maringanti
# Emily Molanphy
# Shawn Averkamp
# Kevin Reiss
# Birkin
# Jon Stroop
# Birong Ho
# William Denton
# Gretchen Gueguen
# Steven Shelton
# Banurekha Lakshminarayanan
# Dan Brubaker Horst
# Martin Mehrling
# Dan Chudnov
# '''We're full!'''

'''Wait List'''
# Erin Germ
# Naomi Dushay
# Shekhar Krishnan
# Schuyler Erle

== Newcomer Dinner ==
First time at code4lib? Join fellow c4l newbies and veterans for an evening of food, socializing, and stimulating discussions about the many uses of bacon.

Code4Lib veterans, you're invited too. Join us in welcoming the newcomers!

'''Tentative plans (more information to come)'''
* When: Monday evening
* Time: 6 PM
* Where: Meet in the hotel lobby. Restaurants - Look below
* Mastermind (if you have any questions): [mailto:yoosebj@muohio.edu Becky Yoose]

=== Newcomer Dinner Signup ===

Clarification - you can still sign up if you didn't intially list your name the first time around. Sorry for any misunderstandings on my part. -_-;

'''Restaurants'''

''Guidelines:''
*Max of '''8''' per location
**Please, no waitlisting :(
*ID yourselves so we can get a good mix of new people and veterans
**New folks - n
**c4l vets - v
*One leader needed for each location (code4lib vets only)
**Leader duties
***Make reservations if required; otherwise make sure that the restaurant can handle a group of 8 rowdy library coders
***Herd folks from hotel to restaurant (know where you're going!)

'''Spots still available below! 2/11 - added a couple more restaurants to make sure everyone has a spot!'''

[http://www.vincenzos.com/ Vincenzo's] (Italian)
# [Leader] Bess Sadler - v
# Thom Cox - n
# Alexander O'Neill - n
# Leland Deeds - n
# Erin Germ - n
# Joe Atzberger - v
# Cindy Harper - n

[http://www.trippsrestaurants.com/ Tripps Restaurant] (Steakhouse)
# [Leader]
#

[http://tableasheville.com/page/276-home Table] (“New American”)
# [Leader] Devon Smith - v
# Anna Headley - n
# Cory Rockliff - n
# Jeff Sherwood - n
# Emily King - n

[http://www.mellowmushroom.com/ Mellow Mushroom Pizza Bakers] (Pizza)
# [Leader]
#

[http://limonesrestaurant.com/page/1240-Home Limones] (Mexican)
# [Leader]
#

[http://www.bistro1896.com/index.php?option=com_content&task=view&id=14&Itemid=42 Bistro 1896] (Bistro)
# [Leader]
#

[http://www.jackofthewood.com/ Jack of the Wood] (another pub for y'all)
# [Leader]
#

'''Sorry, these are full'''

[http://www.doccheys.com/menu/ Doc Chey’s Noodle House] (Asian)
# [Leader] Emily Lynema - v
# Julia Bauder - n
# Joe Marquez - n
# Jason Battles - n
# Jill Ellern - n
# Michael Vandenburg -n
# Shekhar Krishnan
# Schuyler Erle
# '''Sorry - full'''

[http://ashevillebouchon.com/page/2511-Home Bouchon French Bistro] (French)
# [Leader] Ben Florin -v
# Gwen Exner - n
# Joel Richard - n (super-green!)
# Dan Lucas - n
# Hong Ma - n
# Vanessa Meireles - n
# Mark Diggory - n (but not green)
# David Woodbury - n
# '''Sorry - full'''

[http://www.melaasheville.com/ Mela Indian Restaurant] (Indian)
# [Leader] Andrew Darby - v
# Joyce Ouchida - n
# Eric Celeste (spy) - n
# Kossivi (Jean-Paul) Bessou - n
# Steven Shelton - n
# Jeff Silvis - n
# Ya'aqov Ziso - n
# Banurekha - n
# '''Sorry - full'''

[http://www.ichibanwasabi.com/ Wasabi Japanese Restaurant & Sushi Bar] (Japanese)
# [Leader] Ranti Junus - v
# Caitlin Shanley - n
# Erin White - n
# Joel Marchesoni - n
# Ken Rogers - n
# Chris Strauber - n
# Jodi Schneider - v
# Joyce Chapman - n
# '''Sorry - full'''

[http://rosettaskitchen.com/our-menu Rosetta's Kitchen] (Vegetarian)
# [Leader] Rosalyn Metz -v
# Cody Hennesy - n
# Sam Kome - n
# John Yorio - n
# Shawn Averkamp - n
# Sarah Kahn- n
# Cory Lown - n
# Maccabee Levine - n
# '''Sorry - full'''

[http://www.suwanathaiorchid.com/index.php Suwana's Thai Orchid Restaurant] (Thai)
# [Leader] Becky Yoose - v
# Andy Mardesich - n
# Amy McGuire
# Birong HO
# Ryan Scherle - n
# Mark Mounts - n
# Dan Brubaker Horst -n
# Rick Johnson - n
# '''Sorry - full'''

[http://thelobstertrap.biz/ The Lobster Trap] (Seafood)
# [Leader] Michael Klein - v
# Janis Mathewson - n
# Karen Schwentner - n
# Tom Bennett - n
# Carol Ou - v
# Kenny Ketner - n
# Mike Flakus - n
# Michael Doran - v
# '''Sorry - full'''

[http://www.ashevillebiergarden.com/ The Bier Garden (Pub)]
# [Leader] Mike Giarlo - v
# Dileshni Jayasinghe - n
# David Bucknum - n
# Sean Chen - n
# Sibyl Schaefer - n
# Dan Suchy - n
# Mark Matienzo - v
# Declan Fleming - v
# '''Sorry - full'''
# Eric Palmitesta -n (WAITLISTED!) - (BY note - Hi Eric, can you please choose from the available list above? Thanks! [Hey, Eric, you might sign up for Jack of the Wood. Good beer there as well! -MJG])

Cut and paste your name to the restaurant of your choice :)
* Ross Singer
* Monica Claassen-Wilson
* Brendan Gallagher
* Yuka Egusa
* Masao Takaku
* Schuyler Erle
* Tim Shearer
* Michael Silver
* Jason Stirnaman
* Patrick Hochstenbach
* David Chandek-Stark
* David Kennedy
* Paul Joseph
* Vinita Tuteja
* Clint Bellanger
* Wendy Huot
* Robin Hitch
* Cary Gordon (likes anything that involves food)
* Graham Stewart
* David Woodbury
* Antonio Barrera
* Andrew Nagy
* Harry Kaplanian
* Scott Garrison
* Kevin Reiss

== Werewolf! ==
It wouldn't be a tech conference unless we got together one evening to turn into a gang of murdering beasts and hyper-suspicious victims. Facilitated by the one and only mbklein.

* When: Wednesday evening
* Time: 8 PM
* Where: TBA. Watch this space.

=== Werewolf signup ===
* Michael Klein
* Alexander O'Neill
* Bess Sadler
* Leland Deeds
* Jean Rainwater
* Chris Beer
* Wendy Huot
* Jon Gorman
* Jodi Schneider
* Birkin (will arrive after the veggie-dinner, and hoping BBQ-ers will have time to make it, too)
* Harish (ditto)
* Jon Stroop
* Joel Marchesoni (tentative)
* Martin Mehrling
* Michael Vandenburg

== Working Out ==
Gotta make up for that BBQ excursion somehow. Let's work out! Ideas: jogging or [http://www.crossfitasheville.com CrossFitting] (Monday evening, 5:30pm or 6:30pm). Signup:

* Erik Hatcher (game for both jogging and CrossFitting, bring it!)
* Erik Mitchell (Run downtown asheville or the parkway? - great 12 mile climb up the parkway around Pisgah Mtn.), How about a Code4Lib half-marathon? (Why NOT! Let's do a Half Marathon) - Ray Schwartz
**Bike riding - yes might be sketchy given our current weather
**Hike up Looking Glass Rock [http://www.hikewnc.info/trailheads/pisgah/pisgah/guidedhikes/lookingglassrock.html]
* Emily Lynema (game for jogging, hiking, walking, jumping jacks; not crazy enough for parkway running!)
* Ray Schwartz (game for a run - why not a half marathon?!).
* Rick Johnson (Looking to fit in a 10, 12 ,and 8 mile run while in town. Was originally thinking I would go early in the morning: 6:30 or 7. May not be able to run together everytime but definitely looking for suggestions on good routes)
* Thom Cox (lifting, cardio, yoga--all good)
* Jason Stirnaman (hiking, biking - don't mind the weather, lifting, cross-fitting)
* Jean Rainwater (need to get some runs in where the footing's not treacherous and the temp is above freezing)
* Gerald Snyder (a couple mornings jogging would be good, but only 4 or 5 miles for me thanks)
* Jodi Schneider (CrossFitting sounds fun if we can fit in [http://www.crossfitasheville.com/schedule/ their schedule], yoga, walking, hiking)
* Becky Yoose (hiking (intermediate level max), walking, cheer others on while they run a half marathon)
* Carol Bean (does shivering in the cold count as exercise?)
* John Barneson (I'm game for a.m. runs 5-10 miles. I would love a nice scenic route and I don't mind trail running)
* Gabriel Farrell (running, yoga, pickup soccer?)
* Kevin Reiss (running/hiking)
* Jeff Sherwood (I'd be into getting in a Crossfit WOD or maybe a run)
* Nick Hanssens (yoga; I teach if there is space and interest)
* Michael Vandenburg (Crossfit curious)
* Ranti Junus (yoga, walking, thumb wrestling - maybe)
* Mark Diggory (surfing,... kinda hard to find good waves in Asheville... will settle for a little hiking)

== Sitting in a room together and half the time talking to each other out loud and half the time talking in IRC ==

Because you know it's going to happen

* William Denton
* Mike Giarlo (fulfiller of destinies)
* /ignore mjgiarlo
* Antonio Barrera (trying to avoid a repeat of Portland)
* Jodi Schneider (one of the highlights!!!)
* Bess Sadler (can it be in the hospitality suite at 4am? That's the best!)
* Mark Matienzo
* Ranti Junus (hoping somebody can help me hacking my chumby one to install [http://elinks.or.cz/ elinks] or [http://www.qtweb.net/ qtweb])

[[Category: Code4Lib2010]]

Umlaut

2009-11-17T21:34:34Z

128.220.205.186: /* Specific Topics */

Umlaut is [[OpenURL]] link resolving middleware that adds functions and services to commercial link resolving software such as [[SFX]].

[[Category:Umlaut]]

==More information==

[[About Umlaut]] - A gentle introduction to what Umlaut is and what it can do for you.

[http://bibwild.wordpress.com/2008/10/16/umlaut-digital-book/ Digital Text Features] - A tour of some of the 'advanced' digital text features, with a demos pointing to JHU site, hosted on jrochkind's blog.

[http://rubyforge.org/mail/?group_id=4382 Umlaut Listserv]

[http://umlaut.rubyforge.org/ Rubyforge home page for developers]

[[Umlaut wishlist]]

==Installation and Configuration==

[[Umlaut Installation]]

[[Umlaut Setup]]

[[Umlaut_Deployment]]

==Documentation==

===Overview===

[http://umlaut.rubyforge.org/api/ Umlaut API Documentation]

[[Umlaut Technical Overview]]

[[Umlaut_Deployment]]

[[Umlaut Local Configuration Architecture]]

===Specific Topics===

[[Umlaut URL parameters]]

[[Umlaut logging]]

[[Umlaut SFX statistics gotchas]]

====APIs====

[[Umlaut full API]]

[[Umlaut partial html API]]

[[Umlaut partial html API javascript helper]]

====Developer Notes====
[[Notes for a User/Auth architecture]]

Code4Lib Journal Email Templates

2009-07-27T16:35:50Z

128.220.205.186: /* Call for proposals */

''See also [[Code4Lib_Journal_Deadlines]]''

== Call for proposals ==

<pre>
Call for Papers (and apologies for cross-posting):

The Code4Lib Journal (C4LJ) exists to foster community and share
information among those interested in the intersection of libraries,
technology, and the future.

The Code4Lib Journal is now accepting proposals for publication in its
8th issue. Don't miss out on this opportunity to share your ideas and
experiences. To be included in the 8th issue, which is scheduled for
publication in mid November 2009, please submit articles, abstracts,
or proposals to c4lj-articles@googlegroups.com by Friday, August 14,
2009. When submitting, please include the title or subject of the
proposal in the subject line of the email message.

C4LJ encourages creativity and flexibility, and the editors welcome
submissions across a broad variety of topics that support the mission
of the journal. Possible topics include, but are not limited to:

* Practical applications of library technology (both actual and hypothetical)
* Technology projects (failed, successful, or proposed), including how they were done and challenges faced
* Case studies
* Best practices
* Reviews
* Comparisons of third party software or libraries
* Analyses of library metadata for use with technology
* Project management and communication within the library environment
* Assessment and user studies

C4LJ strives to promote professional communication by minimizing the
barriers to publication. While articles should be of a high quality,
they need not follow any formal structure. Writers should aim for the
middle ground between blog posts and articles in traditional refereed
journals. Where appropriate, we encourage authors to submit code
samples, algorithms, and pseudo-code. For more information, visit
C4LJ's Article Guidelines or browse articles from the first 7 issues
published on our website: http://journal.code4lib.org.

Remember, for consideration for the 8th issue, please send proposals,
abstracts, or draft articles to c4lj-articles@googlegroups.com no
later than Friday, August 14, 2009.

Send in a submission. Your peers would like to hear what you are doing.

Code4Lib Journal Editorial Committee
</pre>

== Submission Acknowledgement ==

Thanks for submitting a proposal to the Code4Lib Journal. We appreciate your participation in the code4lib community. The editors have received your proposal and should be in touch with you in 2-4 weeks regarding its appropriateness for publication in C4LJ. We will notify you if we need additional information to make this decision. Please feel free to contact us at c4lj-articles@googlegroups.com if you have additional questions.

== Need More Information ==

Thank you for your interest in publishing in the Code4Lib Journal. The Journal is primarily focused on technological issues in libraries. In order to help the editors determine if your proposal is appropriate for this publication, could you share more details about the intended audience for the the article and how it will address issues surrounding technology in libraries? Please respond to c4lj-articles@googlegroups.com with the additional information requested.

You may also contact the editors at c4lj-articles@googlegroups.com if you have any additional questions. We look forward to hearing from you.

== Proposal Accepted ==

I'm pleased to tell you that your recent proposal for an article about
<insert topic/title> has been provisionally accepted to the Code4Lib
Journal. The editorial committee is interested in your proposal, and
would like to see a draft.

<insert any additional comments about focus we'd like to see in the
article or editorial committee concerns. Sample language "We're
especially interested in X, and we'd like you to make sure to flesh
this out when you write the article." "We're interested in this
proposal if you can do X, Y, or Z.">

As a member of the Code4Lib Journal editorial committee, I will be
your contact for this article, and will work with you to get it ready
for publication.

We hope to publish your article in issue <#> of the Journal, which is
scheduled to appear on <insert date here>. The deadline for submission
of a complete draft is <deadline for draft>, but the sooner you can
get us a draft the better, and the more likely we'll be able to get
your article into issue <#>. Upon receipt of the draft, I will work
with you to address any changes recommended by the Editorial
Committee. More information about our author guidelines may be found
at http://journal.code4lib.org/article-guidelines.

Please note that final drafts must be approved by a vote of the
Editorial Committee before being published.

We also require all authors to agree to CC-BY licensing for the
articles we publish in the journal. We recommend that any included
code also have some type of code-specific open source license (such as
the GPL).

We look forward to seeing a complete draft and hope to include it in
the Journal. Thank you for submitting to us, and feel free to contact
me directly with any questions.

== Proposal Rejected ==

We regret to inform you that your recent proposal to the Code4Lib Journal for an article about <insert topic/title> has not been accepted for publication. This is likely because the Editorial Committee determined that it was not an appropriate match for the audience, mission, or scope of the Code4Lib Journal. [optional - insert comment here about why it's not appropriate]

For more information about the mission of the Code4Lib Journal, please see http://journal.code4lib.org/mission/.

Thanks for considering us, and please do not hesitate to contact the editors at c4lj-articles@googlegroups.com in the future with a new or revised proposal.

[[Category: Code4Lib Journal]]

Code4Lib Journal Email Templates

2009-07-27T16:35:20Z

128.220.205.186:

''See also [[Code4Lib_Journal_Deadlines]]''

== Call for proposals ==

Call for Papers (and apologies for cross-posting):

The Code4Lib Journal (C4LJ) exists to foster community and share
information among those interested in the intersection of libraries,
technology, and the future.

The Code4Lib Journal is now accepting proposals for publication in its
8th issue. Don't miss out on this opportunity to share your ideas and
experiences. To be included in the 8th issue, which is scheduled for
publication in mid November 2009, please submit articles, abstracts,
or proposals to c4lj-articles@googlegroups.com by Friday, August 14,
2009. When submitting, please include the title or subject of the
proposal in the subject line of the email message.

C4LJ encourages creativity and flexibility, and the editors welcome
submissions across a broad variety of topics that support the mission
of the journal. Possible topics include, but are not limited to:

* Practical applications of library technology (both actual and hypothetical)
* Technology projects (failed, successful, or proposed), including how they were done and challenges faced
* Case studies
* Best practices
* Reviews
* Comparisons of third party software or libraries
* Analyses of library metadata for use with technology
* Project management and communication within the library environment
* Assessment and user studies

C4LJ strives to promote professional communication by minimizing the
barriers to publication. While articles should be of a high quality,
they need not follow any formal structure. Writers should aim for the
middle ground between blog posts and articles in traditional refereed
journals. Where appropriate, we encourage authors to submit code
samples, algorithms, and pseudo-code. For more information, visit
C4LJ's Article Guidelines or browse articles from the first 7 issues
published on our website: http://journal.code4lib.org.

Remember, for consideration for the 8th issue, please send proposals,
abstracts, or draft articles to c4lj-articles@googlegroups.com no
later than Friday, August 14, 2009.

Send in a submission. Your peers would like to hear what you are doing.

Code4Lib Journal Editorial Committee

== Submission Acknowledgement ==

Thanks for submitting a proposal to the Code4Lib Journal. We appreciate your participation in the code4lib community. The editors have received your proposal and should be in touch with you in 2-4 weeks regarding its appropriateness for publication in C4LJ. We will notify you if we need additional information to make this decision. Please feel free to contact us at c4lj-articles@googlegroups.com if you have additional questions.

== Need More Information ==

Thank you for your interest in publishing in the Code4Lib Journal. The Journal is primarily focused on technological issues in libraries. In order to help the editors determine if your proposal is appropriate for this publication, could you share more details about the intended audience for the the article and how it will address issues surrounding technology in libraries? Please respond to c4lj-articles@googlegroups.com with the additional information requested.

You may also contact the editors at c4lj-articles@googlegroups.com if you have any additional questions. We look forward to hearing from you.

== Proposal Accepted ==

I'm pleased to tell you that your recent proposal for an article about
<insert topic/title> has been provisionally accepted to the Code4Lib
Journal. The editorial committee is interested in your proposal, and
would like to see a draft.

<insert any additional comments about focus we'd like to see in the
article or editorial committee concerns. Sample language "We're
especially interested in X, and we'd like you to make sure to flesh
this out when you write the article." "We're interested in this
proposal if you can do X, Y, or Z.">

As a member of the Code4Lib Journal editorial committee, I will be
your contact for this article, and will work with you to get it ready
for publication.

We hope to publish your article in issue <#> of the Journal, which is
scheduled to appear on <insert date here>. The deadline for submission
of a complete draft is <deadline for draft>, but the sooner you can
get us a draft the better, and the more likely we'll be able to get
your article into issue <#>. Upon receipt of the draft, I will work
with you to address any changes recommended by the Editorial
Committee. More information about our author guidelines may be found
at http://journal.code4lib.org/article-guidelines.

Please note that final drafts must be approved by a vote of the
Editorial Committee before being published.

We also require all authors to agree to CC-BY licensing for the
articles we publish in the journal. We recommend that any included
code also have some type of code-specific open source license (such as
the GPL).

We look forward to seeing a complete draft and hope to include it in
the Journal. Thank you for submitting to us, and feel free to contact
me directly with any questions.

== Proposal Rejected ==

We regret to inform you that your recent proposal to the Code4Lib Journal for an article about <insert topic/title> has not been accepted for publication. This is likely because the Editorial Committee determined that it was not an appropriate match for the audience, mission, or scope of the Code4Lib Journal. [optional - insert comment here about why it's not appropriate]

For more information about the mission of the Code4Lib Journal, please see http://journal.code4lib.org/mission/.

Thanks for considering us, and please do not hesitate to contact the editors at c4lj-articles@googlegroups.com in the future with a new or revised proposal.

[[Category: Code4Lib Journal]]

Umlaut Local Configuration Architecture

2009-06-11T14:38:56Z

128.220.205.186:

[[Category:Umlaut]]

== Principles/Goals: ==

# Ideally you will not need to edit the common Umlaut codebase to make purely local customizations. All local customizations should occur via various types of configuration options, with the common Umlaut codebase being untouched - except with changes of wider applicability you submit back to the common codebase.
# This means any code or config for local customization will ideally be kept clearly distinct from the common codebase.
# If you like, you should be able to keep any of your local code or config files in your own local SVN or CVS repository, while at the same time getting shared codebase Umlaut code from the central Umlaut repository, combined together in a working Umlaut installation. (You might or might not want your production Umlaut to be an SVN working copy, but if you are a developer you will certainly want your development copy to be!)

To accomplish this required doing things a tiny bit different than standard Rails.
:''We realized after the fact that the Rails Engines plugin might be a great solution to those Goals, requiring less that's 'not the Rails way', and may explore refactoring Umlaut to be an Engines plug-in. But hasn't happened yet.''

Where in a normal Rails app you would customize various files in the config directory, in Umlaut the files in the config directly have common Umlaut configuration necessary for any Umlaut environment, but your local config is instead in files in config/umlaut_config. There are files used in umlaut_config that look very much like the standard Rails config files (eg database.yml, environment.rb), and also some Umlaut specific ones (eg services.yml, institutions.yml).

== Directory Locations For Local Content ==
umlaut_config is just one of Umlaut's locations where local and localized code, config, and data lives:

* $Umlaut/config/umlaut_config: local configuration
* $Umlaut/public/local : Local graphics and other resources that can be served directly by the web server.
* $Umlaut/app/views/layouts/local : Local layouts (Used to put local banner, footer, stylesheets etc. on your pages)
* $Umlaut/app/views/local : Used to store any local Rails 'views', entirely customized page layouts of Umlaut functionality for local needs.

Other locations that are '''NOT yet used''', but would be reasonable extensions of this architecture in the future:

* $Umlaut/app/controllers/local
* $Umlaut/app/models/local

== Generation of local files ==

There is a a generator to create all these locations, and seed them with some sample data - since we want to make it easy to control them in your own SVN, you don't get even these local directory locations from the Umlaut svn.

You may already have run the generator to create these files from the [Umlaut Setup] step, but if not, change into $Umlaut directory and run:

<nowiki>./script/generate umlaut_local</nowiki>

Don't worry if you run this twice; it'll warn and prompt you before over-writing any existing files.

== Rake Tasks to Aid in Management of Local Locations ==

Integrating somewhat elegantly with Rails means that your local content is spread accross several different directories. Umlaut provides some rake tasks to help you control them in your own local svn.

:We also provide some rake tasks to perform svn operations on all of these local locations at once.

;rake <nowiki>umlaut_lcl:import_to_svn</nowiki>

:You've generated all this stuff, and added your own local content. Run this to add it all to your own local SVN--or any other SVN you have access to to store your local config. You'll be prompted for an SVN base path. Make sure to run umlaut_lcl:commit too, this operation does not commit any files!

;rake <nowiki>umlaut_lcl:checkout</nowiki>

:Let's say you already have your local files in your own SVN, but now you doing a new Umlaut install for whatever reason. This rake task will pull all your local stuff down en masse and put it into the new install. You will be prompted for an SVN base.

;rake <nowiki>umlaut_lcl:update</nowiki>

:svn update all local directory locations.

;rake <nowiki>umlaut_lcl:commit</nowiki>

:svn commit all local directory locations.

;rake <nowiki>umlaut_lcl:status</nowiki>

:Runs svn status on all local directory locations at once.

If you need to create an svn repo on a Linux box it's as easy as:

mkdir /home/username/svn

svnadmin create /home/username/svn

Then you can run the above rake tasks.

== A Locally Customized Layout ==

In addition to config files in umlaut_config, the one piece of local customization that almost everyone will do first is creating a local layout for your own look and feel. This can be fairly easily done even to those new to Ruby Rails. In Rails, there are template wrappers (or wrapper templates?) known as 'layouts'. We'll walk you through customizing an Umlaut layout to your local needs, and saving it in a local location.

Start out by copying the default resolver layout from $Umlaut/app/views/layouts/resolve_basic.rhtml to $Umlaut/app/views/layouts/local/myuniversity_resolve_layout.rhtml.

It's this copy now in local that you'll modify.

* Don't have a directory at .../layouts/local? See the above section! You need to run "rake umlaut_lcl:generate" and it'll make one for you. Or you could just create it by hand.
* In addition to the resolve_basic.rhtml, some other example locally customized resolve layouts are distributed with umlaut in $Umlaut/app/views/layouts/distribution. You could start with one of these instead, or use them to see what's possible.

Now edit this local copy to your heart's content. Change the header, change the footer. Link to a different stylesheet (perhaps your want to keep your own custom stylesheet in $Umlaut/public/local, and use the Rails methods to link to it). You should not disturb the declerations that looks like this:

:render(:partial => "layout_helpers/resolve_head_content" )

and

:render(:partial => "layout_helpers/resolve_body_open" )

Because they bring in some standard Umlaut functionality. But just about everything else is fair game.

Now you've got your layout all customized, how do you get your Umlaut installation to use it? (Of course, really, you'd want to get Umlaut to use it as you are developing it, so you can see how it looks!).

In your local config file at $Umlaut/config/umlaut_config/environment.rb, add (or uncomment) this line:

:config.app_config.resolve_layout = "local/myuniversity_resolve_layout.rhtml"

Start (or restart) Umlaut, and it should now be using your localized layout. Neat, huh?

This gives an example of how Umlaut localization is meant to work in general. Note how you didn't need to edit any of the files that came from Umlaut SVN to make this customization.

Umlaut Local Configuration Architecture

2009-06-11T14:38:29Z

128.220.205.186: /* Rake Tasks to Aid in Management of Local Locations */

[[Category:Umlaut]]

== Principles/Goals: ==

# Ideally you will not need to edit the common Umlaut codebase to make purely local customizations. All local customizations should occur via various types of configuration options, with the common Umlaut codebase being untouched - except with changes of wider applicability you submit back to the common codebase.
# This means any code or config for local customization will ideally be kept clearly distinct from the common codebase.
# If you like, you should be able to keep any of your local code or config files in your own local SVN or CVS repository, while at the same time getting shared codebase Umlaut code from the central Umlaut repository, combined together in a working Umlaut installation. (You might or might not want your production Umlaut to be an SVN working copy, but if you are a developer you will certainly want your development copy to be!)

To accomplish this required doing things a tiny bit different than standard Rails.
:''We realized after the fact that the Rails Engines plugin might be a great solution to those Goals, requiring less that's 'not the Rails way', and may explore refactoring Umlaut to be an Engines plug-in. But hasn't happened yet.''

Where in a normal Rails app you would customize various files in the config directory, in Umlaut the files in the config directly have common Umlaut configuration necessary for any Umlaut environment, but your local config is instead in files in config/umlaut_config. There are files used in umlaut_config that look very much like the standard Rails config files (eg database.yml, environment.rb), and also some Umlaut specific ones (eg services.yml, institutions.yml).

== Directory Locations For Local Content ==
umlaut_config is just one of Umlaut's locations where local and localized code, config, and data lives:

* $Umlaut/config/umlaut_config: local configuration
* $Umlaut/public/local : Local graphics and other resources that can be served directly by the web server.
* $Umlaut/app/views/layouts/local : Local layouts (Used to put local banner, footer, stylesheets etc. on your pages)
* $Umlaut/app/views/local : Used to store any local Rails 'views', entirely customized page layouts of Umlaut functionality for local needs.

Other locations that are '''NOT yet used''', but would be reasonable extensions of this architecture in the future:

* $Umlaut/app/controllers/local
* $Umlaut/app/models/local

== Rake Tasks to Aid in Management of Local Locations ==

Integrating somewhat elegantly with Rails means that your local content is spread accross several different directories. Umlaut provides some rake tasks to help you control them in your own local svn.

:We also provide some rake tasks to perform svn operations on all of these local locations at once.

;rake <nowiki>umlaut_lcl:import_to_svn</nowiki>

:You've generated all this stuff, and added your own local content. Run this to add it all to your own local SVN--or any other SVN you have access to to store your local config. You'll be prompted for an SVN base path. Make sure to run umlaut_lcl:commit too, this operation does not commit any files!

;rake <nowiki>umlaut_lcl:checkout</nowiki>

:Let's say you already have your local files in your own SVN, but now you doing a new Umlaut install for whatever reason. This rake task will pull all your local stuff down en masse and put it into the new install. You will be prompted for an SVN base.

;rake <nowiki>umlaut_lcl:update</nowiki>

:svn update all local directory locations.

;rake <nowiki>umlaut_lcl:commit</nowiki>

:svn commit all local directory locations.

;rake <nowiki>umlaut_lcl:status</nowiki>

:Runs svn status on all local directory locations at once.

If you need to create an svn repo on a Linux box it's as easy as:

mkdir /home/username/svn

svnadmin create /home/username/svn

Then you can run the above rake tasks.

== A Locally Customized Layout ==

In addition to config files in umlaut_config, the one piece of local customization that almost everyone will do first is creating a local layout for your own look and feel. This can be fairly easily done even to those new to Ruby Rails. In Rails, there are template wrappers (or wrapper templates?) known as 'layouts'. We'll walk you through customizing an Umlaut layout to your local needs, and saving it in a local location.

Start out by copying the default resolver layout from $Umlaut/app/views/layouts/resolve_basic.rhtml to $Umlaut/app/views/layouts/local/myuniversity_resolve_layout.rhtml.

It's this copy now in local that you'll modify.

* Don't have a directory at .../layouts/local? See the above section! You need to run "rake umlaut_lcl:generate" and it'll make one for you. Or you could just create it by hand.
* In addition to the resolve_basic.rhtml, some other example locally customized resolve layouts are distributed with umlaut in $Umlaut/app/views/layouts/distribution. You could start with one of these instead, or use them to see what's possible.

Now edit this local copy to your heart's content. Change the header, change the footer. Link to a different stylesheet (perhaps your want to keep your own custom stylesheet in $Umlaut/public/local, and use the Rails methods to link to it). You should not disturb the declerations that looks like this:

:render(:partial => "layout_helpers/resolve_head_content" )

and

:render(:partial => "layout_helpers/resolve_body_open" )

Because they bring in some standard Umlaut functionality. But just about everything else is fair game.

Now you've got your layout all customized, how do you get your Umlaut installation to use it? (Of course, really, you'd want to get Umlaut to use it as you are developing it, so you can see how it looks!).

In your local config file at $Umlaut/config/umlaut_config/environment.rb, add (or uncomment) this line:

:config.app_config.resolve_layout = "local/myuniversity_resolve_layout.rhtml"

Start (or restart) Umlaut, and it should now be using your localized layout. Neat, huh?

This gives an example of how Umlaut localization is meant to work in general. Note how you didn't need to edit any of the files that came from Umlaut SVN to make this customization.

Umlaut Local Configuration Architecture

2009-06-11T14:37:53Z

128.220.205.186: /* Rake Tasks to Aid in Management of Local Locations */

[[Category:Umlaut]]

== Principles/Goals: ==

# Ideally you will not need to edit the common Umlaut codebase to make purely local customizations. All local customizations should occur via various types of configuration options, with the common Umlaut codebase being untouched - except with changes of wider applicability you submit back to the common codebase.
# This means any code or config for local customization will ideally be kept clearly distinct from the common codebase.
# If you like, you should be able to keep any of your local code or config files in your own local SVN or CVS repository, while at the same time getting shared codebase Umlaut code from the central Umlaut repository, combined together in a working Umlaut installation. (You might or might not want your production Umlaut to be an SVN working copy, but if you are a developer you will certainly want your development copy to be!)

To accomplish this required doing things a tiny bit different than standard Rails.
:''We realized after the fact that the Rails Engines plugin might be a great solution to those Goals, requiring less that's 'not the Rails way', and may explore refactoring Umlaut to be an Engines plug-in. But hasn't happened yet.''

Where in a normal Rails app you would customize various files in the config directory, in Umlaut the files in the config directly have common Umlaut configuration necessary for any Umlaut environment, but your local config is instead in files in config/umlaut_config. There are files used in umlaut_config that look very much like the standard Rails config files (eg database.yml, environment.rb), and also some Umlaut specific ones (eg services.yml, institutions.yml).

== Directory Locations For Local Content ==
umlaut_config is just one of Umlaut's locations where local and localized code, config, and data lives:

* $Umlaut/config/umlaut_config: local configuration
* $Umlaut/public/local : Local graphics and other resources that can be served directly by the web server.
* $Umlaut/app/views/layouts/local : Local layouts (Used to put local banner, footer, stylesheets etc. on your pages)
* $Umlaut/app/views/local : Used to store any local Rails 'views', entirely customized page layouts of Umlaut functionality for local needs.

Other locations that are '''NOT yet used''', but would be reasonable extensions of this architecture in the future:

* $Umlaut/app/controllers/local
* $Umlaut/app/models/local

== Rake Tasks to Aid in Management of Local Locations ==

Integrating somewhat elegantly with Rails means that your local content is spread accross several different directories. Umlaut provides some rake tasks and a generator to help you deal with them.

=== Generation of local files ===

There is a a generator to create all these locations, and seed them with some sample data - since we want to make it easy to control them in your own SVN, you don't get even these local directory locations from the Umlaut svn.

You may already have run the generator to create these files from the [Umlaut Setup] step, but if not, change into $Umlaut directory and run:

<nowiki>./script/generate umlaut_local</nowiki>

Don't worry if you run this twice; it'll warn and prompt you before over-writing any existing files.

=== Tasks for local SVN management ===

:We also provide some rake tasks to perform svn operations on all of these local locations at once.

;rake <nowiki>umlaut_lcl:import_to_svn</nowiki>

:You've generated all this stuff, and added your own local content. Run this to add it all to your own local SVN--or any other SVN you have access to to store your local config. You'll be prompted for an SVN base path. Make sure to run umlaut_lcl:commit too, this operation does not commit any files!

;rake <nowiki>umlaut_lcl:checkout</nowiki>

:Let's say you already have your local files in your own SVN, but now you doing a new Umlaut install for whatever reason. This rake task will pull all your local stuff down en masse and put it into the new install. You will be prompted for an SVN base.

;rake <nowiki>umlaut_lcl:update</nowiki>

:svn update all local directory locations.

;rake <nowiki>umlaut_lcl:commit</nowiki>

:svn commit all local directory locations.

;rake <nowiki>umlaut_lcl:status</nowiki>

:Runs svn status on all local directory locations at once.

If you need to create an svn repo on a Linux box it's as easy as:

mkdir /home/username/svn

svnadmin create /home/username/svn

Then you can run the above rake tasks.

== A Locally Customized Layout ==

In addition to config files in umlaut_config, the one piece of local customization that almost everyone will do first is creating a local layout for your own look and feel. This can be fairly easily done even to those new to Ruby Rails. In Rails, there are template wrappers (or wrapper templates?) known as 'layouts'. We'll walk you through customizing an Umlaut layout to your local needs, and saving it in a local location.

Start out by copying the default resolver layout from $Umlaut/app/views/layouts/resolve_basic.rhtml to $Umlaut/app/views/layouts/local/myuniversity_resolve_layout.rhtml.

It's this copy now in local that you'll modify.

* Don't have a directory at .../layouts/local? See the above section! You need to run "rake umlaut_lcl:generate" and it'll make one for you. Or you could just create it by hand.
* In addition to the resolve_basic.rhtml, some other example locally customized resolve layouts are distributed with umlaut in $Umlaut/app/views/layouts/distribution. You could start with one of these instead, or use them to see what's possible.

Now edit this local copy to your heart's content. Change the header, change the footer. Link to a different stylesheet (perhaps your want to keep your own custom stylesheet in $Umlaut/public/local, and use the Rails methods to link to it). You should not disturb the declerations that looks like this:

:render(:partial => "layout_helpers/resolve_head_content" )

and

:render(:partial => "layout_helpers/resolve_body_open" )

Because they bring in some standard Umlaut functionality. But just about everything else is fair game.

Now you've got your layout all customized, how do you get your Umlaut installation to use it? (Of course, really, you'd want to get Umlaut to use it as you are developing it, so you can see how it looks!).

In your local config file at $Umlaut/config/umlaut_config/environment.rb, add (or uncomment) this line:

:config.app_config.resolve_layout = "local/myuniversity_resolve_layout.rhtml"

Start (or restart) Umlaut, and it should now be using your localized layout. Neat, huh?

This gives an example of how Umlaut localization is meant to work in general. Note how you didn't need to edit any of the files that came from Umlaut SVN to make this customization.

ServiceResponse data structures and generation

2009-05-28T18:46:54Z

128.220.205.186: /* The handle method */

Part of [[Umlaut Technical Overview]]

==ServiceResponse and related data structures==

Before talking about how the services generate data, we should talk about the data format of a [http://umlaut.rubyforge.org/api/classes/ServiceResponse.html ServiceResponse]. A ServiceResponse is basically a unit of information generated by a Service, generally for display somewhere on the link resolver menu page. For example, there might be a ServiceResponse representing a fulltext link, a help link, or an abstract. ServiceResponses almost always link out somewhere, along with providing other data for display.

The ServiceResponse entity has a few 'standard' properties (display_text, url, notes), but also a property, service_data, consisting of a serialized hash for holding arbitrary key/value information. Different service types might require different key/values here. The [] operator on ServiceResponse conveniently allows you to store arbitrary key/value information in this property (and also access/set the 'built-in' properties). For appropriately loose coupling between data stored, service generating it, and view, we define some conventions for what key/value pairs are used for what purposes in each response type, in comments on [http://umlaut.rubyforge.org/api/classes/ServiceResponse.html ServiceResponse class definition].

A ServiceResponse also records which Service generated it, using that Service's service_id/name as defined in config/umlaut_config/services.yml, and generally retrievable from the ServiceList.

So what do we mean by a 'service type'? The list of all valid service types is defined in the ServiceTypeValue table. Each ServiceTypeValue has a one-word internal identifier token (name), a display_name for user presentation, and optionally a display_name_pluralized (to over-ride standard Rails pluralization). The values in this table are initialized from db/orig_fixed_data/service_type_values.yml when you run rake umlautdb:load_initial_data. We intend the local implementer to be able to create locally defined ServiceTypeValues too, if necessary.

ServiceTypeValue uses the acts_as_enumerated plug-in to conveniently allow the developer to refer to an individual ServiceTypeValue by name: ServiceTypeValue[:fulltext] ==> the ServiceTypeValue object with name == 'fulltext'. acts_as_plugin does efficient caching.

So obviously which ServiceTypeValue a given ServiceResponse is intended for needs to be registered somewhere. But you won't find it in ServiceResponse, which might be confusing at first. In fact, there's a somewhat confusingly named three-way join object called ServiceType, which ties together:
* a ServiceResponse
* a ServiceTypeValue
* a Request

This architecture theoretically allows:
* One ServiceResponse to belong to multiple Requests (ServiceResponse cacheing accross requests/sessions).
* One ServiceResponse to be assigned ''multiple'' ServiceTypeValues and thus listed multiple times with a given Request.

In fact, Umlaut does not currently use ServiceResponse caching across requests; it turned out to be tricky to get right without clear gain. And very few (if any?) current services register the same ServiceResponse to a request with multiple ServiceTypeValues. But, the architecture is there to support it if needed in the future.

This data structure architecture ends up somewhat confusing (and ServiceType is probably not a clear name for that three-way join) but there are usually convenience methods defined to avoid the complexity; they should be used. See for example (tbd).

[http://bibwild.wordpress.com/files/2008/02/umlaut-serviceresponse.jpg Data structure diagram] Trying to figure out how to make this display inline, sorry.

==Obligations of Service logic==

What you need to know to write a new Service. How to generate data, and callback methods service logic can or must provide.

Recall that an umlaut "service" is defined in config/umlaut_config/services.yml to be a particular class holding the service logic, and some configuration parameters.

That class holding the service logic is called a "service adaptor", or somewhat ambiguously, sometimes times just a "service". Service adaptors live in lib/service_adaptors, and extend [http://umlaut.rubyforge.org/api/classes/Service.html Service].

===Statelessness===

Service logic should generally be written to be state-less. The same Service object, defined in services.yml, is initialized once and generally re-used for the life of an application instance (cached by ServiceList). So any state you store can end up persisting from request to request and session to session, which you probably don't intend. Umlaut architecture for background services also involves threads and forks, and while there's normally no reason a given service object would be in two threads simultaneously, better safe than sorry. It's safest to store no non-universal state in the service object.

===Disclosure methods===

A service adaptor must define [http://umlaut.rubyforge.org/api/classes/Service.html#service_types_generated service_types_generated()] to return an Array of ServiceTypeValues constituting the types of ServiceResponses the service

A service adaptor may optionally list some required configuration params. If they are not supplied, an exception will be thrown when the service is initialized from services.yml. eg:
: required_config_params :api_key, :base_url

===The handle method===

The heart of a typical service is in implementing the [http://umlaut.rubyforge.org/api/classes/Service.html#handle handle] method. When Umlaut wants a service to do it's thing, Umlaut will pass the request in, and it's up to the Service to do it's work. Note that while the individual umlaut request is passed into handle() as an argument for legacy purposes, it's also available from Service#request at any time, the argument isn't really necessary.

The service can examine all metadata from the request, and even examine ServiceResponses generated by other services, and the status of other services in progress or finished. (See [http://umlaut.rubyforge.org/api/classes/Request.html Request#dispatched_services], Request#dispatched, Request#services_in_progress, etc.)

The service can then enhance any metadata if desired (likely data in [http://umlaut.rubyforge.org/api/classes/Referent.html Referent], from Request#referent).

The service can create one or more ServiceResponses. A ServiceResponse normally represents a discrete package of data that will be displayed on some part of the resolve menu. ServiceResponses should generally be created with the convenience method [http://umlaut.rubyforge.org/api/classes/Request.html Request]#add_service_response.

The add_service_response call has you specify the particular service class, the ServiceTypeValue, and arbitrary key value pairs as appropriate/conventional for the given time. For conventions on these key/value pairs, see [http://umlaut.rubyforge.org/api/classes/ServiceResponse.html ServiceResponse]. For example:

<pre>
request.add_service_response(:service=>self,
:service_type_value => :cover_image,
:display_text => 'Cover Image',
:key=>size,
:url => img.inner_html,
:asin => asin,
:size => size )
</pre>

The Service code is also responsible for registering a DispatchedService object with the completion state of the service. This should be done with the convenience method [http://umlaut.rubyforge.org/api/classes/Request.html Request]#dispatched . If the service throws an uncaught exception, Umlaut itself will register a DispatchedService with status FailedFatal. But otherwise, the service is responsible for registering a completion status, or Umlaut may not realize the service is complete and continue running it over and over again, or reporting it as timed out.

===callback methods===

The Service can play an interactive role with the view elements of Umlaut in determining how to display the ServiceResponse and how to generate an external url for it if the user clicks on it. A Service doesn't need to do this--it can simply include properties in generated ServiceResponses for the conventional keys mentioned in [http://umlaut.rubyforge.org/api/classes/ServiceResponse.html ServiceResponse], including a pre-generated url in the :url property.

However, for more complicated processing (including not generating urls until the point-of-need when a user actually clicks on one), callback methods can instead be implemented.

These callback methods include [http://umlaut.rubyforge.org/api/classes/Service.html]#view_data_from_service_type(service_type_obj) , #to_[name of service goes here] (eg #to_fulltext, or #to_help ), Service#response_to_view_data, and Service#response_url.

For more information, see the Technical Overview section on view logic. (tbd).

==Alternate Service Tasks==

Services were originally designed to do one thing, as described above. However, it has been useful to use the service architecture to perform other 'tasks' too, basically other sorts of plug-ins. What plug-in 'task' a service will be called upon to perform depends on the task config property in services.yml, which defaults to 'standard' when empty.

The other service task we have defined currently as 'link_out_filter'. A task:link_out_filter service will never have it's handle method called. Instead, it will have a [http://umlaut.rubyforge.org/api/classes/Service.html Service#]link_out_filter method defined, and called at the appropriate control point. Examples of link_out_filter services are ezproxy, and sfx_backchannel_record.

[[Category: Umlaut]]

Umlaut Installation

2009-05-14T17:48:32Z

128.220.205.186: /* 2. Install RubyGems */

[[Category:Umlaut]]

To install Umlaut

== 1. Make sure you have a modern Ruby ==

Install a 1.8.x version of ruby, ruby 1.9 is still considered experimental. The Rails web page says "We recommend Ruby 1.8.7 for use with Rails. Ruby 1.8.6, 1.8.5, 1.8.4 and 1.8.2 are still usable too, but version 1.8.3 is not." (http://rubyonrails.org/download) Try installing Ruby with your package manager of choice. If not, try installing from source, eg

# [Download 1.8.4>http://rubyforge.org/frs/download.php/7858/ruby-1.8.7.tar.gz]
# tar -zxvf ruby-1.8.7.tar.gz
# cd ruby-1.8.7
# sudo ./configure
# sudo make
# sudo make install

( jrochkind is currently running ruby 1.8.6 as of Dec 08 )

== 2. Install RubyGems ==

Again, your package manager may be able to supply this (for example "yum install rubygems), but if not, you could again install from source:

# [Download here>http://rubyforge.org/frs/?group_id=126]
# tar -zxvf rubygems-x.x.x.tar.gz
# cd rubygems-x.x.x
# sudo ruby setup.rb
( actually don't do this, to be safe # sudo gem update) (I don't know what this means, jrochkind 14 May 09!)

== 3. Install Rails ==

Umlaut requires Rails 2.1.2, and is bound to it in the default environment.rb. It has not been verified for Rails 2.2.x yet. So install the 2.1.2 version of Rails (you can have multiple versions of Rails installed simulataneously, don't worry about this overwriting a more recent version of Rails you may want--it won't.)

"sudo gem install rails -v 2.1.2" (say yes to any dependencies)

'''Note''': There are various guides available on the net to getting Ruby/Rubygems/Rails installed on various OSs. Consult if you have trouble.

== 4. Install Umlaut ==

Right now, the best (only) way to install Umlaut is from it's SVN store.

For a read-only checkout:

<pre>
svn checkout http://umlaut.rubyforge.org/svn/trunk/ ./Umlaut
</pre>

Or instead of "./Umlaut", whatever local path you want to put the thing in.

For a checkout with commit privs, you need a rubyforge account and to be added to the umlaut project, then:

<pre>
svn checkout svn+ssh://(developername)@rubyforge.org/var/svn/umlaut/U2 ./Umlaut
</pre>

Umlaut comes with a number of Ruby gems and Rails plugins "frozen" into it's distribution, in vendor/plugins. You do not need to install these, they come with Umlaut. These include: json_pure ; sru; xisbn; enumerations_mixin (plugin) ; app_config (plugin); isbn-tools (plugin) ; openurl ( svn external link in plugin; needs to be fixed to link to a specific tag ); htmlentities (http://htmlentities.rubyforge.org/)

However, there are a few plugins that can not be conveniently packaged with Umlaut, you need to install them yourself...

== 5. Install Umlaut's gem dependencies ==

=== mongrel ===

(Umlaut will not run with WEBrick due to threading issues. Recommend installing mongrel for testing and deployment. mongrel 1.1.4 or later is highly reccommended. )

sudo gem install mongrel

=== hpricot ===

(hpricot is compiled C code, so you are best off installing it yourself. Right now hpricot 0.6 is tested and confirmed. )

sudo gem install hpricot -v 0.6

=== json ===

A pure-ruby json library is bundled with Umlaut automatically, but you really ought to install the compiled C one on your server instead, for much better performance. Umlaut will automatically use it if present. Currently verified with version 1.1.3

sudo gem install json -v 1.1.3

=== mysql ===

MySQL is the reccomended db, and the only db currently verified to work. Umlaut won't usually run with SQLite3 due to threading issues.

Rails is supposed to be able to talk to mysql without the mysql gem installed (just less efficiently), but for some reason Umlaut seems to have trouble with this. Not sure, you can try it.

sudo gem install msyql

Except some additional configuration arguments may be neccesary to compile on your machine.

===== redhat =====

On a RedHat machine, this works:

sudo gem install mysql -- --with-mysql-config=/usr/lib/mysql/mysql_config

===== ubuntu =====

On Ubuntu you will also need to:

sudo apt-get install libmysqlclient15-dev

Then you can:

sudo gem install mysql

Ubuntu also packages the mysql library, if you'd rather use that version you can try:

sudo apt-get install libmysql-ruby

===== Solaris 10 (sparc) =====

This has been reported to work on Solaris 10 (sparc)

gem install mysql -- --with-mysql-include=/opt/pkgs/mysql/include/
\ --with-mysql-lib=/opt/pkgs/mysql/lib

=== More optional gems ===

* Voyager sites that want to bypass z39.50 and access Oracle directly will need Oracle Instant Client or Full Client installed on the same machine as the Umlaut. (This native Voyager code is not currently verified as working.) [http://www.jiubao.org/ruby-oci8 Oracle OCI8] [http://www.oracle.com/technology/tech/oci/instantclient/index.html Oracle Instant Client]

== Now You Need to Setup Umlaut ==

Good job, you've got all software installed, now you need to do some setup. See [[Umlaut Setup]].

Code4Lib Editorial Committee Introduction

2009-04-24T15:30:42Z

128.220.205.186:

[[Category: Code4Lib Journal]]

== How the Editorial Committee Functions ==

The Code4Lib Journal Editorial Committee works much as Code4Lib does: informally and collaboratively. For each issue, one member of the Editorial Committee (EC) volunteers to be Coordinating Editor (ie managing editor) of a journal issue. For the duration of their tenure, the Coordinating Editor is generally responsible for any loose ends tying, and making sure everything proceeds smoothly, coordinating all of the rest of us. This includes distributing the call for papers, communicating with potential authors, opening and closing editorial committee voting on submissions, notifying authors of rejected articles, and making sure that accepted articles have volunteer editors (and that those editors notify authors of accepted articles).

Everyone on the EC may vote on article proposals as they come in. The Coordinating Editor generally sets a deadline of 1-2 weeks for voting. Voting is straightforward and recorded in the Article Tracking spreadsheet. An article must have at least two 'yes' votes and more 'yes' votes than 'no' votes to be accepted. Once an article is accepted for publication, an EC member volunteers to take on editorial responsibility for that article and shepherds it from proposal to publication, acting as the journal's single point of contact with the author. Most Committee members take responsibility for about one article per issue, though the committee is large enough that there is some flexibility with editorial responsibility.

Editing an article includes making sure the article draft is submitted on time, distributing drafts to the full committee for comment, making editorial suggestions or recommendations to the author(s), tracking and enforcing submission deadlines, requesting full Editorial Committee approval of the final draft, and inputting the finished article into our [http://wiki.code4lib.org/index.php/Code4Lib_Editorial_Committee_Introduction#Wordpress_.28Required.29 WordPress site]. Once the assigned editor recommends the final draft for publication, the EC again votes on whether to include that article in the current issue. Again, this requires at least two 'yes' votes and more 'yes' votes than 'no' votes for publication. We do not expect every EC member to vote on every article, but we do ask that you read an article thoroughly before voting on it for inclusion in the issue.

More detailed information describing the entire process from sending out the call for proposals to publishing a new issue is available on the Journal site:
* [http://journal.code4lib.org/process-and-structure General outline of process and structure]
* [http://journal.code4lib.org/process-and-structure/editors More detailed information for editors] (requires Wordpress login)

Templates for notifying authors about the status of their proposals are available as a [http://groups.google.com/group/c4lj-articles/web/templates-for-email-responses page] in the c4lj-articles Google group.

Above all, the Editorial Committee is informal and egalitarian. Jump in with your opinion and ideas!

== Editorial Committee Discussion Lists (Required) ==

Much of the Editorial Committee's business is conducted via email on the [http://groups.google.com/group/c4lj-articles C4LJ-Articles] Google Group. This list is where we debate article submissions, volunteer to be editor or managing editor, discuss acceptance of articles, and take care of any other tasks in front of us that might be of a sensitive nature. Anyone may post to this list, but only editors can read the list activity. To join this list, please visit the URL and request membership, using your preferred email associated with a Google account. If that doesn't work for some reason, you can join the c4lj-discuss group (see below) and send an email requesting membership to c4lj-articles.

All other Journal business is discussed on the [http://groups.google.com/group/c4lj-discuss C4LJ-Discuss] Google Group. If the conversation is unrelated to specific authors, proposals, or articles, it should probably happen on this list. We prefer to discuss other decisions about how the Journal is handled in public where anyone can participate. This list is open for anyone to join and is publicly viewable. Only list members can post. Use the URL above to join this discussion list.

== Article Tracking Spreadsheet (Required) ==

Articles, from proposal submission through to publication, are tracked using the C4LJ Article Tracking spreadsheet in Google Docs. This Google document is private; only Editorial Committee members may view or edit it. Proposal votes and tentative issue assignments for accepted articles are tracked in this spreadsheet. The [http://groups.google.com/group/c4lj-articles/browse_thread/thread/ec4c9701401ce94c/70079ef809a6a9da invitation] to become a collaborator is available on the c4lj-articles list. Please use this invitation to add yourself as a collaborator for this document (you must already be a member of c4lj-articles).

== Wordpress (Required) ==

Code4Lib Journal articles are published in a Wordpress installation hosted by ibiblio (http://journal.code4lib.org). The assigned editor for an article is responsible for entering the content into Wordpress, formatting it, and adding images and code snippets. Guidelines on entering articles are available on the [[Code4Lib_Journal_WordPress_Input_Guidelines|wiki]]. We also maintain basic information about the Journal using pages in Wordpress (Mission, Editorial Committee, Process and Structure, Call for Submissions, Article Guidelines).

New editors need to request a Wordpress account:

# Go to http://journal.code4lib.org/wp/wp-login.php?action=register
# Register
# Send your username to c4lj-articles@googlegroups.com so the technical editor can grant you Wordpress privileges.

== Google Analytics (Optional) ==

Google Analytics is used to gather statistics for the Code4Lib Journal. If you are interested in being able to view these statistics, just send your preferred Google Account information to the c4lj-articles@googlegroups.com discussion list, and the technical editor will enable your access.

== Other Shared Documents (Optional) ==

The C4LJ Article/Author Ideas spreadsheet is used to track ideas for have for specific articles we'd like to recruit or specific authors we want to recruit for the Journal. The [http://groups.google.com/group/c4lj-articles/browse_thread/thread/425165428b88e2ee invitation] to become a collaborative editor is available on the c4lj-articles list.

Code4Lib Journal Entries in Directory of Open Access Journals

2009-04-06T15:45:07Z

128.220.205.186: /* Semi-Automated */

There are two ways to get metadata into the Directory of Open Access Journals: 1) by hand, or 2) through the use of an XML file. Before you do either method, please keep in mind the following things:

# We chose not to have volume numbers, just issue numbers. Issue numbers will just keep incrementing.
# We decided that the "record number" for an article is the article-id that shows up in the WordPress URI. That is, they are not sequential, numbers are skipped. That's fine. So there is no 'start page', but there is a 'record number'; there is no 'end page'.
# Enter the abstract and authors affiliation exactly as found in our published articles.
# Enter keywords if there are any. If not, leave this blank

==By Hand==

To edit by hand go to http://www.doaj.org/restricted, enter our secret username/password combination, and do the necessary data entry.

See this [http://groups.google.com/group/c4lj-articles/browse_thread/thread/ba2efed674d66d7a post] for username and password information.

==Semi-Automated==

To use the XML file to do data entry:
# make sure the WordPress databases is up-to-date,
# go to http://journal.code4lib.org/issues/issue#/feed/doaj to get the necessary XML. (eg http://journal.code4lib.org/issues/issue5/feed/doaj.)
# edit the XML [http://journal.code4lib.org/doaj/|so each author is in a element by themselves],
# validate the XML against the Directory's schema, (how do you do this? -jrochkind)
# go to http://www.doaj.org/restricted and upload the friuts of your labors. See this [http://groups.google.com/group/c4lj-articles/browse_thread/thread/ba2efed674d66d7a post] for username and password information.

More info about the feed and how to customize the XML for import into DOAJ: http://journal.code4lib.org/doaj/

--[[User:Ericleasemorgan|Eric Lease Morgan]] 10:42, 28 May 2008 (PDT)

[[Category: Code4Lib Journal]]

Code4Lib Journal Entries in Directory of Open Access Journals

2009-04-06T15:43:40Z

128.220.205.186:

There are two ways to get metadata into the Directory of Open Access Journals: 1) by hand, or 2) through the use of an XML file. Before you do either method, please keep in mind the following things:

# We chose not to have volume numbers, just issue numbers. Issue numbers will just keep incrementing.
# We decided that the "record number" for an article is the article-id that shows up in the WordPress URI. That is, they are not sequential, numbers are skipped. That's fine. So there is no 'start page', but there is a 'record number'; there is no 'end page'.
# Enter the abstract and authors affiliation exactly as found in our published articles.
# Enter keywords if there are any. If not, leave this blank

==By Hand==

To edit by hand go to http://www.doaj.org/restricted, enter our secret username/password combination, and do the necessary data entry.

See this [http://groups.google.com/group/c4lj-articles/browse_thread/thread/ba2efed674d66d7a post] for username and password information.

==Semi-Automated==

To use the XML file to do data entry:
# make sure the WordPress databases is up-to-date,
# go to http://journal.code4lib.org/issues/issue#/feed/doaj to get the necessary XML. (eg http://journal.code4lib.org/issues/issue5/feed/doaj.)
# edit the XML [http://journal.code4lib.org/doaj/|so each author is in a element by themselves],
# validate the XML against the Directory's schema, (how do you do this? -jrochkind)
# go to http://www.doaj.org/restricted and upload the friuts of your labors.

More info about the feed and how to customize the XML for import into DOAJ: http://journal.code4lib.org/doaj/

--[[User:Ericleasemorgan|Eric Lease Morgan]] 10:42, 28 May 2008 (PDT)

[[Category: Code4Lib Journal]]

Code4Lib Journal Entries in Directory of Open Access Journals

2009-04-06T15:43:20Z

128.220.205.186:

There are two ways to get metadata into the Directory of Open Access Journals: 1) by hand, or 2) through the use of an XML file. Before you do either method, please keep in mind the following things:

#. We chose not to have volume numbers, just issue numbers. Issue numbers will just keep incrementing.

#. We decided that the "record number" for an article is the article-id that shows up in the WordPress URI. That is, they are not sequential, numbers are skipped. That's fine. So there is no 'start page', but there is a 'record number'; there is no 'end page'.

#. Enter the abstract and authors affiliation exactly as found in our published articles.

#. Enter keywords if there are any. If not, leave this blank

==By Hand==

To edit by hand go to http://www.doaj.org/restricted, enter our secret username/password combination, and do the necessary data entry.

See this [http://groups.google.com/group/c4lj-articles/browse_thread/thread/ba2efed674d66d7a post] for username and password information.

==Semi-Automated==

To use the XML file to do data entry:
# make sure the WordPress databases is up-to-date,
# go to http://journal.code4lib.org/issues/issue#/feed/doaj to get the necessary XML. (eg http://journal.code4lib.org/issues/issue5/feed/doaj.)
# edit the XML [http://journal.code4lib.org/doaj/|so each author is in a element by themselves],
# validate the XML against the Directory's schema, (how do you do this? -jrochkind)
# go to http://www.doaj.org/restricted and upload the friuts of your labors.

More info about the feed and how to customize the XML for import into DOAJ: http://journal.code4lib.org/doaj/

--[[User:Ericleasemorgan|Eric Lease Morgan]] 10:42, 28 May 2008 (PDT)

[[Category: Code4Lib Journal]]

Code4Lib Journal Entries in Directory of Open Access Journals

2009-04-06T15:42:28Z

128.220.205.186:

There are two ways to get metadata into the Directory of Open Access Journals: 1) by hand, or 2) through the use of an XML file. Before you do either method, please keep in mind the following things:

1. We chose not to have volume numbers, just issue numbers. Issue numbers will just keep incrementing.

2. We decided that the "record number" for an article is the article-id that shows up in the WordPress URI. That is, they are not sequential, numbers are skipped. That's fine. So there is no 'start page', but there is a 'record number'; there is no 'end page'.

3. Enter the abstract and authors affiliation exactly as found in our published articles.

4. Enter keywords if there are any. If not, leave this blank

To edit by hand go to http://www.doaj.org/restricted, enter our secret username/password combination, and do the necessary data entry.

See this [http://groups.google.com/group/c4lj-articles/browse_thread/thread/ba2efed674d66d7a post] for username and password information.

To use the XML file to do data entry:
# make sure the WordPress databases is up-to-date,
# go to http://journal.code4lib.org/issues/issue#/feed/doaj to get the necessary XML. (eg http://journal.code4lib.org/issues/issue5/feed/doaj.)
# edit the XML [http://journal.code4lib.org/doaj/|so each author is in a element by themselves],
# validate the XML against the Directory's schema, (how do you do this? -jrochkind)
# go to http://www.doaj.org/restricted and upload the friuts of your labors.

More info about the feed and how to customize the XML for import into DOAJ: http://journal.code4lib.org/doaj/

--[[User:Ericleasemorgan|Eric Lease Morgan]] 10:42, 28 May 2008 (PDT)

[[Category: Code4Lib Journal]]

Code4Lib Journal Entries in Directory of Open Access Journals

2009-04-06T15:40:30Z

128.220.205.186:

There are two ways to get metadata into the Directory of Open Access Journals: 1) by hand, or 2) through the use of an XML file. Before you do either method, please keep in mind the following things:

1. We chose not to have volume numbers, just issue numbers. Issue numbers will just keep incrementing.

2. We decided that the "record number" for an article is the article-id that shows up in the WordPress URI. That is, they are not sequential, numbers are skipped. That's fine. So there is no 'start page', but there is a 'record number'; there is no 'end page'.

3. Enter the abstract and authors affiliation exactly as found in our published articles.

4. Enter keywords if there are any. If not, leave this blank

To edit by hand go to http://www.doaj.org/restricted, enter our secret username/password combination, and do the necessary data entry.

See this [http://groups.google.com/group/c4lj-articles/browse_thread/thread/ba2efed674d66d7a post] for username and password information.

To use the XML file to do data entry, make sure the WordPress databases is up-to-date, go to http://journal.code4lib.org/issues/issue#/feed/doaj to get the necessary XML, [http://journal.code4lib.org/doaj/|edit the XML so each author is in a element by themselves], validate the XML against the Directory's schema, go to http://www.doaj.org/restricted and upload the friuts of your labors. For example, the XML for issue 5 is available at http://journal.code4lib.org/issues/issue5/feed/doaj.

This seems to supply some information about the feed and how to customize the XML for import into DOAJ, but doesn't actually provide XML: http://journal.code4lib.org/doaj/

--[[User:Ericleasemorgan|Eric Lease Morgan]] 10:42, 28 May 2008 (PDT)

[[Category: Code4Lib Journal]]

Code4Lib Journal Email Templates

2009-03-13T21:29:07Z

128.220.205.186: /* Proposal Accepted */

''See also [[Code4Lib_Journal_Deadlines]]''

== Submission Acknowledgement ==

Thanks for submitting a proposal to the Code4Lib Journal. We appreciate your participation in the code4lib community. The editors have received your proposal and should be in touch with you in 2-4 weeks regarding its appropriateness for publication in C4LJ. We will notify you if we need additional information to make this decision. Please feel free to contact us at c4lj-articles@googlegroups.com if you have additional questions.

== Need More Information ==

Thank you for your interest in publishing in the Code4Lib Journal. The Journal is primarily focused on technological issues in libraries. In order to help the editors determine if your proposal is appropriate for this publication, could you share more details about the intended audience for the the article and how it will address issues surrounding technology in libraries? Please respond to c4lj-articles@googlegroups.com with the additional information requested.

You may also contact the editors at c4lj-articles@googlegroups.com if you have any additional questions. We look forward to hearing from you.

== Proposal Accepted ==

I'm pleased to tell you that the Code4Lib journal is interested in your recent article proposal about <insert topic/title>. Based on your proposal, we are interested in this topic, and would like to see a draft.

<insert any additional comments about focus we'd like to see in the article or editorial committee concerns. Sample language "We're especially interested in X, and we'd like you to make sure to flesh this out when you write the article.". "We're interested in this proposal if you can do X, Y, or Z.">

As a member of the Code4Lib Journal editorial committee, I will be your contact for your proposed Code4Lib Journal article, and will work with you to get the article ready for publication.

We hope to publish your article in issue <#> of the Journal, which is scheduled to be published on <insert date here>. We need to see a complete draft of the article by <deadline for draft>, but the sooner you can get us a draft the better, the more likely we'll be able to get your article into that issue. Once we see a complete draft, we may work with you on additional requested edits before the Editorial Committee will consider it ready for publication. Your proposal definitely looks like an article we're interested in, but we can only make the final decision to publish when we see a complete draft.

To see what we're looking for, you should consult our author guidelines at: http://journal.code4lib.org/article-guidelines.

As a final note, we require all authors to agree to CC-BY licensing for the articles we publish in the journal. We recommend that any included code also have some type of code-specific open source license (such as the GPL).

We are excited about your article, and look forward to seeing a complete draft and including it in the Journal. Thanks for submitting to us, and feel free to contact me directly with any questions.

== Proposal Rejected ==

We regret to inform you that your recent proposal to the Code4Lib Journal for an article about <insert topic/title> has not been accepted for publication. This is likely because the Editorial Committee determined that it was not an appropriate match for the audience, mission, or scope of the Code4Lib Journal. [optional - insert comment here about why it's not appropriate]

For more information about the mission of the Code4Lib Journal, please see http://journal.code4lib.org/mission/.

Thanks for considering us, and please do not hesitate to contact the editors at c4lj-articles@googlegroups.com in the future with a new or revised proposal.

[[Category: Code4Lib Journal]]

Code4Lib Journal Email Templates

2009-03-13T21:21:07Z

128.220.205.186: /* Proposal Accepted */

''See also [[Code4Lib_Journal_Deadlines]]''

== Submission Acknowledgement ==

Thanks for submitting a proposal to the Code4Lib Journal. We appreciate your participation in the code4lib community. The editors have received your proposal and should be in touch with you in 2-4 weeks regarding its appropriateness for publication in C4LJ. We will notify you if we need additional information to make this decision. Please feel free to contact us at c4lj-articles@googlegroups.com if you have additional questions.

== Need More Information ==

Thank you for your interest in publishing in the Code4Lib Journal. The Journal is primarily focused on technological issues in libraries. In order to help the editors determine if your proposal is appropriate for this publication, could you share more details about the intended audience for the the article and how it will address issues surrounding technology in libraries? Please respond to c4lj-articles@googlegroups.com with the additional information requested.

You may also contact the editors at c4lj-articles@googlegroups.com if you have any additional questions. We look forward to hearing from you.

== Proposal Accepted ==

I'm pleased to tell you that the Code4Lib journal is interested in your recent article proposal about <insert topic/title>. Based on your proposal, we are interested in this topic, and would like to see a draft.

<insert any additional comments about focus we'd like to see in the article or editorial committee concerns. Sample language "We're especially interested in X, and we'd like you to make sure to flesh this out when you write the article.". "We're interested in this proposal if you can do X, Y, or Z.">

As a member of the Code4Lib Journal editorial committee, I will be your contact for your proposed Code4Lib Journal article, and will work with you to get the article ready for publication.

We hope to publish your article in issue <#> of the Journal, which is scheduled to be published on <insert date here>. We need to see a complete draft of the article by <deadline for draft>, but the sooner you can get us a draft the better, the more likely we'll be able to get your article into that issue. Once we see a complete draft, we may work with you on additional requested edits before the Editorial Committee will consider it ready for publication. Your proposal definitely looks like article we're interested in, but we can only make the final decision to publish when we see a complete draft.

To see what we're looking for, you should consult our author guidelines at: http://journal.code4lib.org/article-guidelines.

As a final note, we require all authors to agree to CC-BY licensing for the articles we publish in the journal. We recommend that any included code also have some type of code-specific open source license (such as the GPL).

We are excited about your article, and look forward to seeing a complete draft and including it in the Journal. Thanks for submitting to us, and feel free to contact me directly with any questions.

== Proposal Rejected ==

We regret to inform you that your recent proposal to the Code4Lib Journal for an article about <insert topic/title> has not been accepted for publication. This is likely because the Editorial Committee determined that it was not an appropriate match for the audience, mission, or scope of the Code4Lib Journal. [optional - insert comment here about why it's not appropriate]

For more information about the mission of the Code4Lib Journal, please see http://journal.code4lib.org/mission/.

Thanks for considering us, and please do not hesitate to contact the editors at c4lj-articles@googlegroups.com in the future with a new or revised proposal.

[[Category: Code4Lib Journal]]

Code4Lib Journal Email Templates

2009-03-13T21:19:51Z

128.220.205.186: /* Proposal Accepted */

''See also [[Code4Lib_Journal_Deadlines]]''

== Submission Acknowledgement ==

Thanks for submitting a proposal to the Code4Lib Journal. We appreciate your participation in the code4lib community. The editors have received your proposal and should be in touch with you in 2-4 weeks regarding its appropriateness for publication in C4LJ. We will notify you if we need additional information to make this decision. Please feel free to contact us at c4lj-articles@googlegroups.com if you have additional questions.

== Need More Information ==

Thank you for your interest in publishing in the Code4Lib Journal. The Journal is primarily focused on technological issues in libraries. In order to help the editors determine if your proposal is appropriate for this publication, could you share more details about the intended audience for the the article and how it will address issues surrounding technology in libraries? Please respond to c4lj-articles@googlegroups.com with the additional information requested.

You may also contact the editors at c4lj-articles@googlegroups.com if you have any additional questions. We look forward to hearing from you.

== Proposal Accepted ==

I'm pleased to tell you that the Code4Lib journal is interested in your recent article proposal about <insert topic/title>. Based on your proposal, we are interested in this topic, and would like to see a draft.

<insert any additional comments about focus we'd like to see in the article or editorial committee concerns. Sample language "We're especially interested in X, and we'd like you to make sure to flesh this out when you write the article.". "We're interested in this proposal if you can do X, Y, or Z.">

As a member of the Code4Lib Journal editorial committee, I will be your contact for your proposed Code4Lib Journal article, and will work with you to get the article ready for publication.

We hope to publish your article in issue <#> of the Journal, which is scheduled to be published on <insert date here>. We need to see a complete draft of the article is <deadline for draft>, but the sooner you can get us a draft the better, the more likely we'll be able to get your article into that issue. Once we see a complete draft, we may work with you on additional requested edits before the Editorial Committee will consider it ready for publication. Your proposal definitely looks like article we're interested in, but we can only make the final decision to publish when we see a complete draft.

To see what we're looking for, you should consult our author guidelines at: http://journal.code4lib.org/article-guidelines.

As a final note, we require all authors to agree to CC-BY licensing for the articles we publish in the journal. We recommend that any included code also have some type of code-specific open source license (such as the GPL).

We are excited about your article, and look forward to seeing a complete draft and including it in the Journal. Thanks for submitting to us, and feel free to contact me directly with any questions.

== Proposal Rejected ==

We regret to inform you that your recent proposal to the Code4Lib Journal for an article about <insert topic/title> has not been accepted for publication. This is likely because the Editorial Committee determined that it was not an appropriate match for the audience, mission, or scope of the Code4Lib Journal. [optional - insert comment here about why it's not appropriate]

For more information about the mission of the Code4Lib Journal, please see http://journal.code4lib.org/mission/.

Thanks for considering us, and please do not hesitate to contact the editors at c4lj-articles@googlegroups.com in the future with a new or revised proposal.

[[Category: Code4Lib Journal]]

Code4Lib Journal Email Templates

2009-03-13T21:14:38Z

128.220.205.186: /* Proposal Accepted */

''See also [[Code4Lib_Journal_Deadlines]]''

== Submission Acknowledgement ==

Thanks for submitting a proposal to the Code4Lib Journal. We appreciate your participation in the code4lib community. The editors have received your proposal and should be in touch with you in 2-4 weeks regarding its appropriateness for publication in C4LJ. We will notify you if we need additional information to make this decision. Please feel free to contact us at c4lj-articles@googlegroups.com if you have additional questions.

== Need More Information ==

Thank you for your interest in publishing in the Code4Lib Journal. The Journal is primarily focused on technological issues in libraries. In order to help the editors determine if your proposal is appropriate for this publication, could you share more details about the intended audience for the the article and how it will address issues surrounding technology in libraries? Please respond to c4lj-articles@googlegroups.com with the additional information requested.

You may also contact the editors at c4lj-articles@googlegroups.com if you have any additional questions. We look forward to hearing from you.

== Proposal Accepted ==

I'm pleased to tell you that the Code4Lib journal is interested in your recent article proposal about <insert topic/title>. Based on your proposal, we are interested in this topic, and would like to see a draft.

<insert any additional comments about focus we'd like to see in the article or editorial committee concerns. Sample language "We're especially interested in X, and we'd like you to make sure to flesh this out when you write the article.". "We're interested in this proposal if you can do X, Y, or Z.">

As a member of the Code4Lib Journal editorial committee, I will be your contact for your proposed Code4Lib Journal article, and will work with you to get the article ready for publication.

We hope to publish your article in issue <#> of the Journal, which is scheduled to be published on <insert date here>. We need to see a complete draft of the article is <deadline for draft>, but the sooner you can get us a draft the better, the more likely we'll be able to get your article into that issue. Once we see a complete draft, we may work with you on additional requested edits before the Editorial Committee will vote again to finalize its publication. Your proposal definitely looks like article we're interested in, but we can only make the final decision to publish when we see a complete draft.

To see what we're looking for, you should consult our author guidelines at: http://journal.code4lib.org/article-guidelines.

As a final note, we require all authors to agree to CC-BY licensing for the articles we publish in the journal. We recommend that any included code also have some type of code-specific open source license (such as the GPL).

We are excited about your article, and look forward to seeing a complete draft and including it in the Journal. Thanks for submitting to us, and feel free to contact me directly with any questions.

== Proposal Rejected ==

We regret to inform you that your recent proposal to the Code4Lib Journal for an article about <insert topic/title> has not been accepted for publication. This is likely because the Editorial Committee determined that it was not an appropriate match for the audience, mission, or scope of the Code4Lib Journal. [optional - insert comment here about why it's not appropriate]

For more information about the mission of the Code4Lib Journal, please see http://journal.code4lib.org/mission/.

Thanks for considering us, and please do not hesitate to contact the editors at c4lj-articles@googlegroups.com in the future with a new or revised proposal.

[[Category: Code4Lib Journal]]

Code4Lib Journal Email Templates

2009-03-13T21:05:35Z

128.220.205.186: wiki headings for easier editing

''See also [[Code4Lib_Journal_Deadlines]]''

== Submission Acknowledgement ==

Thanks for submitting a proposal to the Code4Lib Journal. We appreciate your participation in the code4lib community. The editors have received your proposal and should be in touch with you in 2-4 weeks regarding its appropriateness for publication in C4LJ. We will notify you if we need additional information to make this decision. Please feel free to contact us at c4lj-articles@googlegroups.com if you have additional questions.

== Need More Information ==

Thank you for your interest in publishing in the Code4Lib Journal. The Journal is primarily focused on technological issues in libraries. In order to help the editors determine if your proposal is appropriate for this publication, could you share more details about the intended audience for the the article and how it will address issues surrounding technology in libraries? Please respond to c4lj-articles@googlegroups.com with the additional information requested.

You may also contact the editors at c4lj-articles@googlegroups.com if you have any additional questions. We look forward to hearing from you.

== Proposal Accepted ==

Congratulations! Your recent proposal for an article about <insert topic/title> has been provisionally accepted to the Code4Lib Journal. As a member of the Code4Lib Journal editorial committee, I will be your contact for your proposed Code4Lib Journal article, and will work with you to get the article ready for publication.

We would like to publish your article in issue <#> of the Journal, which is scheduled to be published on <insert date here>. The deadline for submission of a complete draft of the article is <deadline for draft>, but the sooner you can get us a draft the better, the more likely we'll be able to get your article into that issue. To see what we're looking for, you should consult our author guidelines at: http://journal.code4lib.org/article-guidelines. Once you have submitted a complete draft for publication, we may work with you on additional requested edits before the Editorial Committee will vote again to finalize its publication.

As a final note, we require all authors to agree to CC-BY licensing for the articles we publish in the journal. We recommend that any included code also have some type of code-specific open source license (such as the GPL).

<insert any additional comments about focus we'd like to see in the article or editorial committee concerns>

We are excited about your article, and look forward to seeing a complete draft and including it in the Journal. Thanks for submitting to us, and feel free to contact me directly with any questions.

== Proposal Rejected ==

We regret to inform you that your recent proposal to the Code4Lib Journal for an article about <insert topic/title> has not been accepted for publication. This is likely because the Editorial Committee determined that it was not an appropriate match for the audience, mission, or scope of the Code4Lib Journal. [optional - insert comment here about why it's not appropriate]

For more information about the mission of the Code4Lib Journal, please see http://journal.code4lib.org/mission/.

Thanks for considering us, and please do not hesitate to contact the editors at c4lj-articles@googlegroups.com in the future with a new or revised proposal.

[[Category: Code4Lib Journal]]

ServiceResponse data structures and generation

2009-02-09T19:57:07Z

128.220.205.186: /* The handle method */

Part of [[Umlaut Technical Overview]]

==ServiceResponse and related data structures==

Before talking about how the services generate data, we should talk about the data format of a [http://umlaut.rubyforge.org/api/classes/ServiceResponse.html ServiceResponse]. A ServiceResponse is basically a unit of information generated by a Service, generally for display somewhere on the link resolver menu page. For example, there might be a ServiceResponse representing a fulltext link, a help link, or an abstract. ServiceResponses almost always link out somewhere, along with providing other data for display.

The ServiceResponse entity has a few 'standard' properties (display_text, url, notes), but also a property, service_data, consisting of a serialized hash for holding arbitrary key/value information. Different service types might require different key/values here. The [] operator on ServiceResponse conveniently allows you to store arbitrary key/value information in this property (and also access/set the 'built-in' properties). For appropriately loose coupling between data stored, service generating it, and view, we define some conventions for what key/value pairs are used for what purposes in each response type, in comments on [http://umlaut.rubyforge.org/api/classes/ServiceResponse.html ServiceResponse class definition].

A ServiceResponse also records which Service generated it, using that Service's service_id/name as defined in config/umlaut_config/services.yml, and generally retrievable from the ServiceList.

So what do we mean by a 'service type'? The list of all valid service types is defined in the ServiceTypeValue table. Each ServiceTypeValue has a one-word internal identifier token (name), a display_name for user presentation, and optionally a display_name_pluralized (to over-ride standard Rails pluralization). The values in this table are initialized from db/orig_fixed_data/service_type_values.yml when you run rake umlautdb:load_initial_data. We intend the local implementer to be able to create locally defined ServiceTypeValues too, if necessary.

ServiceTypeValue uses the acts_as_enumerated plug-in to conveniently allow the developer to refer to an individual ServiceTypeValue by name: ServiceTypeValue[:fulltext] ==> the ServiceTypeValue object with name == 'fulltext'. acts_as_plugin does efficient caching.

So obviously which ServiceTypeValue a given ServiceResponse is intended for needs to be registered somewhere. But you won't find it in ServiceResponse, which might be confusing at first. In fact, there's a somewhat confusingly named three-way join object called ServiceType, which ties together:
* a ServiceResponse
* a ServiceTypeValue
* a Request

This architecture theoretically allows:
* One ServiceResponse to belong to multiple Requests (ServiceResponse cacheing accross requests/sessions).
* One ServiceResponse to be assigned ''multiple'' ServiceTypeValues and thus listed multiple times with a given Request.

In fact, Umlaut does not currently use ServiceResponse caching across requests; it turned out to be tricky to get right without clear gain. And very few (if any?) current services register the same ServiceResponse to a request with multiple ServiceTypeValues. But, the architecture is there to support it if needed in the future.

This data structure architecture ends up somewhat confusing (and ServiceType is probably not a clear name for that three-way join) but there are usually convenience methods defined to avoid the complexity; they should be used. See for example (tbd).

[http://bibwild.wordpress.com/files/2008/02/umlaut-serviceresponse.jpg Data structure diagram] Trying to figure out how to make this display inline, sorry.

==Obligations of Service logic==

What you need to know to write a new Service. How to generate data, and callback methods service logic can or must provide.

Recall that an umlaut "service" is defined in config/umlaut_config/services.yml to be a particular class holding the service logic, and some configuration parameters.

That class holding the service logic is called a "service adaptor", or somewhat ambiguously, sometimes times just a "service". Service adaptors live in lib/service_adaptors, and extend [http://umlaut.rubyforge.org/api/classes/Service.html Service].

===Statelessness===

Service logic should generally be written to be state-less. The same Service object, defined in services.yml, is initialized once and generally re-used for the life of an application instance (cached by ServiceList). So any state you store can end up persisting from request to request and session to session, which you probably don't intend. Umlaut architecture for background services also involves threads and forks, and while there's normally no reason a given service object would be in two threads simultaneously, better safe than sorry. It's safest to store no non-universal state in the service object.

===Disclosure methods===

A service adaptor must define [http://umlaut.rubyforge.org/api/classes/Service.html#service_types_generated service_types_generated()] to return an Array of ServiceTypeValues constituting the types of ServiceResponses the service

A service adaptor may optionally list some required configuration params. If they are not supplied, an exception will be thrown when the service is initialized from services.yml. eg:
: required_config_params :api_key, :base_url

===The handle method===

The heart of a typical service is in implementing the [http://umlaut.rubyforge.org/api/classes/Service.html#handle handle] method. When Umlaut wants a service to do it's thing, Umlaut will pass the request in, and it's up to the Service to do it's work.

The service can examine all metadata from the request, and even examine ServiceResponses generated by other services, and the status of other services in progress or finished. (See [http://umlaut.rubyforge.org/api/classes/Request.html Request#dispatched_services], Request#dispatched, Request#services_in_progress, etc.)

The service can then enhance any metadata if desired (likely data in [http://umlaut.rubyforge.org/api/classes/Referent.html Referent], from Request#referent).

The service can create one or more ServiceResponses. A ServiceResponse normally represents a discrete package of data that will be displayed on some part of the resolve menu. ServiceResponses should generally be created with the convenience method [http://umlaut.rubyforge.org/api/classes/Request.html Request]#add_service_response.

The add_service_response call has you specify the particular service class, the ServiceTypeValue, and arbitrary key value pairs as appropriate/conventional for the given time. For conventions on these key/value pairs, see [http://umlaut.rubyforge.org/api/classes/ServiceResponse.html ServiceResponse]. For example:

<pre>
request.add_service_response(:service=>self,
:service_type_value => :cover_image,
:display_text => 'Cover Image',
:key=>size,
:url => img.inner_html,
:asin => asin,
:size => size )
</pre>

The Service code is also responsible for registering a DispatchedService object with the completion state of the service. This should be done with the convenience method [http://umlaut.rubyforge.org/api/classes/Request.html Request]#dispatched . If the service throws an uncaught exception, Umlaut itself will register a DispatchedService with status FailedFatal. But otherwise, the service is responsible for registering a completion status, or Umlaut may not realize the service is complete and continue running it over and over again, or reporting it as timed out.

===callback methods===

The Service can play an interactive role with the view elements of Umlaut in determining how to display the ServiceResponse and how to generate an external url for it if the user clicks on it. A Service doesn't need to do this--it can simply include properties in generated ServiceResponses for the conventional keys mentioned in [http://umlaut.rubyforge.org/api/classes/ServiceResponse.html ServiceResponse], including a pre-generated url in the :url property.

However, for more complicated processing (including not generating urls until the point-of-need when a user actually clicks on one), callback methods can instead be implemented.

These callback methods include [http://umlaut.rubyforge.org/api/classes/Service.html]#view_data_from_service_type(service_type_obj) , #to_[name of service goes here] (eg #to_fulltext, or #to_help ), Service#response_to_view_data, and Service#response_url.

For more information, see the Technical Overview section on view logic. (tbd).

==Alternate Service Tasks==

Services were originally designed to do one thing, as described above. However, it has been useful to use the service architecture to perform other 'tasks' too, basically other sorts of plug-ins. What plug-in 'task' a service will be called upon to perform depends on the task config property in services.yml, which defaults to 'standard' when empty.

The other service task we have defined currently as 'link_out_filter'. A task:link_out_filter service will never have it's handle method called. Instead, it will have a [http://umlaut.rubyforge.org/api/classes/Service.html Service#]link_out_filter method defined, and called at the appropriate control point. Examples of link_out_filter services are ezproxy, and sfx_backchannel_record.

Umlaut wishlist

2009-02-05T17:05:58Z

128.220.205.186:

[[Category:Umlaut]]

Desired or planned features.

* Allow a service_response to have a tree relationship to children, so for instance alternate versions of a text can be attached as children of the main link, expandable by the user.

* http://export.arxiv.org/api_help/ !!!!

* PubMed Central full text lookup http://www.ncbi.nlm.nih.gov/entrez/query/static/esearch_help.html (SFX may already do this?)

* Journal ToC from CiteULike

* Parsing of formatted references from an entry screen. Use http://wing.comp.nus.edu.sg/parsCit/ package. Very interesting! Or a similar UCOP package: http://purl.net/net/egh/hmm-citation-extractor/ See list of such packages here under "Other Parsing Tools" http://freecite.library.brown.edu/

* LibraryThing open knowledge API for more data. http://www.librarything.com/blog/2008/08/free-web-services-api-to-common.php

* Connect to internet linked movie database on movies: http://www.linkedmdb.org/

* Add information about the conversation happening around an article with Scintilla if we have a URL, PMID or DOI (Alf at Scintilla would prefer us NOT to use the API for high-traffic. But we can copy his techniques internally to Umlaut. CrossRef and PubMed for "cited by" on DOI and PMID identifiers are a good idea. He has also reverse engineered the Scopus javascript api to allow server-side json access. http://hublog.hubmed.org/archives/001512.html):
http://hublog.hubmed.org/archives/001609.html
Unofficially it will return json:
http://scintilla.nature.com/conversations?uri=info%3Adoi%2F10.1371%2Fjournal.pmed.0020124&format=json

* Rochester “Getting Users Fulltext” style code to skip right to the full text, skipping content-provider metadata pages.

* UMich Mirlyn for metadata enrichment?
http://webservices.itcs.umich.edu/mediawiki/MLibraryAPI/index.php/Mirlynapi:Home

* xISBN/thingISBN use. (Some thought is required in how to integrate this while avoiding false positives). Bowker ISSN service for metadata enhancement. OCLC xISSN? Integrate preceding/succeeding title information from OPAC or xISSN?

* LibraryLookup: http://xisbn.worldcat.org/liblook/index.htm At least until xISBN is baked in we could provide a link to this service. Increases the chances of finding a desired book in the catalog through work set grouping. Used by LibX.
http://xisbn.worldcat.org/liblook/resolve.htm?res_id=http://www.iucat.iu.edu&rft.isbn=0451530942&url_ver=Z39.88-2004&rft_val_fmt=info:ofi/fmt:kev:mtx:book

* Journal covers from Ulrich's via screen-scraping (or Ulrich's/sersol built in api?)

* Connotea integration

* Fetch ToC from LC. Screen scrape, I guess? Or z3950? Any other content from LC?

* Link to Books In Print ala Notre Dame.
http://www.library.nd.edu/eresources/findit/findit.cgi?doc_num=001939269&aleph_session=U5AVHRXD5QB1CGDFDSVJ9DSY2UA6QNCGVEU8EYRX9NNMIQ429Q-54668%22
example

* bip search url? :
http://www.booksinprint.com/merge_shared/Search/advsearch.asp%3FdateState%3DY%26txtAction%3D%26BooleanSearch%3D%26SType%3Dadv%26collection%3DBIP%26QueryMode%3DSimple%26ResultCount%3D25%26ResultTemplate%3Dmbbookresult_fl.hts%26navPage%3D1%26SrchFrm%3DAdv%26ScoreThreshold%3D0%26Criteria1%3DISBN%26CriteriaText1%3D0838935370

* SFX plugin: Notice when first title given is non-roman, and look for roman title to enhance metadata with when so.

* HIP and other OPAC searchers should pull ToC from MARC 505 when present. And 856's judged to be ToC in ToC, not full text.

* Fix Umlaut Referent to more easily allow multiple authors. Architectural change neccessary to get a lot of this stuff working right.

* "Cited by" service. Scopus via screen scraping? (scopus javascript api? http://www.scopus.com/scsearchapi/ See also http://hublog.hubmed.org/archives/001512.html ) ISI Web of Science is too hard to even screen scrape the interface is such a mess, but Scopus looks do-able. Google scholar?

* Enhance metadata to have full metadata for a refworks etc export. Using: CrossRef? Metalib? Anything else?

* A general purpose responsecache. Schema: Date, service/source, key. Use for caching image urls, ToC urls from LC, etc.

* Fix Worldcat registry auto-discovery.

* Add a Worldcat search that uses API, instead of screen scrape.

* Switch OCA search to use OCA native APIs, instead of indexdata mirror index.

* fix unapi in umlaut. unapi to rsi? For zotero.

* Change background to use Spawn plugin instead of manual threading. Investigating using spawn with fork instead of thread (terry reese on limited pool of forks).

* Crazy idea for an abstract interface/architecture to support querying web service apis that require client side javascript, like Google Books and Scopus.

* Integrate my various local document delivery services into menu of options when full text isn’t available. More generally, a clear architecture for providing localized doc delivery services in addition to a single ILL link.

* SFX adaptor: Add a "rollup" feature that pays attention to dates to avoid eliminating coverage.

Umlaut wishlist

2009-02-05T17:03:46Z

128.220.205.186:

[[Category:Umlaut]]

Desired or planned features.

* Allow a service_response to have a tree relationship to children, so for instance alternate versions of a text can be attached as children of the main link, expandable by the user.

* http://export.arxiv.org/api_help/ !!!!

* PubMed Central full text lookup http://www.ncbi.nlm.nih.gov/entrez/query/static/esearch_help.html (SFX may already do this?)

* Journal ToC from CiteULike

* Parsing of formatted references from an entry screen. Use http://wing.comp.nus.edu.sg/parsCit/ package. Very interesting! Or a similar UCOP package: http://purl.net/net/egh/hmm-citation-extractor/ See list of such packages here under "Other Parsing Tools" http://freecite.library.brown.edu/

* LibraryThing open knowledge API for more data. http://www.librarything.com/blog/2008/08/free-web-services-api-to-common.php

* Connect to internet linked movie database on movies: http://www.linkedmdb.org/

* Add information about the conversation happening around an article with Scintilla if we have a URL, PMID or DOI (Alf at Scintilla would prefer us NOT to use the API for high-traffic. But we can copy his techniques internally to Umlaut. CrossRef and PubMed for "cited by" on DOI and PMID identifiers are a good idea. He has also reverse engineered the Scopus javascript api to allow server-side json access. http://hublog.hubmed.org/archives/001512.html):
http://hublog.hubmed.org/archives/001609.html
Unofficially it will return json:
http://scintilla.nature.com/conversations?uri=info%3Adoi%2F10.1371%2Fjournal.pmed.0020124&format=json

* Rochester “Getting Users Fulltext” style code to skip right to the full text, skipping content-provider metadata pages.

* UMich Mirlyn for metadata enrichment?
http://webservices.itcs.umich.edu/mediawiki/MLibraryAPI/index.php/Mirlynapi:Home

* xISBN/thingISBN use. (Some thought is required in how to integrate this while avoiding false positives). Bowker ISSN service for metadata enhancement. OCLC xISSN? Integrate preceding/succeeding title information from OPAC or xISSN?

* LibraryLookup: http://xisbn.worldcat.org/liblook/index.htm At least until xISBN is baked in we could provide a link to this service. Increases the chances of finding a desired book in the catalog through work set grouping. Used by LibX.
http://xisbn.worldcat.org/liblook/resolve.htm?res_id=http://www.iucat.iu.edu&rft.isbn=0451530942&url_ver=Z39.88-2004&rft_val_fmt=info:ofi/fmt:kev:mtx:book

* Journal covers from Ulrich's via screen-scraping (or Ulrich's/sersol built in api?)

* Connotea integration

* Fetch ToC from LC. Screen scrape, I guess? Or z3950? Any other content from LC?

* Link to Books In Print ala Notre Dame.
http://www.library.nd.edu/eresources/findit/findit.cgi?doc_num=001939269&aleph_session=U5AVHRXD5QB1CGDFDSVJ9DSY2UA6QNCGVEU8EYRX9NNMIQ429Q-54668%22
example

* bip search url? :
http://www.booksinprint.com/merge_shared/Search/advsearch.asp%3FdateState%3DY%26txtAction%3D%26BooleanSearch%3D%26SType%3Dadv%26collection%3DBIP%26QueryMode%3DSimple%26ResultCount%3D25%26ResultTemplate%3Dmbbookresult_fl.hts%26navPage%3D1%26SrchFrm%3DAdv%26ScoreThreshold%3D0%26Criteria1%3DISBN%26CriteriaText1%3D0838935370

* SFX plugin: Notice when first title given is non-roman, and look for roman title to enhance metadata with when so.

* HIP and other OPAC searchers should pull ToC from MARC 505 when present. And 856's judged to be ToC in ToC, not full text.

* Fix Umlaut Referent to more easily allow multiple authors. Architectural change neccessary to get a lot of this stuff working right.

* "Cited by" service. Scopus via screen scraping? (scopus javascript api? http://www.scopus.com/scsearchapi/ ) ISI Web of Science is too hard to even screen scrape the interface is such a mess, but Scopus looks do-able. Google scholar?

* Enhance metadata to have full metadata for a refworks etc export. Using: CrossRef? Metalib? Anything else?

* A general purpose responsecache. Schema: Date, service/source, key. Use for caching image urls, ToC urls from LC, etc.

* Fix Worldcat registry auto-discovery.

* Add a Worldcat search that uses API, instead of screen scrape.

* Switch OCA search to use OCA native APIs, instead of indexdata mirror index.

* fix unapi in umlaut. unapi to rsi? For zotero.

* Change background to use Spawn plugin instead of manual threading. Investigating using spawn with fork instead of thread (terry reese on limited pool of forks).

* Crazy idea for an abstract interface/architecture to support querying web service apis that require client side javascript, like Google Books and Scopus.

* Integrate my various local document delivery services into menu of options when full text isn’t available. More generally, a clear architecture for providing localized doc delivery services in addition to a single ILL link.

* SFX adaptor: Add a "rollup" feature that pays attention to dates to avoid eliminating coverage.

Code4Lib Journal Email Templates

2009-02-02T17:04:54Z

128.220.205.186:

''See also [[Code4Lib_Journal_Deadlines]]''

'''Submission Acknowledgement

Thanks for submitting a proposal to the Code4Lib Journal. We appreciate your participation in the code4lib community. The editors have received your proposal and should be in touch with you in 2-4 weeks regarding its appropriateness for publication in C4LJ. We will notify you if we need additional information to make this decision. Please feel free to contact us at c4lj-articles@googlegroups.com if you have additional questions.

'''Need More Information

Thank you for your interest in publishing in the Code4Lib Journal. The Journal is primarily focused on technological issues in libraries. In order to help the editors determine if your proposal is appropriate for this publication, could you share more details about the intended audience for the the article and how it will address issues surrounding technology in libraries? Please respond to c4lj-articles@googlegroups.com with the additional information requested.

You may also contact the editors at c4lj-articles@googlegroups.com if you have any additional questions. We look forward to hearing from you.

'''Proposal Accepted

Congratulations! Your recent proposal for an article about <insert topic/title> has been provisionally accepted to the Code4Lib Journal. As a member of the Code4Lib Journal editorial committee, I will be your contact for your proposed Code4Lib Journal article, and will work with you to get the article ready for publication.

We would like to publish your article in issue <#> of the Journal, which is scheduled to be published on <insert date here>. The deadline for submission of a complete draft of the article is <deadline for draft>, but the sooner you can get us a draft the better, the more likely we'll be able to get your article into that issue. To see what we're looking for, you should consult our author guidelines at: http://journal.code4lib.org/article-guidelines. Once you have submitted a complete draft for publication, we may work with you on additional requested edits before the Editorial Committee will vote again to finalize its publication.

As a final note, we require all authors to agree to CC-BY licensing for the articles we publish in the journal. We recommend that any included code also have some type of code-specific open source license (such as the GPL).

<insert any additional comments about focus we'd like to see in the article or editorial committee concerns>

We are excited about your article, and look forward to seeing a complete draft and including it in the Journal. Thanks for submitting to us, and feel free to contact me directly with any questions.

'''Proposal Rejected

We regret to inform you that your recent proposal to the Code4Lib Journal for an article about <insert topic/title> has not been accepted for publication. This is likely because the Editorial Committee determined that it was not an appropriate match for the audience, mission, or scope of the Code4Lib Journal. [optional - insert comment here about why it's not appropriate]

For more information about the mission of the Code4Lib Journal, please see http://journal.code4lib.org/mission/.

Thanks for considering us, and please do not hesitate to contact the editors at c4lj-articles@googlegroups.com in the future with a new or revised proposal.

[[Category: Code4Lib Journal]]

Umlaut Installation

2008-12-23T18:18:52Z

128.220.205.186: /* 1. Make sure you have a modern Ruby */

[[Category:Umlaut]]

To install Umlaut

== 1. Make sure you have a modern Ruby ==

Install a 1.8.x version of ruby, ruby 1.9 is still considered experimental. The Rails web page says "We recommend Ruby 1.8.7 for use with Rails. Ruby 1.8.6, 1.8.5, 1.8.4 and 1.8.2 are still usable too, but version 1.8.3 is not." (http://rubyonrails.org/download) Try installing Ruby with your package manager of choice. If not, try installing from source, eg

# [Download 1.8.4>http://rubyforge.org/frs/download.php/7858/ruby-1.8.7.tar.gz]
# tar -zxvf ruby-1.8.7.tar.gz
# cd ruby-1.8.7
# sudo ./configure
# sudo make
# sudo make install

( jrochkind is currently running ruby 1.8.6 as of Dec 08 )

== 2. Install RubyGems ==

Again, your package manager may be able to supply this (for example "yum install rubygems), but if not, you could again install from source:

# [Download here>http://rubyforge.org/frs/?group_id=126]
# tar -zxvf rubygems-x.x.x.tar.gz
# cd rubygems-x.x.x
# sudo ruby setup.rb
( actually don't do this, to be safe # sudo gem update)

[NOTE: Right now, umlaut may only work with rubygems 0.9. Working on it!]

== 3. Install Rails ==

Umlaut requires Rails 2.1.2, and is bound to it in the default environment.rb. It has not been verified for Rails 2.2.x yet. So install the 2.1.2 version of Rails (you can have multiple versions of Rails installed simulataneously, don't worry about this overwriting a more recent version of Rails you may want--it won't.)

"sudo gem install rails -v 2.1.2" (say yes to any dependencies)

'''Note''': There are various guides available on the net to getting Ruby/Rubygems/Rails installed on various OSs. Consult if you have trouble.

== 4. Install Umlaut ==

Right now, the best (only) way to install Umlaut is from it's SVN store.

For a read-only checkout:

<pre>
svn checkout http://umlaut.rubyforge.org/svn/trunk/ ./Umlaut
</pre>

Or instead of "./Umlaut", whatever local path you want to put the thing in.

For a checkout with commit privs, you need a rubyforge account and to be added to the umlaut project, then:

<pre>
svn checkout svn+ssh://(developername)@rubyforge.org/var/svn/umlaut/U2 ./Umlaut
</pre>

Umlaut comes with a number of Ruby gems and Rails plugins "frozen" into it's distribution, in vendor/plugins. You do not need to install these, they come with Umlaut. These include: json_pure ; sru; xisbn; enumerations_mixin (plugin) ; app_config (plugin); isbn-tools (plugin) ; openurl ( svn external link in plugin; needs to be fixed to link to a specific tag ); htmlentities (http://htmlentities.rubyforge.org/)

However, there are a few plugins that can not be conveniently packaged with Umlaut, you need to install them yourself...

== 5. Install Umlaut's gem dependencies ==

=== mongrel ===

(Umlaut will not run with WEBrick due to threading issues. Recommend installing mongrel for testing and deployment. mongrel 1.1.4 or later is highly reccommended. )

sudo gem install mongrel

=== hpricot ===

(hpricot is compiled C code, so you are best off installing it yourself. Right now hpricot 0.6 is tested and confirmed. )

sudo gem install hpricot -v 0.6

=== json ===

A pure-ruby json library is bundled with Umlaut automatically, but you really ought to install the compiled C one on your server instead, for much better performance. Umlaut will automatically use it if present. Currently verified with version 1.1.3

sudo gem install json -v 1.1.3

=== mysql ===

MySQL is the reccomended db, and the only db currently verified to work. Umlaut won't usually run with SQLite3 due to threading issues.

Rails is supposed to be able to talk to mysql without the mysql gem installed (just less efficiently), but for some reason Umlaut seems to have trouble with this. Not sure, you can try it.

sudo gem install msyql

Except some additional configuration arguments may be neccesary to compile on your machine.

===== redhat =====

On a RedHat machine, this works:

sudo gem install mysql -- --with-mysql-config=/usr/lib/mysql/mysql_config

===== ubuntu =====

On Ubuntu you will also need to:

sudo apt-get install libmysqlclient15-dev

Then you can:

sudo gem install mysql

Ubuntu also packages the mysql library, if you'd rather use that version you can try:

sudo apt-get install libmysql-ruby

===== Solaris 10 (sparc) =====

This has been reported to work on Solaris 10 (sparc)

gem install mysql -- --with-mysql-include=/opt/pkgs/mysql/include/
\ --with-mysql-lib=/opt/pkgs/mysql/lib

=== More optional gems ===

* Voyager sites that want to bypass z39.50 and access Oracle directly will need Oracle Instant Client or Full Client installed on the same machine as the Umlaut. (This native Voyager code is not currently verified as working.) [http://www.jiubao.org/ruby-oci8 Oracle OCI8] [http://www.oracle.com/technology/tech/oci/instantclient/index.html Oracle Instant Client]

== Now You Need to Setup Umlaut ==

Good job, you've got all software installed, now you need to do some setup. See [[Umlaut Setup]].

Umlaut Installation

2008-12-03T20:28:50Z

128.220.205.186: /* Solaris 10 (sparc) */

[[Category:Umlaut]]

To install Umlaut

== 1. Make sure you have a modern Ruby ==

Rails recommends Ruby 1.8.4 (and requires at least 1.8.2, but 1.8.3 is incompatible). Some Red Hat versions may come with only 1.8.1. Try installing Ruby with your package manager of choice, and see if you can get 1.8.4. If not, try installing from source:

# [Download 1.8.4>http://rubyforge.org/frs/download.php/7858/ruby-1.8.4.tar.gz]
# tar -zxvf ruby-1.8.4.tar.gz
# cd ruby-1.8.4
# sudo ./configure
# sudo make
# sudo make install

== 2. Install RubyGems ==

Again, your package manager may be able to supply this (for example "yum install rubygems), but if not, you could again install from source:

# [Download here>http://rubyforge.org/frs/?group_id=126]
# tar -zxvf rubygems-x.x.x.tar.gz
# cd rubygems-x.x.x
# sudo ruby setup.rb
( actually don't do this, to be safe # sudo gem update)

[NOTE: Right now, umlaut may only work with rubygems 0.9. Working on it!]

== 3. Install Rails ==

Umlaut requires Rails 2.1.2, and is bound to it in the default environment.rb. It has not been verified for Rails 2.2.x yet. So install the 2.1.2 version of Rails (you can have multiple versions of Rails installed simulataneously, don't worry about this overwriting a more recent version of Rails you may want--it won't.)

"sudo gem install rails -v 2.1.2" (say yes to any dependencies)

'''Note''': There are various guides available on the net to getting Ruby/Rubygems/Rails installed on various OSs. Consult if you have trouble.

== 4. Install Umlaut ==

Right now, the best (only) way to install Umlaut is from it's SVN store.

For a read-only checkout:

<pre>
svn checkout http://umlaut.rubyforge.org/svn/trunk/ ./Umlaut
</pre>

Or instead of "./Umlaut", whatever local path you want to put the thing in.

For a checkout with commit privs, you need a rubyforge account and to be added to the umlaut project, then:

<pre>
svn checkout svn+ssh://(developername)@rubyforge.org/var/svn/umlaut/U2 ./Umlaut
</pre>

Umlaut comes with a number of Ruby gems and Rails plugins "frozen" into it's distribution, in vendor/plugins. You do not need to install these, they come with Umlaut. These include: json_pure ; sru; xisbn; enumerations_mixin (plugin) ; app_config (plugin); isbn-tools (plugin) ; openurl ( svn external link in plugin; needs to be fixed to link to a specific tag ); htmlentities (http://htmlentities.rubyforge.org/)

However, there are a few plugins that can not be conveniently packaged with Umlaut, you need to install them yourself...

== 5. Install Umlaut's gem dependencies ==

=== mongrel ===

(Umlaut will not run with WEBrick due to threading issues. Recommend installing mongrel for testing and deployment. mongrel 1.1.4 or later is highly reccommended. )

sudo gem install mongrel

=== hpricot ===

(hpricot is compiled C code, so you are best off installing it yourself. Right now hpricot 0.6 is tested and confirmed. )

sudo gem install hpricot -v 0.6

=== json ===

A pure-ruby json library is bundled with Umlaut automatically, but you really ought to install the compiled C one on your server instead, for much better performance. Umlaut will automatically use it if present. Currently verified with version 1.1.3

sudo gem install json -v 1.1.3

=== mysql ===

MySQL is the reccomended db, and the only db currently verified to work. Umlaut won't usually run with SQLite3 due to threading issues.

Rails is supposed to be able to talk to mysql without the mysql gem installed (just less efficiently), but for some reason Umlaut seems to have trouble with this. Not sure, you can try it.

sudo gem install msyql

Except some additional configuration arguments may be neccesary to compile on your machine.

===== redhat =====

On a RedHat machine, this works:

sudo gem install mysql -- --with-mysql-config=/usr/lib/mysql/mysql_config

===== ubuntu =====

On Ubuntu you will also need to:

sudo apt-get install libmysqlclient15-dev

Then you can:

sudo gem install mysql

Ubuntu also packages the mysql library, if you'd rather use that version you can try:

sudo apt-get install libmysql-ruby

===== Solaris 10 (sparc) =====

This has been reported to work on Solaris 10 (sparc)

gem install mysql -- --with-mysql-include=/opt/pkgs/mysql/include/
\ --with-mysql-lib=/opt/pkgs/mysql/lib

=== More optional gems ===

* Voyager sites that want to bypass z39.50 and access Oracle directly will need Oracle Instant Client or Full Client installed on the same machine as the Umlaut. (This native Voyager code is not currently verified as working.) [http://www.jiubao.org/ruby-oci8 Oracle OCI8] [http://www.oracle.com/technology/tech/oci/instantclient/index.html Oracle Instant Client]

== Now You Need to Setup Umlaut ==

Good job, you've got all software installed, now you need to do some setup. See [[Umlaut Setup]].

Umlaut Installation

2008-12-03T20:28:32Z

128.220.205.186: /* Solaris 10 (sparc) */

[[Category:Umlaut]]

To install Umlaut

== 1. Make sure you have a modern Ruby ==

Rails recommends Ruby 1.8.4 (and requires at least 1.8.2, but 1.8.3 is incompatible). Some Red Hat versions may come with only 1.8.1. Try installing Ruby with your package manager of choice, and see if you can get 1.8.4. If not, try installing from source:

# [Download 1.8.4>http://rubyforge.org/frs/download.php/7858/ruby-1.8.4.tar.gz]
# tar -zxvf ruby-1.8.4.tar.gz
# cd ruby-1.8.4
# sudo ./configure
# sudo make
# sudo make install

== 2. Install RubyGems ==

Again, your package manager may be able to supply this (for example "yum install rubygems), but if not, you could again install from source:

# [Download here>http://rubyforge.org/frs/?group_id=126]
# tar -zxvf rubygems-x.x.x.tar.gz
# cd rubygems-x.x.x
# sudo ruby setup.rb
( actually don't do this, to be safe # sudo gem update)

[NOTE: Right now, umlaut may only work with rubygems 0.9. Working on it!]

== 3. Install Rails ==

Umlaut requires Rails 2.1.2, and is bound to it in the default environment.rb. It has not been verified for Rails 2.2.x yet. So install the 2.1.2 version of Rails (you can have multiple versions of Rails installed simulataneously, don't worry about this overwriting a more recent version of Rails you may want--it won't.)

"sudo gem install rails -v 2.1.2" (say yes to any dependencies)

'''Note''': There are various guides available on the net to getting Ruby/Rubygems/Rails installed on various OSs. Consult if you have trouble.

== 4. Install Umlaut ==

Right now, the best (only) way to install Umlaut is from it's SVN store.

For a read-only checkout:

<pre>
svn checkout http://umlaut.rubyforge.org/svn/trunk/ ./Umlaut
</pre>

Or instead of "./Umlaut", whatever local path you want to put the thing in.

For a checkout with commit privs, you need a rubyforge account and to be added to the umlaut project, then:

<pre>
svn checkout svn+ssh://(developername)@rubyforge.org/var/svn/umlaut/U2 ./Umlaut
</pre>

Umlaut comes with a number of Ruby gems and Rails plugins "frozen" into it's distribution, in vendor/plugins. You do not need to install these, they come with Umlaut. These include: json_pure ; sru; xisbn; enumerations_mixin (plugin) ; app_config (plugin); isbn-tools (plugin) ; openurl ( svn external link in plugin; needs to be fixed to link to a specific tag ); htmlentities (http://htmlentities.rubyforge.org/)

However, there are a few plugins that can not be conveniently packaged with Umlaut, you need to install them yourself...

== 5. Install Umlaut's gem dependencies ==

=== mongrel ===

(Umlaut will not run with WEBrick due to threading issues. Recommend installing mongrel for testing and deployment. mongrel 1.1.4 or later is highly reccommended. )

sudo gem install mongrel

=== hpricot ===

(hpricot is compiled C code, so you are best off installing it yourself. Right now hpricot 0.6 is tested and confirmed. )

sudo gem install hpricot -v 0.6

=== json ===

A pure-ruby json library is bundled with Umlaut automatically, but you really ought to install the compiled C one on your server instead, for much better performance. Umlaut will automatically use it if present. Currently verified with version 1.1.3

sudo gem install json -v 1.1.3

=== mysql ===

MySQL is the reccomended db, and the only db currently verified to work. Umlaut won't usually run with SQLite3 due to threading issues.

Rails is supposed to be able to talk to mysql without the mysql gem installed (just less efficiently), but for some reason Umlaut seems to have trouble with this. Not sure, you can try it.

sudo gem install msyql

Except some additional configuration arguments may be neccesary to compile on your machine.

===== redhat =====

On a RedHat machine, this works:

sudo gem install mysql -- --with-mysql-config=/usr/lib/mysql/mysql_config

===== ubuntu =====

On Ubuntu you will also need to:

sudo apt-get install libmysqlclient15-dev

Then you can:

sudo gem install mysql

Ubuntu also packages the mysql library, if you'd rather use that version you can try:

sudo apt-get install libmysql-ruby

===== Solaris 10 (sparc) =====

This has been reported to work on Solaris 10 (sparc)

gem install mysql -- --with-mysql-include=/opt/pkgs/mysql/include/ --with-mysql-lib=/opt/pkgs/mysql/lib

=== More optional gems ===

* Voyager sites that want to bypass z39.50 and access Oracle directly will need Oracle Instant Client or Full Client installed on the same machine as the Umlaut. (This native Voyager code is not currently verified as working.) [http://www.jiubao.org/ruby-oci8 Oracle OCI8] [http://www.oracle.com/technology/tech/oci/instantclient/index.html Oracle Instant Client]

== Now You Need to Setup Umlaut ==

Good job, you've got all software installed, now you need to do some setup. See [[Umlaut Setup]].

Umlaut Installation

2008-12-03T20:28:12Z

128.220.205.186: /* ubuntu */

[[Category:Umlaut]]

To install Umlaut

== 1. Make sure you have a modern Ruby ==

Rails recommends Ruby 1.8.4 (and requires at least 1.8.2, but 1.8.3 is incompatible). Some Red Hat versions may come with only 1.8.1. Try installing Ruby with your package manager of choice, and see if you can get 1.8.4. If not, try installing from source:

# [Download 1.8.4>http://rubyforge.org/frs/download.php/7858/ruby-1.8.4.tar.gz]
# tar -zxvf ruby-1.8.4.tar.gz
# cd ruby-1.8.4
# sudo ./configure
# sudo make
# sudo make install

== 2. Install RubyGems ==

Again, your package manager may be able to supply this (for example "yum install rubygems), but if not, you could again install from source:

# [Download here>http://rubyforge.org/frs/?group_id=126]
# tar -zxvf rubygems-x.x.x.tar.gz
# cd rubygems-x.x.x
# sudo ruby setup.rb
( actually don't do this, to be safe # sudo gem update)

[NOTE: Right now, umlaut may only work with rubygems 0.9. Working on it!]

== 3. Install Rails ==

Umlaut requires Rails 2.1.2, and is bound to it in the default environment.rb. It has not been verified for Rails 2.2.x yet. So install the 2.1.2 version of Rails (you can have multiple versions of Rails installed simulataneously, don't worry about this overwriting a more recent version of Rails you may want--it won't.)

"sudo gem install rails -v 2.1.2" (say yes to any dependencies)

'''Note''': There are various guides available on the net to getting Ruby/Rubygems/Rails installed on various OSs. Consult if you have trouble.

== 4. Install Umlaut ==

Right now, the best (only) way to install Umlaut is from it's SVN store.

For a read-only checkout:

<pre>
svn checkout http://umlaut.rubyforge.org/svn/trunk/ ./Umlaut
</pre>

Or instead of "./Umlaut", whatever local path you want to put the thing in.

For a checkout with commit privs, you need a rubyforge account and to be added to the umlaut project, then:

<pre>
svn checkout svn+ssh://(developername)@rubyforge.org/var/svn/umlaut/U2 ./Umlaut
</pre>

Umlaut comes with a number of Ruby gems and Rails plugins "frozen" into it's distribution, in vendor/plugins. You do not need to install these, they come with Umlaut. These include: json_pure ; sru; xisbn; enumerations_mixin (plugin) ; app_config (plugin); isbn-tools (plugin) ; openurl ( svn external link in plugin; needs to be fixed to link to a specific tag ); htmlentities (http://htmlentities.rubyforge.org/)

However, there are a few plugins that can not be conveniently packaged with Umlaut, you need to install them yourself...

== 5. Install Umlaut's gem dependencies ==

=== mongrel ===

(Umlaut will not run with WEBrick due to threading issues. Recommend installing mongrel for testing and deployment. mongrel 1.1.4 or later is highly reccommended. )

sudo gem install mongrel

=== hpricot ===

(hpricot is compiled C code, so you are best off installing it yourself. Right now hpricot 0.6 is tested and confirmed. )

sudo gem install hpricot -v 0.6

=== json ===

A pure-ruby json library is bundled with Umlaut automatically, but you really ought to install the compiled C one on your server instead, for much better performance. Umlaut will automatically use it if present. Currently verified with version 1.1.3

sudo gem install json -v 1.1.3

=== mysql ===

MySQL is the reccomended db, and the only db currently verified to work. Umlaut won't usually run with SQLite3 due to threading issues.

Rails is supposed to be able to talk to mysql without the mysql gem installed (just less efficiently), but for some reason Umlaut seems to have trouble with this. Not sure, you can try it.

sudo gem install msyql

Except some additional configuration arguments may be neccesary to compile on your machine.

===== redhat =====

On a RedHat machine, this works:

sudo gem install mysql -- --with-mysql-config=/usr/lib/mysql/mysql_config

===== ubuntu =====

On Ubuntu you will also need to:

sudo apt-get install libmysqlclient15-dev

Then you can:

sudo gem install mysql

Ubuntu also packages the mysql library, if you'd rather use that version you can try:

sudo apt-get install libmysql-ruby

===== Solaris 10 (sparc) =====

This has been reported to work on Solaris 10 (sparc)

gem install mysql -- --with-mysql-include=/opt/pkgs/mysql/include/
--with-mysql-lib=/opt/pkgs/mysql/lib

=== More optional gems ===

* Voyager sites that want to bypass z39.50 and access Oracle directly will need Oracle Instant Client or Full Client installed on the same machine as the Umlaut. (This native Voyager code is not currently verified as working.) [http://www.jiubao.org/ruby-oci8 Oracle OCI8] [http://www.oracle.com/technology/tech/oci/instantclient/index.html Oracle Instant Client]

== Now You Need to Setup Umlaut ==

Good job, you've got all software installed, now you need to do some setup. See [[Umlaut Setup]].

Umlaut Installation

2008-12-03T20:28:02Z

128.220.205.186: /* redhat */

[[Category:Umlaut]]

To install Umlaut

== 1. Make sure you have a modern Ruby ==

Rails recommends Ruby 1.8.4 (and requires at least 1.8.2, but 1.8.3 is incompatible). Some Red Hat versions may come with only 1.8.1. Try installing Ruby with your package manager of choice, and see if you can get 1.8.4. If not, try installing from source:

# [Download 1.8.4>http://rubyforge.org/frs/download.php/7858/ruby-1.8.4.tar.gz]
# tar -zxvf ruby-1.8.4.tar.gz
# cd ruby-1.8.4
# sudo ./configure
# sudo make
# sudo make install

== 2. Install RubyGems ==

Again, your package manager may be able to supply this (for example "yum install rubygems), but if not, you could again install from source:

# [Download here>http://rubyforge.org/frs/?group_id=126]
# tar -zxvf rubygems-x.x.x.tar.gz
# cd rubygems-x.x.x
# sudo ruby setup.rb
( actually don't do this, to be safe # sudo gem update)

[NOTE: Right now, umlaut may only work with rubygems 0.9. Working on it!]

== 3. Install Rails ==

Umlaut requires Rails 2.1.2, and is bound to it in the default environment.rb. It has not been verified for Rails 2.2.x yet. So install the 2.1.2 version of Rails (you can have multiple versions of Rails installed simulataneously, don't worry about this overwriting a more recent version of Rails you may want--it won't.)

"sudo gem install rails -v 2.1.2" (say yes to any dependencies)

'''Note''': There are various guides available on the net to getting Ruby/Rubygems/Rails installed on various OSs. Consult if you have trouble.

== 4. Install Umlaut ==

Right now, the best (only) way to install Umlaut is from it's SVN store.

For a read-only checkout:

<pre>
svn checkout http://umlaut.rubyforge.org/svn/trunk/ ./Umlaut
</pre>

Or instead of "./Umlaut", whatever local path you want to put the thing in.

For a checkout with commit privs, you need a rubyforge account and to be added to the umlaut project, then:

<pre>
svn checkout svn+ssh://(developername)@rubyforge.org/var/svn/umlaut/U2 ./Umlaut
</pre>

Umlaut comes with a number of Ruby gems and Rails plugins "frozen" into it's distribution, in vendor/plugins. You do not need to install these, they come with Umlaut. These include: json_pure ; sru; xisbn; enumerations_mixin (plugin) ; app_config (plugin); isbn-tools (plugin) ; openurl ( svn external link in plugin; needs to be fixed to link to a specific tag ); htmlentities (http://htmlentities.rubyforge.org/)

However, there are a few plugins that can not be conveniently packaged with Umlaut, you need to install them yourself...

== 5. Install Umlaut's gem dependencies ==

=== mongrel ===

(Umlaut will not run with WEBrick due to threading issues. Recommend installing mongrel for testing and deployment. mongrel 1.1.4 or later is highly reccommended. )

sudo gem install mongrel

=== hpricot ===

(hpricot is compiled C code, so you are best off installing it yourself. Right now hpricot 0.6 is tested and confirmed. )

sudo gem install hpricot -v 0.6

=== json ===

A pure-ruby json library is bundled with Umlaut automatically, but you really ought to install the compiled C one on your server instead, for much better performance. Umlaut will automatically use it if present. Currently verified with version 1.1.3

sudo gem install json -v 1.1.3

=== mysql ===

MySQL is the reccomended db, and the only db currently verified to work. Umlaut won't usually run with SQLite3 due to threading issues.

Rails is supposed to be able to talk to mysql without the mysql gem installed (just less efficiently), but for some reason Umlaut seems to have trouble with this. Not sure, you can try it.

sudo gem install msyql

Except some additional configuration arguments may be neccesary to compile on your machine.

===== redhat =====

On a RedHat machine, this works:

sudo gem install mysql -- --with-mysql-config=/usr/lib/mysql/mysql_config

===== ubuntu =====

On Ubuntu you will also need to:

sudo apt-get install libmysqlclient15-dev

Then you can:

sudo gem install mysql

Ubuntu also packages the mysql library, if you'd rather use that version you can try:

sudo apt-get install libmysql-ruby

===== Solaris 10 (sparc) =====

This has been reported to work on Solaris 10 (sparc)

gem install mysql -- --with-mysql-include=/opt/pkgs/mysql/include/
--with-mysql-lib=/opt/pkgs/mysql/lib

=== More optional gems ===

* Voyager sites that want to bypass z39.50 and access Oracle directly will need Oracle Instant Client or Full Client installed on the same machine as the Umlaut. (This native Voyager code is not currently verified as working.) [http://www.jiubao.org/ruby-oci8 Oracle OCI8] [http://www.oracle.com/technology/tech/oci/instantclient/index.html Oracle Instant Client]

== Now You Need to Setup Umlaut ==

Good job, you've got all software installed, now you need to do some setup. See [[Umlaut Setup]].

Umlaut Installation

2008-12-03T20:27:52Z

128.220.205.186: /* Solaris 10 (sparc) */

[[Category:Umlaut]]

To install Umlaut

== 1. Make sure you have a modern Ruby ==

Rails recommends Ruby 1.8.4 (and requires at least 1.8.2, but 1.8.3 is incompatible). Some Red Hat versions may come with only 1.8.1. Try installing Ruby with your package manager of choice, and see if you can get 1.8.4. If not, try installing from source:

# [Download 1.8.4>http://rubyforge.org/frs/download.php/7858/ruby-1.8.4.tar.gz]
# tar -zxvf ruby-1.8.4.tar.gz
# cd ruby-1.8.4
# sudo ./configure
# sudo make
# sudo make install

== 2. Install RubyGems ==

Again, your package manager may be able to supply this (for example "yum install rubygems), but if not, you could again install from source:

# [Download here>http://rubyforge.org/frs/?group_id=126]
# tar -zxvf rubygems-x.x.x.tar.gz
# cd rubygems-x.x.x
# sudo ruby setup.rb
( actually don't do this, to be safe # sudo gem update)

[NOTE: Right now, umlaut may only work with rubygems 0.9. Working on it!]

== 3. Install Rails ==

Umlaut requires Rails 2.1.2, and is bound to it in the default environment.rb. It has not been verified for Rails 2.2.x yet. So install the 2.1.2 version of Rails (you can have multiple versions of Rails installed simulataneously, don't worry about this overwriting a more recent version of Rails you may want--it won't.)

"sudo gem install rails -v 2.1.2" (say yes to any dependencies)

'''Note''': There are various guides available on the net to getting Ruby/Rubygems/Rails installed on various OSs. Consult if you have trouble.

== 4. Install Umlaut ==

Right now, the best (only) way to install Umlaut is from it's SVN store.

For a read-only checkout:

<pre>
svn checkout http://umlaut.rubyforge.org/svn/trunk/ ./Umlaut
</pre>

Or instead of "./Umlaut", whatever local path you want to put the thing in.

For a checkout with commit privs, you need a rubyforge account and to be added to the umlaut project, then:

<pre>
svn checkout svn+ssh://(developername)@rubyforge.org/var/svn/umlaut/U2 ./Umlaut
</pre>

Umlaut comes with a number of Ruby gems and Rails plugins "frozen" into it's distribution, in vendor/plugins. You do not need to install these, they come with Umlaut. These include: json_pure ; sru; xisbn; enumerations_mixin (plugin) ; app_config (plugin); isbn-tools (plugin) ; openurl ( svn external link in plugin; needs to be fixed to link to a specific tag ); htmlentities (http://htmlentities.rubyforge.org/)

However, there are a few plugins that can not be conveniently packaged with Umlaut, you need to install them yourself...

== 5. Install Umlaut's gem dependencies ==

=== mongrel ===

(Umlaut will not run with WEBrick due to threading issues. Recommend installing mongrel for testing and deployment. mongrel 1.1.4 or later is highly reccommended. )

sudo gem install mongrel

=== hpricot ===

(hpricot is compiled C code, so you are best off installing it yourself. Right now hpricot 0.6 is tested and confirmed. )

sudo gem install hpricot -v 0.6

=== json ===

A pure-ruby json library is bundled with Umlaut automatically, but you really ought to install the compiled C one on your server instead, for much better performance. Umlaut will automatically use it if present. Currently verified with version 1.1.3

sudo gem install json -v 1.1.3

=== mysql ===

MySQL is the reccomended db, and the only db currently verified to work. Umlaut won't usually run with SQLite3 due to threading issues.

Rails is supposed to be able to talk to mysql without the mysql gem installed (just less efficiently), but for some reason Umlaut seems to have trouble with this. Not sure, you can try it.

sudo gem install msyql

Except some additional configuration arguments may be neccesary to compile on your machine.

===== redhat =====

On a RedHat machine, this works:

sudo gem install mysql -- --with-mysql-config=/usr/lib/mysql/mysql_config

===== ubuntu =====

On Ubuntu you will also need to:

sudo apt-get install libmysqlclient15-dev

Then you can:

sudo gem install mysql

Ubuntu also packages the mysql library, if you'd rather use that version you can try:

sudo apt-get install libmysql-ruby

===== Solaris 10 (sparc) =====

This has been reported to work on Solaris 10 (sparc)

gem install mysql -- --with-mysql-include=/opt/pkgs/mysql/include/
--with-mysql-lib=/opt/pkgs/mysql/lib

=== More optional gems ===

* Voyager sites that want to bypass z39.50 and access Oracle directly will need Oracle Instant Client or Full Client installed on the same machine as the Umlaut. (This native Voyager code is not currently verified as working.) [http://www.jiubao.org/ruby-oci8 Oracle OCI8] [http://www.oracle.com/technology/tech/oci/instantclient/index.html Oracle Instant Client]

== Now You Need to Setup Umlaut ==

Good job, you've got all software installed, now you need to do some setup. See [[Umlaut Setup]].

Umlaut Installation

2008-12-03T20:26:11Z

128.220.205.186: /* mysql */

[[Category:Umlaut]]

To install Umlaut

== 1. Make sure you have a modern Ruby ==

Rails recommends Ruby 1.8.4 (and requires at least 1.8.2, but 1.8.3 is incompatible). Some Red Hat versions may come with only 1.8.1. Try installing Ruby with your package manager of choice, and see if you can get 1.8.4. If not, try installing from source:

# [Download 1.8.4>http://rubyforge.org/frs/download.php/7858/ruby-1.8.4.tar.gz]
# tar -zxvf ruby-1.8.4.tar.gz
# cd ruby-1.8.4
# sudo ./configure
# sudo make
# sudo make install

== 2. Install RubyGems ==

Again, your package manager may be able to supply this (for example "yum install rubygems), but if not, you could again install from source:

# [Download here>http://rubyforge.org/frs/?group_id=126]
# tar -zxvf rubygems-x.x.x.tar.gz
# cd rubygems-x.x.x
# sudo ruby setup.rb
( actually don't do this, to be safe # sudo gem update)

[NOTE: Right now, umlaut may only work with rubygems 0.9. Working on it!]

== 3. Install Rails ==

Umlaut requires Rails 2.1.2, and is bound to it in the default environment.rb. It has not been verified for Rails 2.2.x yet. So install the 2.1.2 version of Rails (you can have multiple versions of Rails installed simulataneously, don't worry about this overwriting a more recent version of Rails you may want--it won't.)

"sudo gem install rails -v 2.1.2" (say yes to any dependencies)

'''Note''': There are various guides available on the net to getting Ruby/Rubygems/Rails installed on various OSs. Consult if you have trouble.

== 4. Install Umlaut ==

Right now, the best (only) way to install Umlaut is from it's SVN store.

For a read-only checkout:

<pre>
svn checkout http://umlaut.rubyforge.org/svn/trunk/ ./Umlaut
</pre>

Or instead of "./Umlaut", whatever local path you want to put the thing in.

For a checkout with commit privs, you need a rubyforge account and to be added to the umlaut project, then:

<pre>
svn checkout svn+ssh://(developername)@rubyforge.org/var/svn/umlaut/U2 ./Umlaut
</pre>

Umlaut comes with a number of Ruby gems and Rails plugins "frozen" into it's distribution, in vendor/plugins. You do not need to install these, they come with Umlaut. These include: json_pure ; sru; xisbn; enumerations_mixin (plugin) ; app_config (plugin); isbn-tools (plugin) ; openurl ( svn external link in plugin; needs to be fixed to link to a specific tag ); htmlentities (http://htmlentities.rubyforge.org/)

However, there are a few plugins that can not be conveniently packaged with Umlaut, you need to install them yourself...

== 5. Install Umlaut's gem dependencies ==

=== mongrel ===

(Umlaut will not run with WEBrick due to threading issues. Recommend installing mongrel for testing and deployment. mongrel 1.1.4 or later is highly reccommended. )

sudo gem install mongrel

=== hpricot ===

(hpricot is compiled C code, so you are best off installing it yourself. Right now hpricot 0.6 is tested and confirmed. )

sudo gem install hpricot -v 0.6

=== json ===

A pure-ruby json library is bundled with Umlaut automatically, but you really ought to install the compiled C one on your server instead, for much better performance. Umlaut will automatically use it if present. Currently verified with version 1.1.3

sudo gem install json -v 1.1.3

=== mysql ===

MySQL is the reccomended db, and the only db currently verified to work. Umlaut won't usually run with SQLite3 due to threading issues.

Rails is supposed to be able to talk to mysql without the mysql gem installed (just less efficiently), but for some reason Umlaut seems to have trouble with this. Not sure, you can try it.

sudo gem install msyql

Except some additional configuration arguments may be neccesary to compile on your machine.

===== redhat =====

On a RedHat machine, this works:

sudo gem install mysql -- --with-mysql-config=/usr/lib/mysql/mysql_config

===== ubuntu =====

On Ubuntu you will also need to:

sudo apt-get install libmysqlclient15-dev

Then you can:

sudo gem install mysql

Ubuntu also packages the mysql library, if you'd rather use that version you can try:

sudo apt-get install libmysql-ruby

===== Solaris 10 (sparc) =====

This has been reported to work on Solaris 10 (sparc)

gem install mysql -- --with-mysql-include=/opt/pkgs/mysql/include/
with-mysql-lib=/opt/pkgs/mysql/lib

=== More optional gems ===

* Voyager sites that want to bypass z39.50 and access Oracle directly will need Oracle Instant Client or Full Client installed on the same machine as the Umlaut. (This native Voyager code is not currently verified as working.) [http://www.jiubao.org/ruby-oci8 Oracle OCI8] [http://www.oracle.com/technology/tech/oci/instantclient/index.html Oracle Instant Client]

== Now You Need to Setup Umlaut ==

Good job, you've got all software installed, now you need to do some setup. See [[Umlaut Setup]].

Umlaut Installation

2008-12-03T20:25:50Z

128.220.205.186: /* mysql */

[[Category:Umlaut]]

To install Umlaut

== 1. Make sure you have a modern Ruby ==

Rails recommends Ruby 1.8.4 (and requires at least 1.8.2, but 1.8.3 is incompatible). Some Red Hat versions may come with only 1.8.1. Try installing Ruby with your package manager of choice, and see if you can get 1.8.4. If not, try installing from source:

# [Download 1.8.4>http://rubyforge.org/frs/download.php/7858/ruby-1.8.4.tar.gz]
# tar -zxvf ruby-1.8.4.tar.gz
# cd ruby-1.8.4
# sudo ./configure
# sudo make
# sudo make install

== 2. Install RubyGems ==

Again, your package manager may be able to supply this (for example "yum install rubygems), but if not, you could again install from source:

# [Download here>http://rubyforge.org/frs/?group_id=126]
# tar -zxvf rubygems-x.x.x.tar.gz
# cd rubygems-x.x.x
# sudo ruby setup.rb
( actually don't do this, to be safe # sudo gem update)

[NOTE: Right now, umlaut may only work with rubygems 0.9. Working on it!]

== 3. Install Rails ==

Umlaut requires Rails 2.1.2, and is bound to it in the default environment.rb. It has not been verified for Rails 2.2.x yet. So install the 2.1.2 version of Rails (you can have multiple versions of Rails installed simulataneously, don't worry about this overwriting a more recent version of Rails you may want--it won't.)

"sudo gem install rails -v 2.1.2" (say yes to any dependencies)

'''Note''': There are various guides available on the net to getting Ruby/Rubygems/Rails installed on various OSs. Consult if you have trouble.

== 4. Install Umlaut ==

Right now, the best (only) way to install Umlaut is from it's SVN store.

For a read-only checkout:

<pre>
svn checkout http://umlaut.rubyforge.org/svn/trunk/ ./Umlaut
</pre>

Or instead of "./Umlaut", whatever local path you want to put the thing in.

For a checkout with commit privs, you need a rubyforge account and to be added to the umlaut project, then:

<pre>
svn checkout svn+ssh://(developername)@rubyforge.org/var/svn/umlaut/U2 ./Umlaut
</pre>

Umlaut comes with a number of Ruby gems and Rails plugins "frozen" into it's distribution, in vendor/plugins. You do not need to install these, they come with Umlaut. These include: json_pure ; sru; xisbn; enumerations_mixin (plugin) ; app_config (plugin); isbn-tools (plugin) ; openurl ( svn external link in plugin; needs to be fixed to link to a specific tag ); htmlentities (http://htmlentities.rubyforge.org/)

However, there are a few plugins that can not be conveniently packaged with Umlaut, you need to install them yourself...

== 5. Install Umlaut's gem dependencies ==

=== mongrel ===

(Umlaut will not run with WEBrick due to threading issues. Recommend installing mongrel for testing and deployment. mongrel 1.1.4 or later is highly reccommended. )

sudo gem install mongrel

=== hpricot ===

(hpricot is compiled C code, so you are best off installing it yourself. Right now hpricot 0.6 is tested and confirmed. )

sudo gem install hpricot -v 0.6

=== json ===

A pure-ruby json library is bundled with Umlaut automatically, but you really ought to install the compiled C one on your server instead, for much better performance. Umlaut will automatically use it if present. Currently verified with version 1.1.3

sudo gem install json -v 1.1.3

=== mysql ===

MySQL is the reccomended db, and the only db currently verified to work. Umlaut won't usually run with SQLite3 due to threading issues.

Rails is supposed to be able to talk to mysql without the mysql gem installed (just less efficiently), but for some reason Umlaut seems to have trouble with this. Not sure, you can try it.

sudo gem install msyql

Except some additional configuration arguments may be neccesary to compile on your machine.

===== redhat =====

On a RedHat machine, this works:

sudo gem install mysql -- --with-mysql-config=/usr/lib/mysql/mysql_config

===== ubuntu =====

On Ubuntu you will also need to:

sudo apt-get install libmysqlclient15-dev

Then you can:

sudo gem install mysql

Ubuntu also packages the mysql library, if you'd rather use that version you can try:

sudo apt-get install libmysql-ruby

===== Solaris 10 (sparc) =====

This has been reported to work on Solaris 10 (sparc)

gem install mysql -- --with-mysql-include=/opt/pkgs/mysql/include/
with-mysql-lib=/opt/pkgs/mysql/lib

=== More optional gems ===

* Voyager sites that want to bypass z39.50 and access Oracle directly will need Oracle Instant Client or Full Client installed on the same machine as the Umlaut. (This native Voyager code is not currently verified as working.) [http://www.jiubao.org/ruby-oci8 Oracle OCI8] [http://www.oracle.com/technology/tech/oci/instantclient/index.html Oracle Instant Client]

== Now You Need to Setup Umlaut ==

Good job, you've got all software installed, now you need to do some setup. See [[Umlaut Setup]].

Umlaut Installation

2008-12-03T20:24:33Z

128.220.205.186: /* ubuntu */

[[Category:Umlaut]]

To install Umlaut

== 1. Make sure you have a modern Ruby ==

Rails recommends Ruby 1.8.4 (and requires at least 1.8.2, but 1.8.3 is incompatible). Some Red Hat versions may come with only 1.8.1. Try installing Ruby with your package manager of choice, and see if you can get 1.8.4. If not, try installing from source:

# [Download 1.8.4>http://rubyforge.org/frs/download.php/7858/ruby-1.8.4.tar.gz]
# tar -zxvf ruby-1.8.4.tar.gz
# cd ruby-1.8.4
# sudo ./configure
# sudo make
# sudo make install

== 2. Install RubyGems ==

Again, your package manager may be able to supply this (for example "yum install rubygems), but if not, you could again install from source:

# [Download here>http://rubyforge.org/frs/?group_id=126]
# tar -zxvf rubygems-x.x.x.tar.gz
# cd rubygems-x.x.x
# sudo ruby setup.rb
( actually don't do this, to be safe # sudo gem update)

[NOTE: Right now, umlaut may only work with rubygems 0.9. Working on it!]

== 3. Install Rails ==

Umlaut requires Rails 2.1.2, and is bound to it in the default environment.rb. It has not been verified for Rails 2.2.x yet. So install the 2.1.2 version of Rails (you can have multiple versions of Rails installed simulataneously, don't worry about this overwriting a more recent version of Rails you may want--it won't.)

"sudo gem install rails -v 2.1.2" (say yes to any dependencies)

'''Note''': There are various guides available on the net to getting Ruby/Rubygems/Rails installed on various OSs. Consult if you have trouble.

== 4. Install Umlaut ==

Right now, the best (only) way to install Umlaut is from it's SVN store.

For a read-only checkout:

<pre>
svn checkout http://umlaut.rubyforge.org/svn/trunk/ ./Umlaut
</pre>

Or instead of "./Umlaut", whatever local path you want to put the thing in.

For a checkout with commit privs, you need a rubyforge account and to be added to the umlaut project, then:

<pre>
svn checkout svn+ssh://(developername)@rubyforge.org/var/svn/umlaut/U2 ./Umlaut
</pre>

Umlaut comes with a number of Ruby gems and Rails plugins "frozen" into it's distribution, in vendor/plugins. You do not need to install these, they come with Umlaut. These include: json_pure ; sru; xisbn; enumerations_mixin (plugin) ; app_config (plugin); isbn-tools (plugin) ; openurl ( svn external link in plugin; needs to be fixed to link to a specific tag ); htmlentities (http://htmlentities.rubyforge.org/)

However, there are a few plugins that can not be conveniently packaged with Umlaut, you need to install them yourself...

== 5. Install Umlaut's gem dependencies ==

=== mongrel ===

(Umlaut will not run with WEBrick due to threading issues. Recommend installing mongrel for testing and deployment. mongrel 1.1.4 or later is highly reccommended. )

sudo gem install mongrel

=== hpricot ===

(hpricot is compiled C code, so you are best off installing it yourself. Right now hpricot 0.6 is tested and confirmed. )

sudo gem install hpricot -v 0.6

=== json ===

A pure-ruby json library is bundled with Umlaut automatically, but you really ought to install the compiled C one on your server instead, for much better performance. Umlaut will automatically use it if present. Currently verified with version 1.1.3

sudo gem install json -v 1.1.3

=== mysql ===

MySQL is the reccomended db, and the only db currently verified to work. Umlaut won't usually run with SQLite3 due to threading issues.

Rails is supposed to be able to talk to mysql without the mysql gem installed (just less efficiently), but for some reason Umlaut seems to have trouble with this. Not sure, you can try it.

sudo gem install msyql

Except some additional configuration arguments may be neccesary to compile on your machine.

==== redhat ====

On a RedHat machine, this works:

sudo gem install mysql -- --with-mysql-config=/usr/lib/mysql/mysql_config

==== ubuntu ====

On Ubuntu you will also need to:

sudo apt-get install libmysqlclient15-dev

Then you can:

sudo gem install mysql

Ubuntu also packages the mysql library, if you'd rather use that version you can try:

sudo apt-get install libmysql-ruby

=== More optional gems ===

* Voyager sites that want to bypass z39.50 and access Oracle directly will need Oracle Instant Client or Full Client installed on the same machine as the Umlaut. (This native Voyager code is not currently verified as working.) [http://www.jiubao.org/ruby-oci8 Oracle OCI8] [http://www.oracle.com/technology/tech/oci/instantclient/index.html Oracle Instant Client]

== Now You Need to Setup Umlaut ==

Good job, you've got all software installed, now you need to do some setup. See [[Umlaut Setup]].

Umlaut Installation

2008-12-03T20:24:24Z

128.220.205.186: /* redhat */

[[Category:Umlaut]]

To install Umlaut

== 1. Make sure you have a modern Ruby ==

Rails recommends Ruby 1.8.4 (and requires at least 1.8.2, but 1.8.3 is incompatible). Some Red Hat versions may come with only 1.8.1. Try installing Ruby with your package manager of choice, and see if you can get 1.8.4. If not, try installing from source:

# [Download 1.8.4>http://rubyforge.org/frs/download.php/7858/ruby-1.8.4.tar.gz]
# tar -zxvf ruby-1.8.4.tar.gz
# cd ruby-1.8.4
# sudo ./configure
# sudo make
# sudo make install

== 2. Install RubyGems ==

Again, your package manager may be able to supply this (for example "yum install rubygems), but if not, you could again install from source:

# [Download here>http://rubyforge.org/frs/?group_id=126]
# tar -zxvf rubygems-x.x.x.tar.gz
# cd rubygems-x.x.x
# sudo ruby setup.rb
( actually don't do this, to be safe # sudo gem update)

[NOTE: Right now, umlaut may only work with rubygems 0.9. Working on it!]

== 3. Install Rails ==

Umlaut requires Rails 2.1.2, and is bound to it in the default environment.rb. It has not been verified for Rails 2.2.x yet. So install the 2.1.2 version of Rails (you can have multiple versions of Rails installed simulataneously, don't worry about this overwriting a more recent version of Rails you may want--it won't.)

"sudo gem install rails -v 2.1.2" (say yes to any dependencies)

'''Note''': There are various guides available on the net to getting Ruby/Rubygems/Rails installed on various OSs. Consult if you have trouble.

== 4. Install Umlaut ==

Right now, the best (only) way to install Umlaut is from it's SVN store.

For a read-only checkout:

<pre>
svn checkout http://umlaut.rubyforge.org/svn/trunk/ ./Umlaut
</pre>

Or instead of "./Umlaut", whatever local path you want to put the thing in.

For a checkout with commit privs, you need a rubyforge account and to be added to the umlaut project, then:

<pre>
svn checkout svn+ssh://(developername)@rubyforge.org/var/svn/umlaut/U2 ./Umlaut
</pre>

Umlaut comes with a number of Ruby gems and Rails plugins "frozen" into it's distribution, in vendor/plugins. You do not need to install these, they come with Umlaut. These include: json_pure ; sru; xisbn; enumerations_mixin (plugin) ; app_config (plugin); isbn-tools (plugin) ; openurl ( svn external link in plugin; needs to be fixed to link to a specific tag ); htmlentities (http://htmlentities.rubyforge.org/)

However, there are a few plugins that can not be conveniently packaged with Umlaut, you need to install them yourself...

== 5. Install Umlaut's gem dependencies ==

=== mongrel ===

(Umlaut will not run with WEBrick due to threading issues. Recommend installing mongrel for testing and deployment. mongrel 1.1.4 or later is highly reccommended. )

sudo gem install mongrel

=== hpricot ===

(hpricot is compiled C code, so you are best off installing it yourself. Right now hpricot 0.6 is tested and confirmed. )

sudo gem install hpricot -v 0.6

=== json ===

A pure-ruby json library is bundled with Umlaut automatically, but you really ought to install the compiled C one on your server instead, for much better performance. Umlaut will automatically use it if present. Currently verified with version 1.1.3

sudo gem install json -v 1.1.3

=== mysql ===

MySQL is the reccomended db, and the only db currently verified to work. Umlaut won't usually run with SQLite3 due to threading issues.

Rails is supposed to be able to talk to mysql without the mysql gem installed (just less efficiently), but for some reason Umlaut seems to have trouble with this. Not sure, you can try it.

sudo gem install msyql

Except some additional configuration arguments may be neccesary to compile on your machine.

==== redhat ====

On a RedHat machine, this works:

sudo gem install mysql -- --with-mysql-config=/usr/lib/mysql/mysql_config

=== ubuntu ===

On Ubuntu you will also need to:

sudo apt-get install libmysqlclient15-dev

Then you can:

sudo gem install mysql

Ubuntu also packages the mysql library, if you'd rather use that version you can try:

sudo apt-get install libmysql-ruby

=== More optional gems ===

* Voyager sites that want to bypass z39.50 and access Oracle directly will need Oracle Instant Client or Full Client installed on the same machine as the Umlaut. (This native Voyager code is not currently verified as working.) [http://www.jiubao.org/ruby-oci8 Oracle OCI8] [http://www.oracle.com/technology/tech/oci/instantclient/index.html Oracle Instant Client]

== Now You Need to Setup Umlaut ==

Good job, you've got all software installed, now you need to do some setup. See [[Umlaut Setup]].

Umlaut Installation

2008-12-03T20:23:34Z

128.220.205.186: /* mysql */

[[Category:Umlaut]]

To install Umlaut

== 1. Make sure you have a modern Ruby ==

Rails recommends Ruby 1.8.4 (and requires at least 1.8.2, but 1.8.3 is incompatible). Some Red Hat versions may come with only 1.8.1. Try installing Ruby with your package manager of choice, and see if you can get 1.8.4. If not, try installing from source:

# [Download 1.8.4>http://rubyforge.org/frs/download.php/7858/ruby-1.8.4.tar.gz]
# tar -zxvf ruby-1.8.4.tar.gz
# cd ruby-1.8.4
# sudo ./configure
# sudo make
# sudo make install

== 2. Install RubyGems ==

Again, your package manager may be able to supply this (for example "yum install rubygems), but if not, you could again install from source:

# [Download here>http://rubyforge.org/frs/?group_id=126]
# tar -zxvf rubygems-x.x.x.tar.gz
# cd rubygems-x.x.x
# sudo ruby setup.rb
( actually don't do this, to be safe # sudo gem update)

[NOTE: Right now, umlaut may only work with rubygems 0.9. Working on it!]

== 3. Install Rails ==

Umlaut requires Rails 2.1.2, and is bound to it in the default environment.rb. It has not been verified for Rails 2.2.x yet. So install the 2.1.2 version of Rails (you can have multiple versions of Rails installed simulataneously, don't worry about this overwriting a more recent version of Rails you may want--it won't.)

"sudo gem install rails -v 2.1.2" (say yes to any dependencies)

'''Note''': There are various guides available on the net to getting Ruby/Rubygems/Rails installed on various OSs. Consult if you have trouble.

== 4. Install Umlaut ==

Right now, the best (only) way to install Umlaut is from it's SVN store.

For a read-only checkout:

<pre>
svn checkout http://umlaut.rubyforge.org/svn/trunk/ ./Umlaut
</pre>

Or instead of "./Umlaut", whatever local path you want to put the thing in.

For a checkout with commit privs, you need a rubyforge account and to be added to the umlaut project, then:

<pre>
svn checkout svn+ssh://(developername)@rubyforge.org/var/svn/umlaut/U2 ./Umlaut
</pre>

Umlaut comes with a number of Ruby gems and Rails plugins "frozen" into it's distribution, in vendor/plugins. You do not need to install these, they come with Umlaut. These include: json_pure ; sru; xisbn; enumerations_mixin (plugin) ; app_config (plugin); isbn-tools (plugin) ; openurl ( svn external link in plugin; needs to be fixed to link to a specific tag ); htmlentities (http://htmlentities.rubyforge.org/)

However, there are a few plugins that can not be conveniently packaged with Umlaut, you need to install them yourself...

== 5. Install Umlaut's gem dependencies ==

=== mongrel ===

(Umlaut will not run with WEBrick due to threading issues. Recommend installing mongrel for testing and deployment. mongrel 1.1.4 or later is highly reccommended. )

sudo gem install mongrel

=== hpricot ===

(hpricot is compiled C code, so you are best off installing it yourself. Right now hpricot 0.6 is tested and confirmed. )

sudo gem install hpricot -v 0.6

=== json ===

A pure-ruby json library is bundled with Umlaut automatically, but you really ought to install the compiled C one on your server instead, for much better performance. Umlaut will automatically use it if present. Currently verified with version 1.1.3

sudo gem install json -v 1.1.3

=== mysql ===

MySQL is the reccomended db, and the only db currently verified to work. Umlaut won't usually run with SQLite3 due to threading issues.

Rails is supposed to be able to talk to mysql without the mysql gem installed (just less efficiently), but for some reason Umlaut seems to have trouble with this. Not sure, you can try it.

sudo gem install msyql

Except some additional configuration arguments may be neccesary to compile on your machine.

=== redhat ===

On a RedHat machine, this works:

sudo gem install mysql -- --with-mysql-config=/usr/lib/mysql/mysql_config

=== ubuntu ===

On Ubuntu you will also need to:

sudo apt-get install libmysqlclient15-dev

Then you can:

sudo gem install mysql

Ubuntu also packages the mysql library, if you'd rather use that version you can try:

sudo apt-get install libmysql-ruby

=== More optional gems ===

* Voyager sites that want to bypass z39.50 and access Oracle directly will need Oracle Instant Client or Full Client installed on the same machine as the Umlaut. (This native Voyager code is not currently verified as working.) [http://www.jiubao.org/ruby-oci8 Oracle OCI8] [http://www.oracle.com/technology/tech/oci/instantclient/index.html Oracle Instant Client]

== Now You Need to Setup Umlaut ==

Good job, you've got all software installed, now you need to do some setup. See [[Umlaut Setup]].

Umlaut Setup

2008-11-26T20:16:07Z

128.220.205.186: /* Next Steps? */

[[Category:Umlaut]]

= Umlaut First-Time Setup and Configuration =

''In all these instructions '''$Umlaut''' in a path stands for the location you have installed Umlaut.
''

== 1. Create Local Config Directories ==

To create directories for your local config, cd into your Umlaut directory, and run:

./script/generate umlaut_local

This will create several directories including the one we care about now: $Umlaut/config/umlaut_config/

:'''Explanation''': In a normal Rails app, your local config goes in places like config/environment.rb and config/database.yml. But Umlaut config/environment.rb has Umlaut application fixed settings in it, mixing in your local settings would be confusing. Plus, that config directory is in the Umlaut overall SVN, you might want to SVN control your local config seperately.

:Therefore we have an architecture to put all local config (and other local customization) in seperate local directories. The goal is that you should never have to edit any of the files that came with the Umlaut distribution to make local customizations, you should always be able to do this through local config. To learn more about this architecture, and how to put your local config in your own local svn, see [[Umlaut Local Configuration Architecture]].

== 2. Configure your database connection information ==

A typical Rails app uses three databases: a production db, a development db, and a test db. At a minimum you need a production db. A development db is probably also neccessary--Umlaut doesn't use tests right now (we are ashamed), so you don't really need a test db.

In Umlaut (a little bit different than standard Rails), your local connection information for your dbs is stored in $Umlaut/config/umlaut_config/database.yml. There should already be an example file there with some hints in it.

We reccommend MySQL 5.x for use with Umlaut. ( SQLite3 won't work, unless you figure out a way to compile it with concurrency support). Create your databases in MySQL. We recommend making sure they are set to UTF8 char encoding. (eg, (CREATE DATABASE 'Name' DATABASE DEFAULT CHARACTER SET utf8). Don't create any tables in your databases yet, that will be done automatically. Do fill out your umlaut_config/database.yml file to point at the right place.

For search functions (manually entered journal name or citation), Umlaut uses a direct db connection to your SFX instance. You should use the MySQL utility to create a new user in the SFX MySQL instance, which is granted only select permissions to the SFX databases. Then, you can fill out your SFX direct to db connection information in config/umlaut_config/database.yml.

If you can't do this, or don't want to do this now, talk to Jonathan, it may be possible to set up other functionality. Umlaut used to support a bulk export from SFX instead of a live db connection, but that functionality has atrophied. It can in theory be brought back if needed.

== 3. Create your database tables ==

Once your dbs are configured in database.yml, you can have Rails create all the neccesary tables for you by running (from the Umlaut directory):

:rake db:schema:load

That will create tables in your development database. To create them in your production database too:

:rake db:schema:load RAILS_ENV=production

== 4. Set up initial Umlaut data ==

Now you've created your databases and tables, but there is some initial fixed data that need to be in those tables for Umlaut to work with. To add this to your database, cd into your $UMLAUT directory, and run:

:rake umlaut:load_initial_data

And again for production:

:rake umlaut:load_initial_data RAILS_ENV=production

== 5. Set up your Institutions and Services ==

What functions your Umlaut installation will have will depend on which services you configure. Services are configured in $Umlaut/config/umlaut_config/services.yml . An individual user connects with given services by association to Institutions. Each Institution has a collection of services, and an individual user is associated with one more institutions.

To begin with, you could define just one default institution (that all users will be associated with) in institutions.yml, and give it a few services. To start out with, just configure an SFX service pointing to your SFX installation. Comment out the others. As you know a service is working, you can add in another.

Note: The A-Z list and journal name lookup will only currently work if using the direct connection to the SFX database.

After editing the institutions.yml file, it needs to be synced with the db, as some institution information is stored in the db. Umlaut should check on startup if timestamp of institutions.yml requires a resync and do it automatically, but if you want to do it manually you can cd into the $UMLAUT directory and run:

:rake umlaut:sync_institutions (RAILS_ENV=production)

== 6. Review additional local configuration ==

There are several files in $Umlaut/config/umlaut_config/initializers/umlaut that contain additional local configuration parameters. A bunch of examples are provided for you, you'll have to un-comment the line and set a value if you want to locally configure a particular property.

There are only a few that are really best set right away, all in umlaut_config/initializers/umlaut/umlaut_properties.rb
* You may want to set your local application name and a URL to an image for a 'link resolver button'. The button is mainly only used in Umlaut 'search' functionality (look up a manually typed in citation or journal name).
* You will definitely need to point AppConfig::Base.main_sfx_base_url to your SFX base URL. This is not used in general link resolver menu functions, but may be used in 'search' function to look up a manually typed in journal name or citation. It is also used on Umlaut's error page, to give the user an option of going to the native original SFX in an error condition.
* You may want to set AppConfig::Base.help_url , which is also used on error pages.

There's really nothing else here you need to change to get Umlaut to work properly for you, but feel free to look around in the other files in initializers to see what sorts of things you can customize (an awful lot, sometimes by writing custom logic in ruby code to determine a particular Umlaut decision.)

== 7. Nightly maintenance ==

Some maintenance routines meant to be run nightly can be executed by cd'ing to your $Umlaut directory and running:

:rake umlaut:nightly_maintenance (RAILS_ENV=production)

To put that in a cron job, use this (with parens, where $Umlaut represents your umlaut install directory as usual):

:( cd $Umlaut && /usr/bin/rake umlaut:nightly_maintenance RAILS_ENV=production )

Or leave the RAILS_ENV=production off to perform maintainance on your dev database.

If you don't put it in a cron job yet, you might want to run this manually from time to time, and probably once now to begin.

== Next Steps? ==

To try out Umlaut, cd into the $Umlaut directory and run "./script/server" to launch the Rails app. (Be sure you've installed mongrel with 'sudo gem install mongrel', in which case Umlaut will be started with the mongrel environment. The default WEBrick environment will not work for Umlaut!). You'll then connect to Umlaut on

http://yourservername.tld:3000

The resolver base URL will be:

http://yourservername.tld:3000/resolve?.

The A-Z search interface will be:

http://yourservername.tld:3000/search

(should also work on straight http://yourservername.tld:3000/)

This is a fine way to start it just for testing, but to deploy it for real see [[Umlaut Deployment]].

You may also be interested in providing your own customized header, footer, or stylesheets. For this, and more localization, you'll find it helpful to see [[Umlaut Local Configuration Architecture]].

Umlaut Setup

2008-11-26T20:15:22Z

128.220.205.186: /* Next Steps? */

[[Category:Umlaut]]

= Umlaut First-Time Setup and Configuration =

''In all these instructions '''$Umlaut''' in a path stands for the location you have installed Umlaut.
''

== 1. Create Local Config Directories ==

To create directories for your local config, cd into your Umlaut directory, and run:

./script/generate umlaut_local

This will create several directories including the one we care about now: $Umlaut/config/umlaut_config/

:'''Explanation''': In a normal Rails app, your local config goes in places like config/environment.rb and config/database.yml. But Umlaut config/environment.rb has Umlaut application fixed settings in it, mixing in your local settings would be confusing. Plus, that config directory is in the Umlaut overall SVN, you might want to SVN control your local config seperately.

:Therefore we have an architecture to put all local config (and other local customization) in seperate local directories. The goal is that you should never have to edit any of the files that came with the Umlaut distribution to make local customizations, you should always be able to do this through local config. To learn more about this architecture, and how to put your local config in your own local svn, see [[Umlaut Local Configuration Architecture]].

== 2. Configure your database connection information ==

A typical Rails app uses three databases: a production db, a development db, and a test db. At a minimum you need a production db. A development db is probably also neccessary--Umlaut doesn't use tests right now (we are ashamed), so you don't really need a test db.

In Umlaut (a little bit different than standard Rails), your local connection information for your dbs is stored in $Umlaut/config/umlaut_config/database.yml. There should already be an example file there with some hints in it.

We reccommend MySQL 5.x for use with Umlaut. ( SQLite3 won't work, unless you figure out a way to compile it with concurrency support). Create your databases in MySQL. We recommend making sure they are set to UTF8 char encoding. (eg, (CREATE DATABASE 'Name' DATABASE DEFAULT CHARACTER SET utf8). Don't create any tables in your databases yet, that will be done automatically. Do fill out your umlaut_config/database.yml file to point at the right place.

For search functions (manually entered journal name or citation), Umlaut uses a direct db connection to your SFX instance. You should use the MySQL utility to create a new user in the SFX MySQL instance, which is granted only select permissions to the SFX databases. Then, you can fill out your SFX direct to db connection information in config/umlaut_config/database.yml.

If you can't do this, or don't want to do this now, talk to Jonathan, it may be possible to set up other functionality. Umlaut used to support a bulk export from SFX instead of a live db connection, but that functionality has atrophied. It can in theory be brought back if needed.

== 3. Create your database tables ==

Once your dbs are configured in database.yml, you can have Rails create all the neccesary tables for you by running (from the Umlaut directory):

:rake db:schema:load

That will create tables in your development database. To create them in your production database too:

:rake db:schema:load RAILS_ENV=production

== 4. Set up initial Umlaut data ==

Now you've created your databases and tables, but there is some initial fixed data that need to be in those tables for Umlaut to work with. To add this to your database, cd into your $UMLAUT directory, and run:

:rake umlaut:load_initial_data

And again for production:

:rake umlaut:load_initial_data RAILS_ENV=production

== 5. Set up your Institutions and Services ==

What functions your Umlaut installation will have will depend on which services you configure. Services are configured in $Umlaut/config/umlaut_config/services.yml . An individual user connects with given services by association to Institutions. Each Institution has a collection of services, and an individual user is associated with one more institutions.

To begin with, you could define just one default institution (that all users will be associated with) in institutions.yml, and give it a few services. To start out with, just configure an SFX service pointing to your SFX installation. Comment out the others. As you know a service is working, you can add in another.

Note: The A-Z list and journal name lookup will only currently work if using the direct connection to the SFX database.

After editing the institutions.yml file, it needs to be synced with the db, as some institution information is stored in the db. Umlaut should check on startup if timestamp of institutions.yml requires a resync and do it automatically, but if you want to do it manually you can cd into the $UMLAUT directory and run:

:rake umlaut:sync_institutions (RAILS_ENV=production)

== 6. Review additional local configuration ==

There are several files in $Umlaut/config/umlaut_config/initializers/umlaut that contain additional local configuration parameters. A bunch of examples are provided for you, you'll have to un-comment the line and set a value if you want to locally configure a particular property.

There are only a few that are really best set right away, all in umlaut_config/initializers/umlaut/umlaut_properties.rb
* You may want to set your local application name and a URL to an image for a 'link resolver button'. The button is mainly only used in Umlaut 'search' functionality (look up a manually typed in citation or journal name).
* You will definitely need to point AppConfig::Base.main_sfx_base_url to your SFX base URL. This is not used in general link resolver menu functions, but may be used in 'search' function to look up a manually typed in journal name or citation. It is also used on Umlaut's error page, to give the user an option of going to the native original SFX in an error condition.
* You may want to set AppConfig::Base.help_url , which is also used on error pages.

There's really nothing else here you need to change to get Umlaut to work properly for you, but feel free to look around in the other files in initializers to see what sorts of things you can customize (an awful lot, sometimes by writing custom logic in ruby code to determine a particular Umlaut decision.)

== 7. Nightly maintenance ==

Some maintenance routines meant to be run nightly can be executed by cd'ing to your $Umlaut directory and running:

:rake umlaut:nightly_maintenance (RAILS_ENV=production)

To put that in a cron job, use this (with parens, where $Umlaut represents your umlaut install directory as usual):

:( cd $Umlaut && /usr/bin/rake umlaut:nightly_maintenance RAILS_ENV=production )

Or leave the RAILS_ENV=production off to perform maintainance on your dev database.

If you don't put it in a cron job yet, you might want to run this manually from time to time, and probably once now to begin.

== Next Steps? ==

To try out Umlaut, cd into the $Umlaut directory and run "./script/server" to launch the Rails app. (Be sure you've installed mongrel with 'sudo gem install mongrel', in which case Umlaut will be started with the mongrel environment. The default WEBrick environment will not work for Umlaut!). You'll then connect to Umlaut on

http://yourservername.tld:3000

The resolver base URL will be:

http://yourservername.tld:3000/resolve?.

The A-Z search interface will be:

http://yourservername.tld:3000/search

This is a fine way to start it just for testing, but to deploy it for real see [[Umlaut Deployment]].

You may also be interested in providing your own customized header, footer, or stylesheets. For this, and more localization, you'll find it helpful to see [[Umlaut Local Configuration Architecture]].