Sun ONE logo      上一个      目录      索引      下一个     

Sun ONE Web Server 6.1 管理员指南

附录 A
命令行实用程序

本附录包含了如何使用 HttpServerAdmin 命令行实用程序的说明。


HttpServerAdmin(虚拟服务器管理)

HttpServerAdmin 是一个命令行实用程序,可以用来与 Server Manager 或 Class Manager 中的虚拟服务器用户界面执行相同的管理功能。如果您愿意使用命令行界面设置虚拟服务器,请使用 HttpServerAdmin


要使用 HttpServerAdmin 命令行实用程序,您必须具有系统的超级用户权限。


HttpServerAdmin 命令行实用程序位于 server_root/bin/https/httpadmin/bin 目录中。

运行 HttpServerAdmin 之前,您需要将环境变量 IWS_SERVER_HOME 设置为环境中的服务器根目录。

例如,在 UNIX/Linux 系统上:

setenv IWS_SERVER_HOME /usr/sun/servers

在 Windows 系统上:

  1. 从“控制面板”中选择“系统”。
  2. 单击“环境”选项卡。
  3. 在“变量”字段中键入 IWS_SERVER_HOME,在“值”字段中键入服务器根目录的路径。
  4. 单击“设置”。
  5. 单击“确定”。

  6. 要执行所有命令,您需要具有文件 server.xml 的写入权限,该文件中存储了虚拟服务器的信息。


HttpServerAdmin 语法

HttpServerAdmin 的语法如下所示:

HttpServerAdmin command_name command_options -d server_root -sinst http_instance

您可以键入以下命令获得命令参数的联机说明:

./HttpServerAdmin -h

command_name 参数有四个可能的值:

每个命令都有其自己的命令选项集。有关更多信息,请参见本章中说明每个命令的小节。

无论命令参数的值是什么,表 A-1 中显示的参数都可应用于 HttpServerAdmin 命令的所有用法。

表 A-1 HttpServerAdmin 参数

参数

-d server_root

(必需)此参数用于指定服务器根目录的路径(服务器的安装位置)。

-sinst http_instance

(必需)此参数用于指定 HttpServerAdmin 将影响哪一个实例。

control 命令

使用 control 命令可以启动、停止或禁用类和虚拟服务器。如果未指定虚拟服务器,此命令将启动、停止或禁用类中的每个虚拟服务器。

选项

使用表 A-2 中显示的选项和 control 命令可以控制类和虚拟服务器。

表 A-2 Control 命令选项

选项

-start

启动指定的虚拟服务器或类中所有的虚拟服务器(如果未指定虚拟服务器)。

-stop

停止指定的虚拟服务器或类中所有的虚拟服务器(如果未指定虚拟服务器)。

-disable

禁用指定的虚拟服务器或类中所有的虚拟服务器(如果未指定虚拟服务器)。

语法

HttpServerAdmin control -cl classname, -control_option [-id virtual_server] -d server_root -sinst http_instance

参数

使用这些参数和命令选项可以控制虚拟服务器。

表 A-3 Control 命令参数

参数

-cl classname

指定虚拟服务器类。

-id virtual_server

(可选)指定要控制的虚拟服务器的 ID。

示例

HttpServerAdmin control -cl myclass -start -id myvirtualserver -d /usr/sun/servers -sinst https-sun.com

HttpServerAdmin control -cl myclass -stop -id myvirtualserver -d /usr/sun/servers -sinst https-sun.com

HttpServerAdmin control -cl myclass -disable -id myvirtualserver -d /usr/sun/servers -sinst https-sun.com

create 命令

使用 create 命令可以创建虚拟服务器类、虚拟服务器和套接字。

选项

使用表 A-4 中显示的选项和 create 命令可以创建类、侦听套接字、虚拟服务器和资源。

表 A-4 Create 命令选项

选项

-c

创建虚拟服务器类。

-l

创建侦听套接字。

-v

创建虚拟服务器。

-r

创建资源。

每个选项又都具有自己的参数,这些参数将显示在以下部分。

创建虚拟服务器类

使用 create 命令的该选项可以创建一个虚拟服务器类。

语法

HttpServerAdmin create -c -cl classname -docroot document_root [-obj obj.conf_file] [-acptlang accept_language] -d server_root -sinst http_instance

参数

使用表 A-5 中显示的参数和 create -c 命令选项可以创建类。

表 A-5 创建虚拟服务器类参数

参数

-cl classname

要创建的类的名称。

-docroot document_root

