Embedthis Appweb(TM)
Welcome to the Appweb -- the fastest little web server.
This document contains details regarding the installation procedure for the binary Embedthis Appweb package. This package contains pre-built stand-alone web server and an embeddable HTTP library with headers. You can read the documentation for the latest release online at:
http://embedthis.com/products/appweb/doc/index.html
This software is copyrighted and distributed under license. Please read the LICENSE.TXT for details.
Table of Contents
* System Requirements
* Installation Package Formats
* Development Environment Platform Support
* Apple MAC OS X Release Details
* Windows Release Details
* Removing Appweb
* Running Appweb
* Building from the Source Code
* License and Copyright Information
System Requirements
Operating System Support
* Windows XP, Vista, Windows-7 (x86,x64)
* Mac OS X 10.6+ (x64)
* Linux 2.4, 2.6 (x86,x64,arm,ppc,sparc,xscale,mips)
* VxWorks (x86,arm,ppc,sparc,xscale,mips)
To install Appweb, your development system will need at least the following:
* 50 MB Disk
* 1 GB RAM
To deploy Appweb in an embedded environment, you will need at least the following:
* 2 MB Disk / ROM space
* 2 MB RAM
To rebuild Appweb from source code on your development system, you will need at least:
* 80 MB disk space
Installation Package Formats
The Appweb binary installation is published in two formats:
* Native Apple MAC OS X PKG format
* Native Windows installer format
For other platforms, you will need to download the source code distribution and build then install. The product documentation describes how to build from source.
Development Environment Platform Support
If you wish to embed Appweb in your application or build 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:
* Linux/Unix GNU Tools
* Windows Visual Studio 2010
* WindRiver Tornado Development Tools
Apple Mac OS X Release Details
To install the native MAC OS X PKG image:
1. Download the PKG image.
2. Double click on the PKG file image.
3. Answer the questions as prompted.
Windows Release Details
To install the Windows Installer image:
1. Login with administrator privileges. This is necessary as the binary
installation needs to install a Windows Service.
2. Use WinZip or equivalent software to extract the installation image. This
will extract the README.TXT and setup.exe from the zip archive.
3. Double click on the setup.exe image to run it.
Removing Appweb
This is the procedure to remove Appweb on all systems except Windows.
1. Run the uninstall script in the install directory for Appweb by typing:
sudo /usr/lib/appweb/latest/bin/uninstall
If you installed the Appweb Windows Installer image, follow these steps to remove Appweb. If you installed the Tar
self-install image, you will need to remove Appweb using the procedure described above.
1. Login with administrator privileges
2. Run the Add / Remove Programs applet from the control panel.
3. Select the Embedthis Appweb and choose remove.
Running Appweb
Appweb will start when the Appweb installation procedure completes and on some systems, will launch your browser directed at the Appweb local home page. Thereafter, Appweb will automatically start if the system is rebooted. If you wish to manually stop Appweb, type:
appman stop
To restart Appweb:
appman start
Alternatively, you can run appweb manually:
cd /etc/appweb
appweb -v
To get all the options for Appweb, read the Appweb man page via
man appweb
or get the command help via:
appweb --help
Appweb is configured by default to listen on port 80. To test that it is serving pages, point your browser at http://localhost/.
Building from the Source Code
If you wish to rebuild the Appweb product from the distributed source code, please download the source code distribution from the Embedthis web site. Then read "Building from Source" in the Appweb product documentation for an explanation of the necessary steps to successfully rebuild the product.
License and Copyright Information
This software is supplied under license. Both a GNU and commercial license are available. Please read LICENSE.TXT for details. This documentation and the software described in this document may be used and copied only in accordance with the terms of the accompanying license agreement. Product and technical information in this document is subject to change without notice and does not represent a commitment on the part of Embedthis Software LLC.
Copyright (c) Embedthis Software LLC, 2003-2013. All Rights Reserved.
Embedthis is a trademark of Embedthis Software LLC. Embedthis, Appweb and Ejscript are trademarks of Embedthis Software. All other brand or product names are the trademarks or registered trademarks of their respective holders.
Embedthis Software, LLC.
4616 25th Ave NE, #733
Seattle, WA 98105.
+1 (425) 329-3490
embedthis.com
info@embedthis.com
2b158e20ca