Difference between revisions of "Hyper"

From Xen
(Basic Hyper how-to)
 
 
Line 1: Line 1:
This guide is a step-by-step procedure on how to setup Hyper on Linux, with Xen Hypervisor. The complete documentation, with installation instructions for other platforms, can be found on Hyper's [https://docs.hyper.sh/index.html official documentation].
+
This guide is a step-by-step procedure on how to setup Hyper on Linux, with Xen Project Hypervisor. The complete documentation, with installation instructions for other platforms, can be found on Hyper's [https://docs.hyper.sh/index.html official documentation].
   
 
= What is Hyper? =
 
= What is Hyper? =
Line 9: Line 9:
 
* QEMU 2.0 (or later)
 
* QEMU 2.0 (or later)
 
* Docker 1.5 (or later)
 
* Docker 1.5 (or later)
* Xen 4.5 (or later)
+
* Xen Project 4.5 (or later)
   
 
= Download & Installation =
 
= Download & Installation =
Line 17: Line 17:
 
Otherwise, if you wish to compile (or view) Hyper's sources code, please go to Hyper's [https://github.com/hyperhq/hyper Github repository]. Installation instructions are available on the [https://docs.hyper.sh/get_started/install.html following page].
 
Otherwise, if you wish to compile (or view) Hyper's sources code, please go to Hyper's [https://github.com/hyperhq/hyper Github repository]. Installation instructions are available on the [https://docs.hyper.sh/get_started/install.html following page].
   
To setup Hyper using Xen Hypervisor, please use the following command:
+
To setup Hyper using Xen Project Hypervisor, please use the following command:
   
 
<pre>
 
<pre>
Line 113: Line 113:
 
*Article about Hyper, containers and guest OS: https://hyper.sh/blog/post/2015/06/29/docker-hyper-and-the-end-of-guest-os.html
 
*Article about Hyper, containers and guest OS: https://hyper.sh/blog/post/2015/06/29/docker-hyper-and-the-end-of-guest-os.html
 
*Article about what is Hyper, and how it works: http://thenewstack.io/hyper-a-hypervisor-agnostic-docker-engine
 
*Article about what is Hyper, and how it works: http://thenewstack.io/hyper-a-hypervisor-agnostic-docker-engine
  +
  +
[[Category:Integration]]

Latest revision as of 23:38, 29 July 2015

This guide is a step-by-step procedure on how to setup Hyper on Linux, with Xen Project Hypervisor. The complete documentation, with installation instructions for other platforms, can be found on Hyper's official documentation.

What is Hyper?

Hyper is a set of Linux kernel, init process and management tools, able to virtualize containers to improve their isolation and management in case of multi-tenant applications, eliminating the need of guest OS and all the components it brings. Hyper provides safe and fast isolated environments (virtual machines), on which portable environments (containers) can be easily scheduled.

Prerequisite

  • QEMU 2.0 (or later)
  • Docker 1.5 (or later)
  • Xen Project 4.5 (or later)

Download & Installation

If you want to follow the recommended automated procedure to install Hyper, please follow the further instructions.

Otherwise, if you wish to compile (or view) Hyper's sources code, please go to Hyper's Github repository. Installation instructions are available on the following page.

To setup Hyper using Xen Project Hypervisor, please use the following command:

# curl -sSL https://hyper.sh/install-xen | bash

Please note that the current version supports the following Linux distro:

  • Ubuntu 64bit
    • 15.04 Vivid
    • 14.10 Utopic
    • 14.04 Trusty
  • CentOS 64bit
    • 7.0
    • 6.x (upgrade to QEMU 2.0)
  • Fedora 20-22 64bit
  • Debian 64bit
    • 8.0 jessie
    • 7.x wheezy (upgrade to QEMU 2.0)

Usage

This is an example of how to run a `Ubuntu` container image using Hyper. For more details about Hyper's CLI usage, please refer to this page.

Start/Stop HyperD daemon

You can `start` hyperd daemon with the following command

# service hyperd start

You can `stop` hyperd daemon with the following command

# service hyperd stop

List running Pods

For more details about what is a Pod, please refer to this page.

You can `list` running pods with the following command

# hyper list [pod|vm|container]

Pull container image

You can `pull` a container image with the following command

# hyper pull ubuntu

Run a container (Pod)

You can `run` a pod with the following command

# hyper run ubuntu

Stop/Remove Pod

You can `stop` a Pod with the following command

# hyper stop POD_ID

You can `remove` a Pod with the following command

# hyper rm POD_ID

Display help

If you need further assistance, you can display Hyper's `help` with the following command

# hyper [COMMAND] -h

note: COMMAND argument is listed in the generic help.

References