2 Known Issues

This chapter describes the known issues you might encounter when you install and configure Oracle Unified Directory 11g Release 2 PS1 (11.1.2.1.0) and its components. It includes the following topics:

Section 2.1, "Known Issues with Oracle Unified Directory 11g Release 2 PS1 (11.1.2.1.0)"
Section 2.2, "Known Issues with Oracle Directory Services Manager"

2.1 Known Issues with Oracle Unified Directory 11g Release 2 PS1 (11.1.2.1.0)

Table 2-1 lists known issues and limitations with 11g Release 2 PS1 (11.1.2.1.0).

Table 2-1 Known Issues with Oracle Unified Directory

Bug Number	Description	Workaround
11678445	When you run the `oud-setup` command and set the `INSTANCE_NAME` variable to a path for which you do not have the appropriate file permissions, the command fails.	The workaround is to have the required file permissions for the path to which `INSTANCE_NAME` variable points.
11718654	In a replicated topology, if the server has a heavy workload then the following error message is recorded in the error log: The server failed to obtain a read lock on the parent entry `dc=example`, `dc=com` after multiple attempts.	You need to configure a larger database cache. For more information, see "Tuning the Server Configuration" in Oracle Fusion Middleware Administrator's Guide for Oracle Unified Directory.
11810392	If an entry has non-ASCII characters used in its name or any property, then the result returned when you run the `ldapsearch` command has those non-ASCII characters suppressed in the print.	There is currently no workaround for this issue.
11812850	On Windows system, if the path to your Java installation in the `-jreLoc` option includes a space character, then the installer does not run appropriately and terminates.	The workaround is to provide the path to your Java installation in DOS 8.3 format. For example: -jreloc C:\Progra~1\Java\jdk1.6.0_21 For more information, see "Installing Oracle Unified Directory" in Oracle Fusion Middleware Installation Guide for Oracle Unified Directory.
11869296	Under heavy and sustained load the database cleaning process does not end.	The workaround is to configure a larger database cache. For more information, see "Tuning the Server Configuration" in Oracle Fusion Middleware Administrator's Guide for Oracle Unified Directory.
12266690	If you delete the load balancing workflow element or the load balancing algorithm, the load balancing routes are also deleted without any warning.	There is currently no workaround for this issue.
12280658	Modify DN (ModDN) is not supported if the DNs are indexed in the global index catalog (GIC).	If DNs are not indexed in the global index catalog, the modify DN operation is supported. Otherwise, only the modify RDN operation is supported.
12291860	On Windows systems no SNMP trap is sent if the server is stopped by using `stop-ds` with no credentials. The server is, however, stopped correctly.	The SNMP trap is sent if the server is stopped by using `stop-ds -D bindDN -p password`.
12291880	The performance of the `rebuild-index` command decreases as the database IDs become unordered over time.	If possible, avoid reindexing large databases or import the database again. For more information, see "rebuild-index" in Oracle Fusion Middleware Administrator's Guide for Oracle Unified Directory.
12329839	When you run the Oracle Unified Directory installer using the `runInstaller` command on SuSE Linux Enterprise Server 11, the prerequisite checks are not executed and an error is generated.	The workaround is to use the `-ignoreSysPrereqs` flag while running the runInstaller command.
13919632	The error log may contain `servere_warning` while setting the file permissions on Microsoft Windows using Java 6.	The workaround for this issue is to apply access-control restrictions from the top-level folder of any Oracle Unified Directory instance. In addition any Oracle Unified Directory process running on Microsoft Windows should be granted `FULL` access to the selected folder. This issue does not appear in Java 7, because Oracle Unified Directory uses Java 7 File APIs to set permissions.
13954545	On Windows system with a JDK 1.7 JVM instance running, the ldapsearch.bat client might not handle the trailing "*" correctly.	The workaround is to download the latest JDK version to leverage the fixes and updates that are added to the Java SE platform.
13965857	The `-tih, -targetInstanceHomeLoc` option of the `oudPasteConfig` command allows you to specify the location of the cloned server instance. If you specify an alternative location, for the cloned server instance, the instance is still created in the default location (TARGET_ORACLE_HOME/../TARGET_INSTANCE_NAME) and no error message is generated. However, the cloned server is configured partially as some custom parameters are not updated in the cloned server instance.	To successfully clone the server instance as the `-tih` parameter is mandatory, you must explicitly provide the default location for the `-tih` parameter as follows: -tih TARGET_ORACLE_HOME/../TARGET_INSTANCE_NAME
13996369	The `gicadm` command does not import a catalog when you specify a relative path.	You must specify an absolute path to import a catalog.
14055062	On Windows system, if the value for parameter `-j, --rootUserPasswordFile` is provided as a relative path, then `oud-setup, oud-proxy-setup,` and `oud-replication-gateway-setup` commands fail.	The workaround is to provide an absolute path for `-j, --rootUserPasswordFile` parameter. For example: -j C:\local\Password.txt
14065106	Oracle Unified Directory does not support translation of both messages and Help for `oudCopyConfig, oudExtractMovePlan`, and `oudPasteConfig` commands.	There is currently no workaround for this issue.
14080885	The `moveplan` does not have a field to update the path for keystore pin file during the cloning process.	The workaround is to use the `dsconfig` command on the cloned instance to update the `key-store-pin-file` value of `JKS Key Manager Provider` while cloning.
14283300	The following error may be written to the log files when running Java 6 Update 32 or later in a Windows environment: `category=JEB severity=SEVERE_WARNING msgID=8519808 msg=An error occurred while setting file permissions for the backend database directory C:\OUD\db\userRoot: org.opends.server.types.DirectoryException: One or more updates to the file permissions for C:\OUD\db\userRoot failed, but at least one update was successful. Some of the permissions for the file may have been altered.`	When running Java 6 or later in a Windows environment you should use Windows' native security tools to assign access control on any folders containing sensitive information after the Oracle Unified Directory install is complete. Access permissions in Windows are inherited, you should assign access control restrictions to the top-level Oracle Unified Directory folder, and ensure that all running Oracle Unified Directory processes are granted full access to that folder.
14562017	When you export data using JDK1.7.0_05 or higher the server is stopped.	The issue arises, because of an issue with JDK1.7. Until this is solved in an upcoming JDK1.7 release the workaround is to use the following option: `-XX:-OptimizeStringConcat`
14753554	The `gicadm` command is not compatible with earlier Oracle Unified Directory versions.	There is currently no workaround for this issue.
14768666	When you use the `addoutboundattr` transformation, for instance `cn=%sn%` with conflict behavior set to `Merge-real-and-virtual,` then the `ldapcompare` command might erroneously return `FALSE,` because comparison is done only on `sn` values and not on `cn` values.	There is currently no workaround for this issue.
14768705	If you omit the curly brackets `{}` while configuring the client-attribute value for an `AddOutboundTransformation,` for instance `client-attribute:"cn=%sn%.%cn%"` instead of `"cn={%sn%.%cn%}"` then the `dsconfig` command does not throw any warning. However, the transformation does not work correctly.	There is currently no workaround for this issue.
14772631	When you configure an `AddOutboundTransformation` with `virtualAttr={%sn%.%cn%@o.com}`where the definition contains a dot, then a search request with a filter on the `virtualAttr` parameter might not work correctly. For instance, the `sn` and `cn` backend attribute values contain a dot, such as `"sn:sn.light"` and `"cn:cn.light."` Here, a search request with a filter on the `virtualAttr`, for example `"virtualAttr=sn.light.cn.light@o.com"` might not work correctly.	There is currently no workaround for this issue.
15939456	In a replicated topology, the `dsreplication` status command displays incorrect port and information when you stop a replicated server.	There is currently no workaround for this issue.
16053072	The server does not start after an upgrade on Microsoft Windows.	The workaround for this issue is to manually copy the INSTALL_DIR`\bat\start-ds.bat` file into the instance that needs to be upgraded. You can then run the `start-ds.bat --upgrade` command, and finally the `start-ds.bat` command to start the server.
16214645	When you install an Oracle database version 11.1.6.0 while setting up the Enterprise User Security (EUS) configuration, you might face ORA-28030 Server encountered problems accessing LDAP directory service.	The workaround is as follows: Log in to Oracle Wallet Manager. Open the wallet, which is by default stored at the following location: ORACLE_BASE`/admin/`SID/`wallet` Enter the password for wallet provided while registering using DBCA. From the File menu, select auto-login. Select the auto-login checkbox from the wallet manager. Save the wallet to create the cwallet.sso file.
16372925	On Windows, while upgrading when you provide an installation location that contains an existing Oracle Unified Directory instance, then the installer does not throw any warning that the existing Oracle Unified Directory instance will be overwritten.	There is currently no workaround for this issue, because this is an upgrade operation. Therefore, it is recommended that you ensure your objective is to upgrade the existing Oracle Unified Directory instance.
16375185	After upgrading your directory service to the latest version, you need to copy the following files manually from the installation directory to the instance directory: For Windows: bat/split-ldif.bat bat/gicadm.bat bat/gicdump.bat bat/dps2oud.bat For Unix: bin/split-ldif bin/gicadm bin/gicdump bin/dps2oud	There is currently no workaround for this issue.
16477758	Entry cache might not be correctly updated.	You must disable the entry cache, running the following command: dsconfig set-entry-cache-prop \ --cache-name FIFO \ --set enabled:false\ --port ADMIN_PORT \ --bindDN cn=Directory\ Manager \ --bindPassword ****** \ --no-prompt
16555520	After upgrading to 11g Release 2 PS1 (11.1.2.1.0) release, a warning about duplicate object class for configuration entries related to indexes `ds-sync-hist` and `objectClass` might be logged. This warning might appear as output when you start the server or in the `server.out` log file.	You can safely ignore this warning as it has no impact on the server behavior.

