Merge changes from topics 'c_doc_update', 'detached_cleanup'
authorTim Rozet <trozet@redhat.com>
Fri, 10 Jun 2016 15:31:49 +0000 (15:31 +0000)
committerGerrit Code Review <gerrit@172.30.200.206>
Fri, 10 Jun 2016 15:31:49 +0000 (15:31 +0000)
* changes:
  Documentation updates
  fixing detached state deployment

build/Makefile
build/opnfv-apex-common.spec
ci/deploy.sh
ci/dev_deploy_check.sh
docs/installation-instructions/baremetal.rst
docs/installation-instructions/index.rst
docs/installation-instructions/introduction.rst
docs/installation-instructions/requirements.rst
docs/installation-instructions/verification.rst

index 4d024a3..3f3d1c3 100644 (file)
@@ -248,7 +248,16 @@ iso:       iso-clean images rpms $(CENTISO)
        @ln $(RPMODL) centos/Packages
        @ln $(RPMONO) centos/Packages
        @ln $(RPMSFC) centos/Packages
-       cd centos/Packages && yumdownloader openvswitch && yumdownloader openstack-tripleo && yumdownloader jq
+       # add packages to the centos packages
+       cd centos/Packages && yumdownloader openvswitch
+       cd centos/Packages && yumdownloader openstack-tripleo
+       cd centos/Packages && yumdownloader jq
+       cd centos/Packages && yumdownloader python34
+       cd centos/Packages && yumdownloader python34-libs
+       cd centos/Packages && yumdownloader python34-yaml
+       cd centos/Packages && yumdownloader python34-setuptools
+       cd centos/Packages && curl -O https://radez.fedorapeople.org/python34-markupsafe-0.23-9.el7.centos.x86_64.rpm
+       cd centos/Packages && curl -O https://radez.fedorapeople.org/python3-jinja2-2.8-5.el7.centos.noarch.rpm
        # regenerate yum repo data
        @echo "Generating new yum metadata"
        createrepo --update -g ../c7-opnfv-x86_64-comps.xml centos
@@ -257,3 +266,43 @@ iso:       iso-clean images rpms $(CENTISO)
        mkisofs -b isolinux/isolinux.bin -no-emul-boot -boot-load-size 4 -boot-info-table -V "OPNFV CentOS 7 x86_64" -R -J -v -T -o $(ISO) centos
        isohybrid $(ISO)
        @printf "\n\nISO is built at $(ISO)\n\n"
