Nirmal, I will certainly try. It should not take too much time since this would be mostly moving stuff around - when we added J2C provider we also posted quite a substantial architecture document. It still is in proposals directory and I will move it to doc. Maybe you could have a quick look at it and let me know whether is good enough or I should make some changes. Thank you,
Piotr. Regards, Piotr Przybylski Connector Tools and Architecture IBM Toronto Lab Phone: 905-413-3688, T/L: 969-3688 Internet: [EMAIL PROTECTED] Nirmal Mukhi/Watson/IBM@ To: Piotr Przybylski/Toronto/IBM@IBMCA IBMUS cc: [EMAIL PROTECTED] Subject: Documenting JCA binding 12/13/2002 01:53 PM Please respond to axis-dev Hi Piotr, One of the relase tasks (see java/doc/RELEASE_TASKS.txt) that nobody has signed up for is documenting the JCA binding extensions, along the lines of the current documentation for the java, JMS and EJB bindings (see for example http://cvs.apache.org/viewcvs.cgi/*checkout*/xml-axis-wsif/java/doc/wsdl_extensions/ejb_extension.html ). Of course you are best qualified to do this, do you tihnk you will have the time to do it next week? Nirmal. [EMAIL PROTECTED] To: [EMAIL PROTECTED] 12/12/2002 02:15 PM cc: Please respond to axis-dev Subject: Re: [wsif] today chat log Hi, sorry I missed the chat today. I definitely agree that including J2C samples would help to show the capabilities of wsif. I will work on these in the next few days and should have them ready by mid next week. The sample for j2c provider is actually two parts, a J2C Resource Adapter with the extensions to use wsif j2c provider and then the actual sample i.e. a proxy and format handlers that invoke particular service of the EIS. The former was included in the initial drop of j2c provider (and still is in proposals) in the MyEIS.rar file, a connector archive with all the sources. What I need to do there is to add the rar contents as the source tree and write build scripts to create RAR file and then add the second part of the sample. Thank you, Piotr. Regards, Piotr Przybylski, IBM Connector Tools and Architecture Aleksander Slominski To: "[EMAIL PROTECTED]" <[EMAIL PROTECTED]> <[EMAIL PROTECTED] cc: .edu> Subject: [wsif] today chat log 12/12/2002 11:57 AM Please respond to axis-dev hi, we have discussed topics related to release: * check RELEASE_TASKS.txt and modify accordingly and pick up taks (we need them all taken care of and avoid possible overlaps) * next chat on Monday and beta release next week * check current 2.0alpha2 release and report problems * check if we can distribute all jar files * samples (we need to decide what does in and what is not to be in release -as nobody works on JCA or EJB samples AFAIK) * samples are crucial to show what WSIF can do and how to use it * we need sample for EJB * we need sample for JMS/SOAP * we need sample for JCA * documentation: we have most of it now but some reading/checking will only make it better * document each sample (Nirmal is doing great work here both writing and documenting samples) * we need more people to check documentation * document WSIF code and give higher level docs than just Javadocs * Forrest proposal check in into proposals directory in CVS * fix remaining critical bugs [Ant: it seems we have only one with Axis provider] * if possible no code changes until we have release unless it is bug fix ... * how to structure jar dependencies (subdirectories or everything in one directory) [to be resolved later] thanks, alek [10:33] <nirmal> Alek, why don't you start? [10:34] <alek_s> sorry [10:34] <alek_s> was gone for few minutes [10:34] <alek_s> could we just revew RELEASE_PLAN? [10:34] <alek_s> can we do it by the end of this week? [10:34] <nirmal> ok [10:35] <nirmal> the final relase - end of next week! [10:35] <nirmal> not this week [10:35] <hughesj> right ... we want beta this week [10:35] <nirmal> I think it is possible to do beta tomorrow and final release end of next week as we planned [10:36] <alek_s> i think this too [10:36] <alek_s> however looking on RELEASE_TASKS.txt [10:36] <antElder> I don't think the doc is ready for a beta yet, specifically the web site [10:36] <alek_s> there is plenty that nobody works on [10:36] <alek_s> we either take soem tasks or ditch them ... [10:36] <hughesj> we need something for web site up before declaring ebta [10:37] <antElder> Owen has been working on a new site based on Forest [10:37] <alek_s> i think if we add wsif directory under axis to xml-site it should work? [10:37] <alek_s> ok Forrest sounds even better [10:37] <antElder> but to use that we really need to convert all the existing html [10:37] <alek_s> what is ETA? [10:37] <hughesj> will some portion of that be ready for tomorrow? [10:38] <alek_s> me personally i really like simplicity of editing HTML files ... [10:38] <antElder> the Forest xml is real simple [10:39] <hughesj> when it comes to navigators (a good thing from a usability point of view) forrest has to be easier than creating them ourselves in raw html [10:39] <hughesj> lets face it ... what people expect from web sites nowadays is more than something we can knock up simply in raw hand crafted html [10:39] <hughesj> Owen, could you check up what there is [10:39] <alek_s> i do not write raw html ... [10:40] <hughesj> then perhaps we could split the tasks [10:40] <alek_s> but i can write raw xml ... [10:40] <antElder> I'd like for Owen to make accessable the 1st page he's done so everyone can see it [10:40] <nirmal> That sounds good, I'd like to see it (the final page and the raw XML) [10:40] <hughesj> Owen is there a way of 'testing' the html generated by xml-site locally before waiting for xml.apache.org to catch up? [10:41] <alek_s> me too: to have some idea what it will look like and how to use it [10:41] <nirmal> However, can we create xml.apache.org/axis/wsif and populate it with our current HTML docs for now? [10:41] <owenb> I could check up the html that forrest has generated - I've only done one page fully so far but it would give an idea. Ultimately we'd want to check up the xml files and have the site built by forrest when xml-site gets built [10:41] <antElder> then if we decided to go with that everyone can start moving html to it. There's to mcuh now for Owen to do all [10:41] <nirmal> right - I'm thinking this is a post-2.0 task [10:41] <alek_s> thne maybe we should wait with "Forrest"-ation until next release? [10:42] <alek_s> (the same thining as nirmal :-)) [10:42] <owenb> Where should I "dump" the html I've generated? [10:42] <antElder> I really don't think what we have now is good enough [10:42] <nirmal> for now why don't you put it under proposals? [10:43] <hughesj> we have a link to WSIF on xml.apache.org/axis ... are we deciding to make a simple web page from that [10:43] <owenb> ok I'll put the entire wsif forrest site under proposals and people can then play around with it on their machines [10:43] <hughesj> indicating we have a beta and if you want documentation then download it! [10:43] <nirmal> Ant, do feel strongly enough to delay releasing WSIF by say 3-4 weeks for the sake of better looking web pages? [10:43] <hughesj> perhaps that's what we should do ... but aim for a beta in the next few days [10:44] <hughesj> then there is maybe 3-4 weeks between beta and release [10:44] <hughesj> to get the web site info looking right [10:44] <antElder> lets look at what Owen has now, decide, and if we go with it we could get everything using it by next week [10:44] <nirmal> Jeremy: no, I think we should have a full fledged web site on xml.apache.org/axis/wsif - the HTML will be simple, like Axis and Apache SOAP [10:44] <antElder> it doesn't need to be generated with every build yet [10:44] <alek_s> i think that simple HTML for now is good [10:44] <hughesj> Nirmal: is that a beta statement ? [10:45] <antElder> 10 minutes to go, are there other issues besides the web site? [10:45] <alek_s> i have just updated RELEASE_TASKS.txt [10:45] <nirmal> I'm in favor of releasing next week, on xml.apache.org/axis/wsif, with full documentation that isn't so pretty looking, then putting Forrest in and doing a 2.0.x in Jan [10:45] <alek_s> split into high/medium/low [10:46] <alek_s> i think onlyu "high" are criticila for 2.0 release [10:46] <antElder> One thing I'd like is for all the jars we ddistribute to be in the lib dir not sub directories [10:46] <alek_s> +1 to releas enext week [10:46] <alek_s> if you put them into one liub direcotry you never knwo what are depnedencies (for example current AXIS needs servlet API on client side) [10:47] <hughesj> which out of the "high" are required for beta and which for final [10:47] <antElder> would you consider looking at what owen has ? [10:47] <alek_s> i will check what is proposals for sure [10:48] <antElder> so can we decide about what to do with the web site tomorrow then? [10:48] <nirmal> Ant I'm not doubting that Forrest will make things much better, but a functional (though not great looking) site like Axis is sufficient, we don't have to delay our first release for the sake of Forrest IMO [10:48] <alek_s> what matyters is _documentation_ [10:49] <alek_s> hjow it looks is secondary [10:49] <antElder> Ok firstly last time I tried the site wsn't functional [10:49] <alek_s> as good documentation is always better than non existing documentation (that will look good in future) ... [10:49] <antElder> so it needs fixing now [10:49] <antElder> and forest looks so easy why not use that if we can [10:50] <nirmal> I completely agree with that Ant [10:50] <antElder> maybe we can't, lets see what goes in proposals and how much work we think it would be [10:51] <nirmal> What needs to be fixed is: addition of content, better organization - that comes first. Whether the presentation is done using Forrest or HTML directly is secondary [10:51] <antElder> so the jars in lib, what do others think? [10:51] <alek_s> what you think: are there any other things to do for first official relelease? [10:51] <alek_s> i have seen some checking - what is status of code? [10:51] <hughesj> the jars in lib ... why are we doing that ... Axis doesn't [10:52] <alek_s> from current RELEASE_TASKS [10:52] <nirmal> The samples are going slowly, I'm just starting on the J2EE ones (JCA, JMS, EJB) and may need help - I'll might ask for help next week if things aren't done by Monday [10:52] <owenb> Here's something - the binary distribution of WSIF should not have our testcases in it [10:52] <alek_s> * [owen] investigate using Forrest for creating separate pages for WSIF outside Axis [10:52] <alek_s> * [nirmal + alek] samples and modularization [10:52] <alek_s> * make sure that all dependencies are documented [10:52] <alek_s> * [nirmal + alek] document how to run samples (step by step) [10:52] <alek_s> * [nirmal + alek] document how to build (step by step) [10:52] <alek_s> should there be code freeze ... [10:52] <alek_s> i have removed testcases source code from bin distribution [10:52] <antElder> yes btw RCx and final [10:53] <hughesj> Owen can you add that to the high priority items in RELEASE_TASKS.txt [10:53] <nirmal> ok, so code freeze prior to RC1, which I'm guessing might be on Wednesday... [10:53] <alek_s> Jeremy: i have restructure lib to amke it easy to pick lib for packages you want to compile with and to make easier to plug inany JAR files you want [10:53] <hughesj> oh alek you did that already sorry [10:54] <owenb> Jeremy - add what to the list? [10:54] <hughesj> I'm nervous about saaj.jar ... we shouldn't be redistributing that because it has a Sun license [10:54] <hughesj> don't you think? [10:54] <nirmal> If we find out that Forrest is easy to do I'm willing to spend significant time fixing the docs next week [10:54] <antElder> axis has saaj.jar doesn't it? [10:54] <nirmal> Axis distributes it, right? But you're right we can't distribute if it has a Sun license [10:54] <alek_s> i have copied saaj from AXIS binary distribution (and made note about it in README.txt)! [10:55] <alek_s> if they can distribute we can too! [10:55] <antElder> yes just checked it does [10:55] <hughesj> ah yes, Axis does distribute it hmmmmm [10:55] <nirmal> Alek could you check with someone on Axis about that - Dims or Sam I would think might know [10:56] <alek_s> ok i will do it [10:56] <antElder> so what do others think about having all the jars in lib, or many subdirs? [10:56] <hughesj> plus any others that aren't Apache license I guess [10:57] <hughesj> Alek ... what are your guidelines about whether a jar should be in our CVS / our bindist ? [10:57] <alek_s> i am against as it makes extremely hard ot create useful depenedencies - example when you need two different versions of the same package like log4j ... [10:58] <hughesj> I guess it's nice to have xerces but this makes the package larger and people probably already have xerces. Axis doesn't ship xerces in bindist [10:59] <nirmal> I'm in favor of including everything we are legally allowed to with the bin dist [10:59] <alek_s> without xerces you *can not* compile WSIF now (serializer) [10:59] <antElder> so 4pm, and it looks like there's to issues: [10:59] <antElder> - the web site [11:00] <antElder> - jars we distribute [11:00] <alek_s> otherwise i would just include XML APIs - but having Xerces is nice to simplify build [11:01] <alek_s> in general we have two major problems: samples and documentation [11:01] <hughesj> alek ... are you saying the user can't compile the sample code without Xerces [11:01] <alek_s> yes [11:01] <alek_s> (to be precise can not compiel WSIF - i did not check just sampels) [11:01] <hughesj> that's probably true with Axis samples and they don't ship Xerces [11:01] <hughesj> oh right [11:01] <hughesj> but the people downloading bindist won't be compiling WSIF [11:02] <hughesj> timeout! [11:02] <antElder> the jms provider uses xerces classes [11:02] <antElder> alek mentioned it on axis-dev earlier [11:03] <alek_s> yes [11:03] <alek_s> i will submit it as a bug [11:04] <hughesj> Alek: if you are contacting Dims/Sam via axis-dev about what dependency jars we're allowed to ship then we can also discuss there whether we should be distributing other peoples jars since clearly Axis has a guideline and we are using a different one [11:04] <nirmal> I don't believe there is a Apache guideline or anything like that [11:04] <alek_s> in 1.0 bin dist AXIS jsut dropped all jar file into lib directory - no license or where they were obtained from and no version information too ... [11:05] <antElder> its very convenient to havethem all in lib [11:05] <antElder> i like that [11:05] <nirmal> And it there was I'd fight it - believe me, you have to make the WSIF dist now and use it, it's so incredibly simple with the scripts to set up classpath, build, etc. [11:06] <hughesj> ok [11:06] <nirmal> The main thing we are trying to do is get a new user to get the samples running in minimum possible time, so including all the jars we can is a very good thing [11:07] <hughesj> ok .... lets just check we're not redistributing something we shouldn't be [11:07] <nirmal> right, absolutely [11:07] <antElder> also I doubt we'd get the JMS provider fixed to not use xerces by next week [11:07] <nirmal> I think that's fine as long as we document it... [11:07] <nirmal> ok, can go over action items then? [11:09] <alek_s> yes [11:09] <alek_s> so i have for now: [11:09] <alek_s> * check if we cna distribute jar files [11:09] <alek_s> * Forrest proposal [11:09] <alek_s> * samples (we need to decide what does in and what is not to be in releeas -as nobody wworks on JCA or EJB samples AFAIK) [11:10] <alek_s> * documentation: we have most of it now but some reading/checking will not hurt [11:10] <alek_s> * if possible no code chnages until we have releleas unless it is bug fix ... [11:10] <antElder> I'm still working on the axis provider [11:10] <nirmal> Documentation needs to be reorganized mainly - especially the README page (I'll do it) [11:11] <nirmal> I think EJB, JCA, JMS samples are essential to show the value of WSIF - and the user doesn't have to run them if he doesn't want to [11:12] <nirmal> One important task now listed in RELASE_TASKS AFAIK: writing documentation for JCA binding [11:12] <alek_s> it is listed but has low priority ... [11:12] <nirmal> ok [11:12] <antElder> I agree with about ejb etc sanmples, but I don't think we can have them done by next week [11:13] <alek_s> so this will be beta release ... [11:13] <antElder> or a 2.0 release with not so much doc [11:13] <alek_s> i have only very vagua idea how EJB or JMS provider works and have never succeded running it or any tests :-( [11:13] <alek_s> .. otherwise i would write samle and docs for it [11:14] <nirmal> I've successfully used EJB provider so I think I can get that working - the hard part is providing enough information/deployment etc. files so it is easy to set up [11:14] <nirmal> I think JMS provider should be possible too - JCA is the only one I have no idea about [11:14] <nirmal> I'm working on EJB and JMS providers and plan (cross fingers) to have something by next week [11:15] <nirmal> s/providers/samples [11:15] <owenb> EJB provider is easy to use once you've set up the EJB but that's the hard bit or should I say the bit that's hard to describe [11:16] <owenb> Since it depends on what App server you are using [11:16] <nirmal> right [11:16] <nirmal> if all goes well I plan to include instructions for running on JBoss and WebSphere, but let's see... [11:16] <owenb> sounds good [11:17] <alek_s> Ant: why do you wan to have all jar files in lib directory? [11:17] <antElder> all the other products I've seen do this so it seems standard [11:18] <hughesj> if you do have them in lib directory then you can do java -Djava.ext.dirs=<lib directory> [11:19] <antElder> yes [11:19] <hughesj> no need to specify all jars separately on classpath [11:19] <nirmal> With WSIF all you do is run classpath.bat, you never have to set a classpath yourself [11:19] <hughesj> ok I haven't been using that :-) [11:19] <nirmal> Also having separate dirs lets you put a README for each jar, describing its version, where to download from, etc. [11:20] <antElder> anyway we just need to decide with either way [11:20] <nirmal> I think Alek put it in yesterday [11:20] <hughesj> I prefer all readmes in one place [11:20] <hughesj> only one place to look at [11:21] <nirmal> Some jars are optional. Others are required. Having them in the same place makes it confusing. [11:21] <alek_s> please downlaod current relelease and keep in mind we wnat to make it wasy for new WSIF user to get started [11:22] <antElder> shall we decide now or think about it and vote on axis-dev tomorrow? [11:22] <alek_s> time form download to run first sample dhould be few minutes max ... [11:22] <hughesj> ok I'll have a look at what you've posted on cvs.apache.org [11:22] <nirmal> try the alpha2 [11:22] <nirmal> i'd rather not vote on such a small issue, we should have consensus [11:23] <antElder> ok, I like all jars in lib [11:23] <nirmal> Ant: try the alpha2 first and then decide [11:24] <antElder> If im the only one, I don't mind the other way though [11:24] <antElder> thats not the issue [11:24] <antElder> i develope in eclipse so I don't use the bat files [11:24] <antElder> most peple would use an ide? [11:25] <alek_s> but then they need ot have their won set up [11:25] <antElder> and all in one dir makes it easy [11:25] <alek_s> you need ot set your classpath in you IDE anyway [11:25] <alek_s> and you willprobabaly work from CVS too .. [11:25] <owenb> I think that a lib dir should contain all the jars not sub-directories for each jar [11:26] <alek_s> that i think is different set of requirements then downlaod and try WSIF and get samples running fast [11:27] <hughesj> I would like to add a hi-prio task (I volunteer) to take out the java/src and java/test directory trees from the bin dist [11:27] <nirmal> you realise that if the lib dir contained all the jars there would be 18 of them? [11:27] <antElder> compared with 18 subdirs? [11:27] <nirmal> No, fewer subdirs (for example wsdl4j.jhar and qname.jar both fit under wsdl4j subdir) [11:27] <owenb> For consistency with most/all? other products that use Java, a lib directory should contain all the lib jars [11:28] <owenb> 18 jars is not a lot [11:28] <nirmal> WSIF is unique - the jars are like plugins - put in a jar for a new provider and off you go - it's almost like the Eclipse plugins [11:28] <alek_s> Jeremy: this is alredy done - check build.xml in CVS and bindist [11:28] <owenb> Ah but we're not taling about provider jars [11:28] <hughesj> ok great ... just noticed it was a problem with alpha2 [11:29] <alek_s> each provider will have its own set of dependencies [11:29] <alek_s> (or should have - currently it is not possoble to compile only one provider) [11:30] <nirmal> right, I think separating the jars is a step towards the eventual modularization - making providers independent from the core, etc. [11:30] <antElder> shall we disagree on this for now and discuss it again on irc later? [11:30] <alek_s> i agree to disagree [11:30] <hughesj> the 'Ant' project libs don't need to be in the bindist [11:31] <alek_s> we have mouch more imprtant taks: like testing doscumntatio, writing javadocs, writing sampels, testing sampels (those really matter for WSIF users) [11:31] <nirmal> ok, let's discuss after you guys have tried running what's in CVS now - if you still feel strongly I don't mind moving to a flat structure [11:33] <alek_s> i will post irc chat log [11:33] <antElder> do we want to discuss any of the bugzzila bugs? (getting them into 2.0 I mean) [11:33] <alek_s> here is list of tasks i have extracted form today chat [11:33] <alek_s> Ant: what bugs are criticial and must be fixed for this relelese? [11:33] <nirmal> I don't feel any are critical, but I'd be happy if somebody has time to fix them of course [11:34] <antElder> I was am fixing the one about the axis provider, not sure if I've read all the others [11:34] <antElder> (am fixing) [11:35] <antElder> ok no, I guess they're not important [11:35] <antElder> shame about the mail/activation jar ones, we can't distribute them can we? [11:36] <nirmal> ok, can we wrap up? (lunch time!) [11:37] <alek_s> it is hard ot knwo what is going on just from CVS commits ... [11:37] <alek_s> here is what i got for things to do: [11:37] <nirmal> no we can't distribute, but Alek I'd change the dependencies so that you ask users to download j2ee.jar only, forgot mail and activation (since it includes them) - of course it might be overkill for the user, but asking them to download just one more jar file is very attractive [11:38] <hughesj> agreed [11:38] <hughesj> can I just say that I've been very impressed with the speed that this has all been happening over the last week [11:38] <alek_s> J2EE (and j2ee.jar) is a huge downlaod so i would leave it as an optin: download J2EE or activatin/mail [11:38] <alek_s> * check current 2.0alpah2 releease and report problems [11:38] <alek_s> * check if we can distribute all jar files [11:38] <alek_s> * samples (we need to decide what does in and what is not to be in releeas -as nobody wworks on JCA or EJB samples AFAIK) [11:38] <alek_s> * sampels are crucial to show what WSIF can do and how to use it [11:38] <alek_s> * we need sample for EJB [11:38] <alek_s> * we need sample for JSM/SOAP [11:38] <alek_s> * we need sample for JCA [11:38] <alek_s> * documentation: we have most of it now but some reading/checking will only make it better [11:38] <alek_s> * document each sample (Nirmal is doing great work here both writing and coumenting sampels) [11:38] <alek_s> * we need more peope to check documntation [11:38] <alek_s> * document WSIF code and give higher level docs than just Javadocs [11:38] <alek_s> * Forrest proposal check in into proposals directory in CVS [11:38] <alek_s> * if possible no code chnages until we have releleas unless it is bug fix ... [11:38] <alek_s> * fix remainign cricial bugs [Ant: it seesm we have only onw with Axis provider] [11:38] <alek_s> [11:39] <alek_s> please take a look: what did i miss onthis list? [11:40] <nirmal> add issue of structuring jar dependencies [11:40] <nirmal> to be resolved later [11:40] <alek_s> * how to structure jar dependencies (subdirectoris or everything in one directory) [to be resolved later] [11:41] <hughesj> so what day next week are we targetting the beta for? [11:41] <hughesj> and are we saying 'high' priority only for beta? [11:41] <hughesj> if so lets call those tasks 'beta priority' [11:41] <nirmal> I'd like Monday afternoon - gives me some time to improve docs a bit and hopefully do an EJB sample [11:42] <alek_s> ok - i have it chnaged to 'for beta release - high priority' [11:42] <hughesj> nice! [11:42] <nirmal> then more betas if reqd, followed by RC1 on Wed afternoon, more RCs if reqd, then release on Friday by noon [11:43] <nirmal> this is all very quick but IMO being done before the holidays is priority #1 as we decided earlier [11:43] <hughesj> another irc on Monday? [11:43] <nirmal> I don't mind (but let's make it shorter ;-)) [11:44] <alek_s> i will be in Poland [11:44] <hughesj> yes ... lets just talk over the items for beta [11:44] <alek_s> no problem with emails but may have problems with IRC or upload/doanload of big files [11:44] <hughesj> will you join from Poland? [11:44] <antElder> yes I'd like an irc before cuttting beta [11:44] <hughesj> email only with Alek then [11:45] <hughesj> bye everyone [11:45] *** Signoff: hughesj (Quit) [11:46] <alek_s> i will try :-) [11:46] <alek_s> yes but eamil is 100% gurantee (just slower) [11:46] <nirmal> ok, bye [11:46] <alek_s> bye bye [11:46] <nirmal> Alek, post transript to axis-dev? [11:46] <alek_s> i will post irc logs [11:46] <antElder> bye all -- The ancestor of every action is a thought. - Ralph Waldo Emerson