5.4 安装用户应用程序

创建用户应用程序之后,便可以安装 Identity Manager 用户应用程序。

5.4.1 关于安装程序

Novell Identity Manager 用户应用程序是一个需要部署到 JBoss 应用程序服务器的 Java 万维网应用程序档案 (WAR) 文件。 它使用数据库(默认情况下为 MySQL)储存配置信息。 根据选择的安装类型,用户应用程序安装程序还可以完成下列任务:

  • 安装 JBoss 或用于指定 JBoss 的现有版本
  • 安装 MySQL,或用于指定 MySQL、Oracle 或 Microsoft SQL Server 2000 的现有版本。
  • 配置 JRE 的证书文件,以便用户应用程序(在 JBoss 上运行)能够安全地与 Identity Vault 和用户应用程序驱动程序通讯。
  • 配置 WAR 文件并将其部署到 JBoss 应用程序服务器。
  • 启用 Novell Audit 日志记录。

安装底稿和可执行文件

要安装 Novell Identity Manager 用户应用程序,需要下列文件:

文件

说明

Linux 平台

  • IdmUserApp.bin

Windows 平台

  • IdmUserApp.exe

启动安装程序。

用户应用程序 WAR

IDM.war: 包括具有身份自助服务功能的 Identity Manager 3 用户应用程序。

IDMProv.war: 安装 Provisioning Module for Identity Manager 3。

提示:确保在安装计算机上停止其它任何 MySQL 版本。 在安装过程中,如果有其它版本在运行,安装程序将不会启动新的 MySQL 服务器,并且不会创建新的数据库。

要启动安装程序,请执行下列操作:

  1. 获取安装底稿和可执行文件中说明的相应安装文件。

  2. 如下所述启动适用于您的平台的程序:

    平台

    操作

    Linux

    1. 以非根帐户的身份登录,并打开一个终端会话。

      必须以根用户以外的身份登录 Linux 计算机。 如果已经以根用户的身份登录,请注销后以其他用户的身份重新登录。 不要只是对终端会话中的另一个帐户执行《su》操作,因为图形状态不会转换为另一个帐户。 (也不建议执行《sux》操作。)

    2. 在控制台上执行以下命令:
      ./IdmUserApp.bin
      

    底稿将会解包 Java 运行时环境 (JRE),并启动 Zero-G 安装程序。

    Windows

    在 Windows 上,双击 \NT 目录中的 IdmUserApp.exe 文件。

  3. 阅读许可协议,然后单击《I accept the terms of the License Agreement(我接受本许可协议的条款)

  4. 在安装向导的《简介》页中单击《下一步》

    选择安装集
  5. 选择安装集,然后单击《下一步》

    安装选项

    功能

    默认

    安装和配置以下项目:

    • IDM 用户应用程序 WAR
    • JBoss: 安装 JBoss 应用程序服务器,或配置现有的 JBoss 应用程序服务器。 对于新的应用程序服务器,该选项将:
      • 创建一个服务器配置,该配置的名称就是在《应用程序名称》字段中提供的名称(该名称在安装过程中指定)。 配置基于《默认》或《所有》配置。
      • 创建用于启动和停止服务器的底稿。
    • MySQL: 安装 MySQL,或配置一个现有的 MySQL 数据库。 对于新的 MySQL 安装,该选项将创建用于启动或停止数据库服务器的底稿。

    自定义:

    IDM 用户应用程序

    • 安装 IDM 用户应用程序,并用于指定现有的数据库和 JBoss 服务器。 支持的数据库类型为 MySQL、Oracle9i、Oracle10g 和 Microsoft SQL Server 2000。

    JBoss

    • 安装 JBoss 应用程序服务器,或用于选择现有的 JBoss 应用程序服务器以供使用。 安装新的应用程序服务器时,该选项将完成以下两项任务:
      • 创建一个服务器配置,该配置的名称就是在《应用程序名称》字段中提供的名称(该名称在安装过程中指定)。 配置基于《默认》或《所有》配置。
      • 创建用于启动和停止服务器的底稿。

    MySQL

    • 安装 MySQL。 该选项不创建用于启动和停止的底稿(与《默认》选项不同)。
  6. 请遵循安装类型的相应指导:

