This Bugzilla instance is deprecated, and most Eclipse projects now use GitHub or Eclipse GitLab. Please see the deprecation plan for details.
Bug 252368 - Need to update demo setup script documentation
Summary: Need to update demo setup script documentation
Status: RESOLVED FIXED
Alias: None
Product: z_Archived
Classification: Eclipse Foundation
Component: Cosmos (show other bugs)
Version: unspecified   Edit
Hardware: All All
: P1 normal (vote)
Target Milestone: ---   Edit
Assignee: Pam Kusnirik CLA
QA Contact: Ruth Lee CLA
URL:
Whiteboard:
Keywords:
Depends on:
Blocks:
 
Reported: 2008-10-28 10:36 EDT by John Devine CLA
Modified: 2012-01-03 13:48 EST (History)
4 users (show)

See Also:


Attachments
Installation Guide - COSMOS Demo Setup (4.81 KB, text/html)
2008-10-28 16:00 EDT, Pam Kusnirik CLA
dlwhiteman: iplog+
Details

Note You need to log in before you can comment on or make changes to this bug.
Description John Devine CLA 2008-10-28 10:36:05 EDT
Both configDemo.bat/configDemo.sh are specific for Tomcat.   Documentation (cosmosdemosetup.html), (and scripts) need to be updated to reflect this.
Comment 1 David Whiteman CLA 2008-10-28 10:41:44 EDT
To add what Jack just said, more specifically, we should add a disclaimer at the end of the first paragraph of that section of the install guide.  Something like this should work: "Note: this program has been customized to install the COSMOS web applications into the Tomcat web server.  If you are using any other web server, you will need to modify this program or install the demo manually."
Comment 2 David Whiteman CLA 2008-10-28 10:43:57 EDT
Also, based on what Jack said, we should probably update the install script as well to output the same sort of disclaimer to the console.  That would require someone technical to make that change and would of course mean that a rebuild would be necessary (which will likely be true anyway for making the logging data manager changes we've discussed).
Comment 3 David Whiteman CLA 2008-10-28 10:50:56 EDT
(In reply to comment #2)
> Also, based on what Jack said, we should probably update the install script as
> well to output the same sort of disclaimer to the console.  That would require
> someone technical to make that change and would of course mean that a rebuild
> would be necessary (which will likely be true anyway for making the logging
> data manager changes we've discussed).

I moved this part of the work effort to bug 252377.
Comment 4 Pam Kusnirik CLA 2008-10-28 15:48:28 EDT
cosmosdemosetup.html has been updated with this info (see the note after the first paragraph).
Comment 5 David Whiteman CLA 2008-10-28 15:51:16 EDT
thanks Pam!  you can mark this as fixed, and attach the file to the defect.  after i take a look at it, i'll mark the defect as verified.
Comment 6 Pam Kusnirik CLA 2008-10-28 16:00:32 EDT
Created attachment 116350 [details]
Installation Guide - COSMOS Demo Setup
Comment 7 Pam Kusnirik CLA 2008-10-28 16:01:55 EDT
Included David's comments re: Tomcat.
Comment 8 David Whiteman CLA 2008-10-28 16:36:57 EDT
Hi Pam... the note looks great!  Since we are now no longer "hiding" that the script works with Tomcat, we should change the first item:

"<web-server-dir>: Web Server install directory
Note: The directory where the web server is installed is referred to as <web-server-dir> in this document."

To:

"tomcatDir: Apache Tomcat install directory"

and change the "<web-server-dir>" references back to "apache-tomcat-5.5.25".

Also, please remove the "i14/" from all occurrences.  For example "/cosmos/i14/birt-runtime-2_3_0.zip" should instead be "/cosmos/birt-runtime-2_3_0.zip" in the example output.

Thanks!