From be8577b32c22e16ca055bb68dd8e0ca5ab73e3ca Mon Sep 17 00:00:00 2001 From: Akilan Pughazhendi Date: Mon, 25 Jul 2016 15:31:50 +0000 Subject: [PATCH] Updating dev quickstart to include compatiblity for newest distros Updates ironic dev quickstart to include compatability with the latest versions of python, ubuntu and fedora Change-Id: I14b0668e228c47db36970df14a774469f6d966d1 Closes-bug: 1603575 --- doc/source/dev/dev-quickstart.rst | 51 +++++++++++++++++++++++++++---- 1 file changed, 45 insertions(+), 6 deletions(-) diff --git a/doc/source/dev/dev-quickstart.rst b/doc/source/dev/dev-quickstart.rst index 79fa7ece85..d2b6206fbf 100644 --- a/doc/source/dev/dev-quickstart.rst +++ b/doc/source/dev/dev-quickstart.rst @@ -8,19 +8,22 @@ This is a quick walkthrough to get you started developing code for Ironic. This assumes you are already familiar with submitting code reviews to an OpenStack project. -The gate currently runs the unit tests under both -Python 2.7 and Python 3.4. It is strongly encouraged to run the unit tests -locally under one, the other, or both prior to submitting a patch. +The gate currently runs the unit tests under Python 2.7, Python 3.4 +and Python 3.5. It is strongly encouraged to run the unit tests locally prior +to submitting a patch. .. note:: Do not run unit tests on the same environment as devstack due to conflicting configuration with system dependencies. +.. note:: + This document is compatible with Python (3.5), Ubuntu (16.04) and Fedora (23). + .. seealso:: http://docs.openstack.org/infra/manual/developers.html#development-workflow -Install prerequisites (for python 2.7): +Install prerequisites for python 2.7: - Ubuntu/Debian:: @@ -50,13 +53,26 @@ Install prerequisites (for python 2.7): ``_. -To use Python 3.4, follow the instructions above to install prerequisites and +If you need Python 3.4, follow the instructions above to install prerequisites for 2.7 and additionally install the following packages: -- On Ubuntu/Debian:: +- On Ubuntu 14.x/Debian:: sudo apt-get install python3-dev +- On Ubuntu 16.04:: + + wget https://www.python.org/ftp/python/3.4.4/Python-3.4.4.tgz + sudo tar xzf Python-3.4.4.tgz + cd Python-3.4.4 + sudo ./configure + sudo make altinstall + + # This will install Python 3.4 without replacing 3.5. To check if 3.4 was installed properly + run this command: + + python3.4 -V + - On Fedora 21/RHEL7/CentOS7:: sudo yum install python3-devel @@ -65,6 +81,29 @@ additionally install the following packages: sudo dnf install python3-devel +If you need Python 3.5, follow the instructions for installing prerequisites for Python 2.7 and +run the following commands. + +- On Ubuntu 14.04:: + + wget https://www.python.org/ftp/python/3.5.2/Python-3.5.2.tgz + sudo tar xzf Python-3.5.2.tgz + cd Python-3.5.2 + sudo ./configure + sudo make altinstall + + # This will install Python 3.5 without replacing 3.4. To check if 3.5 was installed properly + run this command: + + python3.5 -V + +- On Fedora 23:: + + sudo dnf install -y dnf-plugins-core + sudo dnf copr enable -y mstuchli/Python3.5 + dnf install -y python35-python3 + + If your distro has at least tox 1.8, use similar command to install ``python-tox`` package. Otherwise install this on all distros::