5.4.2 选择安装文件夹

  1. 完成以下页中的选项:

    选择安装文件夹

    注:在 Linux 上,如果在路径的任何位置看到 /root,请取消安装,并以非根用户的身份重新登录。

  2. 单击《下一步》

    如果选择:

5.4.3 指定 MySQL 细节

  1. 完成以下页中的选项:

    设置基本文件夹

    字段

    说明

    基本文件夹

    指定安装程序将在其中创建新 MySQL 数据库的位置。

    数据库名称

    指定安装程序创建的数据库的名称。

    MySQL 的根用户口令

    输入 MySQL 数据库用户使用的数据库口令。

    这与 Linux 根用户帐户口令不同。 IdmUserApp 安装程序将在计算机上创建一个新的 MySQL 安装,在此过程中,它还会创建数据库根帐户。 需要指定 MySQL 帐户的口令。

  2. 单击《下一步》可访问部分 5.4.4, 指定数据库主机和端口中显示的页。

5.4.4 指定数据库主机和端口

  1. 完成以下页中的选项:

    主机和端口信息

    字段

    说明

    主机

    指定数据库服务器的主机名或 IP 地址

    端口

    指定数据库的监听器端口号。

    MySQL 的默认值为 63306。

  2. 单击《下一步》

    如果选择:

5.4.5 指定 JBoss 服务器设置

  1. 完成以下页中的选项:

    JBoss 服务器设置

    字段

    说明

    基本文件夹

    指定安装程序将在其中创建新 JBoss 数据库的位置。

    主机

    指定应用程序服务器的主机名或 IP 地址。

    端口

    指定 JBoss 监听器端口号。默认值为 8080。

  2. 单击《下一步》。如果选择:

5.4.6 选择 JBoss 服务器配置类型

  1. 完成以下页中的选项:

    JBoss 服务器配置类型

    选项

    说明

    单个(默认)或群集(所有)

    选择 JBoss 服务器配置的类型(《所有》适用于群集,《默认》适用于其它类型)

    安装底稿将根据选择的服务器基创建服务器配置。 配置名称与接下来指定的应用程序名称相同。

    应用程序名称

    指定用户应用程序环境名称。 该名称是用于访问用户应用程序的 URL 的一部分。

  2. 单击《下一步》。如果选择:

5.4.7 启用 Novell Audit 日志记录

要启用用户应用程序的 Novell Audit 日志记录,请执行下列操作:

  1. 完成以下页中的选项:

    安装配置文件

    字段

    说明

    启用用户应用程序的 Novell Audit 日志记录。

    有关设置 Novell Audit 日志记录的更多信息,请参见《Identity Manager 用户应用程序:管理指南》

    禁用用户应用程序的 Novell Audit 日志记录。 以后可以使用用户应用程序的《管理》选项卡来启用该功能。

    有关启用 Novell Audit 日志记录的更多信息,请参见《Identity Manager 用户应用程序:管理指南》

    服务器

    指定 Novell Audit 服务器的主机名或 IP 地址。

  2. 单击《下一步》,然后继续部分 5.4.8, 配置用户应用程序

5.4.8 配置用户应用程序

