Skip to content

fathomlabs/iceapp

Repository files navigation

Ice icon IceApp

IceApp is an OSX standalone app for running an ICE server (JBEI Inventory of Composable Elements). It packages up all the external dependencies and takes care of configuration to make installation and running of an ICE server an easy, user-friendly experience on OSX.

Packaged dependencies:

  • JAVA Runtime Environment (latest 1.7 release at the time of packaging)
  • PostgreSQL
  • JBOSS WildFly Server
  • JBEI ICE
  • NCBI BLAST

Installation

  1. Download the latest version from the releases page
  2. Double-click the downloaded .dmg file
  3. Drag the Ice.app icon into the /Applications icon
  4. Open your Applications directory and run Ice.app

The app will do the following:

  1. Set up a postgres database server, create the necessary users and databases, and run the server
  2. Set up a JBOSS Wildfly application server and create the necessary systems (e.g. https)
  3. Set up and deploy the ICE app onto the application server

To view your running ICE installation, go to http://localhost:8080.

Screenshot

Screenshot

Building the app from scratch

The app is setup to be able to be rebuilt with new versions of postgres, wildfly and ICE easily. Just follow the following steps to build from scratch:

Prerequisites:

  • XCode
  • homebrew
  • brew install autoconf automake
  • Node.js
  • Ruby/rubygems

Download the code:

git clone https://github.com/fathomlabs/IceApp.git

Download the internal dependencies:

gem install cocoapods
cd IceApp
pod install

Download and compile the external dependencies:

cd src
make

Once this is done, you can just open Ice.xcworkspace in Xcode, select the "Ice" scheme, and click "Build".

To export your build as an .app, use the "Archive" command and then use the "Distribute" command in Organizer.

To package the exported app in a pretty .dmg, save the archived app to the base directory of the source code, then:

npm install --global appdmg
appdmg dmg.json IceApp.dmg