NetIQ Identity Package Deployment Tool 1.0 Release Notes

June 2023

NetIQ Identity Package Deployment Tool 1.0 is a web-based tool that automates the deployment of drivers and packages in various customer environments For more information about this tool and the latest release notes, see the Documentation page. To download this product, see Software License and Download portal.

If you have suggestions for documentation improvements, click comment on this topic at the top or bottom of the specific page in the HTML version of the documentation posted on the Documentation page.

What’s New
System Requirements
Installing Identity Package Deployment Tool 1.0
Known Issues
Legal Notice

1.0 What’s New

2.0 System Requirements

2.1 Operating System

2.2 Supported Web Browsers

2.3 Third-Party Components

3.0 Installing Identity Package Deployment Tool 1.0

3.1 Prerequisites

3.2 Installation Procedure

4.0 Known Issues

4.1 Code (-9131) Error Reported When Trying to Start the Drivers

4.2 When Selecting Mandatory Features, the Sub-Packages Under Connected System are Not Selected By Default

4.3 No Error is Displayed on Choosing Objects Other Than Drivers in the DN Lookup Browser

4.4 Error Displayed in the Designer Workspace When Importing a Driver From Identity Vault

5.0 Legal Notice

1.0 What’s New

The NetIQ Identity Package Deployment Tool provides the following key features in this release:

Create and manage staging environments
Configure Identity Vault
Install, upgrade, downgrade, and uninstall packages in the Identity Vault
Create and manage driver sets and drivers in a stage
Compare and migrate similar drivers from one stage to another stage within the same stageset
Store driver configuration in Git (version control system)
Package catalog- ability to configure multiple channels for downloading packages
Import driver sets and drivers from Identity Vault into PDT
Deploy Identity Vault packages, driver set, and multiple drivers to the Identity Vault

2.1 Operating System

Microsoft Windows 10 and Microsoft Server 2019 and 2022
Red Hat Enterprise Linux (RHEL) 8.1, 8.2, 8.3, 8.4, 8.5, and 8.6
SUSE Linux Enterprise Server (SLES15) SP1, SP2, SP3, and SP4

2.2 Supported Web Browsers

Any of the following browser versions, at a minimum:

Google Chrome 100
Mozilla Firefox 105.0.1
Microsoft Edge 110.0.1587.57

2.3 Third-Party Components

Azul Zulu version of Java JDK 1.8.0_372

3.0 Installing Identity Package Deployment Tool 1.0

Prerequisites
Installation Procedure

3.1 Prerequisites

Before you begin, NetIQ recommends that you review the following prerequisites:

Ensure that Designer 4.8.7 is installed in your system.

For more information about installing Designer, see Installing Designer in the NetIQ Identity Manager Setup Guide for Linuxor Installing Designer in the NetIQ Identity Manager Setup Guide for Windows. If you are upgrading Designer, see Updating Designer in the NetIQ Identity Manager 4.8.7: Installation and Upgrade Guide
Ensure that Java 1.8 (latest update) is installed in your system. The Java command must be accessible from the console where the startup scripts are executed.
The IDM_PackageDeploymentTool_1.0.0.zip contains the PDT.keystore (path - \IDM_PackageDeploymentTool_1.0.0\keystore\pdt.keystore) file with a default SSL certificate. The user should create a new SSL certificate and add that certificate to the keystore. An alternative is that the user can import an already available certificate to the keystore. Make sure that you do not overwrite the existing entries (for example, ism.config.encrypt.0) in the pdt.keystore file.

3.2 Installation Procedure

Perform the following steps to install the Identity Package Deployment Tool 1.0:

Download the IDM_PackageDeploymentTool_1.0.0.zip from the Software License and Download portal and extract it in your system.
Navigate to the IDM_PackageDeploymentTool_1.0.0 folder in the extracted location.
(Conditional) To install Package Deployment Tool on Windows:

NOTE:It is recommended to use Windows Power Shell.
1. Double-click the create-password-config_win.bat to create an administrator password to login.
2. Re-enter the password to confirm.
3. Enter a valid Designer base path that corresponds to the Designer installation location.
  
  For example: C:\netiq\idm\apps\Designer
