Novell Identity Manager Designer 4.0.1 自述文件

1.1 Designer 4.0.1 的新增功能

Designer 4.0.1 for Identity Manager 的新增功能部分包含在本版本中。Designer 4.0.1 发布后，该部分也可联机获得。

1.2 查找文档

Designer 4.0.1 for Identity Manager 的文档包含在本版本中。最新版本发布后，本文档也可联机获得。

本自述文件包含 Designer V 4.0.1 的已知问题。除本自述文件外，另有独立的 Identity Manager 4.0.1 自述文件。

其他文档资源也可用于以下软件：

1.3 浏览或搜索

要在安装 Designer 之后浏览 Designer 的帮助主题：

要在安装 Designer 之后搜索特定的 Designer 信息：

2.1 可用语言

Designer 包含巴西葡萄牙语、简体中文、繁体中文、荷兰语、法语、德语、意大利语、日语和西班牙语的用户界面翻译。用户界面语言可在安装期间或运行时通过“自选设置”对话框进行选择。

2.2 非翻译部分

此版本不包含 Designer 运行时帮助或产品文档的翻译。目前，Designer 生成的项目文档仅提供英语版。

2.3 插件

有些插件由元目录提供，并且仅提供元目录所支持语言的版本，包括简体中文、繁体中文、法语、德语和日语。有些第三方插件仅提供英语版。

3.1 无法在 Windows 上安装 Designer

一些用户报告称他们无法在 Windows 上安装 Designer。安装开始，但因以下错误关闭：

"This Application has Unexpectedly Quit." 

如果您看到此问题：

3.2 在 Windows Vista 中开启 UAC 的情况下将 Designer 安装到网络驱动器

Designer 4.0.1 已在 Windows Vista 上正式测试并受支持。但是，如果在 Windows Vista 中开启了“用户帐户控制 (UAC)”，则程序可能无法访问某些网络位置，因而无法将 Designer 安装到网络驱动器上。当您使用命令提示符访问网络位置时也可能发生这个问题。

要解决此问题，您需要按照 Microsoft 知识库中 2007 年 7 月 20 日一篇名为“After you turn on User Account Control in Windows Vista, programs may be unable to access some network locations”（如果在 Windows Vista 中开启了“用户帐户控制”，则程序可能无法访问某些网络位置）的文章的说明来配置 EnableLinkedConnections 注册表值。

遵循以下步骤来应用该变通方法配置 EnableLinkedConnections 注册表值：

3.3 在带有东亚语言包和双字节安装路径的英文版 Windows 上安装

当您安装到含有双字节字符的路径中时，如果您的操作系统运行的是安装了东亚语言包的英语版 Windows，则安装包发生错误，指出无法将压缩文件解压缩。在 Windows 文件路径中使用双字节字符集 (DBCS) 存在已知问题，这些问题来自 OS 供应商或安装框架供应商。作为备用方案，在您安装到本地化版本操作系统时，可以安装到 DBCS 路径。

3.4 在 Linux 上安装时发生异常错误

有些版本的 Linux 上会发生以下错误：

Invocation of this Java Application has caused an InvocationTargetException. This application will now exit.

xhost 程序禁止其它主机和用户连接到 x 服务器，从而使 Linux 更加安全。如果以有效用户的身份登录并尝试以 root 用户的身份运行安装程序，则可能发生此错误。关于 xhost 的更多信息，请参见 xhost 的手册页。

3.5 安装后启动 Designer 时出现警告讯息

以下警告讯息出现在 SUSE Linux Enterprise Desktop (SLED 11) 和 openSUSE 11.1 平台上：

Gtk-Message: Failed to load module "gnomebreakpad": libgnomebreakpad.so: cannot open shared object file: No such file or directory 

Gtk-Message: Failed to load module "canberra-gtk-module": libcanberra-gtk-module.so: cannot open shared object file: No such file or directory 

