NetIQ Identity Manager Designer 4.8 Release Notes

October 2019

NetIQ Identity Manager Designer 4.8 includes new features, improves usability, and resolves several previous issues.

Many of these improvements were made in direct response to suggestions from our customers. We thank you for your time and valuable input. We hope you continue to help us ensure that our products meet all your needs. You can post feedback in the Identity Manager Community Forums, our community Web site that also includes product notifications, blogs, and product user groups.

For information about what’s new in previous releases, see the “Previous Releases” section in the Identity Manager Documentation Web site.

For more information about this release and for the latest release notes, see the Identity Manager Documentation page. To download this product, see the Identity Manager Product Web site.

1.0 What’s New and Changed?

The following sections outline the key features and functions provided by this version, as well as features that have been removed from the product, and issues resolved in this release:

1.1 New Features

This release provides the following key features:

Operating System Support

This release adds support for the following platforms:

  • SUSE Linux Enterprise Server (SLES) 12 SP4, and SLES 15

  • RedHat Enterprise Linux (RHEL) 7.5, RHEL 7.6, RHEL 8

  • Windows 2016, Windows 2019

  • MacOS 10.14 (Mojave)

  • SUSE Linux Enterprise Desktop 15

  • OpenSuSe LEAP 15 or later

Support for Java 8 Update 222

Designer has been updated to Java 8 Update 222.

Using Git for Package Version Control

Identity Manager introduces Git, an open source version control system, for managing versions of packages in Designer. Git allows you to manage, track, maintain the history of changes, or retrieve an earlier state or compare different states of packages with speed and efficiency. For more information, see “Managing Package Versions Using Git” in the NetIQ Designer for Identity Manager Administration Guide.

Support for Creating Forms using the new Workflow Form Builder

Identity Manager introduces a new tab named JSON Forms in the Provisioning Request Definition editor of Designer for creating and managing forms in the new Workflow Form Builder. The forms that are created using this tab are saved in the JSON format.

For more information about working with the JSON Forms tab, see “About Form Builder” in the NetIQ Identity Manager - Administrator’s Guide to Designing the Identity Applications. For more information about creating forms in the Workflow Form Builder, see the NetIQ Identity Manager - User’s Guide to Form Builder.

Performance Improvement

To improve the performance of Designer, the following changes have been made to the Designer software:

  • To improve the speed of launching Designer, the legacy driver configuration files are no longer a part of the Designer startup script. Instead, these files are included in a separate plug-in located in the Designer installation package. You must manually the load the configuration files from the plug-in for the drivers needed in your environment.

  • Designer enables you to manage the installed packages in your Identity Manager environment to help you keep only the required packages in your environment.

    The Manage Package window is displayed when Designer is launched for the first time. Alternatively, navigate to Help > Manage Packages. For more information, see “Managing Installed Packages” in the NetIQ Designer for Identity Manager Administration Guide.

  • Due to high memory consumption, expanding User Application Driver in the Outline view is no longer supported in 4.8 release and onwards. Use the Provisioning view to make any changes to User Applications objects.

2.0 System Requirements

For information about hardware requirements and supported operating systems, see the System Requirements for Identity Manager 4.8 document.

3.0 Installing Designer 4.8

After you purchased Identity Manager 4.8, log in to the Identity Manager Product Web site and follow the link that allows you to download the software. The following files are available:

File Name



Contains Designer for Linux

Contains Designer for Windows


Contains Designer for MacOS 10.14 (Mojave)

To download the installation kits, see the NetIQ Downloads Web Site.

4.0 Upgrading to Designer 4.8

You can upgrade to Designer 4.8 from Designer 4.7 using the Designer installation program. For information about the supported upgrade paths, see Supported Upgrade Paths in the NetIQ Identity Manager Setup Guide for Linux or Supported Upgrade Paths in the NetIQ Identity Manager Setup Guide for Windows.

5.0 Updating Designer Packages in Offline Mode

To update Designer packages in offline mode, make the package update files available in a local directory on your computer and then configure Designer to read the files from this directory.

To create an offline copy of the package update files:

  1. Log in to the computer that has Designer installed and create a local directory.

  2. Copy the package update files to the directory created in Step1:

    • Linux: In a shell, change to the directory and run the following commands:

      wget -r -nH -np -e robots=off

      wget -r -nH -np -e robots=off

    • Windows: Perform the following actions:

      1. Launch the package update site by using one of the following URLs:



      2. Select and download the required files.

To configure Designer to read the files from the local directory:

  1. Launch Designer.

  2. From Designer’s main menu, click Windows > Preferences.

  3. Click NetIQ > Package Manager > Online Updates.

  4. Click the plus icon to add a new URL.

  5. Provide information for the following fields:

    1. Vendor: Specify the vendor name for package update.

    2. URL: Specify the URL as file:///<path_to_files>/packages/idm/updatesite1_0_0/.

      For Linux mounted ISO, use the following URL format:



      NOTE:To add multiple package sites, repeat this step for including the specified URLs.

  6. Click OK.

  7. Select the required check boxes for the sites in the Preferences window.

    NOTE:The new sites are selected by default.

  8. Click Apply, then click OK.

  9. From Designer’s main menu, click Help > Check for Package Updates.

  10. Select the required updates and click Yes to accept and update the Designer package updates.

    You need to launch Designer again for the changes to take effect.

6.0 Installing Designer on macOS 10.14 (Mojave)

NetIQ provides Identity_Manager_4.8_Designer_MacOSX.dmg file for installing Designer on macOS 10.14.

