---
title: Charmhub | Deploy Placement using Charmhub - The Open Operator Collection
description: Deploy the latest version of Placement on any cloud. OpenStack placement
  service
url: https://charmhub.io/placement
---

# Placement

[OpenStack Charmers](https://charmhub.io/publisher/openstack-charmers "View all packages from OpenStack Charmers")

* [OpenStack Charmers](https://charmhub.io/publisher/openstack-charmers "View all packages from OpenStack Charmers")
* [Cloud](https://charmhub.io/?filter=cloud)

Platform:

24.04

23.10

23.04

22.10

22.04

20.04

18.04

yoga/stable 98683f4

```
juju deploy placement --channel yoga/stable
```

[Learn to deploy on juju >](https://juju.is/docs/juju/manage-applications)

---

Share your thoughts on this charm with the community on discourse.

[Join the discussion](https://discourse.charmhub.io/)

# Overview

The placement charm deploys [Placement](https://docs.openstack.org/placement), the core OpenStack
API service that tracks the inventory and usage of various cloud resources
(e.g. compute, storage, network addresses). The charm works alongside other
Juju-deployed OpenStack services.

> **Note**: The placement charm is supported starting with OpenStack Train.

**Important:** This documentation supports version `3.x` of the Juju client.
See the [OpenStack Charm
guide](https://docs.openstack.org/charm-guide/latest/project/support-notes.html#breaking-changes-between-juju-2-9-x-and-3-x) if you are using the `2.9.x` client.

# Usage

## Configuration

This section covers common and/or important configuration options. See file
`config.yaml` for the full list of options, along with their descriptions and
default values. See the [Juju documentation](https://juju.is/docs/configuring-applications) for details
on configuring applications.

#### `openstack-origin`

The `openstack-origin` option states the software sources. A common value is an
OpenStack UCA release (e.g. ‘cloud:bionic-ussuri’ or ‘cloud:focal-victoria’).
See [Ubuntu Cloud Archive](https://wiki.ubuntu.com/OpenStack/CloudArchive). The underlying host’s existing apt
sources will be used if this option is not specified (this behaviour can be
explicitly chosen by using the value of ‘distro’).

## Deployment

Placement is often containerised. Here a single unit is deployed to a new
container on machine ‘1’:

```
juju deploy --to lxd:1 placement
```

Placement requires these applications to be present: keystone,
nova-cloud-controller, and a cloud database.

The database application is determined by the series. Prior to focal
[percona-cluster](https://jaas.ai/percona-cluster) is used, otherwise it is
[mysql-innodb-cluster](https://jaas.ai/mysql-innodb-cluster). In the example deployment
below mysql-innodb-cluster has been chosen.

```
juju deploy mysql-router placement-mysql-router
juju integrate placement-mysql-router:db-router mysql-innodb-cluster:db-router
juju integrate placement-mysql-router:shared-db placement:shared-db
```

Add relations to the remaining applications:

```
juju integrate placement:identity-service keystone:identity-service
juju integrate placement:placement nova-cloud-controller:placement
```

## Upgrading to OpenStack Train

Prior to OpenStack Train, the placement API was managed by the
nova-cloud-controller charm. Some extra steps are therefore needed when
performing a Stein to Train upgrade. The documented procedure can be found on
the [Special charm procedures](https://docs.openstack.org/project-deploy-guide/charm-deployment-guide/latest/upgrade-special.html) page in the [OpenStack
Charms Deployment Guide](https://docs.openstack.org/project-deploy-guide/charm-deployment-guide).

## High availability

When more than one unit is deployed with the [hacluster](https://jaas.ai/hacluster)
application the charm will bring up an HA active/active cluster.

There are two mutually exclusive high availability options: using virtual IP(s)
or DNS. In both cases the hacluster subordinate charm is used to provide the
Corosync and Pacemaker backend HA functionality.

See [Infrastructure high availability](https://docs.openstack.org/project-deploy-guide/charm-deployment-guide/latest/app-ha.html#ha-applications) in the [OpenStack Charms
Deployment Guide](https://docs.openstack.org/project-deploy-guide/charm-deployment-guide) for details.

# Documentation

The OpenStack Charms project maintains two documentation guides:

* [OpenStack Charm Guide](https://docs.openstack.org/charm-guide): for project information, including development
  and support notes
* [OpenStack Charms Deployment Guide](https://docs.openstack.org/project-deploy-guide/charm-deployment-guide): for charm usage information

# Bugs

Please report bugs on [Launchpad](https://bugs.launchpad.net/charm-placement/+filebug).

---

[Help improve this document in the forum](https://discourse.charmhub.io/t/placement-docs-index/10547) ([guidelines](https://discourse.charmhub.io/t/how-to-write-docs-our-documentation-guidelines-for-contributors/1245)). Last updated 3 years ago.