55.5 升级 Identity Applications 和支持组件

本节提供有关升级 Identity Applications 和支持软件的信息，其中包括更新以下组件的内容：

  • Identity Manager User Application

  • One SSO Provider (OSP)

  • Self-Service Password Reset (SSPR)

  • Tomcat、JDK 和 ActiveMQ

NetIQ 提供了一个升级程序来升级这些组件。此程序位于 Identity Manager 安装包的 products/RBPM/ 目录中。导航到包含以下升级文件的目录：

  • Linux：RBPM_upgrade.bin

  • Windows：RBPM_upgrade.exe

本节提供了以下信息：

55.5.1 了解升级程序

升级进程会从现有组件中读取配置值。这些信息包括 ism-configuration.properties、server.xml、SSPRConfiguration 和其他配置文件。升级进程会使用这些配置文件在内部调用各组件的升级程序。此外，此程序还会创建当前安装的备份。

55.5.2 升级的先决条件和注意事项

在执行升级之前，请先查看以下注意事项：

  • Identity Manager 已升级到版本 4.5.5： 您不能从低于 4.5.5 的版本升级或迁移到版本 4.6。有关如何升级到 Identity Manager 4.5 的详细信息，请参见《NetIQ Identity Manager 安装指南》中的“升级 Identity Manager”。

  • Role and Resource Service 驱动程序包已升级： 有关详细信息，请参见《NetIQ Designer for Identity Manager Administration Guide》（NetIQ Designer for Identity Manager 管理指南）中的“Upgrading Installed Packages”（升级安装的包）。

  • 使用 Tomcat 作为应用程序服务器： 此版本的 Identity Manager 仅支持使用 Tomcat 作为应用程序服务器。

    注：确保您已在 Identity Manager 4.5 安装期间使用便捷安装程序安装 Tomcat 应用程序服务器。升级进程只允许您升级使用便捷安装程序安装的 Tomcat。

    如果用于运行 Identity Applications 的应用程序服务器不是 Tomcat，请将应用程序服务器迁移到 Tomcat。有关详细信息，请参见部分 58.6, 从 Websphere 或 JBoss 迁移到 Tomcat Web 应用程序服务器。

  • 数据库平台已升级： 此程序不会升级 Identity Applications 的数据库平台。请手动将当前的数据库版本升级到支持的版本。要升级 PostgreSQL 数据库，请参见升级 PostgreSQL 数据库。

  • 确保 User Application 环境名称设置为默认名称： 如果您已将 User Application 环境名称设置为非默认名称（不是 IDMProv），则需要更改环境名称。有关详细信息，请参见更改 User Application 的自定义环境名称。

  • Self Service Password Reset: 如果要从 SSPR 4.0 升级，请确保您已更新 CATALINA_OPTS 属性，并且 -Dsspr.application.Path 设置为储存 SSPR 配置的文件夹。

    例如：

    Linux： export CATALINA_OPTS="-Dsspr.applicationPath=/home/sspr_data

    Windows： set CATALINA_OPTS="-Dsspr.applicationPath=C:\sspr_data

    在升级前备份 SSPR LocalDB。要导出或下载 LocalDB，请执行以下步骤：

    1. 以管理员身份登录 SSPR 门户。

    2. 在页面右上角的下拉菜单中单击配置管理器。

    3. 单击 LocalDB。

    4. 单击下载 LocalDB。

升级 PostgreSQL 数据库

要升级 PostgreSQL 数据库，请完成以下步骤：

