WebSphere Application Server 上部署 Design Management Server

可以在 WebSphere® Application Server 上部署 Design Management Server 而不是该服务器附带的 Apache Tomcat 服务器。指示信息基于 WebSphere Application Server V8.0 或更高版本,与 V7.0 的指示信息稍有不同。

开始之前

要点: 有可能在使用 WS-Security 时暴露安全性;这可能导致用户获得更高的特权。这会影响使用 JAX-WS 和 JAX-RPC 的应用程序。有关如何获取和安装此安全补丁的完整详细信息,请阅读此短讯。此外,请考虑是否通过“我的通知”预订 WebSphere Application Server 更新;因此,您将收到有关更新和补丁的与安全性相关的通知。
请确保正确设置了您的环境:

关于此任务

如果正在使用部门或企业拓扑,那么将需要为在此机器上运行的每个服务器和应用程序配置 WebSphere Application Server。

过程

  1. WebSphere Application Server 管理控制台中,指定下列安全性设置:
    1. 通过单击安全性 > 全局安全性并取消选中使用 Java 2 安全性来限制应用程序对本地资源的访问复选框,确认关闭 Java™ 2 安全性。
    2. 当前域定义字段中,请确保配置了正确的安全域并将其设置为当前域。然后选中启用管理安全性启用应用程序安全性复选框。
    3. 单击安全性 > 全局安全性,在认证下单击 Web 和 SIP 安全性 > 常规设置,并选中在访问不受保护的 URI 时使用可用的认证数据复选框。
  2. 指定 WebSphere Application Server 的 Java 虚拟机设置:
    1. 在管理控制台中,单击服务器 > 服务器类型 > WebSphere Application Server,然后单击您的服务器。缺省情况下,该服务器命名为 server1
    2. 服务器基础结构下,单击 Java 和进程管理 > 进程定义
    3. 其他属性下,单击 Java 虚拟机
    4. 初始堆大小字段中,指定 4096 用于堆大小和 JVM 参数的图仅为建议;请根据您的环境设置值。典型中等大小团队可以使用值 4096 MB,同时为至少具有 8 GB 物理内存的 64 位计算机上的 Jazz Team Server 进程提供 4 GB 的堆内存。针对初始和最大堆大小使用相同量,这一点很重要。增大 Java 堆大小时,确保机器上具有足够的未使用的物理内存以允许增加堆大小。如果没有足够的可用物理内存,那么安装更多内存或考虑所发生的对整体性能的影响。具有机器上所有进程一共所需的更多物理内存来阻止分页或交换,这一点也很重要。分页会降低系统的性能,并影响 Java 内存管理系统的性能。
    5. 最大堆大小字段中,指定该服务器的最大内存(以 MB 计)。对于 64 位计算机,请指定适合于您的环境的内存量,例如,4096,它表示 4GB 内存。
    6. 通用 JVM 参数字段中,添加以下内容:
      操作系统 用户输入
      Windows -Xmx4g -Xms4g -Xmn512m -Xgcpolicy:gencon -Xcompressedrefs -Xgc:preferredHeapBase=0x100000000 -XX:MaxDirectMemorySize=1G
      Linux -Xmx4g -Xms4g -Xmn512m -Xgcpolicy:gencon -Xcompressedrefs -Xgc:preferredHeapBase=0x100000000 -XX:MaxDirectMemorySize=1G
      AIX -Xmx4g -Xms4g -Xmn512m -Xgcpolicy:gencon -Xnocompressedrefs -XX:MaxDirectMemorySize=1G
      提示:如果需要更大堆大小,那么可以使用以下设置,同时将 {N} 替换为要使用的内存量,并将 {N/8} 替换为总内存的 1/8。例如,如果 -Xmx 设置为 8g,那么 -Xmn 应设置为 1g。-Xgcpolicy:gencon -Xmx{N} -Xms{N} -Xmn{N/8} -Xcompressedrefs -Xgc:preferredHeapBase=0x100000000 -XX:MaxDirectMemorySize=1G
    7. 单击应用
    8. 在“Java 虚拟机”页面中的其他属性下,单击定制属性
    9. 单击新建并指定 JAZZ_HOME 属性,该属性标识 Design Management Server 的配置文件的位置,其中包括 jtsdm 文件夹。
      此属性使用 URI 而不是简单的文件路径,并且始终以 file:/// 开头。Windows 系统上的缺省位置如下所示:
      file:///C:/PROGRA~1/IBM/JazzTeamServer/server/conf
      在 Linux 系统上,缺省位置如下所示:
      file:///opt/ibm/JazzTeamServer/server/conf
      注: 为了避免出现问题,请不要在文件路径中使用空格。对于 Windows 的 32 位安装版本上的 Program Files 文件夹,您可以使用 PROGRA~1,对于 Windows 的 64 位安装版本上的 Program Files (x86) 文件夹,您可以使用 PROGRA~2
    10. 再次单击新建并指定名为 log4j.configuration 的属性。将 startup_log4j.properties 文件的位置用作值。 此属性使用与 JAZZ_HOME 属性相同的格式。在大多数情况下,此文件位于 JAZZ_HOME 文件夹中。Windows 系统上的缺省值如下所示:
      file:///C:/PROGRA~1/IBM/JazzTeamServer/server/conf/startup_log4j.properties
      Linux 系统上的缺省值如下所示:
      file:///opt/ibm/JazzTeamServer/server/conf/startup_log4j.properties
      注: 在启动过程中的早期阶段将使用 startup_log4j.properties 中的设置来将消息传递至 SystemOut.log 文件。在早期阶段后,每个应用程序都将转变成使用 server/conf/<app_context>/log4j.properties 文件中特定于应用程序的设置。
    11. 再次单击新建并用值 true 来指定名为 java.awt.headless 的属性。
    12. 再次单击新建并用值 true 来指定名为 org.eclipse.emf.ecore.plugin.EcorePlugin.doNotLoadResourcesPlugin 的属性。
    13. 如果您正在使用 SQL Server 数据库,请再次单击新建并用 sqljdbc4.jar 文件的位置来指定名为 SQLSERVER_JDBC_DRIVER_FILE 的属性。
    14. 如果您正在使用 Oracle 数据库,请再次单击新建并用 sqljdbc5.jar 文件的位置来指定名为 SQLSERVER_JDBC_DRIVER_FILE 的属性。
    定制属性看起来类似于下图。注意,除了您添加的属性之外,缺省情况下还会显示某些属性。
    Java 虚拟机属性的示例
  3. 将更改保存到主配置并重新启动 WebSphere Application Server
    现在,该服务器已随时可以部署 Design Management Server 应用程序文件。
    注: 在 UNIX 或 Linux 系统上,如果 WebSphere Application Server 安装在非 root 用户环境中,那么安装 Design Management Server 的用户必须对安装目录及其所有子目录具有读和写访问权。
  4. 安装 Jazz Team Server 应用程序:
    1. 在管理控制台中,单击应用程序 > 新建应用程序 > 新建企业应用程序
    2. 新应用程序的路径下,单击浏览以指定 jts.war 文件所在的位置,然后单击下一步 如果在安装 Design Management Server 时未安装 Apache Tomcat,那么此文件的缺省位置是 installDir/server/webapps。如果安装了 Tomcat,那么缺省位置是 installDir/server/tomcat/webapps
    3. 您要如何安装该应用程序?下,单击快速路径然后单击下一步
    4. 在“步骤 1:选择安装选项”页面中,接受缺省选项然后单击下一步
    5. 在“步骤 2:将模块映射至服务器”页面中,选中 <app>.war(其中,<app> 是正在安装的应用程序的名称)旁边的复选框,请确保目标服务器或集群正确并单击下一步
    6. 在“步骤 3:映射 Web 模块的虚拟主机”页面中,选中 <app>.war 旁边的复选框,并单击下一步
    7. 在“步骤 4:映射 Web 模块的上下文根”页面中,将上下文根设置为 /<app>(其中 <app> 是应用程序上下文根)。例如,如果安装 dm.war,那么上下文根可以为 dm,并单击下一步
    8. 单击完成
  5. 根据您正在服务器上安装的应用程序,对于下列 war 文件和相应的上下文根重复执行这些安装步骤:
    选项 描述
    dm.war(“设计管理”应用程序) /dm
    admin.war(Jazz Team Server 应用程序) /admin
    vvc.war(“设计管理”应用程序) /vvc
    rdmhelp.war(“设计管理”应用程序) /rdmhelp
    clmhelp.war(Jazz Team Server 应用程序) /clmhelp
    rsadm.warr(“设计管理”应用程序) /rsadm
    vvchelp.war(“配置管理”应用程序) /vvchelp
    jts.war(Jazz Team Server 应用程序) /jts
  6. 在包含 Jazz Team Server (jts.war) 的服务器上,您将需要映射 WebSphere Application Server 上的安全角色。将 Jazz Team Server 应用程序的安全角色映射至安全域中的用户和组。 设置安全性不在本任务的范围内,但是在全局安全域使用 LDAP 注册表的大多数情况下,应将 LDAP 注册表中的组映射至该应用程序的下列安全角色:
    • JazzAdmins
    • JazzDWAdmins
    • JazzProjectAdmins
    • JazzGuests
    • JazzUsers
    1. 单击应用程序 > 应用程序类型 > WebSphere 企业应用程序 > jts_war
    2. 详细信息属性下,单击安全角色至用户/组映射 此页面显示 Design Management Server 的用户组,必须将这些用户组映射至安全域中的用户或组。
    3. 选择一个角色,然后单击映射组以将该角色映射至安全域中的某个组。
      注: 请不要启用全部认证?选项。
  7. 验证是否成功安装了应用程序,然后将更改保存到 WebSphere Application Server 的主配置。
  8. 添加以下会话管理定制属性,以避免在用户注销但未终止会话时出现 SESN0008E 错误消息:
    1. 在 WebSphere Integrated Solutions 控制台中,单击服务器 > 服务器类型 > WebSphere Application Server
    2. 单击 server1,然后在“容器设置”部分中,单击“会话管理”。
    3. 在“其他属性”部分,单击定制属性
    4. 单击“新建”并输入以下信息:名称:InvalidateOnUnauthorizedSessionRequestException 值:true
    5. 单击应用并直接保存到主配置。
  9. 保存到主配置之后,请停止并重新启动服务器。
  10. WebSphere Application Server 管理控制台中,单击应用程序 > 应用程序类型 > WebSphere 企业应用程序以确认所有应用程序都在运行。

结果

这些应用程序旁边将显示绿色箭头,以指示它们已正确启动。

下一步做什么

现在,您可以按照设置和配置 Design Management Server 中的描述来配置 Design Management Server

反馈