Mailing-List: contact dev-help@ariatosca.incubator.apache.org; run by ezmlm
Precedence: bulk
Reply-To: dev@ariatosca.incubator.apache.org
Content-Type: text/plain; charset="us-ascii"
MIME-Version: 1.0
Content-Transfer-Encoding: 7bit
From: ran@apache.org
To: dev@ariatosca.incubator.apache.org
Message-Id: <1b9280012d6a4fa58b31c333cc2ad04c@git.apache.org>
Subject: incubator-ariatosca git commit: ARIA-283 Update readme installation
 instructions [Forced Update!]
Date: Thu, 22 Jun 2017 09:25:41 +0000 (UTC)
archived-at: Thu, 22 Jun 2017 09:25:46 -0000

Repository: incubator-ariatosca
Updated Branches:
  refs/heads/ARIA-283-update-readme-installation-instructions 809e3e064 -> b2341f862 (forced update)


ARIA-283 Update readme installation instructions


Project: http://git-wip-us.apache.org/repos/asf/incubator-ariatosca/repo
Commit: http://git-wip-us.apache.org/repos/asf/incubator-ariatosca/commit/b2341f86
Tree: http://git-wip-us.apache.org/repos/asf/incubator-ariatosca/tree/b2341f86
Diff: http://git-wip-us.apache.org/repos/asf/incubator-ariatosca/diff/b2341f86

Branch: refs/heads/ARIA-283-update-readme-installation-instructions
Commit: b2341f86292e8404eef7b357609364d708ce2b2e
Parents: 9907520
Author: Ran Ziv <ran@gigaspaces.com>
Authored: Wed Jun 21 18:05:05 2017 +0300
Committer: Ran Ziv <ran@gigaspaces.com>
Committed: Thu Jun 22 12:25:36 2017 +0300

----------------------------------------------------------------------
 README.rst | 63 ++++++++++++++++++++++++++++++++++++++++-----------------
 1 file changed, 44 insertions(+), 19 deletions(-)
----------------------------------------------------------------------


http://git-wip-us.apache.org/repos/asf/incubator-ariatosca/blob/b2341f86/README.rst
----------------------------------------------------------------------
diff --git a/README.rst b/README.rst
index 8af13a5..832ef88 100644
--- a/README.rst
+++ b/README.rst
@@ -26,37 +26,62 @@ ARIA is an incubation project under the `Apache Software Foundation <https://www
 Installation
 ------------
 
-ARIA is `available on PyPI <https://pypi.python.org/pypi/ariatosca>`__.
+ARIA is `available on PyPI <https://pypi.python.org/pypi/apache-ariatosca>`__.
+
+ARIA requires Python 2.6/2.7. Python 3 is currently not supported.
 
 To install ARIA directly from PyPI (using a ``wheel``), use::
 
-    pip install aria
+    pip install --upgrade pip setuptools
+    pip install apache-ariatosca
 
 To install ARIA from source, download the source tarball from
-`PyPI <https://pypi.python.org/pypi/ariatosca>`__, extract it, and then when inside the extracted
-directory, use::
+`PyPI <https://pypi.python.org/pypi/apache-ariatosca>`__, extract it, and run::
 
-    pip install .
+    pip install --upgrade pip setuptools
+    pip install incubator-ariatosca
 
 The source package comes along with relevant examples, documentation, ``requirements.txt`` (for
 installing specifically the frozen dependencies' versions with which ARIA was tested) and more.
 
-Note that for the ``pip install`` commands mentioned above, you must use a privileged user, or use
-virtualenv.
 
-ARIA itself is in a ``wheel`` format compatible with all platforms. Some dependencies, however,
-might require compilation (based on a given platform), and therefore possibly some system
-dependencies are required as well.
+| ARIA has additional optional dependencies. These are required for running operations over SSH.
+| Below are instructions on how to install these dependencies, including required system dependencies per OS.
+
+Note: These dependencies may have varying licenses which may not be compatible with Apache license 2.0.
+
+
+Ubuntu/Debian (tested on Ubuntu14.04, Ubuntu16.04)::
+
+    apt-get install -y python-dev gcc libffi-dev libssl-dev
+    pip install aria[ssh]
+
+Centos (tested on Centos6.6, Centos7)::
+
+    yum install -y python-devel gcc libffi-devel openssl-devel
+    pip install aria[ssh]
+
+Archlinux::
+
+    pacman -Syu --noconfirm python2 gcc libffi openssl
+    pip2 install aria[ssh]
+
+Windows (tested on Win10)::
+
+    # no additional system requirements are needed
+    pip install aria[ssh]
+
+MacOS::
+
+    # TODO
 
-On Ubuntu or other Debian-based systems::
 
-    sudo apt install python-setuptools python-dev build-essential libssl-dev libffi-dev
 
-On Archlinux::
+To install ``pip``, either use your distro's package management system, or run::
 
-    sudo pacman -S python-setuptools
+    wget http://bootstrap.pypa.io/get-pip.py
+    python get-pip.py
 
-ARIA requires Python 2.6/2.7. Python 3+ is currently not supported.
 
 
 Getting Started
@@ -129,10 +154,10 @@ ARIA is licensed under the
    :target: https://ci.appveyor.com/project/ApacheSoftwareFoundation/incubator-ariatosca/history
 .. |License| image:: https://img.shields.io/github/license/apache/incubator-ariatosca.svg
    :target: http://www.apache.org/licenses/LICENSE-2.0
-.. |PyPI release| image:: https://img.shields.io/pypi/v/ariatosca.svg
-   :target: https://pypi.python.org/pypi/ariatosca
-.. |Python Versions| image:: https://img.shields.io/pypi/pyversions/ariatosca.svg
-.. |Wheel| image:: https://img.shields.io/pypi/wheel/ariatosca.svg
+.. |PyPI release| image:: https://img.shields.io/pypi/v/apache-ariatosca.svg
+   :target: https://pypi.python.org/pypi/apache-ariatosca
+.. |Python Versions| image:: https://img.shields.io/pypi/pyversions/apache-ariatosca.svg
+.. |Wheel| image:: https://img.shields.io/pypi/wheel/apache-ariatosca.svg
 .. |Contributors| image:: https://img.shields.io/github/contributors/apache/incubator-ariatosca.svg
 .. |Open Pull Requests| image:: https://img.shields.io/github/issues-pr/apache/incubator-ariatosca.svg
    :target: https://github.com/apache/incubator-ariatosca/pulls