common/docs/user-guide.rst

   1 =====================================
   2 OPNFV User Guide for the Arno release
   3 =====================================
   4
   5 Abstract
   6 ========
   7
   8 This document provides an overview of how to use the Arno release of OPNFV once the system has been successfully deployed to a Pharos compliant infrastructure.
   9
  10 License
  11 =======
  12
  13 OPNFV User Guide for the Arno release (c) by Christopher Price (christopher.price@ericsson.com)
  14
  15 OPNFV User Guide for the Arno release is licensed under a Creative Commons Attribution 4.0 International License. You should have received a copy of the license along with this. If not, see <http://creativecommons.org/licenses/by/4.0/>.
  16
  17 Version history
  18 ===================
  19
  20 +--------------------+--------------------+--------------------+--------------------+
  21 | **Date**           | **Ver.**           | **Author**         | **Comment**        |
  22 |                    |                    |                    |                    |
  23 +--------------------+--------------------+--------------------+--------------------+
  24 | 2015-06-04         | 1.0.0              | Christopher Price  | Initial revision   |
  25 |                    |                    | (Ericsson AB)      |                    |
  26 +--------------------+--------------------+--------------------+--------------------+
  27 | 2015-06-05         | 1.0.1              | Christopher Price  | Corrected links &  |
  28 |                    |                    | (Ericsson AB)      | e-mail address     |
  29 +--------------------+--------------------+--------------------+--------------------+
  30
  31 .. contents:: Table of Contents
  32    :backlinks: none
  33
  34
  35 Introduction
  36 ============
  37
  38 This document provides a rudimentary user guide for the OPNFV Arno release.  The Arno release is the initial iteration of the OPNFV project and should be used as a developmental platform if you are interested in participating in the community and providing feedback.
  39
  40 The Arno release is not intended to be used in production environments.  It is an initial, experimental, release intended to provide a foundation on which the OPNFV project can evaluate platform capabilities and develop further capabilities.  It is possible that some expected features in the platform may not perform as desired, if you find these types of issue in the platform please report them to support@opnfv.org so that we can resolve them in future releases.
  41
  42 Preface
  43 =======
  44
  45 The Arno release of OPNFV is derived exclusively from open source development activities.  As such the functions, capabilities and user interfaces of the platform derive directly from those upstream sources as well.  The OPNFV project intends to work cooperatively and in conjunction with these projects, awareness of the components and their roles in the platform is important when attempting to use the platform.
  46
  47  - In the Arno release OpenStack Juno is used as the virtual infrastructure management component.  When operating the Arno release you will most often be interacting with the provided OpenStack interfaces.
  48  - Application deployment on the stack can be performed directly on the OpenStack interfaces or by using the Heat interfaces provided.
  49  - If you intend to perform actions on the networking component of the stack the Arno release uses OpenDaylight Helium.  The interfaces for OpenDaylight are available for checking topology and interacting with the OpenDaylight SDN controller.
  50  - Additional interfaces are provided by the Linux operating systems.  The Arno release supports either Centos 7.1 or Ubuntu 14.4 operating systems.
  51
  52 Details of operating these interfaces are explained later in the document.
  53
  54 Prerequisites
  55 =============
  56
  57 Hardware Requirements
  58 ---------------------
  59
  60 The Arno release of OPNFV is intended to be run as a baremetal deployment on a "Pharos compliant" lab infrastructure.  The Pharos project in OPNFV is a community activity to provide guidance and establish requirements on hardware platforms supporting the Arno virtualisation platform.
  61
  62 Prior to deploying the OPNFV platform it is important that the hardware infrastructure be configured according to the Pharos specification: https://www.opnfv.org/sites/opnfv/files/release/pharos-spec.arno.2015.1.0.pdf
  63
  64 Arno Platform Deployment
  65 ------------------------
  66
  67 The Arno platform supports installation and deployment using two deployment tools; a Foreman based deployment toolchain and a Fuel based deployment toolchain.
  68
  69 In order to deploy the Arno release on a Pharos compliant lab using the Foreman deployment toolchain you should follow in the Foreman installation guide: https://www.opnfv.org/sites/opnfv/files/release/foreman_install-guide.arno.2015.1.0.pdf
  70
  71 In order to deploy the Arno release on a Pharos compliant lab using the Fuel deployment toolchain you should follow in the Fuel installation guide: https://www.opnfv.org/sites/opnfv/files/release/install-guide.arno.2015.1.0.pdf
  72
  73 Enabling or disabling OpenDaylight and the native Neutron driver
  74 ----------------------------------------------------------------
  75
  76 You may find that you wish to adjust the system by enabling or disabling the native OpenStack Neutron driver depending on the tasks you are trying to achieve with the platform.  Each of the deployment tools has the option to deploy with or without OpenDaylight enabled.  Details of the available delpoyment options can be found in the associated installation-instructions, please note the platform validation procedures expect a fully deployed platform and results may vary depending on the options selected.
  77
  78 Deployment Validation
  79 ---------------------
  80
  81 Once installed you should validate the deployment completed successfully by executing the automated basic platform validation routines outlined in the Arno testing documentation: https://www.opnfv.org/sites/opnfv/files/release/functest.arno.2015.1.0.pdf
  82
  83 Operating the Arno platform
  84 ===========================
  85
  86 The Arno release provides a platform for deploying software on virtual infrastructure.  The majority of operations to be executed on the platform revolve around deploying, managing and removing software (applications) on the platform itself.  Application deployment is covered in the following sections, however some platform operations you may want to perform include setting up a tenant, in OpenStack tenants are also known as projects in this document we will refer to them as tenants, and associated users for that tenant.
  87
  88 OpenStack provides a good overview of how to create your first tenant for deploying your applications.  You should create a tenant for your applications, associate users with the tenant and assign quota's.
  89  - Open the OpenStack console (Horizon) you should find this by logging into your control node; for example to access the console of POD1 of the OPNFV lab you would browse to <172.30.9.70:80>
  90  - Create your tenant and users by following the instructions at: http://docs.openstack.org/openstack-ops/content/projects_users.html
  91
  92 Further actions and activities for checking logs and status can be found in other areas of the operations document: http://docs.openstack.org/openstack-ops/content/openstack-ops_preface.html
  93
  94
  95 Deploying your applications on Arno
  96 ===================================
  97
  98 Most actions you will want to perform can be executed from the OpenStack dashboard.  When deploying your application on Arno a good reference is the user-guide which describe uploading, managing and deploying your application images.
  99
 100  - Make sure you have established your tenant, associated users and quota's
 101  - Follow the guidelines for managing and deploying your images in the following user-guide: http://docs.openstack.org/user-guide/dashboard.html
 102
 103
 104 Frequently Asked Questions
 105 ==========================
 106
 107 Does OPNFV provide support for the Arno release?
 108 ------------------------------------------------
 109
 110 The Arno release of OPNFV is intended to be a developmental release and is not considered suitable for production deployment or at scale testing activities.  As a developmental release, and in the spirit of collaborative development, we want as much feedback from the community as possible on your experiences with the platform and how the release can be improved.
 111
 112 Support for Arno is provided in two ways:
 113
 114 You can engage with the community to help us improve and further develop the OPNFV platform by raising Jira Bugs or Tasks, and pushing correction patches to our repositories.
 115
 116  - To access Jira for issue reporting or improvement proposals head to: https://jira.opnfv.org/
 117  - To get started helping out developing the platform head to: https://wiki.opnfv.org/developer
 118
 119 Alternatively if you are intending to invest your time as a user of the platform you can ask questions and request help from our mailing list at: mailto://opnfv-users@lists.opnfv.org
 120
 121 License
 122 =======
 123
 124 All Arno entities are protected by the `Apache 2.0 License <http://www.apache.org/licenses/>`_.
 125 Arno platform components and their licences are described in their respective Release Notes: http://artifacts.opnfv.org/genesis/foreman/docs/release-notes.html and http://artifacts.opnfv.org/genesis/fuel/docs/release-notes.html
 126
 127 References
 128 ==========
 129
 130 OpenStack
 131 ---------
 132
 133 `OpenStack Admin User Guide <http://docs.openstack.org/user-guide-admin/>`_
 134
 135 OpenDaylight
 136 ------------
 137
 138 `OpenDaylight User Guide <https://www.opendaylight.org/sites/opendaylight/files/User-Guide-Helium-SR2.pdf>`_
 139
 140 Foreman
 141 -------
 142
 143 `Foreman User Manual <http://theforeman.org/manuals/1.7/index.html>`_
 144
 145 Fuel
 146 ----
 147
 148 `Fuel User Guide <http://docs.fuel-infra.org/openstack/fuel/fuel-6.0/user-guide.html>`_
 149
 150 :Authors: Christopher Price (christopher.price@ericsson.com)
 151 :Version: 1.0.1
 152
 153 **Documentation tracking**
 154
 155 Revision: _sha1_
 156
 157 Build date:  _date_
 158