charm-nova-compute-proxy/README.md
James Page 69fc33656c Updates for alignment with RDO Mitaka
Misc updates as a result of testing with latest OpenStack Mitaka RDO
packages from IBM:

 - neutron.conf: disable neutron_rootwrap_daemon - non-functional.
 - nova.conf: set lock_path to /var/lib/nova/tmp inline with rpm
   packaging.
 - run proxy install process during config-changed, ensuring that
   any new compute hosts get installed and configured.
 - enable and start services on install, as rpm packages install
   disabled.
 - refactor use of proxy in hooks module to ensure its not created
   on module load, but as an when required.
 - change behaviour of remote-key to write key to secured local file,
   avoiding the need to run this charm from a local copy with the key
   embedded.

README updated for any behavioural changes in configuration.

Change-Id: I53d7331a2ddcf73bc41bc8d73be5bf165bf55a92
2016-11-09 13:14:18 +00:00

52 lines
2.2 KiB
Markdown

# Overview
*This charm is in ALPHA state, currently in active development.*
*Developers can be reached on freenode channel #openstack-charms.*
The nova-compute-proxy charm deploys OpenStack Nova Compute to a
pre-existing rpm-based Power8 PowerKVM or s390x z/KVM machine,
where the remainder of the Ubuntu OpenStack control plane and storage
applications are deployed to machines via MAAS.
# Usage
To deploy a nova-compute-proxy service, have the following prepared in
advance:
* PowerKVM or z/KVM machine(s) manually provisioned, booted, accessible from
the control plane units, with network interfaces and storage ready to use.
* An ssh key that the charm can use to remotely execute installation and
configuration operations.
* Yum repository/repositories or .iso file(s) which contain the appropriate
IBM OpenStack RPMs. If using .iso file(s), they must be loop-mounted
on the compute node host.
* Password-less sudo for the specified user configured on the compute node.
Once you have this setup you must configure the charm as follow:
* Apply the following charm config:
* remote-user: username used to access and configure the power node.
* remote-repos: Yum repository url(s) or file url(s)
* remote-hosts: IP address of power node
* remote-key: Private key string to use for access
* Example:
```
remote-user: youruser
remote-repos: file:///tmp/openstack-iso/openstack,file:///tmp/other-iso/repofs
remote-key: |
-----BEGIN DSA PRIVATE KEY-----
MIIBugIBAAKBgQD3IG188Q07kQdbRJhlZqknNpoGDB1r9+XGq9+7nmWGKusbOn6L
5VdyoHnx0BvgHHJmOAvJ+39sex9KvToEM0Jfav30EfffVzIrjaZZBMZkO/kWkEdd
TJrpMoW5nqiyNQRHCJWKkTiT7hNwS7AzUFkH1cR16bkabUfNhx3nWVsfGQIVAM7l
FlrJwujvWxOOHIRrihVmnUylAoGBAKGjWAPuj23p2II8NSTfaK/VJ9CyEF1RQ4Pv
+wtCRRE/DoN/3jpFnQz8Yjt6dYEewdcWFDG9aJ/PLvm/qX335TSz86pfYBd2Q3dp
9/RuaXTnLK6L/gdgkGcDXG8fy2kk0zteNjMjpzbaYpjZmIQ4lu3StUkwTm8EppZz
b0KXUNhwAn8bSTxNIZnlfoYzzwT2XPjHMlqeFbYxJMo9Dk5+AY6+tmr4/uR5ySDD
A+Txxh7RPhIBQwrIdGlOYOR3Mh03NcYuU+yrUsv4xLP8SeWcfiuAXFctXu0kzvPC
uIQ1EfKCrOtbWPcbza2ipo1J8MN/vzLCu69Jdq8af0OqJFoDcY0vAhUAxh2BNdRr
HyF1bGCP1t8JdMJVtb0=
-----END DSA PRIVATE KEY-----
remote-hosts: 10.10.10.10 10.10.10.11
```