Update the getting started docs.

Change-Id: If749de4712db84b148ec18174077338f2f3a1947
This commit is contained in:
Joshua Harlow 2013-06-01 18:21:52 -07:00
parent e994d88c74
commit 67ee943ed9
6 changed files with 1849 additions and 44 deletions

View File

@ -42,6 +42,6 @@ Hacking
Feel free to hack but please try to follow the `hacking guidelines`_
.. _apache version 2.0 license: https://github.com/yahoo/Openstack-Anvil/blob/master/LICENSE
.. _apache version 2.0 license: https://github.com/stackforge/anvil/blob/master/LICENSE
.. _launchpads issue tracking system: http://launchpad.net/anvil
.. _hacking guidelines: https://github.com/yahoo/Openstack-Anvil/blob/master/HACKING.md
.. _hacking guidelines: https://github.com/stackforge/anvil/blob/master/README.md

View File

@ -3,7 +3,32 @@
===============
Examples
===============
===============.
Bootstrapping
---------------------------
::
$ sudo ./smithy --bootstrap
.. literalinclude:: examples/bootstrap.txt
:language: none
:linenos:
Preparing
---------------------------
::
$ sudo ./smithy -a prepare
.. literalinclude:: examples/prepare.txt
:language: none
:linenos:
Installing
---------------------------

File diff suppressed because it is too large Load Diff

View File

