August 20, 2007
For the latest version of the Readme, visit the Designer 2.1 documentation Web page.
The documentation for Designer 2.1 for Identity Manager 3.5.1 is included with the software, in the help system. It is also available online at the Novell Designer 2.1 documentation Web site.
For the latest, updated documentation on Designer 2.1, see the Novell Designer 2.1 documentation Web site.
For information on Novell® Identity Manager 3.5.1, visit the Identity Manager 3.5.1 Documentation Web site.
To browse the Designer help topics after Designer is installed:
In Designer, click > .
Select a book, browse the table of contents, then click a topic.
To search for specific Designer information after Designer is installed:
Click > , then enter text. Or press F1 on any page. (In Linux, press CTRL-F1.)
Type a topic in the Search field, then click .
If you maximize an editor (for example, the Modeler), help topics do not display when you press F1. To view the help, minimize the editor.
In this documentation, a greater-than symbol (>) is used to separate actions within a step and items in a cross-reference path.
A trademark symbol (® , TM, etc.) denotes a Novell trademark; an asterisk (*) denotes a third-party trademark
This release of Designer includes User Interface translation for Brazilian Portuguese, Chinese (Simplified), Chinese (Traditional), Dutch, French, German, Italian, Japanese, and Spanish. You can select the User Interface language during installation, or at runtime through the preferences dialog box.
This release does not include translation of Designer runtime help or product documentation.I rec
Some plug-ins are provided by the metadirectory and are available only in languages supported by the metadirectory: Chinese (Simplified), Chinese (Traditional), French, German, and Japanese. Some third-party plug-ins might be available only in English.
By default, Linux might be using a PDF reader (Evince) that doesn't support the embedded font we use to display double-byte characters. We recommend that you use the Adobe Acrobat Reader for Linux.
Some Windows users have experienced an Out of Memory error when generating documentation. To fix this:
Right-click the Designer shortcut, then select .
Make sure that the -vmargs -Xms256m -Xmx1024m parameters are not enclosed in quotes.
Only the path to the designer.exe file must be in quotes. The following example illustrates the path:
" C:\Program Files\Novell\designer\eclipse\designer.exe" -vmargs -Xms256m -Xmx1024m
If you still experience problems, you can attempt to adjust the -Xms256m -Xmx1024m parameters to a higher memory amount. Just make sure that your system has that memory available. The default settings should be sufficient for most applications.
For more information, see "Freeing Heap Memory" in the Designer help.
Designer 1. x versions of Document Generation styles are not compatible with Designer 2.1. We recommend that you create a new style, then copy and paste your data from the old style. Otherwise, you miss new functionality found in 2.1 styles.w
Passwords are obfuscated. However, if you have other sensitive data in your project file, it is not encrypted in any way, and you must take care to safeguard your information. In the future, the data will be protected.
IMPORTANT:When you use any action that might require a password to be entered (for example, Do Send Email), the password is not being encrypted with this release. If you deploy the policy or save it to disk, the password is in clear text
If simulation stops working after a Designer upgrade, and you are unable to progress past the query/response stage of processing, you can remedy the situation by checking and correcting your simulator preferences page settings. To do this:
Select > > > .
Verify that all paths specified for Input, Output, and Java Extensions are valid paths and that they exist.
When running Designer in any language, by default you see only notification templates for the language that you are running in. To see templates in additional languages, change the filter settings for the Outline view:
Click the filter icon in the upper right corner of the Outline view.
Select the languages that you want to see.
Also, when creating templates, you must add the proper language code to the template name so that your new templates are filtered correctly.
For example, a German template should be named <TemplateName_de>. The language codes are as follows:
de-German
es-Spanish
fr-French
it-Italian
ja-Japanese
nl-Dutch
pt-Portuguese
ru-Russian
sv-Swedish
zh-CN-Chinese Simplified
zh-TW-Chinese Traditional
English Templates are not named with a code.
Windows Vista has implemented a new User Account Control feature that prevents applications to run as Administrator unless you specifically allow it. To run Designer in Vista:
Right-click the Designer shortcut.
Select .
The first time that you run Designer, the Heap Status Widget does not display. To display it, restart Designer. This is a known Eclipse issue.
When importing a project, you might see the java.lang.NoClassDefFoundError: org/apache/xml/serialize/XMLSerializer error in the error log. If you see this error in the error log reinstall Designer to again lay down the xerces.jar file.
Projects created in Designer 2.0 and 2.1 are not compatible with earlier versions of Designer. In this release, if you use a project created earlier than Designer 2.0, Designer runs a project conversion.
WARNING:By default, preferences for policy simulation output are saved to the plug-in directory. If you run Designer 1.2 or earlier and save your custom XDS documents to the plug-in directory, the documents are deleted if you upgrade to Designer 2.1 or reinstall Designer 2.1.
To prevent custom XDS documents from being deleted, save them to some other directory than the plug-in directory. For example, save them to the workspace directory or change the default output directory to the workspace directory.
The minimum resolution required for Designer is 1024 x 768. The recommended resolution for Designer is 1280 x 1024.
On the Novell Linux Desktop, some themes can cause display issues for Designer. One issue is the inability to see the available plug-ins to trace when tracing is disabled. This problem is most widely seen with the Industrial theme.
To work around this issue, change your theme to one of the following:
Grand Canyon
Mist
Traditional
It is a good practice to protect your work by periodically saving your project. You can easily make a copy:
Right-click a project in the Project view.
Select .
Name the project, then click .
In the rare event that Designer gets into a questionable state (for example, lines aren't drawing correctly), as an extra precaution, don't save the project. Close the project, reopen it, and then resume your work. By not saving, you avoid the possibility of saving a corrupted project.
With this release of Designer, an application schema is not automatically imported by default. You can always refresh the application schema on a particular application after the project has been imported:
Select the driver.
Select > .
You can also change the default by setting a preference:
120 DPI is too large for text in standard Windows XP decorations. Adjust the Display settings:
In the Control Panel, select > > .
In , toggle to e.
If you have a display that necessitates 120+ DPI fonts, you need ClearType.
Besides the obvious anti-aliasing aspects, ClearType gives fonts better weight. Without ClearType, the fonts are too thin and light, decreasing readability.
Click , then click .
In the Item field, reduce the Icon, Menu, Message Box, Selected Items, and ToolTip sizes.
Reduce title bars and related controls to a preferred size.
Fix icon spacing and scroll bar width.
Make sure that you are running at a very high resolution.
This helps eliminate most of the display issues on an HD monitor.
If you want to maximize the performance on large-scale operations (for example, copy/paste of several objects), you will find that the performance is up to ten times faster if you hide or close the Outline view. You get even better performance if you also close the Properties view. To quickly restore these views, click Window > Reset Perspective.
This release of Designer supports the new features introduced in Identity Manager 3.5.1 Identity Manager 3.5.1 features are enabled by default on all new projects. The default Identity Manager server version for all new projects is 3.5.1 This is placed in the server properties page so that you can get access to the new 3.5.1 feature set. To access the server properties page:
Go to the Outline view.
Double-click the server icon.
For more information, see the Help system.
Designer 2.1 is not officially supported or tested on Windows Vista. However, our initial impression is that Designer runs well on Vista. During the install, you see a message stating that you are installing on an unsupported Windows version. You can continue with the installation by selecting OK. For instructions on running Designer on Vista, see Section 5.3, Designer Will Not Launch after Installation on Windows Vista.
When installing to a path where there are double-byte characters, and if your operating system is running the English version of Windows with the East Asian Language Packs installed, an error message informs you that the install is unable to extract the compressed file.
There are known issues with using double-byte character sets (DBCS) in Windows file paths. We cannot provide a fix at this time; the fix would have to come from the OS vendor or the install framework vendor. As an alternative, you can install to DBCS paths when installing to a localized version of the operating system.
There are known cases when the Designer install crashes when installing on SLED 10 and SuSE 10.2 when XGL is enabled. The error might be displayed as:
An unexpected error has been detected by HotSpot Virtual Machine:
The problems are only seen when XGL is enabled. If XGL is enabled, disable it, then try installing again.
When you install on Linux, supporting Linux packages for Designer are needed. The GNU gettext utilities provide a framework for internationalized and multilingual messages. Before installing Designer, make sure you have installed the gettext package and any dependencies for this package. You can use YaST to check for installed packages and to check dependencies.
The installation installs a JRE specifically for Designer. This JRE won't impact Java* installed for other uses on the workstation.
Some users have reported the inability to install Designer on Windows*. The install starts to run but closes with the following error:
This application has unexpectedly quit.
If you see this message, do the following:
Right-click the Designer install.exe file, then select .
Select the Compatibility tab.
Under the Compatibility mode section, select .
Select from the drop-down menu.
The Designer install should execute normally.
Installing eDirectory™ base components and NICI requires root privileges. The install program prompts you for the root password so that you can install these components.
The following error occurs with some versions of Linux:
Invocation of this Java Application has caused an InvocationTargetException. This application will now exit.
The xhost program makes Linux more secure by not allowing other hosts and users to make connections to the X server. If you are logged in as a valid user and are trying to run the install as root, this error can occur. For more information on xhost, refer to the man page for xhost.
This is a problem with the underlying install framework that Designer uses. The issue is being tracked and addressed by the third-party company responsible for that install framework.
Our installation framework provided by Macrovision confirms that this is a problem in the install framework. At this time, you must open these links manually
If you are running eDirectory on Linux and also want to run Designer, you might need to run Designer as root. The eDirectory install requires you to install its base packages as root. This prevents a non root user from running them. Specifically, Designer crashes if you are running as a non root user when importing or deploying and when connecting to a tree.
We don't recommend that you use the gtk-qt-engine -GTK-style Engine for Use with Qt Plugins and Settings. This RPM package is installed with SUSE Linux 9.2 and 9.3 and possibly other Linux distributions. Known issues cause crashes and Designer theme issues when this package is installed
If you must use this RPM package, obtain the latest version.You can download this version from kde-look.org.
Even with the latest version of the package, Designer theme functionality might not be present
To determine whether you have the gtk-qt-engine - GTK-style Engine for Use with Qt Plugins and Settings RPM package installed, enter:
rpm -qa|grep gtk-qt
If gtk-qt-engine appears in the list, you should remove the package by issuing the following command as the root user:
rpm -e gtk-qt-engine
Select the Applications menu.
Click Preferences > Font, then decrease the size of the application font.
You can also adjust the thematic elements to your liking. Keep in mind that GTK thematic elements can cause performance issues with Designer. If Designer is running slowly, especially when you use pull-down menus and other widgets, you might try changing to a simplified GTK theme.
Normally, this process fixes display issues.
Because Eclipse (Designer) is a GTK application, we recommend that you use GTK themes rather than qt-based themes.
You must remove the gtk-qt-engine package mentioned in section 3.6. You can do this through YaST or by using the instructions given above.
You need to have the following packages installed on your Linux system. If you installed the GNOME subsystem, you already have these packages installed:
gtk-engines
gtk2-engines
control-center2 > Gnome Control Center
gtk2-themes (or the themes you downloaded, and all the related dependencies)
gnome-themes (only needed if you are going to use the Gnome Control Center to set your theme)
Do one of the following:
Set your GTK theme and font settings from the KDE SUSE menu.
Select > > . You can set this control center application to automatically run each time KDE is started. The following command accomplishes this:
ln -s /opt/gnome/lib/control-center-2.0/gnome-settings-daemon /home/ user/.kde/Autostart
For user, use your username.
Create a GTK control file (usually named .gtkrc-2.0) in your user home directory or the directory where your system is configured to look for GTK2_RC_FILES. Entering set |grep gtk shows how this environment variable is configured and which files it is looking for. The file should include the following information. You can use any font and GTK theme that you prefer.
include "/opt/gnome/share/themes/Xfce-stellar/gtk-2.0/gtkrc" style "user-font" { font_name="Sans Serif 6" } widget_class "*" style "user-font" gtk-theme-name="Xfce-stellar" gtk-font-name="Sans Serif 6"
The S tartDesigner.sh file sets important variables, permissions, and memory parameters. If Designer isn't launched from this file, Designer won't function correctly or be able to call other programs (for example, Mozilla*) on Linux.
StartDesigner.sh is located in the /[path to the Designer install]/designer/eclipse directory.
The latest Fedora core ships with new shared libraries that cause problems in Designer. You might see errors in the error log when you try to use Designer's browser functionality or when performing various operations in Designer's editors. To solve this problem, log in as root and issue the following command to install a compatibility library:
sudo yum install libstdc++.so.5.
Certain links on the What's New page (specifically the Bugzilla links) do not launch a browser on Linux. This is an Eclipse issue that should be fixed in later versions that we will implement into Designer. As a temporary workaround, you can configure your Eclipse preferences to launch an external browser for viewing help files:
Select > > > .
Select .
Select a browser, then click .
If a field on a form used by a workflow returns the value undefined, the form does not display an error or warning message. This situation results from a problem in the script. In general, if a form script evaluates to undefined, the script is considered to be in error. The workaround is to make sure you do not set undefined in the preactivity mappings. To do this, use a try/catch/finally block to ensure that a valid value is always being sent to each control.
You might encounter the following error message when trying to set Trustee rights on a provisioning request definition or when trying to access the Identity Vault via the ECMA expression builder:
Cannot connect to host 'xxx', verify the address is correct and the server is running.
If the address is correct and the server is running, a slow connection might cause this error message.
You can change the connection timeout by setting the Connection preference. Select > > .
When you connect to the Identity Vault from the provisioning request editor (for example when setting Trustee rights on a provisioning request definition) you are prompted for your Identity Vault credentials. If you type an incorrect password and click the Save password button in the Identity Vault credentials dialog box, you cannot connect to the Identity Vault and you are not prompted to retype your credentials.
To work around this issue, access the Modeler view and reconfigure the Identity Vault credentials for the project.
If you run Designer on Windows XP using the Windows Classic Theme, you might encounter problems when you tab between radio buttons. The radio buttons disappear. To work around this problem, use the Windows XP theme.
If you delete an entity and select on the container, the message displayed in the Deployment Results dialog box is misleading. The message indicates that the entity was successfully deployed, not undeployed.
When you generate provisioning documentation for a version 3.0.1 or 3.5 User Application driver, the documentation lists the driver as 3.5.1. The version number in the documentation should be 3.0.1 for the 3.0.1 driver or 3.5 for the 3.5 driver.
Novell, Inc. makes no representations or warranties with respect to the contents or use of this documentation, and specifically disclaims any express or implied warranties of merchantability or fitness for any particular purpose. Further, Novell, Inc. reserves the right to revise this publication and to make changes to its content, at any time, without obligation to notify any person or entity of such revisions or changes.
Further, Novell, Inc. makes no representations or warranties with respect to any software, and specifically disclaims any express or implied warranties of merchantability or fitness for any particular purpose. Further, Novell, Inc. reserves the right to make changes to any and all parts of Novell software, at any time, without any obligation to notify any person or entity of such changes.
Any products or technical information provided under this Agreement may be subject to U.S. export controls and the trade laws of other countries. You agree to comply with all export control regulations and to obtain any required licenses or classification to export, re-export, or import deliverables. You agree not to export or re-export to entities on the current U.S. export exclusion lists or to any embargoed or terrorist countries as specified in the U.S. export laws. You agree to not use deliverables for prohibited nuclear, missile, or chemical biological weaponry end uses. Please refer to the Novell International Trade Services Web page for more information on exporting Novell software. Novell assumes no responsibility for your failure to obtain any necessary export approvals.
Copyright © 2007 Novell, Inc. All rights reserved. No part of this publication may be reproduced, photocopied, stored on a retrieval system, or transmitted without the express written consent of the publisher.
Novell, Inc. has intellectual property rights relating to technology embodied in the product that is described in this document. In particular, and without limitation, these intellectual property rights may include one or more of the U.S. patents listed on the Novell Legal Patents Web page and one or more additional patents or pending patent applications in the U.S. and in other countries.
For Novell trademarks, see the Novell Trademark and Service Mark list.
All third-party trademarks are the property of their respective owners.