+
+###################
+#  python3-jinja2  #
+###################
+
+.PHONY: python3-jinja2
+python3-jinja2: python3-markupsafe python-jinja2-2.8-5.fc24.src.rpm
+       curl -O http://ftp.linux.ncsu.edu/pub/fedora/linux//development/24/Everything/source/tree/Packages/p/python-jinja2-2.8-5.fc24.src.rpm
+       rpm2cpio python-jinja2-2.8-5.fc24.src.rpm | cpio -idmv
+       sed -i 's/python3-devel/python34-devel/' python-jinja2.spec
+       sed -i 's/python3-setuptools/python34-setuptools/' python-jinja2.spec
+       sed -i 's/python3-pytest/python34-pytest/' python-jinja2.spec
+       sed -i 's/python3-markupsafe/python34-markupsafe/' python-jinja2.spec
+       rpmbuild -ba python-jinja2.spec -D '_topdir %(echo `pwd`)' -D '_builddir %(echo `pwd`)' -D '_sourcedir %(echo `pwd`)' -D '_rpmdir %(echo `pwd`)' -D '_specdir %(echo `pwd`)' -D '_srcrpmdir %(echo `pwd`)' -D "with_python3 1"
+
+.PHONY: python3-jinja2-clean
+python3-jinja2-clean:
+       rm -f python-jinja2-2.8-5.fc24.src.rpm
+       rm -f python-jinja2.spec
+       rm -f Jinja2-2.8.tar.gz
+
+########################
+#  python3-markupsafe  #
+########################
+
+.PHONY: python3-markupsafe
+python3-markupsafe: python-markupsafe-0.23-9.fc24.src.rpm
+       curl -O http://ftp.linux.ncsu.edu/pub/fedora/linux//development/24/Everything/source/tree/Packages/p/python-markupsafe-0.23-9.fc24.src.rpm
+       rpm2cpio python-markupsafe-0.23-9.fc24.src.rpm | cpio -idmv
+       sed -i 's/python3-devel/python34-devel/' python-markupsafe.spec
+       sed -i 's/python3-setuptools/python34-setuptools/' python-markupsafe.spec
+       sed -i 's/python3-pytest/python34-pytest/' python-markupsafe.spec
+       sed -i 's/python3-markupsafe/python34-markupsafe/' python-markupsafe.spec
+       rpmbuild -ba python-markupsafe.spec -D '_topdir %(echo `pwd`)' -D '_builddir %(echo `pwd`)' -D '_sourcedir %(echo `pwd`)' -D '_rpmdir %(echo `pwd`)' -D '_specdir %(echo `pwd`)' -D '_srcrpmdir %(echo `pwd`)' -D "with_python3 1"
+
+.PHONY: python3-markupsafe-clean
+python3-markupsafe-clean:
+       rm -f python-markupsafe-0.23-9.fc24.src.rpm
+       rm -f python-markupsafe.spec
+       rm -f MarkupSafe-0.23.tar.gz
index fc82fca..536f9ec 100644 (file)
@@ -11,7 +11,7 @@ Source0:      opnfv-apex-common.tar.gz
 BuildArch:     noarch
 BuildRequires: python-docutils python34-devel
 Requires:      openstack-tripleo opnfv-apex-sdn opnfv-apex-undercloud openvswitch qemu-kvm bridge-utils libguestfs-tools
-Requires:      initscripts net-tools iputils iproute iptables python34 python34-yaml python34-setuptools
+Requires:      initscripts net-tools iputils iproute iptables python34 python34-yaml python3-jinja2
 
 %description
 Scripts for OPNFV deployment using RDO Manager
