--- title: Clearwater and Juju description: Like our sister project, Calico, we on the Project Clearwater team have been using Juju for some of our orchestration needs. In this blog post, I’m going to talk about what Juju is, why it’s a good fit for IMS orchestration, and what we’ve done recently on our Juju charms. Both the Calico blog linked […] url: https://canonical.com/blog/clearwater-and-juju?format=md --- 1. [Blog](https://canonical.com/blog) 2. Article --- [Canonical](https://canonical.com/blog/author/canonical "More about Canonical") 11 June 2015 # Clearwater and Juju [Clearwater](https://canonical.com/blog/tag/clearwater) [Juju](https://canonical.com/blog/tag/juju) [OpenStack](https://canonical.com/blog/tag/openstack) --- Share the article Like [our sister project](http://www.projectcalico.org/exploring-juju/), Calico, we on the Project Clearwater team have been using Juju for some of our orchestration needs. In this blog post, I’m going to talk about what Juju is, why it’s a good fit for IMS orchestration, and what we’ve done recently on our Juju charms. Both the Calico blog linked to above and the [main Juju site](https://jujucharms.com/about) talk about what Juju is in detail, so I’m only going to summarise it briefly here. Put simply, Juju is an orchestration platform – a way to automatically and repeatably deploy and configure network services, whether that’s a simple WordPress blog (the usual Juju example) or a full, interconnected IMS core like Clearwater. (Juju has some specific terminology – “charms” are configuration describing a specific service, and a “bundle” is a group of related charms). What’s different about Juju, compared to related tools like Chef or Puppet, is that instead of focusing on the details of deploying each node (what packages do I install, which config files do I write out), Juju is concerned with managing the relationships between nodes. Each node gets told when its “relations” join or depart the cluster, so that when a new Sprout node (for example) is added, all the Bono nodes learn about it and can start directing traffic to it. The concept of “relations” works particularly well for Clearwater, because there are well-defined and well-known IMS interfaces between nodes. For example, our clearwater-bono charm [exposes](https://github.com/Metaswitch/clearwater-juju/blob/dnsaas/charms/precise/clearwater-bono/metadata.yaml#L13) the IMS Mw interface for S-CSCFs to connect to, and the Gm interface for UEs. The fact that relationships are shown in the Juju GUI also means that your Clearwater deployment actually (kind of) looks like an IMS network diagram: Because Juju works on the level above Chef and Puppet like this, it’s possible to use them together – in fact, the [Juju FAQ](http://insights.ubuntu.com/2013/08/29/top-12-questions-about-juju/) encourages it. This is great for us – it means we can hook into our [existing Chef scripts](https://github.com/Metaswitch/chef) from our Juju charms, reuse all that battle-hardened code for installing the right packages and tweaking the right config files, and let Juju manage the deployment-wide picture and relationships. In the past couple of sprints (Dune and East of Eden), we’ve been making some improvements to our charms: besides general tidying-up and bug-fixing, we’ve now tested against the latest Juju version (1.23), successfully deployed Clearwater with Juju on OpenStack Juno (we’d previously only used Amazon EC2), and added a [clearwater-sipp charm](https://github.com/Metaswitch/clearwater-juju/tree/dnsaas/charms/precise/clearwater-sipp) for stress testing. If you’d like to see a three-minute video of a Clearwater system being managed and scaled by Juju, [there’s one on Youtube here](https://www.youtube.com/watch?v=Tsa0QgffZ28). If that whets your appetite, and you’d like to try this yourself, it’s pretty simple: * Follow the [Juju “Getting Started” guide](https://jujucharms.com/docs/stable/getting-started) to create an EC2 or OpenStack deployment* Install juju-deployer and git (sudo apt-get install juju-deployer git) * Follow our instructions at to deploy the Clearwater bundle * You now have your own, working, Clearwater IMS core – you’re ready to [make your first phone call](http://clearwater.readthedocs.org/en/latest/Making_your_first_call/index.html)! If you have problems or questions, you should check the [Juju documentation](https://jujucharms.com/docs/stable/about-juju) for help with Juju, and the Clearwater [troubleshooting guide](http://clearwater.readthedocs.org/en/latest/Troubleshooting_and_Recovery/index.html) and [general documentation](http://clearwater.readthedocs.org/) for Clearwater. First published on [www.projectclearwater.org](http://www.projectclearwater.org/clearwater-and-juju/) ### About the author Rob is a software engineer on the Project Clearwater team. Outside of work, he likes doing more open-source software development, knitting, and playing video games. Follow Rob on [Twitter](https://twitter.com/day_rk) ## Sign up for our newsletter Get the latest Canonical news and updates in your inbox. Work email: \*I agree to receive information about Canonical's products and services. By submitting this form, I confirm that I have read and agree to [Canonical's Privacy Policy](https://canonical.com/legal/dataprivacy). Sign up ## Share on --- ## Related posts [### How to set up a micro lab: four principles for a reliable homelab](https://canonical.com/blog/how-to-set-up-a-reliable-homelab) After over a decade of running a homelab, I have learned a few difficult lessons. Although it begins as a “lab,” you inevitably end up with something you want to keep. If a... [Jake Nabasny](https://canonical.com/blog/author/slapcat) 17 March 2026 [### Deploy your Spring Boot application to production](https://canonical.com/blog/deploy-spring-application-to-production) In this article we walk through the steps required to deploy a Spring Boot application to production using Juju and Kubernetes. The goal is to showcase the integration of the... [Javier de la Puente](https://canonical.com/blog/author/javierdelapuente) 13 January 2026 [### OpenStack cloud – happy 15th anniversary!](https://canonical.com/blog/openstack-cloud-happy-15th-anniversary) Happy birthday, OpenStack! It’s astonishing how fast time flies – fifteen years already. Yet, here we are: OpenStack cloud still stands as a de facto standard for open source... [Tytus Kurek](https://canonical.com/blog/author/tkurek) 7 October 2025 [### Join Canonical at the first-ever African OpenInfra Days](https://canonical.com/blog/join-canonical-at-the-first-ever-african-openinfra-days) For the second time, and in less than one month, Canonical is coming to East Africa! Three weeks ago, we had the first-ever UbuCon Africa, which was co-located with DjangoCon... [Sharon Koech](https://canonical.com/blog/author/skoech) 2 September 2025