可以安全地忽略这些讯息。

3.6 Designer 在 openSUSE 10.3 32 位平台上起动失败

要解决此问题，请通过 PuTTY 和 Xming 起动 Designer：

3.7 Designer 4.0.1 自述文件显示垃圾字符

如果在安装 Designer 4.0.1 过程中打开 Designer 4.0.1 自述文件，屏幕上会显示垃圾字符。它还显示错误。忽略此错误是安全的。在安装成功完成后，自述文件会正确打开。

3.8 在 Designer 4.0.1 内与 eDirectory 建立通讯时，会在 Windows 7 上导致错误

发生这个问题是因为之前版本的 NICI 可能没有正确卸装，在文件系统上或许还有一些残留文件。

要解决此问题，请从系统中去除所有 NICI 文件，重新安装 Designer 和 Novell Client。

4.1 项目文件未加密

口令已经过混淆处理。但是，如果项目文件中有其他敏感数据，而这些数据并未进行任何形式的加密，请务必注意保护信息。

5.1 使用 Adobe Acrobat Reader for Linux

默认情况下，Linux 可能使用 PDF 阅读程序 (Evince)，该程序不支持用于显示双字节字符的嵌入字体。 您应使用 Adobe Acrobat Reader for Linux 以支持这些语言。

5.2 为大项目生成文档可能导致内存耗尽

为避免内存耗尽，请分别为身份库、驱动程序和驱动程序集生成文档。

6.1 按名称和位置设置过滤通知模板

当您使用任何语言运行 Designer 时，默认情况下您只能看到当前语言的通知模板。要查看其他语言的模板，请更改“大纲”视图的过滤器设置：

同时，创建新模板时，必须向模板名称添加正确的语言代码，才能正确过滤您的新模板。例如，德语模板应命名为 <TemplateName_de>。语言代码如下：

• da-丹麦语
• de-德语
• es-西班牙语
• fr-法语
• it-意大利语
• ja-日语
• nl-荷兰语
• pt-葡萄牙语
• ru-俄语
• sv-瑞典语
• zh-CN-简体中文
• zh-TW-繁体中文
• en-英语（或不使用语言代码）

6.2 对于葡萄牙语区域设置 DAL 下的关系，经理 - 雇员字符串未本地化

6.3 Designer 在 Windows Vista 上安装后不起动

Windows Vista 实现了用户帐户控制功能，禁止应用程序以管理员身份运行，除非得到您的特别允许。

如果 Designer 在 Windows Vista 上不能正确安装或安装后无法起动：

要使 Designer 自动更新，以便在 Windows Vista（Ultimate 和 Business 版本）上使用，请确保登录的用户是管理员或具有同等权限的用户。

6.4 在 Windows Vista 上在线操作很慢

在 Windows Vista 上运行 Designer 时，如果对 Windows 2003 Server 进行在线操作，则您可能会发现执行速度很慢。您可以通过在 Windows Vista 上禁用“TCP 自动调整”来解决此问题。要执行此操作，请打开命令提示符，然后输入以下内容：

netsh interface tcp set global autotuninglevel=disabled 

6.5 在 Designer 安装过程中，NICI 在 Windows 上安装失败

如果在安装 Designer 的过程中看到以下错误讯息，一个可能的原因是 Designer 可执行文件的路径太长。尽管出现错误讯息，Designer 安装仍会成功完成，但 NICI 安装失败。

Error Executing the Specific Program 

C:\Users\Administrator\AppData\Local\Temp\pftE915~tmp\Disk1\Setup.exe -s -f1C:\Users\Administrator\Desktop\designer_cdimage_win\linux\final\designer_win32\designer_install\components\nici\wcniciu0.iss -f2C:\Users\Administrator\AppData\Local\Temp\designerNici.log 

要解决此问题，请通过运行 <Designer 安装位置>\components\nici\wcniciu0.exe 命令来手动安装 NICI。

