THIS IS A TEST INSTANCE. ALL YOUR CHANGES WILL BE LOST!!!!
...
Assuming that you have a running Karaf instance, you can register the Camel features descriptor:
| Code Block |
|---|
karaf@root> features:addurl mvn:org.apache.camel.karaf/apache-camel/2.8.2/xml/features
|
From Karaf 2.2.6 onwards this has been simplified as there is a new features:chooseurl command that is pre-setup for Camel
| Code Block |
|---|
karaf@root> features:chooseurl camel 2.9.1
|
Now, we have all Camel features available:
| Code Block |
|---|
karaf@root> features:list|grep -i camel
[uninstalled] [2.8.0 ] camel repo-0
[uninstalled] [2.8.0 ] camel-core repo-0
[uninstalled] [2.8.0 ] camel-spring repo-0
[uninstalled] [2.8.0 ] camel-blueprint repo-0
[uninstalled] [2.8.0 ] camel-test repo-0
[uninstalled] [2.8.0 ] camel-cxf repo-0
[uninstalled] [2.8.0 ] camel-cache repo-0
[uninstalled] [2.8.0 ] camel-castor repo-0
[uninstalled] [2.8.0 ] camel-crypto repo-0
[uninstalled] [2.8.0 ] camel-http repo-0
[uninstalled] [2.8.0 ] camel-http4 repo-0
[uninstalled] [2.8.0 ] camel-mina repo-0
[uninstalled] [2.8.0 ] camel-jetty repo-0
[uninstalled] [2.8.0 ] camel-servlet repo-0
[uninstalled] [2.8.0 ] camel-jms repo-0
...
|
To install Camel, just install the camel feature:
| Code Block |
|---|
karaf@root> features:install camel
|
...
For instance, if you want to use blueprint as Camel DSL, you have to install the camel-blueprint feature:
| Code Block |
|---|
karaf@root> features:install camel-blueprint
|
If, if your route, you use an endpoint like "stream:out", you have to install the camel-stream feature:
| Code Block |
|---|
karaf@root> features:install camel-stream
|
...
Command | Description |
|---|---|
camel:context-list | Lists the camel contexts available in the current Karaf instance |
camel:context-info | Displays detail information about a given Camel context |
camel:context-start | Starts the given Camel context |
camel:context-stop | Stops the given Camel context (it becomes unavailable and it can't be started afterwards) |
camel:route-list | Displays the list of Camel routes available in the current Karaf instance |
camel:route-info | Provides detail information about a Camel route |
camel:route-show | Renders the route in XML |
camel:route-start | Starts the given route. From Camel 2.10 onwards you can use * as wildcard to match multiple routes. |
camel:route-stop | Stops the given route. From Camel 2.10 onwards you can use * as wildcard to match multiple routes. |
camel:route-suspend | Suspends the given route. From Camel 2.10 onwards you can use * as wildcard to match multiple routes. |
camel:route-resume | Resumes the given route. From Camel 2.10 onwards you can use * as wildcard to match multiple routes. |
...
Command | Description |
|---|---|
camel:backlog-tracer-info | Provides detail information about the BacklogTracer |
camel:backlog-tracer-dump | To dump tracing on the console from the BacklogTracer |
camel:backlog-tracer-start | To start the BacklogTracer on route(s) |
camel:backlog-tracer-stop | To stop the BacklogTracer on route(s) |
camel:route-profile | To profile route(s) |
camel:route-reset-stats | To reset performance stats on the given route(s) |
Karaf commands in Camel 2.13 onwards
Command | Description |
|---|---|
camel:context-suspend | Suspends the given Camel context |
camel:context-resume | Resumes the given Camel context |
camel:context-list
The *camel:context-list* command displays the list of CamelContext available in the current Karaf instance:
| Code Block |
|---|
karaf@root> camel:context-list
Name Status Uptime
[66-camel-3 ] [Started ] [14.559 seconds ]
|
...
The *camel:route-list* command displays the list of Camel routes available in the current Karaf instance:
| Code Block |
|---|
karaf@root> camel:route-list
[route1 ]
|
You can also filter the routes by CamelContext:
| Code Block |
|---|
karaf@root> camel:route-list 66-camel-3
[route1 ]
|
...
add the *--verbose* option (following the context name) to also list the endpoints
| Code Block |
|---|
karaf@root> camel:context-info 66-camel-3
Camel Context 66-camel-3
Name: 66-camel-3
Version: 2.8.0
Status: Started
Uptime: 1 minute
Advanced
Auto Startup: true
Starting Routes: false
Suspended: false
Tracing: false
Properties
Components
timer
properties
log
Endpoints
timer://test
log://test
Routes
route1
Used Languages
|
...
The *camel:context-start* command starts a given CamelContext:
| Code Block |
|---|
karaf@root> camel:context-start 66-camel-3
|
...
The *camel:context-stop* command stops a given CamelContext:. After stopping the context it becomes unavailable and cannot be started again.
| Code Block |
|---|
karaf@root> karaf@root> camel:context-stop 66-camel-3
|
...
The *camel:route-info* command provides detail information about a Camel route:
| Code Block |
|---|
karaf@root> camel:route-info route1
Camel Route route1
Camel Context: 66-camel-3
Properties
id = route1
parent = 2e7aacc1
Statistics
Exchanges Total: 98
Exchanges Completed: 98
Exchanges Failed: 0
Min Processing Time: 1ms
Max Processing Time: 2ms
Mean Processing Time: 1ms
Total Processing Time: 134ms
Last Processing Time: 1ms
First Exchange Date: 2011-06-29 07:21:57
Last Exchange Completed Date: 2011-06-29 07:23:34
Definition
<?xml version="1.0" encoding="UTF-8" standalone="yes"?>
<route id="route1" xmlns="http://camel.apache.org/schema/spring">
<from uri="timer:test"/>
<to uri="log:test" id="to1"/>
</route>
|
...
The *camel:route-show* command renders the route in XML. It's independent from the DSL used to define the route:
| Code Block |
|---|
karaf@root> camel:route-show route1
<?xml version="1.0" encoding="UTF-8" standalone="yes"?>
<route id="route1" xmlns="http://camel.apache.org/schema/spring">
<from uri="timer:test"/>
<to uri="log:test" id="to1"/>
</route>
|
...
The *camel:route-start* command starts a Camel route:
| Code Block |
|---|
karaf@root> camel:route-start route1
|
...
The *camel:route-stop* command stops a Camel route:
| Code Block |
|---|
karaf@root> camel:route-stop route1
|
...
The *camel:route-suspend* command suspends a Camel route:
| Code Block |
|---|
karaf@root> camel:route-suspend route1
|
...
The *camel:route-resume* command resume a Camel route:
| Code Block |
|---|
karaf@root> camel:route-resume route1
|
...
The *camel:endpoint-list* command displays the list of the endpoints available in all camel contexts of the current Karaf instance:
| Code Block |
|---|
karaf@root> camel:endpoint-list
camel-id uri Status
[test ] [timer://test ] [Started ]
[test ] [direct://A ] [Started ]
|
It displays the context name/ID (used in others commands), the URI of the endpoint and the current status (started/stopped).
Camel 2.13 or newer:
camel:context-suspend
The *camel:context-suspend* command suspends a given CamelContext. It then may be resumed again.
| Code Block |
|---|
karaf@root> karaf@root> camel:context-suspend 66-camel-3
|
Tip: use TAB key for completion on the CamelContext name.
camel:context-resume
The *camel:context-resume* command resumes a given CamelContext. After that it returns to the started state.
| Code Block |
|---|
karaf@root> karaf@root> camel:context-resume 66-camel-3
|
Tip: use TAB key for completion on the CamelContext name.