适用于 IBM i 平台

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 特权才能使用 POSTINSTALL 和 PREUNINSTALL 命令。
  • 必须对所指定目录子树中的所有对象具有 *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