以下过程描述如何通过 GUI 或控制台,使用安装向导安装 Identity Applications。要执行无提示或无人照管安装,请参见部分 33.3, 以无提示模式安装 Identity Applications。
要准备安装,请查看部分 33.1, Identity Applications 安装核对清单中所列的活动。另请参见版本随附的《发行说明》。
注:
安装程序不会保存您在向导的各个窗口中输入的值。如果单击上一步返回到前一个窗口,则必须重新输入配置值。
安装程序将创建 novlua 用户帐户,并在应用程序服务器文件中为此用户设置许可权限。例如,idmapps_tomcat_init 脚本将使用此用户帐户来运行 Tomcat。
当您在 WebSphere 上部署主页和仪表板 war 时:
将模块映射到服务器选项会显示两个 war 的 uadash 模块值。URI 值必须与要部署的 war 匹配。
映射 Web 模块的环境根选项会显示两个 war 的 uadash 模块值。URI 值必须与要部署的 war 匹配。
使用与其 .war 文件名匹配的环境值部署 war。对于 dash.war,请指定 dash 作为环境值;对于 landing.war,请指定 landing 作为环境。
确保在 User Application (IDMProv.war) 所在的同一个 WebSphere 节点上部署 war 文件。
在 WebSphere 上部署 Catalog Administrator (rra.war) 时,请在映射 Web 模块的环境根中指定 rra 作为环境值。确保在 User Application (IDMProv.war) 所在的同一个 WebSphere 节点上部署 rra.war。
以 root 或管理用户身份登录到要安装 Identity Applications 的计算机。
(视情况而定)要在 WebSphere 环境中安装,请对支持的 IBM JDK 应用非受限策略文件。
有关详细信息,请参见 IBM 文档获取这些文件的链接以及应用这些文件的指示。非受限策略文件的 JAR 文件必须位于 JAVA_HOME\jre\lib\security 目录中。
如果没有这些非受限策略文件,将显示“非法的密钥大小”错误。出现此问题的根本原因是缺少未受限策略文件,因此请确保使用正确的 IBM JDK。
停止应用程序服务器(例如 Tomcat)。
(视情况而定)如果您已获取 Identity Manager 安装包的 .iso 映像文件,请浏览到包含安装文件的目录(默认为 products/RBPM/user_app_install 目录)。
(视情况而定)如果您已下载安装文件,请完成以下步骤:
浏览到所下载映像的 .tgz 或 win.zip 文件。
将该文件的内容解压缩到本地计算机上的某个目录中。
从包含安装文件的目录完成以下操作之一:
Linux(控制台):输入 ./IdmUserApp.bin -i console
Linux (GUI):输入 ./IdmUserApp.bin
Windows:运行 IdmUserApp.exe
使用以下参数完成引导式过程:
应用程序服务器平台
表示要运行 Identity Applications 的应用程序服务器。必须已安装该应用程序服务器。
为方便起见,NetIQ 提供了 Tomcat。
安装文件夹
表示安装程序要在其中创建应用程序文件的目录路径。
数据库平台
表示 User Application 数据库的平台。必须已安装数据库软件。但是,在安装期间,您无需创建数据库纲要。
为方便起见,NetIQ 提供了 PostgresSQL。
数据库主机和端口
表示托管 User Application 数据库的服务器的设置。
注:在群集环境中,必须为群集中的每个成员指定相同的数据库设置。
指定服务器的名称或 IP 地址。
指定您希望服务器在与 User Application 通讯时所使用的端口。
数据库用户名和口令
表示运行 User Application 数据库的设置。
注:
如果您在安装此版 Identity Manager 的过程中安装了 PostgreSQL,则安装过程已创建了数据库和数据库管理员。默认情况下,安装的数据库为 idmuserappdb,数据库用户为 idmadmin。指定您在安装 PostgreSQL 时使用的相同值。
在群集环境中,必须为群集中的每个成员指定相同的数据库名称、用户名和口令。
根据数据库平台指定数据库的名称。默认情况下,数据库名称为 idmuserappdb。
对于 PostgreSQL 或 SQL Server 数据库,请指定名称。
对于 Oracle 数据库,请指定您为数据库实例创建的安全标识符 (SID)。
指定允许 User Application 访问和修改数据库中数据的帐户名。
为指定用户名指定口令。
指定数据库平台的 JAR 文件。
数据库供应商将提供驱动程序 JAR 文件,该文件即为数据库服务器的瘦客户端 JAR。例如,对于 PostgreSQL,可以指定默认位于 opt\netiq\idm\apps\Postgres 文件夹中的 postgresql-9.3-1101.jdbc41.jar。
NetIQ 不支持第三方供应商提供的驱动程序 JAR 文件。
数据库管理员
可选
表示数据库管理员的名称和口令。
此字段会自动列出您为“数据库用户名和口令”指定的同一用户帐户和口令。要使用该帐户,请不要做任何更改。
(可选)指定可创建数据库表、视图和其他项目的数据库管理员的帐户。
(可选)指定数据库管理员的口令。
创建数据库表
指定是否要在安装过程中或安装后配置新的或现有的数据库。
安装程序将在安装过程中创建数据库表。
安装程序将下达指令,以在首次启动 User Application 时创建表。
生成一个 SQL 脚本,数据库管理员可以运行该脚本来创建数据库。如果选择此选项,则还必须为纲要文件指定名称。该设置在 SQL 输出文件配置中指定。
如果您无权在环境中创建或修改某个数据库,则可以选择此选项。有关使用该文件生成表的详细信息,请参见部分 35.1, 手动创建数据库纲要。
新数据库或现有数据库
仅当您计划在安装期间创建表或者计划写入 SQL 文件时才适用。
指定是要使用现有的空数据库还是让安装创建新的数据库。请注意以下事项:
如果您在安装此版 Identity Manager 的过程中安装了 PostgreSQL,请选择现有数据库。PostgreSQL 安装已经创建了数据库和数据库管理员。默认数据库为 idmuserappdb,数据库用户为 idmadmin。
要使用先前安装中的现有数据库,该数据库不能包含任何数据或表。否则,安装可能会生成错误。
如果现有数据库在 Oracle 平台上运行,则您必须在更新纲要之前准备好 Oracle。有关详细信息,请参见部分 54.6.1, 准备 Oracle 数据库以运行 SQL 文件。
测试数据库连接
指定您是希望安装程序连接到数据库后直接创建表,还是在连接后创建 .sql 文件。
在您单击下一步或按 Enter 后,安装程序即会尝试建立连接。
注:如果数据库连接失败,您可以继续安装。但是,必须在安装后手动创建表并连接到数据库。有关详细信息,请参见部分 35.1.2, 手动创建 SQL 文件以生成数据库纲要。
Java 安装
表示用于起动安装程序的 JRE 文件的路径。例如:/root/opt/java/jre7。
Application_Server 配置
表示应用程序服务器的安装文件的路径。例如:/opt/apache-tomcat-7.0.52。安装过程会将一些文件添加到此文件夹中。
IDM 配置
表示 URL 中使用的 Identity Applications 环境的设置以及工作流程引擎的设置。
仅当您在 JBoss 群集中的某个节点上安装供应 WAR 文件时才适用。
指定应用程序服务器的配置。例如,如果此安装在未加入群集的单个节点上进行,请选择默认。
如果选择所有,则必须指定工作流程引擎 ID。
指定表示应用程序服务器配置的名称、应用程序 WAR 文件以及 URL 环境中的名称。
安装脚本将创建服务器配置,然后根据您在安装应用程序服务器时创建的名称命名该配置。例如:IDMProv。
重要说明:NetIQ 建议您记下指定的应用程序环境。当您从浏览器启动 Identity Applications 时,将会在 URL 中用到此应用程序名称。
仅当您在 JBoss 群集中的某个节点上安装供应 WAR 文件时才适用。
指定工作流程引擎的 ID。
引擎 ID 不能超过 32 个字符。有关工作流程引擎 ID 的详细信息,请参见《User Application: Administration Guide》(User Application:管理指南)中为群集配置工作流程的相关章节。
选择审计日志记录类型
指定是否要将日志事件发送到审计服务器。指定是或否。
Audit 日志记录
仅当您为“选择审计日志记录类型”指定了“是”时才适用。
指定要启用的日志记录类型。
有关设置日志记录的详细信息,请参见《User Application Administration Guide》(User Application 管理指南)。
通过适用于 User Application 的 Novell 或 NetIQ 客户端启用日志记录。
注:如果选择此选项,则还必须指定客户端服务器的主机名或 IP 地址,以及日志超速缓存的路径。这些设置在 Novell Identity Audit 或 NetIQ Sentinel 配置部分中指定。
允许 User Application 向 OpenXDAS 日志服务器发送事件。
安全 - 主密钥
指定是否要导入现有的主密钥。User Application 使用主密钥来访问加密的数据。指定是或否。
在以下情况下,可能会想要导入主密钥:
在群集中安装 Identity Applications 的第一个实例后。群集中 User Application 的每个实例必须使用相同的主密钥。有关详细信息,请参见部分 32.3.3, 为群集中的每个用户应用程序使用相同的主密钥。
您要将安装从过渡系统迁移到生产系统,并希望依然能够访问您在过渡系统中使用的数据库。
您要恢复 User Application,并想要访问先前版本的 User Application 所储存的加密数据。
指定您想要导入现有的主密钥。
指定您要让安装程序创建该密钥。
默认情况下,安装过程会将加密的主密钥写入安装目录中的 master-key.txt 文件。
导入主密钥
仅当您为“安全 - 主密钥”指定了“是”时才适用。
指定您要使用的主密钥。可以从 master-key.txt 文件中复制主密钥。
应用程序服务器连接
表示用户连接应用程序服务器上的 Identity Applications 时所需的 URL 的设置。例如:https:myserver.mycompany.com:8080。
注:如果 OSP 在不同的应用程序服务器实例上运行,则您还必须选择连接外部鉴定服务器并指定 OSP 服务器的值。
指定是要使用 http 还是 https。要使用安全套接字层 (SSL) 进行通讯,请指定 https。
指定托管 OSP 的服务器的 DNS 名称或 IP 地址。请不要使用 localhost。
指定您希望服务器在与客户端计算机通讯时所使用的端口。
指定是否要用不同的应用程序服务器实例来托管鉴定服务器 (OSP)。鉴定服务器包含可登录 SSPR 的用户的列表。
如果选择此设置,则还要指定鉴定服务器的协议、主机名和端口值。
鉴定服务器细节
指定您希望 Identity Applications 在连接鉴定服务器时所使用的口令。该口令又称为客户端机密。安装过程将创建此口令。
(视情况而定)要在安装后配置 Identity Applications 的设置,请单击“Roles Based Provisioning Module 配置”窗口中的取消。
注:安装 User Application 后,您可以修改 configureupdate.sh 或 configureupdate.bat 文件中的大部分设置。有关指定设置值的详细信息,请参见部分 36.0, 配置 Identity Applications 的设置。
(视情况而定)在 GUI 安装中,如果要立即配置 Identity Applications,请在“配置 IDM”窗口中完成以下步骤:
单击是,然后单击下一步。
在“Roles Based Provisioning Module 配置”中,单击显示高级选项。
根据需要修改设置。
注:
有关指定值的详细信息,请参见部分 36.0, 配置 Identity Applications 的设置。
在生产环境中,所有管理员指派都受到许可限制。NetIQ 会收集审计数据库中的监视数据,以确保生产环境符合要求。此外,NetIQ 还建议仅向一个用户授予安全管理员的许可权限。
单击确定。
(视情况而定)在控制台安装中,如果要立即配置 Identity Applications,请完成以下步骤:
从命令行起动配置更新实用程序:
Linux:configupdate.sh
Windows:configupdate.bat
(可选)要创建 NMAS 证书,请浏览到 SSO 客户端 > RBPM,然后将 RBPM 至 eDirectory SAML 配置更改为自动。
根据部分 36.0, 配置 Identity Applications 的设置中所述指定其他设置的值。
单击下一步。
在“安装前摘要”窗口中单击安装。
(可选)查看安装日志文件。要了解基本安装的结果,请参见 /opt/netiq/idm/apps/UserApplication/logs/ 目录中的 user_application_install_log.log 文件。
有关 Identity Applications 配置的信息,请参见 /opt/netiq/idm/apps/UserApplication/ 目录中的 NetIQ-Custom-Install.log 文件。
(可选)如果使用的是外部口令管理 WAR,请手动将 WAR 复制到安装目录和运行外部口令 WAR 功能的远程应用程序服务器部署目录。
(视情况而定)如果要在 JBoss Enterprise Application Platform (EAP) 上安装 Identity Applications,请继续JBoss 的安装后步骤。
(视情况而定)在 WebSphere 环境中,为 User Application 创建新的 JVM 系统属性。有关详细信息,请参见部分 33.6.2, 添加 User Application 配置文件和 JVM 系统属性。
根据部分 35.0, 完成 Identity Applications 的安装中所述继续执行安装后任务。