Since running the py27 tox test before the py34 tox test can cause
errors about 'db type could not be determined'. Change the docs to
show the py34 test first, so hopefully people will run that test
first.
Change-Id: I59409edc5cab7f58112ebe28e280f0eeda3becd0
If tests are run under py27 then run under py34 or py35, user may get
`db type could not be determined` error.
This patch adds a note to the dev-quickstart guide telling user to
remove the file `.testrepository/times.dbm` and then run the py34 or
py35 test to work around this error.
Change-Id: I57b583eaa8586d14cee730eefc515ad064ac8b32
Closes-Bug: #1229445 (regarding Ironic)
Updates ironic dev quickstart to include compatability with the
latest versions of python, ubuntu and fedora
Change-Id: I14b0668e228c47db36970df14a774469f6d966d1
Closes-bug: 1603575
local.conf file for deploying ironic with devstack uses Git protocol to
enable ironic plugin. Git protocol requires access to port 9418 which
corporate firewalls commonly block.
Added a note to the local.conf file informing users who face this
problem how to modify the local.conf file to use https:// instead of
git:// so ironic plugin will be enabled.
Change-Id: Ia0ab1c23cf1e6979eb7e03bb9746aa94dd3f0257
Closes-Bug: #1604243
I ran into gcc not being available recently on a fresh Ubuntu image.
Adding it allowed tox to run fine and install ironic's dependencies. Add
it to the dev quickstart to make sure nobody else gets tripped up.
Change-Id: Ibd6e3bc4772af382c8df92d54050af4934e49ab4
This patch updates the sample local.conf to use the agent_ipmitool
driver instead of the pxe_ssh driver. It also adds a note about *_ssh
drivers being phased out in favor of ipmitool + vbmc.
Change-Id: I1bc58b6b97f2aa0c864ebe112ca3c5a88b9ca561
Support of old ramdisk has been deprecated at [0].
This patch removes IRONIC_DEPLOY_DRIVER_ISCSI_WITH_IPA variable
from documentation.
Reference:
[0] https://review.openstack.org/327083/
Change-Id: I37448131b71d8e1580a765096e9d3698bd4b1c6c
The method documented at
http://docs.openstack.org/developer/devstack/configuration.html#service-repos
doesn't work for services (like Ironic) that use a devstack plugin.
Documenting the right process to use should help new developers (who may
not be familiar with OpenStack infrastructure) become productive
quickly.
Change-Id: I40538306ea81dd356e47e063208ea1b84e6e9b24
The sample configuration file was changed so that the configuration
options are of the form 'name = value' instead of 'name=value'.
This patch updates the developer documentation [1] so that the 'sed'
instructions work properly with the new format.
[1] http://docs.openstack.org/developer/ironic/dev/dev-quickstart.html#option-1-manual-install
Change-Id: I8e36ec40c83c6d914dcd6b3d426f58415e1d3e23
This change fixes all the markup issues in our docs, such as:
* Title length must match an underline (some titles are only 3
characters long, make them longer, otherwise they are not
considered a title);
* Blank line required after literal block;
* Duplicate explicit target name.
It also makes section names consistent in drivers.rst.
Change-Id: I058224589f4ca63a4acfb8e2c4fcdbb51c730542
Github is not the official reference for OpenStack code repositories,
and as such should not be used in documentation.
Update links that are meant to be links to a project as a whole with
links to the project's documentation.
Update links directly to code to git.openstack.org.
Remove link to tripleo-incubator script for DIB dependencies, as it does
way more than we need to, and the dependencies needed differ between DIB
elements. Instead we leave this as an exercise to the user (this is
documented in the DIB docs).
Change-Id: Iee09b6b86628e46dc5e9436bd0f98a40c50244b7
The "nova image-list" command has been deprecated, this patch is replacing
it with the openstack client "image show" command in our docs.
Closes-Bug: #1582211
Change-Id: I857d105a7868a610a4d97516117840cc4309c51d
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
