You are viewing a plain text version of this content. The canonical link for it is here.
Posted to docs@cocoon.apache.org by st...@outerthought.org on 2003/02/06 11:00:06 UTC
[WIKI-UPDATE] BeginnerInstallation MinimalCocoonConfiguration CreateMinimalWebapp BeginnerInstallTomcat Thu Feb 6 11:00:06 2003
Page: http://wiki.cocoondev.org/Wiki.jsp?page=BeginnerInstallation, version: 28 on Thu Feb 6 09:54:08 2003 by DerekH
+ You will learn, how to retrieve and deploy cocoon into a running servlet container. This approach has been tested with tomcat 4.1.16 and newer releases. It should also work for other servlet containers.
- You will learn, how to retrieve and deploy cocoon into
- a running servlet container. This approach has been tested
- with tomcat 4.1.16 and newer releases. It should also work
- for other servlet containers.
- !Your basic skills
+ !Skills Requirements
- I assume, you
? -
+ I assume you
- *have some basic knowledge about web applications and application servers in general.
? -
+ *have some basic knowledge about web applications and application servers in general
+ !Technical Prerequisites
+ In order to install cocoon you need
+ *an operating Java 1.2 (or newer) Virtual Machine
+ *a servlet container installed and working correctly
+
- don't know, what a servlet container is, you may look at the related
? -
+ don't know what a servlet container __is__, you may look at the related
? ++ ++
+ document covering [Tomcat installation|BeginnerInstallTomcat] or the [Windows 2000 Setup|CocoonDistSetupWin2000] (which covers Java and Tomcat setup).
- document about [Tomcat installation|BeginnerInstallTomcat].
-
- !Technical prerequisites
- In order to install cocoon you need
- *an operating Java-1.2, or a newer Java Virtual Machine
- *You have a servlet container installed and verified it work's correctly.
- site. See\\ [http://xml.apache.org/cocoon/installing/index.html]\\
? -- --
+ site. See [http://xml.apache.org/cocoon/installing/index.html]
+
+ ----
- [http://www.apache.org/dist/xml/cocoon/]\\
? --
+ * [http://www.apache.org/dist/xml/cocoon/]
? ++
- [http://xml.apache.org/cocoon/dist/]\\
? --
+ * [http://xml.apache.org/cocoon/dist/]
? ++
- [local mirror|http://www.apache.org/dyn/closer.cgi]
+ * [local mirror|http://www.apache.org/dyn/closer.cgi]
? ++
- !! Step II: Unpack it
? ^^
+ !! Step II: Unpack Cocoon
? ^^^^^^
- !! Step III: Deploy
+ !! Step III: Deploy Cocoon
? +++++++
- Copy the file cocoon.war into the web applications folder of your container. On Tomcat, this
+ Copy the file cocoon.war into the web applications folder of your container. On Tomcat, this will be the webapps folder within the main Tomcat folder.
? +++++++++++++++++++++++++++++++++++++++++++++++++++++++++
- will be the webapps folder within the main Tomcat folder.
+ ----
+
+
+ ----
+ ----
+
Page: http://wiki.cocoondev.org/Wiki.jsp?page=MinimalCocoonConfiguration, version: 1 on Thu Feb 6 09:35:30 2003 by DerekH
New page created:
+ !! What is essential?
+ ''by Robert Simmons Jr.''
+
+ Cocoon binary distributions come with a "kitchen sink" policy. That is that they give you everything they have including the kitchen sink. Most of it is documentation and samples.
+
+ If you wish to create a new custom Cocoon based application that has just the Cocoon engine and your additions to it, you probably want to know what you can take out. First of all, copy your Cocoon distribution so you have a backup and a reference. Now we can start deleting things from our copy. The following structure represents a skeleton Cocoon install with __no__ configured pages.
+
+ * {{sitemap.xmap}}
+ * {{META-INF}}
+ ** {{MANIFEST.MF}}
+ * {{WEB-INF}}
+ ** {{classes}}
+ *** {{CatalogManager.properties}}
+ ** {{lib}}
+ *** {{All of the jar files in the distribution.}}
+ ** {{cocoon.xconf}}
+ ** {{logkit.xconf}}
+ ** {{web.xml}}
+
+ Note that in the manifest file there is a large list of the cocoon libs. This is necessary for deployment as a packaged war on many application servers. It's recommended you just append your manifest entries to the file given. Anything not on the list above you can feel free to trash. This structure will leave you will all of the capability of Cocoon but nothing being used. It's a point at which to start from.
+
+ In the sitemap file, you can delete all the pipelines and action sets. Some actions pertaining to particular samples, such as the database actions for the employee sample, can also be removed. Read the sitemap file carefully. Don't be too distressed if you delete something and need it later, you can always refer back to the original distribution to recreate it.
+
+ In the future there may be a skeletal distribution such as I have shown here. It is on the rather lengthy "to do" list for the cocoon developers. Until then, this should let you do it the old fashioned way.
+
Page: http://wiki.cocoondev.org/Wiki.jsp?page=CreateMinimalWebapp, version: 10 on Thu Feb 6 09:30:04 2003 by DerekH
- Instructions for building a minimal, empty webapp suitable as a starting point for creating your own Cocoon-based web applications.
+ Instructions for building a minimal, empty webapp suitable as a starting point for creating your own Cocoon-based web applications. These instruction use __UNIX__ filesystem notation.
? +++++++++++++++++++++++++++++++++++++++++++++++++++
Page: http://wiki.cocoondev.org/Wiki.jsp?page=BeginnerInstallTomcat, version: 6 on Thu Feb 6 09:41:41 2003 by DerekH
+ Until this page is populated, look at [Windows 2000 Setup|CocoonDistSetupWin2000].
-