how_to_add_new_webservice.txt

   1 How To add a new executable\r
   2 \r
   3 1) Add executable to the binaries folder. If it has source code and can be recompiled for different platforms include it under binaries/src \r
   4 Edit binaries/src setexecutableflag.sh and compilebin.sh scripts accordingly. \r
   5 \r
   6 2) Make sure all the dependencies of the software being installed are satisfied. If there are other binaries they should be included as well. Keep the dependant binaries in subfolder for the main executable. Update compily and setexecflag scripts accordigly. \r
   7 \r
   8 3) Make sure executable \r
   9    - Does not have any hard links to its dependencies, e.g. is able to run from any installation folder and does not contain any hardcoded paths. (TODO examples...) \r
  10 \r
  11 4) Describe executable in conf/Exectuable.properties. \r
  12 \r
  13 5) Add <ExecutableName>Limit.xml, <ExecutableName>Parameters.xml and <ExecutableName>Presets.xml. All but Limits are optional. \r
  14 \r
  15 6) Create a Java wrapper class for your executable. Create it within runner source directory.\r
  16 \r
  17 7) Create a testcase suit for your wrapper and run the test cases. \r
  18 \r
  19 8) Create parser for the output files of your executable. Suggested location compbio.data.sequence.SequenceUtil  \r
  20 \r
  21 9) Test the parser\r
  22 \r
  23 10) Decide which interface your executable is going to match. \r
  24     For example it what the executable produces can be represented as Annotations \r
  25     to the sequence file or alignment, then SequenceAnnotation interface might be appropriate. \r
  26     For multiple sequence alignment an Msa interface should be used. \r
  27 \r
  28 11) If matching interface is found, then implement a web service confirming to it within \r
  29     a webservices source folder \r
  30 \r
  31 12) Register web service in WEB-INF/ web.xml and sun-jaxws.xml\r
  32 \r
  33 13) Modify the client to work with your web service. \r
  34 \r
  35 14) Test. \r
  36 \r
  37 15) Testing on the cluster...\r
  38 \r
  39 \r
  40 \r
  41 \r
  42 If executable does not support parameters do not add a reference to the XXXParameter.xml \r
  43 file into the Executable.properties file. Do the same for Presets\r
  44 \r
  45 \r
  46  \r
  47 \r
  48 \r