You are viewing a plain text version of this content. The canonical link for it is here.
Posted to users@qpid.apache.org by Radosław Śmigielski <ra...@alcatel-lucent.com> on 2014/08/25 14:35:15 UTC
Qpid quick start guide
Hi,
Qpid docs, seems to be missing "Quick Start Guide" type document.
I can say that from my personal perspective, person who 6 months
ago haven't had a clue such thing like qpid exists and needed to
quickly start with Qpid. To fill the gap I created draft of such
document, currently hosted on:
https://github.com/radeksm/qpid-quick-start
Content of this document covers below points:
1. Introduction
2. Installation
3. Configuration
4. Running qpid
5. Running qpid in HA
6. Testing and troubleshooting
Also here is a jira issue to track this:
https://issues.apache.org/jira/browse/QPID-6039
So following Alan Conway advice, he knows this document already
and advised me what to do next, I would like to ask Qpid Community
about feedback and review of this document by people who knows covered
areas better than I do. And maybe we can add this document to Qpid
documentation set at the end of this process.
====================================================
Radosław Śmigielski
ALCATEL-LUCENT - Cloudband/Node Team
---------------------------------------------------------------------
To unsubscribe, e-mail: users-unsubscribe@qpid.apache.org
For additional commands, e-mail: users-help@qpid.apache.org
Re: Qpid quick start guide
Posted by Radosław Śmigielski <ra...@alcatel-lucent.com>.
On Mon, Aug 25, 2014 at 09:04:06AM -0400, Justin Ross wrote:
> First, we should clarify what the intended scope of this is. From what I
> can tell, the content you have so far concerns the Qpid C++ broker and
> related admin tools. Qpid includes a number of other components (java
> broker, messaging apis, etc.), so we should say which are in play for this
> quick start.
Yes, absolutely agree. I am going to make sure scope will be clear.
> Second, we should look at your documentation next to the C++ broker book's
> intro[1], which tries to serve a similar purpose. I think you've done a
> better job than the broker book of bubbling up the central aspects of
> broker usage. For me, this is an exercise in sorting the things you really
> want to know early on in your use of the broker from the things you can
> dive deep on later on. For example, a quick start should tell you how to
> perform some basic control over logging but it should not go into details
> such as category exclusion. The latter should be reserved for a dedicated
> logging section.
Again, absolutely agree. Logging is very important and it's missing now.
====================================================
Radosław Śmigielski
ALCATEL-LUCENT - Cloudband/Node Team
---------------------------------------------------------------------
To unsubscribe, e-mail: users-unsubscribe@qpid.apache.org
For additional commands, e-mail: users-help@qpid.apache.org
Re: Qpid quick start guide
Posted by Justin Ross <jr...@apache.org>.
Hi, Radosław. This is great! I have a couple high-level comments.
First, we should clarify what the intended scope of this is. From what I
can tell, the content you have so far concerns the Qpid C++ broker and
related admin tools. Qpid includes a number of other components (java
broker, messaging apis, etc.), so we should say which are in play for this
quick start.
Second, we should look at your documentation next to the C++ broker book's
intro[1], which tries to serve a similar purpose. I think you've done a
better job than the broker book of bubbling up the central aspects of
broker usage. For me, this is an exercise in sorting the things you really
want to know early on in your use of the broker from the things you can
dive deep on later on. For example, a quick start should tell you how to
perform some basic control over logging but it should not go into details
such as category exclusion. The latter should be reserved for a dedicated
logging section.
[1]
http://qpid.apache.org/releases/qpid-0.28/cpp-broker/book/ch01.html#section-Running-a-Qpid-CPP-Broker
Justin
On Mon, Aug 25, 2014 at 8:35 AM, Radosław Śmigielski <
radoslaw.smigielski@alcatel-lucent.com> wrote:
> Hi,
> Qpid docs, seems to be missing "Quick Start Guide" type document.
> I can say that from my personal perspective, person who 6 months
> ago haven't had a clue such thing like qpid exists and needed to
> quickly start with Qpid. To fill the gap I created draft of such
> document, currently hosted on:
> https://github.com/radeksm/qpid-quick-start
>
> Content of this document covers below points:
> 1. Introduction
> 2. Installation
> 3. Configuration
> 4. Running qpid
> 5. Running qpid in HA
> 6. Testing and troubleshooting
>
> Also here is a jira issue to track this:
> https://issues.apache.org/jira/browse/QPID-6039
>
> So following Alan Conway advice, he knows this document already
> and advised me what to do next, I would like to ask Qpid Community
> about feedback and review of this document by people who knows covered
> areas better than I do. And maybe we can add this document to Qpid
> documentation set at the end of this process.
>
>
> ====================================================
> Radosław Śmigielski
> ALCATEL-LUCENT - Cloudband/Node Team
>
> ---------------------------------------------------------------------
> To unsubscribe, e-mail: users-unsubscribe@qpid.apache.org
> For additional commands, e-mail: users-help@qpid.apache.org
>
>
Re: Qpid quick start guide
Posted by "SUNDAY A. OLUTAYO" <ol...@sadeeb.com>.
----- Original Message -----
From: "Radosław Śmigielski" <ra...@alcatel-lucent.com>
To: users@qpid.apache.org
Sent: Monday, August 25, 2014 3:01:49 PM
Subject: Re: Qpid quick start guide
On Mon, Aug 25, 2014 at 09:01:18AM -0500, SUNDAY A. OLUTAYO wrote:
> This step is commendable, I have bein,g trying to get grasp of qpid for some weeks now.
>
Sunday, what was your main problem(s) you hit during deployment?
Have you installed it as a binary package or you compiled it yourself?
I installed binary package from ubuntu repo
The problem I had was in getting to know the use or distinct definition of each component such as:
proton, dispatch router and broker. The definition in the documentation is does not actually separate each components to where its belong
Sunday Olutayo
====================================================
Radosław Śmigielski
ALCATEL-LUCENT - Cloudband/Node Team
---------------------------------------------------------------------
To unsubscribe, e-mail: users-unsubscribe@qpid.apache.org
For additional commands, e-mail: users-help@qpid.apache.org
---------------------------------------------------------------------
To unsubscribe, e-mail: users-unsubscribe@qpid.apache.org
For additional commands, e-mail: users-help@qpid.apache.org
Re: Qpid quick start guide
Posted by "SUNDAY A. OLUTAYO" <ol...@sadeeb.com>.
The problem I had was in getting the use or distinct definition of each component such as:
proton, dispatch router and broker. The definition in the documentation is does not actually separate each components to where its belong
Thanks,
Sunday Olutayo
----- Original Message -----
From: "Radosław Śmigielski" <ra...@alcatel-lucent.com>
To: users@qpid.apache.org
Sent: Monday, August 25, 2014 3:01:49 PM
Subject: Re: Qpid quick start guide
On Mon, Aug 25, 2014 at 09:01:18AM -0500, SUNDAY A. OLUTAYO wrote:
> This step is commendable, I have bein,g trying to get grasp of qpid for some weeks now.
>
Sunday, what was your main problem(s) you hit during deployment?
Have you installed it as a binary package or you compiled it yourself?
====================================================
Radosław Śmigielski
ALCATEL-LUCENT - Cloudband/Node Team
---------------------------------------------------------------------
To unsubscribe, e-mail: users-unsubscribe@qpid.apache.org
For additional commands, e-mail: users-help@qpid.apache.org
---------------------------------------------------------------------
To unsubscribe, e-mail: users-unsubscribe@qpid.apache.org
For additional commands, e-mail: users-help@qpid.apache.org
Re: Qpid quick start guide
Posted by Radosław Śmigielski <ra...@alcatel-lucent.com>.
On Mon, Aug 25, 2014 at 09:01:18AM -0500, SUNDAY A. OLUTAYO wrote:
> This step is commendable, I have being trying to get grasp of qpid for some weeks now.
>
Sunday, what was your main problem(s) you hit during deployment?
Have you installed it as a binary package or you compiled it yourself?
====================================================
Radosław Śmigielski
ALCATEL-LUCENT - Cloudband/Node Team
---------------------------------------------------------------------
To unsubscribe, e-mail: users-unsubscribe@qpid.apache.org
For additional commands, e-mail: users-help@qpid.apache.org
Re: Qpid quick start guide
Posted by "SUNDAY A. OLUTAYO" <ol...@sadeeb.com>.
This step is commendable, I have being trying to get grasp of qpid for some weeks now.
Thanks,
Sunday Olutayo
----- Original Message -----
From: "Radosław Śmigielski" <ra...@alcatel-lucent.com>
To: users@qpid.apache.org
Sent: Monday, August 25, 2014 1:35:15 PM
Subject: Qpid quick start guide
Hi,
Qpid docs, seems to be missing "Quick Start Guide" type document.
I can say that from my personal perspective, person who 6 months
ago haven't had a clue such thing like qpid exists and needed to
quickly start with Qpid. To fill the gap I created draft of such
document, currently hosted on:
https://github.com/radeksm/qpid-quick-start
Content of this document covers below points:
1. Introduction
2. Installation
3. Configuration
4. Running qpid
5. Running qpid in HA
6. Testing and troubleshooting
Also here is a jira issue to track this:
https://issues.apache.org/jira/browse/QPID-6039
So following Alan Conway advice, he knows this document already
and advised me what to do next, I would like to ask Qpid Community
about feedback and review of this document by people who knows covered
areas better than I do. And maybe we can add this document to Qpid
documentation set at the end of this process.
====================================================
Radosław Śmigielski
ALCATEL-LUCENT - Cloudband/Node Team
---------------------------------------------------------------------
To unsubscribe, e-mail: users-unsubscribe@qpid.apache.org
For additional commands, e-mail: users-help@qpid.apache.org
---------------------------------------------------------------------
To unsubscribe, e-mail: users-unsubscribe@qpid.apache.org
For additional commands, e-mail: users-help@qpid.apache.org