Difference between revisions of "Tacker/Installation"

Revision as of 06:37, 5 December 2016

Tacker Installation Guide

There are two ways to install Tacker service:

- Install via Devstack 1) Pull devstack repo from latest master

git clone https://github.com/openstack-dev/devstack

3) A sample local.conf is placed at https://raw.githubusercontent.com/openstack/tacker/master/devstack/local.conf.example. Copy the local.conf to devstack root directory and customize it based on your environment settings. Update the HOST_IP to the IP address of VM or host where you are running tacker.

Note 1: Ensure local.conf file has the "enable_plugin tacker" line and it is pointing to master.

4) Run stack.sh

Manual Installation

Complete Documentation can be found here - Tacker Manual Installation

Tacker Installation using stable/newton

1) Pull devstack repo for stable newton branch

git clone -b stable/newton https://github.com/openstack-dev/devstack

2) A sample local.conf is placed at https://github.com/openstack/tacker/blob/stable/newton/devstack/local.conf.example. Copy the local.conf to devstack root directory and customize it based on your environment settings. Update the HOST_IP to the IP address of VM or host where you are running tacker.

3) Make sure the local.conf "enable_plugin tacker" is pointing to stable/newton,

enable_plugin tacker https://github.com/openstack/tacker stable/newton

4) Run stack.sh.

Tacker Installation using stable/liberty

1) Pull devstack repo for stable liberty branch

git clone -b stable/liberty https://github.com/openstack-dev/devstack

2) A sample local.conf is placed at https://raw.githubusercontent.com/openstack/tacker/stable/liberty/devstack/samples/local.conf.example. Copy the local.conf to devstack root directory and customize it based on your environment settings. Update the HOST_IP to the IP address of VM or host where you are running tacker.

3) Make sure the local.conf "enable_plugin tacker" is pointing to stable/liberty,

enable_plugin tacker https://github.com/openstack/tacker stable/liberty

4) Run stack.sh

Tacker Usage Guide

1) Sample TOSCA YAML files are placed in https://github.com/openstack/tacker/tree/master/samples. A simple set of vnfd-create, vnf-create and vnf-update commands are shown below.

tacker vnfd-create --vnfd-file ${VNFD_TOSCA_YAML-FILE} <VNFD_NAME>

tacker vnf-create --vnfd-id ${VNFD_ID} <VNF_NAME>

tacker vnf-update --config-file <CONFIG_FILE> <VNF>

The NFV-orchestration cli-reference is available at http://docs.openstack.org/cli-reference/tacker.html

2) If command-line tacker works fine, try out Tacker using Horizon (NFV left menu entry)

@@ Line 17: / Line 17: @@
 Manual Installation
   Complete Documentation can be found here - [http://docs.openstack.org/developer/tacker/install/manual_installation.html Tacker Manual Installation ]
+== Tacker Installation using stable/newton ==
+) Pull devstack repo for stable newton branch
+git clone -b stable/newton https://github.com/openstack-dev/devstack
+) A sample local.conf is placed at https://github.com/openstack/tacker/blob/stable/newton/devstack/local.conf.example. Copy the local.conf to devstack root directory and customize it based on your environment settings. Update the HOST_IP to the IP address of VM or host where you are running tacker.
+) Make sure the local.conf "enable_plugin tacker" is pointing to stable/newton,
+enable_plugin tacker https://github.com/openstack/tacker stable/newton
+) Run stack.sh.
 == Tacker Installation using stable/liberty ==
@@ Line 32: / Line 46: @@
 ) Run stack.sh
-== Tacker Installation using stable/kilo ==
-If you have a specific need to install the older Kilo based OpenStack, use the following steps to install Tacker. Otherwise use the steps described above using the master branch.
-) Pull devstack repo for stable kilo branch
-git clone -b stable/kilo https://github.com/openstack-dev/devstack
-) A sample local.conf is placed at https://github.com/openstack/tacker/blob/master/devstack/samples/local.conf.example. Copy the local.conf to devstack root directory and customize it based on your environment settings. Update the HOST_IP to the IP address of VM or host where you are running tacker.
-) Update the local.conf "enable_plugin tacker" to point to stable/kilo,
-enable_plugin tacker https://github.com/openstack/tacker stable/kilo
-) (Only for physical host based devstack) For running tacker service with devstack on physical hosts, a small mysql backport fix is required. To fix copy the local.sh script from https://github.com/openstack/tacker/blob/master/devstack/samples/local.sh.mysql_fix to devstack root directory as local.sh file. Change the file mode of local.sh file to execution mode as 'chmod +x local.sh'. This fix is required only if you are running devstack Kilo release and not master.
-) Run stack.sh
 == Tacker Usage Guide ==
@@ Line 55: / Line 51: @@
 ) Sample TOSCA YAML files are placed in https://github.com/openstack/tacker/tree/master/samples. A simple set of vnfd-create, vnf-create and vnf-update commands are shown below.
-tacker vnfd-create --name ${VNFD_NAME} --vnfd-file ${VNFD_TOSCA_YAML-FILE}
+tacker vnfd-create  --vnfd-file ${VNFD_TOSCA_YAML-FILE} <VNFD_NAME>
+tacker vnf-create  --vnfd-id ${VNFD_ID}  <VNF_NAME>
-tacker vnf-create --name vnf-name --vnfd-id ${VNFD_ID}
+tacker vnf-update  --config-file  <CONFIG_FILE> <VNF>
-tacker vnf-update  --config "${CONFIG_DATA_YAML} ${VNF_ID}
+The NFV-orchestration cli-reference is available at http://docs.openstack.org/cli-reference/tacker.html
 ) If command-line tacker works fine, try out Tacker using Horizon (NFV left menu entry)