@ -0,0 +1,342 @@
_ ___ ___ _ __ ___ _____ _ __ _
,' \ / o |/ _/ / |/ /,' _//_ _/.' \ ,'_/ / //7
/ o |/ _,'/ _/ / || /_\ `. / / / o // /_ / ,'
|_,'/_/ /___//_/|_//___,' /_/ /_n_/ |__//_/\\
Anvil: | 2013.1-dev |
And now for something completely different!
-----------------Action Runner------------------
INFO: @anvil.distro : Matched distro rhel for platform Linux-2.6.32-220.23.1.el6.YAHOO.20120713.x86_64-x86_64-with-redhat-6.2-Santiago
WARNING: @anvil.shell : Cannot escalate permissions to (uid=0, gid=0): [Errno 1] Operation not permitted
WARNING: @anvil.shell : Can not switch to user mode, no suid user id or suid group id
INFO: @anvil : Starting action prepare on 2013-06-02T01:42:01.909075 for distro: rhel
INFO: @anvil : Using persona: conf/personas/in-a-box/basic.yaml
INFO: @anvil : In root directory: /home/harlowja/openstack
INFO: @anvil.actions.base : Processing components for action prepare.
INFO: @anvil.actions.base : Activating in the following order:
INFO: @anvil.actions.base : |-- general
INFO: @anvil.actions.base : |-- db
INFO: @anvil.actions.base : |-- rabbit-mq
INFO: @anvil.actions.base : |-- oslo-config
INFO: @anvil.actions.base : |-- keystone
INFO: @anvil.actions.base : |-- keystone-client
INFO: @anvil.actions.base : |-- glance
INFO: @anvil.actions.base : |-- glance-client
INFO: @anvil.actions.base : |-- cinder-client
INFO: @anvil.actions.base : |-- quantum-client
INFO: @anvil.actions.base : |-- nova
INFO: @anvil.actions.base : |-- nova-client
INFO: @anvil.actions.base : Booting up your components.
INFO: @anvil.actions.base : Reading passwords using a unencrypted keyring @ /etc/anvil/passwords.cfg
INFO: @anvil.actions.base : Verifying that the components are ready to rock-n-roll.
INFO: @anvil.actions.base : Warming up component configurations.
INFO: @anvil.actions.prepare : Downloading general.
INFO: @anvil.actions.prepare : Performed 0 downloads.
INFO: @anvil.actions.prepare : Downloading db.
INFO: @anvil.actions.prepare : Performed 0 downloads.
INFO: @anvil.actions.prepare : Downloading rabbit-mq.
INFO: @anvil.actions.prepare : Performed 0 downloads.
INFO: @anvil.actions.prepare : Downloading oslo-config.
INFO: @anvil.components.base_install : Downloading from 1 uris:
INFO: @anvil.components.base_install : |-- git://github.com/openstack/oslo.config.git?tag=1.1.0b1
INFO: @anvil.downloader : Downloading git://github.com/openstack/oslo.config.git (master) to /home/harlowja/openstack/oslo-config/app.
INFO: @anvil.downloader : Adjusting to tag 1.1.0b1.
INFO: @anvil.actions.prepare : Performed 1 downloads.
INFO: @anvil.actions.prepare : Downloading keystone.
INFO: @anvil.components.base_install : Downloading from 1 uris:
INFO: @anvil.components.base_install : |-- git://github.com/openstack/keystone.git?tag=2013.1
INFO: @anvil.downloader : Downloading git://github.com/openstack/keystone.git (master) to /home/harlowja/openstack/keystone/app.
INFO: @anvil.downloader : Adjusting to tag 2013.1.
INFO: @anvil.actions.prepare : Performed 1 downloads.
INFO: @anvil.actions.prepare : Downloading keystone-client.
INFO: @anvil.components.base_install : Downloading from 1 uris:
INFO: @anvil.components.base_install : |-- git://github.com/openstack/python-keystoneclient.git?tag=0.2.3
INFO: @anvil.downloader : Downloading git://github.com/openstack/python-keystoneclient.git (master) to /home/harlowja/openstack/keystone-client/app.
INFO: @anvil.downloader : Adjusting to tag 0.2.3.
INFO: @anvil.actions.prepare : Performed 1 downloads.
INFO: @anvil.actions.prepare : Downloading glance.
INFO: @anvil.components.base_install : Downloading from 1 uris:
INFO: @anvil.components.base_install : |-- git://github.com/openstack/glance.git?tag=2013.1
INFO: @anvil.downloader : Downloading git://github.com/openstack/glance.git (master) to /home/harlowja/openstack/glance/app.
INFO: @anvil.downloader : Adjusting to tag 2013.1.
INFO: @anvil.actions.prepare : Performed 1 downloads.
INFO: @anvil.actions.prepare : Downloading glance-client.
INFO: @anvil.components.base_install : Downloading from 1 uris:
INFO: @anvil.components.base_install : |-- git://github.com/openstack/python-glanceclient.git?tag=0.9.0
INFO: @anvil.downloader : Downloading git://github.com/openstack/python-glanceclient.git (master) to /home/harlowja/openstack/glance-client/app.
INFO: @anvil.downloader : Adjusting to tag 0.9.0.
INFO: @anvil.actions.prepare : Performed 1 downloads.
INFO: @anvil.actions.prepare : Downloading cinder-client.
INFO: @anvil.components.base_install : Downloading from 1 uris:
INFO: @anvil.components.base_install : |-- git://github.com/openstack/python-cinderclient.git?tag=1.0.3
INFO: @anvil.downloader : Downloading git://github.com/openstack/python-cinderclient.git (master) to /home/harlowja/openstack/cinder-client/app.
INFO: @anvil.downloader : Adjusting to tag 1.0.3.
INFO: @anvil.actions.prepare : Performed 1 downloads.
INFO: @anvil.actions.prepare : Downloading quantum-client.
INFO: @anvil.components.base_install : Downloading from 1 uris:
INFO: @anvil.components.base_install : |-- git://github.com/openstack/python-quantumclient.git?tag=2.2.1
INFO: @anvil.downloader : Downloading git://github.com/openstack/python-quantumclient.git (master) to /home/harlowja/openstack/quantum-client/app.
INFO: @anvil.downloader : Adjusting to tag 2.2.1.
INFO: @anvil.actions.prepare : Performed 1 downloads.
INFO: @anvil.actions.prepare : Downloading nova.
INFO: @anvil.components.base_install : Downloading from 1 uris:
INFO: @anvil.components.base_install : |-- git://github.com/openstack/nova.git?tag=2013.1
INFO: @anvil.downloader : Downloading git://github.com/openstack/nova.git (master) to /home/harlowja/openstack/nova/app.
INFO: @anvil.downloader : Adjusting to tag 2013.1.
INFO: @anvil.actions.prepare : Performed 1 downloads.
INFO: @anvil.actions.prepare : Downloading nova-client.
INFO: @anvil.components.base_install : Downloading from 1 uris:
INFO: @anvil.components.base_install : |-- git://github.com/openstack/python-novaclient.git?tag=2.13.0
INFO: @anvil.downloader : Downloading git://github.com/openstack/python-novaclient.git (master) to /home/harlowja/openstack/nova-client/app.
INFO: @anvil.downloader : Adjusting to tag 2.13.0.
INFO: @anvil.actions.prepare : Performed 1 downloads.
INFO: @anvil.actions.prepare : Post-download patching general.
INFO: @anvil.actions.prepare : Post-download patching db.
INFO: @anvil.actions.prepare : Post-download patching rabbit-mq.
INFO: @anvil.actions.prepare : Post-download patching oslo-config.
INFO: @anvil.actions.prepare : Post-download patching keystone.
INFO: @anvil.actions.prepare : Post-download patching keystone-client.
INFO: @anvil.actions.prepare : Post-download patching glance.
INFO: @anvil.actions.prepare : Post-download patching glance-client.
INFO: @anvil.actions.prepare : Post-download patching cinder-client.
INFO: @anvil.actions.prepare : Post-download patching quantum-client.
INFO: @anvil.actions.prepare : Post-download patching nova.
INFO: @anvil.actions.prepare : Post-download patching nova-client.
INFO: @anvil.actions.prepare : Packing OpenStack and its dependencies
INFO: @anvil.packaging.base : Full known Python dependency list:
INFO: @anvil.packaging.base : |-- Cheetah>=2.4.4
INFO: @anvil.packaging.base : |-- WebOb==1.2.3
INFO: @anvil.packaging.base : |-- amqplib>=0.6.1
INFO: @anvil.packaging.base : |-- anyjson>=0.2.4
INFO: @anvil.packaging.base : |-- argparse
INFO: @anvil.packaging.base : |-- babel>=0.9.6
INFO: @anvil.packaging.base : |-- boto
INFO: @anvil.packaging.base : |-- cliff-tablib>=1.0
INFO: @anvil.packaging.base : |-- cliff>=1.3.1
INFO: @anvil.packaging.base : |-- coverage>=3.6
INFO: @anvil.packaging.base : |-- discover
INFO: @anvil.packaging.base : |-- distribute>=0.6.24
INFO: @anvil.packaging.base : |-- eventlet>=0.9.17
INFO: @anvil.packaging.base : |-- feedparser
INFO: @anvil.packaging.base : |-- fixtures>=0.3.12
INFO: @anvil.packaging.base : |-- greenlet>=0.3.1
INFO: @anvil.packaging.base : |-- httplib2
INFO: @anvil.packaging.base : |-- iso8601>=0.1.4
INFO: @anvil.packaging.base : |-- jsonschema>=0.7,<2
INFO: @anvil.packaging.base : |-- keyring
INFO: @anvil.packaging.base : |-- kombu>=1.0.4
INFO: @anvil.packaging.base : |-- lxml>=2.3
INFO: @anvil.packaging.base : |-- mock
INFO: @anvil.packaging.base : |-- mox==0.5.3
INFO: @anvil.packaging.base : |-- mysql-python
INFO: @anvil.packaging.base : |-- netaddr>=0.7.6
INFO: @anvil.packaging.base : |-- netifaces
INFO: @anvil.packaging.base : |-- nose
INFO: @anvil.packaging.base : |-- nose-exclude
INFO: @anvil.packaging.base : |-- nosehtmloutput>=0.0.3
INFO: @anvil.packaging.base : |-- nosexcover
INFO: @anvil.packaging.base : |-- openstack.nose-plugin>=0.7
INFO: @anvil.packaging.base : |-- oslo.config>=1.1.0
INFO: @anvil.packaging.base : |-- pam>=0.1.4
INFO: @anvil.packaging.base : |-- paramiko
INFO: @anvil.packaging.base : |-- passlib
INFO: @anvil.packaging.base : |-- paste
INFO: @anvil.packaging.base : |-- pastedeploy>=1.5.0
INFO: @anvil.packaging.base : |-- pep8==1.3.3
INFO: @anvil.packaging.base : |-- prettytable>=0.6,<0.8
INFO: @anvil.packaging.base : |-- psycopg2
INFO: @anvil.packaging.base : |-- pyOpenSSL
INFO: @anvil.packaging.base : |-- pyasn1
INFO: @anvil.packaging.base : |-- pycrypto>=2.1.0alpha1
INFO: @anvil.packaging.base : |-- pyflakes
INFO: @anvil.packaging.base : |-- pylint==0.25.2
INFO: @anvil.packaging.base : |-- pyparsing>=1.5.6,<2.0
INFO: @anvil.packaging.base : |-- pysendfile==2.0.0
INFO: @anvil.packaging.base : |-- pysqlite
INFO: @anvil.packaging.base : |-- python-ldap==2.3.13
INFO: @anvil.packaging.base : |-- python-memcached
INFO: @anvil.packaging.base : |-- python-subunit
INFO: @anvil.packaging.base : |-- requests>=1.0.0
INFO: @anvil.packaging.base : |-- routes>=1.12.3
INFO: @anvil.packaging.base : |-- setuptools-git>=0.4
INFO: @anvil.packaging.base : |-- simplejson
INFO: @anvil.packaging.base : |-- sphinx>=1.1.2
INFO: @anvil.packaging.base : |-- sqlalchemy-migrate>=0.7.2
INFO: @anvil.packaging.base : |-- sqlalchemy>=0.7.8,<=0.7.9
INFO: @anvil.packaging.base : |-- stevedore>=0.7
INFO: @anvil.packaging.base : |-- suds>=0.4
INFO: @anvil.packaging.base : |-- testrepository>=0.0.13
INFO: @anvil.packaging.base : |-- testtools>=0.9.27
INFO: @anvil.packaging.base : |-- unittest2
INFO: @anvil.packaging.base : |-- warlock>=0.7.0,<2
INFO: @anvil.packaging.base : |-- websockify<0.4
INFO: @anvil.packaging.base : |-- webtest
INFO: @anvil.packaging.base : |-- wsgiref
INFO: @anvil.packaging.base : |-- xattr>=0.6.0
INFO: @anvil.packaging.yum : Building openstack-deps RPM
WARNING: @anvil.shell : Cannot escalate permissions to (uid=0, gid=0): [Errno 1] Operation not permitted
Loaded plugins: kabi, presto, remove-with-leaves, versionlock
Loading support for Red Hat kernel ABI
WARNING: @anvil.shell : Can not switch to user mode, no suid user id or suid group id
WARNING: @anvil.shell : Cannot escalate permissions to (uid=0, gid=0): [Errno 1] Operation not permitted
WARNING: @anvil.shell : Can not switch to user mode, no suid user id or suid group id
WARNING: @anvil.shell : Cannot escalate permissions to (uid=0, gid=0): [Errno 1] Operation not permitted
WARNING: @anvil.shell : Can not switch to user mode, no suid user id or suid group id
INFO: @anvil.packaging.yum : These Python packages are already available as RPMs:
INFO: @anvil.packaging.yum : |-- amqplib>=0.6.1 as python-amqplib-0.6.1 from epel
INFO: @anvil.packaging.yum : |-- anyjson>=0.2.4 as python-anyjson-0.3.1 from epel
INFO: @anvil.packaging.yum : |-- argparse as python-argparse-1.2.1 from installed
INFO: @anvil.packaging.yum : |-- boto as python-boto-2.5.2 from installed
INFO: @anvil.packaging.yum : |-- eventlet>=0.9.17 as python-eventlet-0.9.17 from epel
INFO: @anvil.packaging.yum : |-- feedparser as python-feedparser-5.0.1 from epel
INFO: @anvil.packaging.yum : |-- fixtures>=0.3.12 as python-fixtures-0.3.12 from epel
INFO: @anvil.packaging.yum : |-- greenlet>=0.3.1 as python-greenlet-0.3.1 from epel
INFO: @anvil.packaging.yum : |-- httplib2 as python-httplib2-0.7.7 from epel
INFO: @anvil.packaging.yum : |-- iso8601>=0.1.4 as python-iso8601-0.1.4 from installed
INFO: @anvil.packaging.yum : |-- keyring as python-keyring-0.7 from installed
INFO: @anvil.packaging.yum : |-- kombu>=1.0.4 as python-kombu-1.1.3 from epel
INFO: @anvil.packaging.yum : |-- mock as python-mock-0.8.0 from epel
INFO: @anvil.packaging.yum : |-- mox==0.5.3 as python-mox-0.5.3 from epel
INFO: @anvil.packaging.yum : |-- mysql-python as MySQL-python-1.2.3 from base
INFO: @anvil.packaging.yum : |-- netifaces as python-netifaces-0.5 from installed
INFO: @anvil.packaging.yum : |-- nose as python-nose-0.10.4 from base
INFO: @anvil.packaging.yum : |-- paramiko as python-paramiko-1.7.5 from installed
INFO: @anvil.packaging.yum : |-- passlib as python-passlib-1.5.3 from epel
INFO: @anvil.packaging.yum : |-- paste as python-paste-1.7.4 from updates
INFO: @anvil.packaging.yum : |-- prettytable>=0.6,<0.8 as python-prettytable-0.6.1 from epel
INFO: @anvil.packaging.yum : |-- psycopg2 as python-psycopg2-2.0.14 from updates
INFO: @anvil.packaging.yum : |-- pyOpenSSL as pyOpenSSL-0.10 from base
INFO: @anvil.packaging.yum : |-- pyasn1 as python-pyasn1-0.0.12a from base
INFO: @anvil.packaging.yum : |-- pyflakes as pyflakes-0.4.0 from epel
INFO: @anvil.packaging.yum : |-- pyparsing>=1.5.6,<2.0 as pyparsing-1.5.6 from epel
INFO: @anvil.packaging.yum : |-- pysendfile==2.0.0 as pysendfile-2.0.0 from epel
INFO: @anvil.packaging.yum : |-- python-memcached as python-memcached-1.43 from updates
INFO: @anvil.packaging.yum : |-- requests>=1.0.0 as python-requests-1.1.0 from epel
INFO: @anvil.packaging.yum : |-- simplejson as python-simplejson-2.0.9 from base
INFO: @anvil.packaging.yum : |-- stevedore>=0.7 as python-stevedore-0.8 from epel
INFO: @anvil.packaging.yum : |-- suds>=0.4 as python-suds-0.4.1 from base
INFO: @anvil.packaging.yum : |-- testtools>=0.9.27 as python-testtools-0.9.29 from epel
INFO: @anvil.packaging.yum : |-- unittest2 as python-unittest2-0.5.1 from epel
INFO: @anvil.packaging.yum : |-- websockify<0.4 as python-websockify-0.2.0 from epel
INFO: @anvil.packaging.yum : |-- webtest as python-webtest-1.2 from base
INFO: @anvil.packaging.base : Downloading Python dependencies:
INFO: @anvil.packaging.base : |-- Cheetah>=2.4.4
INFO: @anvil.packaging.base : |-- WebOb==1.2.3
INFO: @anvil.packaging.base : |-- babel>=0.9.6
INFO: @anvil.packaging.base : |-- cliff-tablib>=1.0
INFO: @anvil.packaging.base : |-- cliff>=1.3.1
INFO: @anvil.packaging.base : |-- coverage>=3.6
INFO: @anvil.packaging.base : |-- discover
INFO: @anvil.packaging.base : |-- distribute>=0.6.24
INFO: @anvil.packaging.base : |-- jsonschema>=0.7,<2
INFO: @anvil.packaging.base : |-- lxml>=2.3
INFO: @anvil.packaging.base : |-- netaddr>=0.7.6
INFO: @anvil.packaging.base : |-- nose-exclude
INFO: @anvil.packaging.base : |-- nosehtmloutput>=0.0.3
INFO: @anvil.packaging.base : |-- nosexcover
INFO: @anvil.packaging.base : |-- openstack.nose-plugin>=0.7
INFO: @anvil.packaging.base : |-- pam>=0.1.4
INFO: @anvil.packaging.base : |-- pastedeploy>=1.5.0
INFO: @anvil.packaging.base : |-- pep8==1.3.3
INFO: @anvil.packaging.base : |-- pycrypto>=2.1.0alpha1
INFO: @anvil.packaging.base : |-- pylint==0.25.2
INFO: @anvil.packaging.base : |-- pysqlite
INFO: @anvil.packaging.base : |-- python-ldap==2.3.13
INFO: @anvil.packaging.base : |-- python-subunit
INFO: @anvil.packaging.base : |-- routes>=1.12.3
INFO: @anvil.packaging.base : |-- setuptools-git>=0.4
INFO: @anvil.packaging.base : |-- sphinx>=1.1.2
INFO: @anvil.packaging.base : |-- sqlalchemy-migrate>=0.7.2
INFO: @anvil.packaging.base : |-- sqlalchemy>=0.7.8,<=0.7.9
INFO: @anvil.packaging.base : |-- testrepository>=0.0.13
INFO: @anvil.packaging.base : |-- warlock>=0.7.0,<2
INFO: @anvil.packaging.base : |-- wsgiref
INFO: @anvil.packaging.base : |-- xattr>=0.6.0
INFO: @anvil.packaging.base : You can watch progress in another terminal with
INFO: @anvil.packaging.base : tail -f /home/harlowja/openstack/deps/pip-install-download.out
INFO: @anvil.packaging.yum : Building RPM packages from files:
INFO: @anvil.packaging.yum : |-- /home/harlowja/openstack/deps/download/Babel-0.9.6.zip
INFO: @anvil.packaging.yum : |-- /home/harlowja/openstack/deps/download/Cheetah-2.4.4.tar.gz
INFO: @anvil.packaging.yum : |-- /home/harlowja/openstack/deps/download/Jinja2-2.7.tar.gz
INFO: @anvil.packaging.yum : |-- /home/harlowja/openstack/deps/download/Markdown-2.3.1.tar.gz
INFO: @anvil.packaging.yum : |-- /home/harlowja/openstack/deps/download/MarkupSafe-0.18.tar.gz
INFO: @anvil.packaging.yum : |-- /home/harlowja/openstack/deps/download/PasteDeploy-1.5.0.tar.gz
INFO: @anvil.packaging.yum : |-- /home/harlowja/openstack/deps/download/Pygments-1.6.tar.gz
INFO: @anvil.packaging.yum : |-- /home/harlowja/openstack/deps/download/Routes-1.13.tar.gz
INFO: @anvil.packaging.yum : |-- /home/harlowja/openstack/deps/download/SQLAlchemy-0.7.9.tar.gz
INFO: @anvil.packaging.yum : |-- /home/harlowja/openstack/deps/download/Sphinx-1.2b1.tar.gz
INFO: @anvil.packaging.yum : |-- /home/harlowja/openstack/deps/download/Tempita-0.5.1.tar.gz
INFO: @anvil.packaging.yum : |-- /home/harlowja/openstack/deps/download/WebOb-1.2.3.tar.gz
INFO: @anvil.packaging.yum : |-- /home/harlowja/openstack/deps/download/cliff-1.3.3.tar.gz
INFO: @anvil.packaging.yum : |-- /home/harlowja/openstack/deps/download/cliff-tablib-1.0.tar.gz
INFO: @anvil.packaging.yum : |-- /home/harlowja/openstack/deps/download/cmd2-0.6.5.1.tar.gz
INFO: @anvil.packaging.yum : |-- /home/harlowja/openstack/deps/download/colorama-0.2.5.tar.gz
INFO: @anvil.packaging.yum : |-- /home/harlowja/openstack/deps/download/coverage-3.6.tar.gz
INFO: @anvil.packaging.yum : |-- /home/harlowja/openstack/deps/download/decorator-3.4.0.tar.gz
INFO: @anvil.packaging.yum : |-- /home/harlowja/openstack/deps/download/discover-0.4.0.tar.gz
INFO: @anvil.packaging.yum : |-- /home/harlowja/openstack/deps/download/distribute-0.6.45.tar.gz
INFO: @anvil.packaging.yum : |-- /home/harlowja/openstack/deps/download/docutils-0.10.tar.gz
INFO: @anvil.packaging.yum : |-- /home/harlowja/openstack/deps/download/extras-0.0.3.tar.gz
INFO: @anvil.packaging.yum : |-- /home/harlowja/openstack/deps/download/fixtures-0.3.12.tar.gz
INFO: @anvil.packaging.yum : |-- /home/harlowja/openstack/deps/download/jsonpatch-1.0.tar.gz
INFO: @anvil.packaging.yum : |-- /home/harlowja/openstack/deps/download/jsonpointer-1.0.tar.gz
INFO: @anvil.packaging.yum : |-- /home/harlowja/openstack/deps/download/jsonschema-1.3.0.tar.gz
INFO: @anvil.packaging.yum : |-- /home/harlowja/openstack/deps/download/logilab-astng-0.24.3.tar.gz
INFO: @anvil.packaging.yum : |-- /home/harlowja/openstack/deps/download/logilab-common-0.59.1.tar.gz
INFO: @anvil.packaging.yum : |-- /home/harlowja/openstack/deps/download/lxml-3.2.1.tar.gz
INFO: @anvil.packaging.yum : |-- /home/harlowja/openstack/deps/download/netaddr-0.7.10.zip
INFO: @anvil.packaging.yum : |-- /home/harlowja/openstack/deps/download/nose-1.3.0.tar.gz
INFO: @anvil.packaging.yum : |-- /home/harlowja/openstack/deps/download/nose-exclude-0.1.9.tar.gz
INFO: @anvil.packaging.yum : |-- /home/harlowja/openstack/deps/download/nosehtmloutput-0.0.4.tar.gz
INFO: @anvil.packaging.yum : |-- /home/harlowja/openstack/deps/download/nosexcover-1.0.8.tar.gz
INFO: @anvil.packaging.yum : |-- /home/harlowja/openstack/deps/download/openstack.nose_plugin-0.11.tar.gz
INFO: @anvil.packaging.yum : |-- /home/harlowja/openstack/deps/download/pam-0.1.4.tar.gz
INFO: @anvil.packaging.yum : |-- /home/harlowja/openstack/deps/download/pep8-1.3.3.tar.gz
INFO: @anvil.packaging.yum : |-- /home/harlowja/openstack/deps/download/prettytable-0.7.2.zip
INFO: @anvil.packaging.yum : |-- /home/harlowja/openstack/deps/download/pycrypto-2.6.tar.gz
INFO: @anvil.packaging.yum : |-- /home/harlowja/openstack/deps/download/pylint-0.25.2.tar.gz
INFO: @anvil.packaging.yum : |-- /home/harlowja/openstack/deps/download/pyparsing-1.5.7.tar.gz
INFO: @anvil.packaging.yum : |-- /home/harlowja/openstack/deps/download/pysqlite-2.6.3.tar.gz
INFO: @anvil.packaging.yum : |-- /home/harlowja/openstack/deps/download/python-ldap-2.3.13.tar.gz
INFO: @anvil.packaging.yum : |-- /home/harlowja/openstack/deps/download/python-mimeparse-0.1.4.tar.gz
INFO: @anvil.packaging.yum : |-- /home/harlowja/openstack/deps/download/python-subunit-0.0.12.tar.gz
INFO: @anvil.packaging.yum : |-- /home/harlowja/openstack/deps/download/repoze.lru-0.6.tar.gz
INFO: @anvil.packaging.yum : |-- /home/harlowja/openstack/deps/download/setuptools-git-1.0b1.tar.gz
INFO: @anvil.packaging.yum : |-- /home/harlowja/openstack/deps/download/sqlalchemy-migrate-0.7.2.tar.gz
INFO: @anvil.packaging.yum : |-- /home/harlowja/openstack/deps/download/tablib-0.9.11.tar.gz
INFO: @anvil.packaging.yum : |-- /home/harlowja/openstack/deps/download/termcolor-1.1.0.tar.gz
INFO: @anvil.packaging.yum : |-- /home/harlowja/openstack/deps/download/testrepository-0.0.15.tar.gz
INFO: @anvil.packaging.yum : |-- /home/harlowja/openstack/deps/download/testtools-0.9.31.tar.gz
INFO: @anvil.packaging.yum : |-- /home/harlowja/openstack/deps/download/unittest2-0.5.1.zip
INFO: @anvil.packaging.yum : |-- /home/harlowja/openstack/deps/download/warlock-1.0.0.tar.gz
INFO: @anvil.packaging.yum : |-- /home/harlowja/openstack/deps/download/wsgiref-0.1.2.zip
INFO: @anvil.packaging.yum : |-- /home/harlowja/openstack/deps/download/xattr-0.6.4.tar.gz
INFO: @anvil.packaging.yum : You can watch progress in another terminal with
INFO: @anvil.packaging.yum : tail -f /home/harlowja/openstack/deps/py2rpm.deps.out
INFO: @anvil.packaging.yum : Building RPM packages for directories:
INFO: @anvil.packaging.yum : |-- /home/harlowja/openstack/cinder-client/app
INFO: @anvil.packaging.yum : |-- /home/harlowja/openstack/glance-client/app
INFO: @anvil.packaging.yum : |-- /home/harlowja/openstack/glance/app
INFO: @anvil.packaging.yum : |-- /home/harlowja/openstack/keystone-client/app
INFO: @anvil.packaging.yum : |-- /home/harlowja/openstack/keystone/app
INFO: @anvil.packaging.yum : |-- /home/harlowja/openstack/nova-client/app
INFO: @anvil.packaging.yum : |-- /home/harlowja/openstack/nova/app
INFO: @anvil.packaging.yum : |-- /home/harlowja/openstack/oslo-config/app
INFO: @anvil.packaging.yum : |-- /home/harlowja/openstack/quantum-client/app
INFO: @anvil.packaging.yum : You can watch progress in another terminal with
INFO: @anvil.packaging.yum : tail -f /home/harlowja/openstack/deps/py2rpm.openstack.out
INFO: @anvil.packaging.yum : Creating repo at /home/harlowja/openstack/deps/openstack-deps
INFO: @anvil.packaging.yum : Creating repo at /home/harlowja/openstack/deps/openstack-deps-sources
INFO: @anvil.packaging.yum : Writing anvil.repo to /home/harlowja/openstack/deps/anvil.repo
INFO: @anvil.actions.base : Tearing down your components.
INFO: @anvil : It took 691.522 seconds or 11.53 minutes to complete action prepare.
____________________
/ Australia! \
| Australia! |
| Australia! |
\ We love you, amen. /
--------------------
\ ^__^
\ (oo)\_______
(__)\ )\/\
||----w |
|| ||