重要说明：升级过程可能需要一段时间，时间长短取决于数据库大小。因此，请相应规划您的升级。

  1. 停止服务器上正在运行的 PostgreSQL 服务。

  2. 重命名以下位置的 postgres 文件夹：

    Linux： /opt/netiq/idm/apps

    Windows： C:\Netiq\IdentityManager\apps

    例如，将 postgres 重命名为 postgresql_9_3。

  3. 装入 Identity_Applications_版本_平台.iso 映像文件，浏览到包含 PostgreSQL 安装程序的目录。

    <iso 提取路径>/products/RBPM/postgre_tomcat_install

  4. 安装 PostgreSQL 应用程序。从列表中选择 PostgreSQL：

    • Linux (GUI)： 运行 ./TomcatPostgreSQL.bin

    • Linux（控制台)： 运行 ./TomcatPostgreSQL.bin -i console

    • Windows： 运行 TomcatPostgreSQL.exe

    安装期间，请只选择 PostgreSQL 选项。

    注：在 PostgreSQL 细节页面，不要选中创建数据库登录帐户和创建空数据库复选框。

  5. 停止服务器上新安装的 PostgreSQL 服务。

  6. 使用以下命令更改 PostgreSQL 目录的拥有者：

    chown -R postgres:postgres <postgres directory location>

    例如：

    chown -R postgres:postgres /opt/netiq/idm/apps/postgres

  7. 使用以下命令切换为 postgres 用户：

    su - postgres

    1. 切到到 postgres/bin 目录。

    2. 使用以下命令导出 PostgreSQL 安装位置：

      export PATH=/opt/netiq/idm/apps/postgres/bin:$PATH

    3. 使用以下命令导出 PostgreSQL 口令：

      export PGPASSWORD=<输入数据库口令>

  8. 使用以下命令升级 PostgreSQL：

    pg_upgrade --old-datadir <旧 postgres 位置\data> --new-datadir <新 postgres 位置\data> --old-bindir <旧 postgres 位置\bin> --new-bindir <新 postgres 位置\bin>

    例如，。/pg_upgrade --old-datadir /opt/netiq/idm/apps/postgresql_9_3/data/ --new-datadir /opt/netiq/idm/apps/postgres/data/ --old-bindir /opt/netiq/idm/apps/postgresql_9_3/bin --new-bindir /opt/netiq/idm/apps/postgres/bin/

    成功升级后，该应用程序会显示讯息提示您运行 analyze_new_cluster.sh 和 delete_old_cluster.sh。

  9. 启动新的或升级后的 PostgreSQL 数据库服务。

  10. 切换为 postgres 用户，然后运行 analyze_new_cluster.sh。

    su - postgres ./analyze_new_cluster.sh

    确保脚本执行时未出现错误。

  11. 浏览到 /opt/netiq/idm/apps/postgres/bin，然后以 root 用户身份运行 delete_old_cluster.sh。

    ./delete_old_cluster.sh

更改 User Application 的自定义环境名称

如果您之前将 User Application 环境名称设置为非默认名称（不是 IDMProv），请完成以下步骤将环境名称更改为默认环境名称 IDMProv。

注：您可以在 ism-configuration.properties 文件的 portal.context 属性中校验环境名称。

  1. 停止 Tomcat 服务。

    /etc/init.d/idmapps_tomcat_init stop

  2. 浏览到 webapps 文件夹，并将非默认环境名称的文件夹重命名为 IDMProv。

    Linux： /opt/netiq/idm/apps/tomcat/webapps

    Windows： C:\Netiq\IdentityManager\apps\tomcat\webapps

    例如，如果 ism-configuration.properties 文件中的 portal.context 名称为 IDMDev，请将文件夹名称从 IDMDev 更改为 IDMProv。

  3. 运行 Identity Applications 升级程序。请参见部分 55.5.4, 使用指导式过程进行升级或部分 55.5.5, 以无提示模式升级 Identity Manager 应用程序。

  4. 升级 Identity Applications 后，将 WAR 文件恢复为您原来的环境名称。有关详细信息，请参见Identity Applications。

55.5.3 系统要求

升级进程会为所安装组件的当前配置创建备份。确保服务器具有足够储存备份的空间，另外还有可供升级的可用空间。

55.5.4 使用指导式过程进行升级