此配置有两页。 一页用于提供基本的配置信息,另一页供高级用户使用,以及用于配置其它参数。

  1. 完成以下页中的选项:

    《配置用户应用程序》屏幕

    字段

    说明

    LDAP 主机

    必需。 指定 LDAP 服务器的主机名或 IP 地址,以及它的安全端口。例如:

    myLDAPhost:636
    

    LDAP 管理员和口令

    必需。 为 LDAP 管理员指定身份凭证。 该用户必须已经存在。 用户应用程序将使用此帐户来建立与 Identity Vault 的管理连接。

    根树枝 DN

    必需。 指定根树枝的 LDAP 判别名。 如果没有在目录抽象层中指定搜索根,则将该判别名用作默认的实体定义搜索根。

    供应驱动程序 DN

    必需。 指定以前在部分 5.3, 创建用户应用程序驱动程序一节中创建的用户应用程序驱动程序的判别名。 例如,如果驱动程序为 UserApplicationDriver,驱动程序集称为《myDriverSet》,并且驱动程序集位于环境 o=myCompany 中,则可以输入以下值:

    cn=UserApplicationDriver,cn=myDriverSet,o=myCompany
    

    用户应用程序管理员

    必需。 Identity Vault 中的现有用户,有权在 Identity Vault 中执行任何管理任务。

    该用户可以:

    • 使用用户应用程序的《管理》选项卡
    • 使用 iManager 管理工作流程任务
    • 创建新的供应请求

    用户树枝 DN

    必需。 指定用户树枝的 LDAP 判别名 (DN) 或完全限定的 LDAP 名称。

    这将会定义用户和组的搜索范围。

    允许该树枝(以及该级别以下)中的用户登录用户应用程序。

    重要说明:如果要使该用户能够执行工作流程,请确保在设置用户应用程序驱动程序的过程中指定的用户应用程序管理员在该树枝中存在。

    组树枝 DN

    必需。 指定组树枝的 LDAP 判别名 (DN) 或完全限定的 LDAP 名称。

    由目录抽象层中的实体定义使用。

    密钥存储区路径

    必需。 指定运行 JBoss 应用程序服务器时使用的 JRE 的密钥存储区 (cacerts) 文件的完整路径,否则,请单击较小的浏览器按钮,然后导航到/idm/jre/lib/security/ 路径中的 cacerts 文件,并选择该文件。

    实用程序必须有权写入该文件。

    密钥存储区口令/确认密钥存储区口令

    必需。 指定 cacerts 口令。 默认值为 changeit

    电子邮件通知主机

    指定承载 Identity Manager 用户应用程序的 JBoss 服务器。例如:

    myJBossServer
    

    该值将替换电子邮件模板中的 $HOST$ 令牌。 构建好的 URL 就是指向供应请求任务和批准通知的链接。

    电子邮件通知端口

    用于替换供应请求任务和批准通知使用的电子邮件模板中的 $PORT$ 令牌。

    电子邮件通知安全端口

    用于替换供应请求任务和批准通知使用的电子邮件模板中的 $SECURE_PORT$ 令牌。

  2. (可选)单击《显示高级选项》 完成以下页中的选项:

    用户应用程序配置页

    字段

    说明

    连接超时(毫秒)

    用户连接到 LDAP 服务器时,超时之前的等待时间(单位为毫秒)。

    Provider referrals(提供程序参照)

    将该特性从 JNDI 应用程序发送到 LDAP 服务器,以指明如何处理参照。 有效值为《忽略》、《Follow(遵循)》和《Throw(丢弃)》。

    延迟别名

    该特性包含从 LDAP 操作返回的项,用于指明这些项是已延迟(真路径)还是没有延迟(别名)。 有效值为《从不》、《始终》、《查找》和《搜索》。

    用户对象类

    LDAP 用户对象类(通常为 inetOrgPerson)。

    登录特性

    代表用户登录名的特性(例如 CN)。

    用户成员资格特性

    可选。 代表用户的组成员资格的特性。 不允许空格。

    组对象类

    LDAP 组对象类。

    组成员资格特性

    代表用户的组成员资格的特性。 不要在该名称中使用空格。

    使用动态组

    如果需要使用动态组,请选择该选项。

    动态组对象类

    LDAP 动态组对象类。

    已启用 ICS 注销

    如果选择该选项,应用程序将支持同时注销用户应用程序和 iChain®。

    ICS 注销页

    iChain 注销页的 URL。

    电子邮件通知协议

    指定下列值之一:

    • HTTP
    • HTTPS

    用于替换供应请求任务和批准通知使用的电子邮件模板中的 $PROTOCOL$ 令牌。

    电子邮件通知安全协议

    用于替换供应请求任务和批准通知使用的电子邮件模板中的 $SECURE_PROTOCOL$ 令牌。

    会话超时

    指定用户会话可以处于非活动状态的分钟数。 默认情况下,会话中的用户应用程序将在 20 分钟后超时。

    数据源

    指定连接池的 JNDI 名称。 默认情况下,连接池 JNDI 名称为 java:/IDM。

    Add a New Container Object(添加新的树枝对象)

    输入可用作树枝的某个对象类的 LDAP 名称。

    注:要在完成安装后修改这些值,请运行 configupdate.sh 底稿(在 Linux 上)或 configupdate.bat 文件(在 Windows 上)。 这些文件位于安装子目录中。 如果在启动时使用 -use_ssl 参数,更新实用程序可以使用 SSL 连接到 eDirectory。 否则,它将以非 SSL 方式连接到 eDirectory。

  3. 单击《确定》

  4. 查看《预安装摘要》页。 如果每一项都正确,请单击《安装》继续安装

  5. 安装完成后单击《完成》

  6. 打开安装目录中的 README 文件。

  7. 转至部分 5.4.11, 安装后的任务

