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

From fd.io
Jump to: navigation, search
(Created page with "== Intro == If you are simply using honeycomb, it can be convenient to simply install the packages. The instructions below will pull the latest freshest package build from t...")
 
(Centos)
 
(21 intermediate revisions by 5 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.
<div class="mw-collapsible-content">
+
  
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
 
</pre>
 
</pre>
</div>
 
</div>
 
 
<div class="toccolours mw-collapsible mw-collapsed" style="width:800px">
 
  
 
=== Install honeycomb packages ===
 
=== Install honeycomb packages ===
 
Note: This will also install vpp appropriately as a dependency.
 
  
 
<code>
 
<code>
Line 35: 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