home *** CD-ROM | disk | FTP | other *** search
/ ftp.alaska-software.com / 2014.06.ftp.alaska-software.com.tar / ftp.alaska-software.com / waa / waa18w32.txt < prev    next >
Text File  |  2002-05-29  |  7KB  |  197 lines
  1. /*
  2.  * READW.ME of the Alaska Web Application Adaptor Version 1.80
  3.  * for Windows NT/2000/XP and Windows 95/98/Me
  4.  *
  5.  * Release: 1.80.284
  6.  * Date:    May 29th 2002
  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 does not change any environment
  69.      variable nor will any component of the system be replaced.
  70.      If you install the Xbase++ runtime files they will reside in the 
  71.      SERVER directory. The package contains only those Xbase++ runtime 
  72.      files needed by the WAA.
  73.  
  74.  
  75.  1.4 WAA worker-threads 
  76.  
  77.      Each request to the WAA is initiated by a Web browser and sent to the
  78.      HTTP server. In turn, the HTTP server forwards browser requests via the
  79.      WAA gateway (WAA1GATE.EXE) to the WAA server (WAA1SRV.EXE). On startup,
  80.      the WAA initiates several worker-threads which actually receive a request
  81.      and return an answer via the gateway back to the HTTP server which in turn 
  82.      serves the Web browser.
  83.  
  84.      The recommended number of worker-threads depends on a variety of issues and
  85.      is hard to specify in general. As a rule of thumb, the following should be
  86.      considered:
  87.  
  88.      o The faster a request can be fulfilled, the lesser worker-threads are
  89.        required.
  90.  
  91.      o The higher the workload for a package request is, the more worker-threads
  92.        are needed to achieve a good response time.
  93.  
  94.      o The optimum amount of worker-threads is determined by the CPU capacity, not
  95.        by RAM capacity bec. a workerthread consumes approx. only 100K. The higher
  96.        the CPU capacity the more worker-threads can be serviced.
  97.  
  98.  1.5 Linux gateway
  99.  
  100.      The source code of the WAA gateways is available with the professional sub-
  101.      scription. Customers who have reported that they were not able to build the
  102.      waa1gate.exe for the Linux platform will find a reworked Unix version with
  103.      the 3rd Subscription delivery. The following shell command should initiate
  104.      the make process:
  105.  
  106.         make -f gate.mak
  107.  
  108.      IMPORTANT: Due to the nature of a Unix operating system (lightweight processes) 
  109.      our research has prooven the fact that a Linux gateway is up to 25 times
  110.      faster than the gateway on a Windows platform.
  111.  
  112.  1.6 Samples
  113.  
  114.      The samples are located in a subdirectory "WAA". To run the samples, it is
  115.      required to configure this directory as Document Root directory of the HTTP
  116.      server. For further details read the chapter "HTTP Server" in the online
  117.      documentation. It might also be necessary to edit the waa1gate.cfg accordingly.
  118.  
  119.  ____________________________
  120.  2.  Support and contact info
  121.  
  122.  2.1 Technical support
  123.  
  124.      Technical support is available for every registered user of 
  125.      Alaska Software products. If you are not a registered user
  126.      you can also make support requests but it may be handled at
  127.      a lower priority compared to others and thus a response will 
  128.      not be guaranteed by Alaska Software in this case.
  129.  
  130.      To get in contact with our Technical Support use one of the 
  131.      contacts listed in 2.2.
  132.  
  133.  
  134.  2.2 How to contact Alaska
  135.  
  136.      You can use one of the following possibilities:
  137.  
  138.      Customers in Europe, Middle East, Africa use:
  139.  
  140.           support@de.alaska-software.com
  141.  
  142.      FAX:               (+49) 6196 / 779 3622
  143.      Phone:             (+49) 6196 / 779 360
  144.      Mail:              Alaska Software Technology AG
  145.                         Hauptstrasse 71-79
  146.                         65760 Eschborn
  147.                         Germany
  148.  
  149.      Customers in America, Asia, Pacific Rim, Australia use:
  150.  
  151.           support@us.alaska-software.com
  152.  
  153.      FAX:               (+1) 970-242-7557
  154.      Phone:             (+1) 970-242-1084
  155.      Mail:              Alaska Software, Inc.
  156.                         PBM 502
  157.                         569 32 Road, Ste. 7B
  158.                         Grand Junction CO 81504
  159.                         U.S.A.
  160.  
  161.  
  162.  2.3  News groups
  163.  
  164.       The Alaska Software news server address is:
  165.  
  166.            news.alaska-software.com
  167.  
  168.       A variety of Xbase++ related news groups are hosted by Alaska
  169.       Software on this server and you are invited to visit our news
  170.       groups regularly. The news groups provide access to a tremendous
  171.       amount of technical know how and experience that is shared between
  172.       Xbase++ users world wide.
  173.  
  174.      If you have questions about WAA or if you want to share your
  175.      experiences with other programmers, this is the right place to do it:
  176.  
  177.           news://news.alaska-software.com/alaska-software.news.waa
  178.  
  179.  _________________
  180.  3.  Miscellaneous
  181.  
  182.  3.1 Trademark and copyright
  183.  
  184.    * Alaska Xbase++, Alaska XbToolsIII, DMLB, XBP and WAA are registered
  185.      trademarks or trademarks of the Alaska Software.
  186.  
  187.    * OS/2 is a registered trademark of the International Business Machines
  188.      Corporation.
  189.  
  190.    * Windows NT, Windows 2000, Windows XP and Windows 95 / 98 / ME are 
  191.      registered trademarks or trademarks of the Microsoft Corporation.
  192.  
  193.  
  194.  
  195. WITH BEST REGARDS
  196. Your Xbase++ Team...
  197.