home *** CD-ROM | disk | FTP | other *** search
/ OS/2 Shareware BBS: 35 Internet / 35-Internet.zip / webtraps.zip / ibmproxy.conf2 < prev    next >
Text File  |  2001-04-18  |  111KB  |  2,977 lines

  1. # (C) COPYRIGHT International Business Machines Corp. 1997, 2000
  2. # All Rights Reserved
  3. # Licensed Materials - Property of IBM
  4. #
  5. # US Government Users Restricted Rights - Use, duplication or
  6. # disclosure restricted by GSA ADP Schedule Contract with IBM Corp.
  7. #
  8. # ===================================================================== #
  9. #
  10. #        This is the default configuration file for the
  11. #        IBM WebSphere Performance Pack Web Traffic Express
  12. #        proxy server.
  13. #
  14. #        TABLE OF CONTENTS
  15. #        =================
  16. #        - Basic directives
  17. #        - Process control
  18. #        - Logging directives
  19. #          * log file directives
  20. #          * log archive directives
  21. #          * log filtering directives
  22. #        - Method directives
  23. #        - Content presentation directives
  24. #          * Welcome pages directives
  25. #          * Directory browsing directives
  26. #          * CGI program directives
  27. #          * Content type directives
  28. #        - Error Message directives
  29. #        - API directives
  30. #        - User authentication and document protection
  31. #        - Mapping rules
  32. #        - Performance directives
  33. #        - Timeout directives
  34. #        - Proxy directives
  35. #        - Proxy caching directives
  36. #        - Proxy cache garbage collection directives
  37. #        - Advanced proxy and caching directives
  38. #        - Remote Cache Access (RCA) directives
  39. #        - SNMP directives
  40. #        - Icon directives
  41. #        - Cache agent directives
  42. #        - PICS Filtering directives
  43. #        - Miscellaneous directives
  44. #
  45. # ===================================================================== #
  46.  
  47.  
  48.  
  49. # ===================================================================== #
  50. #
  51. #        Basic directives
  52. #
  53. # ===================================================================== #
  54.  
  55.  
  56. #        ServerRoot directive:
  57. #
  58. #        Set this to point to the directory where you unpacked this
  59. #        distribution, or wherever you want ibmproxy to have its "home".
  60. #
  61. #        Default:  opt/IBMWTE/usr/internet/server_root
  62. #        Syntax:   ServerRoot    <path>
  63. ServerRoot /opt/IBMWTE/usr/internet/server_root 
  64. #     This ServerRoot entry usually points to where the WTE install
  65. #     is, you sure can change it, at least to get a WTE log file 
  66. #     in a different location
  67.  
  68. #        Hostname directive:
  69. #
  70. #        Specify the fully-qualified hostname, including the domain.  You can
  71. #        use an alias (if you have one set up) instead of the machine's real
  72. #        host name so that clients will not be able to see the real host name.
  73. #
  74. #        Default:  <host name default defined in DNS>
  75. #        Syntax:   Hostname   <fully-qualified host name>
  76. #
  77.  
  78.  
  79. #        BindSpecific directive:
  80. #
  81. #        Allows a multi-homed system to run a different server on
  82. #        each IP address.
  83. #
  84. #        Default:  off
  85. #        Syntax:   BindSpecific <on | off>
  86. BindSpecific  off
  87.  
  88.  
  89. #        Port directive:
  90. #
  91. #        Port used by the server.
  92. #        NOTE: If the server is not started by root, you have to use a port
  93. #              above 1024; good choices are 8000, 8001, 8080.
  94. #
  95. #        Default:  80
  96. #        Syntax:   Port <num>
  97. Port 8081
  98. #     Multiple ports are possible
  99.  
  100. #        AdminPort directive:
  101. #
  102. #        This port may be used by the administrator for access to the
  103. #        server status pages or configuration forms. Requests to this
  104. #        port will not be queued with all other incoming requests on the
  105. #        standard port(s) defined with the Port directive. However, they
  106. #        will go through the normal access control and request-mapping
  107. #        rules (Pass, Exec, Protect, etc).
  108. #
  109. #        The administration port must not be the same as the standard
  110. #        port(s) defined with the Port directive.
  111. #
  112. #        Default:  none
  113. #        Syntax:   AdminPort <num>
  114. AdminPort 8007
  115.  
  116.  
  117. # ===================================================================== #
  118. #
  119. #        Process control directives
  120. #
  121. # ===================================================================== #
  122.  
  123. #        UserId directive:
  124. #
  125. #        Specify the user name/number to which the server changes
  126. #        before accessing files, if the server was started as root.
  127. #
  128. #        Default:  nobody
  129. #        Syntax:   UserId <user name/number>
  130. #
  131. UserID     wesadmin    
  132.  
  133. #        GroupId directive:
  134. #
  135. #        Specify the group name/number the server changes to
  136. #        before accessing files, if the server was started as root.
  137. #
  138. #        Default:  nobody
  139. #        Syntax:   GroupId <group name/number>
  140. GroupId  wesadmin
  141.  
  142. #     Both UserID and GroupId will be the values you enter during
  143. #     WES install
  144.  
  145. #        NoBG directive:
  146. #
  147. #        Normally, when the server is started, the process forks to go
  148. #        into the background, and the first process exits. If you turn on
  149. #        NoBG, the main process will not go to the background. If you're
  150. #        using init to start the server, it may be useful to set this
  151. #        to ON (and then init can respawn the server if it fails).
  152. #
  153. #        Note that this directive will be ignored if the server is started
  154. #        through SRC.
  155. #
  156. #        Default:  off
  157. #        Syntax:   NoBG <on | off>
  158. NoBG off
  159.  
  160. #        PidFile directive:
  161. #
  162. #        When the server process starts, it will record its process id
  163. #        ("pid") in a file, for use by the "ibmproxy -restart" command. This
  164. #        directive specifies the location for that file. If you are
  165. #        running multiple instances of the server on a single system, each
  166. #        should have its own PidFile.
  167. #
  168. #        Default:  <server-root>/ibmproxy-pid
  169. #                  If no ServerRoot directive is given, then the default for
  170. #                  the PidFile is /tmp/ibmproxy-pid
  171. #        Syntax:   PidFile <path-to-pid-file-into>
  172.  
  173.  
  174. # ===================================================================== #
  175. #
  176. #        Logging directives
  177. #
  178. # ===================================================================== #
  179.  
  180.  
  181. #   ==============================
  182. #   *** log file directives ***
  183. #   ==============================
  184.  
  185.  
  186. #        If you want logging, specify locations for your logs:
  187. #
  188. #           AccessLog      - used for logging local document requests
  189. #           ProxyAccessLog - used for logging proxy requests
  190. #           CacheAccessLog - used for logging hits on proxy cache
  191. #           ErrorLog       - used for logging any errors
  192. #           EventLog       - used for logging initialization events 
  193. #
  194. #        NOTE: To enable logging of requests to the proxy cache, the
  195. #              following must be defined:
  196. #
  197. #              Caching MUST be turned ON (default is OFF)
  198. #              CacheAccessLog MUST be defined
  199. #
  200. #        Defaults:  AccessLog       /opt/IBMWTE/usr/internet/server_root/logs/local
  201. #                   ProxyAccessLog  /opt/IBMWTE/usr/internet/server_root/logs/proxy
  202. #                   CacheAccessLog  /opt/IBMWTE/usr/internet/server_root/logs/cache
  203. #                   ErrorLog        /opt/IBMWTE/usr/internet/server_root/logs/error
  204. #                   EventLog        /opt/IBMWTE/usr/internet/server_root/logs/event
  205. #        Syntax:    <directive> <fullpath-filename>
  206.  
  207. AccessLog        /opt/IBMWTE/usr/internet/server_root/logs/ap_local
  208. ProxyAccessLog   /opt/IBMWTE/usr/internet/server_root/logs/ap_proxy
  209. CacheAccessLog   /opt/IBMWTE/usr/internet/server_root/logs/ap_cache
  210. ErrorLog         /opt/IBMWTE/usr/internet/server_root/logs/ap_error
  211. EventLog         /opt/IBMWTE/usr/internet/server_root/logs/ap_event
  212. TraceLog     /opt/IBMWTE/usr/internet/server_root/logs/ap_tracelog
  213.  
  214. #    LogFileFormat:
  215. #
  216. #    Specify the format of the access log files.  
  217. #    By default, logs are displayed in the NCSA Common Log Format.
  218. #    Specify "combined" to get the NCSA Combined Log Format instead.
  219. #    Entries in the combined format are the same as those in the
  220. #    common format with the addition of fields for the referring URL, 
  221. #    User Agent, and Cookie (if present in the request).  Certain site 
  222. #    analysis tools, such as IBM's Site Analyzer, require proxy logs 
  223. #    to be in Combined format.
  224. #
  225. #    Default: common
  226. #    Syntax LogFileFormat <common | combined>
  227. #
  228. # LogFileFormat common
  229.  
  230. #        LogToSyslog directive:
  231. #
  232. #        In addition to logging access request information to the server logs,
  233. #        you can send log entries to the UNIX syslog daemon.
  234. #
  235. #        Default:  off
  236. #        Syntax:   LogToSyslog <on | off>
  237. #
  238. #        NOTE: Please reference online documentation/help for a more extensive
  239. #              explanation of how to use this function.
  240. #
  241. LogToSyslog off
  242.  
  243.  
  244. #        NoLog directive:
  245. #
  246. #        Suppress access log entries for host matching a given IP address
  247. #        or hostname. Wild cards "*" may be used. This directive may be used
  248. #        multiple times within the configuration file.
  249. #
  250. #        Default:  <none>
  251. #        Syntax:   NoLog  <hostnames and IP addresses>
  252. #
  253. #        NOTE: DNS-Lookup may need to be turned ON.
  254. #
  255. # Example:
  256. # NoLog    128.141.*.*
  257. # NoLog    *.location.company.com
  258. # Nolog    *.*.*.com
  259.  
  260.  
  261. #   ==============================
  262. #   *** log archive directives ***
  263. #   ==============================
  264.  
  265.  
  266. # LogArchive directive
  267. #
  268. #        Specify the type of archive processing to use.
  269. #
  270. #        Default:  Purge
  271. #        Syntax:   LogArchive <Compress | Purge | none>
  272. #
  273. LogArchive Purge
  274.  
  275.  
  276. # Compress directives
  277. #
  278. #        If you specified "Compress" for LogArchive, specify:
  279. #          - the age at which the log files should be compressed
  280. #          - the age at which the log files should be deleted
  281. #          - the compress command you want executed against the
  282. #            log archive files
  283. #
  284. #        Default:  0
  285. #        Syntax:   CompressAge <num>
  286. #        Syntax:   CompressDeleteAge <num>
  287. #
  288. #        Default:  <none>
  289. #        Syntax:   CompressCommand <commpress-command>
  290. #
  291. CompressAge       1
  292. CompressDeleteAge 7
  293. # CompressCommand tar -cf /logarchs/log%%DATE%%.tar %%LOGFILES%% ; gzip /logarchs/log%%DATE%%.tar
  294. # CompressCommand tar -cf /logarchs/log%%DATE%%.tar %%LOGFILES%% ; compress /logarchs/log%%DATE%%.tar
  295. # CompressCommand zip -q /logarchs/log%%DATE%%.tar %%LOGFILES%%
  296.  
  297.  
  298. # Purge directives
  299. #
  300. #        If you specified "Purge" for LogArchive,
  301. #        specify the age and size(in Megabytes) limits
  302. #        at which time the files should be purged.
  303. #
  304. #        Syntax:   PurgeAge <num>
  305. #        Default:  PurgeAge 7
  306. #        Syntax:   PurgeSize <num>
  307. #        Default:  PurgeSize 0
  308. #
  309. PurgeAge   7
  310. PurgeSize  0
  311.  
  312.  
  313. #   ====================================
  314. #   *** log filtering directives ***
  315. #   ====================================
  316.  
  317.  
  318. # AccessLogExcludeUserAgent directive
  319. #
  320. # A filter to exclude request URLs from user-agents that match a
  321. # given template.
  322. #
  323. #        Default: Requests from Network Dispatcher's HTTP and WTE advisors
  324. #                 will not be logged
  325. #        Syntax:  AccessLogExcludeUserAgent <User-Agent template>
  326. #
  327. AccessLogExcludeUserAgent IBM_Network_Dispatcher_HTTP_Advisor
  328. AccessLogExcludeUserAgent IBM_Network_Dispatcher_WTE_Advisor
  329.  
  330. #        AccessLogExcludeURL, AccessLogExcludeMethod,
  331. #        AccessLogExcludeReturnCode and AccessLogExcludeMimeType directive:
  332. #
  333. #        Access log entries may be filtered to exclude requests by:
  334. #           * requests matching a given URL template
  335. #           * requests of a given method
  336. #           * requests with a given return code range (200s, 300s, 400s, 500s)
  337. #           * requests for files of a given mime type
  338. #
  339. #        Default:  <none>
  340. #        Syntax:   AccessLogExcludeURL    <URL template>
  341. #                  AccessLogExcludeMethod <GET | PUT | POST | DELETE>
  342. #                  AccessLogExcludeReturnCode <200 | 300 | 400 | 500>
  343. #                  AccessLogExcludeMimeType <text/html | text/plain |
  344. #                                            text/other | image/gif  |
  345. #                                            image/jpeg | image/(other) |
  346. #                                            application/* |
  347. #                                            audio/* | video/* |
  348. #                                            (other)/(other)>
  349. #
  350. # Example:
  351. # AccessLogExcludeURL  *.gif
  352. # AccessLogExcludeURL  /Freebies/*
  353. # AccessLogExcludeMethod PUT
  354. # AccessLogExcludeMethod POST
  355. # AccessLogExcludeReturnCode 300
  356. # AccessLogExcludeReturnCode 400
  357. # AccessLogExcludeMimeType text/html
  358. # AccessLogExcludeMimeType text/plain
  359.  
  360.  
  361. # ===================================================================== #
  362. #
  363. #        Method directives
  364. #
  365. # ===================================================================== #
  366. #
  367. #        HTTP Methods that you do or don't want your server to accept.
  368. #
  369. #        NOTE: Please reference online documentation/help to specify or
  370. #              create other methods.
  371. #
  372. #        Default:  Enable     GET
  373. #                  Enable     HEAD
  374. #                  Enable     POST
  375. #                  Enable     TRACE
  376. #                  Enable     OPTIONS
  377. #                  Enable     CONNECT
  378. #                  Disable    PUT
  379. #                  Disable    DELETE
  380. #        Syntax:   Enable  <method>
  381. #                  Disable <method>
  382. #
  383. Enable     GET
  384. Enable     HEAD
  385. Enable     POST
  386. Enable     TRACE
  387. Enable     OPTIONS
  388. Enable     CONNECT
  389.  
  390. Disable    PUT
  391. Disable    DELETE
  392.  
  393.  
  394. # ===================================================================== #
  395. #
  396. #        Content presentation directives
  397. #
  398. # ===================================================================== #
  399.  
  400.  
  401. #   ==============================
  402. #   *** Welcome pages ***
  403. #   ==============================
  404.  
  405. #        Welcome directive:
  406. #
  407. #        Specifies the default file name to use when only a directory name is
  408. #        specified in the URL. Many Welcome directives may be defined, with the
  409. #        one defined earliest having precedence.
  410. #
  411. #        Multi-homed servers can use the IP-address_template parameter to
  412. #        specify an address template which restricts the server to displaying
  413. #        a specific welcome page based on which address template matches.
  414. #
  415. #        NOTE: the address of the servers network connection is compared
  416. #              to the template, not the address of the requesting client.
  417. #
  418. #        Defaults:  Welcome.html, welcome.html, index.html, Frntpage.html
  419. #        Syntax:    Welcome file-name [IP-address-template]
  420. #
  421. # Example:
  422. # Welcome letsgo.html
  423. # Welcome CustomerA.html  9.67.106.79
  424. Welcome     Welcome.html
  425. Welcome     welcome.html
  426. Welcome     index.html
  427. Welcome     Frntpage.html
  428.  
  429.  
  430. #   =====================================
  431. #   *** Directory browsing directives ***
  432. #   =====================================
  433.  
  434. #        These directives control directory listings as follows:
  435. #          * Enable/disable or selective directory browsing
  436. #          * Configure/disable readme feature for directory browsing
  437. #          * Control the appearance of the directory listing
  438. #          * Define the maximum width of the description text
  439. #          * Define the maximum & minimum width of the filename field
  440. #
  441. #        Default:  DirShowIcons        on
  442. #                  DirShowDate         on
  443. #                  DirShowSize         on
  444. #                  DirShowDescription  on
  445. #                  DirShowCase         on
  446. #                  DirShowHidden       on
  447. #                  DirShowBytes        off
  448. #        Syntax:   <directive> <on | off>
  449. #
  450. #        Default:  DirShowMaxDescrLength 25
  451. #                  DirShowMaxLength      25
  452. #                  DirShowMinLength      15
  453. #        Syntax:   <directive> <num>
  454. DirShowIcons           on
  455. DirShowDate            on
  456. DirShowSize            on
  457. DirShowDescription     on
  458. DirShowCase            on
  459. DirShowHidden          on
  460. DirShowBytes           off
  461. DirShowMaxDescrLength  25
  462. DirShowMaxLength       25
  463. DirShowMinLength       15
  464.  
  465.  
  466. #        FTPDirInfo directive:
  467. #
  468. #        FTP servers may generate a welcome or description message for
  469. #        a directory. This can optionally be displayed as part of FTP
  470. #        directory listings; in addition, you can control where it will
  471. #        be displayed. The following options are available:
  472. #
  473. #        FTPDirInfo top -    display welcome message at the top of the page,
  474. #                            before the listing of files in the directory.
  475. #        FTPDirInfo bottom - display welcome message at the bottom of the page,
  476. #                            after the listing of files in the directory.
  477. #        FTPDirInfo off    - do not display the welcome message from the
  478. #                            FTP server.
  479. #
  480. #        Note that this directive gives no control over the content of the
  481. #        message itself; that message will be generated by the FTP server
  482. #        being contacted.
  483. #
  484. #        Default:   FTPDirInfo top
  485. #        Syntax:    FTPDirInfo <top | bottom | off>
  486. #
  487. # Example: don't display welcome messages from FTP servers
  488. # FTPDirInfo off
  489. FTPDirInfo top
  490.  
  491.  
  492. #        DirBackgroundImage
  493. #
  494. #        This directive allows applying a background image to directory
  495. #        listings generated by the proxy. Directory listings are generated
  496. #        when browsing FTP sites through the proxy.
  497. #
  498. #        The background image should be given as an absolute path. If the
  499. #        image is located at another server, the background image must
  500. #        be specified as a full URL.
  501. #
  502. #        If no background image is specified, a plain white background will
  503. #        be used.
  504. #
  505. #        Default:   no background image specified
  506. #        Syntax:    DirBackgroundImage /some/image.jpg
  507. #
  508. # Example: use /images/corplogo.png as background graphic
  509. # DirBackgroundImage /images/corplogo.png
  510. #
  511. # Example: use /graphics/embossed.gif on Web server www.somehost.com as
  512. # background graphic
  513. # DirBackgroundImage http://www.somehost.com/graphics/embossed.gif
  514.  
  515.  
  516. #   =====================================
  517. #   *** CGI program directives ***
  518. #   =====================================
  519.  
  520. #        InheritEnv and DisInheritEnv directives:
  521. #
  522. #        InheritEnv    - Specify which environment variables are
  523. #                        inherited by CGI programs.
  524. #
  525. #        DisInheritEnv - Specify which environment variables are
  526. #                        disinherited by CGI programs.
  527. #
  528. #        By default, all environment variables are inherited by
  529. #        CGI programs. If you include any InheritEnv directive,
  530. #        only those environment variables specified on InheritEnv
  531. #        directives will be inherited. You can exclude individual
  532. #        environment variables from being inherited with the
  533. #        DisInheritEnv directive.
  534. #
  535. #        NOTE: Refer to the Web Programming Guide for a list
  536. #              of the CGI-specific environment variables.
  537. #
  538. #        Default:  <none>
  539. #        Syntax:   InheritEnv    <variable>
  540. #        Syntax:   DisInheritEnv <variable>
  541. # Example:
  542. # InheritEnv PATH
  543. # InheritEnv LANG=ENUS
  544. # DisInheritEnv PATH
  545. # DisInheritEnv LANG
  546.  
  547.  
  548. #   =====================================
  549. #   *** Content type directives ***
  550. #   =====================================
  551.  
  552. #        imbeds directive:
  553. #
  554. #        Controls Server Side Include processing for output that has
  555. #        Content-type: text/x-ssi-html.
  556. #
  557. #        NOTE: Please reference online documentation/help for a more extensive
  558. #              explanation of how to use this function.
  559. #
  560. #        Default:  off SSIOnly
  561. #        Syntax:   imbeds <on/off/files/cgi/noexec> <html/SSIOnly>
  562. #                  parm1: on         process files, CGIs and SSI #exec CGI
  563. #                         off        never use SSI
  564. #                         files      process files and SSI #exec CGI
  565. #                         cgi        process CGIs  and SSI #exec CGI
  566. #                         noexec     process files, CGIs but not SSI #exec CGI
  567. #
  568. #                  parm2: html       also process Content-type: text/html
  569. #                         SSIOnly    process Content-type: text/x-ssi-html only
  570. #
  571. #
  572. imbeds on SSIOnly
  573.  
  574.  
  575. #        SuffixCaseSense directive:
  576. #
  577. #        Specify whether case sensitivity for suffixes is on or off.
  578. #
  579. #        Default:  off
  580. #        Syntax:   SuffixCaseSense  <on | off>
  581. #
  582. #        NOTE: This directive should be BEFORE any AddType or AddEncoding
  583. #              directives.
  584. #
  585. SuffixCaseSense   off
  586.  
  587. #        AcceptAnything directive:
  588. #
  589. #        If this is set to ON, documents will be served to the client even
  590. #        if the MIME type of the document does not match an Accept:
  591. #        header sent by the client. If this is OFF, documents with a MIME type
  592. #        which the client doesn't not state that they understand will cause
  593. #        the client to see an error page instead.
  594. #
  595. #        Default:  ON
  596. #        Syntax:   AcceptAnything <on | off>
  597. #
  598. #
  599. AcceptAnything     on
  600.  
  601.  
  602. #        Map suffixes to the content-type of a file.
  603. #
  604. #        Defaults:  see list below
  605. #        Syntax:    Addtype <.suffix><representation><encoding><quality>
  606. #                      where <quality> is optional
  607. #
  608.  
  609. # Application-specific types
  610. AddType  .bcpio    application/x-bcpio               binary  1.0 # Old binary CPIO
  611. AddType  .cpio     application/x-cpio                binary  1.0 # POSIX CPIO
  612. AddType  .gtar     application/x-gtar                binary  1.0 # Gnu tar
  613. AddType  .bin      application/octet-stream          binary  1.0 # Uninterpreted binary
  614. AddType  .class    application/octet-stream          binary  1.0 # Java applet or application
  615. AddType  .dms      application/octet-stream          binary  1.0 #
  616. AddType  .exe      application/octet-stream          binary  0.8 # MSDOS/OS2/WIN executables
  617. AddType  .dll      application/octet-stream          binary  0.8 # OS2/WIN executables
  618. AddType  .lha      application/octet-stream          binary  0.8 # LHArc
  619. AddType  .lzh      application/octet-stream          binary  0.8 # Compressed data
  620. AddType  .oda      application/oda                   binary  1.0
  621. AddType  .pdf      application/pdf                   binary  1.0
  622. AddType  .ai       application/postscript            8bit    0.5 # Adobe Illustrator
  623. AddType  .PS       application/postscript            8bit    0.8 # PostScript
  624. AddType  .eps      application/postscript            8bit    0.8
  625. AddType  .ps       application/postscript            8bit    0.8
  626. AddType  .rtf      application/rtf                   7bit    1.0 # RTF
  627. AddType  .sit      application/stuffit               binary  1.0 # Mac StuffIt compressor
  628. AddType  .csh      application/x-csh                 7bit    0.5 # C-shell script
  629. AddType  .dvi      application/x-dvi                 binary  1.0 # TeX DVI
  630. AddType  .hdf      application/x-hdf                 binary  1.0 # NCSA HDF data file
  631. AddType  .latex    application/x-latex               8bit    1.0 # LaTeX source
  632. AddType  .nc       application/x-netcdf              binary  1.0 # Unidata netCDF data
  633. AddType  .cdf      application/x-netcdf              binary  1.0
  634. AddType  .js       application/x-javascript          binary  1.0 # Java script
  635. AddType  .sh       application/x-sh                  7bit    0.5 # Shell-script
  636. AddType  .shar     application/x-shar                8bit    1.0 # Shell archive
  637. AddType  .sv4cpio  application/x-sv4cpio             binary  1.0 # SVR4 CPIO
  638. AddType  .sv4crc   application/x-sv4crc              binary  1.0 # SVR4 CPIO with CRC
  639. AddType  .tcl      application/x-tcl                 7bit    0.5 # TCL-script
  640. AddType  .tex      application/x-tex                 8bit    1.0 # TeX source
  641. AddType  .texi     application/x-texinfo             7bit    1.0 # Texinfo
  642. AddType  .texinfo  application/x-texinfo             7bit    1.0
  643. AddType  .t        application/x-troff               7bit    0.5 # Troff
  644. AddType  .roff     application/x-troff               7bit    0.5
  645. AddType  .tr       application/x-troff               7bit    0.5
  646. AddType  .man      application/x-troff-man           7bit    0.5 # Troff with man macros
  647. AddType  .me       application/x-troff-me            7bit    0.5 # Troff with me macros
  648. AddType  .ms       application/x-troff-ms            7bit    0.5 # Troff with ms macros
  649. AddType  .src      application/x-wais-source         7bit    1.0 # WAIS source
  650. AddType  .prs      application/x-freelance           binary  1.0 # Lotus Freelance
  651. AddType  .pre      application/vnd.lotus-freelance   binary  1.0 # Lotus Freelance
  652. AddType  .prz      application/vnd.lotus-freelance   binary  1.0 # Lotus Freelance
  653. AddType  .lwp      application/vnd.lotus-wordpro     binary  1.0 # Lotus Word Pro
  654. AddType  .sam      application/vnd.lotus-wordpro     binary  1.0 # Lotus Word Pro
  655. AddType  .apr      application/vnd.lotus-approach    binary  1.0 # Lotus Approach
  656. AddType  .vew      application/vnd.lotus-approach    binary  1.0 # Lotus Approach
  657. AddType  .123      application/vnd.lotus-1-2-3       binary  1.0 # Lotus 1-2-3
  658. AddType  .wk1      application/vnd.lotus-1-2-3       binary  1.0 # Lotus 1-2-3
  659. AddType  .wk3      application/vnd.lotus-1-2-3       binary  1.0 # Lotus 1-2-3
  660. AddType  .wk4      application/vnd.lotus-1-2-3       binary  1.0 # Lotus 1-2-3
  661. AddType  .org      application/vnd.lotus-organizer   binary  1.0 # Lotus Organizer
  662. AddType  .or2      application/vnd.lotus-organizer   binary  1.0 # Lotus Organizer
  663. AddType  .or3      application/vnd.lotus-organizer   binary  1.0 # Lotus Organizer
  664. AddType  .scm      application/vnd.lotus-screencam   binary  1.0 # Lotus Screencam
  665. AddType  .ppt      application/vnd.microsoft-powerpoint binary 1.0 # MS PowerPoint
  666. AddType  .pac      application/x-ns-proxy-autoconfig binary  1.0 # Netscape proxy Autoconfig files
  667. AddType  .hqx      application/mac-binhex40          binary  1.0 # Macintosh BinHex format
  668. AddType  .bsh      application/x-sh                  7bit    0.5 # Bourne shell script
  669. AddType  .ksh      application/x-ksh                 7bit    0.5 # K-shell script
  670. AddType  .pcl      application/x-pcl                 7bit    0.5 #
  671. AddType  .wk1      application/x-123                 binary  1.0 #
  672.  
  673. # Audio files
  674. AddType  .snd      audio/basic                       binary  1.0 # Audio
  675. AddType  .au       audio/basic                       binary  1.0
  676. AddType  .mid      audio/midi                        binary  1.0
  677. AddType  .midi     audio/midi                        binary  1.0
  678. AddType  .kar      audio/midi                        binary  1.0
  679. AddType  .mpga     audio/mpeg                        binary  1.0
  680. AddType  .mp2      audio/mpeg                        binary  1.0
  681. AddType  .mp3      audio/mpeg                        binary  1.0
  682. AddType  .aiff     audio/x-aiff                      binary  1.0
  683. AddType  .aifc     audio/x-aiff                      binary  1.0
  684. AddType  .aif      audio/x-aiff                      binary  1.0
  685. AddType  .ra       audio/x-realaudio                 binary  1.0
  686. AddType  .ram      audio/x-pn-realaudio              binary  1.0
  687. AddType  .rpm      audio/x-pn-realaudio-plugin       binary  1.0
  688. AddType  .wav      audio/x-wav                       binary  1.0 # Windows+ WAVE format
  689.  
  690. AddType  .pdb      chemical/x-pdb                    binary  0.8
  691. AddType  .xyz      chemical/x-pdb                    binary  0.8
  692.  
  693. # Graphic (image) types
  694. AddType  .bmp      image/bmp                         binary  1.0 # OS/2 bitmap format
  695. AddType  .ras      image/x-cmu-raster                binary  1.0
  696. AddType  .gif      image/gif                         binary  1.0 # GIF
  697. AddType  .ief      image/ief                         binary  1.0 # Image Exchange fmt
  698. AddType  .jpg      image/jpeg                        binary  1.0 # JPEG
  699. AddType  .JPG      image/jpeg                        binary  1.0
  700. AddType  .JPE      image/jpeg                        binary  1.0
  701. AddType  .jpe      image/jpeg                        binary  1.0
  702. AddType  .JPEG     image/jpeg                        binary  1.0
  703. AddType  .jpeg     image/jpeg                        binary  1.0
  704. AddType  .png      image/png                         binary  1.0 # Portable Network Graphics
  705. AddType  .tif      image/tiff                        binary  1.0 # TIFF
  706. AddType  .tiff     image/tiff                        binary  1.0
  707. AddType  .pnm      image/x-portable-anymap           binary  1.0 # PBM Anymap format
  708. AddType  .pbm      image/x-portable-bitmap           binary  1.0 # PBM Bitmap format
  709. AddType  .pgm      image/x-portable-graymap          binary  1.0 # PBM Graymap format
  710. AddType  .ppm      image/x-portable-pixmap           binary  1.0 # PBM Pixmap format
  711. AddType  .rgb      image/x-rgb                       binary  1.0
  712. AddType  .xbm      image/x-xbitmap                   binary  1.0 # X bitmap
  713. AddType  .xpm      image/x-xpixmap                   binary  1.0 # X pixmap format
  714. AddType  .xwd      image/x-xwindowdump               binary  1.0 # X window dump (xwd)
  715.  
  716. # "Multipart" (containers)
  717. AddType  .tar      multipart/x-tar                   binary  1.0 # 4.    3BSD tar
  718. AddType  .ustar    multipart/x-ustar                 binary  1.0 # POSIX tar
  719. AddType  .zip      multipart/x-zip                   binary  1.0 # PKZIP
  720.  
  721. # Text file types
  722. AddType  .css      text/css                          8bit    1.0 # W3C Cascading Style Sheets
  723. AddType  .html     text/html                         8bit    1.0 # HTML
  724. AddType  .htm      text/html                         8bit    1.0 # HTML on PCs
  725. AddType  .c        text/plain                        7bit    0.5 # C source
  726. AddType  .h        text/plain                        7bit    0.5 # C headers
  727. AddType  .C        text/plain                        7bit    0.5 # C++ source
  728. AddType  .cc       text/plain                        7bit    0.5 # C++ source
  729. AddType  .hh       text/plain                        7bit    0.5 # C++ headers
  730. AddType  .java     text/plain                        7bit    0.5 # Java source
  731. AddType  .m        text/plain                        7bit    0.5 # Objective-C source
  732. AddType  .f90      text/plain                        7bit    0.5 # Fortran 90 source
  733. AddType  .txt      text/plain                        7bit    0.5 # Plain text
  734. AddType  .cxx      text/plain                        7bit    0.5 # C++
  735. AddType  .for      text/plain                        7bit    0.5 # Fortran
  736. AddType  .mar      text/plain                        7bit    0.5 # MACRO
  737. AddType  .log      text/plain                        7bit    0.5 # logfiles
  738. AddType  .com      text/plain                        7bit    0.5 # scripts
  739. AddType  .sdml     text/plain                        7bit    0.5 # SDML
  740. AddType  .list     text/plain                        7bit    0.5 # listfiles
  741. AddType  .lst      text/plain                        7bit    0.5 # listfiles
  742. AddType  .def      text/plain                        7bit    0.5 # definition files
  743. AddType  .conf     text/plain                        7bit    0.5 # definition files
  744. AddType  .         text/plain                        7bit    0.5 # files with no extension
  745. AddType  .rtx      text/richtext                     7bit    1.0 # MIME Richtext format
  746. AddType  .tsv      text/tab-separated-values         7bit    1.0 # Tab-separated values
  747. AddType  .etx      text/x-setext                     7bit    0.9 # Struct Enchanced Txt
  748. AddType  .asm      text/x-asm                        7bit    1.0 # ASM source
  749. AddType  .sgm      text/x-sgml                       8bit    1.0 # SGML source
  750. AddType  .sgml     text/x-sgml                       8bit    1.0 # SGML source
  751. AddType  .htmls    text/x-ssi-html                   8bit    1.0 # Server-side includes
  752. AddType  .shtml    text/x-ssi-html                   8bit    1.0 # Server-side includes
  753. AddType  .uil      text/x-uil                        8bit    1.0 #
  754. AddType  .uu       text/x-uuencode                   8bit    1.0 #
  755.  
  756. # Video formats
  757. AddType  .mpg      video/mpeg                        binary  1.0
  758. AddType  .mpe      video/mpeg                        binary  1.0
  759. AddType  .mpeg     video/mpeg                        binary  1.0
  760. AddType  .qt       video/quicktime                   binary  1.0 # QuickTime
  761. AddType  .mov      video/quicktime                   binary  1.0
  762. AddType  .avi      video/x-msvideo                   binary  1.0 # MS Video for Windows
  763. AddType  .movie    video/x-sgi-movie                 binary  1.0 # SGI movieplayer
  764. AddType  .mjpg     video/x-motion-jpeg               binary  1.0 #
  765.  
  766. # "WWW" - internal - types
  767. AddType  .mime     www/mime                          binary  1.0 # Internal -- MIME is not recursive
  768.  
  769. # Extension types
  770. AddType  .ice      x-conference/x-cooltalk           binary  1.0
  771. AddType  .wrl      x-world/x-vrml                    binary  1.0 # VRML
  772.  
  773. # When all else fails...
  774. AddType  *.*       application/octet-stream          binary  0.1 # Try to guess
  775. AddType  *         application/octet-stream          binary  0.1 # Try to guess
  776.  
  777.  
  778.  
  779. #        Map suffixes to MIME content-encodings.
  780. #        These are usually extra suffixes that modify the base file.
  781. #
  782. #        Defaults:  <none>
  783. #        Syntax:    AddEncoding <.suffix><encoding>
  784. AddEncoding     .Z              x-compress    1.0   # Compressed data
  785. AddEncoding     .gz             x-gzip        1.0   # Compressed data
  786.  
  787.  
  788.  
  789.  
  790. # ===================================================================== #
  791. #
  792. #        Error Message directives
  793. #
  794. # ===================================================================== #
  795.  
  796.  
  797. #        ErrorPage directive:
  798. #
  799. #        Specifies the html file name to be returned by the server to the
  800. #        client when a specific error occurs.
  801. #
  802. #        NOTE: Please see "Error Conditions, Causes, and Default Messages"
  803. #              in the online documentation for a list keywords.
  804. #
  805. #        Default:  <none>
  806. #        Syntax:   ErrorPage <keyword> </path/filename.html>
  807. #
  808. # Example:
  809. # ErrorPage scriptstart /errorpages/scriptstart.html
  810. #
  811. ErrorPage badrange              /errorpages/badrange.htmls
  812. ErrorPage badredirect           /errorpages/badredirect.htmls
  813. ErrorPage badrequest            /errorpages/badrequest.htmls
  814. ErrorPage badscript             /errorpages/badscript.htmls
  815. ErrorPage baduser               /errorpages/baduser.htmls
  816. ErrorPage blocked               /errorpages/blocked.htmls
  817. ErrorPage byrule                /errorpages/byrule.htmls
  818. ErrorPage cacheexp              /errorpages/cacheexp.htmls
  819. ErrorPage cachenoconn           /errorpages/cachenoconn.htmls
  820. ErrorPage cachenotopened        /errorpages/cachenotopened.htmls
  821. ErrorPage cacheonly             /errorpages/cacheonly.htmls
  822. ErrorPage connectfail           /errorpages/connectfail.htmls
  823. ErrorPage deletefailed          /errorpages/deletefailed.htmls
  824. ErrorPage dirbrowse             /errorpages/dirbrowse.htmls
  825. ErrorPage dirnobrowse           /errorpages/dirnobrowse.htmls
  826. ErrorPage dotdot                /errorpages/dotdot.htmls
  827. ErrorPage expectfailed          /errorpages/expectfailed.htmls
  828. ErrorPage ftpanonloginrej       /errorpages/ftpanonloginrej.htmls
  829. ErrorPage ftpauth               /errorpages/ftpauth.htmls
  830. ErrorPage ftpbad220             /errorpages/ftpbad220.htmls
  831. ErrorPage ftphpanonloginrej     /errorpages/ftphpanonloginrej.htmls
  832. ErrorPage ftphpbad220           /errorpages/ftphpbad220.htmls
  833. ErrorPage ftphploginrej         /errorpages/ftphploginrej.htmls
  834. ErrorPage ftphpnoconnect        /errorpages/ftphpnoconnect.htmls
  835. ErrorPage ftphpnoresponse       /errorpages/ftphpnoresponse.htmls
  836. ErrorPage ftphpnosocket         /errorpages/ftphpnosocket.htmls
  837. ErrorPage ftphpunreshost        /errorpages/ftphpunreshost.htmls
  838. ErrorPage ftploginrej           /errorpages/ftploginrej.htmls
  839. ErrorPage ftploginreq           /errorpages/ftploginreq.htmls
  840. ErrorPage ftpnoconnect          /errorpages/ftpnoconnect.htmls
  841. ErrorPage ftpnodata             /errorpages/ftpnodata.htmls
  842. ErrorPage ftpnoresponse         /errorpages/ftpnoresponse.htmls
  843. ErrorPage ftpnosocket           /errorpages/ftpnosocket.htmls
  844. ErrorPage ftpunrechost          /errorpages/ftpunrechost.htmls
  845. ErrorPage ftpunreshost          /errorpages/ftpunreshost.htmls
  846. ErrorPage hpforbidden           /errorpages/hpforbidden.htmls
  847. ErrorPage httpnodata            /errorpages/httpnodata.htmls
  848. ErrorPage httpnoforward         /errorpages/httpnoforward.htmls
  849. ErrorPage httpnosend            /errorpages/httpnosend.htmls
  850. ErrorPage httpunreshost         /errorpages/httpunreshost.htmls
  851. ErrorPage ipmask                /errorpages/ipmask.htmls
  852. ErrorPage ipmaskproxy           /errorpages/ipmaskproxy.htmls
  853. ErrorPage methoddisabled        /errorpages/methoddisabled.htmls
  854. ErrorPage multifail             /errorpages/multifail.htmls
  855. ErrorPage noaccess              /errorpages/noaccess.htmls
  856. ErrorPage noacl                 /errorpages/noacl.htmls
  857. ErrorPage nocachenoconn         /errorpages/nocachenoconn.htmls
  858. ErrorPage noentry               /errorpages/noentry.htmls
  859. ErrorPage noformat              /errorpages/noformat.htmls
  860. ErrorPage nohostheader          /errorpages/nohostheader.htmls
  861. ErrorPage noopen                /errorpages/noopen.htmls
  862. ErrorPage nopartner             /errorpages/nopartner.htmls
  863. ErrorPage norep                 /errorpages/norep.htmls
  864. ErrorPage notallowed            /errorpages/notallowed.htmls
  865. ErrorPage notauthorized         /errorpages/notauthorized.htmls
  866. ErrorPage notfound              /errorpages/notfound.htmls
  867. ErrorPage notmember             /errorpages/notmember.htmls
  868. ErrorPage olproxnocontact       /errorpages/olproxnocontact.htmls
  869. ErrorPage openfailed            /errorpages/openfailed.htmls
  870. ErrorPage originbadresp         /errorpages/originbadresp.htmls
  871. ErrorPage preconfail            /errorpages/preconfail.htmls
  872. ErrorPage proxybadurl           /errorpages/proxybadurl.htmls
  873. ErrorPage proxyfail             /errorpages/proxyfail.htmls
  874. ErrorPage proxynotauth          /errorpages/proxynotauth.htmls
  875. ErrorPage proxynotmember        /errorpages/proxynotmember.htmls
  876. ErrorPage putfailed             /errorpages/putfailed.htmls
  877. ErrorPage rchunkerror           /errorpages/rchunkerror.htmls
  878. ErrorPage rchunkmemory          /errorpages/rchunkmemory.htmls
  879. ErrorPage scriptinterr          /errorpages/scriptinterr.htmls
  880. ErrorPage scriptio              /errorpages/scriptio.htmls
  881. ErrorPage scriptnocomm          /errorpages/scriptnocomm.htmls
  882. ErrorPage scriptnotfound        /errorpages/scriptnotfound.htmls
  883. ErrorPage scriptnovari          /errorpages/scriptnovari.htmls
  884. ErrorPage scriptstart           /errorpages/scriptstart.htmls
  885. ErrorPage servermaperror        /errorpages/servermaperror.htmls
  886. ErrorPage setuperror            /errorpages/setuperror.htmls
  887. ErrorPage throttled             /errorpages/throttled.htmls
  888. ErrorPage unknownmethod         /errorpages/unknownmethod.htmls
  889.  
  890.  
  891.  
  892. # ===================================================================== #
  893. #
  894. #        API directives:
  895. #
  896. # ===================================================================== #
  897.  
  898.  
  899. #        ServerInit directive:
  900. #
  901. #        Specify a customized application function you want the server
  902. #        to call during the server's initialization routines. This code
  903. #        will be executed before any client requests are read.
  904. #
  905. #        Default:  <none>
  906. #        Syntax:   ServerInit </path/file:function_name>
  907. #
  908. # Example:
  909. # ServerInit /www/api/bin/icsext05.so:svr_init
  910. #
  911. #WES
  912. # ********R E A D    T H I S**********************************
  913. # The Everyplace Suite installer program should create the following file.
  914. # If you are running in a SecureWay Directory environment, the values from this file
  915. # will be overridden by the values in the SecureWay Directory table.
  916.  
  917. ServerInit /usr/bin/wesauth.so:InitAS /usr/lpp/IBMEPS.Auth/ibmwesas.conf
  918.  
  919.  
  920. #        PreExit directive:
  921. #
  922. #        Specify a customized application function you want the server to
  923. #        call during the User PreExit step. This code will be executed after
  924. #        a client request has been read but before any other processing
  925. #        occurs. You can call the goserve module during this step.
  926. #
  927. #        Default:  <none>
  928. #        Syntax:   PreExit </path/file:function_name>
  929. #
  930. # Example:
  931. # PreExit /www/api/bin/icsext05.so:pre_exit
  932.  
  933.  
  934. #        Authentication directive:
  935. #
  936. #        Specify a customized application function you want the server to
  937. #        call during the Authentication step. This code will be executed based
  938. #        on the authentication scheme. Currently, only Basic authentication
  939. #        is supported.
  940. #
  941. #        Default:  <none>
  942. #        Syntax:   Authentication <type> </path/file:function_name>
  943. #
  944. # Example:
  945. # Authentication BASIC /www/api/bin/icsextpgm.so:basic_authen
  946.  
  947.  
  948. #        NameTrans directive:
  949. #
  950. #        Specify a customized application function you want the server
  951. #        to call during the Name Translation step. This code would supply
  952. #        the mechanism for translating the virtual path in the request to
  953. #        the physical path on the server, mapping URLs to specific objects.
  954. #
  955. #        Default:  <none>
  956. #        Syntax:   NameTrans </URL> </path/file:function_name> <IP_address_template>
  957. #
  958. # Example:
  959. # NameTrans /index.html /www/api/bin/icsextpgm.so:trans_url
  960.  
  961.  
  962. #        Authorization directive:
  963. #
  964. #        Specify a customized application function you want the server
  965. #        to call during the Authorization step. This code would verify
  966. #        that the requested object can be served to the client.
  967. #
  968. #        Default:  <none>
  969. #        Syntax:   Authorization </URL> </path/file:function_name>
  970. #
  971. # Example:
  972. # Authorization /index.html /www/api/bin/icsextpgm.so:trans_url
  973. #WES
  974. # The following line requires authorization for every page, including http and https:
  975.  
  976. #Authorization * /usr/bin/wesauth.so:AuthAS
  977. Authorization http://servicewes1:15080/* /usr/bin/wesauth.so:AuthAS
  978.  
  979. ######################################
  980. #
  981. # UNPROTECTED ALIASES
  982. #
  983. ######################################
  984. Proxy    /tsm-enroll/*   http://servicewes1:18080/*
  985. Proxy    /enroll/*       http://servicewes1:18080/enroll/*
  986. Proxy    /art/*        http://servicewes1:18080/art/*
  987.  
  988.  
  989. #        ObjectType directive:
  990. #
  991. #        Specify a customized application function you want the server
  992. #        to call during the Object Type step. This code would locate the
  993. #        requested object in the file system and identify its MIME type.
  994. #
  995. #        Default:  <none>
  996. #        Syntax:   ObjectType </URL> </path/file:function_name>
  997. #
  998. # Example:
  999. # ObjectType /index.html /www/api/bin/icsextpgm.so:obj_type
  1000.  
  1001.  
  1002. #        Service directive:
  1003. #
  1004. #        Specify a customized application function you want the server
  1005. #        to call during the Service step. This code would service the client
  1006. #        request. For example, it sends the file or runs the CGI program.
  1007. #
  1008. #        Default:  <none>
  1009. #        Syntax:   Service </URL> </path/file:function_name> <IP_address_template>
  1010. #
  1011. # Example:
  1012. # Service /index.html       /www/api/bin/icsext05.so:serve_req
  1013.  
  1014.  
  1015. #        Transmogrifier directive:
  1016. #
  1017. #        Specify a customized application function you want the server
  1018. #        to call during the Transmogrifier step. This code would provide four
  1019. #        application functions: an open function, a write function, a close
  1020. #        function, and an error function.
  1021. #
  1022. #        Default:  <none>
  1023. #        Syntax:   Transmogrifier </path/file:open_function_name:write_function_name:close_function_name:error_function_name>
  1024. #
  1025. # Example:
  1026. # Transmogrifier /www/api/bin/icsext05.so:my_open:my_write:my_close:my_error
  1027.  
  1028.  
  1029. #        Log directive:
  1030. #
  1031. #        Specify a customized application function you want the server
  1032. #        to call during the Log step. This code would supply logging and
  1033. #        other processing you want performed after the connection has
  1034. #        been closed.
  1035. #
  1036. #        Default:  <none>
  1037. #        Syntax:   Log </URL> </path/file:function_name>
  1038. #
  1039. # Example:
  1040. # Log /index.html /www/api/bin/icsextpgm.so:trans_url
  1041.  
  1042.  
  1043. #        Error directive:
  1044. #
  1045. #        Specify a customized application function you want the server
  1046. #        to call during the Error step. This code would execute only when
  1047. #        an error is encountered to provide customized error routines.
  1048. #
  1049. #        Default:  <none>
  1050. #        Syntax:   Error </URL> </path/file:function_name>
  1051. #
  1052. # Example:
  1053. # Error /index.html /www/api/bin/icsext05.so:error_rtns
  1054.  
  1055.  
  1056. #        PostExit directive:
  1057. #
  1058. #        Specify a customized application function you want the server
  1059. #        to call during the Post-exit step. This code will be executed
  1060. #        regardless of the return codes from previous steps. It allows
  1061. #        you to clean up any resources allocated to process the request.
  1062. #
  1063. #        Default:  <none>
  1064. #        Syntax:   PostExit </path/file:function_name>
  1065. #
  1066. # Example:
  1067. # PostExit /www/api/bin/icsext05.so:post_exit
  1068.  
  1069.  
  1070. #        ServerTerm directive:
  1071. #
  1072. #        Specify a customized application function you want the server
  1073. #        to call during the Server Termination step. This code would
  1074. #        execute when an orderly shutdown occurs and allows you to
  1075. #        release resources allocated by a PreExit application function.
  1076. #
  1077. #        Default:  <none>
  1078. #        Syntax:   ServerTerm </path/file:function_name>
  1079. #
  1080. # Example:
  1081. # ServerTerm /www/api/bin/icsext05.so:shut_down
  1082. ServerTerm /usr/bin/wesauth.so:TermAS
  1083.  
  1084.  
  1085. #        Midnight directive:
  1086. #
  1087. #        Specify a customized application function you want the server
  1088. #        to call at midnight.
  1089. #
  1090. #        Default:  Midnight /usr/lib/archive.so:begin
  1091. #        Syntax:   Midnight </path/file:function_name>
  1092. Midnight /usr/lib/archive.so:begin
  1093.  
  1094. # See also the 'Service' directive, which is an API directive, but
  1095. # comes after the document protection directives.
  1096.  
  1097.  
  1098.  
  1099. # ===================================================================== #
  1100. #
  1101. #        User authentication and document protection
  1102. #
  1103. # ===================================================================== #
  1104.  
  1105.  
  1106. #        Within the configuration file, there are three directives that
  1107. #        define file access protection:
  1108. #          Protect, DefProt, and Protection.
  1109. #
  1110. #        A Protection setup contains subdirectives that define how a set
  1111. #        of resources is to be protected. The protection setup is used on
  1112. #        a DefProt or Protect directive. The subdirectives can be coded
  1113. #          * on a preceding Protection directive
  1114. #          * in-line on the DefProt or Protect directive
  1115. #          * in a separate protection file
  1116. #
  1117. #        The Protect and DefProt directives define the association of a
  1118. #        Protection setup with a set of resources to be protected.
  1119. #          * The DefProt statement associates a Protection setup with a URL
  1120. #            template but does not activate protection.
  1121. #          * The Protect statement associates a Protection setup with a URL
  1122. #            template and activates the protection.
  1123. #
  1124. #        If your server has multiple network connections, you can optionally
  1125. #        specify an address template on either the DefProt or Protect directive
  1126. #        to restrict the server to using the directive only for requests that
  1127. #        come to the server on a connection with an address matching the
  1128. #        template.
  1129. #
  1130. #        NOTE: The address of the server's network connection is compared to
  1131. #              the template, NOT the address of the requesting client.
  1132. #
  1133. #        You can specify a complete IP address (for example, FOR 9.67.106.79),
  1134. #        or you can use a wildcard(*) character and specify a template
  1135. #        (for example, FOR 9.83.*).
  1136. #
  1137. #
  1138. #        Protection directive:
  1139. #
  1140. #        Default:  <none>
  1141. #        Syntax:  Protection setup-name { directives }
  1142. #
  1143. #                 Within the braces, any combination of twelve(12) possible
  1144. #                 protection subdirectives can be defined:
  1145. #                    UserID, GroupID, ServerID, AuthType,
  1146. #                    GetMask, PutMask, PostMask, DeleteMask, Mask,
  1147. #                    PasswdFile, GroupFile
  1148. #
  1149. #
  1150. #        Protect directive:
  1151. #
  1152. #        Default:  <none>
  1153. #        Syntax for a Protect directive pointing to a Protection directive:
  1154. #                 Protect request-template setup-name [FOR IP-address-label]
  1155. #
  1156. #        Syntax for a Protect directive with protection settings defined
  1157. #        inline:
  1158. #                 Protect request-template [IP-address-label] {
  1159. #                      protection setting
  1160. #                      protection setting
  1161. #                      .
  1162. #                      .
  1163. #                      .
  1164. #                      }
  1165. # Example:
  1166. # Protect /secret/*  CustomerA-PROT
  1167. # Protect /secret/*  {
  1168. #                  ServerID   ServerName
  1169. #                  AuthType   Basic
  1170. #                  PasswdFile /docs/www/restricted.pwd
  1171. #                  GroupFile  /docs/www/restricted.grp
  1172. #                  GetMask  authors
  1173. #                  }
  1174. # Protect /secret/*  CustomerA-PROT FOR 9.67.106.79
  1175. # Protect /secret/*  9.83.*  {
  1176. #                  ServerID   ServerName
  1177. #                  AuthType   Basic
  1178. #                  PasswdFile /docs/www/restricted.pwd
  1179. #                  GroupFile  /docs/www/restricted.grp
  1180. #                  GetMask    authors
  1181. #                  }
  1182. #
  1183. #
  1184. #        DefProt directive:
  1185. #
  1186. #        Syntax for a DefProt directive pointing to a Protection directive:
  1187. #                 DefProt request-template setup-name [FOR IP-address-label]
  1188. #
  1189. #        Syntax for a Protect directive with protection settings defined
  1190. #        inline:
  1191. #                 DefProt request-template [IP-address-label] {
  1192. #                      protection setting
  1193. #                      protection setting
  1194. #                      .
  1195. #                      .
  1196. #                      .
  1197. #                      }
  1198. #
  1199. # Example:
  1200. # DefProt /secret/*  CustomerA-PROT
  1201. # DefProt /secret/*  {
  1202. #                  ServerID   ServerName
  1203. #                  AuthType   Basic
  1204. #                  PasswdFile /docs/www/restricted.pwd
  1205. #                  GroupFile  /docs/www/restricted.grp
  1206. #                  GetMask    authors
  1207. #                  }
  1208. # DefProt /secret/*  CustomerA-PROT FOR 9.67.106.79
  1209. # DefProt /secret/*  9.83.*  {
  1210. #                  ServerID   ServerName
  1211. #                  AuthType   Basic
  1212. #                  PasswdFile /docs/www/restricted.pwd
  1213. #                  GroupFile  /docs/www/restricted.grp
  1214. #                  GetMask    authors
  1215. #                  }
  1216. #
  1217. #
  1218. #        Example DefProt and Protect and Protection directives:
  1219. #
  1220. #        Protection setup by usernames; specify groups in the group
  1221. #        file, if you need groups; create and maintain password files
  1222. #        with the htadm program.
  1223. #
  1224. # Protection PROT-SETUP-USERS {
  1225. #         ServerId        YourServersFancyName
  1226. #         AuthType        Basic
  1227. #         PasswdFile      /where/ever/passwd
  1228. #         GroupFile       /where/ever/group
  1229. #         GET-Mask        user, user, group, group, user
  1230. # }
  1231. #
  1232. #
  1233. #        Protection setup by hosts; you can use both domain name
  1234. #        templates and IP number templates
  1235. #
  1236. # Protection PROT-SETUP-HOSTS {
  1237. #         ServerId        YourServersFancyName
  1238. #         AuthType        Basic
  1239. #         PasswdFile      /where/ever/passwd
  1240. #         GroupFile       /where/ever/group
  1241. #         GET-Mask        @(*.cern.ch, 128.141.*.*, *.ncsa.uiuc.edu)
  1242. # }
  1243. # DefProt /very/secret/URL/*
  1244. # Protect /very/secret/URL/*      PROT-SETUP-USERS
  1245. # Protect /another/secret/URL/*   PROT-SETUP-HOSTS
  1246. #
  1247. Protection PROT-ADMIN {
  1248.           ServerId     Private_Authorization
  1249.           AuthType     Basic
  1250.           GetMask      All@(*)
  1251.           PutMask      All@(*)
  1252.           PostMask     All@(*)
  1253.           Mask         All@(*)
  1254.           PasswdFile   /opt/IBMWTE/usr/internet/server_root/protect/webadmin.passwd
  1255. }
  1256.  
  1257. #WES
  1258. #********You can change the ServerID line to suit your needs**********
  1259. # The ServerID line determines what name will be shown in the authentication dialog box
  1260. # on the client machine.
  1261. Protection PROT-AS {
  1262.     ServerId WES_Support
  1263.     AuthType Basic
  1264.     Mask     All@(*)
  1265. }
  1266.  
  1267. Protect /admin-bin/* PROT-ADMIN
  1268. Protect /reports/*   PROT-ADMIN
  1269. Protect /Usage*      PROT-ADMIN
  1270.  
  1271. # Added for Authentication server
  1272. #Protect /*           PROT-AS
  1273. Protect   /tsm_sc/*  PROT-AS    
  1274. Protect   /selfcare/*  PROT-AS
  1275.  
  1276. #
  1277. #        Service directive:
  1278. #
  1279. #        Default:  <none>
  1280. #        Syntax:   service <URL> <program>
  1281. #
  1282.  
  1283. Service /ndadvisor               INTERNAL:NDAdvisor
  1284. service /Usage*                  INTERNAL:UsageFn
  1285. service /admin-bin/trace*        INTERNAL:TraceFn
  1286.  
  1287.  
  1288.  
  1289. # ===================================================================== #
  1290. #
  1291. #        Mapping rules
  1292. #
  1293. # ===================================================================== #
  1294.  
  1295.  
  1296. #        The Pass, Fail, Exec, Map, Redirect, and Proxy rules are used for
  1297. #        mapping a request URL to another URL or a physical file.
  1298. #
  1299. #        The rules specify templates and a file directory or new URL to replace
  1300. #        the template in the request. If a request comes in and the URL of the
  1301. #        request matches one of the mapping rules, the rule is applied. Asterisks
  1302. #        are used as wild cards and must appear in both the request template and
  1303. #        the replacement template. The Fail rule does not have a replacement template.
  1304. #
  1305. #        The Pass, Fail, and Exec rules are used for mapping from a request URL
  1306. #        to a physical file. The Map rule is used for mapping from one url to
  1307. #        another.  The Proxy rule is used for mapping from a request URL to a URL
  1308. #        which will be passed on to another server and requires a full URL in the
  1309. #        replacement template.  Redirect will direct the client to pass the request
  1310. #        on to another server and requires a full URL in the replacement template.
  1311. #
  1312. #        The rules are applied in the order they appear in the configuration file
  1313. #        until a request template has been matched or until there are no more rules
  1314. #        to apply.  The Map rule will modify the request as defined by the replacement
  1315. #        template and then will continue processing the remaining rules against the
  1316. #        mapped request.  All other rules will stop applying rules once one of the
  1317. #        rules has been matched.
  1318. #
  1319. #        If your server has multiple network connections, you can optionally
  1320. #        specify an address template to restrict the server to using the
  1321. #        directive only for requests that come to the server on a connection
  1322. #        with an address matching the template.
  1323. #
  1324. #        NOTE: the address of the servers network connection is compared
  1325. #              to the template, not the address of the requesting client.
  1326. #
  1327. #        You can specify a complete IP address (for example, 9.67.106.79).
  1328. #
  1329. #        Default:  <none>
  1330. #        Syntax:   rule request-template result [IP-address-template]
  1331. #
  1332. #
  1333. # Example:
  1334. # Exec          /cgi-bin/*              /CGI-BIN/CustomerA/*  9.67.109.79
  1335. # Map           /data/*                 /www/data/*
  1336. # Map           /mess/*                 /www/junk/*
  1337. # Map           /books/stuff/*          /www/docs/*
  1338. # Fail          /bogus/*                9.67.105.79
  1339. # Fail          /ddd/eee/*
  1340. # Redirect      /old/server/*           http://new.server.loc/newpath/*
  1341. # Proxy         /hosta/*                http://hosta/*
  1342. # Pass          /buck/*                 /diskx/bin/*
  1343. #
  1344. # Added for Authentication Server TPSM enrollment
  1345. #    The enrollment server config is only for Auth Servre testing
  1346. #    as this server should be out the WES domain. Change to the
  1347. #    correct TPSM machine. The http request is
  1348. #        http://wesaix04:8001/tsm-enroll/enroll.html
  1349. # You should change the machine names in the example to match those 
  1350. # of your TPSM machine.  
  1351. #
  1352.  
  1353. #WES
  1354. # An example of how to use a proxy statement is as follows:
  1355. # Proxy  /ibm/*  http://www.ibm.com/*
  1356. # From the client browser, you would access the URL
  1357. # http://server:port/ibm/
  1358. # This statement makes it appear that the remote page is actually contained on the 
  1359. # local machine.  Remember that proxy statements work best on pages that you maintain
  1360. # because absolute links will not work.  
  1361. # If a link references www.ibm.com/images/logo.gif, it will not access the image
  1362. # correctly.  In this situation, you should create a relative link to the 
  1363. # image.  An example would be /images/logo.gif.  
  1364. # For this example, you need to add another proxy line in order to correctly proxy
  1365. # the images directory.   Example:  Proxy  /images/*  http://www.ibm.com/images/*
  1366. # The correct way to access the image is as follows:  http://server:port/images/logo.gif.
  1367.  
  1368.  
  1369. # Here are some examples we have added for Tivoli Personalized Services Manager.
  1370.  
  1371. #Proxy        /tsm-enroll/*        http://servicewes1:18080/*
  1372. #Proxy        /enroll/*        http://servicewes1:18080/enroll/*
  1373. #Proxy          /art/*             http://servicewes1:18080/art/*
  1374.  
  1375.  
  1376. # Tivoli Personalized Services Manager Personal (Personal has links to the selfcare appls)
  1377. # It shoud be accessed by
  1378. #           http://wteserver:port/perso/samples/welcome.jsp
  1379. # However, the welcome.jsp in /usr/TivTSM/personal/content/samples contains some gif 
  1380. # files that reside on www.tivoli.com, which results in blank image under AP
  1381. #
  1382. Proxy        /perso/*        http://servicewes1:16080/perso/*
  1383. Proxy        /images/*        http://servicewes1:16080/images/*
  1384. #
  1385.  
  1386. # Tivoli Personalized Services Manager Selfcare
  1387. # For selfcare access, use
  1388. #        http://wteserver:port/tsm_sc/selfcare
  1389. #
  1390.  
  1391. Proxy   /tsm_sc/*       http://servicewes1:15080/*
  1392. Proxy   /selfcare/*     http://servicewes1:15080/selfcare/*
  1393.  
  1394. # If there is any back-end original server, say backserver-1,  other than the TPSM 
  1395. # machine, that you don't want the request be transformed by WTP, in which case, 
  1396. # you still a Proxy directive for this specific server
  1397. Proxy    /bs-1/*        http://backserver-1:port/*
  1398. # and the request would be
  1399. #    http://wte-server:port/*
  1400. # and later on, the no_proxy line need to be specified--see "no_proxy" for details
  1401.  
  1402.  
  1403. #WES
  1404. # For testing purposes, you may choose to add the following line at the
  1405. # bottom of your proxy statements.  Adding this line will map everything that
  1406. # does not match another proxy statement to the specified site.  Again, this is
  1407. # for testing and should probably not be used in the real world.  
  1408. # For example http://wteserver:port/www.yahoo.com
  1409. # is mapped to http://www.yahoo.com
  1410. #
  1411. #Proxy           /*                      http://*
  1412. #
  1413.  
  1414.  
  1415. #        Scripts; URLs starting with /cgi-bin/ will be understood as
  1416. #        script calls in the directory /opt/IBMWTE/usr/internet/server_root/cgi-bin/
  1417. #
  1418. #        URLs starting with /admin-bin/ will be understood as
  1419. #        script calls in the directory /opt/IBMWTE/usr/internet/server_root/admin-bin/
  1420. #
  1421. Pass        /admin-bin/webexec/*.style    /opt/IBMWTE/usr/internet/server_root/admin-bin/webexec/*.style
  1422. Pass        /admin-bin/webexec/*.NLS      /opt/IBMWTE/usr/internet/server_root/admin-bin/webexec/*.NLS
  1423. Pass        /admin-bin/webexec/*.props    /opt/IBMWTE/usr/internet/server_root/admin-bin/webexec/*.props
  1424. Pass        /admin-bin/webexec/*.class    /opt/IBMWTE/usr/internet/server_root/admin-bin/webexec/*.class
  1425. Pass        /admin-bin/webexec/*.gif      /opt/IBMWTE/usr/internet/server_root/admin-bin/webexec/*.gif
  1426. Pass        /admin-bin/webexec/*.jar      /opt/IBMWTE/usr/internet/server_root/admin-bin/webexec/*.jar
  1427. Pass        /admin-bin/webexec/*.html     /opt/IBMWTE/usr/internet/server_root/admin-bin/webexec/*.html
  1428. Pass        /Docs/arrow*.gif              /opt/IBMWTE/usr/internet/server_root/Docs/arrow*.gif
  1429. Pass        /Docs/up-arrow.gif            /opt/IBMWTE/usr/internet/server_root/Docs/up-arrow.gif
  1430. Pass        /Docs/*.jar                   /opt/IBMWTE/usr/internet/server_root/Docs/*.jar
  1431. Pass        /Docs/*.class                 /opt/IBMWTE/usr/internet/server_root/Docs/*.jar
  1432. #Pass        /admin-bin/webexec/images/*  /opt/IBMWTE/usr/internet/server_root/admin-bin/webexec/images*
  1433.  
  1434. Pass        /admin-bin/webexec/*  /opt/IBMWTE/usr/internet/server_root/admin-bin/webexec/*
  1435. Exec        /cgi-bin/*            /opt/IBMWTE/usr/internet/server_root/cgi-bin/*
  1436. Exec        /admin-bin/*          /opt/IBMWTE/usr/internet/server_root/admin-bin/*
  1437. Exec        /Docs/admin-bin/*     /opt/IBMWTE/usr/internet/server_root/admin-bin/*
  1438.  
  1439.  
  1440. #
  1441. #        URL translation rules; If your documents are under
  1442. #        /opt/IBMWTE/usr/internet/server_root/pub/ then this single rule does the job:
  1443. #
  1444. Pass            /icons/statusSB.gif /opt/IBMWTE/usr/internet/server_root/icons/statusSB.gif
  1445. Pass            /icons/*            /opt/IBMWTE/usr/internet/server_root/icons/*
  1446. Pass            /Admin/*            /opt/IBMWTE/usr/internet/server_root/Admin/*
  1447. Pass            /Docs/*             /opt/IBMWTE/usr/internet/server_root/Docs/*
  1448. Pass            /htmldocs/*            /opt/IBMWTE/usr/internet/server_root/Docs/htmldocs/*
  1449. Pass            /wsApplet/*         /opt/IBMWTE/usr/internet/server_root/Applets/*
  1450. Pass            /errorpages/*       /opt/IBMWTE/usr/internet/server_root/pub/errorpages/*
  1451. # *** ADD NEW MAPPING RULES HERE ***
  1452. Pass            /*                  /opt/IBMWTE/usr/internet/server_root/pub/*
  1453.  
  1454.  
  1455. # ===================================================================== #
  1456. #
  1457. #        Performance directives
  1458. #
  1459. # ===================================================================== #
  1460.  
  1461.  
  1462. #        MaxActiveThreads directive:
  1463. #
  1464. #        Defines the number of threads in system thread pool.
  1465. #
  1466. #        Default:  100
  1467. #        Syntax:   MaxActiveThreads  <num>
  1468. MaxActiveThreads  100
  1469.  
  1470.  
  1471. #        MaxPersistRequest directive:
  1472. #
  1473. #        Maximum number of request to receive on a persistent connection.
  1474. #
  1475. #        Default:  5
  1476. #        Syntax:   MaxPersistRequest <num>
  1477. MaxPersistRequest 5
  1478.  
  1479.  
  1480.  
  1481.  
  1482. #        DNS-Lookup directive:
  1483. #
  1484. #        Instruct the server to look up hostnames of clients by
  1485. #        setting DNS-Lookup to "on".
  1486. #        NOTE: Turning DNS-Lookup "on" decreases server performance.
  1487. #
  1488. #        Default:  off
  1489. #        Syntax:   DNS-Lookup <on | off>
  1490. DNS-Lookup     off
  1491.  
  1492.  
  1493. #        PureProxy directive:
  1494. #
  1495. #        Specifies if the server is to be run purely as a proxy server.
  1496. #
  1497. #        Default:  on
  1498. #        Syntax:   PureProxy <on | off>
  1499. PureProxy on
  1500.  
  1501.  
  1502. #        MaxContentLengthBuffer directive:
  1503. #
  1504. #        The server normally gives a content-length header line for every
  1505. #        document it returns. For dynamically-generated documents, the server
  1506. #        must buffer the document to compute the content length. This directive
  1507. #        can be used to set the size of this buffer. If it is exceeded the
  1508. #        document will be returned without a content-length header field (and
  1509. #        the connection will be forced closed: persistent connections cannot
  1510. #        be used unless the response has a content length).
  1511. #
  1512. #        Default:  100 K
  1513. #        Syntax:  MaxContentLengthBuffer  <size>  <K|M>
  1514. #        (Only one keyword/value pair allowed.)
  1515. #
  1516. MaxContentLengthBuffer   100 K
  1517.  
  1518.  
  1519. #        ProxyPersistence directive:
  1520. #
  1521. #        Allows persistent connections, which will significantly reduce
  1522. #        latency for users and reduce CPU load on the proxy server.
  1523. #
  1524. #        NOTE: Supporting persistent connections requires more threads,
  1525. #              and thus more memory, on the proxy server. In addition,
  1526. #              if you have a multi-level proxy server setup, and you
  1527. #              have any old (HTTP/1.0) proxies in the network, then you
  1528. #              MUST NOT use persistent connections at the proxy.
  1529. #
  1530. #        Default:  on
  1531. #        Syntax:   ProxyPersistence <on | off>
  1532. ProxyPersistence on
  1533.  
  1534.  
  1535.  
  1536. # ===================================================================== #
  1537. #
  1538. #        Timeout directives
  1539. #
  1540. # ===================================================================== #
  1541.  
  1542.  
  1543. #        Use these directives to:
  1544. #           * limit the time to wait for the client to send a request
  1545. #             after connecting to the server before cancelling the connection.
  1546. #           * limit the time allowed without network activity before
  1547. #             cancelling the connection.
  1548. #           * limit the time to allow for sending output to the client.
  1549. #           * limit the time to allow for CGI programs to finish.
  1550. #             (If the program does not finish within allotted time, the server
  1551. #              will kill the CGI program.)
  1552. #           * limit the time to wait for the client to send a request
  1553. #             after establishing a persistent connection to the server
  1554. #             before cancelling the connection.
  1555. #
  1556. #        Default:  InputTimeout         2 minutes
  1557. #        Default:  ReadTimeout          5 minutes
  1558. #        Default:  OutputTimeout       12 hours
  1559. #        Default:  ScriptTimeout        5 minutes
  1560. #        Default:  PersistTimeout       4 seconds
  1561. #
  1562. #        Syntax:   <directive>       <time-spec>
  1563. #
  1564. InputTimeout         2 minutes
  1565. ReadTimeout          5 minutes
  1566. OutputTimeout       12 hours
  1567. ScriptTimeout        5 minutes
  1568. PersistTimeout       4 seconds
  1569.  
  1570.  
  1571.  
  1572. # ===================================================================== #
  1573. #
  1574. #        Proxy directives
  1575. #
  1576. # ===================================================================== #
  1577.  
  1578.  
  1579. #        Proxy server protection and caching directives
  1580. #
  1581. #        Proxy protections; if you want only certain domains to
  1582. #        use your proxy, uncomment these lines and specify the Mask
  1583. #        with hostname templates or IP number templates:
  1584. #
  1585. # Protection PROXY-PROT {
  1586. #       ServerId        YourProxyName
  1587. #       Mask            @(*.cern.ch, 128.141.*.*, *.ncsa.uiuc.edu)
  1588. # }
  1589. # Protect  *  PROXY-PROT
  1590. #
  1591.  
  1592.  
  1593. # Protect    http:*      PROXY-PROT
  1594. # Protect    ftp:*       PROXY-PROT
  1595. # Protect    gopher:*    PROXY-PROT
  1596.  
  1597. #        Specify the protocols that this proxy server will forward:
  1598. #
  1599. Proxy   http:*
  1600. Proxy   ftp:*
  1601. Proxy   gopher:*
  1602.  
  1603.  
  1604. #        SSLTunneling directive:
  1605. #
  1606. #        Enable SSL Tunneling to any port. You must also make sure that
  1607. #        the CONNECT method is enabled; use the directive "Enable" to
  1608. #        do this.
  1609. #
  1610. #        Default: on
  1611. #        Syntax: SSLTunneling <on | off>
  1612. SSLTunneling on
  1613.  
  1614.  
  1615. #        Proxy-to-Proxy directives:
  1616. #        Also known as Proxy Chaining
  1617. #
  1618. #        ftp_proxy directive:
  1619. #
  1620. #        Use this directive to specify the name of another proxy web server
  1621. #        this server should contact for FTP requests rather than contacting
  1622. #        the FTP Server named in the request URL directly.
  1623. #
  1624. #        Default: <none>
  1625. #        Syntax:  ftp_proxy <outer_proxy_server_URL>
  1626. #
  1627. # Example:
  1628. # ftp_proxy     http://outer.proxy.name/
  1629.  
  1630.  
  1631. #        gopher_proxy directive:
  1632. #
  1633. #        Use this directive to specify the name of another proxy web server
  1634. #        this server should contact for Gopher requests rather than contacting
  1635. #        the Gopher Server named in the request URL directly.
  1636. #
  1637. #        Default: <none>
  1638. #        Syntax:  gopher_proxy <outer_proxy_server_URL>
  1639. #
  1640. # Example:
  1641. # gopher_proxy  http://outer.proxy.name/
  1642.  
  1643.  
  1644. #        http_proxy directive:
  1645. #
  1646. #        Use this directive to specify the name of another proxy web server
  1647. #        this server should contact for HTTP requests rather than contacting
  1648. #        the HTTP Server named in the request URL directly.
  1649. #
  1650. #        Default: <none>
  1651. #        Syntax:  http_proxy <outer_proxy_server_URL>
  1652. #
  1653. # Example:
  1654. # http_proxy    http://outer.proxy.name/
  1655. #
  1656. # Added for Authentication Server, this will be the WTP
  1657. #http_proxy    http://brooktrout.raleigh.ibm.com:8088/
  1658.  
  1659.  
  1660. #        no_proxy directive:
  1661. #
  1662. #        Specify the domains to which the server should directly connect.
  1663. #        This is ONLY used when doing proxy chaining (i.e., when an
  1664. #        http_proxy, ftp_proxy, and/or gopher_proxy is defined). This
  1665. #        directive does NOT apply when the proxy goes through a SOCKS server;
  1666. #        use socks.conf for that purpose. Also, if you are using neither
  1667. #        proxy chaining nor SOCKS, then this directive is not needed.
  1668. #
  1669. #        Specify the value as a string of domain names or domain name
  1670. #        templates. Separate each entry in the string with a comma.
  1671. #
  1672. #        Do NOT put any spaces in the string.
  1673. #        You CANNOT use the wildcard character (*).
  1674. #        You CAN specify a template by including only the last part of a domain
  1675. #        name.
  1676. #
  1677. #        Default:  <none>
  1678. #        Syntax:   no_proxy <non-proxy domain specification>
  1679. #
  1680. # Example:
  1681. # no_proxy   www.someco.com,.raleigh.ibm.com,.some.host.org:8080
  1682. #
  1683. # this is to send traffic around the WTP to go to backserver-1 directly
  1684. no_proxy    raleigh.ibm.com
  1685.  
  1686.  
  1687.  
  1688. # ===================================================================== #
  1689. #
  1690. #        Proxy caching directives
  1691. #
  1692. # ===================================================================== #
  1693.  
  1694.  
  1695. #        Caching directive:
  1696. #
  1697. #        Turn on proxy caching here. To enable proxy caching, you must:
  1698. #        1) set the Caching directive to ON, and
  1699. #        2) specify at least one CacheDev (raw partition or file), or
  1700. #           specify CacheMemory (if no CacheDev, then memory cache is used)
  1701. #  
  1702. #        There are three different types of caches:
  1703. #          - memory cache - fastest, but limited by amount of RAM
  1704. #          - raw disk cache - fast, only limited by disk space
  1705. #          - file cache - slowest, but convenient
  1706. #
  1707. #        For raw disk and file caches, the htcformat utility must be used
  1708. #        to set up the devices and/or files. The CacheDev and BlockSize 
  1709. #        directives need to be specified. Multiple CacheDev directives can be
  1710. #        specified, mixing both file caches and raw disk caches if needed,
  1711. #        and the total space from those devices will be used as single
  1712. #        cache. For disk (rather than memory) caches, the CacheMemory
  1713. #        directive can still be used to tell the proxy how much memory it
  1714. #        can use to efficiently manage the disk cache. CacheMemory should
  1715. #        be set to at least 1% of the total size of the disk cache.
  1716. #
  1717. #        For a memory cache, simply specify the CacheMemory directive for the
  1718. #        desired cache size, and do not specified any CacheDev directives.
  1719. #
  1720. #        The minimum cache size allowed is 16392 K (16 M + 1 block), which
  1721. #        can be either 16392 K of a memory cache, or a single cache device
  1722. #        of 16392 K. This value is also the minimum size for a single cache
  1723. #        device, so you cannot specify two devices that add up to only
  1724. #        16392 K.
  1725. #
  1726. #        Default:  OFF
  1727. #        Syntax:   Caching <ON | on | OFF | off>
  1728.  
  1729. #WES
  1730. #************R E A D    T H I S**********************
  1731. #For our testing purposes, caching has been turned off.  For real world
  1732. #applications, you will probably want to utilize caching.  
  1733.  
  1734. Caching OFF
  1735.  
  1736.  
  1737. #       CacheDev directive:
  1738. #
  1739. #       Specify the cache device(s) to be used for the cache. The minimum
  1740. #       size for an individual cache device is 16392 K.
  1741. #
  1742. #       Default:  none
  1743. #       Syntax:   CacheDev <raw disk partition | file>
  1744. #
  1745. #       Examples:  CacheDev /dev/rwtecache
  1746. #                  CacheDev /wtecache/filecache1
  1747.  
  1748. #CacheDev /dev/rwtecache
  1749.  
  1750.  
  1751. #        CacheMemory directive:
  1752. #
  1753. #        Specify the amount of RAM associated with the cache. See the 
  1754. #        explanations in the Caching section above for more information
  1755. #        about the use of this directive. If the proxy needs more memory
  1756. #        than is specified for this directive, it will use what it needs
  1757. #        and send a warning message indicating this to the EventLog when
  1758. #        the proxy starts up and initializes the cache. There is more
  1759. #        memory overhead per cache device, so memory utilization is more
  1760. #        efficient for fewer cache devices. As a guideline, memory
  1761. #        utilization is also better for larger caches (1 G and up) than
  1762. #        for smaller caches. With a cache device over 1 G in size, the
  1763. #        amount of memory used will be approximately 1% of the total cache 
  1764. #        size. Each cache device uses a minimum of about 8.5 M of memory.
  1765. #
  1766. #        The unit specified can be B (bytes), K (kilobytes), M (megabytes),
  1767. #        or G (gigabytes). If you do not specify a unit, it assumes M.
  1768. #
  1769. #        Minimum for a memory cache: 16392 K
  1770. #        Minimum for a non-memory cache: 1 K
  1771. #        Default:  there is no default value, this must be specified
  1772. #        Syntax:   CacheMemory <size> B | K | M | G
  1773.  
  1774. CacheMemory 16392 K
  1775.  
  1776.  
  1777. #        BlockSize directive:
  1778. #
  1779. #        Specify the size (in bytes) of the blocks within the cache.
  1780. #        The same BlockSize value will be used for all devices specified 
  1781. #        via the CacheDev directives.
  1782. #
  1783. #        Default:  8192 (the only supported BlockSize is 8192 bytes)
  1784. #        Syntax:   BlockSize <size>
  1785.  
  1786. #BlockSize 8192
  1787.  
  1788.  
  1789. #        CacheDefaultExpiry directive:
  1790. #
  1791. #        Specify the expiry date for files which do not include an explicit
  1792. #        expiry date and do not have a last-modified date that would allow us
  1793. #        to compute an expiry based on the CacheLastModifiedFactor. This is
  1794. #        most useful for protocols that do not have any way to transmit this
  1795. #        information, such as FTP or Gopher.
  1796. #
  1797. #        NOTE: The default expiration for HTTP is 0. HTTP should be kept at 0
  1798. #              because many script programs don't give an expiration date, yet
  1799. #              their output expires immediately. A value other than zero may
  1800. #              cause problems.
  1801. #
  1802. #        Defaults:  http:*    0 days
  1803. #                   ftp:*     1 day
  1804. #                   gopher:*  2 days
  1805. #        Syntax:    CacheDefaultExpiry <URL pattern> <time period>
  1806. #
  1807. # Example: set default expiration for all FTP files to 14 days
  1808. # CacheDefaultExpiry ftp:*   1 fortnight
  1809.  
  1810. CacheDefaultExpiry     http:*         0 days
  1811. CacheDefaultExpiry     ftp:*          1 day
  1812. CacheDefaultExpiry     gopher:*       2 days
  1813.  
  1814.  
  1815. #        CacheRefreshInterval directive:
  1816. #
  1817. #        This directive specifies when to revalidate - check with the
  1818. #        origin to see if they've changed - documents. The difference
  1819. #        between this directive and CacheClean (below) is that CacheClean
  1820. #        will cause documents to be removed from the cache after a
  1821. #        given period of time, while CacheRefreshInterval will just
  1822. #        force the proxy to revalidate them before using them.
  1823. #
  1824. #        Defaults:  2 weeks for all documents
  1825. #        Syntax:    CacheRefreshInterval <URL pattern> <time period>
  1826. #                       - This form specifies the refresh interval for
  1827. #                         and URLs matching <URL pattern>
  1828. #                   CacheRefreshInterval pattern> <time period>
  1829. #                       - This specifies the refresh interval for any
  1830. #                         documents NOT matching a <URL pattern> in
  1831. #                         another CacheRefreshInterval directive - in
  1832. #                         other words, the default refresh interval.
  1833. #
  1834. # Example: refresh all .gif images after 8 hours, and all other documents
  1835. # after a week.
  1836. # CacheRefreshInterval *.gif 8 hours
  1837. # CacheRefreshInterval 1 week
  1838.  
  1839. CacheRefreshInterval 2 weeks
  1840.  
  1841.  
  1842. #        CacheUnused directive:
  1843. #
  1844. #        Specify how long the proxy cache should keep files which have not
  1845. #        been used (requested by a client). Unused files which have been in
  1846. #        the cache longer than this will be removed during garbage collection.
  1847. #
  1848. #        Default:  2 days  for http:*
  1849. #                  3 days  for ftp:*
  1850. #                 12 hours for gopher:*
  1851. #        Syntax:   CacheUnused <URL pattern> <time period>
  1852.  
  1853. CacheUnused http:*    2 days
  1854. CacheUnused ftp:*     3 days
  1855. CacheUnused gopher:* 12 hours
  1856.  
  1857.  
  1858. #        CacheExpiryCheck directive:
  1859. #
  1860. #        Normally, a caching proxy will check that the files in its cache
  1861. #        have not expired. In special circumstances (such as a network outage)
  1862. #        you may want to disable this check; the proxy will then serve files
  1863. #        from its cache even if they're out of date.
  1864. #
  1865. #        Default: on
  1866. #        Syntax:  CacheExpiryCheck <on | off>
  1867.  
  1868. CacheExpiryCheck on
  1869.  
  1870.  
  1871. #        CacheNoConnect directive:
  1872. #
  1873. #        In normal situations, the proxy server will contact the content
  1874. #        server to fetch pages. However, in special situations (such as
  1875. #        a demonstration at a trade show), you may not want the proxy server
  1876. #        to try to contact the origin server. Setting CacheNoConnect "on"
  1877. #        prevents the proxy from contacting the origin server.
  1878. #
  1879. #        Default: off
  1880. #        Syntax:  CacheNoConnect <on | off>
  1881.  
  1882. CacheNoConnect off
  1883.  
  1884.  
  1885. #        CacheTimeMargin directive:
  1886. #
  1887. #        The proxy server will not cache documents which are due to expire
  1888. #        'soon'. This directive defines what 'soon' is. In other words, a
  1889. #        document's expiry date must be further in the future than the
  1890. #        CacheTimeMargin when WTE receives it in order for it to be cached.
  1891. #
  1892. #        Default: 10 minutes
  1893. #        Syntax:  CacheTimeMargin <time period>
  1894.  
  1895. CacheTimeMargin  10 minutes
  1896.  
  1897.  
  1898. #        CacheLastModifiedFactor directive:
  1899. #
  1900. #        Use this directive to have the server set expirations for files which
  1901. #        have a Last-Modified date, but no Expires date. The server uses the
  1902. #        Last-Modified date to determine how long it has been since the file
  1903. #        was modified, then multiplies that time by the fraction specified by
  1904. #        the value on this directive to determine the proportion of a file's
  1905. #        age (LastModified) to be used as the expiry time. The assumption
  1906. #        is that files that have changed recently are probably changing
  1907. #        frequently, while files that have not been modified in some time have
  1908. #        stablizied and do not need to be refreshed as frequently.
  1909. #
  1910. #        The higher this value is set, the longer these files will reside in
  1911. #        the cache without being checked for freshness. Setting this value too
  1912. #        high may cause stale (out-of-date) files to be served from cache.
  1913. #
  1914. #        For example, if a file was last modified 1 month ago and
  1915. #        CacheLastModifiedFactor was set to 0.5, the file would expire in
  1916. #        approximately 15 days (half a month).  If the file was changed 4 days
  1917. #        ago, and CacheLastModifiedFactor was set to 0.25, the file would
  1918. #        expire in 1 day.
  1919. #
  1920. #        If a CacheLastModifiedFactor of -1 is specified, the file
  1921. #        last-modified date will not be used to calculate the file expiry time.
  1922. #        This setting is not suggested for normal operation, as it will result
  1923. #        in very few files being cached.
  1924. #
  1925. #        Default: Numerous factors, based on file extensions. The defaults
  1926. #                 reflect the fact that certain types of files - like
  1927. #                 graphics - tend to have longer lifetimes.
  1928. #        Syntax:  CacheLastModifiedFactor <URL pattern> <fraction>
  1929. #
  1930. # Example:
  1931. # CacheLastModifiedFactor http://* 0.14
  1932. # CacheLastModifiedFactor ftp://*  0.25
  1933.  
  1934. CacheLastModifiedFactor http://*/ 0.10
  1935. CacheLastModifiedFactor http://*.htm* 0.20
  1936. CacheLastModifiedFactor http://*.gif 1.00
  1937. CacheLastModifiedFactor http://*.jpg 1.00
  1938. CacheLastModifiedFactor http://*.jpeg 1.00
  1939. CacheLastModifiedFactor http://*.png 1.00
  1940.  
  1941. CacheLastModifiedFactor http://*.tar 1.00
  1942. CacheLastModifiedFactor http://*.zip 1.00
  1943.  
  1944. CacheLastModifiedFactor http:* 0.15
  1945. CacheLastModifiedFactor ftp:*  0.50
  1946. CacheLastModifiedFactor     *  0.10
  1947.  
  1948. #        CacheMaxExpiry directive:
  1949. #
  1950. #        Specify the maximum lifetime allowed for objects matching a given
  1951. #        request template. An object may still be kept longer than its
  1952. #        maximum lifetime, but it must be revalidated with the origin
  1953. #        server when its lifetime has been reached. A maximum lifetime
  1954. #        of 0 is interpreted as no maximum - the lifetime will not have
  1955. #        an upper limit.
  1956. #
  1957. #        Note that it doesn't make much sense to set this higher than
  1958. #        CacheClean, as CacheClean specifies the maximum time an object can
  1959. #        remain in the cache before it is deleted.
  1960. #
  1961. #        Default: 1 month for all objects
  1962. #        Syntax:  CacheMaxExpiry <URL request template> <time spec>
  1963. #
  1964. # Example: .gif files may not have a lifetime longer than 2 weeks.
  1965. # CacheMaxExpiry http://*.gif 2 weeks
  1966.  
  1967. CacheMaxExpiry 1 month
  1968.  
  1969.  
  1970.  
  1971. #        CacheClean directive:
  1972. #
  1973. #        Specify how long you want the server to keep cached files with URLs
  1974. #        matching a given request template. The server deletes cached files
  1975. #        whose URLs match a given request template after they have been cached
  1976. #        for the specified time, regardless of their expiration date.
  1977. #
  1978. #        Default: 1 month for all objects
  1979. #        Syntax:  CacheClean <URL request template> <time spec>
  1980. # Example:
  1981. # CacheClean  http:*  2 weeks
  1982.  
  1983. CacheClean 1 month
  1984.  
  1985.  
  1986. #        CacheFileSizeLimit directive:
  1987. #
  1988. #        CacheFileSizeLimit specifies the maximum size for any file that will
  1989. #        be cached. The value can be specified in bytes (B), kilobytes (K),
  1990. #        megabytes (M), or gigabytes (G).
  1991. #
  1992. #        Note that in previous releases, this directive was called
  1993. #        CacheLimit_2. The syntax of the directive remains unchanged.
  1994. #
  1995. #        Default:  CacheFileSizeLimit  4000 K
  1996. #        Syntax:   CacheFileSizeLimit  <bytes> <B|K|M|G>
  1997. #
  1998. # Example: Don't cache any files larger than 512 K.
  1999. # CacheFileSizeLimit 512 K
  2000.  
  2001. CacheFileSizeLimit 4000 K
  2002.  
  2003.  
  2004. #        CacheOnly and NoCaching directives:
  2005. #
  2006. #        The server allows control over the files to be cached in two ways.
  2007. #
  2008. #        CacheOnly - specifies a set of URLs which will be considered for
  2009. #                    caching (URLs not in that list will never be cached)
  2010. #        NoCaching - specifies a set of URLs which must never be cached,
  2011. #                    (all other URLs are candidates for caching)
  2012. #
  2013. #        Default:  <none> (for both CacheOnly and NoCaching)
  2014. #        Syntax:   CacheOnly <URL pattern>
  2015. #                  NoCaching <URL pattern>
  2016. #
  2017. # Example:
  2018. # CacheOnly   http://www.ibm.com/*
  2019. # NoCaching   http://never.cache.me.net/*
  2020.  
  2021.  
  2022. #        ContinueCaching directive:
  2023. #
  2024. #        Specifies the point at which a file being received from a content
  2025. #        server will continue to be received from the content server and
  2026. #        stored in the cache even if the connection to the client which
  2027. #        requested the file has been terminated.  The value specified
  2028. #        represents a percentage of the size of the file being transferred.
  2029. #        If less than this percentage of the file has been transferred from
  2030. #        the content server at the time the client connection is terminated,
  2031. #        file transfer from the content server will be terminated and the cache
  2032. #        file containing the partial file will be removed from the cache.
  2033. #
  2034. #        Default: 75
  2035. #
  2036. #        Syntax:   ContinueCaching <percent of file already transferred>
  2037. #
  2038. # Example:
  2039. # ContinueCaching 75
  2040.  
  2041.  
  2042.  
  2043. # ===================================================================== #
  2044. #
  2045. #        Proxy cache garbage collection directives
  2046. #
  2047. # ===================================================================== #
  2048.  
  2049.  
  2050. #        Gc (Garbage Collection) directive:
  2051. #
  2052. #        In order for a caching proxy server to function efficiently, it
  2053. #        needs to sweep through the cache and remove out-of-date files on a
  2054. #        regular basis. This is called 'garbage collection'. It should only
  2055. #        be turned "off" in special circumstances, such as during an extended
  2056. #        network outage.
  2057. #
  2058. #        Default:  on
  2059. #        Syntax:   Gc <on | off>
  2060. Gc on
  2061.  
  2062.  
  2063.  
  2064. #        CacheAlgorithm directive:
  2065. #
  2066. #        Specifies which cache algorithm the server will use.  Choices
  2067. #        include: bandwidth, responsetime, and blend.  Specifying
  2068. #        bandwidth will rate cache files to minimize network bandwidth.
  2069. #        Choosing responsetime will rank cached files to minimize response
  2070. #        time.  The blend option will do a combination of the two.
  2071. #
  2072. #        Default:  bandwidth
  2073. #        Syntax:   CacheAlgorithm <string>
  2074. #                    where string is "bandwidth" | "responsetime" | "blend"
  2075. #
  2076. CacheAlgorithm bandwidth
  2077.  
  2078. #        GcHighWater directive:
  2079. #
  2080. #        When the cache fills up to the high-water mark, garbage collection
  2081. #        will begin. The high-water mark is specified as a percentage of the
  2082. #        total cache capacity. Garbage collection will continue until the
  2083. #        low-water mark has been reached - see GcLowWater to set this.
  2084. #        The high-water mark must not be set above 95%, and normally should
  2085. #        not be set below 50%.
  2086. #
  2087. #        Default:  90 (percent)
  2088. #        Syntax:   GcHighWater <percentage>
  2089. #
  2090. # Example: Start garbage collection when cache utilization reaches 85%
  2091. # GcHighWater 85
  2092. GcHighWater 90
  2093.  
  2094.  
  2095. #        GcLowWater directive:
  2096. #
  2097. #        Once cache garbage collection has begun, it will continue until
  2098. #        cache utilization reaches the low-water mark. The low-water mark is
  2099. #        specified as a percentage of the total cache capacity. The low-water
  2100. #        mark must be below the high-water mark; see the GcHighWater directive
  2101. #        for setting the high-water mark.
  2102. #
  2103. #        Default:  60 (percent)
  2104. #        Syntax:   GcLowWater <percentage>
  2105. #
  2106. # Example: End garbage collection when the cache reaches 75% full.
  2107. # GcLowWater 75
  2108. GcLowWater 60
  2109.  
  2110.  
  2111. # ===================================================================== #
  2112. #
  2113. #        Advanced proxy and caching directives
  2114. #
  2115. # ===================================================================== #
  2116.  
  2117.  
  2118. #        ProxyIgnoreNoCache directive:
  2119. #
  2120. #        Allows the proxy server to ignore the "Pragma: no-cache" header
  2121. #        (usually sent by browsers when the user hits the "Reload" button)
  2122. #        and serve the content from cache (if available) in defiance of
  2123. #        the client's request.
  2124. #
  2125. #        NOTE: This should ONLY be used in unusual circumstances.
  2126. #
  2127. #        Default:  off
  2128. #        Syntax:   ProxyIgnoreNoCache <on | off>
  2129. ProxyIgnoreNoCache  off
  2130.  
  2131.  
  2132. #        AggressiveCaching directive:
  2133. #
  2134. #        Allows the proxy server to cache responses which might not
  2135. #        ordinarily be cached, for example responses which contain
  2136. #        the "cache-control: no-cache" header.
  2137. #
  2138. #        Default: <none>
  2139. #        Syntax:  AggressiveCaching <URL pattern>
  2140. # Example:
  2141. # AggressiveCaching http://www.hosta.com/*
  2142.  
  2143.  
  2144. #        ProxySendClientAddress directive:
  2145. #
  2146. #        Instructs the proxy to forward an HTTP header containing the
  2147. #        client's IP address. If ProxySendClientAddress is not defined,
  2148. #        client IP addresses are NOT forwarded.
  2149. #
  2150. #        Default:  <none>
  2151. #        Syntax:   ProxySendClientAddress <HTTP header name>
  2152. #
  2153. #        NOTE: The Remote Configuration forms only support 2 options:
  2154. #              (1) client IP addresses NOT forwarded
  2155. #                  ProxySendClientAddress directive is removed
  2156. #              (2) client IP addresses ARE forwarded with Client-IP: header
  2157. #                  ProxySendClientAddress Client-IP:
  2158. #
  2159. # Example:
  2160. # ProxySendClientAddress Client-IP:
  2161.  
  2162.  
  2163. #        ProxyUserAgent directive:
  2164. #
  2165. #        Substitute a different User-agent string for the one that the client
  2166. #        sends. This helps make the clients more anonymous when surfing the web.
  2167. #        User-agent strings may include spaces.
  2168. #
  2169. #        NOTE: Some Web sites automatically generate different pages
  2170. #              for certain Web browsers (by looking at the User-Agent header),
  2171. #              so if you mask the identity of the browser, you won't be able
  2172. #              to see the pages that are customized for certain browsers.
  2173. #
  2174. #        Default:  <none>
  2175. #        Syntax:   ProxyUserAgent <string> (in the form "ProductName/Version")
  2176. #
  2177. # Example:
  2178. # ProxyUserAgent Mozilla/4.0 (emulation; Javelin/2.0)
  2179.  
  2180.  
  2181. #        ProxyFrom directive:
  2182. #
  2183. #        Specifies the "From:" header to send on all requests that
  2184. #        go through this proxy.
  2185. #
  2186. #        NOTE: Replaces the "From:" header sent by the client
  2187. #
  2188. #        Default:  <none>
  2189. #        Syntax:   ProxyFrom <string>
  2190. #
  2191. # Example:
  2192. # ProxyFrom  webmaster@www.ibm.com
  2193.  
  2194.  
  2195. #        NoProxyHeader directive:
  2196. #
  2197. #        Allows the proxy to block certain headers that clients send.
  2198. #
  2199. #        NOTE: Any HTTP header (even required headers) can be blocked
  2200. #              with this directive, so extreme care should be used.
  2201. #
  2202. #        Default:  <none>
  2203. #        Syntax:   NoProxyHeader <header>
  2204. #
  2205. # Example:
  2206. # NoProxyHeader Referer:
  2207.  
  2208.  
  2209. #        CacheMinHold directive:
  2210. #
  2211. #        Overrides the "Expires" tag on documents from certain sites.
  2212. #        These sites routinely force documents to expire immediately
  2213. #        even when they have a longer lifetime.
  2214. #
  2215. #        Default:  <none>
  2216. #        Syntax:   CacheMinHold <URL pattern> <time spec>
  2217. #
  2218. # Example:
  2219. # CacheMinHold  http://www.cachebusters.com/*  1 hour
  2220.  
  2221.  
  2222. #        CacheLocalDomain directive:
  2223. #
  2224. #        Allows local domain sites to be cached, when set "on".
  2225. #
  2226. #        NOTE: Assumes hostnames without a domain name are local.
  2227. #
  2228. #        Default:  on
  2229. #        Syntax:   CacheLocalDomain <on | off>
  2230. CacheLocalDomain  on
  2231.  
  2232.  
  2233. #        appendCRLFtoPost directive:
  2234. #
  2235. #        Some Origin servers require a Carriage Return and Line Feed to
  2236. #        be appended at the end of the content body on a POST request.
  2237. #        Use the appendCRLFtoPost directive to specify sites which should
  2238. #        have the CRLF appended at the end of the content body when sending
  2239. #        a POST request to the site.
  2240. #
  2241. #        Default:  <none>
  2242. #        Syntax:   appendCRLFtoPost <URL pattern>
  2243. #
  2244. # Example:
  2245. # appendCRLFtoPost   http://www.hosta.com/*
  2246.  
  2247.  
  2248. #        SendHTTP10outbound directive:
  2249. #
  2250. #        Specifies the HTTP version to be used on requests sent outbound
  2251. #        to the origin server or to the next proxy in a chain of proxies.
  2252. #        SendHTTP10outbound should only be used if the origin server
  2253. #        or next downstream proxy have known problems handling HTTP/1.1 requests.
  2254. #
  2255. #        Default:  <none>
  2256. #        Syntax:   SendHTTP10outbound <URL pattern>
  2257. #
  2258. #SendHTTP10outbound http://www.hosta.com/*
  2259.  
  2260. #SendHTTP10Outbound http://*.mail.yahoo.com/*
  2261.  
  2262.  
  2263. #        CacheQueries directive:
  2264. #
  2265. #        Specifies whether or not responses to queries should be cached.
  2266. #        If ALWAYS is specified, responses to queries will be cached as
  2267. #        long as the response is otherwise cacheable.
  2268. #        If PUBLIC is specified, responses to queries will be cached if
  2269. #        the response is marked as "public" by containing a
  2270. #        "cache-control: public header, or if the response contains
  2271. #        cache-control headers which will force re-validation on every request, and the
  2272. #        response is otherwise cacheable.
  2273. #
  2274. #        Default: <none>
  2275. #        Syntax:  CacheQueries <ALWAYS | PUBLIC> <URL Pattern>
  2276. #
  2277. # Example:
  2278. # CacheQueries ALWAYS http://www.hosta.com/*
  2279. # CacheQueries PUBLIC http://www.hostb.com/*
  2280.  
  2281.  
  2282. #        CacheByIncomingUrl directive:
  2283. #
  2284. #        Specifies whether to use the incoming URL or the outgoing URL as
  2285. #        the basis for generating cache file names.
  2286. #        If ON is specified, the incoming URL will be used to generate the
  2287. #        cache file name.  If OFF is specified, All applicable Name Translation
  2288. #        plug-ins and Map and Proxy rules will be applied to the incoming URL and
  2289. #        the resulting URL will be used to generate the cache name.
  2290. #
  2291. #        Default: OFF
  2292. #        Syntax:  CacheByIncomingUrl <on | off>
  2293. CacheByIncomingUrl off
  2294.  
  2295.  
  2296.  
  2297. # ===================================================================== #
  2298. #
  2299. #        RCA (Remote Cache Access) directives
  2300. #
  2301. # ===================================================================== #
  2302.  
  2303.  
  2304. #        Version directive:
  2305. #
  2306. #        Specify the protocol name and version.
  2307. #
  2308. #        Default:  <RCA/1.0>
  2309. #        Syntax:   Version  <protocol/major.minor>
  2310. Version    RCA/1.0
  2311.  
  2312.  
  2313. #        ArrayName directive:
  2314. #
  2315. #        Specify the name of this array.
  2316. #
  2317. #        NOTE: This is an administrative aid.
  2318. #              Spaces are not allowed in the array name.
  2319. #              This directive is required.
  2320. #
  2321. #        Default:  <none>
  2322. #        Syntax:   ArrayName  <array name>
  2323. # Example:
  2324. # ArrayName mastiff
  2325.  
  2326.  
  2327. #        Member directive:
  2328. #
  2329. #        Specify a member this array.
  2330. #
  2331. #        Default:  <none>
  2332. #        Syntax:   Member Name { subdirectives }
  2333. #
  2334. #                  Name         required; the hostname this member is known to
  2335. #                               clients by
  2336. #
  2337. #                  subdirectives are one of:
  2338. #                  RCAAddr      required; IP address or hostname for RCA
  2339. #                               communication
  2340. #                  RCAPort      required; port for RCA communication
  2341. #                  Timeout      ( milliseconds )
  2342. #                               optional; how long to wait for this member
  2343. #                               before deciding rigor mortis has occured;
  2344. #                               must be positive; default is 1000 ms
  2345. #                  BindSpecific ( On | Off )
  2346. #                               optional; allows communications to occur on a
  2347. #                               private subnet, providing a measure of security;
  2348. #                               default is ON
  2349. #                  ReuseAddr    ( On | Off )
  2350. #                               optional; allows faster rejoining of the array;
  2351. #                               "on" would allow other processes to steal the
  2352. #                               port, causing undefined behaviour;
  2353. #                               default is OFF
  2354. #
  2355. # Example:
  2356. # Member bittersweet.chocolate.ibm.com {
  2357. #     RCAAddr      127.0.0.1
  2358. #     RCAPort      6294
  2359. #     Timeout      1000 milliseconds
  2360. #     BindSpecific On
  2361. #     ReuseAddr    Off
  2362. # }
  2363.  
  2364.  
  2365.  
  2366.  
  2367.  
  2368.  
  2369. # ===================================================================== #
  2370. #
  2371. #        SNMP directives
  2372. #
  2373. # ===================================================================== #
  2374.  
  2375.  
  2376. #        SNMP directive:
  2377. #
  2378. #        Set SNMP communication on or off.
  2379. #
  2380. #        Default:  off
  2381. #        Syntax:   SNMP  <on | off>
  2382. SNMP   off
  2383.  
  2384.  
  2385. #        SNMPCommunity directive:
  2386. #
  2387. #        The community name which is used by the server to communicate
  2388. #        with the SNMP agent.
  2389. #
  2390. #        Default:  public
  2391. #        Syntax:   SNMPCommunity  <public | community name>
  2392. SNMPCommunity   public
  2393.  
  2394.  
  2395. #        WebMasterEMail directive:
  2396. #
  2397. #        The E-mail address of the person who should get communications
  2398. #        about this server
  2399. #
  2400. #        Default:  webmaster
  2401. #        Syntax:   WebMasterEMail bigguy@mybox.com
  2402. WebMasterEMail   webmaster
  2403.  
  2404.  
  2405. # ===================================================================== #
  2406. #
  2407. #        Icon directives
  2408. #
  2409. # ===================================================================== #
  2410.  
  2411.  
  2412. #        AddIcon, AddDirIcon, AddBlankIcon, AddUnknownIcon and AddParentIcon
  2413. #        directives:
  2414. #
  2415. #        AddIcon        - Bind icon URL to a MIME content-type or
  2416. #                         content-encoding.
  2417. #        AddDirIcon     - Specify directory icon URL for directory listing
  2418. #        AddBlankIcon   - Specify blank icon URL for directory listing
  2419. #        AddParentIcon  - Specify parent directory icon URL for directory
  2420. #                         listing
  2421. #        AddUnknownIcon - Specify unknown icon URL for directory listing
  2422. #
  2423. #        Default:  <default set of icons shown below>
  2424. #        Syntax:   AddIcon        <icon URL> <ALT text> <MIME-type template>
  2425. #        Syntax:   AddDirIcon     <icon URL> <ALT text>
  2426. #        Syntax:   AddBlankIcon   <icon URL> <ALT text>
  2427. #        Syntax:   AddParentIcon  <icon URL> <ALT text>
  2428. #        Syntax:   AddUnknownIcon <icon URL> <ALT text>
  2429. #
  2430. #        If the <icon URL> does not include a path, the server will prepend
  2431. #        the directory /icons/ to the icon filename. Note that the icon URL
  2432. #        is a virtual path; it will be sent through the mapping rules
  2433. #        (Map, Pass, etc) to find the real path in the filesystem.
  2434.  
  2435. AddIcon          app-123.gif      123    application/x-123
  2436. AddIcon          app-compress.gif Z      x-compress
  2437. AddIcon          app-compress.gif gz     x-gzip
  2438. AddIcon          app-fl.gif       FL     application/x-freelance
  2439. AddIcon          app-pcl.gif      PCL    application/x-pcl
  2440. AddIcon          app-pdf.gif      PDF    application/pdf
  2441. AddIcon          app-ps.gif       PS     application/postscript
  2442. AddIcon          app-shar.gif     shar   application/x-shar
  2443. AddIcon          app-bsh.gif      sh     application/x-bsh
  2444. AddIcon          app-csh.gif      csh    application/x-csh
  2445. AddIcon          app-ksh.gif      ksh    application/x-ksh
  2446.  
  2447. AddIcon          mp-tar.gif       tar    multipart/x-tar
  2448. AddIcon          mp-tar.gif       tar    multipart/x-ustar
  2449. AddIcon          mp-zip.gif       zip    multipart/x-zip
  2450.  
  2451. AddIcon          audio.gif        au     audio/basic
  2452. AddIcon          audio.gif        aiff   audio/x-aiff
  2453. AddIcon          audio.gif        wav    audio/x-wav
  2454. AddIcon          audio.gif        audio  audio/*
  2455.  
  2456. AddIcon          image-gif.gif    GIF    image/gif
  2457. AddIcon          image-jpeg.gif   JPEG   image/jpeg
  2458. AddIcon          image-pixmap.gif pixmap image/x-xpixmap
  2459. AddIcon          image-tif.gif    TIFF   image/tiff
  2460. AddIcon          image.gif        img    image/*
  2461.  
  2462. AddIcon          text-assem.gif   asm    text/x-asm
  2463. AddIcon          text-c.gif       c      text/x-c
  2464. AddIcon          text-html.gif    HTML   text/html
  2465. AddIcon          text-html.gif    HTML   text/x-ssi-html
  2466. AddIcon          text-uu.gif      UU     text/x-uuencode
  2467. AddIcon          text.gif         text   text/*
  2468.  
  2469. AddIcon          video-avi.gif    avi    video/x-msvideo
  2470. AddIcon          video-avi.gif    qt     video/quicktime
  2471. AddIcon          video-jpeg.gif   mjpg   video/x-motion-jpeg
  2472. AddIcon          video-mpeg.gif   mpeg   video/mpeg
  2473. AddIcon          video.gif        video  video/*
  2474.  
  2475. AddIcon          binary.gif       bin    application/octet-stream
  2476. AddIcon          binary.gif       bin    binary
  2477.  
  2478. AddBlankIcon     blank.gif
  2479. AddParentIcon    dir-up.gif       UP
  2480. AddDirIcon       dir.gif          DIR
  2481. AddUnknownIcon   unknown.gif      ???
  2482.  
  2483.  
  2484.  
  2485. # ===================================================================== #
  2486. #
  2487. #        Cache agent directives
  2488. #
  2489. # ===================================================================== #
  2490.  
  2491.  
  2492. #        UpdateProxy directive:
  2493. #
  2494. #        Specify which proxy server the cache agent should update.
  2495. #
  2496. #        NOTE: This directive is required for the cache agent to function on
  2497. #              on AIX, Solaris, and Linux systems. This directive is also
  2498. #              required when the cache agent needs to update a proxy server
  2499. #              other than the local proxy server on which it is running.
  2500. #
  2501. #        Default:  <host on which the cache agent is running>
  2502. #        Syntax:   UpdateProxy <fully-qualified host name of the proxy server>
  2503. # Example:
  2504. # UpdateProxy www.raleigh.ibm.com
  2505.  
  2506.  
  2507. #        LoadURL directive:
  2508. #
  2509. #        Specify URLs to be loaded into the cache.
  2510. #
  2511. #        NOTE: These URLs are placed at the top of the cache agent's queue.
  2512. #
  2513. #        Default:  <none>
  2514. #        Syntax:   LoadURL  <URL to load>
  2515. # Example:
  2516. # LoadURL http://www.ibm.com/
  2517.  
  2518.  
  2519. #        LoadTopCached directive:
  2520. #
  2521. #        Specify that the cache agent should load the specified number of
  2522. #        most popular URLs to the cache.
  2523. #
  2524. #        NOTE: These URLs are queued below the URLs loaded by the
  2525. #              LoadURL directive
  2526. #
  2527. #        Default:  100
  2528. #        Syntax:   LoadTopCached  <num to load>
  2529. #
  2530. #        NOTE: In order to use this directive, the server configuration
  2531. #              file MUST specify Caching "on" and have a valid values 
  2532. #              for the cache location and size 
  2533. #
  2534. LoadTopCached 100
  2535.  
  2536.  
  2537. #        IgnoreURL directive:
  2538. #
  2539. #        Specify URLs that are NOT to be retrieved by the cache agent.
  2540. #        This directive applies only to delving performed by the cache
  2541. #        agent. If you wish for the proxy server not to cache certain
  2542. #        URLs, then see the NoCache directive.
  2543. #        This directive may be specified multiple times.
  2544. #
  2545. #        NOTE: Wild cards "*" may be used.
  2546. #
  2547. #        Default:  */cgi-bin/*    (Ignore URLs containing /cgi-bin/)
  2548. #        Syntax:   IgnoreURL  <URL to ignore>
  2549. # Example:
  2550. # IgnoreURL http://www.yahoo.com/*
  2551. # IgnoreURL http://www.yahoo.com/*.html
  2552. #
  2553. IgnoreURL */cgi-bin/*
  2554.  
  2555.  
  2556. #        DelveInto directive:
  2557. #
  2558. #        Specify whether or not the cache agent should load pages
  2559. #        linked off of cached URLs.
  2560. #
  2561. #        Default:  always
  2562. #        Syntax:   DelveInto <always | never | admin | topn>
  2563. #
  2564. #          always - the cache agent will parse the HTML of cached
  2565. #                   URLs and retrieve linked pages.
  2566. #          never  - the cache agent will not parse the HTML of
  2567. #                   cached URLs.
  2568. #          admin  - the cache agent will only parse HTML documents that
  2569. #                   originated from one of the LoadURL directives.
  2570. #          topn   - the cache agent will only parse HTML documents that
  2571. #                   were chosen from the server's cache.
  2572. DelveInto always
  2573.  
  2574.  
  2575. #        DelveDepth directive:
  2576. #
  2577. #        Specify the number of link levels to follow when searching
  2578. #        for pages to load into the cache.
  2579. #
  2580. #        NOTE: Applicable when DelveInto "always" is specified.
  2581. #
  2582. #        Default:  1
  2583. #        Syntax:   DelveDepth <num>
  2584. DelveDepth 1
  2585.  
  2586.  
  2587. #        DelveAcrossHosts directive:
  2588. #
  2589. #        Specify whether the cache agent will only retrieve pages
  2590. #        found on this server, or if the cache agent will retrieve
  2591. #        pages from other hosts.
  2592. #
  2593. #        NOTE: Applicable when DelveInto "never" is NOT specified.
  2594. #
  2595. #        Default:  off
  2596. #        Syntax:   DelveAcrossHosts <on | off>
  2597. DelveAcrossHosts off
  2598.  
  2599.  
  2600. #        DelayPeriod directive:
  2601. #
  2602. #        Specify whether the cache agent should wait between sending
  2603. #        requests to destination servers.
  2604. #
  2605. #        Default:  on
  2606. #        Syntax:   DelayPeriod <on | off>
  2607. #
  2608. #          on  - reduces the load on the proxy machine and your
  2609. #                network link, as well as being kinder to the
  2610. #                destination servers.
  2611. #          off - allows the cache agent to run at maximum speed.
  2612. #
  2613. #        NOTE: When DelayPeriod off, certain sites will be
  2614. #              accessed very often in rapid succession.
  2615. DelayPeriod on
  2616.  
  2617.  
  2618. #
  2619. #       LoadInlineImages directive:
  2620. #
  2621. #       Indicate whether inline images should be retrieved by the
  2622. #       cache agent.
  2623. #
  2624. #       Default:  on
  2625. #       Syntax:   LoadInlineImages <on | off>
  2626. LoadInlineImages on
  2627.  
  2628.  
  2629. #        NumClients directive:
  2630. #
  2631. #        Specify the number of worker threads to use to request pages.
  2632. #
  2633. #        NOTE: Increase this number for a fast machine and a fast
  2634. #              Internet link.  Use a smaller number for a slow
  2635. #              machine or a slow Internet link.
  2636. #
  2637. #        Default:  4
  2638. #        Syntax:   NumClients <num>  (maximum of 100)
  2639. NumClients 4
  2640.  
  2641.  
  2642. #        MaxQueueDepth directive:
  2643. #
  2644. #        Specify the maximum depth of the cache agent's queue of
  2645. #        outstanding page retrieval requests. Specifying a larger
  2646. #        number creates a larger queue.
  2647. #
  2648. #        NOTE: Only applicable when DelveInto "always" is specified,
  2649. #              otherwise, MaxQueueDepth will be set equal to the
  2650. #              value specified on the MaxUrls directive.
  2651. #
  2652. #        Default:  250
  2653. #        Syntax:   MaxQueueDepth <num of queue entries>
  2654. # Example:
  2655. # MaxQueueDepth 500
  2656. MaxQueueDepth 250
  2657.  
  2658.  
  2659. #        MaxUrls directive:
  2660. #
  2661. #        Specify the maximum number of URLs the cache agent will
  2662. #        request during a particular run.
  2663. #
  2664. #        Default:  2000
  2665. #        Syntax:   MaxUrls <num>
  2666. MaxUrls 2000
  2667.  
  2668.  
  2669. #        MaxRuntime directive:
  2670. #
  2671. #        Specify the maximum amount of time that the cache agent
  2672. #        will continue requesting URLs.
  2673. #
  2674. #        NOTE: A value of 0 means "no limit" - the request runs
  2675. #              until completion.
  2676. #
  2677. #        Default:  2 hours
  2678. #        Syntax:   MaxRuntime  0 | [<num> hours [<num> minutes]]
  2679. # Example:
  2680. # MaxRuntime 4 hours
  2681. # MaxRuntime 4 hours 10 minutes
  2682. MaxRuntime 2 hours
  2683.  
  2684.  
  2685. #        AutoCacheRefresh directive:
  2686. #
  2687. #        Specify whether or not cache content will be refreshed
  2688. #        automatically. If this is set to OFF, the cache agent
  2689. #        will not be invoked (and all its settings will be ignored).
  2690. #
  2691. #        Default:  on
  2692. #        Syntax:   AutoCacheRefresh <on | off>
  2693. AutoCacheRefresh on
  2694.  
  2695.  
  2696. #        CacheRefreshTime directive:
  2697. #
  2698. #        Specify when the cache agent should be started.
  2699. #
  2700. #        Default:  3:00 AM
  2701. #        Syntax:   CacheRefreshTime <HH:MM>
  2702. #
  2703. # Example: Begin cache refresh at 3:50 AM
  2704. # CacheRefreshTime 03:50
  2705. CacheRefreshTime 03:00
  2706.  
  2707.  
  2708. # ===================================================================== #
  2709. #
  2710. #        PICS Filtering directives
  2711. #
  2712. # ===================================================================== #
  2713.  
  2714.  
  2715. #        PICS Filtering using PICSRules
  2716. #
  2717. #        For a complete specification of PICSRules, see the URL
  2718. #        http://www1.raleigh.ibm.com/pics/PICSRules_1.0.html.
  2719. #
  2720. #        Default:  "See Example below"
  2721. #        Syntax:   DefinePicsRule "filterName" {
  2722. #                                    (PicsRule-1.0
  2723. #                                       (
  2724. #                                        ...subdirectives...(not required)
  2725. #                                        serviceinfo (name "serviceURL"
  2726. #                                                     shortname "shortName"
  2727. #                                                     bureau "bureauURL"
  2728. #                                                     ratfile "ratFile"
  2729. #                                                     available-with-content "NO"
  2730. #                                                     )
  2731. #                                        passURL ()
  2732. #                                        failURL ()
  2733. #                                       )
  2734. #                                    )
  2735. #                  }
  2736. #
  2737. #        NOTE: Be sure to specify only one rule per DefinePicsRule {...}
  2738. #              Each rule should begin with a DefinePicsRule "filterName" {
  2739. #              and end with a closing "}".
  2740. #
  2741. # Example:
  2742. DefinePicsRule "RSAC Example" {
  2743.     (PicsRule-1.0
  2744.         (
  2745.             serviceinfo (
  2746.                         name "http://www.rsac.org/ratingsv01.html"
  2747.                         shortname "RSAC"
  2748.                         available-with-content "YES"
  2749.                         )
  2750.             name        (
  2751.                         rulename "RSAC Example"
  2752.                         description "Example rule using the RSAC system to block naughty pictures."
  2753.                         )
  2754.             passURL     ("http://www.ibm.com/*")
  2755.             optextension (extension-name "http://www1.raleigh.ibm.com/pics/PICSRules_1.0.html")
  2756.             ibm-javelin-extensions (
  2757.                                active "no"
  2758.                                )
  2759.             Filter ( Pass '((RSAC.v < 3) && (RSAC.s < 3) && (RSAC.n < 3) && (RSAC.l < 3))' )
  2760.         )
  2761.     )
  2762. }
  2763.  
  2764.  
  2765. #        HTTPSCheckRoot directive:
  2766. #
  2767. #        Whether or not to check the unsecure homepage for self-labels and
  2768. #        apply them to a secure request for the same host.
  2769. #
  2770. #        Default:  on
  2771. #        Syntax:   HTTPSCheckRoot <on | off>
  2772. HTTPSCheckRoot on
  2773.  
  2774.  
  2775.  
  2776. # ===================================================================== #
  2777. #
  2778. #        SSL Directives
  2779. #
  2780. # ===================================================================== #
  2781.  
  2782. #WES
  2783. #******** R E A D   T H I S   F O R   S S L***********************
  2784. #For an explanation of how to set up the Reverse Proxy for use with SSL, please refer to 
  2785. #the SSL documentation located at 
  2786. #http://www.ibm.com/software/webservers/perfpack/doc2/wtewg/wtewgssl.htm
  2787. #
  2788. #To setup SSL with reverse proxy (AP mode) you need to check for the following:  
  2789. # SSL Enable is on
  2790. # KeyRing is set to the .kdb file containing your certificates
  2791. # KeyRingStash is set to the keystash        
  2792. # Enable CONNECT line is present
  2793. #
  2794. # To access an SSL page when using reverse proxy (AP mode)
  2795. # refer to the page as follows:
  2796. # https://proxyserver/secure/page.html
  2797. # This example assumes that you have a proxy statement set to point
  2798. # /secure/* to the real secure page.
  2799. #
  2800. # From the client browser, accessing an outside secure page, you should see
  2801. # the certificate from the Reverse Proxy machine, not the certificate from the remote site.
  2802. # The Reverse Proxy machine must trust the certificate of the remote site.  This is
  2803. # done in the gsk4ikm program and is addressed in the documentation referenced
  2804. # above.
  2805.  
  2806. #        SSLEnabled directive:
  2807. #
  2808. #        Specifies to listen on Port 443 for secure requests.
  2809. #
  2810. #        Default:  OFF
  2811. #        Syntax:   SSLEnable <ON | on | OFF | off>
  2812. SSLEnable OFF
  2813. #SSLEnable ON
  2814.  
  2815.  
  2816. #        SSLCaching directive:
  2817. #
  2818. #        In a reverse proxy scenario, attempt to cache content on
  2819. #        a secure request.  Caching must be enabled for this
  2820. #        directive to be effective.
  2821. #
  2822. #        Default:  off
  2823. #        Syntax:   SSLCaching <on | off>
  2824. SSLCaching off
  2825.  
  2826. #       SSL Version Specification
  2827. #    
  2828. #       Specifies the SSL Version to use - Either SSLV3 or SSLV2.
  2829. #       Syntax: SSLVersion <SSLV2> | <SSLV3> | <ALL> 
  2830. #       Default: <ALL>
  2831. #
  2832. SSLVersion     SSLV3
  2833.  
  2834. #        SSLV3Timeout
  2835. #
  2836. #        The time in seconds allowed before an SSL V3 session will expire.
  2837. #
  2838. #        Default:  100
  2839. #        Valid range:  1 - 86400 seconds (1 day)
  2840. #        Syntax:   SSLV3Timeout  <seconds>
  2841. SSLV3Timeout 100
  2842.  
  2843. #        SSLV2Timeout
  2844. #
  2845. #        The time in seconds allowed before an SSL V2 session will expire.
  2846. #
  2847. #        Default:  100
  2848. #        Valid range:  1 - 100 seconds
  2849. #        Syntax:   SSLV2Timeout  <seconds>
  2850. #SSLV2Timeout 100
  2851.  
  2852. #        KeyRing directive:
  2853. #
  2854. #        Specifies the file path to the Key Ring Database the server will
  2855. #        use for SSL requests.  Key Ring Files are generated via the
  2856. #        IKeyman utility.
  2857. #
  2858. #        Default:  none
  2859. #        Syntax:   KeyRing <filename>
  2860. #
  2861. # Example:
  2862. # KeyRing /etc/key.kdb
  2863.  
  2864.  
  2865.  
  2866. #        KeyRingStash directive:
  2867. #
  2868. #        Specifies the file path to the Key Ring Database's password file.
  2869. #        The password file is generated via the IKeyman utility when building
  2870. #        a Key Ring Database File.
  2871. #
  2872. #        Default:  none
  2873. #        Syntax:   KeyRingStash <filename>
  2874. #
  2875. # Example:
  2876. # KeyRingStash /etc/key.sth
  2877.  
  2878. #       SSL V3 Cipherspecs
  2879. #       The Cipherspecs allowed for SSL V3
  2880. #
  2881. #    Syntax:
  2882. #      V3CipherSpecs <cipherspec string>
  2883. #       Default:  US: "0A09060564620403020100" Export: "0906646203020100"
  2884. #       
  2885. #V3CipherSpecs  0A0605
  2886.  
  2887. #       SSL V2 Cipherspecs
  2888. #       The Cipherspecs allowed for SSL V2
  2889. #
  2890. #    Syntax:
  2891. #      V2CipherSpecs <cipherspec string>
  2892. #       Default:  US: "137624" Export: "246"
  2893. #
  2894. #V2CipherSpecs         176
  2895.  
  2896.  
  2897.  
  2898.  
  2899.  
  2900. # ===================================================================== #
  2901. #
  2902. #        Miscellaneous directives
  2903. #
  2904. # ===================================================================== #
  2905.  
  2906.  
  2907. #        ConfigFile directive:
  2908. #
  2909. #        Specifies the name of an additional configuration file. Directives
  2910. #        found in the specified configuration file will be processed after
  2911. #        processing the current configuration file.
  2912. #
  2913. #        For backwards compatability, the directive 'RCAConfigFile' is
  2914. #        supported as an alias for ConfigFile.
  2915. #
  2916. #        Default:  none
  2917. #        Syntax:   ConfigFile <filename>
  2918. #
  2919. # Example:
  2920. # ConfigFile /etc/rca.conf
  2921.  
  2922.  
  2923. #        FTPUrlPath directive:
  2924. #
  2925. #        Specifies whether FTP url paths should be treated as absolute
  2926. #        paths (specified in relation to the root directory) or as
  2927. #        relative paths (specified in relation to the home directory)
  2928. #
  2929. #        Default: absolute
  2930. #
  2931. #        Syntax:  FTPUrlPath <absolute | relative>
  2932. #
  2933. # Example:
  2934. # FTPUrlPath absolute
  2935.  
  2936.  
  2937. #        flexibleSocks directive:
  2938. #
  2939. #        Whether or not to use a socks conifiguration file to specify
  2940. #        hosts for direct connections or connections to a socks server.
  2941. #
  2942. #        Default:  on
  2943. #        Syntax:   flexibleSocks <on | off>
  2944. flexibleSocks  on
  2945.  
  2946.  
  2947. #        TransparentProxy directive:
  2948. #
  2949. #        Specifies if the server is to be run as a transparent proxy server.
  2950. #
  2951. #        Default:  off
  2952. #        Syntax:   TransparentProxy <on | off>
  2953. TransparentProxy off
  2954.  
  2955.  
  2956. #        ListenBacklog directive:
  2957. #
  2958. #        Specifies the size of the listen backlog to use for the socket
  2959. #        the proxy server listens with.
  2960. #
  2961. #        Default:  128
  2962. #        Syntax:   ListenBacklog <value>
  2963. ListenBacklog 128
  2964.  
  2965.  
  2966. #        PacFilePath directive:
  2967. #
  2968. #        Specifies the directory containing the PAC files
  2969. #        generated using the remote config PAC file form.
  2970. #
  2971. #        Default:  /opt/IBMWTE/usr/internet/server_root/pub/pacfiles
  2972. #        Syntax:   PacFilePath <filepath>
  2973. PacFilePath   /opt/IBMWTE/usr/internet/server_root/pub/pacfiles
  2974.