[cle-release-team] 2.9 install guide totally incorrect

[Neal Caidin]

This page needs updating -  https://confluence.sakaiproject.org/pages/viewpage.action?pageId=69273826  - Tomcat Windows Service (2.x)  - references Tomcat 5.5

I realize most folks are probably still on holiday.  I'll start compiling these in a Google doc and bring up at a CLE release team meeting. Ideally, we would have a CLE release team member review the docs from end-to-end (or split that task up among a few CLE members). I could imagine having folks take a look for obvious errors, but then it would also be nice to have the documents tested, follow the instructions and see the results. I know, lots of work. What can we bribe folks with? ;-)

-- Neal



On Dec 31, 2012, at 10:05 AM, Neal Caidin <nealcaidin at sakaifoundation.org> wrote:

> Specific things that need validation on https://confluence.sakaiproject.org/pages/viewpage.action?pageId=81756286
> 
> * Section 2.1 - Additional required settings under  Set Java_Opts reference Tomcat 5.5
> * Section 4.3 Create a Maven settings.xml file .  I thought this had been reviewed but seeing a reference to tomcat5x
> 
> Any volunteers?
> 
> Cheers
> 
> 
> On Dec 31, 2012, at 8:27 AM, Steve Swinsburg <steve.swinsburg at gmail.com> wrote:
> 
>> G'day Neal,
>> First hit in google for 'Sakai install guide' comes up with the source install (2.9) page:
>> 
>> https://confluence.sakaiproject.org/pages/viewpage.action?pageId=81756286
>> 
>> Sent from my iPhone
>> 
>> On 31/12/2012, at 23:49, Neal Caidin <nealcaidin at sakaifoundation.org> wrote:
>> 
>>> Hi Steve,
>>> 
>>> What path are you looking at?
>>> 
>>> 1) When I go to the overall release notes page - https://confluence.sakaiproject.org/display/DOC/Sakai+CLE+2.9+release+notes
>>> 
>>> 2) Then find "installing" and expand it's display
>>> 
>>> 3) Then click on "Sakai CLE 2.9 install guide (source)" 
>>> 
>>> I'm seeing Tomcat 7, Maven 3, etc. 
>>> 
>>> Thanks,
>>> Neal
>>> 
>>> 
>>> On Dec 30, 2012, at 6:12 AM, Steve Swinsburg <steve.swinsburg at gmail.com> wrote:
>>> 
>>>> I just had to grab something from the install guide and noticed it is totally incorrect. It looks like its been copied from the 2.7 one? Why not the 2.8 one? It still references Maven 2.0, Tomcat 5.5, Sakai 2.7 code. I hope no one has tried to use it.
>>>> 
>>>> This needs to be updated as a matter of urgency and should have been ready before the 2.9.0 release went out...
>>>> 
>>>> I also think its far too long winded. You don't need a maven settings file, nor to help people configure tomcat with the sub standard index.html file in the ROOT webapp, or to show them how to install Tomcat as a service, or even the various flags for Maven. That's all just junk that gets in the way and makes us look like amateurs. If people want that stuff they can look up the up to date info elsewhere.
>>>> 
>>>> The install guide should have:
>>>> 
>>>> Setup the apps you need.
>>>> Download source
>>>> Build
>>>> Start tomcat
>>>> Fin.
>>>> 
>>>> thanks,
>>>> Steve
>>>> 
>>>> _______________________________________________
>>>> cle-release-team mailing list
>>>> cle-release-team at collab.sakaiproject.org
>>>> http://collab.sakaiproject.org/mailman/listinfo/cle-release-team
>>> 
> 

-------------- next part --------------
An HTML attachment was scrubbed...
URL: http://collab.sakaiproject.org/pipermail/cle-release-team/attachments/20121231/b133db05/attachment-0006.html