* Only tox has to be installed via pip, everything else is in virtual
environment. Nose is no longer used.
* One should NOT run other tox commands in an existing tox environment.
This is not how tox is intended to be used, and it cause weird failures
or seemingly random virtual environment rebuilds.
* Drop statement about running unit tests on a clear VM. Not sure where it
comes from, only tox and setuptools are required to run unit tests,
and they don't mess with system packages. Only leave note about devstack,
as people seem to have problems with it.
Change-Id: Ie7d0172b66231cfd8f9c4f8f2d76604a187443b0
Pillow now requires to have libjpeg installed, this change adds it
to the list of binary dependencies for unit tests in developer
quickstart guide.
Closes-bug: #1516782
Change-Id: Id779c97de4ec6830117120a3311500d1dc6fc7f6
To run a specific unit test using ostestr (instead of testr), the '-r'
argument needs to be specified. This updates the developer documention
to reflect this.
By default, ostestr runs the tests in parallel, so the (incorrect)
example for running them in parallel was removed.
Change-Id: I01be19d4419155b7bb5367a14a585a1016bc799f
This updates the documentation on installing mariaDB on
Fedora/RHEL/CentOS. The mariadb-server package is needed.
Change-Id: I1cc617f9311ad203d863c22de440f8bb103e7a1d
Fedora 22 doesn't ship "yum" anymore it now uses "dnf". So this patch
is updating the documentation examples to reflect that.
Co-Authored-By: Vladyslav Drok <vdrok@mirantis.com>
Change-Id: I1b96ba29d4699cc59d686104e968e7d35c874f0d
Added a note to make it clear that the developer should set up the environment
on a clean install to avoid conflicting devstack dependency config problems.
Change-Id: I81bba0ff33b33a026a3effc0ad71d9019df17582
Fix markup so that directions for MySQL database setup
look right in HTML.
Also, remove the conductor step from the API section since
the command is missing and the conductor has its own step.
Change-Id: Ibddf50527b5cc76c2dd06323ac46ba78431671d1
The docs were saying to use:
tox -evenv -- echo 'done'
Which would create the virtualenv 'venv' but then error.
Update the docs to do:
tox -evenv --notest
Change-Id: Ibe1dfd8748535c75040a8d8ef6d33d0791d022d1
Changed dev quick start instructions to include installing gcc and
python3-devel as these are required to be present on (at least)
Fedora 21 server.
Change-Id: I576231cc3ecfda6407279b0326dbe54a408a64e0
The virtualenv in the python-ironicclient now installs the 'ironic'
program by default into the bin directory of the 'venv' environment. It
is no longer needed to manually call setup.py
Remove that line from the instructions.
Change-Id: I25fffa41cb4e806d20484ce3423943c91d8ca38e
This patch adds a vagrantfile and ansible playbook that captures
the instructions from the ironic developer quickstart. By using
'vagrant up', and configuring your local dev instance to use
192.168.99.11, you should be able to exercise your services locally.
Documentation has also been updated.
Change-Id: Ic4f42e59cbda968d301c797ef77ff98030c55c41
Fix and enhance some parts of the "Exercising the Services Locally"
documentation. Also, this patch is updating the RHEL instructions to
support RHEL7 (not RHEL6).
Change-Id: I23618962d24856074e7b1b06e68e82e64f904ed4
Graphviz is needed for generating the state machine diagram
(eg, via 'tox -egenstates'). It is added to the list of packages
to install.
The instructions for installing on openSUSE and SLE are a bit
more involved, so I've added a URL that describes how to do that.
Change-Id: I16380bc88fcecc6911f21b4554b04a9d72b2d66b
Before, the " and ' in the message was rendering into smart quotes,
making copy+paste impossible. This fix places the commands inside the
note into a blockquote, preventing sphinx from breaking copy+paste.
Change-Id: I7291f7cbdb9c7fa16d23376792012a7a70c7c16b
Devstack create multiple networks, a Network ID has to be specific
when boot a instance with admin account.
Change-Id: I2cc0835950a57560493ee11089d89cd3a471125c
The ipmitool package was missing for the Ubuntu package list in
the quickstart guide. This has to be installed for the examples.
Change-Id: If7ec49540f9c46d96b5b381ebad6e652f5c90af8
This is provided by the package `psmisc` on all three documented
distributions.
Change-Id: Ie0e5b7c20e2ba701d75ed2853190b318c63c0413
Closes-bug: 1358820
The devstack section of the developer's quick-start documentation is
updated:
1. replaces the https://devstack.org link (doesn't work) with
http://docs.openstack.org/developer/devstack/
2. clarifies how to configure usage of the PXE or agent driver
Change-Id: I2220f685c862832f73b28157355e11c7b49ce29b
Closes-Bug: #1400461
Turns out certain versions of Ubuntu packages tox to use Python
3, which breaks installing MySQL-Python into 2.x virtualenvs.
Since we already have "pip install tox" in these docs, let's
stick with that method rather than depending on what distros do.
Also remove other packages from SUSE line that are
duplicated by the "pip install" line.
Change-Id: I472704ab879446586ec7fa7ecd79da4f7212b81d
Closes-Bug: 1399463
Replace URLs for workflow documentation to appropriate parts of the
OpenStack Project Infrastructure Manual.
Dropped sections that duplicate each other after the change.
Co-Authored-By: Dmitry Tantsur <dtantsur@redhat.com>
Change-Id: I233df03368dbb4b7805d6dce28de00fa037353c7
Documented what the settings are in the localrc, as well as adding the
credentials for swift so when your localrc is setup as documented,
devstack runs without prompting.
Change-Id: Ie965a6c3b4f97b14e97e78e8cf77c789a891a387
Certain prerequisites are not found by yum by default on RHEL. The yum
command specified in the RHEL instructions for installing prerequisites
fails to install python-pip and git-review. Adding a sentence directing
readers to use the EPEL software repository which has the missing
packages.
Closes-Bug: 1392355
Change-Id: Ibcbe9ff9e5d8eeb9f2511915d67dc53ac1dc1b63
Conductor has problems if ipmitool is absent on dev
machines. So add ipmitool as install prerequisite.
Closes-Bug: #1387495
Change-Id: I0f52f63ab2478634f6650657fd120e14a9b7925b
* added unspecifed required package "python-tox" for Ubuntu/Debian,
and removed "py26" from "tox.ini" so that "tox" command doesn't
invoke the tests in Python 2.6 environment.
Change-Id: I57df22a54fc08f2bb53a17d13b70706952815871
Closes-Bug: #1392304
We already use tox to generate the sample configuration, run the tests,
etc.. This patch is adding a new 'gendocs' tox job for generating the
documentation. I always have a hard time remembering the syntax to
generate the docs, by adding it to tox I hope it may facilitate it a bit.
You can now (re)generate the docs with this tox job:
tox -egendocs
The quick start guide was also updated with the new command.
Change-Id: I6a755c31382310420d706e51a3e014941fd49872
Our tests now require the binary "msgfmt" to be installed. This is
provided by the gettext package on Ubuntu and Fedora, and the
gettext-runtime package on OpenSuSE.
Change-Id: Ib8da08a89506325cacdd387728562a714f6b1119
The ironic-dbsync utility was updated with a new 'create_schema'
command with this review:
https://review.openstack.org/107629
This updates the quickstart guide to use this new command. We also
change the deploy guide to use it, mainly for consistency of usage
in our documentation.
Change-Id: I2b0e8620c1143822c1ba263d4004499ad5ea9cff
Closes-Bug: #1347604
We no longer test deploying Devstack + Ironic on Precise 12.04 anywhere,
so we should no longer promise that it is functional there. This removes steps
of the DevStack documentation that sets up access to the Cloud Archive and
explains that Ubuntu 14.04 is the minimum supported OS.
Closes-bug: 1371300
Change-Id: I99b7705c2c78443c7a95ff499b8c9fde33964c46
The current docs fail with the following error:
$ image=$(nova image-list | egrep "$DEFAULT_IMAGE_NAME[^-]" | awk '{print $2 }')
zsh: bad math expression: operand expected at `^-'
With this change, these docs work as expected for zsh users.
Change-Id: I56c39718cfe40208f62ea4786d684f6b24431ed9
The command to query the UUID of the default image to be deployed
was retuning more than one UUID because of a grep problem, that would
also cause the "nova boot" command to fail because it was passing more
arguments that expected.
This commit fix the regex to query the UUID of the image by ignoring
what comes after the name of the image.
Change-Id: I03ad610fdd3313977b61d0d82bd1b33811f7ece1
