Difference between revisions of "Honeycomb/Releases/1609/Installing binaries from packages"

From fd.io
Jump to: navigation, search
(Centos)
(Centos)
 
(20 intermediate revisions by 4 users not shown)
Line 1: Line 1:
== Intro ==
+
== Dependencies ==
  
If you are simply using honeycomb, it can be convenient to simply install the packages.  The instructions below
+
Honeycomb binary package dependencies
will pull the latest freshest package build from the master branch (updated on every merge).  Please note, honeycomb will pull in vpp
+
as necessary.
+
  
== Centos ==
+
=== Java ===
  
=== Add fd.io repo ===
+
'''Honeycomb needs Java 8''' to run. It installs openjdk-8 as a dependency.
  
 +
=== VPP ===
  
==== CentOS 7.2 - VPP master branch RPMs ====
+
Honeycomb runs on top of VPP. It installs VPP as a dependency if not already present.
  
Create a file /etc/yum.repos.d/fdio-master.repo with contents:
+
=== NSH (optional) ===
 +
 
 +
Honeycomb provides optional support for VPP's plugin: NSH_SFC. It is a suggested dependency, so if wanted, install honeycomb with ''--install-suggests'' switch.
 +
 
 +
== Centos ==
 +
 
 +
=== CentOS 7.2 - Honeycomb Release RPMs ===
 +
 
 +
==== Add fd.io repo ====
 +
 
 +
Create a file /etc/yum.repos.d/honeycomb-release.repo with contents:
  
 
<pre>
 
<pre>
[fdio-master]
+
[honeycomb-release]
name=fd.io master branch latest merge
+
name=honeycomb release branch latest merge
baseurl=https://nexus.fd.io/content/repositories/fd.io.master.centos7/
+
baseurl=https://nexus.fd.io/content/repositories/fd.io.centos7/
 
enabled=1
 
enabled=1
 
gpgcheck=0
 
gpgcheck=0
Line 23: Line 32:
  
 
=== Install honeycomb packages ===
 
=== Install honeycomb packages ===
 
Note: This will also install vpp appropriately as a dependency.
 
  
 
<code>
 
<code>
Line 30: Line 37:
 
</code>
 
</code>
  
=== Start honeycomb ===
+
== Ubuntu ==
  
Note: This will also start vpp as necessary.
+
=== Ubuntu 14.04 - Honeycomb Release DEB ===
  
<code>
+
* <span style="color:red">Add openjdk-8 repository. 1404 does not provide openjdk-8 by default</span>
sudo service honeycomb start
+
 
</code>
+
  According to http://stackoverflow.com/questions/32942023/ubuntu-openjdk-8-unable-to-locate-package
 +
 
 +
* Pick Ubuntu version:
 +
 
 +
  export UBUNTU="trusty"
 +
 
 +
* Then run:
 +
  sudo rm /etc/apt/sources.list.d/99fd.io.list
 +
  echo "deb [trusted=yes] https://nexus.fd.io/content/repositories/fd.io.ubuntu.$UBUNTU.main/ ./" | sudo tee -a /etc/apt/sources.list.d/99fd.io.list
 +
  sudo apt-get update
 +
  sudo apt-get install honeycomb
 +
 
 +
* <span style="color:red">Uninstall previously installed java 7</span>
 +
 
 +
  look for packages e.g. openjdk-7-* and uninstall them
 +
 
 +
=== Ubuntu 16.04 - Honeycomb Release DEB ===
 +
 
 +
For Ubuntu 16.04, the packages are not published to 1604 repository. But the packages for ubuntu 1404 repository can be safely used.
 +
 
 +
'''Note: The service definition is written for upstart, not systemd, so in ubuntu 16.06 one might have to start honeycomb using script: ''/opt/honeycomb/honeycomb-start'' '''
 +
 
 +
== Running honeycomb ==
 +
[[Honeycomb/Releases/1609/Running Honeycomb#Starting_Honeycomb_agent]]

Latest revision as of 13:59, 22 September 2016

Dependencies

Honeycomb binary package dependencies

Java

Honeycomb needs Java 8 to run. It installs openjdk-8 as a dependency.

VPP

Honeycomb runs on top of VPP. It installs VPP as a dependency if not already present.

NSH (optional)

Honeycomb provides optional support for VPP's plugin: NSH_SFC. It is a suggested dependency, so if wanted, install honeycomb with --install-suggests switch.

Centos

CentOS 7.2 - Honeycomb Release RPMs

Add fd.io repo

Create a file /etc/yum.repos.d/honeycomb-release.repo with contents:

[honeycomb-release]
name=honeycomb release branch latest merge
baseurl=https://nexus.fd.io/content/repositories/fd.io.centos7/
enabled=1
gpgcheck=0

Install honeycomb packages

sudo yum install honeycomb

Ubuntu

Ubuntu 14.04 - Honeycomb Release DEB

  • Add openjdk-8 repository. 1404 does not provide openjdk-8 by default
 According to http://stackoverflow.com/questions/32942023/ubuntu-openjdk-8-unable-to-locate-package
  • Pick Ubuntu version:
 export UBUNTU="trusty"
  • Then run:
 sudo rm /etc/apt/sources.list.d/99fd.io.list
 echo "deb [trusted=yes] https://nexus.fd.io/content/repositories/fd.io.ubuntu.$UBUNTU.main/ ./" | sudo tee -a /etc/apt/sources.list.d/99fd.io.list
 sudo apt-get update
 sudo apt-get install honeycomb
  • Uninstall previously installed java 7
 look for packages e.g. openjdk-7-* and uninstall them

Ubuntu 16.04 - Honeycomb Release DEB

For Ubuntu 16.04, the packages are not published to 1604 repository. But the packages for ubuntu 1404 repository can be safely used.

Note: The service definition is written for upstart, not systemd, so in ubuntu 16.06 one might have to start honeycomb using script: /opt/honeycomb/honeycomb-start

Running honeycomb

Honeycomb/Releases/1609/Running Honeycomb#Starting_Honeycomb_agent