This application has been configured with guard, it will ensure
- Tests are run
- Solr is running for dev and test
- Development web server is started
- All of the above is restarted when you edit files
bundle install
bundle exec spring rake db:create
bundle exec spring rake db:schema:load
RAILS_ENV=test bundle exec spring rake db:schema:load
bundle exec guard
We are using Capistrano for deployment.
cap deploy
if necessary:
cap deploy:migrate
cap sunspot:reindex
ssh deploy@catalog.paradisec.org.au "mysqldump -u root nabu | gzip > nabu.sql.gz"
scp deploy@catalog.paradisec.org.au:nabu.sql.gz .
gzip -dc nabu.sql.gz | mysql -u root nabu_devel
spring rake sunspot:reindex
import archive files
RAILS_ENV=production bundle exec rake archive:update_files
check if all files that have been uploaded are ok:
cd /srv/www/nabu/current
RAILS_ENV=production bundle exec rake --trace archive:update_files > log/update_files.log
check if all *-CAT-PDSC_ADMIN.xml files exist and create if necessary:
cd /srv/www/nabu/current
RAILS_ENV=production bundle exec rake --trace archive:admin_files > log/admin_files.log
delete a collection with all its items:
cd /srv/www/nabu/current
RAILS_ENV=production bundle exec rake archive:delete_collection[PA1]
# NEW Ethnologue data
Download the latest version of the following tables from
http://www.ethnologue.com/codes/default.asp#downloading
* CountryCodes.tab
* LanguageIndex.tab
Copy them into the data directory, overwriting the existing files there.
Run the following rake tasks to import them (in this order):
``` bash
bundle exec rake import:countries
bundle exec rake import:languages
All new countries will be added to the Nabu countries table. The new language codes of type "L" will be added to the Nabu language table. All mappings of language to countries will also be added to the countries_languages table.
Download the latest version of the retired codes from
http://www-01.sil.org/iso639-3/download.asp#retiredDownloads
- iso-639-3_Retirements.tab
Copy it into the data directory, overwriting the existing file there.
Run the following rake task to import them:
bundle exec rake import:retired
All existing codes that are retired are marked as such, incl name change. Where name changes occurred items in CollectionLanguage, ItemContentLanguage, ItemSubjectLanguage are updated with the replacement language code. Where splits happened, a message is printed.
OLAC available at:
The feeds that OLAC harvests:
- http://catalog.paradisec.org.au/oai/item?verb=ListRecords&metadataPrefix=olac
- http://catalog.paradisec.org.au/oai/item?verb=Identify (Archive identification)
- http://catalog.paradisec.org.au/oai/item?verb=ListMetadataFormats
- http://catalog.paradisec.org.au/oai/item?verb=ListIdentifiers&metadataPrefix=olac
Individual item:
RIF-CS available at:
testing:
- install localtunnel to port forward your local webserver
- http://progrium.com/localtunnel/
gem install localtunnel
rbenv rehash
localtunnel 3000
use resulting server on an OAI repository explorer:
- http://www.language-archives.org/register/register.php (OLAC)
- http://re.cs.uct.ac.za/
- http://oval.base-search.net/ (OAI-PMH validator)
- http://validator.oaipmh.com/ (OAI-PMH validator)
- http://repox.gulbenkian.pt/repox/jsp/testOAI-PMH.jsp (test protocol)
URLs to test:
- http://localhost:3000/oai/collection?verb=Identify
- http://localhost:3000/oai/collection?verb=ListMetadataFormats
- http://localhost:3000/oai/collection?verb=ListSets
- http://localhost:3000/oai/collection?verb=ListIdentifiers
- http://localhost:3000/oai/collection?verb=ListRecords
The feed that ANDS harvests:
Test at ANDS:
Feed for a single collection:
You need to configure the rollbar API key to capture exceptions.
The first method is creating a file in the shared directory, which will be symlinked by cap.
echo ROLLBAR_API_KEY > /srv/www/nabu/shared/config/rollbar.txt
Alternatively you can pass it in as an environment variable at server start up, for example.
rails server ROLLBAR_ACCESS_TOKEN=ROLLBAR_API_KEY