Refactor:
[jabaws.git] / TODO.txt
1 TODO: \r
2 \r
3 add to help text: To disable a web service remove it from WEB-INF/sun-jaxws.xml descriptor\r
4 \r
5 add to help: VirtualBox 4.0.4 works fine with JABAWS update links \r
6 \r
7 rename jaba.war to jabaws.war and make sure jabaws context path is used throughout. \r
8 \r
9 Current stat collector has to rely on file dates! \r
10 \r
11 Test all WS as names from Executables were removed\r
12 \r
13 Add default names for input and output in every executable and use them consistently\r
14 throughts (e.g. in all WS). Best of all use the same name from SceletalExectuable \r
15 For statistics. \r
16 \r
17 FIXME: \r
18 Conecting to JABAWS version 2 service\r
19 09-Feb-2011 15:27:53 compbio.ws.client.Jws2Client connect\r
20 INFO: Connected successfully!\r
21 Exception in thread "main" java.lang.NullPointerException\r
22         at compbio.ws.client.MetadataHelper.getParametersList(MetadataHelper.java:30)\r
23         at compbio.ws.client.Jws2Client.<init>(Jws2Client.java:179)\r
24         at compbio.ws.client.Jws2Client.main(Jws2Client.java:483)\r
25         \r
26 ScoreManager should output scores properly \r
27 \r
28 Allow empty Parameters and Preset files! \r
29 \r
30 Check the WS input and reject it on submission rather then of access with error message\r
31 \r
32 Globprot need a proper reference to bio python and sav_gol binaries -> they should be \r
33 somehow taken from disembl. \r
34 \r
35 Add registry service to query services status\r
36 \r
37 Refactor web services checker to enable a programmatic access to its methods.\r
38 Rename it to avoid confusion with jabaws client\r
39 \r
40 Finish the client\r
41 \r
42 Add interface for Jalview annotation \r
43 Add the method to return Jalview Annotation to SequenceAnnotation IF  \r
44 \r
45 Develop generic Interface to return Jalview annotation for easy to add new \r
46 services (?) \r
47 \r
48 Replace conservation.Method with server.ws.Method \r
49 and try building WS. If this does not work - get rid of Method\r
50 \r
51 Output file parsing for stat reporting\r
52 cluster engine stat of www-jws2 user\r
53 \r
54 integrate the above to tweak the size of the local job\r
55 \r
56 Add AACon ws\r
57 Add iupred ws http://iupred.enzim.hu/\r
58 Add globprot ws - does not report raw scores, just regions\r
59 Add ronn ws\r
60 \r
61 Philogeny Mrbayes + Philip\r
62  \r
63 USE CASE - TURN ALIGNMENT INTO PROFILE AND SEARCH SEQUENCE DATABASE USECASE\r
64 - Receive user alignment \r
65 - use hmmerbuild to turn it to profile\r
66 - use hmmersearch to search the database \r
67 \r
68 #END OF - TURN ALIGNMENT INTO PROFILE AND SEARCH SEQUENCE DATABASE USECASE \r
69 \r
70 New data model for representing psiblast,blast,phmmer,jackhmmer results\r
71 \r
72 new parsers for the above programmes output (Stockholm MSA format?)\r
73 \r
74 Think hard on what to do with large output files? \r
75 e.g. serve the hits table in full, but retrieve alignments on demand.\r
76 What actually needs to be sent?   \r
77 \r
78 Add facility to distribute other results of the calculations like the trees and \r
79 annotation file for probcons. \r
80 \r
81 # END OF SEARCHING SEQUENCE DATABASE USECASE\r
82 \r
83 Good toString method for Limits (test with command line client -limits)\r
84 \r
85 JABA DOCS\r
86 (later) Define limits for presets - if required\r
87 (later) Add documentation on Presets, Parameters and Limits\r
88 (later) Explain how to define a limit\r
89 \r
90 Add test for repeated result collection from cluster engine\r
91 \r
92 (low) Pack the test cases and build file to run them in one of the distributives \r
93 \r
94 (low) Add logging facility to WSTester so more details of the problem can be reported\r
95 \r
96 (low) Statistics collector for engines (number of operations/timing)\r
97 \r
98 (later) WRAP Amps\r
99 \r
100 (later) Implement utility to rerun died tasks\r
101 \r
102 (later) Add recognition for executables for the different architectures\r
103 \r
104 (later) use Latch to manage engine reservations. Reservations for parallel jobs? \r
105 \r
106 DONE\r
107 WILL NOT DO: Progress bars - needs assessing how long does it take to run a task\r
108 DONE: LocalExecutor service must be shutdown on web application undeploy event not on JVM shutdown. \r
109       This is because JVM is still running even after web application is shut down!\r
110 DONE: Use absolute path for web site download links as archives are not included into distro!\r
111 DONE: Rearrange web site docs - add links to the top of the page to the topics discussed below\r
112 DONE: Put the documentation for various executables online\r
113 DONE: Make left gradient image one-two characters larger + change "For developer ->For Developers"\r
114 DONE: test local/cluster execution - test Load balancer\r
115 DONE: Improve SimpleWS client so it can be scripted against: give user alignment and accept parameters\r
116 DONE: Make a configuration tester class (check that configuration files point to the executables, and they can be executed)\r
117 DONE: PUT CLIENT JAR INTO WEB-INF/LIB - most likely need to get rid of dist prefix in the build file\r
118 DONE: Different packages for download and dundee. generic vs specific settings. \r
119 DONE: JAVADOC\r
120 DONE: Refactor EngineResourcesLeak tester to hide a map implementation!\r
121 DONE: Compile executables for linux in the most generic way\r
122 DONE: Make different log4j configuration files / web services logs.\r
123 DONE: System manual\r
124 DONE: Developer doc\r
125 DONE: How to\r
126 DONE: Prepare different packages\r
127 DONE: extract commonly used names into variable in the build script\r
128 DONE: Test for high load conditions (TestNG?)\r
129 DONE: (low) Fix: Started jobs with unknown completion status reported as FINISHED by  msaws.getJobStatus(taskId) (see SimpleWSClient)\r
130 DONE: fix compile binaries script\r
131 DONE: Make script to change executable flag for linux systems\r
132 DONE: jobsout must be created within war\r
133 DONE: enable relative paths for local engine conf temp dir\r
134 COUND NOT REPRODUCE: fix cluster job status - RUNNING -> UNDEFINED\r
135 DONE: throw JobSubmission exception with appropriate method instead - (low) code discoverer/tester for ws - e.g. after war deployment to find out what actually works\r
136 DONE: fix build scripts after reorganising project\r
137 DONE: package as war file for deployment\r
138 DONE: package for jalview distro for local execution\r
139 DONE: reorganise project into independent chunks\r
140 DONE: test Parameter & Option toCommand method\r
141 DONE: Replace WS methods with new CommandBuilder.toCommand()\r
142 DONE: Setting default values is validated as external method \r
143 DONE: Refactoring to extract data model, and engines is performed\r
144 DONE: Default value is adopted for passing new Option values to server side\r
145 DONE: Converting Options to commands delegated to CommandBuilder  \r
146 DONE: Make Arguments mutable to facilitate default value setting for WS\r
147 DONE: Matrix files for alignment programme\r
148 DONE: Clean up testcases\r
149 DONE: Replace List<String> as command line parameters abstraction to dedicated CommandBuilder class \r
150 DONE: Parallel execution for tcoffee jobs\r
151 DONE: Copyright added\r
152 DONE: WRAP ProbCons\r
153 DONE: think about time limits and cluster parameters for parallel execution - NativeSpecs for cluster is implemented\r
154 DONE: (low) Use for WS: (@WebParam(name = "name") String name) {\r
155 DONE: Implement rough policy for runtimes (e.g. do not run excessively long tasks on the local machine if cluster is available)\r
156 DONE: Write tomcat conf to expose WS\r
157 DONE: access control to web.xml\r
158 DONE: Statistics collector for WS\r
159 DONE: implements limits for web services\r
160 DONE: WS clients must be able to connect to a web service given the service url. \r
161 e.i. ws URL should not be compiled in using wsimport, but determined from \r
162 the configuration file.  \r
163 \r
164 DONE: Could not find configuration files if run from within servlet container\r
165 DONE: Add ways to get engine based on the key for everything but submission of the new tasks \r
166 DONE: Add cache to Cluster JOBID - so that at least jobs for which results have not been collected is cached.\r
167 DONE: FINISHED overrides FINISHED with time stamp!\r
168 DONE: Consider think about JobStatus and StatFileStatus\r
169 DONE: a method to read 3 chars at the beginning of the file to indicate a progress is added\r
170 DONE: ConfiguredExecutable<?> al = sexec.getResults(jobId); || Alignment ?\r
171 DONE: ClustalW - OUTput must be set !\r
172 DONE: Add accessor methods to get a DUMP of the process output \r
173 DONE: FilePuller should be cached to avoid excessive fs exercise\r
174 DONE: Test List of the processes (ensure no memory leaks)\r
175 PART DONE - On the client on shutdown remember the task list - server tasks could be loaded and executed from saved run configurations, client should decide for themselves what they want\r
176 DONE: Persist the task list to enable later result collection on the server side\r
177 DONE Wrap TCoffee\r
178 DONE: improve parameters handling - new schema + update for all parameters\r
179 DONE: Cluster jobs report submitting and result collecting/finishing time (for sync jobs only(!)) and cluster jobid in the corresponding files  \r
180 DONE: Local jobs report starting and finising times in files with corresponding names in the task directory  \r
181 DONE: Generalize getResult method for MSA runners\r
182 DONE: Create test suits\r
183 DONE: Convert junit tests to TestNG\r
184 DONE: Redirect output & error streams to the named files as some processed need this  \r
185 DONE: Extract generilyzed class with most of the method for individual executable to use\r
186 DONE: Refit wrappers to use the generalised class to avoid duplication  \r
187 DONE: Pass environment variable settings to the executable\r
188 DONE: Complete AsyncExecutors implementation\r
189 DONE: Look to unify methods for engines\r
190 DONE: Provide way around of generated directory setup for test cases(?)\r
191 DONE: Fix the test cases for local engine (need to set directory on executable explicitly)\r
192 DONE: Make log files for processes err and out for local execution\r
193 DONE: Trace where AsyncExcel called with null Executable and attempts to create a new directory repeatedly\r
194 DONE: directory generator\r
195 DONE: tests for cancel \r
196 DONE tests for getStatus\r
197 DONE  ws async\r
198 DONE: parametrized clustal operations\r
199 DONE: test large datasets handling \r
200 DONE: write load balancer \r
201 DONE: (low) task persistance\r
202 DONE: Look at CancellableTask if with Sync and AsyncExecutor \r