| 1 | 
 ajm | 
 1.1 | 
 i-scream Conient Client README | 
 
 
 
 
 
 | 2 | 
   | 
   | 
 ============================== | 
 
 
 
 
 
 | 3 | 
   | 
   | 
  | 
 
 
 
 
 
 | 4 | 
   | 
   | 
 Compiling | 
 
 
 
 
 
 | 5 | 
   | 
   | 
 --------- | 
 
 
 
 
 
 | 6 | 
   | 
   | 
  | 
 
 
 
 
 
 | 7 | 
   | 
   | 
 Conient can now easily be compiled without worrying about setting up any | 
 
 
 
 
 
 | 8 | 
   | 
   | 
 of the CLASSPATH's. It's all self contained. | 
 
 
 
 
 
 | 9 | 
   | 
   | 
  | 
 
 
 
 
 
 | 10 | 
   | 
   | 
 Typical sequence to compile; | 
 
 
 
 
 
 | 11 | 
   | 
   | 
  | 
 
 
 
 
 
 | 12 | 
   | 
   | 
 ./configure | 
 
 
 
 
 
 | 13 | 
   | 
   | 
 make build | 
 
 
 
 
 
 | 14 | 
   | 
   | 
 make install prefix=/some/path | 
 
 
 
 
 
 | 15 | 
   | 
   | 
 make clean | 
 
 
 
 
 
 | 16 | 
   | 
   | 
  | 
 
 
 
 
 
 | 17 | 
   | 
   | 
 In more detail, the first line ensures that the required libraries are | 
 
 
 
 
 
 | 18 | 
   | 
   | 
 available, and sets the Makefiles up so they know where everything is. | 
 
 
 
 
 
 | 19 | 
   | 
   | 
 The second line compiles all of the code and creates a JAR file in the | 
 
 
 
 
 
 | 20 | 
   | 
   | 
 build directory. | 
 
 
 
 
 
 | 21 | 
   | 
   | 
 The install line installs the server and libraries to a given location, | 
 
 
 
 
 
 | 22 | 
   | 
   | 
 along with the configuration files. | 
 
 
 
 
 
 | 23 | 
   | 
   | 
 Finally, the last line cleans up. | 
 
 
 
 
 
 | 24 | 
   | 
   | 
  | 
 
 
 
 
 
 | 25 | 
   | 
   | 
 Running | 
 
 
 
 
 
 | 26 | 
   | 
   | 
 ------- | 
 
 
 
 
 
 | 27 | 
   | 
   | 
  | 
 
 
 
 
 
 | 28 | 
   | 
   | 
 Simply typing "make run" will start Conient. | 
 
 
 
 
 
 | 29 | 
   | 
   | 
  | 
 
 
 
 
 
 | 30 | 
   | 
   | 
 Once configuration issues have been solved, you will be able to specify | 
 
 
 
 
 
 | 31 | 
   | 
   | 
 a configuration file on startup. | 
 
 
 
 
 
 | 32 | 
   | 
   | 
  | 
 
 
 
 
 
 | 33 | 
   | 
   | 
 Makefile | 
 
 
 
 
 
 | 34 | 
   | 
   | 
 ======== | 
 
 
 
 
 
 | 35 | 
   | 
   | 
 The following targets are available; | 
 
 
 
 
 
 | 36 | 
   | 
   | 
  | 
 
 
 
 
 
 | 37 | 
   | 
   | 
 build | 
 
 
 
 
 
 | 38 | 
   | 
   | 
  | 
 
 
 
 
 
 | 39 | 
   | 
   | 
   Compile the entire Conient package. Generates the | 
 
 
 
 
 
 | 40 | 
   | 
   | 
   JAR file for the final package. | 
 
 
 
 
 
 | 41 | 
   | 
   | 
  | 
 
 
 
 
 
 | 42 | 
   | 
   | 
 run | 
 
 
 
 
 
 | 43 | 
   | 
   | 
  | 
 
 
 
 
 
 | 44 | 
   | 
   | 
   Run's Conient from the JAR file in /build. | 
 
 
 
 
 
 | 45 | 
   | 
   | 
  | 
 
 
 
 
 
 | 46 | 
   | 
   | 
 clean | 
 
 
 
 
 
 | 47 | 
   | 
   | 
  | 
 
 
 
 
 
 | 48 | 
   | 
   | 
   Cleans all compiled code, and javadoc pages. | 
 
 
 
 
 
 | 49 | 
   | 
   | 
  | 
 
 
 
 
 
 | 50 | 
   | 
   | 
 distclean | 
 
 
 
 
 
 | 51 | 
   | 
   | 
  | 
 
 
 
 
 
 | 52 | 
   | 
   | 
   Also cleans files left by configure, including the libraries. | 
 
 
 
 
 
 | 53 | 
   | 
   | 
  | 
 
 
 
 
 
 | 54 | 
   | 
   | 
 install | 
 
 
 
 
 
 | 55 | 
   | 
   | 
  | 
 
 
 
 
 
 | 56 | 
   | 
   | 
   Installs Conient to a given directory. Also takes a prefix; | 
 
 
 
 
 
 | 57 | 
   | 
   | 
     make install prefix = /usr/i-scream | 
 
 
 
 
 
 | 58 | 
   | 
   | 
  | 
 
 
 
 
 
 | 59 | 
   | 
   | 
 cvsbuild | 
 
 
 
 
 
 | 60 | 
   | 
   | 
  | 
 
 
 
 
 
 | 61 | 
   | 
   | 
   Builds any tagged version of Conient from CVS. This saves the need to | 
 
 
 
 
 
 | 62 | 
   | 
   | 
   checkout a version to build it, as it's all done automatically; | 
 
 
 
 
 
 | 63 | 
   | 
   | 
     make install rev = RELEASE_1 | 
 
 
 
 
 
 | 64 | 
   | 
   | 
   Default tag is HEAD. | 
 
 
 
 
 
 | 65 | 
   | 
   | 
  | 
 
 
 
 
 
 | 66 | 
   | 
   | 
 javadoc | 
 
 
 
 
 
 | 67 | 
   | 
   | 
  | 
 
 
 
 
 
 | 68 | 
   | 
   | 
   Builds all the javadoc pages in the `doc' directory. |