类的文档根目录。它必须为绝对路径。

-obj obj.conf_file

(可选)类的 obj.conf 文件。如果未指定此参数,服务器会将 obj.conf 文件创建为 classname.obj.conf。如果要为类的 obj.conf 文件指定其他名称,请在此处指定。

-acptlang accept_language

(可选)如果未指定此参数,默认情况下 acptlang 将关闭。

示例

HttpServerAdmin create -c -cl myclass1 -docroot /docs -d /export/sun/servers -sinst https-sun.com

创建侦听套接字

使用 create 命令的该选项可以创建一个侦听套接字。

语法

HttpServerAdmin create -l -ip ip_address -port port_number -sname server_name -id default_virtual_server [-sec security] [-acct number_of_accept_threads] -d server_root -sinst http_instance

参数

使用表 A-6 中显示的参数和 create -l 命令选项可以创建侦听套接字。

表 A-6 创建侦听套接字参数

参数

-ip ip_address

侦听套接字的 IP 地址。

-port port_number

侦听套接字的端口号。

-sname server_name

要与侦听套接字关联的服务器名称。

-id default_virtual_server

缺省虚拟服务器的 ID。使用虚拟服务器创建侦听套接字之前,该虚拟服务器必须已存在。

-acct number_of_accept_threads

(可选)侦听套接字接受线程的数目。

-sec on

(可选)如果指定了此参数,使用 On 以启用侦听套接字的安全性。如果未指定此参数,则不会启用安全性。

示例

HttpServerAdmin create -l -id ls3 -ip 0.0.0.0 -port 1333 -sname austen -defaultvs vs2 -sec on -acct 4 -d /export/carey/server6 -sinst https-austen.com

创建虚拟服务器

使用 create 命令的该选项可以创建一个虚拟服务器。

请注意,如果未包括某些可选参数的值,则使用缺省值。您始终可以在创建虚拟服务器后更改缺省值。

语法

HttpServerAdmin create -v -id virtual_server -cl classname -urlh urlhosts [-state state][-docroot document_root] [-mime mime_types_file] [-aclid acl_ID] -d server_root -sinst http_instance

参数

使用表 A-7 中显示的参数和 create -v 命令选项可以创建虚拟服务器。

表 A-7 创建侦听套接字参数

参数

-id virtual_server

正在创建的虚拟服务器的 ID。

-cl classname

虚拟服务器将成为该类的成员。

-urlh URL_hosts

虚拟服务器的 URL 主机。您可以指定多个 URL 主机,主机之间以逗号分隔。

-state state

(可选)有效值为 On、Off 和 Disable。

-docroot document_root

(可选)如果要为虚拟服务器指定文档根目录,请使用此参数。您必须使用绝对路径名称。

-mime mime_types_file

(可选)虚拟服务器的 MIME 类型文件的名称。

-aclid acl_ID

(可选)server.xml 文件中使用的 ACL 文件 ID <ACLID>。

示例

HttpServerAdmin create -v -id vs3 -cl class1 -urlh annh -d /export/sun/server6 -sinst https-sun.com

HttpServerAdmin create -v -id vs4 -cl class1 -urlh annh,annh2 -state off -mime mime.types -d /export/sun/server6 -sinst https-sun.com

创建 JDBC 连接池

通过命令行界面使用 create -r 命令可以创建新的 JDBC 连接池。

语法

HttpServerAdmin -create -r -jdbcconnectionpool -poolname jdbcpoolname -classname classname [-steadypoolsize steadypoolsize] [-maxpoolsize maxpoolsize] [-poolresizequantity poolresizequantity] [-idletimeout idletimeout] [-maxwaittime maxwaittime] [-connectionvalidation true/false] [-connectionvalidationmethod connectionvalidationmethod] [-validationtablename validationtablename] [-failall true/false] [-desc description] [[-property propertyname=value],...]

选项

下表概述了使用 create -r 命令选项创建连接池所需的所有选项。

表 A-8 创建连接池参数

参数

poolname jdbcpoolname

JDBC 连接池的池名称。

classname classname

实现数据源的供应商特定的类名。

steadypoolsize steadypoolsize

池中必须维持的最小连接数目。

maxpoolsize maxpoolsize

池中允许的最大连接数目。

poolresizequantity poolresizequantity

达到 steadypoolsize 值时,根据该批量大小调整池的大小。

idletimeout idletimeout

连接在池中保持空闲的最长时间(以秒为单位)。

maxwaittime maxwaittime

达到连接超时前调用者等待的时间。