6.6 在 Windows Vista 上关闭 Designer 时 JVM 崩溃

在 Windows Vista 上的 Designer 中执行任何在线操作后，关闭 Designer 时 JVM 可能会崩溃。这是由于 JClient 中的错误调用。如果发生这种情况，不会丢失任何数据，只需关闭错误窗口即可。

该问题正在改进中。

6.7 默认情况下不导入应用程序纲要

默认情况下，不会自动导入应用程序纲要。用户可以在项目导入后，始终对特定的应用程序执行刷新应用程序纲要的操作。

6.8 在 Windows 中运行 Designer 时使用 120 DPI 字体

120 DPI 对于使用标准 Windows XP 排版的文本来说字体过大。调整显示设置：

6.9 改进建模器的性能

如果要最大限度地提高大规模操作（例如，多个对象的复制和粘贴）的执行速度，请隐藏或关闭“大纲”视图，这样最多可将执行速度提高十倍。关闭“属性”视图后，执行速度还可以进一步提高。要快速恢复这些视图，请单击窗口 > 重设置视角。

6.10 JDBC 3.5 驱动程序项目名称

如果项目包含 JDBC 3.5 驱动程序，则您可能注意到默认驱动程序名称为 JDBC 3\.5。这是正常的，并且驱动程序能够正确部署。

6.11 Designer 4.0.1 不支持 2.1.1 工作空间

Designer 2.1.1 工作空间与 Designer 4.0.1 不兼容。Designer 将项目和配置信息存储在工作空间中。这些工作空间在不同版本的 Designer 之间互不兼容。您需要将 Designer 4.0.1 指向一个新的工作空间，而不是先前版本的 Designer 使用的工作空间。

6.12 角色编辑器限制

角色编辑器不支持扇出驱动程序功能，且无法为 SAP 驱动程序选择逻辑系统。尽管角色编辑器显示权利，但它无法区分逻辑系统。

6.13 Designer 4.0.1 不支持版本低于 Designer 3.0 的项目转换

要解决此问题，请将较早的项目转换到 Designer 3.0.1，然后将其导入到 Designer 3.5。

6.14 项目转换程序不支持远程装入的工作空间

如果在安装了 Designer 4.0.1 的本地计算机上装入 Designer 3.5 工作空间后将 Designer 3.5 项目转换为 Designer 4.0.1，则项目转换程序不会转换 Designer 3.5 项目。

要解决此问题，请将 Designer 3.5 工作空间复制到安装了 Designer 4.0.1 的本地计算机上，然后运行项目转换程序。

6.15 文档生成器没有为基于角色的权利策略和 Roles Based Provisioning Module 资源生成文档

6.16 Designer 中的内部 Web 浏览器在 Linux 平台上无法运行

由于 XULrunner 问题，内部 Web 浏览器未按预期工作。

要解决此问题，请从 Designer > Windows > 自选设置 > 一般 > Web 浏览器 > 使用外部 Web 浏览器设置外部浏览器。这样就会通过系统默认的 Web 浏览器（如 Mozilla Firefox 或 Microsoft Internet Explorer）打开 iManager URL。

6.17 将 ECMAScript 的链接部署到供应请求定义

ECMAScript 应与其链接一起部署。直接部署 ECMAScript 时不会部署链接。只能在存在连接 ECMAScript 和驱动程序的链接的情况下，才能将已部署 (eDirectory) 脚本添加到供应请求定义 (PRD)。

可使用以下方法之一链接 ECMAScript 和驱动程序：

6.18 MVEditor 没有为 DAL 全局查询解析 DN

未指定实体类型时，MVEditor 查找选择会过滤搜索结果并显示正确的值。指定了实体类型时，DAL 查询不再返回正确的值。

要解决此问题，请不要在指定全局表达式的情况下指定 DAL 实体密钥，因为全局查询已参照了定义中的实体密钥。您可以指定 DAL 实体密钥查找并映射显示表达式，也可以指定 DAL 查询全局表达式，但不能同时指定两者。

