可以使用安装 Liberty 概要文件作业,以远程方式将资源安装在多主机 Liberty服务器环境中。安装之前,资源必须存储在一个或多个压缩文件(.zip 文件)中;安装时,由作业管理器将资源解压缩到相对于所指定根目录的目标目录。
开始之前
在运行安装 Liberty 概要文件资源作业之前,必须存在下列情况:
- 作业管理器必须正在运行。
- 必须向作业管理器至少注册了一个目标主机。
- 压缩文件(.zip 文件)必须以满足作业管理器规则的目录结构包含 Liberty资源。请参阅“将 Liberty资源打包”。
- 必须定义目标主机上要安装资源的根目录。在尝试安装工作资源之前,请将 WLP_WORKING_DIR WebSphere 变量设置为对目标主机有效的目录路径。同样,在尝试安装共享资源之前,请将 WLP_SHARED_DIR WebSphere 变量设置为有效的目录路径。可以为这些变量定义全局缺省值,并根据需要覆盖特定主机上的值。请参阅“为 Liberty 服务器设置变量”。
您在作业管理器中的标识必须具有管理员角色权限或操作员角色权限,才能提交作业。
向作业管理器注册目标主机时,可以保存操作系统安全性信息。将作业提交到一个或多个目标(尚未针对其保存安全性信息)时,必须指定授权的操作系统用户名,以及该用户名的密码或公用-专用密钥信息。安全凭证必须对所有作业目标有效。
会自动将来自 Liberty 服务器的状态发送到 STATUS_LISTENER_ADDRESS 端口。要更改 STATUS_LISTENER_ADDRESS 端口号,请使用 Deployment Manager 控制台的“端口”页面()或者作业管理器控制台的“端口”页面()。如果在安装 Liberty 服务器资源之后更改 STATUS_LISTENER_ADDRESS 端口号,那么将无法再从先前安装的 Liberty 资源接收自动状态。
关于此任务
可以使用作业管理器或 Deployment Manager 的管理控制台来将 Liberty资源安装在一个或多个主机目标上。从控制台中,选择安装 Liberty 概要文件资源作业,指定压缩文件位置和其他作业选项,复审摘要,然后提交作业。
可以在 AdministrativeJobs 命令组中运行 installLibertyProfileResources 作业脚本,而不是使用控制台。请参阅“管理作业类型”主题。
过程
- 在管理控制台的导航树中,单击。
- 选择用于安装 Liberty资源的作业。
- 从列表中选择安装 Liberty 概要文件资源作业类型。
- (可选)指定作业的描述。
- 单击下一步。
- 选择要在其中添加 Liberty资源的作业目标。
- 从列表中选择目标组,或者选择目标名称。
在目标组列表中,将仅显示对所选作业类型有效的目标组。
- 如果已选择目标名称,请指定目标名称并单击添加,或者单击查找并在“查找目标”页面上指定所选目标。
- 如果在向作业管理器注册目标主机时未选择保存安全认证信息,请指定用于访问目标主机的操作系统用户名和密码或公用-专用密钥信息。安全凭证必须对所有作业目标有效。
- 单击下一步。
- 为安装 Liberty资源作业指定参数。
- 如果包含 Liberty资源的压缩文件位于作业管理器服务器上,那么对 Liberty 概要文件资源压缩文件的路径指定压缩文件(.zip 文件)的完整路径名。
如果压缩文件并不位于作业管理器服务器上,请跳过此步骤并指定压缩文件的 URL 路径。
例如,假定 Liberty资源存在于 /resources/my_liberty_server.zip 压缩文件中。指定压缩文件的完整路径名:
![[AIX]](../images/aixlogo.gif)
![[HP-UX]](../images/hpux.gif)
![[Linux]](../images/linux.gif)
![[Solaris]](../images/solaris.gif)
/resources/my_liberty_server.zip
![[Windows]](../images/windows.gif)
c:/resources/my_liberty_server.zip
- 如果包含 Liberty资源的压缩文件并不位于作业管理器服务器上,那么对 Liberty 概要文件资源压缩文件的 URL 路径指定压缩文件的 URL 路径。
统一资源定位符 (URL) 的支持模式名称包含 http、https、ftp 和 file。
限制: 目标主机必须具有 wget 实用程序,才能将 Liberty 概要文件资源压缩文件的 URL 路径与 file 之外的协议一起使用。选择目标主机上的 wget 实用程序支持的 http、https 或 ftp 远程下载协议。如果 wget 实用程序不支持所选协议,那么该作业无法安装这些资源。
例如,对 Liberty资源文件 my_liberty_server.zip 指定下列其中一个 URL。
如果 Liberty资源位于 HTTP 或 HTTPS 服务器上:
http://www.mycompany.com/resources/my_liberty_server.zip
https://www.mycompany.com/resources/my_liberty_server.zip
如果 Liberty资源位于 FTP 服务器上:
ftp://www.mycompany.com/resources/my_liberty_server.zip
如果 Liberty资源位于目标主机上,那么 URL 可以使用文件模式来描述压缩文件的路径和名称:
![[AIX]](../images/aixlogo.gif)
![[HP-UX]](../images/hpux.gif)
![[Linux]](../images/linux.gif)
![[Solaris]](../images/solaris.gif)
file:///resources/my_liberty_server.zip
![[Windows]](../images/windows.gif)
file://c:/resources/my_liberty_server.zip
- 如果包含 Liberty资源的压缩文件并不位于作业管理器服务器上,而且 URL 受密码保护,请指定用户名和密码。
- 对于访问 URL 所需的用户名,请指定可以访问对步骤 4(b) 指定的 URL 的用户名。
- 对于访问 URL 所需的密码和确认密码,请指定使用户能访问 URL 的密码。
- 要安装可以在服务器之间共享的 Liberty资源,请选择安装到共享位置。
缺省情况下,未选择此选项,并且作业会将资源安装到 WLP_WORKING_DIR WebSphere 变量所设置的位置。如果选择了此选项,那么作业会将资源安装到 WLP_SHARED_DIR WebSphere 变量所设置的位置。
- 要运行用于授权 Liberty安装及其嵌入式服务器的可选 iSeries 脚本,请选择在 IBM i 目标上运行可选的安装脚本。
如果选择,那么会对作业管理器正在 IBM i 目标上安装的每个
Liberty运行以下命令:
liberty_home/bin/iAdmin POSTINSTALL
在共享拓扑中安装一个或多个服务器时,运行以下命令:
liberty_home_of_server/bin/iAdmin GRANTAUTH --rolename server
--userprofilename QEJBSVR --userdir server_area_root
server_area_root 是服务器目录的祖父目录。例如,如果服务器是安装到
/usr/servers/myserver 目录,那么
server_area_root 是
/usr 且命令为:
liberty_home_of_server/bin/iAdmin GRANTAUTH --rolename server
--userprofilename QEJBSVR --userdir /usr
卸载
Liberty安装时,在 IBM i 目标上运行以下命令:
liberty_home/bin/iAdmin PREUNINSTALL
- 单击下一步。
- 安排作业时间表。
指定的时间和日期相对于作业管理器。
- (可选)指定当作业完成时发送通知的一个或多个电子邮件地址。
如果指定了多个电子邮件地址,请使用逗号进行分隔。
- 选择作业何时可提交。
- 选择作业到期时间。
- (可选)指定作业的重现时间间隔、此时间间隔的起始日期和时间以及此时间间隔的结束日期和时间。
- 单击下一步。
- 复审摘要并单击完成以提交作业。
结果
作业管理器服务器会运行作业,并尝试将 Liberty资源添加到目标主机。
作业会按以下顺序尝试下列方法,在目标主机上解压缩映像:
- 在主机上使用 unzip 实用程序。
- 在主机上使用 jar 实用程序,包括库存作业所找到的软件开发包 (SDK) 中的 jar 实用程序。
使用执行作业期间复制到远程主机的 unzip 实用程序(如果管理员未明确地将其禁用)。完成作业后,会删除 unzip 实用程序。
- 在作业管理器上解压缩 zip 文件,并将文件逐个复制到目标主机。只有在映像位于作业管理器上时,此方法才适用。
下一步做什么
在“作业状态”页面上,单击安装 Liberty资源作业的标识并查看作业状态。单击状态刷新图标
以刷新所显示的状态。
如果作业不成功,请查看运行作业时产生的任何错误消息,更正错误情况,然后再次提交作业。
避免故障: 如果作业失败并显示消息
Undefined variable WLP_WORKING_DIR,请单击,选择作用域,然后单击
新建。创建名称为
WLP_WORKING_DIR 的变量,以及一个包含用于指定要安装
Liberty资源的目录路径的值,例如
/liberty/working。如果作业失败并发出消息
Undefined variable WLP_SHARED_DIR,请创建名称为
WLP_SHARED_DIR 的变量,并指定要安装共享
Liberty资源的目录路径,例如
/liberty/shared。然后,再次提交作业。
gotcha
如果作业成功,请单击,以查看资源列表中的 Liberty资源。