You are viewing a plain text version of this content. The canonical link for it is here.
Posted to dev@geronimo.apache.org by Jason Lenhart <jp...@yahoo.com> on 2005/12/22 19:28:28 UTC
Geronimo Installation Document Section
Hi,
I am starting on the Installation section of the docs
- I have been running around like a maniac doing stuff
(mostly holiday things) - so I am a bit slow to
produce. But I am setting aside some time each day to
contribute more and more to the docs. If you start to
see me go off base - please feel free to call me out
:-D
Also - is the preference to complete a section and
then update? I started and updated but it is not
complete.
Thanks,
Jason
__________________________________________
Yahoo! DSL Something to write home about.
Just $16.99/mo. or less.
dsl.yahoo.com
Re: Geronimo Installation Document Section
Posted by Paul McMahan <pa...@gmail.com>.
I have been fooling around with apache jetspeed and found their installation
instructions (which is linked from their download page) to be pretty useful.
http://portals.apache.org/jetspeed-2/download.html#Installation_Instructions
- Getting Started with Jetspeed-2
Installer<http://portals.apache.org/jetspeed-2/getting-started-installer.html>
- Getting Started with Building from Jetspeed-2
Source<http://portals.apache.org/jetspeed-2/getting-started-source.html>
- Getting Started with Building from Jetspeed-2 Maven
Plugin<http://portals.apache.org/jetspeed-2/getting-started-binary.html>
I realize the G installer isn't ready yet but perhaps we could still follow
a similar format.
Best wishes,
Paul
Re: Geronimo Installation Document Section
Posted by Hernan Cunico <hc...@gmail.com>.
how about this structure
Installation
Supported platforms
Hardware and software prerequisites
Getting the software
Getting the binaries
Getting the source code
Build from the source
complete build
modular build
Installing the binaries
_interoperability,
ports conflict considerations,
directory structure,
configuration files,
additional considerations_
Cheers!
Hernan
Joe Bohn wrote:
> I would recommend then not using the term "Installation". Even with IT
> guys this typically implies installing some piece of software to simply
> use it ... not to setup for development and building. Perhaps "Setup for
> Developers" would be a better heading or if we must continue to use
> "Installation" then perhaps extend the heading to "Installation for
> Developers".
>
> Joe
>
> Hernan Cunico wrote:
>
>> Hi all,
>> for getting Geronimo up and running really fast, there is already the
>> *Quick start - Apache Geronimo for the impatient* section where you
>> get it running right from the binaries.
>>
>> My original idea for the *Installation* section was to have a complete
>> set of instructions for downloading and building. Initially focused on
>> the alternatives for downloading from svn and then, once you have the
>> source, all the options for complete/modular building.
>>
>> I believe that not only developers will be interested in partial
>> builds. What about IT guys (and I'm one of them) looking for
>> performance improvement or resources optimization?
>>
>> I will reorganize the *Installation* section to make the subtopics and
>> scope more clear.
>>
>> Cheers!
>> Hernan
>>
>> Prasad Kashyap wrote:
>>
>>> I agree with Matt. If you want to call it an "Installation document",
>>> then it must be geared towards the users installing Geronimo. They
>>> care little about building it. They would be the ones downloading the
>>> binaries and wanting to get G up and running quickly.
>>>
>>> The steps being discussed in this thread should go in something like
>>> a "Developers Section" .
>>>
>>> Cheers
>>> Prasad
>>>
>>> On 1/6/06, *Matt Hogstrom* <matt@hogstrom.org
>>> <ma...@hogstrom.org>> wrote:
>>>
>>> I think we've now crossed teh chasm to where there are two types of
>>> users.
>>> Developers of Geronimo and Users of Geronimo. So far this thread
>>> has been
>>> talking about developers but I think we also need a User section
>>> that describes
>>> teh process of installation from a downloaded binary rather than
>>> having to worry
>>> about SVN. We can then augment that with some updated doc on the
>>> installer.
>>>
>>> Thoughts?
>>>
>>> Matt
>>>
>>> John Sisson wrote:
>>> > You need to do the fresh-checkout the first time you get the
>>> source so
>>> > that you get the OpenEJB code (from CVS). AFAIK, you shouldn't
>>> need to
>>> > do a fresh-checkout again because an m:update will update both
>>> svn and
>>> > OpenEJB CVS files.
>>> >
>>> > Not sure why you would need to do a fresh-checkout a second time
>>> for the
>>> > second round to work.
>>> >
>>> > John
>>> >
>>> > Hernan Cunico wrote:
>>> >
>>> >> On my machine, if I don't do a fresh-checkout the build fails.
>>> In fact
>>> >> it always fails the first attempt and the second round works
>>> as long
>>> >> as I do the fresh-checkout.
>>> >>
>>> >> Any idea why this is happening?
>>> >>
>>> >> Cheers!
>>> >> Hernan
>>> >>
>>> >> Sachin Patel wrote:
>>> >>
>>> >>>
>>> >>> - sachin
>>> >>>
>>> >>>
>>> >>>
>>> >>> On Jan 5, 2006, at 4:16 PM, Hernan Cunico wrote:
>>> >>>
>>> >>>> Hi Jason,
>>> >>>> how is the installation doc coming, do you need any help on
>>> the
>>> >>>> confluence side?
>>> >>>>
>>> >>>> I saw what you started to work on the "Getting the source
>>> code"
>>> >>>> section, I would suggest to keep this task simple. We do
>>> not want
>>> >>>> to _scare_ the users with way too complicated commands and
>>> >>>> parameters, all at once.
>>> >>>>
>>> >>>> There are basically four steps to get the source and build
>>> >>>> Geronimo, so I would focus on those first.
>>> >>>>
>>> >>>> 1.- svn checkout
>>> https://svn.apache.org/repos/asf/geronimo/tags/
>>> >>>> 1.0.0/ <geronimo_home>
>>> >>>> 2.- cd <geronimo_home>
>>> >>>> 3.- maven m:fresh-checkout
>>> >>>> 4.- maven new
>>> >>>>
>>> >>>> Then, the next time you want to build you just do an update
>>> >>>>
>>> >>>> 1.- cd <geronimo_home>
>>> >>>> 2.- maven m:update
>>> >>>> 3.- maven m:fresh-checkout
>>> >>>
>>> >>>
>>> >>>
>>> >>>
>>> >>> Take out #3
>>> >>>
>>> >>>> 4.- maven new
>>> >>>
>>> >>>
>>> >>>
>>> >>>
>>> >>> add -o
>>> >>>
>>> >>>>
>>> >>>> (BTW, all the steps should be validated and make sure they
>>> are up-
>>> >>>> to-date)
>>> >>>>
>>> >>>> Once you explained the basics then you can go more in
>>> detail with
>>> >>>> all the other options for retrieving the source code and
>>> building
>>> >>>> Geronimo. It would also be nice to include common building
>>> errors,
>>> >>>> how to identify them, probable causes and solutions.
>>> >>>>
>>> >>>> Again, this is just a suggestion. What you think about this
>>> approach?
>>> >>>>
>>> >>>> As for update preference, I think is best to update as you
>>> go so
>>> >>>> everybody can test your instructions and provide early
>>> comments
>>> >>>> that will make corrections (if any) easier.
>>> >>>>
>>> >>>> Cheers!
>>> >>>> Hernan
>>> >>>>
>>> >>>> Jason Lenhart wrote:
>>> >>>>
>>> >>>>> Hi,
>>> >>>>> I am starting on the Installation section of the docs
>>> >>>>> - I have been running around like a maniac doing stuff
>>> >>>>> (mostly holiday things) - so I am a bit slow to
>>> >>>>> produce. But I am setting aside some time each day to
>>> >>>>> contribute more and more to the docs. If you start to
>>> >>>>> see me go off base - please feel free to call me out
>>> >>>>> :-D
>>> >>>>> Also - is the preference to complete a section and
>>> >>>>> then update? I started and updated but it is not
>>> >>>>> complete.
>>> >>>>> Thanks,
>>> >>>>> Jason
>>> >>>>> __________________________________________ Yahoo!
>>> DSL –
>>> >>>>> Something to write home about. Just $16.99/mo. or less.
>>> dsl.yahoo.com <http://dsl.yahoo.com>
>>> >>>>
>>> >>>>
>>> >>>
>>> >>>
>>> >>>
>>> >>
>>> >
>>> >
>>> >
>>> >
>>>
>>>
>>
>>
>
Re: Geronimo Installation Document Section
Posted by Joe Bohn <jo...@earthlink.net>.
I would recommend then not using the term "Installation". Even with IT
guys this typically implies installing some piece of software to simply
use it ... not to setup for development and building. Perhaps "Setup for
Developers" would be a better heading or if we must continue to use
"Installation" then perhaps extend the heading to "Installation for
Developers".
Joe
Hernan Cunico wrote:
> Hi all,
> for getting Geronimo up and running really fast, there is already the
> *Quick start - Apache Geronimo for the impatient* section where you get
> it running right from the binaries.
>
> My original idea for the *Installation* section was to have a complete
> set of instructions for downloading and building. Initially focused on
> the alternatives for downloading from svn and then, once you have the
> source, all the options for complete/modular building.
>
> I believe that not only developers will be interested in partial builds.
> What about IT guys (and I'm one of them) looking for performance
> improvement or resources optimization?
>
> I will reorganize the *Installation* section to make the subtopics and
> scope more clear.
>
> Cheers!
> Hernan
>
> Prasad Kashyap wrote:
>
>> I agree with Matt. If you want to call it an "Installation document",
>> then it must be geared towards the users installing Geronimo. They
>> care little about building it. They would be the ones downloading the
>> binaries and wanting to get G up and running quickly.
>>
>> The steps being discussed in this thread should go in something like a
>> "Developers Section" .
>>
>> Cheers
>> Prasad
>>
>> On 1/6/06, *Matt Hogstrom* <matt@hogstrom.org
>> <ma...@hogstrom.org>> wrote:
>>
>> I think we've now crossed teh chasm to where there are two types of
>> users.
>> Developers of Geronimo and Users of Geronimo. So far this thread
>> has been
>> talking about developers but I think we also need a User section
>> that describes
>> teh process of installation from a downloaded binary rather than
>> having to worry
>> about SVN. We can then augment that with some updated doc on the
>> installer.
>>
>> Thoughts?
>>
>> Matt
>>
>> John Sisson wrote:
>> > You need to do the fresh-checkout the first time you get the
>> source so
>> > that you get the OpenEJB code (from CVS). AFAIK, you shouldn't
>> need to
>> > do a fresh-checkout again because an m:update will update both
>> svn and
>> > OpenEJB CVS files.
>> >
>> > Not sure why you would need to do a fresh-checkout a second time
>> for the
>> > second round to work.
>> >
>> > John
>> >
>> > Hernan Cunico wrote:
>> >
>> >> On my machine, if I don't do a fresh-checkout the build fails.
>> In fact
>> >> it always fails the first attempt and the second round works
>> as long
>> >> as I do the fresh-checkout.
>> >>
>> >> Any idea why this is happening?
>> >>
>> >> Cheers!
>> >> Hernan
>> >>
>> >> Sachin Patel wrote:
>> >>
>> >>>
>> >>> - sachin
>> >>>
>> >>>
>> >>>
>> >>> On Jan 5, 2006, at 4:16 PM, Hernan Cunico wrote:
>> >>>
>> >>>> Hi Jason,
>> >>>> how is the installation doc coming, do you need any help on the
>> >>>> confluence side?
>> >>>>
>> >>>> I saw what you started to work on the "Getting the source code"
>> >>>> section, I would suggest to keep this task simple. We do not
>> want
>> >>>> to _scare_ the users with way too complicated commands and
>> >>>> parameters, all at once.
>> >>>>
>> >>>> There are basically four steps to get the source and build
>> >>>> Geronimo, so I would focus on those first.
>> >>>>
>> >>>> 1.- svn checkout
>> https://svn.apache.org/repos/asf/geronimo/tags/
>> >>>> 1.0.0/ <geronimo_home>
>> >>>> 2.- cd <geronimo_home>
>> >>>> 3.- maven m:fresh-checkout
>> >>>> 4.- maven new
>> >>>>
>> >>>> Then, the next time you want to build you just do an update
>> >>>>
>> >>>> 1.- cd <geronimo_home>
>> >>>> 2.- maven m:update
>> >>>> 3.- maven m:fresh-checkout
>> >>>
>> >>>
>> >>>
>> >>>
>> >>> Take out #3
>> >>>
>> >>>> 4.- maven new
>> >>>
>> >>>
>> >>>
>> >>>
>> >>> add -o
>> >>>
>> >>>>
>> >>>> (BTW, all the steps should be validated and make sure they
>> are up-
>> >>>> to-date)
>> >>>>
>> >>>> Once you explained the basics then you can go more in detail
>> with
>> >>>> all the other options for retrieving the source code and
>> building
>> >>>> Geronimo. It would also be nice to include common building
>> errors,
>> >>>> how to identify them, probable causes and solutions.
>> >>>>
>> >>>> Again, this is just a suggestion. What you think about this
>> approach?
>> >>>>
>> >>>> As for update preference, I think is best to update as you
>> go so
>> >>>> everybody can test your instructions and provide early comments
>> >>>> that will make corrections (if any) easier.
>> >>>>
>> >>>> Cheers!
>> >>>> Hernan
>> >>>>
>> >>>> Jason Lenhart wrote:
>> >>>>
>> >>>>> Hi,
>> >>>>> I am starting on the Installation section of the docs
>> >>>>> - I have been running around like a maniac doing stuff
>> >>>>> (mostly holiday things) - so I am a bit slow to
>> >>>>> produce. But I am setting aside some time each day to
>> >>>>> contribute more and more to the docs. If you start to
>> >>>>> see me go off base - please feel free to call me out
>> >>>>> :-D
>> >>>>> Also - is the preference to complete a section and
>> >>>>> then update? I started and updated but it is not
>> >>>>> complete.
>> >>>>> Thanks,
>> >>>>> Jason
>> >>>>> __________________________________________ Yahoo! DSL –
>> >>>>> Something to write home about. Just $16.99/mo. or less.
>> dsl.yahoo.com <http://dsl.yahoo.com>
>> >>>>
>> >>>>
>> >>>
>> >>>
>> >>>
>> >>
>> >
>> >
>> >
>> >
>>
>>
>
>
--
Joe Bohn
joe.bohn@earthlink.net
"He is no fool who gives what he cannot keep, to gain what he cannot
lose." -- Jim Elliot
Re: Geronimo Installation Document Section
Posted by Hernan Cunico <hc...@gmail.com>.
Hi all,
for getting Geronimo up and running really fast, there is already the *Quick start - Apache Geronimo
for the impatient* section where you get it running right from the binaries.
My original idea for the *Installation* section was to have a complete set of instructions for
downloading and building. Initially focused on the alternatives for downloading from svn and then,
once you have the source, all the options for complete/modular building.
I believe that not only developers will be interested in partial builds. What about IT guys (and I'm
one of them) looking for performance improvement or resources optimization?
I will reorganize the *Installation* section to make the subtopics and scope more clear.
Cheers!
Hernan
Prasad Kashyap wrote:
> I agree with Matt. If you want to call it an "Installation document",
> then it must be geared towards the users installing Geronimo. They care
> little about building it. They would be the ones downloading the
> binaries and wanting to get G up and running quickly.
>
> The steps being discussed in this thread should go in something like a
> "Developers Section" .
>
> Cheers
> Prasad
>
> On 1/6/06, *Matt Hogstrom* <matt@hogstrom.org
> <ma...@hogstrom.org>> wrote:
>
> I think we've now crossed teh chasm to where there are two types of
> users.
> Developers of Geronimo and Users of Geronimo. So far this thread
> has been
> talking about developers but I think we also need a User section
> that describes
> teh process of installation from a downloaded binary rather than
> having to worry
> about SVN. We can then augment that with some updated doc on the
> installer.
>
> Thoughts?
>
> Matt
>
> John Sisson wrote:
> > You need to do the fresh-checkout the first time you get the
> source so
> > that you get the OpenEJB code (from CVS). AFAIK, you shouldn't
> need to
> > do a fresh-checkout again because an m:update will update both
> svn and
> > OpenEJB CVS files.
> >
> > Not sure why you would need to do a fresh-checkout a second time
> for the
> > second round to work.
> >
> > John
> >
> > Hernan Cunico wrote:
> >
> >> On my machine, if I don't do a fresh-checkout the build fails.
> In fact
> >> it always fails the first attempt and the second round works as long
> >> as I do the fresh-checkout.
> >>
> >> Any idea why this is happening?
> >>
> >> Cheers!
> >> Hernan
> >>
> >> Sachin Patel wrote:
> >>
> >>>
> >>> - sachin
> >>>
> >>>
> >>>
> >>> On Jan 5, 2006, at 4:16 PM, Hernan Cunico wrote:
> >>>
> >>>> Hi Jason,
> >>>> how is the installation doc coming, do you need any help on the
> >>>> confluence side?
> >>>>
> >>>> I saw what you started to work on the "Getting the source code"
> >>>> section, I would suggest to keep this task simple. We do not want
> >>>> to _scare_ the users with way too complicated commands and
> >>>> parameters, all at once.
> >>>>
> >>>> There are basically four steps to get the source and build
> >>>> Geronimo, so I would focus on those first.
> >>>>
> >>>> 1.- svn checkout https://svn.apache.org/repos/asf/geronimo/tags/
> >>>> 1.0.0/ <geronimo_home>
> >>>> 2.- cd <geronimo_home>
> >>>> 3.- maven m:fresh-checkout
> >>>> 4.- maven new
> >>>>
> >>>> Then, the next time you want to build you just do an update
> >>>>
> >>>> 1.- cd <geronimo_home>
> >>>> 2.- maven m:update
> >>>> 3.- maven m:fresh-checkout
> >>>
> >>>
> >>>
> >>>
> >>> Take out #3
> >>>
> >>>> 4.- maven new
> >>>
> >>>
> >>>
> >>>
> >>> add -o
> >>>
> >>>>
> >>>> (BTW, all the steps should be validated and make sure they are up-
> >>>> to-date)
> >>>>
> >>>> Once you explained the basics then you can go more in detail with
> >>>> all the other options for retrieving the source code and building
> >>>> Geronimo. It would also be nice to include common building errors,
> >>>> how to identify them, probable causes and solutions.
> >>>>
> >>>> Again, this is just a suggestion. What you think about this
> approach?
> >>>>
> >>>> As for update preference, I think is best to update as you go so
> >>>> everybody can test your instructions and provide early comments
> >>>> that will make corrections (if any) easier.
> >>>>
> >>>> Cheers!
> >>>> Hernan
> >>>>
> >>>> Jason Lenhart wrote:
> >>>>
> >>>>> Hi,
> >>>>> I am starting on the Installation section of the docs
> >>>>> - I have been running around like a maniac doing stuff
> >>>>> (mostly holiday things) - so I am a bit slow to
> >>>>> produce. But I am setting aside some time each day to
> >>>>> contribute more and more to the docs. If you start to
> >>>>> see me go off base - please feel free to call me out
> >>>>> :-D
> >>>>> Also - is the preference to complete a section and
> >>>>> then update? I started and updated but it is not
> >>>>> complete.
> >>>>> Thanks,
> >>>>> Jason
> >>>>> __________________________________________ Yahoo! DSL –
> >>>>> Something to write home about. Just $16.99/mo. or less.
> dsl.yahoo.com <http://dsl.yahoo.com>
> >>>>
> >>>>
> >>>
> >>>
> >>>
> >>
> >
> >
> >
> >
>
>
Re: Geronimo Installation Document Section
Posted by Prasad Kashyap <go...@gmail.com>.
I agree with Matt. If you want to call it an "Installation document", then
it must be geared towards the users installing Geronimo. They care little
about building it. They would be the ones downloading the binaries and
wanting to get G up and running quickly.
The steps being discussed in this thread should go in something like a
"Developers Section" .
Cheers
Prasad
On 1/6/06, Matt Hogstrom <ma...@hogstrom.org> wrote:
>
> I think we've now crossed teh chasm to where there are two types of users.
> Developers of Geronimo and Users of Geronimo. So far this thread has been
> talking about developers but I think we also need a User section that
> describes
> teh process of installation from a downloaded binary rather than having to
> worry
> about SVN. We can then augment that with some updated doc on the
> installer.
>
> Thoughts?
>
> Matt
>
> John Sisson wrote:
> > You need to do the fresh-checkout the first time you get the source so
> > that you get the OpenEJB code (from CVS). AFAIK, you shouldn't need to
> > do a fresh-checkout again because an m:update will update both svn and
> > OpenEJB CVS files.
> >
> > Not sure why you would need to do a fresh-checkout a second time for the
> > second round to work.
> >
> > John
> >
> > Hernan Cunico wrote:
> >
> >> On my machine, if I don't do a fresh-checkout the build fails. In fact
> >> it always fails the first attempt and the second round works as long
> >> as I do the fresh-checkout.
> >>
> >> Any idea why this is happening?
> >>
> >> Cheers!
> >> Hernan
> >>
> >> Sachin Patel wrote:
> >>
> >>>
> >>> - sachin
> >>>
> >>>
> >>>
> >>> On Jan 5, 2006, at 4:16 PM, Hernan Cunico wrote:
> >>>
> >>>> Hi Jason,
> >>>> how is the installation doc coming, do you need any help on the
> >>>> confluence side?
> >>>>
> >>>> I saw what you started to work on the "Getting the source code"
> >>>> section, I would suggest to keep this task simple. We do not want
> >>>> to _scare_ the users with way too complicated commands and
> >>>> parameters, all at once.
> >>>>
> >>>> There are basically four steps to get the source and build
> >>>> Geronimo, so I would focus on those first.
> >>>>
> >>>> 1.- svn checkout https://svn.apache.org/repos/asf/geronimo/tags/
> >>>> 1.0.0/ <geronimo_home>
> >>>> 2.- cd <geronimo_home>
> >>>> 3.- maven m:fresh-checkout
> >>>> 4.- maven new
> >>>>
> >>>> Then, the next time you want to build you just do an update
> >>>>
> >>>> 1.- cd <geronimo_home>
> >>>> 2.- maven m:update
> >>>> 3.- maven m:fresh-checkout
> >>>
> >>>
> >>>
> >>>
> >>> Take out #3
> >>>
> >>>> 4.- maven new
> >>>
> >>>
> >>>
> >>>
> >>> add -o
> >>>
> >>>>
> >>>> (BTW, all the steps should be validated and make sure they are up-
> >>>> to-date)
> >>>>
> >>>> Once you explained the basics then you can go more in detail with
> >>>> all the other options for retrieving the source code and building
> >>>> Geronimo. It would also be nice to include common building errors,
> >>>> how to identify them, probable causes and solutions.
> >>>>
> >>>> Again, this is just a suggestion. What you think about this approach?
> >>>>
> >>>> As for update preference, I think is best to update as you go so
> >>>> everybody can test your instructions and provide early comments
> >>>> that will make corrections (if any) easier.
> >>>>
> >>>> Cheers!
> >>>> Hernan
> >>>>
> >>>> Jason Lenhart wrote:
> >>>>
> >>>>> Hi,
> >>>>> I am starting on the Installation section of the docs
> >>>>> - I have been running around like a maniac doing stuff
> >>>>> (mostly holiday things) - so I am a bit slow to
> >>>>> produce. But I am setting aside some time each day to
> >>>>> contribute more and more to the docs. If you start to
> >>>>> see me go off base - please feel free to call me out
> >>>>> :-D
> >>>>> Also - is the preference to complete a section and
> >>>>> then update? I started and updated but it is not
> >>>>> complete.
> >>>>> Thanks,
> >>>>> Jason
> >>>>> __________________________________________ Yahoo! DSL –
> >>>>> Something to write home about. Just $16.99/mo. or less.
> dsl.yahoo.com
> >>>>
> >>>>
> >>>
> >>>
> >>>
> >>
> >
> >
> >
> >
>
Re: Geronimo Installation Document Section
Posted by Matt Hogstrom <ma...@hogstrom.org>.
I think we've now crossed teh chasm to where there are two types of users.
Developers of Geronimo and Users of Geronimo. So far this thread has been
talking about developers but I think we also need a User section that describes
teh process of installation from a downloaded binary rather than having to worry
about SVN. We can then augment that with some updated doc on the installer.
Thoughts?
Matt
John Sisson wrote:
> You need to do the fresh-checkout the first time you get the source so
> that you get the OpenEJB code (from CVS). AFAIK, you shouldn't need to
> do a fresh-checkout again because an m:update will update both svn and
> OpenEJB CVS files.
>
> Not sure why you would need to do a fresh-checkout a second time for the
> second round to work.
>
> John
>
> Hernan Cunico wrote:
>
>> On my machine, if I don't do a fresh-checkout the build fails. In fact
>> it always fails the first attempt and the second round works as long
>> as I do the fresh-checkout.
>>
>> Any idea why this is happening?
>>
>> Cheers!
>> Hernan
>>
>> Sachin Patel wrote:
>>
>>>
>>> - sachin
>>>
>>>
>>>
>>> On Jan 5, 2006, at 4:16 PM, Hernan Cunico wrote:
>>>
>>>> Hi Jason,
>>>> how is the installation doc coming, do you need any help on the
>>>> confluence side?
>>>>
>>>> I saw what you started to work on the "Getting the source code"
>>>> section, I would suggest to keep this task simple. We do not want
>>>> to _scare_ the users with way too complicated commands and
>>>> parameters, all at once.
>>>>
>>>> There are basically four steps to get the source and build
>>>> Geronimo, so I would focus on those first.
>>>>
>>>> 1.- svn checkout https://svn.apache.org/repos/asf/geronimo/tags/
>>>> 1.0.0/ <geronimo_home>
>>>> 2.- cd <geronimo_home>
>>>> 3.- maven m:fresh-checkout
>>>> 4.- maven new
>>>>
>>>> Then, the next time you want to build you just do an update
>>>>
>>>> 1.- cd <geronimo_home>
>>>> 2.- maven m:update
>>>> 3.- maven m:fresh-checkout
>>>
>>>
>>>
>>>
>>> Take out #3
>>>
>>>> 4.- maven new
>>>
>>>
>>>
>>>
>>> add -o
>>>
>>>>
>>>> (BTW, all the steps should be validated and make sure they are up-
>>>> to-date)
>>>>
>>>> Once you explained the basics then you can go more in detail with
>>>> all the other options for retrieving the source code and building
>>>> Geronimo. It would also be nice to include common building errors,
>>>> how to identify them, probable causes and solutions.
>>>>
>>>> Again, this is just a suggestion. What you think about this approach?
>>>>
>>>> As for update preference, I think is best to update as you go so
>>>> everybody can test your instructions and provide early comments
>>>> that will make corrections (if any) easier.
>>>>
>>>> Cheers!
>>>> Hernan
>>>>
>>>> Jason Lenhart wrote:
>>>>
>>>>> Hi,
>>>>> I am starting on the Installation section of the docs
>>>>> - I have been running around like a maniac doing stuff
>>>>> (mostly holiday things) - so I am a bit slow to
>>>>> produce. But I am setting aside some time each day to
>>>>> contribute more and more to the docs. If you start to
>>>>> see me go off base - please feel free to call me out
>>>>> :-D
>>>>> Also - is the preference to complete a section and
>>>>> then update? I started and updated but it is not
>>>>> complete.
>>>>> Thanks,
>>>>> Jason
>>>>> __________________________________________ Yahoo! DSL –
>>>>> Something to write home about. Just $16.99/mo. or less. dsl.yahoo.com
>>>>
>>>>
>>>
>>>
>>>
>>
>
>
>
>
Re: Geronimo Installation Document Section
Posted by John Sisson <jr...@gmail.com>.
You need to do the fresh-checkout the first time you get the source so
that you get the OpenEJB code (from CVS). AFAIK, you shouldn't need to
do a fresh-checkout again because an m:update will update both svn and
OpenEJB CVS files.
Not sure why you would need to do a fresh-checkout a second time for the
second round to work.
John
Hernan Cunico wrote:
> On my machine, if I don't do a fresh-checkout the build fails. In fact
> it always fails the first attempt and the second round works as long
> as I do the fresh-checkout.
>
> Any idea why this is happening?
>
> Cheers!
> Hernan
>
> Sachin Patel wrote:
>
>>
>> - sachin
>>
>>
>>
>> On Jan 5, 2006, at 4:16 PM, Hernan Cunico wrote:
>>
>>> Hi Jason,
>>> how is the installation doc coming, do you need any help on the
>>> confluence side?
>>>
>>> I saw what you started to work on the "Getting the source code"
>>> section, I would suggest to keep this task simple. We do not want
>>> to _scare_ the users with way too complicated commands and
>>> parameters, all at once.
>>>
>>> There are basically four steps to get the source and build
>>> Geronimo, so I would focus on those first.
>>>
>>> 1.- svn checkout https://svn.apache.org/repos/asf/geronimo/tags/
>>> 1.0.0/ <geronimo_home>
>>> 2.- cd <geronimo_home>
>>> 3.- maven m:fresh-checkout
>>> 4.- maven new
>>>
>>> Then, the next time you want to build you just do an update
>>>
>>> 1.- cd <geronimo_home>
>>> 2.- maven m:update
>>> 3.- maven m:fresh-checkout
>>
>>
>>
>> Take out #3
>>
>>> 4.- maven new
>>
>>
>>
>> add -o
>>
>>>
>>> (BTW, all the steps should be validated and make sure they are up-
>>> to-date)
>>>
>>> Once you explained the basics then you can go more in detail with
>>> all the other options for retrieving the source code and building
>>> Geronimo. It would also be nice to include common building errors,
>>> how to identify them, probable causes and solutions.
>>>
>>> Again, this is just a suggestion. What you think about this approach?
>>>
>>> As for update preference, I think is best to update as you go so
>>> everybody can test your instructions and provide early comments
>>> that will make corrections (if any) easier.
>>>
>>> Cheers!
>>> Hernan
>>>
>>> Jason Lenhart wrote:
>>>
>>>> Hi,
>>>> I am starting on the Installation section of the docs
>>>> - I have been running around like a maniac doing stuff
>>>> (mostly holiday things) - so I am a bit slow to
>>>> produce. But I am setting aside some time each day to
>>>> contribute more and more to the docs. If you start to
>>>> see me go off base - please feel free to call me out
>>>> :-D
>>>> Also - is the preference to complete a section and
>>>> then update? I started and updated but it is not
>>>> complete.
>>>> Thanks,
>>>> Jason
>>>> __________________________________________ Yahoo! DSL –
>>>> Something to write home about. Just $16.99/mo. or less. dsl.yahoo.com
>>>
>>
>>
>>
>
Re: Geronimo Installation Document Section
Posted by Hernan Cunico <hc...@gmail.com>.
On my machine, if I don't do a fresh-checkout the build fails. In fact it always fails the first
attempt and the second round works as long as I do the fresh-checkout.
Any idea why this is happening?
Cheers!
Hernan
Sachin Patel wrote:
>
> - sachin
>
>
>
> On Jan 5, 2006, at 4:16 PM, Hernan Cunico wrote:
>
>> Hi Jason,
>> how is the installation doc coming, do you need any help on the
>> confluence side?
>>
>> I saw what you started to work on the "Getting the source code"
>> section, I would suggest to keep this task simple. We do not want to
>> _scare_ the users with way too complicated commands and parameters,
>> all at once.
>>
>> There are basically four steps to get the source and build Geronimo,
>> so I would focus on those first.
>>
>> 1.- svn checkout https://svn.apache.org/repos/asf/geronimo/tags/
>> 1.0.0/ <geronimo_home>
>> 2.- cd <geronimo_home>
>> 3.- maven m:fresh-checkout
>> 4.- maven new
>>
>> Then, the next time you want to build you just do an update
>>
>> 1.- cd <geronimo_home>
>> 2.- maven m:update
>> 3.- maven m:fresh-checkout
>
>
> Take out #3
>
>> 4.- maven new
>
>
> add -o
>
>>
>> (BTW, all the steps should be validated and make sure they are up-
>> to-date)
>>
>> Once you explained the basics then you can go more in detail with all
>> the other options for retrieving the source code and building
>> Geronimo. It would also be nice to include common building errors,
>> how to identify them, probable causes and solutions.
>>
>> Again, this is just a suggestion. What you think about this approach?
>>
>> As for update preference, I think is best to update as you go so
>> everybody can test your instructions and provide early comments that
>> will make corrections (if any) easier.
>>
>> Cheers!
>> Hernan
>>
>> Jason Lenhart wrote:
>>
>>> Hi,
>>> I am starting on the Installation section of the docs
>>> - I have been running around like a maniac doing stuff
>>> (mostly holiday things) - so I am a bit slow to
>>> produce. But I am setting aside some time each day to
>>> contribute more and more to the docs. If you start to
>>> see me go off base - please feel free to call me out
>>> :-D
>>> Also - is the preference to complete a section and
>>> then update? I started and updated but it is not
>>> complete.
>>> Thanks,
>>> Jason
>>>
>>> __________________________________________ Yahoo! DSL – Something to
>>> write home about. Just $16.99/mo. or less. dsl.yahoo.com
>
>
>
Re: Geronimo Installation Document Section
Posted by Sachin Patel <sp...@gmail.com>.
- sachin
On Jan 5, 2006, at 4:16 PM, Hernan Cunico wrote:
> Hi Jason,
> how is the installation doc coming, do you need any help on the
> confluence side?
>
> I saw what you started to work on the "Getting the source code"
> section, I would suggest to keep this task simple. We do not want
> to _scare_ the users with way too complicated commands and
> parameters, all at once.
>
> There are basically four steps to get the source and build
> Geronimo, so I would focus on those first.
>
> 1.- svn checkout https://svn.apache.org/repos/asf/geronimo/tags/
> 1.0.0/ <geronimo_home>
> 2.- cd <geronimo_home>
> 3.- maven m:fresh-checkout
> 4.- maven new
>
> Then, the next time you want to build you just do an update
>
> 1.- cd <geronimo_home>
> 2.- maven m:update
> 3.- maven m:fresh-checkout
Take out #3
> 4.- maven new
add -o
>
> (BTW, all the steps should be validated and make sure they are up-
> to-date)
>
> Once you explained the basics then you can go more in detail with
> all the other options for retrieving the source code and building
> Geronimo. It would also be nice to include common building errors,
> how to identify them, probable causes and solutions.
>
> Again, this is just a suggestion. What you think about this approach?
>
> As for update preference, I think is best to update as you go so
> everybody can test your instructions and provide early comments
> that will make corrections (if any) easier.
>
> Cheers!
> Hernan
>
> Jason Lenhart wrote:
>> Hi,
>> I am starting on the Installation section of the docs
>> - I have been running around like a maniac doing stuff
>> (mostly holiday things) - so I am a bit slow to
>> produce. But I am setting aside some time each day to
>> contribute more and more to the docs. If you start to
>> see me go off base - please feel free to call me out
>> :-D
>> Also - is the preference to complete a section and
>> then update? I started and updated but it is not
>> complete.
>> Thanks,
>> Jason
>>
>> __________________________________________ Yahoo! DSL – Something
>> to write home about. Just $16.99/mo. or less. dsl.yahoo.com
Re: Geronimo Installation Document Section
Posted by Hernan Cunico <hc...@gmail.com>.
Hi Jason,
how is the installation doc coming, do you need any help on the confluence side?
I saw what you started to work on the "Getting the source code" section, I would suggest to keep
this task simple. We do not want to _scare_ the users with way too complicated commands and
parameters, all at once.
There are basically four steps to get the source and build Geronimo, so I would focus on those first.
1.- svn checkout https://svn.apache.org/repos/asf/geronimo/tags/1.0.0/ <geronimo_home>
2.- cd <geronimo_home>
3.- maven m:fresh-checkout
4.- maven new
Then, the next time you want to build you just do an update
1.- cd <geronimo_home>
2.- maven m:update
3.- maven m:fresh-checkout
4.- maven new
(BTW, all the steps should be validated and make sure they are up-to-date)
Once you explained the basics then you can go more in detail with all the other options for
retrieving the source code and building Geronimo. It would also be nice to include common building
errors, how to identify them, probable causes and solutions.
Again, this is just a suggestion. What you think about this approach?
As for update preference, I think is best to update as you go so everybody can test your
instructions and provide early comments that will make corrections (if any) easier.
Cheers!
Hernan
Jason Lenhart wrote:
> Hi,
>
> I am starting on the Installation section of the docs
> - I have been running around like a maniac doing stuff
> (mostly holiday things) - so I am a bit slow to
> produce. But I am setting aside some time each day to
> contribute more and more to the docs. If you start to
> see me go off base - please feel free to call me out
> :-D
>
> Also - is the preference to complete a section and
> then update? I started and updated but it is not
> complete.
>
> Thanks,
>
> Jason
>
>
>
> __________________________________________
> Yahoo! DSL – Something to write home about.
> Just $16.99/mo. or less.
> dsl.yahoo.com
>
>