6.19 在 LDAP 名称中包含下划线的属性违反了详细 Portlet

在属性名称中使用下划线 (_) 时会出现此问题。例如，TestName 或 Test-Name 之类的属性不会产生这个问题，但是 Test_Name 会产生此问题。

6.20 无本地历史自选设置

Designer 随附的“本地历史记录自选设置”是 Eclipse 功能。这些自选设置并非旨在用于超速缓存 Designer 数据。

最小化 Designer 可以超速缓存的历史记录：

6.21 将项目导入 Designer 后正确设置 LDAP 端口

将项目从在线系统导入 Designer 后创建该项目时，Designer 无法在身份库“属性”视图中正确设置端口。

要解决此问题，请在部署导入的项目之前先在身份库“属性”视图中更改 LDAP 端口。

7.1 JVM Terminated Exit Code=1 错误

一些安装在 SLED 10 SP1 工作站上报告了 JVM Terminated Exit Code=1 错误。可通过在 /etc/X11/xorg.conf 文件中进行以下更改来应用临时变通方法：

Section "Extensions"

Option "MIT-SHM" "no"

EndSection

注意，禁用此扩展会降低性能。

7.2 通过 GNOME 界面在 openSUSE 10.3 上安装 Designer

openSUSE 10.3 中的 GNOME 界面开始时无法与 Identity Manager Designer 协同工作。例如，Designer 不能在 GNOME 下起动，只要悬停在工具提示上 Designer 就会崩溃，或者从“项目”视图中删除对象时 Designer 会崩溃。为使带 GNOME 的 openSUSE 10.3 能够与 Designer 3 搭配使用。x 或更高版本，需要更新来自 openSUSE.org 的所有库。确保包含以下内容：

如果运行更新时遇到问题，或如果需要配置更新服务器，请转到 YaST 联机更新文档站点以获取更多帮助。

7.3 openSUSE 10.3 上的堆栈崩溃错误

在 openSUSE 10.3 上使用 StartDesigner.sh 启动 Designer 时，您可能会在控制台上接收到以下错误：

"*** stack smashing detected ***: ~/designer/jre/bin/java terminated" 

Designer 无法启动。此错误可能是由在 Linux 桌面上使用智能通用输入法平台 (SCIM) 语言输入系统导致的，尤其是 GTK 的 scim-bridge-gtk 模块。您可以通过两种方式修正此错误：

7.4 在基于 Debian 的 Linux 版本上安装 Designer

尽管不能正式支持所有 Linux 发行套件，但许多客户报告说在基于 Debian 的发行套件（如 Ubuntu）上可以成功运行 Designer。要进行此操作，请执行以下步骤：

7.5 在 Linux 上同时运行 eDirectory 和 Designer

如果要在 Linux 上同时运行 eDirectory 和 Designer，则您可能需要作为 root 用户来运行 Designer。eDirectory 安装要求您作为根用户安装其基础包，这样典型用户将无法运行这些包。特别地，导入或部署以及连接到树时，如果以非根用户身份运行 Designer，则 Designer 将崩溃。

7.6 通过 gtk-qt-engine 在 Linux 上运行 Designer

我们不建议在安装了 gtk-qt-engine RPM 的情况下运行 Designer此 RPM 包随 SUSE Linux 及其他一些 Linux 版本安装。有些已知问题会在安装此包时导致崩溃和 Designer 主题问题。

如果使用此 RPM 包，请获取最新版本。您可以从 KDE 网站下载此版本。

即便使用该包的最新版本，也可能会缺少 Designer 主题功能。

要确定是否安装了 gtk-qt-engine RPM，请输入：

rpm -qa|grep gtk-qt

如果列表中显示 gtk-qt-engine，则应该以 root 用户身份输入以下命令来去除该包：

rpm -e gtk-qt-engine

