Release Notes

Embedthis Appweb Release Notes

Welcome to the Embedthis Appweb distribution. This document describes the procedure for installing the binary Embedthis Appweb package. This package contains a pre-built stand-alone (binary) web server and the development libraries and headers needed to embed Appweb in a device or application. Once installed, you may read the Appweb online documentation and samples for further information. You can also read the documentation for the latest release online at:

http://www.mbedthis.com/products/appweb/doc/index.html 

This software is copyrighted and distributed under license. It is available under an open source and a commercial licenses. Please read the LICENSE.TXT for details.

System Requirements

Operating System Support

• Linux 2.4, 2.6 (x86,arm,ppc,sparc,xscale,mips) including Redhat and Debian based distributions.
• Windows Vista, XP, 2000 (x86)
• VxWorks (x86,arm,ppc,sparc,xscale,mips)

Note the binary distributions are only made available for X86 platforms.

Development Environment Hardware Platform Support

If you wish to build the samples or rebuild Embedthis Appweb from source code, you will need to use a C++ compiler and associated development tools. Several development environments are supported. You may choose any of the following to compile and build samples and source code.

• Linux GNU tools
• Windows Visual Studio (Visual Studio 6 and Visual Studio.NET 2005). This also requires the Cygwin UNIX emulation tools. See www.cygwin.com.

Run-time System Requirements

To run Embedthis Appweb, your system will need at least the following resoures (depending on your configuration)

• 1 MB spare RAM memory
• 600 KB disk / ROM space
• TCP/IP network stack

To develop applications that use Embedthis Appweb you will need an additional

• 15 MB disk space

To rebuild Appweb from source code, you will need at least

• 30 MB disk space

Packages

Appweb includes several packags including OpenSSL, MatrixSSL and PHP. These packages have their own licenses. Appweb supports and includes two SSL packages. Please note that MatrixSSL has a GPL license and if you wish to use it in a commerical product, you may require a commerical license from Peersec. OpenSSL may typically be used in either commerical or open source based implementations. Make sure you check the packages license details to ensure you are complying with their license.

Features

This release includes support for the following features:

• HTTP/1.0 and HTTP/1.1 compliant HTTP server
• Apache style configuration
• Embeddable in single and multithreaded applications
• Embedded Server Pages (ESP)
• Embedded JavaScript (EJS)
• Embedded Gateway Interface (EGI)
• Common Gateway Interface (CGI)
• PHP
• Digest and basic authentication
• File Upload
• Access and error logging streams
• Secure Sockets Layer (SSL) via OpenSSL and MatrixSSL
• Sandboxing environment for additional security
• HTTP client
• Extensible via dynamically loadable modules
• Samples
• Documentation

Release Build

This distribution is a RELEASE build and has little trace and or debug assertions to help find bugs. If you rebuild from source code, a DEBUG build may be created which has more trace to assist in debugging. Performance with the DEBUG build will be slower and the memory footprint will be larger than with the release build.

Helpful Hints

Debug Trace and Logging

Appweb has a logging and trace facility that can help greatly when diagnosing configuration issues or developing your application code that uses Appweb. You can see what modules are loaded and how, what requests arrive and how they are serviced. You can also vary the level of logging via the appweb.conf configuration file or via the -l logfile command line switch. The log command line switch has the format

-l logFile:logLevel

where level can be from 0 to 9, with 9 being the most verbose level. A level of 6 usually gives plenty of detail. You can define the log file and log level via the appweb.conf file using the ErrorLog and LogLevel directives.

Resolved Issues

See the new features and fixes in the New Features document.