5.4.9 选择数据库平台

  1. 完成以下页中的选项:

    选择数据库平台
  2. 选择数据库平台。 根据您的选择,请遵循下表中的配置步骤:

    数据库

    说明和配置细节

    MySQL

    对于远程 MySQL 环境,为部分 5.4.3, 指定 MySQL 细节中指定的名称创建数据库。

    提示:安装程序将使用用户应用程序 WAR 文件的名称创建 JBoss 数据源文件。

    Oracle

    要将 Oracle 数据库与用户应用程序一起使用,请执行下列操作:

    1. 在 Oracle 实例上创建数据库(确保名称与在部分 5.4.10, 指定数据库名称和特权用户中指定的名称相同。)
    2. 从 Oracle 的下载站点下载 ojdbc14.jar 驱动程序,并将其复制到 /idm/jboss/server/<server-name>/lib

    提示:安装程序将使用用户应用程序 WAR 文件的名称创建 JBoss 数据源文件。

    MS SQL

    要将 MS SQL 数据库与用户应用程序一起使用,请执行下列操作:

    1. 在 MS SQL 实例上创建数据库(确保名称与在部分 5.4.10, 指定数据库名称和特权用户中指定的名称相同。)
    2. 从 Microsoft 下载站点下载 MS SQL JDBC 驱动程序 (msbase.jarmssqlserver.jarmsutil.jar),并将其复制到 /idm/jboss/server/<server-name>/lib
    3. 创建指向该数据库的 JBoss 数据源文件。

    提示:安装程序将使用用户应用程序 WAR 文件的名称创建 JBoss 数据源文件。

  3. 单击《下一步》,然后继续部分 5.4.4, 指定数据库主机和端口

5.4.10 指定数据库名称和特权用户

  1. 完成以下页中的选项:

    指定数据库名称和特权用户

    字段

    说明

    数据库名称(或 SID)

    指定储存用户应用程序配置信息的数据库的名称。

    数据库用户

    指定数据库根用户。

    数据库口令/确认口令

    指定数据库根口令。

  2. 单击《下一步》,然后继续部分 5.4.5, 指定 JBoss 服务器设置

5.4.11 安装后的任务

忘记口令和工作流程电子邮件通知功能要求执行下列安装后的任务:

  1. 在 iManager 中,选择《口令职能》

  2. 在《口令》中,选择《电子邮件服务器选项》 >

  3. 在《主机名》字段中提供 SMTP 服务器名

  4. 在《从》字段中指定一个电子邮件地址(例如 noreply@novell.com),然后单击《确定》 >

5.4.12 测试安装

要校验安装状况是否良好,请完成部分 5.2, 安装和配置中概述的剩余步骤。 完成这些步骤后,如果浏览器中未显示《Identity Manager 用户应用程序》页,请检查终端控制台上是否出现与 MySQL、JBoss 和用户应用程序相关的错误讯息,并请参见部分 5.5, 查错