Embedthis Embedthis Appweb(TM)
README.TXT for Installing Appweb on Windows

Welcome to the Embedthis Appweb distribution. 

This document contains describes the procedure for installing Appweb. This package contains a pre-built stand-alone (binary) web server and the development documentation, libraries, headers and samples needed to embed Appweb in an 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.embedthis.com/products/appweb/doc/index.html


This software is copyrighted and distributed under license. Please read the LICENSE.TXT for details.


System Requirements

To install Embedthis Appweb on a development system, you will need at least the following:

    * Windows XP, Vista or 7
    * 256MB RAM
    * 10 MB free disk space
    * TCP/IP network stack

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

    * 30 MB disk space


Development Environment Platform Support

If you wish to embed Appweb in your application, build the samples or rebuild Embedthis Appweb from source code, you will need to use a C/C++ compiler and associated development tools. Two development environments are supported.  You may choose either of the following:

    * Windows Visual Studio Express 2008 or later

    * Cygwin Unix Emulation Tools (see www.cygwin.com)


Installing Embedthis Appweb

The installation distribution includes sub-packages containing pre-built binaries, development libraries, headers, documentation and samples. It also contains the complete source code for Appweb. You can selectively install the sub-packages or you can install the complete distribution.

The Embedthis Appweb Server install distribution for Windows is published in one format:

    * A ZIPped Windows installer executable named:

      appweb-VERSION-BUILD-WIN-i386.exe.zip

The package contains the binary distribution, libraries, headers, documentation and samples distribution in the one package. During installation you will have the option of installing the full package or just the binary or documentation and samples.

To install the Windows Installer package

   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 README.TXT and setup.exe from the zip archive.

   3. Select Run from the Start menu and browse to the location holding the setup.exe install package and select it.

   4. Click OK.


Removing Embedthis Appweb

If you installed the Tar package, you will need to remove Appweb manually. If you installed the Windows Installer package, follow these steps to remove Appweb.

   1. Login with administrator privileges

   2. Run the Add / Remove Programs applet from the control panel.

   3. Select the Embedthis Appweb Server and choose remove.


Running Appweb on Windows

Appweb can run in the background as a windows service, or in the foreground as a windows application or as a console application. 

The Appweb Windows Installer product installation will automatically start appweb as a Windows Service before the installation completes. Thereafter, Appweb will automatically start if the system is rebooted. You may start and stop Appweb manually if you wish. To do this, you will first need to disable the Appweb Windows Service via the following steps:

   1. Start the Windows Service Control Applet by right clicking on My Computer and then selecting Manage. 

   2. Then click on Services and Applications in the left-hand pane. 

   3. Select Services in the left pane and then scroll in the right pane to find Embedthis Appweb and double click on Embedthis Appweb.

   4. Select Start, Stop, Pause or Resume as required.

   5. Or change the Startup Type to be manual to permanently disable Appweb as a Windows Service.


To Manually run Appweb as a windows app

   1. Ensure that appweb is not running as a service (as described above)

   2. Display the contents of Programs > Embedthis Appweb under the Start menu.

   3. Select Embedthis Appweb. The application will be started and its icon will appear in the status area of the Windows taskbar. This is actually starting appweb. You can double click on the appweb icon to launch a browser.


To Run Appweb from the Console

   1. Select Run from the Start menu and browse to the location holding the Embedthis Appweb installation. Browse to the App web program which by default is in C:/Program Files/Embedthis Appweb/bin/appweb.exe. Select the appweb.exe program.

   1. Double click OK

   2. A command.com window will appear

   3. To exit the application, close the window


Appweb is run as configured by default to startup up automatically as a system service and to listen on port 7777. To test that it is serving pages, point your browser at http://localhost:7777. To tailor the Embedthis Appweb configuration, including the default port, you may wish to edit the appweb.conf configuration file.


Building the Source Code

If you wish to rebuild the Appweb product from the distributed source code, please read "Building from Source" in the Appweb product documentation for an explanation of the necessary steps to successfully rebuild the product.


Exporting

This distribution includes cryptographic software.  The country in which you currently reside may have restrictions on the import, possession, use, and/or re-export to another country, of encryption software. BEFORE using any encryption software, please check your country's laws, regulations and policies concerning the import, possession, or use, and re-export of encryption software, to see if this is permitted.  See <http://www.wassenaar.org/> for more information.

The U.S. Government Department of Commerce, Bureau of Industry and Security (BIS), has classified this software as Export Commodity Control Number (ECCN) 5D002.C.1, which includes information security software using or performing cryptographic functions with asymmetric algorithms. This release is eligible for export under the License Exception ENC Technology Software Unrestricted (TSU) exception (see the BIS Export Administration Regulations, Section 740.13) for both object code and source code.


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-2007. All Rights Reserved.

Embedthis is a trademark of Embedthis Software LLC. Embedthis, Appweb, ESP and EGI 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
www.embedthis.com
info@embedthis.com
