1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
|
<?xml version="1.0" encoding="utf-8"?>
<!--
Licensed to the Apache Software Foundation (ASF) under one
or more contributor license agreements. See the NOTICE file
distributed with this work for additional information
regarding copyright ownership. The ASF licenses this file
to you under the Apache License, Version 2.0 (the
"License"); you may not use this file except in compliance
with the License. You may obtain a copy of the License at
http://www.apache.org/licenses/LICENSE-2.0
Unless required by applicable law or agreed to in writing,
software distributed under the License is distributed on an
"AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
KIND, either express or implied. See the License for the
specific language governing permissions and limitations
under the License.
-->
<section><title>
Qpid JMX Management Console FAQ
</title>
<!--
h3. {toggle-cloak:id=qManagementConsoleSecurity} How do I connect the management console to my broker using security ?
{cloak:id=qManagementConsoleSecurity}
The [Management Console Security] page will give you the instructions that you should use to set this up.
{cloak}
h3. {toggle-cloak:id=rmiServerHostname} I am unable to connect Qpid JMX MC/JConsole to a remote broker running on Linux, but connecting to localhost on that machine works ?
{cloak:id=rmiServerHostname}
The RMI based JMX ConnectorServer used by the broker requries two ports to operate. The console connects to an RMI Registry running on the primary (default 8999) port and retrieves the information actually needed to connect to the JMX Server. This information embeds the hostname of the remote machine, and if this is incorrect or unreachable by the connecting client the connection will fail.
This situation arises due to the hostname configuration on Linux and is generally encountered when the remote machine does not have a DNS hostname entry on the local network, causing the hostname command to return a loopback IP instead of a fully qualified domain name or IP address accessible by remote client machines. It is described in further detail at: http://java.sun.com/javase/6/docs/technotes/guides/management/faq.html#linux1
To remedy this issue you can set the _java.rmi.server.hostname_ system property to control the hostname/ip reported to the RMI runtime when advertising the JMX ConnectorServer. This can also be used to dictate the address returned on a computer with multiple network interfaces to control reachability. To do so, add the value _-Djava.rmi.server.hostname=<desired hostname/ip>_ to the QPID_OPTS environment variable before starting the _qpid-server_ script.
-->
<section role="h2" id="QpidJMXManagementConsoleFAQ-Errors"><title>
Errors
</title>
<section role="h3" id="QpidJMXManagementConsoleFAQ-HowdoIconnectthemanagementconsoletomybrokerusingsecurity-3F"><title>
How do I connect the management console to
my broker using security ?
</title>
<para>
The <xref linkend="qpid_Management-Console-Security"/> page will give you the instructions that you should
use to set this up.
</para>
<!--h3--></section>
<section role="h3" id="QpidJMXManagementConsoleFAQ-IamunabletoconnectQpidJMXMC-2FJConsoletoaremotebrokerrunningonLinux-2Cbutconnectingtolocalhostonthatmachineworks-3F"><title>
I am unable to connect Qpid JMX MC/JConsole
to a remote broker running on Linux, but connecting to localhost
on that machine works ?
</title>
<para>
The RMI
based JMX ConnectorServer used by the broker requries two ports
to operate. The console connects to an RMI Registry running on
the primary (default 8999) port and retrieves the information
actually needed to connect to the JMX Server. This information
embeds the hostname of the remote machine, and if this is
incorrect or unreachable by the connecting client the connection
will fail.
</para><para>
This
situation arises due to the hostname configuration on Linux and
is generally encountered when the remote machine does not have a
DNS hostname entry on the local network, causing the hostname
command to return a loopback IP instead of a fully qualified
domain name or IP address accessible by remote client machines.
It is described in further detail at: <xref linkend="qpid_faq"/>
</para><para>
To
remedy this issue you can set the
<emphasis>java.rmi.server.hostname</emphasis> system property to control the
hostname/ip reported to the RMI runtime when advertising the JMX
ConnectorServer. This can also be used to dictate the address
returned on a computer with multiple network interfaces to
control reachability. To do so, add the value
<emphasis>-Djava.rmi.server.hostname=<desired hostname/ip></emphasis>
to the QPID_OPTS environment variable before starting the
<emphasis>qpid-server</emphasis> script.
</para>
<!--h3--></section>
<!--h2--></section>
</section>
|
