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
