Skip to content

III: Creating your Hyrax Application

Jump to bottom
llvallejo93 edited this page Jan 8, 2019 · 2 revisions

Compatibility

  • On your development unit, open up your command prompt/powershell/terminal and go to the directory where you will be accessing the application locally.

  • Once you are in there, check to make sure that you are running a compatible version of both Ruby (Ruby -v) and Rails (Rails -v). Having the Ruby Version Manager tool (RVM) helps facilitate the management of their versions so you don't have to deal with any dependency conflicts in the future. For this specific example and setup, make sure you are running Ruby v2.4.5 and Rails v5.1.6. You should also have the latest version of RVM found here.

Creating the application

  • After checking your development versions, go ahead and run this script in order to create the application:

rails _5.1.6_ new armand-dev -m https://raw.githubusercontent.com/samvera/hyrax/v3.0.0-beta1/template.rb

(Notice that we specified the rails version, named the application "armand-dev" and made sure that the Hyrax template we are using is the "v3.0.0-beta1" version.)

Gem Dependency

  • Now that your application has been created successfully, CD into the application's folder. Before we run a bundle install, there are a few gems that need to be placed into the gem file that are not originally part of the app.

  • Open your app in a code editor; for this example we will be using Visual Studio Code.

  • Access your gemfile and add

    gem 'solr_wrapper'

    gem 'fcrepo_wrapper'

  • Save your gem file and close your editor.

  • Now run a bundle install in your terminal within the app's directory.

Once the bundle install is completed successfully you can move on to the next section covering accessibility and management of your new application.

Clone this wiki locally