适用于 IBM i 平台

Liberty:iAdmin 命令

该命令支持在 IBM® i 平台上操作 Liberty 服务器。命令文件位于 wlp/lib/native/os400/bin 目录中。命令文件是名称为 iAdmin 的脚本。

语法

命令语法如下所示:

iAdmin task [options]
其中 task 的值可以是下列其中一个选项:
  • POSTINSTALL
  • PREUNINSTALL
  • GRANTAUTH
POSTINSTALL 任务配置 server start 命令,以便将服务器作为 QWAS9 子系统中的作业来启动。此外,该任务还执行下列操作:
  • 将 Liberty 配置成在 QEJBSVR 用户概要文件下运行服务器。
  • 通过将文件 wlp/etc/default.env 中的 WLP_DEFAULT_JAVA_HOME 设置为 32 位版本支持的最低 Java™ 级别的位置来配置缺省 JDK 位置。
  • 在 IBM i 本机产品注册表中添加产品的条目。
  • 创建 IBM i 本机库和对象,例如 QWAS9 子系统和 QEJBSVR 用户概要文件。

仅在通过解压归档文件来安装 Liberty 之后调用 iAdmin POSTINSTALL 命令。

GRANTAUTH 任务会将服务器角色的必要文件权限和所有权授予给 QEJBSVR 用户概要文件。POSTINSTALL 会正确地为 QEJBSVR 用户概要文件设置文件所有权和权限。但是,如果您手动创建文件,或者修改 Liberty 服务器所使用文件的权限,那么可以调用 iAdmin GRANTAUTH 命令来确保 QEJBSVR 具有正确的权限。

PREUNINSTALL 任务会移除 POSTINSTALL 任务所创建的本机库和对象。在将 Liberty 应用程序服务环境从系统中移除之前调用 iAdmin PREUNINSTALL 命令,但只有在通过执行 JAR 文件来安装了 Liberty 时才需要这样做。

注:
  • 必须具有 *ALLOBJ*SECADM 特权才能使用 POSTINSTALLPREUNINSTALL 命令。
  • 必须对所指定目录子树中的所有对象具有 *ALLOBJ 特殊许可权,拥有这些对象或者对这些对象具有 *OBJMGT 权限,才能使用 GRANTAUTH 命令。
  • 运行 POSTINSTALL 任务之后,还必须具有 *ALLOBJ*SECADM 特权才能启动和停止 Liberty 服务器。

选项

以下选项可用于 iAdmin 命令:
--outputdir wlp_user_dir
服务器生成文件的目录。此选项只能是绝对路径,对于 GRANTAUTH 任务是可选的,但可以为所有其他任务所忽略。如果未指定,那么会使用服务器生成输出的缺省位置。
--rolename role_name
分配给用户概要文件的角色。服务器角色是目前唯一受支持的角色。此选项对于 GRANTAUTH 任务是必需的,但可以为所有其他任务所忽略。
--userdir wlp_user_dir
包含共享资源和服务器定义的目录。此选项只能是绝对路径,对于 GRANTAUTH 任务是可选的,但可以为所有其他任务所忽略。如果未指定,那么会使用共享资源和服务器定义的缺省位置。
--userprofilename user_profile_name
要授予权限的用户概要文件。QEJBSVR 是目前服务器角色的唯一受支持用户概要文件名称。此选项对于 GRANTAUTH 任务是必需的,但可以为所有其他任务所忽略。

使用方案

以下示例说明了正确的语法。在一行上运行以下示例中命令。
  • 对 Liberty 进行配置,以便作为 QWAS9 子系统中的作业来启动并在运行时交换到 QEJBSVR 用户概要文件。
    wlp/lib/native/os400/bin/iAdmin POSTINSTALL
  • 针对配置给此 Liberty 运行时环境的共享资源、服务器定义和输出位置,将服务器角色授予给 QEJBSVR 用户概要文件。
    wlp/lib/native/os400/bin/iAdmin GRANTAUTH --rolename server --userprofilename QEJBSVR
  • 移除 POSTINSTALL 任务所创建的本机库和对象。
    wlp/lib/native/os400/bin/iAdmin PREUNINSTALL

用于指示主题类型的图标 参考主题



时间戳记图标 最近一次更新时间: Tuesday, 6 December 2016
http://www14.software.ibm.com/webapp/wsbroker/redirect?version=cord&product=was-nd-mp&topic=rwlp_command_iadmin
文件名:rwlp_command_iadmin.html