2.2 Oracle Web Listener的配置参数

Oracle WebServer提供基于HTML的管理工具，可以被任何支持表格的浏览器。此工具
估计了WebServer管理员大多数情形下手工修改Web Listener的配置文件，包括了每个
参数的解释帮助文本。管理工具在"Oracle WebServer管理员工具"中描
述，本节为那些想手工编辑文件的管理员，提供了配置文件的全部参数的文档，

Web Listener 配置文件分为节，以方括号内的节名开始，例如[NetInfo]。每个配
置参数由name = value对设置，配置参数在等号左边，值在右边。

　例如，看下面的配置文件的一部分：

　　　　　　　　　　　　　　　 ;
　　　　　　　　　　　　　　　 ; www.acme.com configuration file
　　　　　　　　　　　　　　　 ;
　　　　　　　　　　　　　　　 [NetInfo]
　　　　　　　　　　　　　　　 HostName = www.acme.com
　　　　　　　　　　　　　　　 HostAddress = ANY
　　　　　　　　　　　　　　　 PortNumber = 80

　表2 - 1 含有按逻辑功能分组的参数。
　

节参数名	缺省值	描述
NetInfo HostName	none	Web Listener所处的主机名，使用主　　　　　　 机全名，例如www.acme.com，若不指　　　　　　 定主机名， Listener使用主因特网　　　　　　 地址。
HostAddress	ANY	Web Listener所在的多主主机接收哪　　　　　　 些因特网地址的连接。ANY表示所有　　　　　　 的接口(IP地址)的连接都接受。除非　　　　　　 你有特定的需要进行改变，让它为　　　　　　 ANY 。
PortNumber	80	Web Listener在哪个TCP/IP端口接收　　　　　　 请求。 注意低于1024的端口要求Web　　　　　　 Listener在UNIX系统上作为root运　　　　　　 行。80是Web HTTP服务器的通常缺省　　　　　　 值。
MaxConnectCount	50	用户同时连接的最大数量。Web Listener忽略超过次限制的请求。注意：每个平台　　　　　　 有个编译时确定的不可超越的限制，而无　　　　　　 论这里指定什么值。
DNSResolution	NEVER	控制DNS的名字解析。若设为ALWAYS, Web　　　　　　 Listener总将地址翻译为名称。若设为　　　　　　 LAZY，Web Listener根据需要解析名字。　　　　　　 若设为LAZY_WITH_CGI，Web Listener根据　　　　　　 CGI程序的需要解析。若设为NEVER，Web　　　　　　　 Listener 即使请求也不做解析（这提供最　　　　　　 好的性能）。
SERVERPID	none	存放 Web Listener进程号(PID)的文件的名称。

Table 2 - 1. Oracle Web Listener 网络配置参数
　

Logging Configuration Parameters 日志配置参数

　

节参数名	缺省值	描述
[Log] LogDir	none	包含日志文件的目录名。此目录必须在Web　　　　　　　 Listener启动之前已存在。
LogInfoFile	none	存储例程日志的文件名
LogErrorFile	none	存储出错日志的文件名。

Table 2 - 2. Oracle Web Listener 日志配置参数

　注意: 确保Web Listener所运行的用户拥有对日志文件目录的读写权。
　

Directory目录映射参数 Mapping Parameters

　Directory_Name　 R|N|C　　 Virtual_Path_Name

• 左边目录名为在Web Listener文件系统上的物理目录名。

• R|N|C控制选择为目录名如何被解释。

• R 表示嵌套映射，目录是带子目录的树，所有子目录都映射为以指定虚路径 开头的一个树。

• N 表示只映射指定的目录自己，不映射子目录。

• C 表示目录包含CGI程序而不是将被传输的文件。

• Virtual_Path_Name是此目录在Web上显示的位置。

　　　　　　　 ;
　　　　　　　 ; directory mapping section of Web Listener configuration file
　　　　　　　 ;
　　　　　　　 [DirMaps]
　　　　　　　 c:\html　　 R　　　　 /

File Cache Definitions 文件缓存定义　

如果一个文件未在这里列出，它就不会被缓存。客户端请求一个非缓存的文件时，服
务器只在客户端涉及此文件时，才使用资源访问它。一旦客户端不再指向该文件时，
服务器就释放访问该文件所要求的资源。

　 有三个指定文件缓存的选项。

• 显式地给出文件名

• 以星号结尾的不完全的文件名可用于指明所有与星号前部分匹配的文件都被缓 存。

• 指定目录，它的所有文件和子目录都被缓存。

　　　　　　　 ;
　　　　　　　 ; File Cache Definitions
　　　　　　　 ;
　　　　　　　 [FileCache]
　　　　　　　 /index.html
　　　　　　　 /marketing/a*
　　　　　　　 /products

Encoding Definitions 编码定义　

　　　　　　　 ;
　　　　　　　 ; encoding definitions
　　　　　　　 ; List for each combination of encodings
　　　　　　　 ; one or more unique extensions
　　　　　　　 ;
　　　　　　　 [Encodings]
　　　　　　　 compress　　　　　　　 Z
　　　　　　　 gzip　　　　　　　　　　　 gz

MIME Types Definitions MIME类型定义　