4. Double-click the start-pdt_win.bat to start the Package Deployment Tool.
5. (Optional) To stop the Package Deployment Tool, press Ctrl+C twice on your keyboard or click .
(Conditional) To install Package Deployment Tool on Linux systems:
1. Create an administrator password to login using the following command:
```
create-password-config_linux.sh
```
2. Re-enter the password to confirm.
3. Enter a valid Designer base path that corresponds to the Designer installation location.
  
  For example: root/designer
4. Execute the start-pdt_linux.sh command to start the Package Deployment Tool.
5. (Optional) Run the following shell script to stop the Package Deployment Tool:
```
stop-pdt_linux.sh
```
Launch the Package Deployment Tool user interface on the browser using the URL:
```
https://<ip_address>:<port>/pdt
```
For example:
```
https://localhost:8280/pdt/
```
Enter the default username (pdtadmin) and the password created using the create-password-config_<OS> script.

The Identity Package Deployment Tool 1.0 application is launched.

4.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.

Code (-9131) Error Reported When Trying to Start the Drivers
When Selecting Mandatory Features, the Sub-Packages Under Connected System are Not Selected By Default
No Error is Displayed on Choosing Objects Other Than Drivers in the DN Lookup Browser
Error Displayed in the Designer Workspace When Importing a Driver From Identity Vault

4.1 Code (-9131) Error Reported When Trying to Start the Drivers

Issue: When you try to start the driver after successfully deploying it with the Package Deployment Tool, the following error message is displayed:

Code(-9131) Error in vnd.nds.stream://<TREE>/system/driverset1/eDirectory+Driver/NOVLEDIRMSYS-itp-InitManagedSystemInfo#XmlData:89 : Error evaluating XPATH expression 'token-xpath("es:guid2string($driver//attr[@attr-name='GUID']/value/text())")' : com.novell.xml.xpath.XPathEvaluationException: function 'es:guid2string' not found

This issue specifically affects the following drivers:

eDirectory - Novell eDirectory (NOVLEDIRBASE)
Multi Domain AD
SOAP Server - SOAP (Simple Object Access Protocol) Server

This issue does not impact the functionality of the above drivers.

(Bug 648057, 651006, and 654098)

Workaround: Make sure to import the ECMAScript into the driver properties using Identity Console.

Log in to the Identity Console.
In the IDENTITY MANAGER module, click IDM Administration and select the required driver.
Click Data Transformation and Synchronization > Ecma Scripts.
To import, click and select the required ECMAScript from a list of ECMAScript resource files.

4.2 When Selecting Mandatory Features, the Sub-Packages Under Connected System are Not Selected By Default

Issue: When you add a driver to the driver set, the check box under Select Mandatory Features for the parent package is automatically selected, but not for the sub-packages. This issue is specific to the SOAP Server - SOAP (Simple Object Access Protocol) Server and JMS Queue - JMS (Java Messaging Service) Queue drivers. (Bug 654094)

Workaround: You will have to select the sub-packages manually.

4.3 No Error is Displayed on Choosing Objects Other Than Drivers in the DN Lookup Browser

Issue: When importing drivers from the Identity Vault, you can choose the required drivers under Tree > system > driverset<id> in the DN Lookup Browser window. If you choose packages and objects such as Tree, Security, data, and system without selecting a driver and then submit, the application displays no error message. The import driver operation, however, will fail. (Bug 672022)

To successfully import drivers into your staging environment, you must only select the required drivers from the driver set.

4.4 Error Displayed in the Designer Workspace When Importing a Driver From Identity Vault

Issue: The following error is displayed when importing a driver from Identity Vault into Package Deployment Tool: Designer: An error has occurred. See the log file <.log_file_location>.

This occurs because the temporary log file created in the Designer workspace is not deleted after the driver import operation is finished. (Bug 717002)

Workaround: To resolve the error, you must manually delete the Designer workspace folder in your system.

5.0 Legal Notice

For information about legal notices, trademarks, disclaimers, warranties, export and other use restrictions, U.S. Government rights, patent policy, and FIPS compliance, see https://www.netiq.com/company/legal.