7.7 Linux 上的显示问题

7.8 Designer 在 SLED 10.3 64 位上起动失败

7.9 在 openSUSE 11.2 上，对话框按钮对鼠标点击无响应

如果对话框中的按钮对鼠标单击无响应，则可以采用以下方法之一解决此问题：

7.10 创建或配置驱动程序时无法选择选项

在创建或配置驱动程序时，有时不能选择下拉选项。要避免此问题，请使用以下解决方法：

7.11 浏览 Designer 4.0.1 帮助系统时发生异常

在 openSUSE 11.2 平台上浏览帮助内容时发生异常。这可能是因为您的 XULrunner 版本与 Eclipse 不兼容。要避免此异常，请使用以下变通方法：

8.1 返回 Undefined 的表单字段不显示错误或警告

如果工作流程使用的表单上的一个字段返回值“undefined”，则表单不会显示错误或警告讯息。脚本中的问题会导致出现这种情况。一般来说，如果一个表单脚本计算的值为“undefined”，则该脚本被视为有错误。变通方法是确保不在准备活动映射中设置“undefined”。为此，请使用一种“尝试/捕获/最终块”的方式确保始终存在有效值可发送到每个控制。

8.2 在供应请求定义上设置受托者权限时可能发生超时

尝试在供应请求定义上设置受托者权限或尝试通过 ECMA 表达式构建器访问身份库时，可能会遇到以下错误讯息：

Cannot connect to host 'xxx', verify the address is correct and the server is running.

如果地址正确且服务器处于运行状态，则此错误可能是连接缓慢导致的。

可以通过窗口 > 自选设置 > Novell > 供应设置连接自选设置，从而更改连接超时设置。

8.3 在供应请求定义编辑器中保存错误的身份凭证

从供应请求编辑器连接到身份库时（例如，在供应请求定义上设置受托者权限时），会提示您输入其身份库身份凭证。如果您键入错误的口令，然后单击身份库“身份凭证”对话框中的保存口令按钮，将无法连接到身份库，也不会提示您重键入身份凭证。

要解决此问题，请访问“建模器”视图并重新配置该项目的身份库身份凭证。

8.4 未从角色编辑器的资源列表中删除与角色关联的资源

在角色编辑器中的资源列表下，提供了关联资源的只读列表及角色。从 eDirectory 导入角色编目时，将获取并更新此列表中所有角色的信息。您可以看到新资源关联，而看不到已从 User Application 中去除的资源关联。

要解决此问题，请确保删除的资源关联已从资源列表中去除：

8.5 在版本控制下的项目中使用比较功能时出现错误

如果在版本控制下向项目添加 User Application 驱动程序，并在重新归还项目后执行比较，您可能会在错误日志中看到以下异常：

Unable to find a light item for the path: Model/Provisioning/AppConfig/.appconfig 

您可以放心地忽略此错误。

8.6 导入项目存档时抛出异常

如果将项目存档文件导入 Designer，则可能看不到现有的小组定义。在错误日志中还可以看到以下错误：

org.eclipse.core.internal.resources.ResourceException:
Resource'/myProject/Model/Provisioning/AppConfig/TeamDefs/TeamDefs.digest'

要使小组定义可用，重启动 Designer。

8.7 角色比较显示错误的结果

如果同时使用 User Application 用户界面和 Designer 创建角色，则 Designer 的“在线比较”功能可能不会显示预期结果。要解决此问题，请执行以下操作之一：

8.8 将供应对象归还给版本控制时出现空指针异常错误

如果在打开的供应请求定义 (PRD) 存在未保存更改时向版本控制提交任何供应对象，则会在错误日志中看到空指针异常错误。您可能在打开错误日志视图时才会意识到提交失败。简单的解决办法是在将供应对象归还给版本控制之前保存供应对象，或者不保存对象而是直接关闭它。

8.9 还原打开的供应请求定义会导致编辑器关闭

