Search this site

Installation

The easiest way to install Pintura is download a Persevere 2.0 distribution:
  1. Download the persevereJSGI archive from http://www.persvr.org/nightly/ and unzip it into a directory without any spaces in its path.
  2. Go into persevereJSGI/narwhal directory
  3. bin/sea
  4. Now you can go to Running the Example
Alternately, you can download the Pintura package and its dependencies. Pintura is dependent on several CommonJS packages. Pintura is designed to work with Narwhal's Tusk installer. However, Pintura currently depends on forks of some of the dependent projects, so package-based installation is currently done by manually downloading each of the necessary packages (the installation process will be greatly improved in the future with package management and/or nightly builds):
  1. Download and unzip http://github.com/kriszyp/narwhal/zipball/master
  2. Put Narwhal on your PATH environment variable.
    • export PATH=$PATH:~/narwhal/bin, or
    • or go into narwhal director and do:
      bin/sea
  3. Move into the packages directory in Narwhal, and download and unzip:
  4. http://github.com/kriszyp/commonjs-utils/zipball/master into a directory "commonjs-utils"
  5. http://github.com/kriskowal/narcissus/zipball/master into a directory "narcissus"
  6. http://github.com/kriszyp/perstore/zipball/master into a directory "perstore"
  7. http://github.com/kriszyp/pintura/zipball/master into a directory "pintura"
  8. http://github.com/kriskowal/wiky/zipball/master into a directory "wiky"
  9. If you want to run Pintura on Node: http://github.com/kriszyp/jsgi-node/zipball/master into a directory "jsgi-node"
  10. http://github.com/kriszyp/jack/zipball/master into a directory "jack"
  11. If you want to run on Jack, copy packages/jack/bin/* into narwhal's bin directory

* Note that it is recommended that you use a Sun implementation of Java if you will be running on Jack (Node doesn't use Java). If your system defaults to a non-Sun Java runtime, you can do:
sudo update-java-alternatives --set java-6-sun

Running the Example

Pintura is designed to run various CommonJS/JSGI servers. To run the example Wiki application, go into the example directory (should be in the root directory if you did a nightly, it will be under narwhal/packages/pintura if you did package-based install) and run:

bin/sea

(Yes, you really do need to executed bin/sea twice, once in narwhal, and once in the example directory).
Then to start the server:
  • Jack:
    jackup

  • Node (requires Node 0.1.25 or higher):
    node start-node.js
You should now be able to access the Wiki application at http://localhost:8080/. You will need to enter a username and password and click "Register" and then "Login" to begin editing.