From 8136666e1efc9f89ac0793d5fbd7b41c1be91712 Mon Sep 17 00:00:00 2001 From: blsaws Date: Thu, 8 Sep 2016 08:49:19 -0700 Subject: Update to new docs folders and names. JIRA: COPPER-1 Remove trailing whitespace Change-Id: I6291106ca6133034cdee6551df1b7b075ea5ee69 Signed-off-by: blsaws (cherry picked from commit f845679c6e99e9a8b48a4f9ad01a6647383aa62e) --- .../feature.configuration.rst | 79 ++++++++++++++++++++++ 1 file changed, 79 insertions(+) create mode 100644 docs/installationprocedure/feature.configuration.rst (limited to 'docs/installationprocedure/feature.configuration.rst') diff --git a/docs/installationprocedure/feature.configuration.rst b/docs/installationprocedure/feature.configuration.rst new file mode 100644 index 0000000..fce0044 --- /dev/null +++ b/docs/installationprocedure/feature.configuration.rst @@ -0,0 +1,79 @@ +.. This work is licensed under a +.. Creative Commons Attribution 4.0 International License. +.. http://creativecommons.org/licenses/by/4.0 +.. (c) OPNFV + +Copper configuration +==================== +This release includes installer support for the OpenStack Congress service under +JOID and Apex installers. Congress is installed by default for all JOID and Apex +scenarios. Support for other OPNFV installer deployed environments is planned +for the next release. + +Pre-configuration activities +---------------------------- +None required. + +Hardware configuration +---------------------- +There is no specific hardware configuration required for the Copper project. + +Feature configuration +--------------------- + +OPNFV installer support +....................... + +The Congress service is automatically configured as required by the JOID and +Apex installers, including creation of datasources per the installed datasource +drivers. This release includes default support for the following datasource drivers: + * nova + * neutronv2 + * ceilometer + * cinder + * glancev2 + * keystone + +For JOID, Congress is installed through a JuJu Charm, and for Apex through a +Puppet Module. Both the Charm and Module are being upstreamed to OpenStack for +future maintenance. + +Other project installer support (e.g. Doctor) may install additional datasource +drivers once Congress is installed. + +Manual installation +................... + +NOTE: This section describes a manual install procedure that had been tested +under the JOID and Apex base installs, prior to the integration of native +installer support through JuJu (JOID) and Puppet (Apex). This procedure is being +maintained as a basis for additional installer support in future releases. +However since Congress is pre-installed for JOID and Apex, this procedure is not +necessary and not recommended for use if Congress is already installed. + +Copper provides a set of bash scripts to automatically install Congress based +upon a JOID or Apex install which does not already have Congress installed. +These scripts are in the Copper repo at: + * components/congress/install/bash/install_congress_1.sh + * components/congress/install/bash/install_congress_2.sh + +Prerequisites to using these scripts: + * OPFNV installed via JOID or Apex + * For Apex installs, on the jumphost, ssh to the undercloud VM and "su stack". + * For JOID installs, admin-openrc.sh saved from Horizon to ~/admin-openrc.sh + * Retrieve the copper install script as below, optionally specifying the branch + to use as a URL parameter, e.g. ?h=stable%2Fbrahmaputra + +To invoke the procedure, enter the following shell commands, optionally +specifying the branch identifier to use for OpenStack. + +.. code:: + + cd ~ + wget https://git.opnfv.org/cgit/copper/plain/components/congress/install/bash/install_congress_1.sh + wget https://git.opnfv.org/cgit/copper/plain/components/congress/install/bash/install_congress_2.sh + bash install_congress_1.sh [openstack-branch] + +Copper post configuration procedures +------------------------------------ +No configuration procedures are required beyond the basic install procedure. -- cgit 1.2.3-korg