Page tree
Skip to end of metadata
Go to start of metadata

在此页:

目标用户:

CAST AI 管理员

概述:本节描述如何安装配置健康仪表盘——用于在分析/快照生成过程中生成集合数据的顶层调查。

简介

需要多少健康仪表盘?

CAST强烈建议安装一个健康仪表盘,以显示来自所有应用的快照数据,无论这些应用存储在一个或多个仪表盘服务中。因此在配置健康仪表盘时,应该:

  • 配置到单个测量服务的连接(CAST模式之一)    
  • 将来自所有仪表盘服务的数据合并到这个单一测量服务中   

注意:

  • 健康仪表盘可以正式支持最多200个应用的上传。CAST建议只从业务视图中选择最关键的应用——即需要CIO和管理人员以高可见性监视的应用。如果需要上传超过200个应用,请参见HD- 为大量应用配置健康仪表盘(该信息对于上传少于200个应用同样有效)。
  • 如果用户只被授权访问来自特定应用的数据,“授权”可以帮助分离应用数据 —— 参见HD -配置数据授权

独立文件还是组合WAR文件?

CAST在WAR文件中提供健康仪表盘,必须将其部署到兼容的应用服务器(有关应用服务器支持的信息,请参见支持的平台)。然而CAST提供了两个WAR文件,其中包含健康仪表盘,如下所示:

WAR 文件名称描述
CAST-Health.war

旧版的“独立”WAR文件只包含健康仪表盘(以及CAST Rest API接口)。这个文档描述了如何使用这个WAR文件进行安装。

CAST-Health-Engineering.war

包含健康仪表盘和工程仪表盘(外加CAST Rest API接口)的“组合”WAR文件。

可以自由的使用想要部署健康仪表盘的任何WAR文件(两个WAR文件的要求和先决条件都相同),然而,如果同时使用CAST健康和工程仪表盘来完成(例如)一个“风险和质量”使用案例,那么利用CAST-Health-Engineering.war文件组合以及从同一个WAR文件部署两个仪表盘是有意义的。如果这样做,请注意以下关于使用“组合”WAR文件的说明:

  • 没有必要专门为工程仪表盘向下钻取数据(通过“显微镜”图标)配置URL——有关更多信息,请参见快照生成和验证:在使用组合的“WAR”文件时,从健康仪表盘对工程仪表盘的访问是预先配置的。
  • 安全访问和身份验证对于两个仪表盘都通用。因此,如果设置动态目录身份验证,那么必须使用它来访问两个仪表盘——当“静态列表”用于一个仪表盘时,“动态目录”不能用于另一个仪表盘。
  • 角色配置对于两个仪表盘都通用。因此,授予“admin”角色的“UserA”将在两个仪表盘中具有“admin”角色。
  • 数据授权对于两个仪表盘都通用。因此,如果仅通过authorizations.xml文件授权“UserA”查看应用“B”,那么这对于两个仪表盘都正确。请注意,当使用组合war文件时,只基于为健康仪表盘创建的标记类别(标记和类别是工程仪表盘中不可用的特性)的授权将应用于工程仪表盘。
  • 组配置对于两个仪表盘都通用,而与使用的身份验证模式无关。因此,如果授权“GroupD”仅查看应用“E”,那么这对于两个仪表盘都正确。
  • 登录后,用户将在“欢迎”页面中看到如下图1所示的仪表盘选项。点击Access将进入所选仪表盘自定义登录的界面,如果用户希望登录到另一个仪表盘(图2),则可以使用“Return to welcome page”URL:

图 1 —— Welcome page

图 2 —— Return to welcome page URL


需求

安装健康仪表盘(CAST HD)需要:

(tick)

Java JRE

必须安装在将托管应用服务器的机器上。有关JRE支持,请参见支持的平台

(tick)

应用服务器

必须安装在兼容的机器上。有关应用服务器支持,请参见支持的平台

(tick)

Web 浏览器

用于访问健康仪表盘。有关Web浏览器兼容性,请参见支持的平台

(tick)

测量服务

