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