Gsearch

common tasks

• start: bhladmin@bhl-test2: /opt/archival-storage/fedora/tomcat/bin/startup.sh
• stop: bhladmin@bhl-test2: /opt/archival-storage/fedora/tomcat/bin/shutdown.sh
• reindex: http://bhl-test.nhm.ac.uk/fedoragsearch/rest -> updateIndex -> updateIndex FromFoxmlFiles
• browse index: http://bhl-test.nhm.ac.uk/fedoragsearch/rest -> browseIndex

location

• Github: https://github.com/bhle/bhle/tree/master/data-management/gsearch
• web-application: /opt/archival-storage/fedora/tomcat/webapps/fedoragsearch
• application-container: /opt/archival-storage/fedora/tomcat
• config files:
  1. /opt/data-management/gsearch/fgsconfig-basic.properties
• logs: /var/log/gsearch/fedoragsearch.daily.log

dependencies

• Fedora Commons
• Solr
• Ant

modifying config files

1. fgsconfig-basic.properties:
   bhladmin@bhl-test2: ant -f /opt/data-management/gsearch/fgsconfig-basic.xml
2. It is recommended to delete all index in Solr (/mnt/nfs/test/data/data-management/solr/core/data) before reindexing.

how to test if it's working

• http://bhl-test.nhm.ac.uk/fedoragsearch/rest -> updateIndex, if there is no error message

login information if necessary

• username: fgsAdmin
• password: [the same as bhletech account]

proxy information

• bhladmin@bhl-proxy1:~$ sudo vi /etc/apache2/sites-enabled/bhl-test
  • ProxyPass /fedoragsearch http://bhl-test2.nhm.ac.uk:8080/fedoragsearch
    ProxyPassReverse /adore-djatoka http://bhl-test2.nhm.ac.uk:8080/fedoragsearch

Installation

• Version 2.3 from https://github.com/fcrepo/gsearch (git clone)
• Follow the instructions in FedoraGenericSearch/src/html/fedoragsearch-doc.html
• Configure Fedora to update gSearch index when new objects are archived => see fedoragsearch-doc.html section "Configuring Fedora for Automatic Updates"
• Move config files to data-management folder:

bhladmin@bhl-test2: mv -r /opt/archival-storage/fedora/tomcat/webapps/fedoragsearch/FgsConfig/* /opt/data-management/gsearch

Troubleshooting

• If fedoragsearch loses the connection to ActiveMQ, simple restart the fedoragsearch applet from the manager app of tomcat (<tomcat_url>/manager/html/)