connectionvalidation true/false

指定将连接传递到应用程序之前是否验证连接。

connectionvalidationmethod connectionvalidationmethod

可以用于验证数据库连接的方法。有效值为 auto-commitmeta-data

validationtablename validationtablename

表的名称(如果 connectionvalidationmethod 设置为 table)。

failall true/false

在确定某个连接已失败时,指定是否使池中所有连接都失败并重新创建这些连接。

desc description

池的说明。

property propertyname=value

指定标准和专用 JDBC 连接池特性的“名称-值”对。

示例

HttpServerAdmin create -r -jdbcconnectionpool -poolname testpool -classname "oracle.jdbc.pool.OracleDataSource" -property "URL=jdbc:oracle:thin:@dbhost:1521:ORCL,user=scott,password=tiger" -d /opt/Sun/S1WS6.1 -sinst testinstance

创建 JDBC 资源

通过命令行界面使用 create -r 命令可以创建新的 JDBC 资源。

语法

HttpServerAdmin -create -r -jdbc -jndiname jndiname -poolname poolname [-desc description] [-enabled true/false]

选项

下表概述了使用 create -r 命令选项创建新的 JDBC 资源所需的所有选项。

表 A-9 创建 JDBC 资源参数

参数

jndiname jndiname

资源的 JNDI 名称。

poolname poolname

JDBC 连接池的池名称。

desc description

池的说明。

enabled true/false

指定是否启用或禁用资源。

如果禁用了某个 JDBC 资源,则所有应用程序组件都不能连接到此资源,但资源的配置仍保留在服务器实例中。

示例

HttpServerAdmin create -r -jdbc -jndiname "jdbc/testjdbcresource" -poolname testpool -d /opt/Sun/S1WS6.1 -sinst testinstance

创建自定义资源

通过命令行界面使用 create -r 命令可以创建新的自定义资源。

语法

HttpServerAdmin -create -r -custom -jndiname jndiname -resourcetype resourcetype -factoryclass factoryclassname [-enabled true/false] [-desc description] [[-property propertyname=value],...]

选项

下表概述了使用 create -r 命令选项创建新的 JDBC 资源所需的所有选项。

表 A-10 创建自定义资源参数

参数

jndiname jndiname

资源的 JNDI 名称。

resourcetype resourcetype

资源的类型。

factoryclassname factoryclassname

对象工厂的类名。

enabled true/false

指定是否启用或禁用资源。

desc description

池的说明。

property propertyname=value

指定自定义资源特性的“名称-值”对。

示例

HttpServerAdmin create -r -custom -jndiname "testcustomresource" -resourcetype "java.lang.String" -factoryclass "com.mycom.test.StringFactory" -d /opt/Sun/S1WS6.1 -sinst testinstance

创建外部 JNDI 资源

通过命令行界面使用 create -r 命令可以创建新的外部 JNDI 资源。

语法

HttpServerAdmin -create -r -external -jndiname jndiname -jndilookupname jndilookupname -restype restype -factoryclass factoryclass [-enabled true/false] [-desc description] [[-property propertyname=value],...]

选项

下表概述了使用 create -r 命令选项创建新的外部 JNDI 资源所需的所有选项。

表 A-11 创建外部 JNDI 资源参数

参数

jndiname jndiname

资源的 JNDI 名称。

jndilookupname jndilookupname

资源的 JNDI 查找名称。

restype restype

资源的类型。

factoryclass factoryclass

对象工厂的类名。

enabled true/false

指定是否启用或禁用资源。

desc description

池的说明。

property propertyname=value

指定自定义资源特性的“名称-值”对。

示例

HttpServerAdmin create -r -external -jndiname "testexternalresource" -jndilookupname "rmiconverter" -restype "samples.rmi.simple.ejb.ConverterHome" -factoryclass "com.sun.jndi.cosnaming.CNCtxFactory" -property "java.naming.provider.url=iiop://localhost:3700" -d /opt/Sun/S1WS6.1 -sinst testinstance

创建邮件资源

通过命令行界面使用 create -r 命令可以创建新的邮件资源。

语法

HttpServerAdmin -create -r -mail -jndiname jndiname -host host -user user -from from [-storeprotocol storeprotocol] [-storeprotocolclass storeprotocolclass] [-transportprotocol transportprotocol] [-transportprotocolclass transportprotocolclass] [-enabled true/false] [-desc description] [[-property propertyname=value]...]

选项

下表概述了使用 create -r 命令选项创建新的邮件资源所需的所有选项。

