activemq-dev mailing list archives

Site index · List index
Message view « Date » · « Thread »
Top « Date » · « Thread »
From Bruce Snyder <bruce.sny...@gmail.com>
Subject Re: [VOTE] Release Apollo 1.0 Beta 1 (2nd Attempt)
Date Sun, 03 Apr 2011 18:44:52 GMT
On Fri, Apr 1, 2011 at 9:57 AM, Hiram Chirino <hiram@hiramchirino.com> wrote:
> Hi all,
>
> The first release attempt had a fatal flaw (it did not run properly on
> linux) so I've recut a
> Apollo 1.0 beta 1 release candiate which addresses that issue.
>
> The new release candidate has been staged to nexus under:
> https://repository.apache.org/content/repositories/orgapacheactivemq-059/
>
> Binary distros can be found at:
> https://repository.apache.org/content/repositories/orgapacheactivemq-059/org/apache/activemq/apache-apollo/1.0-beta1/
>
> Source code distros can be found at:
> https://repository.apache.org/content/repositories/orgapacheactivemq-059/org/apache/activemq/apollo-project/1.0-beta1/
>
> The build was tagged at:
> http://svn.apache.org/repos/asf/activemq/activemq-apollo/tags/apollo-project-1.0-beta1/
>
> The project website for that version has been staged to:
> http://activemq.apache.org/apollo/versions/1.0-beta1/website/index.html
>
> Please vote to approve this release
>
> [ ] +1 Release the binary as Apache ActiveMQ 5.5.0
> [ ] -1 Veto the release (provide specific comments)

I haven't ever run Apollo, so here's what I did:

1) wget <url-to-tarball>
2) tar zxvf <path-to-tarball>
3) Look for help command:

$ ./bin/apollo --help
Command not found: --help

4) open readme.html
5) Click 'Getting Started Guide'
6) Read 'Installation' section; Set the APOLLO_HOME:

$ export APOLLO_HOME=`pwd`
$ echo $APOLLO_HOME
/Users/bsnyder/amq/apache-apollo-1.0-beta1

$ export PATH=$PATH:$APOLLO_HOME/bin

7) Read 'Install BDB'; Do I really need to install BDB first?; Skip
this for now
8) Read 'Creating a Broker Instance'; Hmm, I guess I need to do this:

$ ./bin/apollo create mybroker
Creating apollo instance at: mybroker
Generating ssl keystore...
Make sure the following directory is on your path:

   /Users/bsnyder/amq/apache-apollo-1.0-beta1/bin/bin

Then run the broker by executing:

   /Users/bsnyder/amq/apache-apollo-1.0-beta1/mybroker/bin/apollo-broker run

9) Read 'Updating the Configuration to use BDB'; Do I really need to
configure BDB?; Skip this for now
10) Read 'Running a Broker Instance'; Notice it sorta matches the
output from step 7 above; Run the broker:

$ ./mybroker/bin/apollo-broker run

    _____                .__  .__
   /  _  \ ______   ____ |  | |  |   ____
  /  /_\  \\____ \ /  _ \|  | |  |  /  _ \
 /    |    \  |_> >  <_> )  |_|  |_(  <_> )
 \____|__  /   __/ \____/|____/____/\____/
         \/|__|  Apache Apollo (1.0-beta1)


Loading configuration file
'/Users/bsnyder/amq/apache-apollo-1.0-beta1/mybroker/etc/apollo.xml'.
INFO  | OS     : Mac OS X 10.6.7
INFO  | JVM    : Java HotSpot(TM) 64-Bit Server VM 1.6.0_24 (Apple Inc.)
INFO  | Apollo : 1.0-beta1
INFO  | OS is restricting the open file limit to: 10240
INFO  | Starting store: jdbm2 store at
/Users/bsnyder/amq/apache-apollo-1.0-beta1/mybroker/data
INFO  | Store started
INFO  | Accepting connections at: tls://0.0.0.0:61614
INFO  | Accepting connections at: tcp://0.0.0.0:61613
INFO  | broker startup is taking a long time (1 seconds). Waiting on
jetty webserver
INFO  | Administration interface available at: http://127.0.0.1:61680/

