The HyperText Transfer Protocol (HTTP) port

Revised for CPX 4.7.0.
Configuration of the HyperText Transfer Protocol (HTTP) port

Configuration of the HyperText Transfer Protocol (HTTP) port
Statistics of the HyperText Transfer Protocol (HTTP) port

Configuration of HTTP Virtual Root Paths
Configuration of HTTP Virtual Path's Access Rights

Http user manual
<<<<<<< mod_http.htm Http pages for traffic analisys (TRFA)


======= Http pages for IP traffic analisys (TRFA)


>>>>>>> 1.14

The HTTP port is sued by the Abilis CPX to implement the homonymous protocol.

Generally the HyperText Transfer Protocol (HTTP) is an applicative layer protocol and belongs to the TCP/IP family. It transfers hyper textual information and it uses the transport service of Connection Oriented type, provided by the protocol TCP/IP.

...

Configuration of the HyperText Transfer Protocol (HTTP) port top

The HTTP port implements the HyperText Transfer Protocol and it is labelled within the Abilis CPX with the acronym "HTTP". it is provided with the parameters described in this section.

Here is an example on how to display the HTTP port parameters. Shown values are the default ones.

[18:45:45] ABILIS_CPX: D P PO:HTTP

PO:915 ------------------------------------------------------------------------
HTTP   lowpo:901   ACT:NO   locport:80     sesnum:12        COOKIE-TOUT:1440   
       IPSRC:*                             IPSRCLIST:#          
       WDIR:C:\APP\HTTP\                    
       START-PAGE:SYS (/sys/cpx.htm)  

To activate changes made on the parameters displayed by low case characters, it is needed to restart the system; on the contrary for activating changes made on high case parameters it is enough to execute the initialization command INIT PO:.

Details of the parameters of the HTTP port


LOWPO: Identifier of the lower TCP port
901 1 - 999, NONE

It sets the Abilis CPX lower layer port. It can be a TCP port only.

The value "NONE" isolates the HTTP port.


ACT: Run time activation/deactivation flag
NO NO, YES

This parameter allows to run-time activate/deativate the HTTP protocol functionalities above mentioned. If the parameter is set to "NO", even if the HTTP port is configured and active, it won't provided any service.


locport: Identifier of the IP local port used
80 80

It sets the IP local port used by the HTTP one. Recommendations reserve the number 80 for the HTTP service.

This is an informative parameter and its value cannot be changed.


sesnum: Maximum number of HTTP sessions
12 0..255

It sets the maximum number of sessions on the HTTP port.


COOKIE-TOUT: Cookie time-out
1440 5..65535 min.

It sets the cookie time-out in minutes.


IPSRC: IP address of the enabled source
* see table, *

This parameter configures the IP address of the enabled source of incoming requests.

The allowed values are showed by the following table:

HEX: 00000000 01000000 - 7EFFFFFF 80000000 - DFFFFFFF
DDN: 0.0.0.0 1.0.0.0 - 126.255.255.255 128.0.0.0 - 223.255.255.255

IP address of class D and E are not actually supported.

The character '*' means "any IP source address".


IPSRCLIST: List of the IP addresses of the enabled sources
# ListName, #

This parameter configures a list of the enabled sources of incoming requests.

A string of maximum 20 characters in the range [0..9, a..z, A..Z, _] is accepted. The configured name must correspond to the name of a list of IP addresses or the name of a list of IP addresses ranges or the name of a Rule list or the name of a Master Rule list. The referenced list must already be defined in the Elements Lists service.

The character '#' means "no list".


WDIR: Directory where temporary files are saved
C:\APP\HTTP\ see below

This parameter selects the directory where temporary files are saved. It cannot be empty. It must be a physical full path in DOS notation, i.e. starting with a drive letter in the range ['A'..'Z'] and ending with the '\' character. The maximum accepted working directory string length is 128 characters. Case is preserved and spaces are allowed, but strings holding spaces must be written between quotation marks (E.g.: "C:\My dir\").


START-PAGE: Start page
SYS (/sys/cpx.htm) ListName, #

This parameter selects the HTTP start page. The user can select between the "SYS" value, i.e. the default system start page corresponding to the "/sys/cpx.htm", and a specific file, whose name must be specified with the related URL (Uniform Resource Identifier)(E.g.: "/default.htm" or "/root/home.htm" ). The maximum accepted start page string length is 128 characters. Case is preserved and spaces are allowed, but strings holding spaces must be written between quotation marks (E.g.: "/My url/index.htm").

Statistics of the HyperText Transfer Protocol (HTTP) port top

Example on how to show state and statistics of the HTTP port through the command D S:

[18:45:45] ABILIS_CPX: D S PO:HTTP

PO:915 ------------------------------------------------------------------------
HTTP   STATE:READY     MAX-CONN:12    
       ------------------------------------------------------------------------
       CH  State       LocAdd-LocPort         RemAdd-RemPort    
       ------------------------------------------------------------------------
       0   LISTENING   000.000.000.000-80
       1   LISTENING   000.000.000.000-80
       2   LISTENING   000.000.000.000-80
       3   LISTENING   000.000.000.000-80
       4   LISTENING   000.000.000.000-80
       5   LISTENING   000.000.000.000-80
       6   LISTENING   000.000.000.000-80
       7   LISTENING   000.000.000.000-80
       8   LISTENING   000.000.000.000-80
       9   LISTENING   000.000.000.000-80
       10  LISTENING   000.000.000.000-80
       11  LISTENING   000.000.000.000-80
       -----------|---INPUT---|--OUTPUT---|-----------|---INPUT---|--OUTPUT---|
       CHR        |          0|          0|REQ        |          0|           |
       REQ-GET    |          0|           |REQ-POST   |          0|           |
       REQ-PUT    |          0|           |
       ------------------------------------------------------------------------

