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
The current devstack configuration in the dev documentation
is out of date and will not successfully spin up a
Nova with Ironic driver environment. One of the critical
changes necessary is to set the IRONIC_VM_SPECS_RAM to 1024,
as that is now the minimum size for a virtual Ironic node.
This change also updates the configurations to more closely match
the ones being used for the virtual ironic Devstack job and
explicitly sets file logging to make debugging easier.
Change-Id: Ifbe0af9759483ccd80e74b24d45eaa4726c4b101
The sample config used to have several drivers enabled, but this was changed
to default to the 'pxe_ipmitool' production driver. The developer documentation
for "Exercising the Services Locally", has examples using the 'fake_ipmitool'
driver. It won't work since only the pxe_ipmitool driver is available. This adds
instructions for updating the config file to enable fake_ipmitool instead of
pxe_ipmitool.
Users sometimes encounter the 'NodeLocked' exception while trying out the
sample "ironic" commands, due to the periodic sync_power_state task locking
the node. Documentation was added with instructions on how to turn off this
background sync_power_state task via a config setting.
Change-Id: Id53db08df59d13ca7a52505d6b3c0931551f4bf4
Devstack now supports the IRONIC_VM_EPHEMERAL_DISK variable
which allows the user to specify the size of the ephemeral
disk partition. This change documents how to use this variable
to boot an instance with ephemeral storage.
Change-Id: Idd3bf8c4c63d32a8ed2bacd37ba642eb70f709db
The BM_* variables are no longer used by Devstack for Ironic
deployment and the new defaults should work fine. Removes
references to the old settings.
Change-Id: Ia19dccaf389273c5a224b804eb270c08d31a1811
Adds a section to the developer quickstart doc explaining
how to deploy Ironic as part of devstack.
Change-Id: I26a6f8faa882bfaa94dd6eb26e6bef197f12b25c
This was previously set right before ironic-api start, but the
default value must also be present for ironic-dbsync calls.
Note: the default value of database.connection is changed here - from
now on the sqlite database will be stored in ./ironic/ironic.sqlite
instead of ./ironic/openstack/common/db/ironic.sqlite.
Closes-Bug: #1290645
Change-Id: I2c2ab2f10a99ffd564611351e71c0b88adc20ba7
Clarify and fix up the dev-quickstart doc some more
based on user feedback.
Testing examples now use tox rather than invoking the
testr command directly.
Simplified the section on building the documentation by
removing the need to install a web server.
Co-Authored-By: David Shrewsbury <shrewsbury.dave@gmail.com>
Change-Id: Ibdff4b44a26f11a5a0e92efb4c451105f6ab3245
Fixing:
* Add missing -r option to the pip install command
* Add a step to start rabbitmq-server on fedora/rhel after the
installation
* Replace the systemctl command with service because RHEL <= 6 doesn't
use systemd
* auth_strategy option can't be appended at the end of the file and
should be edited under the [DEFAULT] section
* Remove the trailing space
Change-Id: Id9b8a3e2b8c0358ddfc6693fb0cda410a40a4186
Add notes to dev/dev-quickstart to demonstrate how to
start up and interact with ironic-api and ironic-conductor
services locally, in a python virtualenv.
Also add some instrutions on building the documentation locally.
Change-Id: I01eb7ffb5ebe510cec9e4bc2f6ac0f0cc616493c
Without git installed, `tox -evenv -- echo 'done'` fails with a
cryptic error message. This should keep newcomers from getting
stuck on this.
Change-Id: I7cd7faa3bda905c8cfb3cfb456e3279566edf613
In order to create a virtualenv with tox, a postgresql package is needed
as a prerequisite. The dev-quickstart documentation has been updated to
reflect this.
In addition, the prerequisites for Fedora/RHEL were modified, because
mysql-devel is needed, not mysql-libs.
Fixes bug: #1227390
Change-Id: Ibfdb0a9a3d560fcc3fb7d95aaa1d765ed18215e2
Create doc/source/dev/ directory, and add several files that got
accidentaly ignored because they were under doc/source/api/.
Also move some files from doc/source into doc/source/dev to clean up the
base doc dir.
Change-Id: Ief9777216db82ec3be32b7a73e2d268a3a973ef8
