User Tools

Site Tools


joid:get_started

This is an old revision of the document!


Deploy JOID in your POD

(Help us to improve this page)

Example POD architecture drawings:

Link to Gliffy source for above drawing: maas-poc-drawing.gliffy.zip


Get the joid code from gerritt

git clone https://gerrit.opnfv.org/gerrit/p/joid.git cd joid/ci

Enable MAAS

  • Create a directory in maas/<company name>/<pod number>/ for example

mkdir maas/intel/pod7/

  • copy files from pod5 to pod7

cp maas/intel/pod5/* maas/intel/pod7/*

4 files will get copied: deployment.yaml environments.yaml interfaces.host lxc-add-more-interfaces

deployment.yaml file

Prerequisite:

  1. Make sure Jump host node has been configured with bridges on each interface. So that appropriate MAAS and JUJU bootstrap VM can be created. For example if you have three network admin, data and public then I would suggest to give names like brAdm, brData and brPublic.
  2. You have information about the node MAC address and power management details (IPMI IP, username, password) of the nodes used for control and compute node.

modify

This file has been used to configure your maas and bootstrap node in a VM. Comments in the file are self explanatory and we expect fill up the information according to match lab infrastructure information. Sample deployment.yaml can be found at https://gerrit.opnfv.org/gerrit/gitweb?p=joid.git;a=blob;f=ci/maas/intel/pod5/deployment.yaml

modify interfaces.host file

This file will be used to configure your network interfaces on the rest of the nodes deployed through MAAS. I would suggest to list interface you want to bring up after the deployment of the Operating System. JUJU will do that using this file.

modify lxc-add-more-interfaces file

This File will be used as network template to create the network in containers.\

In case your POD is official OPNFV POD check in your files to the JOID git repo.

MAAS Deployment

This section will guide you how to deploy maas and bootstrap node in a VM on a bare metal host.

Make sure you have ubuntu 14.04 install and all bridges configured on bare metal host server as mentioned in deployment.yaml file above. Then follow the section below.

modify 02-maasdeploy,sh

  • In case "$2" please add another section:

'intelpod7' )

      cp maas/intel/pod7/deployment.yaml ./deployment.yaml
      ;;

install MAAS and add nodes in MAAS

  • run the following command from ~/joid/ci directory

./02-maasdeploy.sh intelpod7

   
   Above command will take around 30-45 minutes depends upon your network connection to install MAAS on VM as per name mentioned in the deployment.yaml and configure the interfaces accordingly.  
* Above maas installation will crate the environments.yaml file in ~/joid/ci folder

Configure juju integration

This section will guide you how to configure joid to your environment to deploy OPNFV platform.

  • Make sure you have environments.yaml in ~/joid/ci directory. If it does not exist then most likely you have not used the above method to deploy MAAS. In that case please copy the file manually.
  • make sure all changes in bundle file ./odl/juju-deployer/ovs-odl-ha.yaml has the correct information. If no then i would request you to modify the ~/joid/ci/01-deploybundle.sh file to modify fot your lab.
'' 
  'intelpod7' )
      cp maas/intel/pod7/interfaces.host trusty/ubuntu-nodes-controller/network/interfaces.host
      cp maas/intel/pod7/lxc-add-more-interfaces trusty/ubuntu-nodes-controller/lxc/add-more-interfaces
      cp maas/intel/pod7/interfaces.host trusty/ubuntu-nodes-compute/network/interfaces.host
      cp maas/intel/pod7/lxc-add-more-interfaces trusty/ubuntu-nodes-compute/lxc/add-more-interfaces
      # As per your lab vip address list be deafult uses 10.4.1.11 - 10.4.1.20
      sed -i -- 's/10.4.1.1/10.4.1.2/g' ./bundles.yaml
      # choose the correct interface to use for data network
      sed -i -- 's/#os-data-network: 10.4.8.0\/21/os-data-network: 10.4.9.0\/24/g' ./bundles.yaml
      sed -i -- 's/#        "ext-port": "eth1"/#        "ext-port": "brPublic"/g' ./bundles.yaml
      ;;
''

Run the deployment using JOID

Once you have modified the above sections then deployment will be very easy. Please do the following:

./deploy.sh -o liberty -s odl -t ha -l intelpod7

Above statement will deploy the openstack kilo with sdn odl in HA mode in Intel lab pod7

If you wants to deploy the opencontrail then you need to replace the odl with opencontrail and liberty with juno in the above command.

Submitting merge proposal to joid

On successful deployment test please submit the merge proposal into joid using git.

Please follow https://wiki.opnfv.org/developer/getting_started for any developer tools.

git add –all

git commit

git review -D

Few above commands will be useful to submit your patch for review.

joid/get_started.1448939573.txt.gz · Last modified: 2015/12/01 03:12 by Narinder Gupta