CAST存储服务上的专用模式(CAST测量服务)。

为了确保兼容性,必须只使用安装了CAST AIP版本的测量服务,该版本与正在安装的WAR的主版本、次版本或服务包版本号完全匹配。

  • 测量服务不支持其它RDBMS
  • 可能需要在CAST存储服务安装一个独立的测量服务(参见安装 CAST AIP 模式)例如:
    1. 只安装了CAST模式的“三元组”(即管理/分析/仪表盘服务)
    2. 已经从CAST AIP的上一个版本迁移过来,在上一个版本中,没有使用CAST测量服务(通常是CAST AIP 7.0.x)
    3. 管理/分析/仪表盘服务安装在Microsoft SQL 服务器/ Oracle服务器上(不支持安装测量服务)
    4. 希望安装多个健康仪表盘
  • 测量服务可以为多个管理服务激活(因此来自多个仪表盘服务的数据可以聚合到一个测量服务中)。
(tick)仪表盘服务(s)

可以从任意数量的仪表盘服务模式(受200个应用的限制)将数据合并到测量服务中。支持以下仪表盘服务:

CAST 仪表盘服务

AIP 版本支持
8.3.x(tick)
8.2.x(tick)
8.1.x(tick)
8.0.x(tick)
7.3.x(tick)
7.2.x(tick)
7.1.x(tick)
7.0.x(tick)

Host CSS/RDBMS

  • 所有支持的CSS/RDBMS平台

(tick)

WAR 文件

WAR文件(CAST-Health.war) ——可以从位于CAST AIP安装文件夹中的WARS文件夹中检索:

请注意,WAR文件必须来自CAST AIP的当前版本。

预安装检查列表

在开始安装程序前,请确保已执行了以下所有任务,并满足以下要求:

(tick)

请确保已经阅读了所有CAST产品版本发布信息,以获取最新的信息。

(tick)

决定将在何处安装健康仪表盘——CAST管理器、单独的专用计算机或其它用于CAST仪表盘现有的计算机。

(tick)

确保目标计算机上的用户登录具有足够的用户权限来安装应用 (参见附录- CAST管理工作站的安装和硬件要求)。

(tick)

确保已经为部署准备好所需的.WAR文件。

安装过程

本文假设在Windows环境中使用Apache Tomcat来托管健康仪表盘。如果在Linux环境中使用IBM Websphere 应用服务器,请参见附录 - HD - ED-RestAPI -部署在IBM WebSphere 应用服务器上

安装过程分为以下几个步骤:

步骤1:部署和配置应用服务器上的CAST-Health.war文件

 Click here to expand...

部署WAR 文件

位于CAST-Health.war文件,并将其移动到web应用安装位置。在Apache Tomcat上,默认设置为:

%CATALINA_HOME%\webapps
  • 如果Apache Tomcat服务器正在运行,那么.WAR文件将被解压并部署到一个名为“CAST-Health”的文件夹中。
  • 部署之后,配置context.xml文件用于告知web应用存储测量服务。这个文件位于:
%CATALINA_HOME%\webapps\CAST-Health\META-INF\context.xml

Tomcat 8 / 8.5简介

如果使用Tomcat 8 / 8.5来托管健康仪表盘,请遵循以下说明:

  • 使用文本编辑器打开context.xml文件(如上所述)。
  • 默认情况下,文件将包含未注释的模板(如下所示):该模板适合于使用Tomcat 8 / 8.5CAST存储服务2上的CAST测量服务模式进行连接。