下面的过程说明如何使用向导升级 Identity Applications、OSP、SSPR、Tomcat 和 ActiveMQ 应用程序。

  1. 以 root 或管理用户身份登录要用来运行升级进程的服务器。

  2. 装入 Identity_Applications.iso 映像文件，浏览到包含升级可执行文件的目录（默认位于 products/RBPM/ 目录中）。

  3. 起动升级程序。根据您的平台，执行以下其中一个文件：

    • Linux： RBPM_upgrade.bin

    • Windows： RBPM_upgrade.exe

  4. 在简介页面上，您可以查看可升级的 Identity Manager 组件，然后单击下一步。

  5. 阅读并接受许可协议，然后单击下一步。

  6. 查看已部署的应用程序页面，然后单击下一步。

    此页面会列出当前已安装的组件，还会列出 Tomcat 和 JRE 的版本和安装目录。如果在该服务器上部署了其他应用程序，则升级进程会显示警告，指出升级后这些应用程序可能会无法正常工作。

    例如，Identity Reporting 或用户定义的 war 文件。您必须手动从升级进程创建的备份恢复它们。

  7. 要继续升级，请单击下一步。

  8. 使用以下参数完成引导式过程。此程序会自动填充现有组件的值。确保为参数指定了正确的值。

    • One SSO Provider

      表示升级程序要在其中创建 OSP 应用程序文件的目录路径。如果该路径不正确，请浏览到 OSP 的安装路径。

    • SSPR

      表示升级程序要在其中创建 SSPR 应用程序文件的目录路径。如果该路径不正确，请浏览到 SSPR 的安装路径。

    • 用户应用程序

      表示升级程序要在其中创建 User Application 应用程序文件的目录路径。如果该路径不正确，请浏览到 User Application 的安装路径。

    • 数据库连接

      表示用于连接 User Application 数据库的设置，Identity Applications 也会连接到此数据库。升级程序会将这些细节包含在 User Application 配置文件中。

      数据库平台

      表示 User Application 数据库的平台。

      数据库主机

      指定托管 User Application 的服务器的名称或 IP 地址。

      数据库端口

      指定数据库服务器用于与 User Application 通讯的端口。

      数据库驱动程序 JAR

      指定数据库平台的 jar 文件。

      数据库供应商将提供驱动程序 JAR 文件，即数据库服务器的 JAR。例如，对于 PostgreSQL，可以指定默认位于 opt/netiq/idm/apps/postgres 文件夹（Linux 上）和 C:\netiq\idm\apps\postgres（Windows 上）的 postgresql-9.4-1212.jdbc42.jar。同样，指定您数据库平台的相应 jar 文件。

    • 数据库身份凭证

      数据库名称

      指定数据库的名称。默认情况下，数据库名称为 idmuserappdb。

      数据库用户名

      指定允许 User Application 访问和修改数据库中数据的帐户名。数据库用户名默认为 idmadmin。

      数据库口令

      为指定用户名指定口令。

    • 升级数据库

      立即升级数据库

      升级程序会在升级过程中为数据库表更新纲要。

      在应用程序启动时升级数据库

      升级程序会下达在升级后 User Application 首次启动时为数据库表更新纲要的指令。

      将 SQL 写入文件

      生成一个 SQL 脚本，数据库管理员可以运行该脚本来更新数据库。如果选择此选项，则还必须为纲要文件指定名称。设置位于 SQL 输出文件配置中。如果您无权在您的环境中创建或修改数据库，可以选择此选项。有关使用该文件生成表的详细信息，请参见部分 39.2, 手动创建数据库纲要。

    • 数据库管理员

      表示数据库管理员的名称和口令。

      数据库用户名

      指定可创建数据库表、视图和其他项目的数据库管理员帐户。

      口令

      指定数据库管理员的口令。

    • 备份文件夹

      根据组件的安装位置，安装进程会在该位置创建备份目录，并在备份目录中追加时戳（指示备份时间）。

      例如，

      • Tomcat：/opt/netiq/idm/apps/tomcat_backup_02262017_033634

      • OSP 和 SSPR：/opt/netiq/idm/apps/osp_sspr_backup_02262017_033634

      • ActiveMQ：/opt/netiq/idm/apps/activemq_backup_02262017_033634

      • User Application：/opt/netiq/idm/apps/UserApplication_backup_02262017_033634

  9. 复查升级前摘要页面，然后单击安装。

    升级进程会停止 Tomcat 服务并开始升级，完成此过程可能需要一段时间。

  10. 当升级过程完成时，查看 /tmp/rbpm_upgrade/ 中的升级日志文件，您需要手动更新数个配置，请参见部分 55.5.6, 升级后任务。

55.5.5 以无提示模式升级 Identity Manager 应用程序

无提示（非交互式）安装不显示用户界面。

  1. 以 root 用户或管理员身份登录要升级 Identity Manager 应用程序的服务器。

  2. 打开一个终端会话。

  3. 在属性文件中为安装指定相应的值。

    • Linux：products/RBPM/RBPM_Upgrade_Linux.properties

    • Windows：products\RBPM\RBPM_Upgrade_Win.properties

  4. 要起动适用于您平台的升级程序，请输入以下命令：

    • Linux：RBPM_Upgrade.bin -i silent -f RBPM_Upgrade_Linux.properties

    • Windows：RBPM_Upgrade.exe -i silent -f RBPM_Upgrade_Win.properties

    注：如果 RBPM_Upgrade_Linux.properties 文件与安装程序脚本不在同一目录，您必须指定该文件的绝对路径。该脚本会将必要的文件解压缩到一个临时目录，然后起动无提示安装。

55.5.6 升级后任务

完成升级后，必须手动恢复 Tomcat、SSPR、OSP 或 Identity Applications 的自定义设置。

针对所需组件执行升级后步骤：

Java