View File

@ -2,56 +2,53 @@
Features
========
- A set of configuration files (in yaml format) that shows common/component/distribution configurations
- A set of configuration files (in yaml format) that shows common/component/distribution configurations.
- Supports the following *actions* on the various `OpenStack`_ components.
* **Installing**:
* Downloading source from git, archive urls (ie launchpad tarballs) or local files
* Downloading source from git and performing tag/branch checkouts automatically.
* Verifying that the ``test-requires`` and ``pip-requires`` files have packages that can be
translated to a known `pypi`_ or apt/yum package
* Installing those dependencies (handling `pypi`_ and apt/yum packaging specifics for you)
* Configuring the needed files, symlinks, adjustments, tweaks (and so on...)
translated to a known `pypi`_/rpm package (or building said package to satisfy said translation).
* Installing or building those dependencies & handling `pypi`_ and rpm/yum packaging specifics for you.
* Configuring the needed files, symlinks, adjustments, tweaks...
* **Starting**: starting of the components sub-programs with
the needed configuration via the common `daemon`_ model
the needed configuration via the common `daemon`_ model
* Also creates a ``pid``, ``stderr`` and ``stdout`` file set for debugging/examination
* Also creates a ``pid``, ``stderr`` and ``stdout`` file set for debugging/examination.
* **Stopping**: stopping of the previously started components
* **Stopping**: stopping of the previously started components
* **Uninstalling**: getting you back to an initial 'clean' state
* Removing installed configuration
* Undoing of installed files/directories
* Removing of packages installed
* Removing installed configuration.
* Undoing of installed files/directories.
* Removing of packages installed.
* **Testing**: running each components unit tests (and in the future performing a simple set of integration tests)
* **Packaging**: creating a basic set of packages for the desired distributions
* **Packaging**: creating a basic set of packages that matches the components selected
- Supports automatic injection of dependencies, creation of change log from git history...
* **Status**: checking the status of the running components sub-programs
- Supports **dry-run** mode (to see what *would* happen)
- Tracking of all actions taken by a component via append-only files (mainly for uninstall, but useful for analysis)
- Supports **dry-run** mode (to see what *would* happen).
- Written in **python** so it matches the style of other `OpenStack`_ components.
- **Code decoupling** (thus encouraging re-use by others)
* Components/actions are isolated as individual classes (and so on).
* Components/actions are isolated as individual classes...
* Supports installation *personas* that define what is to be installed, thus
decoupling the 'what' from the 'how'.
- Extensively documented **distribution specifics** (also decoupled)
* See the ``conf/distros`` directory for examples
- **Install/start/stop... resumption** so that when you install you can ``ctrl+c`` and resume later (where applicable).
- Extensive **logging** (and debug mode)
* All commands ran are logged, all configuration files read/write...
- **Package/pip tracking**
- **Package tracking and building**
* Anvil can create a single rpm of your installation, as well as build or include all needed dependencies so that
the software that is installed can be installed repeatedly and reliably in the future.
* This allows for installations to use the distributions native packages (when applicable)
as well as provides a list of pips which should be packaged by that distribution before the given `OpenStack`_ release
is stabilized.

