9.3. Exceptions
The Fuse Plugins for JON components throw the following exceptions:
ActiveMQDestinationComponent component
Note
JBoss A-MQ standalone. This component is used for connecting to an MQ destination.
| Message | Description |
|---|---|
Cannot invoke operation [<name>], as we can't connect to the MBean—is it down? |
Failure to invoke the specified JMX operation may be due to the failure to connect to the resource.
Check whether the server is running.
|
Missing operation compositeData[] browse([String selector]) |
The
browse operation is not supported.
This rarely occurs. Check whether you are using a version of ActiveMQ that supports the
browse operation for destinations.
|
FabricContainerDiscoveryComponent component
Note
FuseSource 7.x. This component is used for discovering fabric containers.
| Message | Description |
|---|---|
Missing Zookeeper library fabric-linkedin-zookeeper*.jar in <karafHome>/system> |
The specified library is missing from the <karafHome>/system directory.
This could indicate a potentially corrupt installation of FuseSource 7.x or JBoss Fuse 6.x that are missing
.jar files.
|
Missing value for property <property> in serviceUrl |
The specified JMX URL property is missing from the
etc/org.apache.karaf.management.cfg file and the etc/system.properties file.
Check whether the properties file has been corrupted.
|
FabricProfileGroupManager component
Note
FuseSource 7.z and JBoss Fuse 6.x. This component is used for managing fabric profile groups.
| Message | Description |
|---|---|
Error looking up MQ broker properties: <message> |
The specified error occurred when reading profile metadata.
May indicate there are connection issues with the Zookeeper server.
|
Error getting Parent profiles for <profileName>: <message> |
The specified error occurred when reading profile metadata.
May indicate there are connection issues with the Zookeeper server.
|
Unable to connect to Fabric Registry in <timeout> seconds |
The component failed to connect to Zookeeper within the allotted timeout period.
May indicate there are connection issues with the Zookeeper server.
|
Error processing server profile <profile>:<containerVersion>:<message> | The specified error occurred while reading the server profile. The message contains the details. |
Unknown metric <metricName> for resource <resourceKey> | Unable to recognize the specified metric. This exception will occur only if the plugin is broken. |
Error getting Server info from Fabric Registry: <message> |
The specified error occurred when reading server information from Fabric registry.
May indicate there are connection issues or a corrupted Zookeeper registry.
|
Error processing profiles for [<resourceKey>]: <message> | The specified error occurred when processing profiles. The message contains the details. |
FabricProfileGoupsComponent component
Note
JBoss Fuse 6.x. This component is used for maintaining the fabric profile groups server log file.
| Message | Description |
|---|---|
Fabric profile groups server plugin is misconfigured—User Name property is not set | Fix the server plugin configuration in the JON server console. |
Fabric profile groups server plugin is misconfigured—User Password property is not set | Fix the server plugin configuration in the JON server console. |
Fabric profile groups server plugin is misconfigured—Recalculation Interval property is not set | Fix the server plugin configuration in the JON server console. |
Property Registry URL must have a non-empty value | Missing registry URL in the plugin configuration. Fix the registry URL property under Server Plugin configuration in the JON server console. |
FuseMBeanResourceComponent component
Note
FuseSource 7.x, JBoss Fuse 6.x, ServiceMix 3.x, 4.x. This component is used for discovering Fuse MBeans.
| Message | Description |
|---|---|
EMS bean was null for Resource with type [<resourceType>] and statsObjectName key [<statsObjectName>]. |
The statistics MBean is missing. This exception rarely occurs. Caused by using an unsupported version of Karaf.
|
FuseServerComponent component
Note
FuseSource 7.x, JBoss Fuse 6.x, ServiceMix 3.x, 4.x. This component is used for establishing connections to Fuse servers.
| Message | Description |
|---|---|
Unsupported connection type descriptor <connectionTypeDescriptorClass> |
The JMX connection type is unsupported. This exception rarely occurs.
Report the exception to Red Hat Technical Support (see Note).
|
Failed to get JMX service URL using jvmstat | jvmstat was unable to get the JMX service URL. This exception occurs only when the JVM cannot attach to the process because, for example, something is wrong with the JVM installed on the machine or with the user's permissions to access the monitored Fuse process.
Report the exception to Red Hat Technical Support (see Note).
|
Failed to authenticate to managed JVM—principal and/or credentials connection properties are not set correctly |
A resource start error occurred. Fix the JMX user and password the Connection Settings in the JON console.
|
FuseServerDiscoveryComponent component
Note
FuseSource 7.x, JBoss Fuse 6.x, ServiceMix 3.x, 4.x. This component is used for discovering Fuse servers.
| Message | Description |
|---|---|
Home directory <homePath> does not exist |
The Karaf home directory does not exist. This exception rarely occurs, and indicates a corrupt or deleted installation.
|
Process [<pid>] with command line <commandLine> cannot be discovered because it does not specify -D<resourceKeyProperty>=UNIQUE_KEY |
Because the resource does not have the expected command line key, it cannot be discovered. This exception rarely occurs.
Report the exception to Red Hat Technical Support (see Note).
|
A connector address must be specified when manually adding a <resourceTypeName>. |
An error occurred when an attempt was made to manually add a resource.
In the JON server console, change the appropriate settings per error message for the manually added resource.
|
Failed to authenticate to <resourceTypeName> with connector address [<connectorAddress>]—principal and/or credentials connection properties are not set correctly. |
An error occurred when an attempt was made to manually add a resource.
In the JON server console, change the appropriate settings per error message for the manually added resource.
|
Failed to connect to <resourceTypeName> with connector address [<connectorAddress>]. |
An error occurred when an attempt was made to manually add a resource.
In the JON server console, change the appropriate settings per error message for the manually added resource.
|
Version file <versionFile> could not be found in <homePath> |
An error occurred when an attempt was made to manually add a resource.
In the JON server console, change the appropriate settings per error message for the manually added resource.
|
Error setting plugin properties, check agent log for details (you may have to enable debug first) |
An error occurred when an attempt was made to manually add a resource.
In the JON server console, change the appropriate settings per error message for the manually added resource.
|
Missing Property <connectorAddress> in Resource type <resourceType> | A plugin configuration error occurred that indicates the plugin is broken. This exception should never occur. |
Unable to get Process PID using java.lang.management.RuntimeMXBean for [<resourceTypeName>], with connector address [<connectorAddress>] |
An error occurred while attempting to discover a JVM process.
Send the agent log file with report to Red Hat Technical Support (see Note).
|
Error getting Process PID for resource [<resourceTypeName>] with JMX connector [<connectorAddress>]: <error-message> |
An error occurred while attempting to discover a JVM process.
Send the agent log file with report to Red Hat Technical Support (see Note).
|
GitDataStoreImpl component
Note
JBoss Fuse 6.1 and higher. This component is used for reading profile data stored in Git.
| Message | Description |
|---|---|
Error opening Fabric Git repo at [<gitRepo>]: <message> | Git repository error. Possible bad Git repository in Fabric. |
Missing Git <branch> | Git repository error. Possible bad Git repository in Fabric. |
Error looking up MQ broker properties: <message> | The specified error occurred when attempting to read the MQ broker's properties. The message contains the details. |
Error getting Parent profiles for <profileName>: <message> | The specified error occurred when attempting to read the specified profile. The message contains the details. |
JBossFuseContainerDiscovery component
Note
JBoss Fuse 6.x. This component is used for discovering JBoss Fuse containers.
| Message | Description |
|---|---|
Missing Zookeeper libraries fabric-linkedin-zookeeper-*.jar and fabric-zookeeper-*.jar in <karafHomePath>/system |
LinkedIn class loading error for v6.0. The specified
.jar files are missing from Karaf''s /system directory.
Check the installation.
|
Missing Google Guava library guava-*.jar in <karafHomePath>/system |
The class loader could not find the specified libraries in
<karafHomePath>/system.
Check the installation.
|
Missing JGit library fabric-git-1*.jar in <karafHomePath>/system |
Fabric Git repository class loading error for v6.1. The specified files are missing from Karaf''s
/system directory.
Check the installation.
|
Missing value for property <property> in serviceUrl |
JMX URL error reading from configuration property files.
Check Karaf properties for resolving serviceUrl in
etc/ directory.
|
JBossFuseProfileGroupManager component
Note
JBoss Fuse 6.x. This component is used for managing fabric profile groups on JBoss Fuse
| Message | Description |
|---|---|
Neither LinkedIn Zookeeper nor Apache Curator library was found | The specified libraries used for Zookeeper connections are missing. This exception should occur only if the installation was modified. |
Error processing Server Profile <profile>:<containerVersion>: <message> | An error occurred while processing the specified server's profile. |
Error processing Profile metadata for [resourceKey]: <message> | An error occurred while processing profile metadata for the specified resource. |
Unknown metric <metricName> for resource <resourceKey> | Unable to recognize the specified metric. This exception will occur only if the plugin is broken. |
JvmStatUtility component
Note
FuseSource 7.x, JBoss Fuse 6.x, ServiceMix 3.x, 4.x. This component is used for discovering JVMs.
| Message | Description |
|---|---|
Failed to extract JMX service URL for process with PID [<pid>] |
The Java process PID cannot be converted to an integer to extract the JMX URL using ConnectorAddressLink.importFrom(int).
Report the exception to Red Hat Technical Support (see Note).
|
LinkedInFabricRegistryImpl component
Note
JBoss Fuse version 6.0. This component implements connections to the Zookeeper registry using the linkedin-zk library.
| Message | Description |
|---|---|
Unable to connect to Fabric Registry in <timeout> seconds. |
The component failed to connect to Zookeeper within the allotted timeout period.
Check Zookeeper network connections.
|
Error looking up MQ broker properties: <message> | The specified error occurred when attempting to read the MQ broker's properties. The message contains the details. |
Error getting Parent profiles for <profileName>: <message> | The specified error occurred when attempting to read the specified parent profile. The message contains the details. |
