anvil/docs/source/topics/qanda.rst
Stanislav Kudriashev 31f6fc18db Small documentation fix
* Fixed component origin parameters list
* Fixed small typo

Change-Id: Ifdb49627e7f4f8bf0a4165c5dac6d5a2c139ee8f
2014-02-10 18:36:45 +02:00

91 lines
3.1 KiB
ReStructuredText

.. _q-a:
=====================
Questions and Answers
=====================
How do I cause the anvil dependencies to be reinstalled?
--------------------------------------------------------
Anvil bootstraps itself via shell script (if you look at the code
in the file ``smithy`` you will see that it is actually a bash
script).
This bootstrapping occurs to ensure that anvils pypi/rpm/deb
dependencies are installed before anvil can actually be used.
To remove the files that are left behind to let the shell script
know when this happens delete files located at ``$HOME/.anvil_bootstrapped``
and at ``$PWD/.anvil_bootstrapped`` to cause bootstrapping to occur again.
Another way to make this happen temporarily is to use the following:
::
sudo BOOT_FILES=/dev/null ./smithy
This will make anvil think those files are coming from ``/dev/null``
which will always return nothing. Using the same variable
also allows you to retarget the locations where the ``smithy``
shell script will look for the 'marker' files if
you so choose (say in a continuous integration environment).
How do I run a specific OpenStack milestone?
--------------------------------------------
Anvil has the same tag names as OpenStack releases so to
run against a specific milestone of OpenStack just checkout the
same tag in anvil and run the same actions as
you would have ran previously.
An example of this, lets adjust ``nova`` to use the ``stable/essex`` branch.
- Open ``conf/origins/master.yaml`` file in your favorite editor
- Locate lines that describe the ``nova`` component
- Change branch parameter to the desired one
::
nova:
repo: git://github.com/openstack/nova.git
branch: stable/essex
- Component origin parameters are:
- ``repo: <repo_url>`` - required
- ``branch: <branch>`` - optional
- ``tag: <tag>`` - optional
If no branch nor tag parameters were specified then ``branch: master`` is used by default.
**Note:** tag overrides branch (so you can't really include both)
`OMG` the images take forever to download!
------------------------------------------
Sometimes the images that will be uploaded to glance take a long time to
download and extract and upload.
To adjust this edit ``conf/components/glance.yaml`` and change the following:
::
...
# List of images to download and install into glance.
image_urls:
- http://launchpad.net/cirros/trunk/0.3.0/+download/cirros-0.3.0-x86_64-uec.tar.gz
- http://smoser.brickies.net/ubuntu/ttylinux-uec/ttylinux-uec-amd64-11.2_2.6.35-15_1.tar.gz
To something like the following (shortening that list):
::
image_urls:
- http://launchpad.net/cirros/trunk/0.3.0/+download/cirros-0.3.0-x86_64-uec.tar.gz
This will remove the larger ubuntu image and just use the smaller `cirros`_ image (which should not take to long to upload).
Note that repeated downloads occur due to the fact that the files inside the image do not match the name of what is installed
into glance (this can be avoided by completely disabling the image uploading, see the persona file for the flag for this).
.. _cirros: https://launchpad.net/cirros