Prototype of the HTTP Speed+ Mobility proposal submitted to IETF
C# JavaScript
Switch branches/tags
Nothing to show
Fetching latest commit…
Cannot retrieve the latest commit at this time.
Failed to load latest commit information.


Microsoft Open Technologies, Inc.
Rev 1.3

HTTP Speed+Mobility (“S+M”) Prototype
Getting Started Guide
Table of Content:

1) License
2) About this Document
3) Target Audience
4) Requirements
5) Installing the HTTP Speed+Mobility Prototype Client
6) How to use the Client
	6.2) DIR
	6.3) GET
	6.5) Statistics
	6.7) CLOSE
	6.8) EXIT
        6.9) RUN
        6.10) HTTP2GET
7) Installing and configuring the server
8) References

1) License - (NOTE: HTTP2Demo folder has its own release notes and license; see inside folder)
Copyright 2012 Microsoft Open Technologies, Inc.

   Licensed under the Apache License, Version 2.0 (the "License");
   you may not use this file except in compliance with the License.
   You may obtain a copy of the License at

   Unless required by applicable law or agreed to in writing, software
   distributed under the License is distributed on an "AS IS" BASIS,
   See the License for the specific language governing permissions and
   limitations under the License.

2) About this Document

The document covers what you need to know to download, install and use the HTTP Speed+Mobility Prototype Client, and configure your own Server if you are so inclined.

3) Target Audience 

The target audience is developers interested in the standardization of HTTP 2.0 who want to evaluate a working implementation of the HTTP Speed+Mobility proposal ( that was presented at IETF 83 in Paris.

4) Requirements

To build the source code, the following is required:
- Microsoft Visual Studio 2010

In order to install and use the HTTP Speed+Mobility Prototype Client, the following are required:
- Windows 7 Client
- Microsoft .NET Framework 4.0

In order to run the server, the server machine will need to support:
- Node.JS 

5) Installing the HTTP Speed+Mobility Prototype Client

Download the MSI file from this location: and run it.
Note that you can access the source code of this open source project from the Microsoft Open Technologies section of GitHub.
Follow the prompts and once complete files will be installed to the selected location. By default, it will be the Temp folder of the current user, i.e. something like C:\Users\<user>\AppData\Local\Temp\Microsoft Open Technologies Inc\HTTP Speed+Mobility Prototype Client\.

A shortcut will be added to the desktop.

6) How to use the Client

- Double click on the "HTTP Speed+Mobility" icon installed on the desktop of your machine, or alternatively run "client.exe" from the installation folder.

- The client will start by displaying the following message:

	HTTP Speed+Mobility Prototype Client help

	HELP                          Display this help information
	CONNECT [C|S| ] <URI>         Connect to the server endpoint. If no URI is specified,
        	                      defaults to ws://
                                  defaults to no compression of headers
                                  'C' enables compression of headers
                                  'S' enables stateful compression of headers
	DIR                           List files on server.
	GET <filename>                Download web page and associated resources using
					              the S+M Protocol. E.g. GET /files/test.txt
	VERBOSE [1|2|3]               Display verbose output.
	CAPTURE-STATS [On|Off|Reset]  Start/stop/reset protocol monitoring.
	DUMP-STATS                    Display statistics captured using CAPTURE-STATS.
	HTTPGET                       Download file using HTTP 1.1
                                  Ex. http://localhost:8080/microsoft/default.htm
	CLOSE                         Close session
    RUN <filename>                Run command script
	EXIT                          Exit application

	Please type a command:


The first step after launching the client is to issue a CONNECT command
If you have set up your own S+M server, add the URI of that server. Otherwise leave blank. The client will automatically connect to the default Azure endpoint:

	Executing connect
	[2:58:17 PM] INFO:Session is opened: ws://

CONNECT command accepts additional switch ('c' or 's')
'c' enabled compression of HTTP headers using static dictionary
's' enables compression of HTTP headers using dynamic dictionary

	connect s ws://

Connect to  Azure endpoint, use dynamic header copression

6.2) DIR

Once you are connected to the server, use DIR to see a list of the documents available for download from the server (this is accomplished by downloading and then displaying the content of a special "index" file):

	Executing dir
	[2:59:24 PM] INFO:Stream is opened: id=1
	[2:59:24 PM] INFO:File downloaded: index


	[2:59:24 PM] INFO:Bytes transferred:134 upstream, 128 downstream, 262 Total

