h1. Deploy Cellar

This chapter describes how to deploy and start Cellar into a running Apache Karaf instance. This chapter
assumes that you already know Apache Karaf basics, especially the notion of features and shell usage.

h2. Registering Cellar features

Karaf Cellar is provided as a Karaf features XML descriptor.

Simply register the Cellar feature URL in your Karaf instance:

{code}
karaf@root> features:addurl mvn:org.apache.karaf.cellar/apache-karaf-cellar/2.2.1/xml/features
{code}

Now you have Cellar features available in your Karaf instance:

{code}
karaf@root> features:list|grep -i cellar
[uninstalled] [2.2.1          ] cellar                                                        Karaf clustering
[uninstalled] [2.2.1          ] cellar-webconsole                                             Karaf Cellar Webconsole Plugin
{code}

h2. Starting Cellar

To start Cellar in your Karaf instance, you only need to install the Cellar feature:

{code}
karaf@root> features:install cellar
{code}

You can now see the Cellar components (bundles) installed:

{code}
karaf@root> la|grep -i cellar
[  56] [Active     ] [Created     ] [       ] [   60] Apache Karaf :: Cellar :: Core (2.2.1)
[  57] [Active     ] [Created     ] [       ] [   60] Apache Karaf :: Cellar :: Config (2.2.1)
[  58] [Active     ] [Created     ] [       ] [   60] Apache Karaf :: Cellar :: Features (2.2.1)
[  59] [Active     ] [Created     ] [       ] [   60] Apache Karaf :: Cellar :: Bundle (2.2.1)
[  60] [Active     ] [Created     ] [       ] [   60] Apache Karaf :: Cellar :: Utils (2.2.1)
[  61] [Active     ] [Created     ] [       ] [   60] Apache Karaf :: Cellar :: Shell (2.2.1)
[  62] [Active     ] [            ] [       ] [   60] Apache Karaf :: Cellar :: Hazelcast (2.2.1)
{code}

And Cellar cluster commands are now available:

{code}
karaf@root> cluster:<TAB>
cluster:config-list           cluster:config-proplist       cluster:config-propset        cluster:consumer-start        cluster:consumer-status       cluster:consumer-stop         cluster:features-install      cluster:features-list
cluster:features-uninstall    cluster:group-create          cluster:group-delete          cluster:group-join            cluster:group-list            cluster:group-quit            cluster:group-set             cluster:handler-start
cluster:handler-status        cluster:handler-stop          cluster:list-nodes            cluster:ping                  cluster:producer-start        cluster:producer-status       cluster:producer-stop
{code}