Example on how to show extended statistics of the HTTP port through the command D SE:

[11:32:37] ABILIS_CPX: D SE PO:HTTP

PO:915 ------------------------------------------------------------------------
HTTP   --- Cleared 000:00:00:00 ago, on 15/03/2004 at 17:46:44 ----------------
       -----------|---INPUT---|--OUTPUT---|-----------|---INPUT---|--OUTPUT---|
       CHR        |          0|          0|REQ        |          0|           |
       REQ-GET    |          0|           |REQ-POST   |          0|           |
       REQ-PUT    |          0|           |
       ------------------------------------------------------------------------
       CH:0
       -----------|---INPUT---|--OUTPUT---|-----------|---INPUT---|--OUTPUT---|
       CHR        |          0|          0|REQ        |          0|           |
       REQ-GET    |          0|           |REQ-POST   |          0|           |
       REQ-PUT    |          0|           |
       ------------------------------------------------------------------------
       CH:1
       -----------|---INPUT---|--OUTPUT---|-----------|---INPUT---|--OUTPUT---|
       CHR        |          0|          0|REQ        |          0|           |
       REQ-GET    |          0|           |REQ-POST   |          0|           |
       REQ-PUT    |          0|           |
       ------------------------------------------------------------------------
       CH:2
       -----------|---INPUT---|--OUTPUT---|-----------|---INPUT---|--OUTPUT---|
       CHR        |          0|          0|REQ        |          0|           |
       REQ-GET    |          0|           |REQ-POST   |          0|           |
       REQ-PUT    |          0|           |
       ------------------------------------------------------------------------

The information "Cleared DDD:HH:MM:SS ago, at DD/MM/YYYY HH:MM:SS", referred by the extended statistics, shows the elapsed time from the last reset of the statistics (by the format "days:hours:minutes:seconds") and date/time of its execution (by the format "day/month/year" and "hours:minutes:seconds").

Details of the state fields and statistics of the HTTP port


STATE: Current state of the HTTP port
INACTIVE, DOWN, READY, ERR

It shows the current state of the HTTP port driver.

Driver States Description Values shown in:
System Log Events Log Display LCD
HTTP INACTIVE The run time activation flag ACT: is set to "NO".     IN
DOWN The run time activation flag ACT: is set to "YES", but Listen(s) to lower TCP port fail.     DN
READY The run time activation flag ACT: is set to "YES", and HTTP is connected to lower TCP port.     RD
ERR Software error. Contact Abilis CPX assistance.     NA


MAX-CONN: Current maximum number of connections
0..255

It shows the current maximum number of HTTP connections.


CHR Number of characters sent/received by the port
0 - 4.294.967.295

The counter CHR (INPUT) is incremented every time data are received by the port. The counter CHR (OUTPUT) is incremented every time data are sent by the port.


REQ Number of requests received by the port
0 - 4.294.967.295

The counter REQ (INPUT) is incremented every time a requests is received by the port.


REQ-GET Number of GET requests received by the port
0 - 4.294.967.295

The counter REQ (INPUT) is incremented every time a GET requests is received by the port.


REQ-POST Number of GET requests received by the port
0 - 4.294.967.295

The counter REQ (INPUT) is incremented every time a POST requests is received by the port.


REQ-PUT Number of GET requests received by the port
0 - 4.294.967.295

The counter REQ (INPUT) is incremented every time a PUT requests is received by the port.

Details of the state fields and statistics of the HTTP connections


CH Connection identifier
0..255

It is the connection identifier.


State Connection state
CLOSED, LISTENING, CALLED, CALLING, CONNECTED, READY, CLEARING, CLEARED, DESTRUCTING, DOWN, READY, ERR

It shows tha current state of the HTTP connection.


LocAdd-LocPort Local IP address and Local port
000.000.000.000..255.255.255.255 - 1..65535

It show the local IP address, in Dotted Decimal Notation, and the local TCP/IP port.


RemAdd-RemPort Remote IP address and Remote port
000.000.000.000..255.255.255.255 - 1..65535

It show the remote IP address, in Dotted Decimal Notation, and the remote TCP/IP port.


CHR Number of characters sent/received by the single connection
0 - 4.294.967.295

The counter CHR (INPUT) is incremented every time data are received by the single connection. The counter CHR (OUTPUT) is incremented every time data are sent by the single connection.


REQ Number of requests received by the single connection
0 - 4.294.967.295

The counter REQ (INPUT) is incremented every time a requests is received by the single connection.


REQ-GET Number of GET requests received by the single connection
0 - 4.294.967.295

The counter REQ (INPUT) is incremented every time a GET requests is received by the single connection.


REQ-POST Number of GET requests received by the single connection
0 - 4.294.967.295

The counter REQ (INPUT) is incremented every time a POST requests is received by the single connection.


REQ-PUT Number of GET requests received by the single connection
0 - 4.294.967.295

The counter REQ (INPUT) is incremented every time a PUT requests is received by the single connection.

printPrint this page