6.3) GET 

In order to download a file, issue a GET statement followed by the path of the file. The client will download the file. Then it will parse its content and download any associated resources similarly to what a web browser does:

	GET /website/test.html
	Executing get /website/test.html
	[3:08:39 PM] INFO:Stream is opened: id=3
	[3:08:39 PM] INFO:File downloaded: test.html
	[3:08:39 PM] INFO:Stream is opened: id=5
	[3:08:39 PM] INFO:Stream is opened: id=7
	[3:08:39 PM] INFO:Bytes transferred:146 upstream, 14069 downstream, 14215 Total
	[3:08:39 PM] INFO:File downloaded: testImage1.jpg
	[3:08:39 PM] INFO:Bytes transferred:153 upstream, 3002 downstream, 3155 Total
	[3:08:39 PM] INFO:File downloaded: testImage14.jpg
	[3:08:39 PM] INFO:Bytes transferred:154 upstream, 3002 downstream, 3156 Total

	[3:08:40 PM] INFO:File downloaded: test3.css
	[3:08:40 PM] INFO:Bytes transferred:146 upstream, 391 downstream, 537 Total

The client displays a message whenever a new stream is opened within the session. It also prints the amount of data that moved over the wire whenever a file transfer completes.


VERBOSE controls the amount of information that is displayed in response to the various commands, where 1 is the least amount, and 3 is the fullest amount:

	Executing verbose 2
	[1:06:39 AM] INFO:VERBOSE output VerboseLogging

6.5) Statistics

The client keeps track by default of all the frames (data and control) it exchanges with the server. The CAPTURE-STATS command allows to either stop the capture, reset it if it is in progress, or start it again if it was stopped:

	Executing capture-stats on

	Executing capture-stats reset

	Executing capture-stats off

The DUMP-STATS command will display the aggregate information on the files 


This command is provided to compare the information moved over the wire by the HTTP Speed+Mobility implementation vs. the current HTTP 1.1 standard. The same statistics on bytes exchanged and header information are displayed on the console according to the value of the VERBOSE setting:

	Executing httpget
	[1:08:19 AM] INFO:HTTP response: 301, length: 484
	[1:08:19 AM] INFO:
	Headers: GET HTTP/1.1
	Connection: Keep-Alive
	User-Agent: SMClient
	Accept: text/plain,application/xml;q=0.9,*/*;q=0.8
	Length: 160

	Total size of data received(bytes):       23
	Total size of headers received(bytes):    461
	Total size received(bytes):               484
	Total size of headers sent(bytes):        160
	Total size of data exchanged(bytes):      644
	Total count of requests sent:             1
	Total count of responses received:        1
	Total count of connections opened:        1

6.7) CLOSE

Issuing a CLOSE will terminate the session with the server but leave the client active.

	Executing close
	[12:35:06 AM] INFO:Current session is closed.
	[12:35:06 AM] INFO:Session closed 

6.8) EXIT

Issuing EXIT from the command line will close the session and shut down the client

6.9) RUN

RUN allows to execute commands from a script file.
The Script file is just a text file with one command per line.
Lines that starts with '#' are comments
Execute the script by passing it as an argument to RUN
'Client run test.txt'

Below is an example of a script

# Script to download a web page from server using S+M and HTTP1.1
# The statistics are displayed side by side.
# Set verbose output to Info
# Connect to Azure endpoint (ws://
# Get file with Speed+Mobility protocol
GET /files/test.txt
# Get files with HTTP1.1
HTTPGET /files/test.txt
# Display statistics side by side

6.10) HTTP2GET

This command operates exactly like HTTPGET excepts that it starts the communication over HTTP/1.1, while requesting an upgrade to HTTP/2.0 as described in the proposal

7) Installing and configuring the server

- Download and install node.js from 

- Download and install the websocket server code from

- Download the additional S+M server files or modified websocket files from

- From a command line window run the following: 

	node <path to server.js>. 

The Server.js file is located in the SMServer folder in the downloaded source code folder.

By default, the server runs on port 8080. Note that depending on your firewall’s configuration you may need to open this port, in order for the server to operate properly.

8) References

HTTP Speed+Mobility Proposal