[revert to earlier state of local install directions. cabalization didn't work, the templates get left behind thomashartman1@gmail.com**20080625030457] hunk ./templates/run-tutorial-locally.st 5 -

This tutorial is cabalized. You can install and run it simply by doing: sudo cabal install happs-tutorial. You should then be able to run the resulting binary and view the tutorial offline at http://localhost:5001.

+

Assuming the basics are in place, you can install and run this tutorial locally as follows

hunk ./templates/run-tutorial-locally.st 7 -

The cabal installation may take up to an hour, mainly because the HAppS-Server installation is slow, but it should succeed in one shot. Incidentally, the fact that installing HAppS takes this long is arguably a bug. Hopefully this situation will be remedied as HAppS matures and, eventually, has an official release

- -

If you've never used cabal install or need more detailed info....

hunk ./templates/run-tutorial-locally.st 9 -
  • Haskell: You need at least ghc 6.8.2 to install HAppS. I installed this with with apt-get install haskell (works for ubuntu hardy heron), and then upgraded to ghc 6.8.3 as this is supposed to have fixed some bugs.
    • -
  • Dependency chasing haskell package installers: you should have the latest versions of cabal and cabal install from hackage. These are already included in the latest version of ghc, or they will be soon. Another reason to upgrade to ghc 6.8.3.
    • -
  • If you want to check out the latest version of this tutorial, install Darcs and check out the repo with darcs get http://code.haskell.org/happs-examples
    • -
  • cabal installs the tutorial at /home/yourdir/.cabal/bin/happs-tutorial. In practice, I usually recompile and run changed code by executing ./runServer.sh, in the top project directory.
    • -
  • You should now be able to browse this tutorial offline by running the executable, and opening http://localhost:5001 in your browser.
    • +
  • Install Darcs: a version control tool you need to check out this source. I installed this with sudo apt-get install darcs
    • +
  • Haskell: You need at least ghc 6.8.2 to install HAppS. I installed this with with apt-get install haskell, and then upgraded to ghc 6.8.3 as this is supposed to have fixed some bugs.
    • +
  • Dependency chasing haskell package installers: you should have the latest versions of cabal and cabal install from hackage. These are already included in the latest version of ghc, or they will be soon.. another reason to upgrade to the latest ghc.
    • +
  • HAppS: Once you have cabal install working, you should be able to install the HAppS packages in one shot, with all dependencies getting chased down automatically, without any babysitting. On ubuntu, I did this with
      time sudo cabal-install HAppS-Server
    This takes a while, which is why I like to install with the time command as above -- when it's done it tells me how long the whole process has taken. Lately, running this command has been taking up to an hour, so I recommend brewing some tea or going for a walk or something. By the way, the fact that installing HAppS takes this long is arguably a bug. Hopefully this situation will be remedied as HAppS matures and, eventually, has an official release.
    • + +
  • Get the source for this tutorial: darcs get http://code.haskell.org/happs-examples
    • +
  • Run the tutorial server locally
      cd happs-examples; ./runServer.sh
    • +
  • You should now be able to brows this tutorial locally by opening a browser and going to http://localhost:5001/tutorial/home