对照较旧 JRE 位置，校验新升级的 JRE 位置中的证书：jre/lib/security/cacerts。手动将缺少的证书导入到 cacerts 中。

  1. 使用 keytool 命令导入 java cacerts：

    keytool -import -trustcacerts -file Cerificate_Path -alias ALIAS_NAME -keystore cacerts

    注：升级后，JRE 储存在 Identity Applications 安装位置。例如：/opt/netiq/idm/apps/jre

  2. 校验 JRE 主目录位置。

    Linux： tomcat/bin/setenv.sh

    Windows： tomcat/bin/setenv.bat

  3. 起动配置更新实用程序，并校验您的 cacerts 路径。

Tomcat 应用程序服务器

  1. （视情况而定）从升级进程先前创建的备份恢复自定义文件。

    示例：

    • 自定义的 https 证书。要恢复配置，请将备份的 server.xml 中的 Java Secure Socket Extension (JSSE) 内容复制到 /tomcat/conf 目录下的新 server.xml 文件中。

    • 不要将备份的 Tomcat 目录中的配置文件复制到新 Tomcat 目录中。应根据需要在新版本默认配置的基础上进行更改。有关详细信息，请参见此 Apache 网站。

    • 如果您自定义了密钥存储区文件，请在新 server.xml 文件中包括正确的路径。

  2. （视情况而定）浏览到 Identity Manager User Application，然后通过读取备份的配置手动恢复自定义设置。

Identity Applications

从升级过程中创建的备份恢复 Identity Applications 自定义配置。

如果您在运行升级程序前已将自定义环境文件夹重命名为 IDMProv，则应使用 configupdate 实用程序将该环境文件夹名称更改为原来的环境名称。例如，原来的自定义环境名称为 IDMDev，现在它被重命名为 IDMProv。

请完成以下步骤将环境名称改回为原来的环境名称：

  1. 浏览到 User Application 目录 /opt/netiq/idm/apps/UserApplication。

  2. 起动 configupdate 实用程序。

    Linux： configupdate.sh

    Windows： configupdate.bat

  3. 在 User Application 选项卡中单击高级选项，然后执行以下步骤：

    1. 选中更改 RBPM 环境名称复选框。

    2. 将 RBPM 环境名称更改为原来的环境名称。

    3. 浏览并选择相应的角色驱动程序 DN，然后单击确定。

    4. 使用以下命令更改 WAR 文件的许可权限和所有权。

      chmod 755 <Original_Context_Name>.war; chown -R novlua:novlua <Original_Context_Name>.war

      例如，如果原来的自定义环境名称为 IDMDev：

      chmod 755 IDMDev.war; chown -R novlua:novlua IDMDev.war

  4. （视情况而定）如果您已完成所有升级后任务，则请启动 Identity Applications 的 Tomcat 服务。

One SSO Provider

如果 OSP 和 User Application 部署在不同的服务器上，则请使用配置更新实用程序更新 SSO 客户端参数。有关更多信息，请参见部分 40.4, SSO 客户端参数中的部分 40.4.3, IDM 仪表板。

位于 /etc/logevent.conf 文件中的 LogHost 条目默认设置为 localhost。

要修改 LogHost 条目，请手动从升级过程中创建的备份恢复 OSP 自定义配置。

Self-Service Password Reset

升级 SSPR 后，使用配置更新实用程序更新 SSO 客户端参数。有关更多信息，请参见部分 40.4, SSO 客户端参数中的部分 40.4.8, Self Service Password Reset。

要更新 SSPR 配置细节，请执行以下步骤：

  1. 以管理员身份登录 SSPR 门户。

  2. 更新审计服务器细节：

    1. 导航到配置编辑器，指定配置口令。

    2. 选择设置 > 审计 > 审计转发 > Syslog 审计服务器证书。

    3. 从服务器导入这些证书，然后单击保存。

  3. 将 LocalDB 导入 SSPR：

    1. 在页面右上角的下拉菜单中单击配置管理器。

    2. 单击 LocalDB。

    3. 单击导入（上载）LocalDB 存档文件。

  4. 配置 SSPR 的管理员许可权限，请参见部分 32.3, 安装后任务

    注：如果您是从 SSPR 4.0 升级到 SSPR 4.1，SSPR 配置的自定义位置将会变为 SSPR 4.1 的默认位置。在 setenv.sh 文件中可以找到更多有关配置位置的信息。不过，此更改不会影响组件的行为。

    例如，如果升级前 SSPR 配置的路径为 -Dsspr.applicationPath='/home/sspr-data，则升级后该路径会变为 -Dsspr.applicationPath=/opt/netiq/idm/apps/osp_sspr/sspr/sspr_data，并且会恢复此位置中所有关联的配置。

要校验升级是否成功，请起动升级的组件。

例如，起动 Identity Manager 仪表板，单击关于。检查应用程序显示的是否为新版本，例如 4.6.0。