<Resource name="jdbc/domains/AAD" url="jdbc:postgresql://localhost:2280/postgres"
          connectionInitSqls="SET search_path TO [Measure Schema];"
          username="operator" password="CastAIP"
 
          auth="Container" type="javax.sql.DataSource" driverClassName="org.postgresql.Driver"
          validationQuery="select 1"
          initialSize="5" maxTotal="20" maxIdle="10" maxWaitMillis="-1"/>
  • URL参数设置到测量服务所在的服务器:
    • 将“localhost”更改为主机CSS所在的服务器的名称
    • 如果使用CAST存储服务3,请将端口2280(CAST存储服务2)更改为2282
  • 改变[Measure Schema]的名称为测量服务(参见安装 CAST AIP 模式)。
  • 确保用户名密码参数正确(注意,如果您需要加密用户名和密码,以避免在明文输入名称,请参见:HD-ED -加密数据库和LDAP的登录和密码
  • 应该以段落结束:
<Resource name="jdbc/domains/AAD" url="jdbc:postgresql://NEFYN:2280/postgres"
            connectionInitSqls="SET search_path TO V83_MEASURE_CSS2;"
            username="operator" password="CastAIP"
  
            auth="Container" type="javax.sql.DataSource" driverClassName="org.postgresql.Driver"
            validationQuery="select 1"
            initialSize="5" maxTotal="20" maxIdle="10" maxWait="-1"/>
  • 在进行所有更改之后,保存context.xml文件,然后重新启动应用服务器以便更改生效。

注意:

  • 在使用健康仪表盘时,必须保留名称=“jdbc/domains/AAD”。请不要将域名“AAD”更改为任何其他内容。仪表盘要求将域设置为AAD,否则在尝试登录时将收到错误。
  • 对于测量服务模式,只应该声明一个资源(名为AAD)。
  • 根据消费使用案例和要配置的模式数量来配置initialSize、maxTotalmaxIdle参数是非常重要的。默认值很高,但可能会降低,以限制到数据库实例的活动连接的数量(例如。initialSize = " 2 " maxTotal = " 10 " maxIdle =“2”)。请参见“优化context.xml”部分,关于这些参数的更多信息,请参见HD -为大量应用配置健康仪表盘,或者参考相关的Apache Tomcat文档:https://tomcat.apache.org。

Tomcat 7的说明

如果使用Tomcat 7来托管健康仪表盘,请遵循以下说明:

  • 使用文本编辑器打开context.xml文件(如上所述)。
  • 默认情况下,文件将包含未注释的模板(如下所示):使用Tomcat 8 / 8.5将其调整为连接到CAST存储服务2上的CAST模式
<Resource name="jdbc/domains/AAD" url="jdbc:postgresql://localhost:2280/postgres"
          connectionInitSqls="SET search_path TO [Measure Schema];"
          username="operator" password="CastAIP"
 
          auth="Container" type="javax.sql.DataSource" driverClassName="org.postgresql.Driver"
          validationQuery="select 1"
          initialSize="5" maxTotal="20" maxIdle="10" maxWaitMillis="-1"/>
  • 需要在本段添加<!-- 和 -->来评论这个模板:
<!-- <Resource name="jdbc/domains/AAD" url="jdbc:postgresql://localhost:2280/postgres"
          connectionInitSqls="SET search_path TO [Measure Schema];"
          username="operator" password="CastAIP"
 
          auth="Container" type="javax.sql.DataSource" driverClassName="org.postgresql.Driver"
          validationQuery="select 1"
          initialSize="5" maxTotal="20" maxIdle="10" maxWaitMillis="-1"/>
-->
  • 现在找到Tomcat 7模板——它位于:
<!--  Tomcat 7 Documentation : http://ci.apache.org/projects/tomcat/tomcat7/docs/jndi-resources-howto.html -->
<!-- These connections examples on Tomcat 7 are provided for CSS connections especially useful for REST API on central database.
 
template for resources on CSS:
    <Resource name="jdbc/domains/${domainName}"
            url="jdbc:postgresql://${host}:${port}/postgres"
            username="${user}" password="${password}"
            initConnectionSqls="SET search_path TO ${schema};"
            auth="Container" type="javax.sql.DataSource" driverClassName="org.postgresql.Driver"
            validationQuery="select 1" initialSize="5" maxActive="20" maxIdle="10" maxWait="-1"/>
  • CSS模板上的资源模板复制到未注释的空白中:
<Resource name="jdbc/domains/${domainName}"
        url="jdbc:postgresql://${host}:${port}/postgres"
        username="${user}" password="${password}"
        initConnectionSqls="SET search_path TO ${schema};"
        auth="Container" type="javax.sql.DataSource" driverClassName="org.postgresql.Driver"
        validationQuery="select 1" initialSize="5" maxActive="20" maxIdle="10" maxWait="-1"/>
  • ${domainName}值设置为AAD
  • URL参数设置为仪表盘服务模式所在的服务器:
    • ${host}更改为主机CSS所在的服务器的名称
    • ${port}值更改为2280(CAST存储服务2)或2282(CAST存储服务3)
  • 确保$ { user }${password}参数正确,使用操作符CastAIP用户名/密码组合,如果没有改变这些默认值(注意,如果需要加密用户名和密码,以避免在明文输入名称,请参阅:HD-ED - 加密数据库和LDAP的登录和密码
<Resource name="jdbc/domains/AAD"
            url="jdbc:postgresql://NEFYN:2280/postgres"
            username="operator" password="CastAIP"
            initConnectionSqls="SET search_path TO V83_MEASURE_CSS2;"
            auth="Container" type="javax.sql.DataSource" driverClassName="org.postgresql.Driver"
            validationQuery="select 1" initialSize="5" maxActive="20" maxIdle="10" maxWait="-1"/>
  • 在进行所有更改之后,保存context.xml文件,然后重新启动应用服务器以便更改生效。

注意:

  • 在使用健康仪表盘时,必须确保name="jdbc/domains/${domainName}"始终设置为name="jdbc/domains/AAD"。请不要将域名“AAD”更改为其它任何内容。仪表盘要求将域设置为AAD,否则在尝试登录时将收到错误。
  • 对于测量服务模式,只应声明一个资源(名为AAD)。
  • 根据消费使用案例和要配置的模式数量来配置initialSize、maxActivemaxIdle参数是非常重要的。默认值很高,但可能会降低,以限制到数据库实例的活动连接的数量(例如。initialSize = " 2 " maxActive = " 10 " maxIdle =“2”)。请参见HD -为大量应用配置健康仪表盘中的“优化context.xml”部分获得这些参数的更多信息,或者参考相关的Apache Tomcat文档:https://tomcat.apache.org。

测试对健康仪表盘的访问

  • 现在可以使用URL测试健康仪表盘是否已部署:
http://<server_name>:[<port_number>]/CAST-Health
  • 登入页面如下:

错误消息记录在HD-ED - 错误提示消息中。

步骤2: 配置用户身份验证

步骤2涉及配置用户如何使用健康仪表盘进行身份验证。大多数组织选择LDAP/Active Directory集成,这样用户就可以使用公司用户名/密码访问所需的资源。健康仪表盘还有一个内置的用户名/密码身份验证机制,可以“开箱即用”。

有关更多信息,请参见配置用户身份验证

步骤3:配置数据授权

步骤3涉及配置数据授权。授权向用户或用户组定义访问健康仪表盘中特定应用并“使用数据”的权限。如果未授予权限,则与此应用相关的任何信息将不可访问:应用属性,如名称、技术或级别和测量等。因此必须在用户/用户组访问特定应用之前定义授权。

有关更多信息,请参见配置数据授权

步骤4:健康仪表盘中显示上传快照数据

 Click here to expand...

用户在健康仪表盘中查看任何数据之前,需要在快照数据生成之后上传(参见如何使用 CAST AIP 分析应用系统获得更多信息)。快照上传是使用CAST管理器实现的。

请注意,健康仪表盘可以正式支持最多200个应用的上传。CAST建议只从业务视图中选择最关键的应用——即此应用需要CIO和管理人员高度监视。

A - 激活测量服务

在上传快照数据之前,必须确保测量服务对于当前的管理服务(即在CAST 管理器中连接的管理服务)是激活的。测量服务可以为多个管理服务活动(因此可以上传来自多个仪表盘服务的数据)。

使用组合安装选项安装CAST AIP

如果:

  • 已经使用CAST 服务管理器中的组合安装选项“应用分析平台安装”从头安装了这个版本的CAST AIP
  • 或者使用从以前激活的健康仪表盘CAST AIP版本更新(上面CAST AIP的任何版本,包括7.3.x)

那么测量服务将与管理、分析和仪表盘服务一起安装,并在CAST 管理器中的服务视图中可见。在这种情况下,测量服务将已经处于激活状态:

独立的测量服务

如果:

  • 已经从健康仪表盘不可用的CAST AIP的上一个版本更新(在7.3.x之前的CAST AIP的任何版本,但不包括该版本)
  • 或者管理/分析和仪表盘服务安装在Microsoft SQL 服务器 / Oracle服务器上(不支持安装测量服务)

为了使用健康仪表盘,将在CSS2上安装一个独立的测量服务。在这种情况下,需要在做任何事情之前激活这个服务:

  • 打开CAST 管理器并移动到服务视图
    • 在从以前的CAST版本进行迁移的情况下——如果测量服务安装在与管理/分析/仪表盘服务相同的服务器(即CSS2)上,请选择托管CAST管理服务(_MNGT)的服务器,并选择Services > Discover来定位独立的测量服务:

    • 如果管理/分析/仪表盘服务安装在Microsoft SQL 服务器/Oracle 服务器上,而测量服务安装在CSS2上,那么需要添加CAST存储服务条目
      • 点击appropriate 图标:

      • 然后在编辑器中定义连接参数:

  • 选择新定义的服务器并进行选择 Services > Discover.

  • 在这两种情况下,独立测量服务将显示:

  • 接下来双击服务视图中的Measurement Service来编辑。

  • Active for the current Management Service将显示“No”,如上所示。
  • 单击 Activate.
  • 如果已经在CAST 管理器中有一个或多个应用,系统将提示选择是否上传为给定应用生成的所有快照的数据。如果不想上传某项应用的资料,请确保勾选相关的应用:

  • 点击Finish继续——上传过程将开始:

B-在测量服务处于激活状态时上传快照数据

当测量服务处于激活状态时,有两种方式将快照数据上传到测量服务:

  • 自动(在生成快照的同时)
  • 手动(如果在生成快照时选择不上传快照数据)。

可以在快照生成和验证中找到关于这些选项的更多信息。

还请注意健康仪表盘具有服务器缓存功能,以提高数据显示的速度。但是最近的数据更改(即新的快照生成)可能不会立即出现在仪表盘中。如果是这样,则需要手动重新加载服务器缓存。参见HD-ED -重载缓存

步骤5: 配置对工程仪表盘以及从健康仪表盘对旧版CAST工程仪表盘的服务

 Click here to expand...

健康仪表盘允许用户(通过“microscope”图标)在CAST仪表盘服务模式通过工程仪表盘或旧版CAST工程仪表盘直接访问底层数据。这两个仪表盘都提供有关健康仪表盘中显示的顶层数据的详细信息。此配置依赖于许可证。

通过存储在测量服务中的URL(指向所需的仪表盘)提供对底层数据的访问。

部署注意事项

  • 但是如果使用独立的CAST-Health.war / CAST-Engineering.war / CAST-CED.war文件进行单独的独立部署,那么访问工程仪表盘(ED)旧版CAST工程仪表盘(CED)不是自动实现的,将需要手动上传一个URL,如下所述。

结合WAR文件

如果已经从组合CAST-Health-Engineering.war文件中部署了健康仪表盘和工程仪表盘(如在安装和配置健康仪表盘安装和配置工程仪表盘所描述),那么访问工程仪表盘(ED)是自动实现的。

注意:

  • 自动访问仅针对每个CAST仪表盘服务实现,这些CAST仪表盘服务配置为在工程仪表盘中查看。因此,如果已经将来自CAST仪表盘服务的数据合并到CAST 测量服务中,以便在健康仪表盘中查看,但是还没有在工程仪表篇配置中声明这个CAST仪表盘服务,那么自动访问将不起作用,用户将被通知访问尚未配置。
  • 不能覆盖自动访问以指向单独的工程仪表盘部署。

独立 WAR 文件

如果使用独立的CAST-Health.war / CAST-Engineering.war / CAST-CED.war文件部署了健康仪表盘和工程仪表盘(如安装和配置健康仪表盘安装和配置工程仪表盘安装和配置旧版CAST工程仪表盘和发现门户),那么访问工程仪表盘(ED)或旧版CAST工程仪表盘(CED)不是自动实现的,需要按照以下步骤进行:

注意:

  • 希望用户能够向下钻取数据到的每个CAST仪表盘服务(工程仪表盘使用的CAST AIP模式)重复此操作。
  • 可能需要一个特定的许可证,以便在此功能在健康仪表盘中运行之前能够访问工程仪表盘。
  • 在尝试此操作之前,必须已经生成快照并将快照数据上传到测量服务
  • 独立的WAR文件必须来自同一个CAST AIP版本。不支持使用来自不同版本的WAR文件。

上传工程仪表盘的URL

  • 对于要向下钻取数据的每个CAST仪表盘服务,必须首先确定在工程仪表盘(ED)context.xml文件中定义的仪表盘服务的context "name"
  • 首先在文本编辑器中找到并打开以下文件:
%CATALINA_HOME%\webapps\CAST-Engineering\WEB-INF\context.xml
  • 以下面的示例为例,显示了三个CAST仪表盘服务,每个服务具有不同的context "names"context "names"是在第二个斜杠之后定义的值,例如name=“jdbc/domains/APP1”(即APP1))。将使用为V80_CENTRAL_APP1仪表盘服务定义的APP1名称
<Resource name="jdbc/domains/APP1" url="jdbc:postgresql://NEFYN:2280/postgres"
           initConnectionSqls="SET search_path TO V80_CENTRAL_APP1;"
           username="operator" password="CastAIP" 
           auth="Container" type="javax.sql.DataSource" driverClassName="org.postgresql.Driver"
           validationQuery="select 1"
           initialSize="5" maxActive="20" maxIdle="10" maxWait="-1"/>

<Resource name="jdbc/domains/APP2" url="jdbc:postgresql://NEFYN:2280/postgres"
           initConnectionSqls="SET search_path TO V80_CENTRAL_APP2;"
           username="operator" password="CastAIP" 
           auth="Container" type="javax.sql.DataSource" driverClassName="org.postgresql.Driver"
           validationQuery="select 1"
           initialSize="5" maxActive="20" maxIdle="10" maxWait="-1"/>

<Resource name="jdbc/domains/APP3" url="jdbc:postgresql://NEFYN:2280/postgres"
           initConnectionSqls="SET search_path TO V80_CENTRAL_APP3;"
           username="operator" password="CastAIP" 
           auth="Container" type="javax.sql.DataSource" driverClassName="org.postgresql.Driver"
           validationQuery="select 1"
           initialSize="5" maxActive="20" maxIdle="10" maxWait="-1"/>
  • 打开CAST 管理器并移动到服务视图
  • 双击相应的仪表盘服务以打开其编辑器(即本例中的V80_CENTRAL_APP1):

  • 输入工程仪表盘的URL。以下形式:http://<server>:<port>/CAST-Engineering/engineering/index.html#<context-name> ——应该将<server><port> 和条目自定义到环境中。<context-name>值引用在前面的示例APP1中确定的值。因此,将添加以下URL: http://TOMCAT:8080/CAST-Engineering/engineering/index.html#APP1
  • 单击Add URL到测量服务
  • 重新启动应用服务器以便更改生效。
  • 现在用户可以向下钻取数据到工程仪表盘。

上传旧版CAST工程仪表盘的URL

  • 只需在上面的URL字段中输入URL,格式为http://<server>:[<port>]/CAST-CED(应该将<server>和<port> 条目自定义到环境中)

附加信息

可以在健康仪表盘-高级配置中找到关于高级配置更改的附加信息,例如:   

可以找到关于健康仪表盘高级安全配置更改的附加信息,例如:

关于在Web应用部署常见安全配置选项中为应用服务器实现增强安全配置的附加信息:

  • No labels