home *** CD-ROM | disk | FTP | other *** search
/ ftp.alaska-software.com / 2014.06.ftp.alaska-software.com.tar / ftp.alaska-software.com / waa / waa182w32.txt < prev    next >
Text File  |  2003-03-27  |  8KB  |  201 lines
  1. /*
  2.  * READW.ME of the Alaska Web Application Adaptor Version 1.82
  3.  * for Windows NT/2000/XP and Windows 95/98/ME
  4.  *
  5.  * Release: 1.82.294
  6.  * Date:    March 24th 2003
  7.  * 
  8.  */
  9.  
  10.  ________________
  11.  1.0 Installation
  12.  
  13.  
  14.  1.1 Procedure
  15.  
  16.      When you have downloaded the Web Application Adaptor (WAA) as 
  17.      a ZIP archive, unpack the archive in a temporary directory and start 
  18.      the SETUP program. 
  19.      If you have received WAA on CD-ROM, insert the CD in your CD-ROM 
  20.      drive and start the SETUP program from the WAA1W32 directory.
  21.       
  22.      Note for Xbase++ users: Select "Custom installation" (see 1.2 below)
  23.  
  24.      The WAA development kit is installed by default on drive C: with 
  25.      the following directory structure: 
  26.  
  27.      \ALASKA\WAA1W32 
  28.                 |---APACHE       Apache HTTP server  
  29.                 |      |---OS2     OS/2 version 
  30.                 |      |---W32     Windows 9x and Windows NT version 
  31.                 |
  32.                 |---BOOK         WAA documentation 
  33.                 |
  34.                 |---GATEWAY      Gateway between the HTTP server and WAA  
  35.                 |      |---OS2     OS/2 version  
  36.                 |      |---W32     Windows 95/98/ME and Windows NT/2000/XP
  37.                 |      |           version 
  38.                 |      |---ISAPI   Gateway for MS Internet Information Server
  39.                 |      |---LINUX   Gateway for LINUX glibc2
  40.                 |
  41.                 |---SOURCE
  42.                 |      |---SAMPLES
  43.                 |            |---WAA   Source code for example applications 
  44.                 |
  45.                 |---SERVER       Web Application Adaptor (WAA) 
  46.                                    (and Xbase++ runtime, when installed)
  47.  
  48.      When the installation program has finished, the file WAA1SRV.EXE 
  49.      is located in the ..\SERVER directory. This file is the WAA server 
  50.      and it needs a connection to your HTTP server. The connection is 
  51.      provided by a gateway which is available for OS/2, Windows and Linux 
  52.      platforms. How to install and configure the gateway depends on
  53.      the HTTP server you are using. 
  54.  
  55.      Please refer to the online documentation for further configuration 
  56.      steps.
  57.  
  58.  
  59.  1.2 You have Xbase++ installed
  60.  
  61.      Select "Custom Installation" and unselect the checkbox for the Xbase++
  62.      runtime libraries. It is not recommended to install the Xbase++ runtime 
  63.      environment twice. 
  64.  
  65.  
  66.  1.3 You do not have Xbase++ installed
  67.  
  68.      The setup program of the Alaska WAA neither changes any environment
  69.      variables nor replaces any system components. If you install 
  70.      Xbase++ runtime files included with the Web Application Adaptor, 
  71.      these runtime files will reside in the SERVER directory and will not 
  72.      interfere with an existing Xbase++ installation. The package contains 
  73.      only those Xbase++ runtime files needed by the WAA.
  74.  
  75.  
  76.  1.4 WAA Worker Threads 
  77.  
  78.      Each request to the WAA is initiated by a Web browser and sent to the
  79.      HTTP server. In turn, the HTTP server forwards these requests via the
  80.      WAA gateway (WAA1GATE.EXE) to the WAA server (WAA1SRV.EXE). On startup,
  81.      the WAA creates several worker threads which actually process the
  82.      individual requests. Results are then returned via the gateway to 
  83.      the HTTP server, which in turn notifies the Web browser, thus completing 
  84.      the request.
  85.  
  86.      The optimal number of worker threads depends on a variety of issues and
  87.      is hard to specify in general. As a rule of thumb, the following should be
  88.      considered:
  89.  
  90.      o The faster a request can be fulfilled, the fewer worker threads are
  91.        required.
  92.  
  93.      o The higher the workload for a package request, the more worker threads
  94.        are needed to achieve good response times.
  95.  
  96.      o The optimal number of worker threads is determined by CPU capacity, 
  97.        not by RAM capacity. Since worker threads consume only a very low amount 
  98.        of memory (approximately 100K), the CPU workload becomes the bottleneck,
  99.        i.e. the determinating factor. Hence, the higher the CPU capacity, the 
  100.        more worker threads can be serviced.
  101.  
  102.  1.5 Linux gateway
  103.  
  104.      The source code of the WAA gateways is available with the Professional 
  105.      Subscription. The following shell command should initiate the make 
  106.      process:
  107.  
  108.         make -f gate.mak
  109.  
  110.      IMPORTANT: Due to the nature of a Unix operating system (lightweight processes) 
  111.      our research has proven the fact that a Linux gateway is up to 25 times
  112.      faster than the gateway on a Windows platform.
  113.  
  114.  1.6 Samples
  115.  
  116.      The samples are located in a subdirectory "WAA". To run the samples, it is
  117.      required to configure this directory as Document Root directory of the HTTP
  118.      server. For further details, please be referred to the chapter "HTTP Server" 
  119.      in the online documentation. It might also be necessary to edit the 
  120.      waa1gate.cfg accordingly.
  121.  
  122.  ____________________________
  123.  2.  Support and contact info
  124.  
  125.  2.1 Technical support
  126.  
  127.      Technical support is available for every registered user of 
  128.      Alaska Software products. If you are not a registered user
  129.      you can also send in your support requests but they may be 
  130.      handled at a lower priority compared to others. Furthermore,
  131.      a response to your request may not be guaranteed by Alaska 
  132.      Software in this case.
  133.  
  134.      To get in contact with our Technical Support use one of the 
  135.      contacts listed in 2.2.
  136.  
  137.  
  138.  2.2 How to contact Alaska
  139.  
  140.      You can use one of the following possibilities:
  141.  
  142.      Customers in Europe, Middle East, Africa use:
  143.  
  144.           support@de.alaska-software.com
  145.  
  146.      FAX:               (+49) 6196 / 779 3622
  147.      Phone:             (+49) 6196 / 779 360
  148.      Mail:              Alaska Software Technology AG
  149.                         Hauptstrasse 71-79
  150.                         65760 Eschborn
  151.                         Germany
  152.  
  153.      Customers in America, Asia, Pacific Rim, Australia use:
  154.  
  155.           support@us.alaska-software.com
  156.  
  157.      FAX:               (+1) 970-242-7557
  158.      Phone:             (+1) 970-242-1084
  159.      Mail:              Alaska Software, Inc.
  160.                         PBM 502
  161.                         569 32 Road, Ste. 7B
  162.                         Grand Junction CO 81504
  163.                         U.S.A.
  164.  
  165.  
  166.  2.3  News groups
  167.  
  168.       The Alaska Software news server address is:
  169.  
  170.            news.alaska-software.com
  171.  
  172.       A variety of Xbase++ related news groups are hosted by Alaska
  173.       Software on this server and you are invited to visit our news
  174.       groups regularly. The news groups provide access to a tremendous
  175.       amount of technical know how and experience that is shared between
  176.       Xbase++ users world wide.
  177.  
  178.      If you have questions about WAA or if you want to share your
  179.      experiences with other programmers, this is the right place to do it:
  180.  
  181.           news://news.alaska-software.com/alaska-software.news.waa
  182.  
  183.  _________________
  184.  3.  Miscellaneous
  185.  
  186.  3.1 Trademark and copyright
  187.  
  188.    * Alaska Xbase++, Alaska XbToolsIII, DMLB, XBP and WAA are registered
  189.      trademarks or trademarks of the Alaska Software.
  190.  
  191.    * OS/2 is a registered trademark of the International Business Machines
  192.      Corporation.
  193.  
  194.    * Windows NT, Windows 2000, Windows XP and Windows 95/98/ME are 
  195.      registered trademarks or trademarks of the Microsoft Corporation.
  196.  
  197.  
  198.  
  199. WITH BEST REGARDS
  200. Your Xbase++ Team...
  201.