This patch updates most links in the dev-quickstart.rst file from http
to https. The link for Vagrant page is also updated because when open
it a custom 404 page was being displayed.
Change-Id: I781b785992598f89fcea897fa78853a4fb71c10c
This patch is extending the developer quick-start guide to include
information about how one can run the integration tests (tempest) against
a running devstack cloud (the setup for such a cloud is already part of
the documentation).
The patch also removes the information about how to run tests from the
ironic_tempest_plugin/README.rst file and add a link pointing to our
documentation.
Change-Id: I6aeb3a4fa735ff08cbb62b0b15cf95be57d1a308
By default DEFAULT_INSTANCE_TYPE is not set. As result when tempest is
enabled default Nova flavors are used. To use 'baremetal' flavor
DEFAULT_INSTANCE_TYPE should be set to 'baremetal' as is done on gate job.
Otherwise running BaremetalBasicOps test locally will fail.
Change-Id: I1294b1dc7bf4fa32f9cdeb7a8c22667a76929ded
Example local.conf from Ironic docs uses $HOME/ironic-bm-logs as VM log dir.
On some systems (e.g. Fedora) user's home is accessible only to the owner by
default which causes "permission denied" errors when starting VMs because
QEMU domains are running as non-root user ("qemu" in Fedora).
Extend the documentation with note about possible problems with custom
log directory set using IRONIC_VM_LOG_DIR.
Change-Id: Ia1d7688fd71c4853538621ec32b2d4a024f52a76
Closes-Bug: #1532184
This patch is updating the "Developer Quick-Start" guide to instruct
people using Fedora 23+ to install a package called "redhat-rpm-config".
This is needed to build a virtualenv for development successfully.
Closes-Bug: #1527614
Change-Id: I95c927330faea009b327492a3884e01b9c44606d
As ironic is installed as devstack plugin, add this to sample
local.conf file. Apart from that, some formatting issues in
dev-quickstart are fixed.
Depends-On: I5125fce295c79600781469c2f48bea80e7600081
Change-Id: I30683b2569e6ca1233f54d1529a74f6a63cd633e
mysql login requires password by default. We should change the DB
creation and connection string as below.
1. mysql -u root -pMYSQL_ROOT_PWD -e "create schema ironic"
2. sed -i ... root:MYSQL_ROOT_PWD@localhost ... ironic.conf.local
Change-Id: I19696a470055823a3b2edc45a48889945c255dfd
Closes-bug: #1520420
The old ramdisk is deprecated, so we should not really default to it.
Also this guide makes an assumption that agent_* and pxe_* drivers
can't be used together, which is no longer the case, as IPA handles both.
Consolidate the example local.conf into one enabling both pxe_* and agent_*
drivers with IPA and create a separate page for explaining difference between
these two.
Co-Authored-By: Lilia Sampaio <liliars@lsd.ufcg.edu.br>
Change-Id: Ifeed7bf9128281b79d425f7c5dbb3d8c39e7fb68
we have switched from MySQL-python to PyMySQL[1], so the mysql url in
dev-quickstart doc should be changed also, this patch will change
\connection=mysql:@' to 'connection=mysql+pymysql:@'.
[1] https://review.openstack.org/#/c/184392
Closes-bug: #1520020
Change-Id: Ibd2e6170eba3fe64f6a79966e1384c3ffc64f05b
* 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
