Once you have installed all the dependencies you are now ready to install the rest of the stack. As all the components require configuration to interact we strongly recommend that you use the installation template which is a Rails Application Template which is provided for Supplejack.
If you are a Mac user using Homebrew we strongly recommend you cleanly run brew doctor before installing.
$ brew update $ brew doctor
Resolving issues that
brew doctor picks up will alleviate many problems you might encounter installing Supplejack.
Please also note there is a known installation issue involving the libv8 gem, which can affect Yosemite users. We are working to resolve this.
mongod is the primary daemon process for the MongoDB system. It handles data requests, manages data access, and performs background management operations. You need to run mongod in order to install Supplejack and whenever Supplejack is in use.
Assuming your installation went smoothly and your paths are set up correctly you should be able to run mongod from the command line.
If mongod doesn't start, review the MongoDB installation documention for your system.
Install the Supplejack Stack
The Supplejack Stack refers to the Supplejack API, Supplejack Manager and the Supplejack Worker applications.
The installation template creates a new Rails application using the Supplejack API and then installs and configures the Supplejack Manager and Supplejack Worker applications.
To install the full stack run the following command:
# You should replace 'mysupplejack_api_name' with the name of your app. $ rails _3.2.12_ new mysupplejack_api_name --skip-bundle -m https://raw.github.com/digitalnz/supplejack_installation/master/supplejack_api_template.rb
Note: Be sure to record the user API key that is printed to the terminal during the install process.
This operation will create three directories and many files:
If you ever want to remove this supplejack project, simply delete these three directories. Once the operation is complete you need to bundle install the various gems and libraries that Supplejack relies on.
$ cd mysupplejack_api_name $ bundle install
Supplejack uses Sidekiq to manage indexing jobs. Make sure you have installed Redis as Sidekiq depends on it.
To start Sidekiq, run the following command
$ cd mysupplejack_api_name $ bundle exec sidekiq
These commands will start Sidekiq and have it start listening for jobs to process from Redis
Supplejack uses the sunspot gem to interact with Solr. There is currently an issue with Sunspot and Solr 4. For development instances, please follow these configuration instructions. When asked which version of Solr to download, select solr-4.1.0.tgz or solr-4.1.0.zip .
Whenever you want to start Solr execute the following command from
$ bundle exec rake sunspot:solr:start
Finally start a rails server from within
$ rails server
Once complete you will be able to access your API (at http://localhost:3000/records.json?api_key=USER_API_KEY) and harvest new data from external sources.