Re: [stellation-res] CLI installation and STELLATION_HOME?

[Dave Shields <shields@xxxxxxxxxxxxxx>]

On Sun, Dec 22, 2002 at 10:17:47AM -0500, Mark C. Chu-Carroll wrote:
> On Sun, 2002-12-22 at 09:14, Ringo De Smet wrote:
> > Guys,
> > 
> > You all know that I have been away from Stellation work for quite a while.
> > As a result, I used the documentation on the Stellation website to build and
> > install the CLI version of Stellation. Although everything is explained
> > somewhere on the website, I couldn't find a good coherence in the docs. As a
> > result, I have bits and pieces of my Stellation setup scattered in three
> > different places:
> > 1) C:\Documents and Settings\opt\stellation-lib
> > 2) my source folder
> > 3) C:\Software\Stellation
> > 
> > As a user, I first of all want to install the software where *I* like it. So
> > I created "C:\Software\Stellation" and let my STELLATION_HOME point to that
> > folder. Then, I was too lazy to read all the little details on all the
> > different pages to get the system installed. I ran "ant -f build-core.xml"
> > in my core source folder and it barfed on not finding the cli code.
> > That's my first question: shouldn't the CLI build system not reside in the
> > cli CVS module and invoke the build of the core instead of vice versa?
> 
> Yes, you're right.
> 
> There are two problems here. 
> 
> First, we haven't finished adapting to
> the separation of the command-line from the core. Some of the impact of
> that is being deliberately delayed until the server code also gets 
> separated; and some of it we just haven't had time to work through
> yet. So I do think you're right: the build and test for the command-line
> should be pulled into the CLI command-line component, not the core.
> 
> Second, Dave wrote the scripts for building the downloadable source in
> a way that eliminates the Eclipse plugin structure, and combines the
> source directory; but the build script was written assuming that it
> would be run inside of the eclipse plugin directory structure. So this
> is a bug, and we're negotiating whether to change the directory
> structure of the download to match the Eclipse structure, or to
> change the ant script to allow it to work in either structure. I'm
> personally strongly in favor of preserving the plugin
> directory structure.
> 

The intent was -- and is -- that the download tar and zip files reflect
the existing directory structure. Unfortunately, as Mark notes above,
and I noted yesterday, this is not currently the case, as we failed to
update scripts to reflect the source re-org. That is why I opened 
Bugzilla 28778 yesterday.

The "src" distribution should consist of the plugins core and cli directories. 
The "bin" distribution is the same, except that it does not include "src" 
directories and build-core.xml, adding 'svc.jar' in their place.

> 
> > If you try to build Maven (http://jakarta.apache.org/turbine/maven) from
> > source, they try to limit the number of prerequisites before being able to
> > use Maven:
> > 
> > - you need a JDK (>= 1.3)
> > - you need a Ant installed and configures (>= 1.4)
> > - you checkout the Maven sources from their CVS
> > - you define MAVEN_HOME in your environment variables.
> > - you invoke "ant -f build-bootstrap.xml"
> > 
> > When the CVS sources are OK, you will end up with a working Maven
> > distribution in <MAVEN_HOME>.
> > 
> > I think we should do the same: let the user define STELLATION_HOME, check
> > out the sources and do a "ant -f build-cli.xml" from within the cli module.
> > If the cli module can't find the core module, the cli module will do a
> > checkout (long live the cvs task in Ant) and invoke the build of the core.
> > It will also retrieve the dependent libraries if not available.
> 
> I think you're mostly right. My one quibble is that I think that the
> whole Stellation source that's needed by the CLI should be part of a
> single download bundle. So there should be no need to put in ant code
> to do a CVS fetch of other Stellation components. Letting it hit our
> download site to grab our dependent libraries using the ftp task is
> probably fine.
> 
> 	-Mark
> 

The current scripts do not directly support downloading required external files.
As Mark notes, we may be able to do this via FTP once our new server is up and
running.

I am at work now, trying to put together a new current build with desired directory
structure. I'm keeping build-core.xml as is, except that I'm moving the tar/zip
creation tasks to current.xml. Though we may eventually want to move the script
tests from core to cli, that can wait for another day.

dave

-- 
Dave Shields, IBM Research, shields@xxxxxxxxxxxxxx.