Hi Jens, @5 you're right, it is a jar dependency, my bad.
@7 you're right, I removed the src/main/webapp/WEB-INF/web.xml so that the opencmis-server-bindings is inherited Changes have been committed to http://github.com/sourcesense/cmis-server-archetype Thanks, Maurizio On Tue, Jul 27, 2010 at 1:57 PM, Jens Hübel <[email protected]> wrote: > Thanks Maurizio this is very valuable feedback. It seems that not all > changes after the merge with the Chemistry code base have made it to the > documentation. I have updated the page. > > Some comments: > > @1) Are sure that you have picked the correct archetype? The simple-webapp > neither uses Spring nor Struts. I have used number 18 (there was a > misleading sentence on the documentation page that I have removed now). > > @2) is related to 1), works for me > > @3) true, I have fixed this > > @4) true, I have fixed this > > @5) I don't get this one. chemistry-opencmis-server-support is a jar. > > @6) Until we have a release I assume that opencmis is built and installed > in your local repository. I have added a hint on the page. > > @7) The mechanism is different. You don't have to uncompress and extract > anything manually. The overlay mechanism uses the web.xml from the > server-bindings project (and it requires some more files from there like the > wsdls). But in the documentation the hint is missing that you have to delete > the generated src/webapp directory so that this works. I have added this > hint. > > @8) That's up to the user where he wants to deploy. I have added a hint to > the jetty target in maven. > > Perhaps we also should add the complete code to subversion as an easier > starting point. I will discuss this in the Chemistry community. > > Thanks again. > > Jens > > > > -----Original Message----- > From: Maurizio Pillitu [mailto:[email protected]] > Sent: Dienstag, 27. Juli 2010 10:40 > To: [email protected] > Subject: Re: OpenCMIS Server Archetype > > Hi Jens, > sure, I can provide you with more details, but in general the archetype > aims > to simplify the maven approach, therefore the first part of the > documentation. > > 1.The documentation guides the user through the creation of a webapp using > a > specific archetype; this archetype contains spring, struts and many other > dependencies that are not necessary for building an OpenCMIS server and > makes the pom.xml heavier. > > 2. The final pom is posted as code, but copy/pasting it on top of the > previously created archetype breaks, since none of the spring/struts > dependencies are there anymore > > 3. the POM overlay on org.opencmis.opencmis-server-impl is wrong, should be > org.apache.chemistry.opencmis.chemistry-server-bindings; you don't need to > specify an overlay, maven does it automatically if the POM packaging=WAR > and > there's only one WAR dependency > > 4. All org.apache.chemistry.opencmis.opencmis-* dependencies should > be org.apache.chemistry.opencmis.chemistry-opencmis-* ; the build cannot > find the dependencies > > 5. org.apache.chemistry.opencmis.chemistry-opencmis-server-support is of > type POM; if not specified the build fails > > 6. Missing Maven repository to fetch the last SNAPSHOT versions: > http://repository.apache.org/snapshots > > 7. In order to get the WAR to work, you need to manually uncompress the > opencmis-server-bindings-XXXX.war and copy the WEB-INF/web.xml in > src/main/webapp/WEB-INF > > 8. Instead of asking the user to deploy the WAR, why not using the Maven > Jetty Plugin? > > This is the pom.xml[1] that is generated by the archetype, containing all > the fixes I just mentioned you. > > I think that the new documentation of the Maven approach should just > mention: > > > mvn archetype:generate -DarchetypeArtifactId=my-cmis-server-archetype > -DarchetypeGroupId=org.apache.chemistry.opencmis.server > -DarchetypeVersion=0.1.0-incubating-SNAPSHOT > > > cd ${artifactId} > > > mvn jetty:run > > so that the user can better focus on the server implementation details, > rather then the development environment. > > WDYT? > > Maurizio > > [1] - > > http://github.com/sourcesense/cmis-server-archetype/blob/c749484ded318185735065ddc7f5a8da48a3ce53/src/main/resources/archetype-resources/pom.xml > > On Tue, Jul 27, 2010 at 10:15 AM, Jens Hübel <[email protected]> wrote: > > > Hi Maurizio, > > > > thanks for providing feedback. Could you perhaps provide some more > details > > in what kind of issues you ran? > > I would be happy to update the documentation in case that there are > errors. > > > > Thanks Jens > > > > > > -----Original Message----- > > From: Maurizio Pillitu [mailto:[email protected]] > > Sent: Montag, 26. Juli 2010 19:59 > > To: [email protected] > > Subject: OpenCMIS Server Archetype > > > > Hi everyone, > > I was following the "How to create a CMIS server using OpenCMIS"[1] > > documentation page, but I got stuck on several issues, so I decided to > > build > > and contribute a Maven Archetype; I've filed an issue[2] on Jira. > > > > I think it would be a good idea to contribute it to the OpenCMIS project. > > > > Looking forward to your feedback. > > Regards, > > Maurizio > > > > [1] - http://incubator.apache.org/chemistry/how-to-build-a-server.html > > [2] - https://issues.apache.org/jira/browse/CMIS-243 > > > > -- > > Maurizio Pillitu - 0031 (0)615655668 > > Opensource Software Engineer > > Scrum Certified Master - http://www.scrumalliance.org > > Sourcesense - making sense of Open Source: http://www.sourcesense.com > > > > > > -- > > Met vriendelijke groet, > -- > Maurizio Pillitu - 0031 (0)615655668 > Opensource Software Engineer > Scrum Certified Master - http://www.scrumalliance.org > Sourcesense - making sense of Open Source: http://www.sourcesense.com > -- Met vriendelijke groet, -- Maurizio Pillitu - 0031 (0)615655668 Opensource Software Engineer Scrum Certified Master - http://www.scrumalliance.org Sourcesense - making sense of Open Source: http://www.sourcesense.com
