Odi Doc 2
Odi Doc 2
1
This section contains information on the following issues:
• 999 is a Prohibited Master Repository ID
• Domain Assisted Schema Upgrade (DASU) Does Not Pre-populate ODI
Supervisor Credentials
• Unable to Include Dependencies while Creating Version
• CopyConfig command cannot connect to ODI schema through External
Authentication
• Upgrading commons-lang from 2.6 to commons-lang3-3.8.1.jar in SDK Script File
• Upgraded bpm-infra.jar Causes NullPointer Exception
2
command cannot connect to ODI schema through
CopyConfig
External Authentication
The CopyConfig command cannot be executed on an environment configured with
external authentication. It needs internal authentication to connect to the ODI schema.
[27084113]
For example :
import org.apache.commons.lang.ArrayUtils;
to
import org.apache.commons.lang3.ArrayUtils;
3
• Performance Delay While Editing Scenarios and Load Plans
4
New Data Server and New Logical Schema options along with some other menu
items stay missing.
As a workaround, restart the ODI studio. [ 29792225]
5
When executing a mapping using LKM Hive to File Direct, it fails and the following
error is displayed:
ODI-1227: Task Unload Hive data-LKM Hive to File Direct- fails on the source
connection HIVE_DATA_SERVER
This is caused due to Hive bugs, HIVE-5672 and HIVE-6410, which cause the INSERT
OVERWRITE statement to fail when writing to HDFS. Please note that these Hive
bugs are already fixed and the issue is resolved when upgraded to a recent version of
CDH and Hortonworks. [21529011]
Log Files are Deleted Even in Case of Failure when Using the
OdiOSCommand on Oozie
Many KMs that use OdiOSCommand use the OUT_FILE/ERR_FILE parameters to
redirect output into log files.The directory for such files is based on the KM option
TEMP_DIR, which uses a default value of System.getProperty("java.io.tmpdir").
This causes ODI on Oozie to use an Oozie job temporary directory, which gets
cleaned up on job completion, irrespective of whether the job was successful. This
results in the log files not being available after execution.
As a workaround, when executing on Oozie, overwrite the KM option TEMP_DIR to a
specific temporary directory. [21232650]
Note:
Folder oozie-sharelib-yarn is local to the oozie setup. After creating the
sharelib, you can verify the sharelib on HDFS at the location hdfs:///user/
oozie/share/lib/lib_<timestamp>
2. Add the following properties to oozie-site.xml. These properties are needed for
Oozie to obtain the hadoop configuration files to access HDFS. In the first property
value, add the path after "*="
6
<property>
<name>oozie.service.HadoopAccessorService.hadoop.configurations</name>
<value>*=<replace_this_with_path_to_hadoop_configuration_folder For
Example:/etc/hadoop/conf></value>
<value>*=<replace_this_with_path_to_hadoop_configuration_folder
For Example:/etc/hadoop/conf></value>
</property>
<property>
<name>oozie.service.WorkflowAppService.system.libpath</name>
<value>hdfs:///user/oozie/share/lib</value>
</property>
For example:
hdfs dfs -mkdir -p /opt/cloudera/parcels/CDH-5.3.0-1.cdh5.3.0.p0.30/jars
hdfs dfs -copyFromLocal
/opt/cloudera/parcels/CDH-5.3.0-1.cdh5.3.0.p0.30/jars/* /opt/cloudera/parcels/
CDH-5.3.0-1.cdh5.3.0.p0.30/jars
7
For example, if the attribute is defined as DOUBLE, the constant expression for this
attribute should be set to 999.0 instead of 999. [20808984]
To resolve this issue, upgrade the topology information so Support Distinct Operator is
set to True. [20234590]
8
• unspecified – Perform a DISTINCT operation on output
• DISTINCT – Perform a DISTINCT operation on input, but not output
• ALL – Do not perform a DISTINCT operation on input or output
Log Level and Log File Not Displayed in the Complex File
Dataserver Properties
When creating a Complex File dataserver, the log level (ll) and log file (lf) properties
are not displayed in the Properties tab. [20377218]
Also, please note that no Support Requests can be raised regarding the unsupported
Spark execution modes.
9
WebLogic JDBC Driver for Cassandra will encounter file permission problems and
displays errors messages such as:
py4j.protocol.Py4JJavaErrorpy4j.protocol.Py4JJavaError: An error
occurred while calling o140.jdbc.
: java.sql.SQLException: [FMWGEN][Cassandra JDBC Driver]
[Cassandra]Unable to create local database file: $$ The cause: $$
This error is often caused by the driver not having write access to the target directory.
[24928801]
• Use of extended TIMESTAMP and INTERVAL datatypes such as: TIMESTAMP WITH
TIME ZONE, TIMESTAMP WITH LOCAL TIME ZONE, INTERVAL DAY TO SECOND,
INTERVAL YEAR TO MONTH will cause the following errors:
py4j.protocol.Py4JJavaErrorpy4j.protocol.Py4JJavaError:
An error occurred while calling o43.jdbc.:
java.sql.SQLException: Unsupported type -101
10
• If you have any custom KMs, the customizations are lost if you upgrade the KMs
during repository upgrade.
As a workaround, uncheck Replace KMs with Mandatory Updates when
upgrading the ODI repositories. After you upgrade the repositories, manually
replace only those KMs that you want to upgrade.
11
• MapPhysicalDesign.ExecutionUnitGraphNode
• MapPhysicalDesign.MapPhysicalDesignConfig
• MapPhysicalDesign.NodeConfiguration
• MapPhysicalDesign.PushDirection
• MapPhysicalNode.RMCStackPropertyManager
• MapRootContainer
• MappingGenericTechnology.MappingLanguage
• MappingGenericTechnology.MappingLanguageElement
• MappingGenericTechnology.MappingSubLanguage
• NamedObject
• OdiComponent
• OdiInterface.IPersistenceComparable
• PropertyOwner
• ResourceLoader
• ResourceLoader.ResourceCandidate
• ReusableMappingComponent.RMCConnectorPointDelegate
• Root
• RootIssue.TextPos
• TargetLoadOrderException
CKM Fails with XML and Complex Files When Database is Set to
External
Flow control steps (CKM) fail with ORA-00904: "NOW": invalid identifier errors
when CKM is used with XML and Complex Files. Mapping is defined to load data into
a Complex File target Datastore, while the Complex File Data Server is defined to use
an external database.
You get the following error message:
at oracle.jdbc.driver.T4CTTIoer11.processError(T4CTTIoer11.java:495)
at oracle.jdbc.driver.T4CTTIoer11.processError(T4CTTIoer11.java:447)
12
The problem is due to ODI not being able to pick the right DATE function when the flow
or static control is run on a XML ( or Complex File ) Data Server defined to use an
external database.
One of the main reason behind this limitation is, the CKM code being executed on the
external database technology ( for example Oracle ), should use DATE function
specific to that technology. Instead it gets the information from the definition of the
XML or Complex File technology and the resulting function does not apply to the
external database technology. As a result ODI is not able to run static or flow control
( CKM ) on technologies such as XML and Complex Files when the Data Server is set
to use an external database.
So, the workaround is to edit the CKM Insert PK errors, Insert AK errors, Insert
FK errors and Insert CK errors tasks' target commands by replacing
OdiRef.getInfo("DEST_DATE_FCT")with the date function of the used external
database technology. For example — sysdate, if you are using Oracle external
database. [28641256]
When you re-open the KM Editor and go to Flexfields tab, the newly created flexfields
may not be displayed, though they are already saved. Refreshing the Tree on save
when multiple editors are open may result in performance issues. To avoid
performance issues, refresh the parent of the KM before you re-open it.[28561299]
Note:
Once the ODI repository is upgraded it cannot be reverted back even if
you remove the patch. So make sure you make a proper backup of your
existing ODI repository so that it can be restored if you remove this patch
in the future for any reason.
3. For setting up new domains with this patch, follow the instructions in Installing and
Configuring Oracle Data Integrator.
4. Clearing of the JDev cache is required for all installations where the ODI Client is
to be launched:
13
• For UNIX platforms:
Locate system14.1.2.0.0 in your Home directory and remove it.
For example: rm -rf $HOME/.odi/system12.2.1.0.0
• For Windows platforms:
Locate system14.1.2.0.0 in your Home directory and remove it.
For example: delete C:\Users\<username>\AppData\Roaming\odi
5. Start ODI Studio.
6. Depending upon the installation type, start Standalone Agent or all servers
(AdminServer and all Managed server(s)).
Documentation Accessibility
For information about Oracle's commitment to accessibility, visit the Oracle
Accessibility Program website at http://www.oracle.com/pls/topic/lookup?
ctx=acc&id=docacc.
Oracle Fusion Middleware Release Notes for Oracle Data Integrator, 14c (14.1.2.0.0)
G10244-01
This software and related documentation are provided under a license agreement containing restrictions on use and disclosure and are protected by intellectual property laws.
Except as expressly permitted in your license agreement or allowed by law, you may not use, copy, reproduce, translate, broadcast, modify, license, transmit, distribute, exhibit,
perform, publish, or display any part, in any form, or by any means. Reverse engineering, disassembly, or decompilation of this software, unless required by law for
interoperability, is prohibited.
The information contained herein is subject to change without notice and is not warranted to be error-free. If you find any errors, please report them to us in writing.
If this is software, software documentation, data (as defined in the Federal Acquisition Regulation), or related documentation that is delivered to the U.S. Government or anyone
licensing it on behalf of the U.S. Government, then the following notice is applicable:
U.S. GOVERNMENT END USERS: Oracle programs (including any operating system, integrated software, any programs embedded, installed, or activated on delivered
hardware, and modifications of such programs) and Oracle computer documentation or other Oracle data delivered to or accessed by U.S. Government end users are
"commercial computer software," "commercial computer software documentation," or "limited rights data" pursuant to the applicable Federal Acquisition Regulation and agency-
specific supplemental regulations. As such, the use, reproduction, duplication, release, display, disclosure, modification, preparation of derivative works, and/or adaptation of i)
Oracle programs (including any operating system, integrated software, any programs embedded, installed, or activated on delivered hardware, and modifications of such
programs), ii) Oracle computer documentation and/or iii) other Oracle data, is subject to the rights and limitations specified in the license contained in the applicable contract.
The terms governing the U.S. Government's use of Oracle cloud services are defined by the applicable contract for such services. No other rights are granted to the U.S.
Government.
This software or hardware is developed for general use in a variety of information management applications. It is not developed or intended for use in any inherently dangerous
applications, including applications that may create a risk of personal injury. If you use this software or hardware in dangerous applications, then you shall be responsible to take
all appropriate fail-safe, backup, redundancy, and other measures to ensure its safe use. Oracle Corporation and its affiliates disclaim any liability for any damages caused by
use of this software or hardware in dangerous applications.
Oracle®, Java, MySQL, and NetSuite are registered trademarks of Oracle and/or its affiliates. Other names may be trademarks of their respective owners.
Intel and Intel Inside are trademarks or registered trademarks of Intel Corporation. All SPARC trademarks are used under license and are trademarks or registered trademarks
of SPARC International, Inc. AMD, Epyc, and the AMD logo are trademarks or registered trademarks of Advanced Micro Devices. UNIX is a registered trademark of The Open
Group.
14
This software or hardware and documentation may provide access to or information about content, products, and services from third parties. Oracle Corporation and its affiliates
are not responsible for and expressly disclaim all warranties of any kind with respect to third-party content, products, and services unless otherwise set forth in an applicable
agreement between you and Oracle. Oracle Corporation and its affiliates will not be responsible for any loss, costs, or damages incurred due to your access to or use of third-
party content, products, or services, except as set forth in an applicable agreement between you and Oracle.
15