Difference between revisions of "Http-server"
(→HTTP Server over TCP/ICN) |
|||
| Line 14: | Line 14: | ||
* libboost-filesystem-dev | * libboost-filesystem-dev | ||
* libicnet | * libicnet | ||
| + | * libcurl | ||
== Install the HTTP-Server == | == Install the HTTP-Server == | ||
| Line 43: | Line 44: | ||
For installing the application: | For installing the application: | ||
| − | < | + | <syntaxhighlight lang="bash"> |
$ mkdir build && cd build | $ mkdir build && cd build | ||
$ cmake .. | $ cmake .. | ||
$ make | $ make | ||
$ sudo make install | $ sudo make install | ||
| − | </ | + | </syntaxhighlight> |
| + | |||
== Usage == | == Usage == | ||
For starting the http-server, from the build folder: | For starting the http-server, from the build folder: | ||
| − | < | + | <syntaxhighlight lang="bash"> |
| − | + | $ cd build | |
| − | The server now is: | + | $ ./http-server |
| + | </syntaxhighlight> | ||
| + | |||
| + | The server now is: | ||
| + | * Serving files from the folder '''/var/www/html''' | ||
| + | * Listening on the prefix http://webserver | ||
| + | * Listening on the TCP port 8080 | ||
For retrieving a content through icn, the name must have the following format: | For retrieving a content through icn, the name must have the following format: | ||
| − | < | + | <syntaxhighlight lang="bash"> |
| + | $ iget http://webserver/file.mp4 | ||
| + | </syntaxhighlight> | ||
| + | |||
| + | The application iget is available in the package '''libicnet'''. | ||
| + | |||
| + | The server accept three option through the command line: | ||
| + | |||
| + | <syntaxhighlight lang="bash"> | ||
| + | $ ./http-server -h | ||
| + | http-server [-p PATH_TO_ROOT_FOOT_FOLDER] [-l WEBSERVER_PREFIX] [-x REMOTE_ORIGIN] | ||
| + | </syntaxhighlight> | ||
| + | |||
| + | The default values for the first two parameters are '''/var/www/html''' for the root folder and '''http://webserver''' as icn prefix served. | ||
| + | |||
| + | The http-server can also be used as a transparent proxy: if the resources to retrieve are stored in | ||
| + | a remote location and they are available over http, it is possible to retrieve them by specifying their | ||
| + | location when starting the http-server, in this way: | ||
| + | |||
| + | <syntaxhighlight lang="bash"> | ||
| + | $ ./http-server -x myvideos.org | ||
| + | </syntaxhighlight> | ||
| − | The server | + | The server will perform the following operations: |
| − | + | * When it receives the first client request, it will look for the asked resource locally | |
| − | + | * If the resource is not available, it will forward the HTTP request to the remote origin ''myvideos.com'' | |
| − | + | * The remote origin will reply with the content (or with an error code) | |
| + | * The reply will be forwarded to the client | ||
== Platforms == | == Platforms == | ||
| − | + | Http-server has been tested in: | |
| − | + | * Ubuntu 16.04 (x86_64) | |
| − | + | * Ubuntu 14.04 (x86_64) | |
| − | + | * Debian Testing | |
| − | + | * MacOSX 10.12 | |
| + | * CentOS 7 | ||
Revision as of 09:43, 6 June 2017
Contents
HTTP Server over TCP/ICN
This is an implementation of a HTTP server able to serve client requests using both TCP and ICN as transport protocol.
This project is a fork from the http server implemented by Ole Christian Eidheim and open sourced at https://github.com/eidheim/Simple-Web-Server.
In the ICN flavour, so far, we support just the GET method. Later we'll be implementing the remaining methods as well.
Dependencies
- libboost-regex-dev
- libboost-system-dev
- libboost-filesystem-dev
- libicnet
- libcurl
Install the HTTP-Server
Installation from binary packages
Ubuntu 14.04 and Ubuntu 16.04
$ echo "deb [trusted=yes] https://nexus.fd.io/content/repositories/fd.io.master.ubuntu.$(lsb_release -sc).main/ ./" \ | sudo tee -a /etc/apt/sources.list.d/99fd.io.list $ sudo apt-get update $ sudo apt-get install http-server
Centos 7
$ cat << EOF | sudo tee -a /etc/yum.repos.d/99fd.io.repo [fdio-cicn-master] name=fd.io master branch latest merge baseurl=https://nexus.fd.io/content/repositories/fd.io.master.centos7/ enabled=1 gpgcheck=0 EOF $ sudo yum install http-server
Installation from source code
For installing the application:
$ mkdir build && cd build $ cmake .. $ make $ sudo make install
Usage
For starting the http-server, from the build folder:
$ cd build $ ./http-server
The server now is:
- Serving files from the folder /var/www/html
- Listening on the prefix http://webserver
- Listening on the TCP port 8080
For retrieving a content through icn, the name must have the following format:
$ iget http://webserver/file.mp4
The application iget is available in the package libicnet.
The server accept three option through the command line:
$ ./http-server -h http-server [-p PATH_TO_ROOT_FOOT_FOLDER] [-l WEBSERVER_PREFIX] [-x REMOTE_ORIGIN]
The default values for the first two parameters are /var/www/html for the root folder and http://webserver as icn prefix served.
The http-server can also be used as a transparent proxy: if the resources to retrieve are stored in a remote location and they are available over http, it is possible to retrieve them by specifying their location when starting the http-server, in this way:
$ ./http-server -x myvideos.org
The server will perform the following operations:
- When it receives the first client request, it will look for the asked resource locally
- If the resource is not available, it will forward the HTTP request to the remote origin myvideos.com
- The remote origin will reply with the content (or with an error code)
- The reply will be forwarded to the client
Platforms
Http-server has been tested in:
- Ubuntu 16.04 (x86_64)
- Ubuntu 14.04 (x86_64)
- Debian Testing
- MacOSX 10.12
- CentOS 7
