Red Hat Training

A Red Hat training course is available for Red Hat Fuse

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.
MessageDescription
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.
MessageDescription
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.
MessageDescription
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.
MessageDescription
Fabric profile groups server plugin is misconfigured—User Name property is not setFix the server plugin configuration in the JON server console.
Fabric profile groups server plugin is misconfigured—User Password property is not setFix the server plugin configuration in the JON server console.
Fabric profile groups server plugin is misconfigured—Recalculation Interval property is not setFix the server plugin configuration in the JON server console.
Property Registry URL must have a non-empty valueMissing 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.
MessageDescription
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.
MessageDescription
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.
MessageDescription
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.
MessageDescription
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.
MessageDescription
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
MessageDescription
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.
MessageDescription
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.
MessageDescription
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.