[DOCU-144] Installation / admin docu should "promote" the "war install" Created: 18/Apr/11  Updated: 14/Apr/16  Resolved: 14/Apr/16

Status: Closed
Project: Documentation
Component/s: None
Affects Version/s: None
Fix Version/s: None

Type: Improvement Priority: Neutral
Reporter: Magnolia International Assignee: Antti Hietala
Resolution: Done Votes: 0
Labels: None
Remaining Estimate: Not Specified
Time Spent: Not Specified
Original Estimate: Not Specified


 Description   

Couple of notes of stuff I think are "missing" or misleading on our docs:

  • we document a lot the bundle installation process. I think this might mislead customers into installing the bundle as-is in production (not a good idea, since they then have to remove one of the instances, configure that specific tomcat, etc) - imho we should promote the "war" install more, maybe by having some sort of header in the bundle-install-notes that says this is good for trial, pocs and other test installs, but for production one should consider the "proper" way, installing "just" the war.
  • of course we'd need to expand a little on our "war install" docs.
    • Use "tomcat" not "Tomcat 5". We bundle with Tomcat 5.5 and most ppl use Tomcat 6 in prod.
    • Link to detailed container-specific docs for stuff ppl need to know/understand about their container of choice.
    • Have some (minimal) docu on how to front a tomcat-or-other with Apache. (linking to existing external doc for details rather than reproducing it entirely)


 Comments   
Comment by Antti Hietala [ 19/Apr/11 ]

Align docs to promote WAR for production use. Touches:

  • Technical Guide
  • Installation, esp. WAR

Consider if this is a role-based choice. For people just checking out Magnolia, the bundle is the way to go. For open source developers, an own build is preferred. This topic belongs to a "going to production" type of material.

Comment by Antti Hietala [ 14/Apr/16 ]

https://documentation.magnolia-cms.com/display/DOCS/Deploying

Generated at Mon Feb 12 01:06:20 CET 2024 using Jira 9.4.2#940002-sha1:46d1a51de284217efdcb32434eab47a99af2938b.