Perform the following actions to install Designer on macOS system:

  1. Download the Identity_Manager_4.8_Designer_MacOSX.dmg from NetIQ Downloads Web Site.

    NOTE:Sometimes quarantine attributes such as are included in the Designer application that prevents you from launching Designer. To resolve this issue, see Unable to Launch Designer Application on Mac on NetIQ Designer for Identity Manager Administration Guide.

  2. From the pop-up window that appears, drag and drop the Designer folder into the location where you want to install it.

    By default, Mac prompts you to download Designer into the Applications folder. If you choose to install Designer in this folder, Mac creates a Designer shortcut on the launchpad.

    IMPORTANT:The following considerations apply to installing two instances of Designer on your operating system:

    • Install the instances in two different folders.

    • Install the new instance in a folder that has an existing instance of Designer. In this case, ensure that you rename the first instance before placing a new instance of Designer.

  3. If you are launching Designer for the first time and see the following message, you must run the script. It updates the Info.plist files of the Designer and Azul Zulu JDK applications with missing capabilities in absence of which you see this message.

    If you do not see this message, directly go to Step 4.

    Figure 1 Install legacy Java SE 6 message

    NOTE:In case you do not have the Azul Zulu JDK version 8u222-b10 installed in the system, install it from <jdk>.dmg file only before you run the script.

    Perform the following actions:

    1. Open a browser and specify the following URL:

    2. Download the file.

    3. Launch a terminal window and run the following command from the directory where you have downloaded the file:

      sudo python

    4. Specify the value corresponding to the Azul Zulu JDK version 8u222-b10.

    5. From the list of Designer versions displayed, specify the value corresponding to the required Designer version.

      The Info.plist file is updated.

  4. Launch Designer by clicking the Designer icon on the launchpad or the Designer application from the installed folder.For more information about using Designer, see NetIQ Designer for Identity Manager Administration Guide.

Uninstalling Designer

To uninstall Designer, right click the Designer folder and select Move to trash.

After Designer is uninstalled, the shortcut is automatically removed from the launchpad.

For troubleshooting Designer, see Troubleshooting Designer in NetIQ Designer for Identity Manager Administration Guide.

7.0 Known Issues

NetIQ Corporation strives to ensure our products provide quality solutions for your enterprise software needs. The following issues are currently being researched. If you need further assistance with any issue, please contact Technical Support.

7.1 PRD Compare Not Showing Form Dependencies for New JSON Forms

Issue: In case of Provisioning Request Definition with new JSON forms, the Compare feature will not show you the form dependencies. If Compare > Reconcile operation is used for deploying the PRD, any changes in the form fields will not get deployed.

Workaround: Use the Deploy feature to see the form dependencies and to deploy the changes made in the form.

7.2 PRD Not Getting Updated When Select Form Field Is Changed from Single to Multiple Value

Issue: In Form Builder, if you modify attribute of a field, for example Select field from single value to multiple value, the change will not update in PRD. The PRD in the text editor will show target-type="single-value" as shown below:

                data-type="string" name="select2"

Workaround: To update the change target-type="multi-value-list" in PRD, perform the following actions:

  1. Go to the PRD view and click the activity associated with the form. This will update the target-type="multi-value-list" for the Select field.

  2. Save and deploy the PRD.

7.3 Add Policy Failing in Designer 4.8 with Identity Manager Version 4.7.3

Issue: In Designer 4.8, with Identity Manager version 4.7.3, when you add a New DirXML Script Policy, a Failed to create the part's controls message is displayed.

Workaround: Perform the following steps to resolve this issue.

  1. Navigate to the Designer 4.8 installed location in your system: <Designer_installation_path>\plugins\com.novell.idm.policybuilder_<latestversion>\DTD

    For example, C:\netiq\idm\apps\Designer\plugins\com.novell.idm.policybuilder_4.0.0.201906141638\DTD

  2. Copy-paste dirxmlscript4.7.2.dtd file to create its duplicate. Rename the copy as dirxmlscript4.7.3.dtd.

  3. Restart the Designer.

7.4 When User Application Driver 4.7 package is installed, Helpdesk Ticket Template package with Version 4.8 is installed instead of 4.7

Issue: In Designer 4.8, with Identity Manager version 4.7.3, when you create User Application driver 4.7 package, the Driver Configuration Wizard installs Helpdesk Ticket Template package with Version 4.8 instead of 4.7.

Workaround: Perform the following steps to downgrade the Helpdesk Ticket Template to 4.7.

  1. In Outline view, right-click Identity Vault and then select Properties.

  2. Select Packages option.

  3. In the Helpdesk Ticket Template, click Operation drop-down and select Downgrade option.

  4. Select the version as 4.7.

  5. Click OK.

7.5 Unable to Launch Form Builder When Designer is Installed in Custom Install Path on Linux Platforms

Issue: If you have installed Designer in a non-default location on Linux, then the Form Builder cannot be launched. In this case, the Form Builder files located at <designer_installed_path>/plugins/<version_number>/lib directory does not have the required executable permission in order to launch the Form Builder. (Bug 1163062)

Workaround: Perform the following actions:

  1. Open the command prompt on the system where you have installed Designer.

  2. Navigate to the <designer_installed_location>/plugins/ location.

    For example, cd <designer_installed_location>/plugins/

  3. Run the following commands:

    find -iname "*.so" -exec chmod 755 '{}' \;

    find -iname "*.bin" -exec chmod 755 '{}' \;

    chmod 755<version_number>/lib/form-builder

  4. Launch Designer.

8.0 Contact Information

Our goal is to provide documentation that meets your needs. If you have suggestions for improvements, please email We value your input and look forward to hearing from you.

For detailed contact information, see the Support Contact Information website.

For general corporate and product information, see the NetIQ Corporate website.

For interactive conversations with your peers and NetIQ experts, become an active member of our community. The NetIQ online community provides product information, useful links to helpful resources, blogs, and social media channels.