Sun Java System Access Manager 7 2005Q4 管理指南

amadmin 选项

以下是 amadmin 命令行参数选项的定义:

--runasdn (-u)

--runasdn 用于验证访问 LDAP 服务器的用户。此参数的值等于被授权运行 amadmin 的用户的区别名 (DN) 的值;例如

--runasdn uid=amAdmin,ou=People,o=iplanet.com,o=isp

还可以在 DN 中的域组件之间插入空格,并将整个 DN 用双引号引起,如下所示:--runasdn "uid=amAdmin, ou=People, o=iplanet.com, o=isp"

--password (-w)

--password 是一个强制性选项,其值等于用 --runasdn 选项指定的 DN 密码的值。

--locale (-l)

--locale 选项的值等于语言环境名称的值。此选项可用于自定义消息语言。如果没有提供此选项,则使用默认语言环境 en_US

--continue (-c)

如果使用 --continue 选项,则即使出现了错误,amadmin 命令仍然会继续处理 XML 文件。例如,如果要同时加载三个 XML 文件,并且第一个 XML 文件加载失败,amadmin 将继续加载其余的文件。continue 选项仅应用于独立请求。

--session (-m)

--session (-m) 选项可管理会话或显示当前会话。当指定 --runasdn 时,其值必须与 AMConfig.properties 中超级用户的 DN 相同,或与顶级管理员用户的 ID 相同。

以下示例将显示特定服务主机名的所有会话:

amadmin -u uid=amadmin,ou=people,dc=iplanet,dc=com 
-v  -w 12345678 -m http://sun.com:58080

以下示例将显示特定用户的会话:

amadmin -u uid=amadmin,ou=people,dc=iplanet,dc=com -v 
 -w 12345678 -m http://sun.com:58080 username

可以通过输入相应的索引编号来终止会话,或输入多个索引编号(以空格分开)来终止多个会话。

而使用以下选项:

amadmin -m | --session servername 模式

该模式可以是一个通配符 (*)。如果此模式 (pattern) 使用通配符 (*),则必须在 Shell(命令解释器)中用元字符 (\\) 对其进行换码。

--debug (-d)

--debug 选项可以将消息写入在 /var/opt/SUNWam/debug 目录下创建的 amAdmin 文件中。这些消息在技术上很详细,但与 i18n 不兼容。要生成 amadmin 操作日志,应在记入数据库时,手动添加数据库驱动程序的类路径。 例如,当以 amadmin 记入 mysql 时,需添加以下行:

CLASSPATH=$CLASSPATH:/opt/IS61/SUNWam/lib/mysql-connector-java-3.0.6-stable-bin.jar
export CLASSPATH

--verbose (-v)

--verbose 选项可在屏幕上显示 amadmin 命令的总体进度。它不会将详细信息打印到文件中。输出到命令行的消息与 i18n 兼容。

--data (-t)

--data 选项将正在导入的批处理 XML 文件的名称作为它的值。可以指定一个或多个 XML 文件。此 XML 文件可以创建、删除和读取各种目录对象,还可以注册和取消注册服务。

--schema (-s)

--schema 选项可将 Access Manager 服务的属性加载到 Directory Server 中。它的变量值为在其中定义服务属性的 XML 服务文件。此 XML 服务文件是基于 sms.dtd 的。可以指定一个或多个 XML 文件。


注 –

根据是要对 DIT 配置批更新还是要加载服务模式和配置数据,必须指定 --data--schema 选项。


--deleteservice (-r)

--deleteservice 选项仅用于删除服务及其模式。

--serviceName

--serviceName 选项的值等于在 XML 服务文件 Service name=... 标签中定义的服务名称。 此部分显示在--serviceName中。


示例 14–1 sampleMailService.xml 的一部分


...
<ServicesConfiguration>
    <Service name="sampleMailService" version="1.0">
        <Schema
 serviceHierarchy="/other.configuration/sampleMailService"
            i18nFileName="sampleMailService"
            i18nKey="iplanet-am-sample-mail-service-description">
...

                  

--help (-h)

--help 参数显示 amadmin 命令的语法。

--version (-n)

--version 参数显示实用程序名称、产品名称、产品版本和法律声明。