OK, the broker is running.

11) Read the 'Verification' section. I guess I'll try to run the Ruby
examples, that's usually pretty easy.
12) Open another terminal
13) Install the Stomp gem:

$ gem install stomp
WARNING:  Installing to ~/.gem since /Library/Ruby/Gems/1.8 and
	  /usr/bin aren't both writable.
WARNING:  You don't have /Users/bsnyder/.gem/ruby/1.8/bin in your PATH,
	  gem executables will not run.
Successfully installed stomp-1.1.8
1 gem installed
Installing ri documentation for stomp-1.1.8...
Installing RDoc documentation for stomp-1.1.8...

14) Move into the examples/ruby dir to run the listener:

$ cd /Users/bsnyder/amq/apache-apollo-1.0-beta1/examples/ruby
$ ruby listener.rb

(No output) Is it running correctly?? I guess I'll run the publisher to see.

15) Open another terminal
16) Move into the examples/ruby dir to run the publisher:

$ cd /Users/bsnyder/amq/apache-apollo-1.0-beta1/examples/ruby
$ ruby publisher.rb
Sent 1000 messages
Sent 2000 messages
Sent 3000 messages
Sent 4000 messages
Sent 5000 messages
Sent 6000 messages
Sent 7000 messages
Sent 8000 messages
Sent 9000 messages
Sent 10000 messages

Ahh, OK, some output.

17) Switch back to the terminal where the listener is running and see output:

Received 1000 messages.
Received 2000 messages.
Received 3000 messages.
Received 4000 messages.
Received 5000 messages.
Received 6000 messages.
Received 7000 messages.
Received 8000 messages.
Received 9000 messages.
Received 10000 messages.
Received 10000 in 2.125227 seconds

OK, it seems to have run correctly. That probably means success.

18) Read the 'Web Administration' section
19) Click on the URL to see the web UI; not a lot here yet
20) Try to run the Java examples.

$ mvn install
...
Missing:
----------
1) org.fusesource.hawtbuf:hawtbuf:jar:1.3-SNAPSHOT

  Try downloading the file manually from the project website.

  Then, install it using the command:
      mvn install:install-file -DgroupId=org.fusesource.hawtbuf
-DartifactId=hawtbuf -Dversion=1.3-SNAPSHOT -Dpackaging=jar
-Dfile=/path/to/file

  Alternatively, if you host your own repository you can deploy the file there:
      mvn deploy:deploy-file -DgroupId=org.fusesource.hawtbuf
-DartifactId=hawtbuf -Dversion=1.3-SNAPSHOT -Dpackaging=jar
-Dfile=/path/to/file -Durl=[url] -DrepositoryId=[id]

  Path to dependency:
  	1) example:example:jar:1.0-SNAPSHOT
  	2) org.fusesource.stompjms:stompjms-client:jar:1.0-SNAPSHOT
  	3) org.fusesource.hawtbuf:hawtbuf:jar:1.3-SNAPSHOT

----------
1 required artifact is missing.

for artifact:
  example:example:jar:1.0-SNAPSHOT

from the specified remote repositories:
  central (http://repo1.maven.org/maven2),
  Fusesource Snapshots
(http://repo.fusesource.com/nexus/content/repositories/snapshots)

Oh good grief.


A simple README document should provide new users a deterministic,
step-by-step guide so that they know exactly what commands to run and
what to expect from those commands. I had to do a fair amount of
meandering to figure out how to get the broker running.

Are you sure you want to label this as a beta release? This should be
an alpha release, i.e., allow developers to kick the tires, make it
clear that it is not polished yet. I'm willing to help contribute to
these items, but this will take some time. I don't think that it
should be labeled as a beta release.

Just my $.02.

Bruce
-- 
perl -e 'print unpack("u30","D0G)U8V4\@4VYY9&5R\"F)R=6-E+G-N>61E<D\!G;6%I;\"YC;VT*"
);'

ActiveMQ in Action: http://bit.ly/2je6cQ
Blog: http://bruceblog.org/
Twitter: http://twitter.com/brucesnyder

Mime
View raw message