home *** CD-ROM | disk | FTP | other *** search
/ ftp.alaska-software.com / 2014.06.ftp.alaska-software.com.tar / ftp.alaska-software.com / waa / waa17w32.txt < prev    next >
Text File  |  2001-09-17  |  9KB  |  226 lines
  1. /*
  2.  * READW.ME of the Alaska Web Application Adaptor Version 1.7
  3.  * for Windows 2000, Windows NT and Windows 95/98/ME 
  4.  *
  5.  * International Edition
  6.  * 
  7.  * Date: August 21st, 2001
  8.  * 
  9.  */
  10.  
  11.  ________________
  12.  1.0 Installation
  13.  
  14.  
  15.  1.1 Procedure
  16.  
  17.      When you have downloaded the Web Application Adaptor (WAA) as 
  18.      a ZIP archive, unpack the archive in a temporary directory and start 
  19.      the SETUP program. 
  20.      If you have received WAA on CD-ROM, insert the CD in your CD-ROM 
  21.      drive and start the SETUP program from the WAA1W32 directory.
  22.       
  23.      Note for Xbase++ users: Select "Custom installation" (see 1.2 below)
  24.  
  25.      The WAA development kit is installed by default on drive C: with 
  26.      the following directory structure: 
  27.  
  28.      \ALASKA\WAA1W32 
  29.                 |---APACHE       Apache HTTP server  
  30.                 |      |---OS2     OS/2 version 
  31.                 |      |---W32     Windows 9x and Windows NT version 
  32.                 |
  33.                 |---BOOK         WAA documentation 
  34.                 |
  35.                 |---GATEWAY      Gateway between the HTTP server and WAA  
  36.                 |      |---OS2     OS/2 version  
  37.                 |      |---W32     Windows 95/98/ME and Windows NT/2000
  38.                 |      |           version 
  39.                 |      |---ISAPI   Gateway for MS Internet Information Server
  40.                 |      |---LINUX   Gateway for LINUX glibc2
  41.                 |
  42.                 |---SOURCE
  43.                 |      |---SAMPLES
  44.                 |            |---waa   Source code for example applications 
  45.                 |
  46.                 |---SERVER       Web Application Adaptor (WAA) 
  47.                                    (and Xbase++ runtime, when installed)
  48.  
  49.      When the installation program has finished, the file WAA1SRV.EXE 
  50.      is located in the ..\SERVER directory. This file is the WAA server 
  51.      and it needs a connection to your HTTP server. The connection is 
  52.      provided by a gateway which is available for OS/2, Windows and Linux 
  53.      platforms. How to install and configure the gateway depends on
  54.      the HTTP server you are using. 
  55.  
  56.      Please refer to the online documentation for further configuration 
  57.      steps.
  58.  
  59.  
  60.  1.2 You have Xbase++ installed
  61.  
  62.      Select "Custom Installation" and unselect the checkbox for the Xbase++
  63.      runtime libraries. It is not recommended to install the Xbase++ runtime 
  64.      environment twice. 
  65.  
  66.  
  67.  1.3 You do not have Xbase++ installed
  68.  
  69.      The setup program of the Alaska WAA does not change any environment
  70.      variable nor will any component of the system be replaced.
  71.      If you install the Xbase++ runtime files they will reside in the 
  72.      SERVER directory. The package contains only those Xbase++ runtime 
  73.      files needed by the WAA.
  74.  
  75.  
  76.  1.4 What's new in this version ?
  77.  
  78.      The method oHtml:getAllCgiVars() is introduced with this version of the WAA.
  79.      Besides the fact that all CGI variables can be queried with a single method
  80.      call, debugging a WAA package becomes easier now since developers are able
  81.      to investigate what has been sent from the http server to the WAA.
  82.  
  83.      Please refer to the chapter "Read me first" in the WAA online help
  84.      for a full explanation of changes in this version.
  85.      
  86.  1.5 WAA worker-threads 
  87.  
  88.      Each request to the WAA is initiated by a Web browser and sent to the
  89.      HTTP server. In turn, the HTTP server forwards browser requests via the
  90.      WAA gateway (WAA1GATE.EXE) to the WAA server (WAA1SRV.EXE). On startup,
  91.      the WAA initiates several worker-threads which actually receive a request
  92.      and return an answer via the gateway back to the HTTP server which in turn 
  93.      serves the Web browser.
  94.  
  95.      The recommended number of worker-threads depends on a variety of issues and
  96.      is hard to specify in general. As a rule of thumb, the following should be
  97.      considered:
  98.  
  99.      o The faster a request can be fulfilled, the lesser worker-threads are
  100.        required.
  101.  
  102.      o The higher the workload for a package request is, the more worker-threads
  103.        are needed to achieve a good response time.
  104.  
  105.      o The optimum amount of worker-threads is determined by the CPU capacity, not
  106.        by RAM capacity bec. a workerthread consumes approx. only 100K. The higher
  107.        the CPU capacity the more worker-threads can be serviced.
  108.  
  109.      IMPORTANT:
  110.      Since we have reworked the internal scheduler of the WAA job-queue/worker-thread
  111.      mechanism, we urge you to review your worker-thread configuration. Some users
  112.      have started 20 or more worker-threads to work around PDR 4351 (lost worker threads)
  113.      which is closed with this release. 
  114.  
  115.  1.6 Linux gateway
  116.  
  117.      The source code of the WAA gateways is available with the professional sub-
  118.      scription. Customers who have reported that they were not able to build the
  119.      waa1gate.exe for the Linux platform will find a reworked Unix version with
  120.      the 3rd Subscription delivery. The following shell command should initiate
  121.      the make process:
  122.  
  123.         make -f gate.mak
  124.  
  125.      IMPORTANT: Due to the nature of a Unix operating system (lightweight processes) 
  126.      our research has prooven the fact that a Linux gateway is up to 25 times
  127.      faster than the gateway on a Windows platform.
  128.  
  129.  1.7 Samples
  130.  
  131.      The samples are located in a subdirectory "WAA". To run the samples, it is
  132.      required to configure this directory as Document Root directory of the HTTP
  133.      server. For further details read the chapter "HTTP Server" in the online
  134.      documentation. It might also be necessary to edit the waa1gate.cfg accordingly.
  135.  
  136.  ____________________________
  137.  2.  Support and contact info
  138.  
  139.  2.1 Technical support
  140.  
  141.      Technical support is available for every registered user of 
  142.      Alaska Software products. If you are not a registered user
  143.      you can also make support requests but it may be handled at
  144.      a lower priority compared to others and thus a response will 
  145.      not be guaranteed by Alaska Software in this case.
  146.  
  147.      To get in contact with our Technical Support use one of the 
  148.      contacts listed in 2.2.
  149.  
  150.  
  151.  2.2 How to contact Alaska
  152.  
  153.      You can use one of the following possibilities:
  154.  
  155.      Customers in Europe, Middle East, Africa use:
  156.  
  157.           support@de.alaska-software.com
  158.  
  159.      FAX:               (+49) 6196 / 779 36-22
  160.      Phone:             (+49) 6196 / 779 36-0
  161.      Mail:              Alaska Software Technology AG
  162.                         Hauptstrasse 71-79
  163.                         65760 Eschborn
  164.                         Germany
  165.  
  166.      Customers in America, Asia, Pacific Rim, Australia use:
  167.  
  168.           support@us.alaska-software.com
  169.  
  170.      FAX:               (+1) 970-242-7557
  171.      Phone:             (+1) 970-242-1084
  172.      Mail:              Alaska Software, Inc.
  173.                         PBM 502
  174.                         569 32 Road, Ste. 7B
  175.                         Grand Junction, CO 81504
  176.                         U.S.A.
  177.  
  178.  
  179.  2.3  News groups
  180.  
  181.       The Alaska Software news server address is:
  182.  
  183.            news.alaska-software.com
  184.  
  185.       A variety of Xbase++ related news groups are hosted by Alaska
  186.       Software on this server and you are invited to visit our news
  187.       groups regularly. The news groups provide access to a tremendous
  188.       amount of technical know how and experience that is shared between
  189.       Xbase++ users world wide.
  190.  
  191.      If you have questions about WAA or if you want to share your
  192.      experiences with other programmers, this is the right place to do it:
  193.  
  194.           news://news.alaska-software.com/alaska-software.news.waa
  195.  
  196.  _________________
  197.  3.  Miscellaneous
  198.  
  199.  3.1 Trademark and copyright
  200.  
  201.    * Alaska Xbase++, Alaska XbToolsIII, DMLB, XBP and WAA are registered
  202.      trademarks or trademarks of the Alaska Software Technology AG.
  203.  
  204.    * OS/2 is a registered trademark of the International Business Machines
  205.      Corporation.
  206.  
  207.    * Windows NT, Windows 2000 and Windows 95 / 98 / ME are registered
  208.      trademarks or trademarks of the Microsoft Corporation.
  209.  
  210.  _______________
  211.  6.  Closed Pdrs
  212.  
  213.      PDR-ID    Symptom
  214.      -----------------
  215.      109-4265  WAA does not set cookie                                     
  216.      109-4312  oHtml:setCookie() fails with IP domain name in 5th param    
  217.      109-4351  WAA looses Worker-threads when continuously submitting forms  
  218.      109-4530  WAA does not decode cgi strings passed with POST method
  219.  
  220.  
  221.  
  222.  
  223. WITH BEST REGARDS
  224. Your Xbase++ Team...
  225.  
  226.