README.win

   1 Hatch - Java Print / Storage / Etc Service
   2
   3 ** ROUGH SETUP NOTES **
   4
   5 !!! TODO: refactor these for hatch-as-native-messaging-host changes !!!
   6
   7 Install Hatch on your desktop -- Windows edition:
   8
   9 If you're reading this online, first download hatch to your desktop.
  10
  11 The canonical location for this project is:
  12 http://git.evergreen-ils.org/?p=Hatch.git
  13
  14 But a convenient snapshot as of 2015-08-20 is here:
  15 https://github.com/phasefx/random/archive/hatch.zip
  16
  17 Unzip the file wherever you'd like to install the application, such as in C:\Program Files\
  18
  19 Then go to http://download.eclipse.org/jetty/
  20
  21 Download the latest stable-9 .zip version into the same directory as this README file.
  22
  23 Unzip and rename the folder to "jetty".
  24
  25 Then go to http://www.oracle.com/technetwork/java/javase/downloads/jdk8-downloads-2133151.html
  26
  27 Download the Development Kit .exe for your version of Windows.
  28
  29 Install it.
  30
  31 In the same directory as this README file, create a subdirectory named "lib".
  32
  33 Then go to http://mvnrepository.com/artifact/org.eclipse.jetty/jetty-util-ajax
  34
  35 Download the latest 9.2.x .jar file into the "lib" directory.
  36
  37 Create a dummy SSL certificate for Jetty.
  38 For step 2, modify the JDK path to match your version/location.
  39 The password used when creating the certicate will have to be added
  40 to hatch.xml, unless you use "password".
  41 1. cd jetty\etc
  42 2. C:\"Program Files"\Java\jdk1.8.0_60\bin\keytool.exe -keystore keystore -alias jetty -genkey -keyalg RSA
  43
  44 Edit the run-win.bat file, and, if needed, change the JAVA_HOME variable to the location where you installed the Java Development Kit.  In my case, I changed the line:
  45
  46 SET JAVA_HOME="C:\Program Files\Java\jdk1.8.0_20"
  47
  48 to
  49
  50 SET JAVA_HOME="C:\Program Files\Java\jdk1.8.0_31"
  51
  52 Then open a Command window and cd into the same directory as this README file.  One easy way to do this is to click into the address of the bar of window displaying the directory, typing "cmd" and pressing enter.
  53
  54 Then enter:
  55 run-win.bat
  56
  57 Choose Allow for any Firewall/Security prompt.
  58
  59 Then go to https://localhost:8443/ in Chrome and click through the security warning.
  60 (In my case, I clicked on the link "Advanced" and then "Proceed to localhost (unsafe)")
  61
  62 You should expect a 404 Not Found page.
  63
  64 Then open the browser client.
  65
  66 Set "This workstation uses a remote print / storage service ("Hatch")?" under Admin -> Workstation
  67
  68 Optionally configure / test printing