                   StWeb - Stratos Web Server
                     (http://www.stweb.org)



  What is StWeb?
  -----------

  StWeb  is an integrated HTTP and application server. Detailed
  description of StWeb can be found on StWeb site http://www.stweb.org.

  Documentation
  -------------

  The most up-to-date documentation is available for on-line
  consulting and download on http://www.stweb.org/document.html.



  Downloads
  ---------

  The latest version of StWeb run-time and applications can be
  found on download page  http://www.stweb.org/download.html.


  What should be downloaded:
       1. The StWeb run-time binaries for your system
       2. The StWeb tutorial and demo application binaries
       3. The StWeb tutorial and demo application source files
       4. The documentation


  Installation notes for Windows95/98/NT
  --------------------------------------

  To get the latest information please check the StWeb site:
  http://www.stweb.org

  Requirements:

    * TCP/IP networking must be installed
    * The Oracle client must be installed for StWeb/Oracle

  The StWeb run-time for Windows95/98/NT came as zip file with
  self-installing setup. Unzip the file in one temporary directory
  and run the setup.exe. If you are non an experienced user, just
  accept the default setting.


  The default StWeb installation layout on Windows is:

      C:\stweb\         - stweb.exe & StwebCore.dll
      C:\stweb\cgi-bin\ - default directory for CGI applications
      C:\stweb\conf\    - configuration files
      C:\stweb\htdocs\  - document root directory
      C:\stweb\logs\    - log files

  NOTE: If you installed StWeb to another disk, but the name of
        the StWeb home directory remains unchanged, there should
        be no problems and you can use the default configuration
        files provided with this distribution.

  The name of the program and DLL depends on the version of StWeb you
  are using. It is:
   stweb    - if you are using the MySql database server
   stwebora - if you are using the Oracle
   stwebx   - if you are using ODBC version

  In \stweb directory you will find the Stratos compiler - stcompx.exe.
  If you want to be able to easily  refer to the location of the compiler,
  you must modify this environment variable or you can
  move the stcompx in one of the directories already in the PATH.


  StWeb is an windows console application. On Windows NT it can be
  installed as a service or it can be run from the command line.
  On Windows 95/98 it runs only as console application.


  You can install StWeb as a Windows NT service as follows:
      stweb -i
  or  stwebora -i
  or  stwebx -i

  and to remove the StWeb service, use
      stweb -u
  or  stwebora -u
  or  stwebx -u


  Once this is done you can start StWeb by opening the Services window
  (Control  Panel), selecting StWeb service and clicking on Start.
  StWeb will be running in the background. You can stop it by clicking
  on Stop.

  As an alternative to using the Services window, you can start and stop
  StWeb from the command line with:

     NET START STWEB
     NET STOP STWEB

  To run StWeb as a console application from the command line on WinNT ,
  use the following command:

      stweb -s
  or: stwebora -s
  or: stwebx -s


  Installation notes for Unix-like systems
  ----------------------------------------

  To get the latest information please check the StWeb site:
  http://www.stweb.org

  Requirements:

    * TCP/IP networking must be installed
    * The Oracle client must be installed for StWeb/Oracle

  The StWeb run-time for Unix came as compressed tar file. The default
  installation path is /usr/local/stweb.

  The default StWeb installation layout on Unix is:

      /usr/local/stweb/bin      - binaries and scripts
      /usr/local/stweb/cgi-bin/ - default directory for CGI applications
      /usr/local/stweb/conf/    - configuration files
      /usr/local/stweb/htdocs/  - document root directory
      /usr/local/stweb/logs/    - log files


  The name of the program depends on the version of StWeb you
  are using. It is:
   stweb    - if you are using the MySql database server
   stwebOra - if you are using the Oracle

  In /stweb/bin directory you will find the Stratos compiler - stcompx.
  If you want to be able to easily  refer to the location of the compiler,
  you must modify this environment variable or you can
  move the stcompx in one of the directories already in the PATH.

  To start the StWeb server on Unix you can use stwebctl script:

   /usr/local/stweb/bin/stwebctl start

   and stop it with:

      /usr/local/stweb/bin/stwebctl stop

  The StWeb runs as a demon.


  Post-installation notes
  -----------------------

  If you installed StWeb in a directory different than default (/stweb)
  as a first thing to do is to edit web configuration file
  /installation-directory/conf/stweb.conf (installation-directory
  is a directory where you have installed the StWeb!)  and replace all
  occurrences of "/stweb" with the yours installation-directory name.
  The same should be done with Stratos configuration files (stratos.ini).

  To connect to the server and access the default page, launch a browser
  and enter this URL:   http://localhost/
  Before to do this please check the proxy setup in your browser and
  disable the proxy for localhost.

  If you run into troubles please check How To page on http://www.stweb.org.

  MySql Database connection
  -------------------------

  The default Stratos configuration files (stratos.ini) is set to
  connect with MySql server on "localhost" as user "guest" and
  password "guest":

  Example of /stweb/htdocs/stratos.ini file:

  !------------------------------------------------
  ! Environment variables:
  ! ST_TMP- defines the temporary directory for StWeb
  ! STRAT_SERVER - MySql host
  ! STRAT_USER   - database user
  ! STRAT_PASSWD - password
  !------------------------------------------------
  @STRAT_ENV
  ST_TMP=c:/tmp

  STRAT_SERVER=localhost
  STRAT_USER=guest
  STRAT_PASSWD=guest

  !------------------------------------------------
  ! Program directories
  !------------------------------------------------
  @STRAT_PROGS
  /stweb/htdocs


  If you have MySql server running on another machine or want to change the
  default user, please edit the htdocs/stratos.ini file and set the
  appropriate values.

  ODBC Database connection
  -------------------------

  If you are using the StWeb/ODBC the connection is established with
  the database which name is specified in sqlConnect() function call.
  The name must be a valid DSN name. As the default user and password
  the values of STRAT_USER/STRAT_PASSWD will be used.

  Note: The Tutorial and demo applications use "dbdemo" database, so
        you have to create a valid DSN "dbdemo" which connects the
        database of your choice.

  Oracle Database connection
  --------------------------

  If you are using the StWeb/Oracle the connection is established with
  the database which name is specified in sqlConnect() function call.
  The name must be a valid Oracle service name. As the default user and
  password the values of STRAT_USER/STRAT_PASSWD will be used.

  Note: The Tutorial and demo applications use "dbdemo" database, so
        you have to create a valid Oracle service name "dbdemo". You
        can use "Oracle Net8 Easy Config" to accomplish this task.



  Tutorial and Demo Applications
  -------------------------------

  StWeb Tutorial and Demo Applications in binary and source form are provided
  as separate zip files. The binaries must be installed in StWeb document root
  directory (default /stweb/htdocs).
  The Windows users can download the self-extracting zip which will
  install all Stratos binaries.
  For Unix users there is a compressed tar which should be extracted
  in /prefix-path/stweb (by default "prefix-path" is /usr/local !).

  Once again, if you have changed the StWeb installation path, please
  edit the Stratos configuration files (stratos.ini) to set the
  exact paths.

  Licensing
  ---------

  Please see the file LICENSE.

  Acknowledgements
  ----------------

  This product includes software developed by the Apache Group
  for use in the Apache HTTP server project (http://www.apache.org/).


Thanks for using StWeb:)
