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