如果恢复供应请求定义 (PRD) 时供应请求定义在供应请求定义编辑器中处于打开状态，则编辑器会关闭，再重新打开刷新后的 PRD 版本。这是供应请求定义编辑器的正常操作。

8.10 还原区域设置更改可能会显示错误的状态

当使用“区域设置和本地化资源组”窗口（配置 > 区域设置）添加和去除区域设置，然后执行版本控制恢复，则 Designer 可能会错误地指示本地对象已更改。如果您未作出任何更改，但通过单击确定来关闭窗口，就会发生这种情况。可通过单击取消而不是确定来避免出现此讯息。

8.11 将 User Application 驱动程序迁移到 3.6.1 之后，在只读供应请求定义上设置受托者时发生问题

如果在迁移到 3.6.1 的 User Application 驱动程序上的某只读供应请求定义（例如角色或证明对象）上设置受托者，Designer 会创建供应请求定义的额外副本。您将在供应视图中看到两个同名对象。

删除额外对象：

8.12 没有为具有 Identity Manager 4.0.1 格式的权利正确生成权利参数

Identity Manager 4.0.1 权利接受 JSON 表达式。但是，生成的表达式会返回一个简单参数，例如：

carpathia.qalab.com

确保您将该表达式编辑为 JSON 表达式。例如，对于 Active Directory 驱动程序，如下修改表达式：

{"ID", "carpathia.qalab.com"}

9.1 User Application 3.7 驱动程序迁移未能自动部署通知模板

您应该在处理从 User Application 3.7 之前的版本迁移的 User Application 驱动程序时手动添加和部署通知模板。使用以下步骤部署通知模板：

9.2 不支持将 User Application 驱动程序直接迁移到 4.0.1 版本

Identity Manager 驱动程序迁移不再是 Designer 4.0.1 随附的选项。Designer 4.0.1 仅支持升级驱动程序包。要将更早版本的 User Application 驱动程序升级到 4.0.1 版本，需要将驱动程序迁移到 4.0 版本，然后使用 User Application 包升级到 4.0.1 版本。

10.1 比较大型项目的版本控制修订时出现 404 错误

比较大型项目时或比较项目期间的连接速度非常慢时，出现间歇性问题。比较需要运行很长时间，且并非所有项目均出现在“比较”窗口中。大多数情况下，重试可解决此问题。如果问题仍然存在，请联系 Novell 支持人员，获取关于暂时关闭状态线程的信息。

10.2 检查是否有更新后，版本控制或建模器视图中不显示驱动程序

如果在一台计算机上向一个驱动程序集添加了驱动程序，将该更新保存到版本控制服务器，然后在第二台计算机上执行“获取更新”，您将看不到添加到该驱动程序集的驱动程序。如果发生这种情况，请通过关闭然后重新打开视图来刷新建模器视图。然后在版本控制视图上运行刷新。

10.3 在“导航器”视图中执行复制、粘贴和拖放操作不会更新版本控制

如果文件在版本控制下，则在“导航器”视图中执行的复制并粘贴或拖放操作不能正确处理这些文件。变通方法是从项目视图执行这些操作。

11.1 如果站点需要鉴定，包的自动更新失败

如果您从需要鉴定的站点自动下载包，则下载会失败。可将 Designer 配置为自动鉴定到下载站点来解决此问题。

12.1 不支持从 Designer 3.0.1 升级到 Designer 4.0.1

Designer 4.0.1 是成熟的 RCP 应用程序。它不支持从先前版本的 Designer 升级。您仍可以将 Designer 3.0.1 工作空间导出到 Designer 4.0.1，从而触发项目转换并将项目转换到 4.0.1 版本。

13.1 管理目录中的帮助连续装载了 12 小时以上

出现“正在装载帮助”对话框，但不出现“帮助”窗口。除非 Designer 重启动，否则不关闭“加载帮助”对话框。