表 A-12 创建邮件资源参数

参数

jndiname jndiname

资源的 JNDI 名称。

host host

邮件服务器主机名。

user user

邮件服务器用户名。

from from

邮件服务器用来指明邮件发件人的 Email 地址。

storeprotocol storeprotocol

指定连接至邮件服务器、检索邮件和将邮件保存到文件夹中的存储协议服务。示例值为 imappop3

storeprotocolclass storeprotocolclass

指定用于存储的服务提供商实现类。

可从以下位置查找该类:

transportprotocol transportprotocol

指定发送邮件的传输协议服务。

transportprotocolclass transportprotocolclass

指定用于传输的服务提供商实现类。

可从以下位置查找该类:

enabled true/false

确定是否在运行时启用该资源。有效值为 OnOffYesNo10TrueFalse

desc description

资源的说明。

property propertyname=value

指定自定义资源特性的“名称-值”对。

示例

HttpServerAdmin create -r -mail -jndiname "localmail" -host localhost -user mailid -from mailid@mailhost -d /opt/Sun/S1WS6.1 -sinst testinstance

delete 命令

使用 delete 命令可以删除虚拟服务器类、虚拟服务器和侦听套接字。

选项

使用表 A-13 中显示的选项和 delete 命令可以删除类。

表 A-13 Delete 命令选项

选项

-c

删除指定的虚拟服务器类。

-l

删除指定的侦听套接字 ID。

-v

删除指定的虚拟服务器。

-r

删除指定的资源。

删除类

使用 delete 命令的该选项可以删除一个虚拟服务器类。

语法

HttpServerAdmin delete -c -cl classname -d server_root -sinst http_instance

参数

使用表 A-13 中显示的参数和 delete 命令可以删除类。

表 A-14 删除类参数

参数

-c l class

要删除的类名。

示例

HttpServerAdmin delete -c -cl class1 -d /export/sun/server6 -sinst https-sun.com

删除侦听套接字

使用 delete 命令的该选项可以删除一个侦听套接字。

语法

HttpServerAdmin delete -l -id listen_socket -d server_root -sinst http_instance

参数

使用表 A-13 中显示的参数和 delete 命令可以删除类。

表 A-15 删除类参数

参数

-id listen_socket

要删除的侦听套接字的 ID。

示例

HttpServerAdmin delete -l -id ls3 -d /export/sun/server6 -sinst https-sun.com

删除虚拟服务器

使用 delete 命令的该选项可以删除一个虚拟服务器。

语法

HttpServerAdmin delete -v -id virtual_server -cl classname -d server_root -sinst http_instance

参数

使用表 A-13 中显示的参数和 delete 命令可以删除虚拟服务器。

表 A-16 删除虚拟服务器参数

参数

-id virtual_server

要删除的虚拟服务器 ID。

-cl class

虚拟服务器所属的类。

示例

HttpServerAdmin delete -v -id vs3 -cl class1 -d /export/sun/server6 -sinst https-sun.com

删除 JDBC 连接池

使用 delete 命令的该选项可以删除一个连接池。

语法

HttpServerAdmin delete -r jdbcconnectionpoolname

参数

使用表 A-13 中显示的参数和 delete 命令可以删除连接池。

表 A-17 删除连接池参数

参数

connectionpoolname

要删除的连接池的名称。

示例

HttpServerAdmin delete -r connpool

删除 JNDI 资源

使用 delete 命令的该选项可以删除一个 JNDI 资源。

语法

HttpServerAdmin delete -r jndiname

参数

使用表 A-13 中显示的参数和 delete 命令可以删除 JNDI 资源。

表 A-18 删除 JNDI 资源参数

参数

jndiname

要删除的资源的 JNDI 名称。

示例

HttpServerAdmin delete -r testresource

list 命令

使用 list 命令可以列出虚拟服务器类、虚拟服务器、侦听套接字和资源。

语法

HttpServerAdmin list -command_option -d server_root -sinst http_instance

选项

表 A-19 List 命令选项

选项

-c

列出所有的虚拟服务器类。

-l

列出所有的侦听套接字。

-v

列出所有的虚拟服务器。

-r

列出指定的资源。

示例

HttpServerAdmin list -c -d /export/sun/server6 -sinst https-sun.com

HttpServerAdmin list -l -d /export/sun/server6 -sinst https-sun.com

列出的信息将显示在命令窗口中。



上一个      目录      索引      下一个     


版权所有 2004 Sun Microsystems, Inc.。保留所有权利。