View File

@ -22,14 +22,18 @@ Read the great documentation for developers/admins at
- http://docs.openstack.org/
This will vastly help you understand what the
configurations and options do when anvil configures them.
configurations and options do when ANVIL configures them.
Linux
-----
One of the tested Linux distributions (RHEL 6.2+ until further updated)
One of the tested distributions.
You can get RHEL 6.2+ (**64-bit** is preferred) from http://rhn.redhat.com/.
- RHEL 6.2+
- CentOS 6.2+
- Oracle Enteprise Linux 6.2+
You can get CentOS 6.2+ (**64-bit** is preferred) from https://www.centos.org/
Networking
----------
@ -91,8 +95,7 @@ Also disable selinux:
$ sudo vi /etc/sysconfig/selinux
Change *SELINUX=enforcing* to *SELINUX=disabled* then it seems you need
to reboot.
Change *SELINUX=enforcing* to *SELINUX=disabled* then reboot.
::
@ -110,7 +113,7 @@ This can be typically solved by running the following (and then updating the ``i
$ sudo chmod -R a+rwx /home/openstack
Also as documented at http://docs.openstack.org/essex/openstack-compute/admin/content/qemu.html#fixes-rhel-qemu
please run the following (after installation).
please run the following (**after** installation).
::
@ -150,7 +153,7 @@ http://www.techotopia.com/index.php/Creating_an_RHEL_5_KVM_Networked_Bridge_Inte
Pre-installing
----------
--------------
In order to ensure that anvil will have its correct dependencies you need to first run the
bootstrapping code that will setup said dependencies for your operating system.
@ -159,6 +162,23 @@ bootstrapping code that will setup said dependencies for your operating system.
sudo ./smithy --bootstrap
Preparing
---------
Now prepare *OpenStacks* components by running the following:
::
./smithy -a prepare
You should see a corresponding OpenStack repositories getting downloaded using
git, python setups occurring and configuration files being written as well as
rpm packages being built (and a repository setup from those components) that
will allow you to reliably and repeatly install the OpenStack components and
there dependencies as ANVIL figures out how to prepare your desired components (if you
desire more informational output add a ``-v``to that
command).
Installing
----------
@ -169,10 +189,9 @@ Now install *OpenStacks* components by running the following:
sudo ./smithy -a install
You should see a set of distribution packages and/or pips being
installed, python setups occurring and configuration files being written
as ANVIL figures out how to install your desired components (if you
desire more informational output add a ``-v``to that
command).
installed and configuration files being written as ANVIL figures out how to
install your desired components from the prepared packages built in the last
step (if you desire more informational output add a ``-v``to that command).
Testing
----------
@ -196,18 +215,12 @@ Now that you have installed *OpenStack* you can now start your
sudo ./smithy -a start
Check horizon
~~~~~~~~~~~~~
Check horizon (if applicable)
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
Once that occurs you should be able to go to your hosts ip with a web
browser and view horizon which can be logged in with the user ``admin``
and the password you entered when prompted for
``Enter a password to use for horizon and keystone``. If you let the
system auto-generate one for you you will need to check the final output
of the above install and pick up the password that was generated which
should be displayed at key ``passwords/horizon_keystone_admin``. You can
also later find this authentication information in the generated
``passwords.yaml`` file.
and the password you entered when prompted for.
If you see a login page and can access horizon then:
@ -238,7 +251,7 @@ EC2 apis run the following to get your EC2 certs:
::
./euca.sh $OS_USERNAME $OS_TENANT_NAME
./tools/euca.sh $OS_USERNAME $OS_TENANT_NAME
It broke?
~~~~~~~~~