注意缺省认为是MIME类型application/octet-stream 的文件不会映射成任何类型。
　 本节的每一行的组成如下：

MIME-type　　　　　　　　　　　　　　 list of file extensions mapping to that type

　　　　　　　 [MIMEType]
　　　　　　　 text/html　　　　　　 htm html
　　　　　　　 image/jpeg　　　　　 jpg jpeg
　　　　　　　 image/gif　　　　　　 gif

• htm 和 html 视为 MIME 类型 text/html

• jpg 和 jpeg 表明 image/jpeg 文件

• gif 表明它是一个 image/gif 文件

Language Extensions 语言扩展　

　 每行的构成为：

language_ID　　　　 character_set_ID　　　　　　　 list_of_file-extensions

　　　　　　　 [LangExt]
　　　　　　　 en　　　　　 iso-8859-1　　　　　 eng
　　　　　　　 en　　　　　 unicode-1-1　　　　 engU uc
　　　　　　　 fr-CA　　 iso-8859-1　　　　　 frc

　字符集的名称指定在RFC 1521中，语言标识符在RFC 1766中定义。

　 为了在Web Listener中使用语言映射能力，URL指定时不能跟扩展名。Web Listener 将增加相应的语言/字符集的扩展名，如果支持国家语言协商的话。
　For instance:
　 例如：
　http://www.oracle.com/index
如果客户端已设置加拿大法语为首选语言，则访问文件的结果为：
　/index.frc.html

客户端上可以配置一个语言列表，所以可以指定多种语言，并且如果他们之一出现，
就依据首先匹配的原则发送文件。如果文件的类型扩展名之前没有语言扩展名，此文
件被认为是语言中性的。缺省字符集为ISO-8859-1。

　 总结：如果文件 /index.frc.html 和 /index.html 都存在，指定加拿大法语为首选语
言的用户将得到文件的第一版，其它用户将得到第二版。
　

Basic and Digest Authentication Configuration

基本授权和Digest授权配置

　基本授权 和 Digest 授权在概念上是一致的。用用户名/口令组合列出用户，接着
指定那些用户属于哪些组。最终，组被分配到安全realm， realm为文件保护时指定
的参数。

　 基本授权与Digest授权的配置的区别在于，模块名使用 Basic还是 Digest 。
　 如果可能建议使用Digest授权 ，以防止口令在网络上被截获。
　 例如：
　

[Security]
　　　　　　　　　　　　　　　 Digest {
　　　　　　　　　　　　　　　　　　　　　　　 (Users)
　　　　　　　　　　　　　　　　　　　　　　　 jjones: glorkz
　　　　　　　　　　　　　　　　　　　　　　　 kmaco:　 plugh
　　　　　　　　　　　　　　　　　　　　　　　 ajames: foo

　　　　　　　　　　　　　　　　　　　　　　　 (Groups)
　　　　　　　　　　　　　　　　　　　　　　　 mktg:　　 ajames
　　　　　　　　　　　　　　　　　　　　　　　 dev:　　　 kmaco
　　　　　　　　　　　　　　　　　　　　　　　 all:　　　 jjones kmaco ajames

　　　　　　　　　　　　　　　　　　　　　　　 (Realms)
　　　　　　　　　　　　　　　　　　　　　　　 restricted:　　　　 all
　　　　　　　　　　　　　　　　　　　　　　　 secret:　　　　　　　　 dev mktg
　　　　　　　　　　　　　　　 }

　 这种情形下，任何定义在restricted realm下的文件都可以被这里指定的三个用户
访问（但使用同一个Web Listener的其他人不行），任何ecret realm下的文件只能被
用户 ajames 和 kmaco访问。
　

网络(IP)地址和主机名限制配置

　 为包括一个或一组主机，在主机标志前标上加号(+)，排除它用减号(-)。另外，星号统配符可以用来匹配主机的组。
　 例如：
　

[Security]
　　　　　　　　　　　　　　　 IP {
　　　　　　　　　　　　　　　　　　　　　　　 st:　　　　 +144.25.16.*
　　　　　　　　　　　　　　　　　　　　　　　　　　　　　　　 +144.25.20.*
　　　　　　　　　　　　　　　　　　　　　　　 dc:　　　　 +130.35.*.*
　　　　　　　　　　　　　　　　　　　　　　　　　　　　　　　 -130.35.1.1
　　　　　　　　　　　　　　　 }

　 当域名限制的情形下，同样的技术用于主机名。
　
　 下例配置所有在域oracle.com 下的机器除了www.oracle.com外，都归oracle组：
　

[Security]
　　　　　　　　　　　　　　　 Domain {
　　　　　　　　　　　　　　　　　　　　　　　 oracle: +*.oracle.com
　　　　　　　　　　　　　　　　　　　　　　　　　　　　　　　 -www.oracle.com
　　　　　　　　　　　　　　　 }

Assigning Security to Individual Files 为独立文件赋安全设置

　 例如：
　

　　　　　　　 [Protection]
　　　　　　　 /secret/　　　　　　　　　　　　　　　 IP(st) | Basic(secret)
　　　　　　　 /company/*　　　　　　　　　　　　　 Domain(acme)

Oracle Web Listener 其它配置参数