Some Eclipse Foundation services are deprecated, or will be soon. Please ensure you've read this important communication.

Bug 361959

Summary:	Headless b3 aggregator documentation is incomplete
Product:	[Technology] CBI	Reporter:	Terry Parker <tparker>
Component:	CBI p2 Repository Aggregator	Assignee:	Project Inbox <b3.aggregator-inbox>
Status:	RESOLVED FIXED	QA Contact:
Severity:	major
Priority:	P3	CC:	david_williams, thomas
Version:	unspecified
Target Milestone:	---
Hardware:	All
OS:	All
Whiteboard:

Description Terry Parker

2011-10-25 12:44:01 EDT

Build Identifier: I20110613-1736

The documentation at http://wiki.eclipse.org/Eclipse_b3/aggregator/manual#Headless_installation gives instructions to download org.eclipse.b3.cli.product from http://download.eclipse.org/modeling/emft/b3/headless-3.7.  Further down on the same page http://wiki.eclipse.org/Eclipse_b3/aggregator/manual#Running_from_the_command_line, the documentation states that you can use the "b3 aggregate <options>" command to do an aggregation in headless mode.  But when I run the downloaded b3 executable the only available command is "runScript".  I haven't been able to find documentation for that command anywhere.  

The scenario I need described is a very common one:  I want to set up a mirroring operation using the Aggregator Editor and then take the resulting .b3aggr file and run it from a script in headless mode.  I was able to do this with the Eclipse 3.5 but don't see the path for doing this with the current version.  Is this still possible?  If not let me know and I'll file a separate bug.

Reproducible: Always

Comment 1 David Williams

2011-10-25 15:42:46 EDT

Not sure what that "b3" means ... but, if it helps, I use eclipse with the headless app ... something like 

eclipse -application org.eclipse.b3.cli.headless aggregate

Comment 2 Terry Parker

2011-11-01 19:24:33 EDT

(In reply to comment #1)
> Not sure what that "b3" means ... but, if it helps, I use eclipse with the
> headless app ... something like 
> 
> eclipse -application org.eclipse.b3.cli.headless aggregate

That is the missing piece.  If the text read:
  "eclipse -application org.eclipse.b3.cli.headless aggregate <options>" 
rather than 
  "b3 aggregate <options>"
it would be much more clear.

Comment 3 Thomas Hallgren

2011-11-03 03:59:45 EDT

The output of just running b3 is:

No command was specified

Usage: b3 command [options...]
 --eclipseLogLevel [DEBUG | INFO |      : Controls the verbosity of the eclipse
 WARNING | ERROR]                       : log trace output. Defaults to global
                                          b3 settings.
 --logLevel [DEBUG | INFO | WARNING |   : Controls the verbosity of the console
 ERROR]                                 : trace output. Defaults to global b3
                                          settings.
 --stacktrace                           : Display stack trace on error
 -? (--help)                            : Print help screen for specified
                                          command

Available commands:
aggregate - Aggregates source repositories into a resulting repository using aggregator definition
modify - Modifies the validationSets model from the command line
runScript - Runs a set of commands from a script file

Is the 'aggregate' command missing from your output? What download are you using in that case?

Comment 4 David Williams

2011-11-28 14:00:15 EST

(In reply to comment #3)
> The output of just running b3 is:
> 
> No command was specified
> 

For me, its 
$ b3
b3: command not found

:) 

I think the starting point for me and Terry is we install eclipse-SDK, then install b3 aggregator from update site. So, there is no "b3". I think I tried the "headless installation" years ago (with the p2 director download, b3 profile, etc.) ... but ... never really found a need for it. 

I'll add a short blurb to clarify command for SDK case.

Comment 5 David Williams

2011-11-28 14:07:13 EST

I've added this note: 

Note: if you install the aggregator into an Eclipse SDK or Platform (rather than a pure headless installation), you can run from the command line, by using
<pre>eclipse -application org.eclipse.b3.cli.headless aggregate <options></pre>

to 

http://wiki.eclipse.org/Eclipse_b3/aggregator/manual#Running_from_the_command_line

Comment 6 David Williams

2016-09-16 15:59:53 EDT

[Bookkeeping change only. Moving bugs to the new "home" of aggregator, CBI.
No change to assignee for resolved and verified bugs.]