Optional: Extra steps for browser-based staff client

Note

Skip this entire section if you are using an official release tarball downloaded from http://evergreen-ils.org/downloads

Note

You make skip the subsection ‘Install dependencies for browser-based staff client’ if you are installing on either Debian Jessie, Ubuntu Trusty, or Ubuntu Xenial and you have installed the ‘Optional: Developer Additions’ described above. You will still need to do the steps in ‘Install files for browser-based staff client’ below.

Install dependencies for browser-based staff client

  1. Install Node.js. For more information see also: Node.js Installation

    # Go to a temporary directory
    cd /tmp
    
    # Clone the code and checkout the necessary version
    git clone https://github.com/joyent/node.git
    cd node
    git checkout -b v0.10.28 v0.10.28
    
    # set -j to the number of CPU cores on the server + 1
    ./configure && make -j2 && sudo make install
    
    # update packages
    % sudo npm update
  2. Install Grunt CLI

    % sudo npm install -g grunt-cli
  3. Install Bower

    % sudo npm install -g bower

Install files for browser-based staff client

  1. Building, Testing, Minification: The remaining steps all take place within the staff JS web root:

    cd $EVERGREEN_ROOT/Open-ILS/web/js/ui/default/staff/
  2. Install Project-local Dependencies. npm inspects the package.json file for dependencies and fetches them from the Node package network.

    npm install   # fetch Grunt dependencies
    bower install # fetch JS dependencies
  3. Run the build script.

    # build, run tests, concat+minify
    grunt all