geoblacklight

Johns Hopkins University Geoblacklight Project

Installation

Dependencies

• Ruby 2.6.5
• Java 8 or greater (Solr)
• Node.js (yarn)

GoRails has great Ruby on Rails setup instructions for macOS, Ubuntu, and Windows.

Clone the Project

cd <your project directory>
git clone git@github.com:jhu-library-applications/geoblacklight.git

Configuration

Duplicate the .example files in the project and remove the .example string from each of their filename. Configure each file as necessary, or keep the default values.

cp .example.env.development .env.development  
cp .example.env.test .env.test  

Bundle RubyGems

Test with Bundler 2.1.4

bundle

Install Yarn Packages

yarn install

Run the Database Migrations

bin/rails db:migrate RAILS_ENV=development

Run the Application

The rake task below will spin up Solr, index the test fixture documents, and start the default Rails web server.

bundle exec rake jhu:server

• View the application at http://localhost:3000
• View the Solr admin panel at http://localhost:8983

Optional - Index JHU test fixtures

bundle exec rake jhu:index_jhu_fixtures

Optional - Index UMD documents from B1G Geoportal

bundle exec rake jhu:b1g_index_umd_data

Run the Test Suite

Stop any instances of GeoBlacklight before running this command.

RAILS_ENV=test bundle exec rake ci

Add RUBYOPT=W0 to suppress deprecation warnings.

RUBYOPT=W0 RAILS_ENV=test bundle exec rake ci

Docker for Solr

To run the GeoPortal's Solr server via Docker, start Docker on your local computer, and run the following command:

docker-compose --env-file .env.development up

---

Homepage Imagery

• Hackerman Maps
• Maryland LiDAR
• Fish and Game
• Watersheds