应用属性文件以使用作业管理器来配置服务器

在灵活管理环境中,可以提交配置属性作业以将属性文件应用于作业管理器管理的应用程序服务器。在编辑用于受管应用程序服务器目标的属性文件之后,请使用作业管理器来将该属性文件分发到受管目标上并应用已更改文件来更新应用程序服务器配置。

开始之前

属性文件提供用来查询和更改产品配置的方式。这些文件用名称/值对的形式列出最常用的属性。

在可提交用于应用属性文件的作业之前,请执行以下操作:

  1. 启动作业管理器。如果要将属性文件应用到 Deployment Manager 目标,请启动 Deployment Manager 及 Deployment Manager 的联合节点。如果要将属性文件应用到独立应用程序服务器目标,请启动管理代理程序。目标必须由作业管理器进行管理。
  2. 使用 AdminTask 对象的 PropertiesBasedConfiguration 命令组中的 extractConfigProperties 命令来抽取由作业管理器管理的应用程序服务器的属性文件。必须在本地运行 extractConfigProperties 命令,或者运行 wsadmin 脚本以在运行 wsadmin 脚本作业中抽取属性文件。作业管理器没有专门用于抽取属性文件的作业。

    例如,假定您想要抽取应用程序服务器目标的服务器配置,该目标具有服务器 server1 和概要文件 AppSrv02。从 AppSrv02 概要文件的 bin 目录运行以下 wsadmin 命令:

    wsadmin -lang jython
    
    AdminTask.extractConfigProperties('[-propertiesFileName server.props -configData Server=server1 ]')

    产品会将服务器配置抽取到 AppSrv02 概要文件的 bin 目录中的文件 server.props

  3. 对属性文件打开编辑器,更改一个或多个属性的值并保存该文件。
    要点: 属性文件必须为 UTF-8。生成的文件会自动采用 UTF-8。确保该文件在任何编辑后仍为 UTF-8。使用可以处理 UTF-8 或 US-ASCII(如果文件不含 7 位 US-ASCII 字符集以外的字符)的编辑器。
  4. 将属性文件复制到作业管理器概要文件的 /config/temp/JobManager 目录。

    如果 JobManager 目录不存在,那么在作业管理器概要文件 /config/temp 目录中创建 JobManager 目录。要创建并访问该目录,必须具有相应权限。

    如果属性文件存在于受管目标上,那么可以运行收集文件作业以将属性文件从受管目标复制到 job_manager_profile/config/temp/JobManager/jobToken/targetName 目录。请参阅“收集文件作业”主题。

  5. 运行分发文件作业以将属性文件从作业管理器分发到一个或多个应用程序服务器目标。请记住对目标指定的任何值,因为用来应用属性文件的作业会使用该位置。
    避免故障 避免故障: 必须将属性文件分发到目标,然后才能运行配置属性作业。分发文件作业会将作业管理器概要文件的 /config/temp/JobManager 目录中的属性文件复制到目标。目标上属性文件的名称会变成您在分发文件时对目标指定的任何值。请参阅“分发文件作业”主题。gotcha
  6. 如果属性文件使用变量映射文件,那么运行分发文件作业以分发变量映射文件。请记住对目标指定的任何值。

您在作业管理器中的标识必须具有管理员角色权限或操作员角色权限,才能提交作业。提交作业时,您可以指定用户名和密码,以便在目标上进行认证和授权。将一个作业提交至多个目标时,提交者的用户名和密码或凭证必须适用于所有作业目标。

关于此任务

可以使用作业管理器或 Deployment Manager 的管理控制台来提交用于应用属性文件和配置应用程序服务器的作业。从控制台中,选择配置属性作业,指定要应用的属性文件,指定作业选项,安排作业,复审摘要,然后提交作业。

该作业会对应用程序服务器配置进行下列更改:
  • 将与特性文件中指定的每个特性对应的属性设置为新值。
  • 如果配置中不存在与指定特性对应的属性,那么在配置中创建属性。
  • 如果配置中不存在属性文件中指定的配置对象,那么创建配置对象。

(可选)当应用属性文件时,可以指定作业管理器使用变量映射文件中设置的变量。指定要随属性文件包括的变量映射文件的位置。

这些步骤描述如何使用作业管理器控制台或 Deployment Manager 来提交作业。可以通过运行 AdministrativeJobs 命令组中的 configProperties 命令来配置应用程序服务器目标的属性以提交作业,而不使用控制台。请参阅“管理作业类型”主题。

配置属性作业使用 AdminTask 对象的 PropertiesBasedConfiguration 命令组中的 applyConfigProperties 命令来配置目标的属性。

过程

  1. 在管理控制台的导航树中,单击作业 > 提交
  2. 选择用来将属性文件应用于一个或多个应用程序服务器目标的作业。
    1. 从列表中选择配置属性作业类型。
    2. (可选)描述作业。
    3. 单击下一步
  3. 对于作业目标,选择要通过应用属性文件来配置的应用程序服务器目标。
    1. 选择目标名称
    2. 指定先前将属性文件分发到的目标名称并单击添加,或者单击查找并在“查找目标”页面上指定应用程序服务器目标作为所选目标。
    3. 单击下一步
    4. 如果需要用户认证,请指定用户名、密码或任何其他认证值(视需要)。
    5. 单击下一步
  4. 为配置属性作业指定参数。
    1. 指定要应用的属性文件的位置。

      属性文件位置是您已为分发文件作业指定的目标值。

    2. 如果属性文件使用变量映射文件,那么指定变量映射文件的位置。

      请使用已为分发文件作业指定的目标值。

    3. 单击下一步
  5. 安排作业时间表。

    指定的时间和日期相对于作业管理器。

    1. (可选)指定一个或多个电子邮件地址,作业完成时,将向这些地址发送通知。

      如果指定多个电子邮件地址,请用逗号将它们分隔。这些电子邮件地址保存在控制台首选项中。会对每个电子邮件地址进行验证以查找格式错误。

    2. 选择作业何时可提交。

      您可以提交作业以使其立即可供使用,也可以指定从作业管理器检索作业的时间和日期。

    3. 选择作业到期时间。

      作业到期时间是作业将不再可供目标运行的时间。可以使用缺省到期时间,为作业到期指定时间与日期或指定作业到期的时间量。缺省到期时间是在作业管理器配置页面上定义的。

    4. (可选)指定作业的重现时间间隔、此时间间隔的起始日期和时间以及此时间间隔的结束日期和时间。
    5. 单击下一步
  6. 复审摘要并单击完成以提交作业。

结果

作业管理器会执行下列操作:

  • 使配置属性作业可供目标使用。
  • 报告作业在每个目标上的状态。

下一步做什么

在“作业状态”页面上,单击作业标识并查看作业状态。单击状态刷新图标 指定作业状态的刷新视图图标 以刷新所显示的状态。

如果作业不成功,请查看运行作业时产生的任何错误消息,更正错误情况,然后再次提交作业。

如果作业状态是 Succeeded,请检查目标以确保已应用属性文件。


指示主题类型的图标 任务主题



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