index f9a5f0c..da1d29e 100755 (executable)
@@ -1256,8 +1256,6 @@ parse_cmdline() {
 ##END FUNCTIONS
 
 main() {
-  # Make sure jinja2 is installed
-  easy_install-3.4 jinja2 > /dev/null
   parse_cmdline "$@"
   echo -e "${blue}INFO: Parsing network settings file...${reset}"
   parse_network_settings
index e93e9f4..8ba46ab 100755 (executable)
@@ -35,3 +35,7 @@ for i in epel-release python34-PyYAML openvswitch openstack-tripleo libguestfs l
         fi
     fi
 done
+
+
+# Make sure jinja2 is installed
+easy_install-3.4 jinja2
index e325700..e60ec9d 100644 (file)
@@ -10,9 +10,10 @@ platform.  All the networks involved in the OPNFV infrastructure as well as the
 networks and the private tenant VLANs needs to be manually configured.
 
 The Jumphost can be installed using the bootable ISO or by other means including the
-(``opnfv-apex*.rpm``) RPMs and virtualization capabilities.  The Jumphost should then be
-configured with an IP gateway on its admin or public interface and configured with a
-working DNS server.  The Jumphost should also have routable access to the lights out network.
+(``opnfv-apex*.rpm``) RPMs, their dependencies and virtualization capabilities.  The
+Jumphost should then be configured with an IP gateway on its admin or public interface
+and configured with a working DNS server.  The Jumphost should also have routable access
+to the lights out network.
 
 ``opnfv-deploy`` is then executed in order to deploy the Undercloud VM.  ``opnfv-deploy`` uses
 three configuration files in order to know how to install and provision the OPNFV target system.
@@ -102,13 +103,21 @@ Install Bare Metal Jumphost
     - opnfv-apex-opendaylight-sfc - OpenDaylight SFC support **
     - opnfv-apex-undercloud       - (required) Undercloud Image
     - opnfv-apex-common           - (required) Supporting config files and scripts
+    - python34-markupsafe         - (required) Dependency of opnfv-apex-common ***
+    - python3-jinja2              - (required) Dependency of opnfv-apex-common ***
 
     ** One or more of these RPMs is required
     Only one of opnfv-apex, opnfv-apex-onos and opnfv-apex-opendaylight-sfc is required. It is
     safe to leave the unneeded SDN controller's RPMs uninstalled if you do not intend to use them.
 
+    *** These RPMs are not yet distributed by CentOS or EPEL.
+    Apex has built these for distribution with Apex while CentOS and EPEL do not distribute them. Once
+    they are carried in an upstream channel Apex will no longer carry them and they will not need
+    special handling for installation.
+
     To install these RPMs download them to the local disk on your CentOS 7 install and pass the
     file names directly to yum:
+    ``sudo yum install python34-markupsafe-<version>.rpm python3-jinja2-<version>.rpm``
     ``sudo yum install opnfv-apex-<version>.rpm opnfv-apex-undercloud-<version>.rpm opnfv-apex-common-<version>.rpm``
 
 
index 1c3f4fe..0dd3d87 100644 (file)
@@ -19,7 +19,7 @@ Contents:
 
 :Authors: Tim Rozet (trozet@redhat.com)
 :Authors: Dan Radez (dradez@redhat.com)
-:Version: 1.0
+:Version: 3.0
 
 Indices and tables
 ==================
index 3d5d1bc..14fe04b 100644 (file)
@@ -20,10 +20,11 @@ The Apex deployment artifacts contain the necessary tools to deploy and
 configure an OPNFV target system using the Apex deployment toolchain.
 These artifacts offer the choice of using the Apex bootable ISO
 (``opnfv-apex-colorado.iso``) to both install CentOS 7 and the
-necessary materials to deploy or the Apex RPMs (``opnfv-apex*.rpm``)
-which expects installation to a CentOS 7 libvirt enabled host. The RPM
-contains a collection of configuration files, prebuilt disk images,
-and the automatic deployment script (``opnfv-deploy``).
+necessary materials to deploy or the Apex RPMs (``opnfv-apex*.rpm``),
+and their associated dependencies, which expects installation to a
+CentOS 7 libvirt enabled host. The RPM contains a collection of
+configuration files, prebuilt disk images, and the automatic deployment
+script (``opnfv-deploy``).
 
 An OPNFV install requires a "Jumphost" in order to operate.  The bootable
 ISO will allow you to install a customized CentOS 7 release to the Jumphost,
index ff9dc2a..af03aac 100644 (file)
@@ -15,7 +15,7 @@ The Jumphost requirements are outlined below:
 4.     minimum 2 networks and maximum 6 networks, multiple NIC and/or VLAN combinations are supported.
        This is virtualized for a VM deployment.
 
-5.     The Colorado Apex RPMs.
+5.     The Colorado Apex RPMs and their dependencies.
 
 6.     16 GB of RAM for a bare metal deployment, 64 GB of RAM for a VM deployment.
 
index 42dcb8c..0ff5632 100644 (file)
@@ -3,9 +3,12 @@ Verifying the Setup
 
 Once the deployment has finished, the OPNFV deployment can be accessed via the Undercloud node. From
 the jump host ssh to the Undercloud host and become the stack user. Alternativly ssh keys have been
-setup such that the root user on the jump host can ssh to Undercloud directly as the stack user.
+setup such that the root user on the jump host can ssh to Undercloud directly as the stack user. For
+convenience a utility script has been provided to look up the undercloud's ip address and ssh to the
+undercloud all in one command. An optional user name can be passed to indicate whether to connect as
+the stack or root user. The stack user is default if a username is not specified.
 
-| ``ssh root@192.0.2.1``
+| ``opnfv-util undercloud root``
 | ``su - stack``
 
 Once connected to Undercloud as the stack user look for two keystone files that can be used to