2.2 Known Issues with Oracle Directory Services Manager

Table 2-2 lists known issues with Oracle Directory Services Manager at the time of Oracle Unified Directory 11g Release 2 PS1 (11.1.2.1.0) release.

Table 2-2 Known Issues with Oracle Directory Services Manager

Bug Number	Description	Workaround
11937031	Microsoft Internet Explorer 7 does not render some Web pages of Oracle Directory Services Manager properly. It does not lead to any loss of functionality, but some Web pages display with unnecessary scroll bars or wrapped field names.	The workaround is to upgrade the browser to Microsoft Internet Explorer 8 or Microsoft Internet Explorer 9. While using Microsoft Internet Explorer 8 or Microsoft Internet Explorer 9, you need to disable the compatibility view mode in the browser. For more information about how to disable the compatibility view mode in the browser, refer to the following Web page: `http://support.microsoft.com/kb/956197`
12363352	When you are in the screenreader mode, the Create, Apply, and Cancel buttons in the Oracle Directory Services Manager interface does not get focus after modification.	The workaround is to press the Tab key till you get the focus on the required button. Alternatively, you can use the mouse to activate the required button.
15928439	While accessing information of a changelog entry, you might receive a Java NullPointer exception if the entry does not have an objectclass specified.	There is currently no workaround for this issue.
16048731	When you click any item of type `Objectclass` on the Schema tab in Microsoft Internet Explorer, then the browser hangs and does not respond. You might observe the same behavior for `Content Rules` in the Schema tab and `Virtual Attributes` in the Configuration tab.	The workaround is to apply a patch that addresses Bug 13417997 (v1 non_edg:script on the pg is causing ie to run slowly' err running qtp scripts). A patch for the current release is available as Patch 16478722 (merge request on top of 11.1.1.6.0 for Bugs 16011916 and 13417997). This patch can be downloaded from My Oracle Support.
16056177	On the Advanced Search page, when you click an entry in the Search Results table, the Show Attributes button does not appear if Optional Attributes is already expanded. However, if you collapse Optional Attibutes and then expand, the Show Attributes button appears. But, when you click the button the Select Attributes dialog box is blank.	There is currently no workaround for this issue.
16056480	On the Advanced Search page, from the Fetched Attributes list when you select Pick Attributes and click Search, then the entries are displayed in the Search Results table as expected. If you select an entry all the information is displayed correctly in the next page. However, if you click Refresh, then all the Mandatory Attributes values and Optional Attributes values disappear.	There is currently no workaround for this issue.
16167561	On the Advanced Search page, from the Fetched Attributes list when you select Pick Attributes then the Object Class and Common Name(cn) columns are blank when you click Next to go to the second page.	There is currently no workaround for this issue.
16561545	When you deploy Oracle Directory Services Manager on IBM WebSphere using the `was_config` script, then the deployed application does not have the shared library references.	The workaround is to add the missing shared library references, `adf.oracle.domain` and `oracle.jsp.next` in Oracle Directory Services Manager manually using the IBM WebSphere Administrative console. Perform the following steps: Log in to the IBM WebSphere Administrative Console using the following URL: `http://HOSTNAME:PORT/ibm/console` Here, `PORT` is port number for the WebSphere administrative HTTP transport (`WC_ adminhost`). The default value is `9060`. In the console navigation tree, expand Applications, and then Application Types and then click WebSphere enterprise applications to open the list of applications. In the Enterprise Applications page, click the application that needs to refer to the shared library. In this scenario, select odsm_11.1.2.1.0. Under Configurations, click Shared library references. Note: The Shared Libraries column is empty for the Application `odsm_11.1.2.1.0`. In the Shared Library Mapping for Modules section, select the check box for odsm_11.1.2.1.0 application, and then click the Reference shared libraries button above the table. Select the following shared library from the Available list and move it to the Selected list: `adf.oracle.domain_1.0_11.1.1.2.0` `oracle.jsp.next_11.1.1_11.1.1` Click OK. Verify the Shared Libraries column for the row Application odsm_11.1.2.1.0 in the table. Click OK. On the Configuration main page, click Save to commit the changes. Click OK. Perform the following steps to restart the application that references the shared library: a) Select the check box for odsm_11.1.2.1.0 application. b) Click Stop. c) Select the check box for odsm_11.1.2.1.0 application. d) Click Start.