home *** CD-ROM | disk | FTP | other *** search
/ Programming with VisualAge for Java / IBMVJAVA.ISO / icswinnt / httpdw32.z / read.me < prev    next >
Text File  |  1997-03-18  |  9KB  |  185 lines
  1. ########################################################################
  2. # (C) COPYRIGHT International Business Machines Corp. 1996, 1997       #
  3. # All Rights Reserved                                                  # 
  4. # Licensed Materials - Property of IBM                                 #
  5. #                                                                      #
  6. # US Government Users Restricted Rights - Use, duplication or          #
  7. # disclosure restricted by GSA ADP Schedule Contract with IBM Corp.    #
  8. ########################################################################
  9.  
  10. Welcome to the IBM Internet Connection Secure Server V4R2 for Windows NT.
  11.  
  12. This README file contains late-breaking information about installing
  13. and using your IBM Internet Connection Secure Server.  This information
  14. corrects and supplements the information in the IBM Internet Connection Secure
  15. Server's Quick Beginnings book and Webmaster's Guide.
  16.  
  17. For answers to frequently asked questions about the Internet Connection
  18. Secure Server, go to our Internet Connection Family Web Site at
  19. http://www.ics.raleigh.ibm.com and read our FAQ.
  20.  
  21. LATE-BREAKING INFORMATION...
  22.  
  23. o The Request Label Entries from Third-Party Rating Service form is not
  24.    currently available, but should be ready by mid-March.
  25.  
  26. o Some Web browsers may display either a blank page or the pop-up "Document
  27.    contains no data" on some long HTTP requests.  Such a request might be
  28.    S-HTTP or a large form post.  The client closes the socket before the
  29.    entire request can be received by the Web server.  Re-submitting the
  30.    form or request often solves the problem.
  31.    
  32. o The server currently does not allow the use of blank characters within a
  33.    file name specified in the configuration file.  Blank spaces are treated
  34.    as delimiters.
  35.  
  36. o Starting a PICS rating service and label bureau
  37.                                                                    
  38.    When configuring your server as a PICS rating service,
  39.    add the Service directive to the configuration file
  40.    to inform the server that you are a PICS service
  41.    and specify where to direct the PICS rating label requests.
  42.    To add the Service directive, use the Request Routing form
  43.    in the Configuration and Administration forms.
  44.                                                                    
  45.    NOTE: It is advisable to use the Configuration and Administration
  46.    form, Request Routing, to ensure correct placement of the Service
  47.    directive in the configuration file.  Conversely, if you insert the Service
  48.    directive manually, place it with the default Service directives already
  49.    in the configuration file.
  50.  
  51.    For example:
  52.                                                                    
  53.       Service /Ratings INTERNAL:PICS-Ratings
  54.                                                                    
  55.    Replace /Ratings with the path and file name portion of the
  56.    URL you will use for label requests.  For example, if you publish
  57.    the URL http://www.coolratings.com/CoolSite, you would
  58.    include only /CoolSite in the Service directive.
  59.  
  60. o If you plan to use servlet support, be aware that the current version of the
  61.    Java Servlet API does not provide any method in its ServletResponse interface
  62.    to write response header information.  We have added the writeHeaders()
  63.    method to the Java.servlet.ServletResponse interface to provide this support.
  64.  
  65.       NOTE:  WebExplorer does not support Java.
  66.  
  67.  
  68. o  When you use the certutil command, you might see messages similar to the messages listed
  69.    here.  Please ignore the messages; they are issued by the Windows NT operating system and
  70.    do not affect the certutil function.
  71.  
  72.       D:\WWW\Bin>certutil -k cakeyfile.kyr < certreq.txt > cert.txt
  73.       The handle could not be opened
  74.       during redirection of handle 1.
  75.       The handle could not be opened
  76.       during redirection of handle 1.
  77.       Key File Password: ********
  78.   
  79. o  To prevent the entire screen going black and flashing before a pop-up
  80.    window is displayed, set the default MS-DOS mode for the Display Options
  81.    for Console Windows to "Window" rather than "Full Screen".  Use the "Console"
  82.    control panel to set the Display Options for Console Windows to "Window".
  83.  
  84. o  Revisions to example URLS in the chapter "Customizing your Web site"
  85.  
  86.  - The example URLs for list item 3 of the "Configuration instructions" section
  87.    should not include your server name.
  88.  
  89.    3. Insert lines in the Web page HTML file for the functions
  90.       you are using.
  91.  
  92.       Page count:
  93.       <img src="/cgi-bin/apicounter/counter_name?&[common_options] [counter_option]">
  94.  
  95.       Date and time:
  96.       <img src="/cgi-bin/datetime?[common_options] [date_and_time_option]">
  97.  
  98.       Text:
  99.       <img src="/cgi-bin/text2gif?[common_options] [text_to_gif_option]">
  100.  
  101.  
  102.  - At the beginning of the "Options" section, the URL examples in note 3 
  103.    (using an ampersand to separate options) and note 4 (RRGGBB color options) 
  104.    should not include your server name.
  105.  
  106.    Note 3.
  107.    For example, to display a page counter with a foreground color
  108.    of blue and a background color of white, use the following URL:
  109.  
  110.     <img src="/cgi-bin/apicounter/counter_name?FG=blue&BG=white">
  111.  
  112.    Note 4.
  113.    For example, to display a page counter with a foreground color
  114.    of blue and a background color of white, use the following URL:
  115.  
  116.     <img src="/cgi-bin/apicounter/counter_name?FG=FFFF00">
  117.  
  118.  - For the Text to gif option, the example URLs should not include
  119.    your server name.  The following URLs show an example
  120.    of how you can display text and page count on a web page:
  121.  
  122.    <img src="/cgi-bin/text2gif?BG=white&Text=This%20Web%20page%20has%20been%20accessed%20">
  123.    <img src="/cgi-bin/apicounter/counter_name?FG=red&BG=white">
  124.    <img src="/cgi-bin/text2gif?BG=white&Text=%20times%20since%20January%201,%201997.">
  125.  
  126.  
  127. o The new version of reporting is not able to handle very large logfiles in the browser.
  128.  
  129.   Your server might not be able to create a report for a very large access log file 
  130.   (60 MB, for example).  If your system encounters a problem while trying to generate a report,
  131.   the cause might be an access log that is too large.  To generate reports against very large 
  132.   access log files, try increasing the RAM and (or) the swapper file space on your system.
  133.   A short-term solution to this problem is to turn off report generation by renaming 
  134.   the htlogrep executable file.
  135.  
  136. o The previous version of htlogrep is available for those who need the old functionality.  
  137.   If you need to use the previous version of htlogrep, please see the Internet Connection 
  138.   Family Web Site at http://www.icw.raleigh.ibm.com for additional information.
  139.  
  140. o  Byte count variations when monitoring server performance and status
  141.  
  142.    The bytes sent and bytes received counts on the Internet
  143.    Connection Server Activity Monitor are different than those
  144.    on the Windows NT Performance Monitor. The Server Activity Monitor
  145.    displays bytes sent and bytes received counts for content only.
  146.    The Windows NT Performance Monitor displays bytes sent and bytes
  147.    received counts for content and header data.
  148.  
  149.                                                                   
  150. SOFTWARE REQUIREMENTS...
  151.  
  152. For Windows NT, you need:
  153. ---------------------------
  154. o Microsoft Windows NT or NT-J Server or Client (Workstation) 3.51
  155.    with TCP/IP configured
  156.  
  157. o A partition formatted using the NT File System (NTFS), the
  158.    High Performance File System (HPFS), or the File Allocation Table (FAT).
  159.    We recommend that you use NTFS for better file protection.
  160.                                                     
  161. o For SNMP support, install the SystemView Agent Developers
  162.    toolkit which can be downloaded from the
  163.       http://www.software.ibm.com/download/ URL.
  164.  
  165. o To compile and run Java servlets, you will need the
  166.    Java Developers' Kit (JDK), Version 1.0.2.  You can download 
  167.    JDK from the IBM software download library at URL:
  168.  
  169.       http://www.software.ibm.com/download
  170.  
  171.    We will provide our own version of the Java servlet classes in the 
  172.    icsclass.zip file.
  173.  
  174.    NOTE:  To use Java servlet support, the CLASSPATH environment variable
  175.              must be set as follows before you install the server
  176.       
  177.              CLASSPATH=C:\java_home_directory\lib\classes.zip                                                 
  178.                                 
  179.              When you install the server, the installation program will
  180.              automatically add the icsclass.zip file to your CLASSPATH
  181.              environment variable.
  182.  
  183.  
  184.  
  185.