summaryrefslogtreecommitdiffstats
path: root/docs/source/apps.md
diff options
context:
space:
mode:
Diffstat (limited to 'docs/source/apps.md')
-rw-r--r--docs/source/apps.md38
1 files changed, 12 insertions, 26 deletions
diff --git a/docs/source/apps.md b/docs/source/apps.md
index 9b2384f29..1c44a8ca9 100644
--- a/docs/source/apps.md
+++ b/docs/source/apps.md
@@ -1,12 +1,12 @@
-# Application examples using hICN stack
+# Applications
-## Introduction
+The open source distribution provides a few application examples:
+one MPEG-DASH video player, and an HTTP reverse proxy a command line
+HTTP GET client.
+hICN sockets have been succesfully used to serve HTTP, RTP and
+RSockets application protocols.
-higet and hicn-http-proxy are two application examples that use hicn stack.
-
-## Using hICN Application Examples
-
-### Dependencies
+## Dependencies
Build dependencies:
@@ -73,7 +73,7 @@ Example:
The hICN names used by higet for naming the HTTP requests are composed the same way as described in [hicn-http-proxy](#hicn-http-proxy).
-### How To Setup A Simple HTTP Client-Server Scenario using the hicn-http-proxy
+## HTTP Client-Server with hicn-http-proxy
We consider the following topology, consisting on two linux VM which are able to communicate through an IP network (you can also use containers or physical machines):
@@ -94,29 +94,15 @@ For running the hicn-plugin at the server there are two main alternatives:
- Use a docker container
- Run the hicn-plugin directly in a VM or Bare Metal Server
-#### Docker
+### Docker
Install docker in the server VM:
```bash
-server$ sudo apt-get update
-server$ sudo apt-get install \
- apt-transport-https \
- ca-certificates \
- curl \
- gnupg-agent \
- software-properties-common
-
-server$ curl -fsSL https://download.docker.com/linux/ubuntu/gpg | sudo apt-key add -
-server$ sudo add-apt-repository \
- "deb [arch=amd64] https://download.docker.com/linux/ubuntu \
- $(lsb_release -cs) \
- stable"
-server$ sudo apt-get update
-server$ sudo apt-get install docker-ce docker-ce-cli containerd.io
+server$ curl get.docker.com | bash
```
-Run the hicn-http-proxy container. Here we use a public server [example.com](example.com) as origin:
+Run the hicn-http-proxy container. Here we use a public server "example.com" as origin:
```bash
server$ docker run -e ORIGIN_ADDRESS=example.com \
@@ -204,7 +190,7 @@ Run the http client [higet](#higet) and print the http response on stdout:
client$ /usr/bin/higet -O - http://webserver/index.html -P c001
```
-#### Host/VM
+### Host/VM
You can install the hicn-plugin of vpp on your VM and directly use DPDK compatible nics, forwarding hicn packets directly over the network. DPDK compatible nics can be used inside a container as well.