[jira] [Commented] (ARTEMIS-4538) Update mirroring documentation to clarify format of mirroring connection URIs

2023-12-15 Thread Robbie Gemmell (Jira)


[ 
https://issues.apache.org/jira/browse/ARTEMIS-4538?page=com.atlassian.jira.plugin.system.issuetabpanels:comment-tabpanel=17797259#comment-17797259
 ] 

Robbie Gemmell commented on ARTEMIS-4538:
-

The reference may not have existed at that time. I dont think it really makes 
sense to add something to the mirroring section specifically, when its already 
covered by the initial general section covering configuring a broker-connection 
at all, including the URL. Would we than also add it to the 4 other connection 
sub-element types, given the mirroring one is no different than the other 4 in 
this regard? I dont see that making sense. This is already just pointing out it 
is configured the same way this stuff is everywhere else in the broker, when 
nothing has been said to suggest otherwise. Once seems enough.

> Update mirroring documentation to clarify format of mirroring connection URIs
> -
>
> Key: ARTEMIS-4538
> URL: https://issues.apache.org/jira/browse/ARTEMIS-4538
> Project: ActiveMQ Artemis
>  Issue Type: Task
>Reporter: John Clifford
>Priority: Major
>
> The [Artemis 
> documentation|https://activemq.apache.org/components/artemis/documentation/latest/amqp-broker-connections.html]
>  explains how to make a connection for mirroring using the 
> {{}} configuration. However, it isn't clear what format the 
> connection URI takes. In particularly, it isn't clear how to configure it to 
> use TLS.
> I understand that the URI format is, in fact, the same as that used by other 
> Artemis network connections. I would not have guessed this, because Artemis 
> does not use AMQP for any of these other connections, and I just assumed that 
> AMQP mirroring connections would be configured differently.
> So I think all that is needed here is one additional line explaining this, 
> and perhaps linking to the relevant section of the docs. A specific example 
> of configuring a mirror connection using TLS would, I think, provide useful 
> additional help.



--
This message was sent by Atlassian Jira
(v8.20.10#820010)


[jira] [Commented] (ARTEMIS-4538) Update mirroring documentation to clarify format of mirroring connection URIs

2023-12-15 Thread John Clifford (Jira)


[ 
https://issues.apache.org/jira/browse/ARTEMIS-4538?page=com.atlassian.jira.plugin.system.issuetabpanels:comment-tabpanel=17797253#comment-17797253
 ] 

John Clifford commented on ARTEMIS-4538:


[~robbie] I guess the reporter was reading the Mirroring section in isolation 
so did not see the note about the connection URI being common and the reference 
to ssl example both of which are in the AMQ Connections section. Could we add a 
reference to the example in the mirroring section also?

> Update mirroring documentation to clarify format of mirroring connection URIs
> -
>
> Key: ARTEMIS-4538
> URL: https://issues.apache.org/jira/browse/ARTEMIS-4538
> Project: ActiveMQ Artemis
>  Issue Type: Task
>Reporter: John Clifford
>Priority: Major
>
> The [Artemis 
> documentation|https://activemq.apache.org/components/artemis/documentation/latest/amqp-broker-connections.html]
>  explains how to make a connection for mirroring using the 
> {{}} configuration. However, it isn't clear what format the 
> connection URI takes. In particularly, it isn't clear how to configure it to 
> use TLS.
> I understand that the URI format is, in fact, the same as that used by other 
> Artemis network connections. I would not have guessed this, because Artemis 
> does not use AMQP for any of these other connections, and I just assumed that 
> AMQP mirroring connections would be configured differently.
> So I think all that is needed here is one additional line explaining this, 
> and perhaps linking to the relevant section of the docs. A specific example 
> of configuring a mirror connection using TLS would, I think, provide useful 
> additional help.



--
This message was sent by Atlassian Jira
(v8.20.10#820010)


[jira] [Commented] (ARTEMIS-4538) Update mirroring documentation to clarify format of mirroring connection URIs

2023-12-15 Thread Robbie Gemmell (Jira)


[ 
https://issues.apache.org/jira/browse/ARTEMIS-4538?page=com.atlassian.jira.plugin.system.issuetabpanels:comment-tabpanel=17797239#comment-17797239
 ] 

Robbie Gemmell commented on ARTEMIS-4538:
-

The documentation has a specific note already that the TLS config for broker 
connections is in fact not configured differently than any other broker TLS 
connection config, just in case anyone should assume they were for $reasons I 
dont understand. There is also already a specific example showing how to 
configure TLS for an amqp broker connection: 
[https://github.com/apache/activemq-artemis-examples/tree/main/examples/features/broker-connection/amqp-sending-overssl.]

https://activemq.apache.org/components/artemis/documentation/latest/amqp-broker-connections.html#amqp-server-connections

"Note that the connection URI options for transport settings such as enabling 
and configuring TLS are common with other Artemis connector URIs. See [the 
transport 
doc|https://activemq.apache.org/components/artemis/documentation/latest/configuring-transports.html#configuring-netty-ssl]
 for more. An example configuration for a TLS AMQP broker-connection can be 
found in the broker examples at 
./examples/features/broker-connection/amqp-sending-overssl.

 

(The example reference could be updated for 2.32.0 to point to the new examples 
repo, I'll take of that under ARTEMIS-4533)

> Update mirroring documentation to clarify format of mirroring connection URIs
> -
>
> Key: ARTEMIS-4538
> URL: https://issues.apache.org/jira/browse/ARTEMIS-4538
> Project: ActiveMQ Artemis
>  Issue Type: Task
>Reporter: John Clifford
>Priority: Major
>
> The [Artemis 
> documentation|https://activemq.apache.org/components/artemis/documentation/latest/amqp-broker-connections.html]
>  explains how to make a connection for mirroring using the 
> {{}} configuration. However, it isn't clear what format the 
> connection URI takes. In particularly, it isn't clear how to configure it to 
> use TLS.
> I understand that the URI format is, in fact, the same as that used by other 
> Artemis network connections. I would not have guessed this, because Artemis 
> does not use AMQP for any of these other connections, and I just assumed that 
> AMQP mirroring connections would be configured differently.
> So I think all that is needed here is one additional line explaining this, 
> and perhaps linking to the relevant section of the docs. A specific example 
> of configuring a mirror connection using TLS would, I think, provide useful 
> additional help.



--
This message was sent by Atlassian Jira
(v8.20.10#820010)