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

Sun ONE Identity Server 6.1 管理指南

第 10 章
amserver 命令行工具

本章介绍有关 amserver 命令行工具的信息。本章包含以下内容：

amserver 命令行可执行文件

amserver 命令行可执行文件可以在 Solaris 平台上创建、启动、停止和删除附加的 Identity Server 实例。Windows 2000 平台上的 amserver 只允许启动和停止 Identity Server。

amserver 语法

使用该工具的通用语法为：

./amserver { create | delete [instance_name] | startall | start | stop | stopall | version }

适用于 Solaris 的 amserver 命令

create

create 命令用于创建新的 Identity Server 实例。应当以 root 用户身份运行 amserver 脚本。要创建实例，请运行 amserver 脚本 ./amserver create。使用 amserver 进行多服务器安装程序管理（仅用于 Web Server 实例）中介绍了创建多个服务器实例的详细步骤。该命令只适用于 Web Server 实例。

startall

startall 命令用于启动所有的 Identity Server 实例。要启动单个实例，请运行以下命令：

IdentityServer_base/SUNWam/bin/amserver.instance_name start

stopall

stopall 命令用于停止所有的 Identity Server 实例。要停止单个 Identity Server 实例，请运行以下命令：

/opt/SUNWam/bin/amserver.instance_name stop

delete

delete 命令用于删除由 create 选项创建的实例。

适用于 Windows 2000 的 amserver 命令

Windows 2000 平台上的 amserver 仅支持以下命令：

start

start 命令用于启动 Identity Server。

stop

stop 命令用于停止 Identity Server。

注

stop 和 start 在新的与容器无关的部署中可能会运行不正常。如果遇到这种情况，请在容器中使用 stop 和 start。

restart

restart 命令用于重新启动 Identity Server。

amserver 不能停止或启动 Directory Server。可能需要手动重新启动它。amserver 只能重新启动 Web Server 实例。对于其它 Web 容器，该命令仅重新启动验证帮助器。

使用 amserver 进行多服务器安装程序管理（仅用于 Web Server 实例）

可以使用 amserver 命令行实用程序安装和管理 Identity Server 的多个实例。在安装 Identity Server 的多个实例之前，您必须先以 root 用户身份登录。在 IdentityServer_base/SUNWam/bin 中可以找到以下步骤中涉及到的脚本。

要安装多个实例，请执行以下步骤：

  1. 通过输入 ./amserver create 使用 amServer 创建一个新的服务器实例。

    2. 例如，如果要创建侦听端口：81 的名为 instance1 的实例，脚本的输出可能会如下所示：

     

    #####################################################################

    请输入服务器实例的名称:instance1

    请输入端口号: 81

    是否要创建更多的服务器实例？y/[n]

    正在安装... 请稍候....

    ##################################################################

    1. 随后将为每个 Web Server 实例创建一个目录。示例：

      2. IdentityServer_base/SUNWam/servers/https-instance_name

    2. Identity Server 应用程序将被部署到以下位置：

      3. IdentityServer_base/SUNWam/servers/web-apps-instance_name

    3. IdentityServer_base/SUNWam/bin 目录包含 amServer 的实例特定版本。例如：

      4. amserver.instance_name

    4. 将在 IdentityServer_base/SUNWam/lib/AMConfig-instance_name.properties 中创建 Identity Server 配置文件的副本。
    5. 文件 /etc/rc3.d 包含初始化文件的实例特定版本：

      6. S55amserver.instance_name

      K55amserver.instance_name

    注

    请勿在创建实例名称时使用“_”（下划线 _）或“.”（句点）。

  2. 通过输入以下命令启动所有的 Identity Server 实例（包括原先的服务器实例）：

    3. ./amserver startall

    也可以使用以下命令启动单个服务器：

    IdentityServer_base/SUNWam/bin/amserver.instance_name start

    现在应该可以通过浏览器调用所有实例的 Identity Server 登录屏幕。

  3. 通过输入以下命令停止所有的服务器实例（包括原先的实例）：

    4. ./amserver stopall

    也可以使用以下命令停止单个服务器：

    IdentityServer_base/SUNWam/bin/amserver.instance_name stop

  4. 通过输入以下命令调用 Delete 命令选项：

    5. ./amserver delete

    由 Create 命令创建的所有文件应该已被删除。如果使用 Identity Server 卸载实用程序，则由脚本生成的文件不会被删除。

  5. 通过输入以下命令指定调试文件的目录：

    6. Edit IdentityServer_base/SUNWam/lib/AMConfig-instan ce_name.properties

    确保将 com.iplanet.services.debug.directory 属性更改为您的指定目录。

  6. 通过使用以下语法调用 ammultiserverinstall 实用程序：

    7. ammultiserverinstall [ server-instance-name ] [ port ]

    如果应用需要安装多个 Identity Server 实例，但是倾向于使用非交互式界面，请使用 ammultiserverinstall 实用程序。如果 ammultiserverinstall 失败，将以值 1 退出。

  7. amserver 将自动将服务器实例添加到“平台服务器”列表中。
  8. 将 Identity Server 配置为在 SSL 模式中运行。有关此操作的说明，请参见本手册的附录 B“在 SSL 模式中配置 Identity Server”。
  9. 输入以下命令以启动所有的 Identity Server 实例：

    10. ./amserver startall

    也可以使用以下命令启动单个 Identity Server 实例：

    ./amserver-instance start



上一个      目录      索引      下一个     

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