简介：围绕 ODI 12cR1（12.1.3.0.0）的安装部署，这份自编实操文档适合初次接触 Oracle Data Integrator 的数据集成工程师、中间件管理员，以及需要独立搭建 ODI 环境的人员。文档以实际安装步骤为主线，先说明从 Oracle 官方获取 ODI 与 Fusion Middleware Infrastructure 两个安装包的方法，并特别强调 JEE 企业版必须先安装 Infrastructure 这一前提，独立安装则无需该组件；随后详细讲解在已装 JDK 1.7 以上版本的前提下，使用 java -jar 命令依次启动 infrastructure 和 odi 安装程序、在首次运行 odi64.exe 时指定 JDK Home 路径等操作，并配有界面说明。安装完成后，文档还梳理了 ODI Studio 中 Operator/Topology、映射接口与知识模块等核心配置思路，帮助读者从安装环节顺利过渡到数据集成项目开发。资源为单个 docx 文件，容量约 2.23MB，内容紧凑、步骤清晰，适合安装时边看边做。已有 262 人学习下载，作为作者整理的安装笔记，能有效帮助读者规避安装顺序、JDK 版本与依赖组件方面的常见问题。
1. ODI 12cR1安装：先把两个jar包的关系理清
提到ODI安装，很多人第一反应是解压、双击、下一步。实际上Oracle Data Integrator 12cR1（12.1.3.0.0）的安装最容易被卡住的地方不在ODI安装程序本身，而在它前面的依赖组件安装。JEE企业版必须先装Oracle Fusion Middleware Infrastructure，这个基础设施包提供Java Required Files等运行支撑，漏装或顺序不对，后面ODI Studio连代理服务都会失败。这篇安装笔记按实际部署流程来写：先做前置检查，再依次装Infrastructure和ODI本体，最后用Studio做一次真实连接验证。适合第一次装ODI的人照着走，也适合已经装过几次、但总在最后一步报错的人对照排查。
2. 安装前置检查：JDK版本、磁盘空间与JEE/独立选型的三个硬条件
在动手下载安装包之前，先把环境检查做完。ODI 12cR1安装程序本身是个Java应用，启动依赖JDK，所以这家软件对JDK的要求从第一步就影响整个安装过程。很多人都是把Infrastructure装到一半时才察觉JDK不对，只能全部卸载重来。
2.1 用命令行确认JDK版本：别信“装了就行”
ODI 12cR1要求JDK 1.7以上，实际部署里JDK 1.8更稳妥。这个要求看着简单，出错率却不低，原因是一台机器上往往同时装了多个JDK和JRE，而安装程序是从系统PATH里找Java的，跟你IDE里配置的JDK完全是两回事。
java -version先执行这条命令看看当前PATH指向的Java。输出里第一行是版本号，最后一行能看到64-Bit还是32-Bit。如果显示的版本低于1.7，或者输出里只有JRE字样，那就要先调整环境变量再继续安装。光有java -version还不够，建议顺手再看一个命令：
javac -versionjavac是JDK自带的编译器命令，如果提示“不是内部或外部命令”，说明PATH里的Java不是完整JDK。安装程序在初始化阶段需要完整的JDK环境，缺失javac时后续向导会在某个界面无故卡住或直接退出。
为避免PATH里混着多版本带来的干扰，我一般用完整路径直接调用目标JDK来启动安装程序：
C:\Java\jdk1.8.0_xxx\bin\java.exe -version把jdk1.8.0_xxx替换成机器上实际的JDK目录名。这一步确认版本和位数后，安装环境才算踏实。
2.2 JEE安装与独立安装的分岔口：先选型再下载
ODI 12cR1有两种安装形态：独立安装（Standalone）和JEE企业版安装。独立安装不需要Infrastructure，下载fmw_12.1.3.0.0_odi.jar直接装就能用；JEE安装则必须先装Oracle Fusion Middleware Infrastructure，ODI运行在WebLogic Server之上，具备集中代理、调度和高可用能力。
选择标准其实很直接：如果只是单机开发，自己写映射、自己调试，独立安装完全够用；如果要作为数据集成平台，让多个用户和外部系统连接，那就走JEE路线。项目文档里那句“Prerequisite for ODI Enterprise (JEE) installation only”说的就是这个区别。我看到过不少初学的开发者把两个jar包都下载了，按JEE模式装，实际上对独立安装来说多装一套Infrastructure不仅浪费，还会在后续配置阶段引入不必要的端口占用。建议先拿下面这个表做一个简单判断：
| 对比项 | 独立安装 | JEE安装 |
|---|---|---|
| 是否需要Infrastructure | 不需要 | 必须先装 |
| 运行容器 | 直接运行 | WebLogic Server |
| 代理与调度 | 单机代理 | 集中代理、集群调度 |
| 适合场景 | 开发调试 | 平台交付、多人协作 |
这个判断要在下载安装包之前完成，会省掉不少重复劳动。
2.3 磁盘、目录与管理员权限：三个容易翻车的细节
安装前的硬环境还有三个细节，看起来小，翻车率不低。第一是磁盘空间，ODI加Infrastructure装完要占好几个GB，解压目录加安装目录建议预留10GB以上。第二是路径，Oracle中间件的主目录对中文、空格和特殊符号很敏感，我习惯用C:\fmw12c这种纯英文、无空格的目录，不要放在带中文用户名的桌面路径下。第三是权限，Windows上安装过程要写系统目录、注册服务，别用普通用户双击启动，右键以管理员身份运行cmd是标准操作。
提示：Fusion Middleware安装日志默认写到安装目录下的cfg/logs或临时目录。看到报错先查日志，不要一上来就删掉重装。日志文件通常带时间戳，搜一下install关键字的日志文件即可。
2.4 压缩包校验：zip转jar这一步别疏忽
官网下载的是两个zip包，文件名分别是fmw_12.1.3.0.0_odi_Disk1_1of1.zip和fmw_12.1.3.0.0_infrastructure_Disk1_1of1.zip。不要被“Disk1_1of1”误导，这只是一个完整安装包，不是什么分卷压缩。解压后得到的对应是fmw_12.1.3.0.0_infrastructure.jar和fmw_12.1.3.0.0_odi.jar两个文件。
解压前建议先比对一下文件校验值。Windows下可以用certutil：
certutil -hashfile C:\downloads\fmw_12.1.3.0.0_odi_Disk1_1of1.zip MD5把输出值与下载页附带的校验值对比。这一步在ODI 12cR1这种时间比较久的安装包上尤为重要——下载工具拿到不完整文件时，解压不一定报错，但安装到一半会失败。解压完成后看一眼jar文件大小，正常是几百MB级别，不应该只有几KB。
3. 先装基础设施：fmw_12.1.3.0.0_infrastructure.jar 的图形安装过程
JEE模式的第一步是安装Oracle Fusion Middleware Infrastructure。这个组件提供的Java Required Files、WebLogic基础库是ODI运行时依赖的底层服务。最容易忽略的是先后顺序：必须Infrastructure在前，ODI在后。顺序反了，ODI安装时检测不到已有主目录，后面建域、连代理都会出问题。
3.1 解压结构与Oracle Home规划
把fmw_12.1.3.0.0_infrastructure_Disk1_1of1.zip解压，得到fmw_12.1.3.0.0_infrastructure.jar。我建议建一个专门的安装文件目录，比如C:\odi_install，把Infrastructure和ODI两个jar都放这里，避免四处找文件。安装目标目录用的是C:\fmw12c，名字可以自定义，但必须全英文、无空格。这个目录同时作为后续ODI的Oracle Home，取一个短名字后面频繁输入会省事很多。
这里有一个概念容易被忽略：Fusion Middleware 12c的安装模型是多个组件共享同一个Oracle Home目录。ODI、Infrastructure、WebLogic基础件最终都在C:\fmw12c下，而不是各自独立的安装目录。如果给ODI单独建一个新主目录，后续WebLogic域配置会找不到ODI模板，这是新手经常踩的坑。
3.2 用java -jar启动安装向导：命令参数说明
打开以管理员身份运行的cmd窗口，切换到安装文件目录，执行：
cd C:\odi_install C:\Java\jdk1.8.0_xxx\bin\java.exe -jar fmw_12.1.3.0.0_infrastructure.jar这里的关键是使用JDK完整路径调用java.exe，而不是直接输入java，目的就是避开PATH里可能混入的JRE或错误版本。-jar参数后面跟安装程序jar包的路径，如果路径含空格，要把整个路径前后加双引号。回车后安装程序加载图形界面，耗时从十几秒到几十秒不等。
如果是在没有图形桌面的远程服务器上装，可以采用静默方式。常见做法是准备一个response文件后执行：
C:\Java\jdk1.8.0_xxx\bin\java.exe -jar fmw_12.1.3.0.0_infrastructure.jar -silent -responseFile C:\odi_install\infrastructure.rsp-responseFile参数用来指定应答文件路径，应答文件里记录主目录、安装组件和JDK home等选项。第一次安装建议走图形界面，能看清每一步实际选了什么，静默模式适合熟悉参数后的批量交付。
3.3 安装向导里的关键选择：位置、组件与JDK home
图形向导进入后，第一步通常是欢迎页，直接下一步。第二步选择安装位置，默认值类似C:\Oracle\Middleware，改成前面规划的C:\fmw12c。第三步是组件清单，务必要确认勾选包含Fusion Middleware Infrastructure的完整项，以及Java Required Files子项。如果这里只选了独立工具集，装出来的目录会缺wlserver，后面ODI完全无法运行。
再往后是JDK检查。检查通过后要求指定Java主目录，这个输入框填JDK的根目录，也就是含bin、lib、jre的那一层，比如C:\Java\jdk1.8.0_xxx，不要填到bin层级。安装程序找不到默认JDK时，这一步会显示一个空框等待手动输入。填完后进入安装摘要页，此时能核对Oracle Home路径和组件列表，确认无误再点安装，之后等待进度条走完即可。
3.4 装完后的验证：看oracle_common和wlserver
进度条走完先别急着关窗口，等明确提示安装成功再退出。打开C:\fmw12c，正常情况下应看到oracle_common、wlserver、inventory等目录。其中wlserver是WebLogic Server的交付目录，它存在说明组件集选对了；缺少它基本可以判断安装类型选错，需要重装。
目录层面确认后，建议把cmd窗口里输出的日志路径复制出来存好。后续装ODI如果出现主目录识别问题，这份日志能看出Infrastructure实际装到了哪，尤其是本机存在多个中间件目录时，排查价值很大。
4. 再装ODI本体：fmw_12.1.3.0.0_odi.jar 与 odi64.exe 的首次握手
Infrastructure装好后，第二步装ODI。这一章的主要动作是启动ODI安装程序、复用已有主目录，然后处理第一次启动odi64.exe出现的JDK home提示。这是整个过程里大多数人第一次直接接触ODI可执行程序的地方。
4.1 ODI jar安装顺序与“使用现有主目录”
还是在管理员cmd窗口里，用完整JDK路径启动ODI安装程序：
cd C:\odi_install C:\Java\jdk1.8.0_xxx\bin\java.exe -jar fmw_12.1.3.0.0_odi.jarODI安装向导启动后先做环境检查，读取机器上已安装的Fusion Middleware组件。如果检测到C:\fmw12c下已有Infrastructure的Oracle Home，安装位置步骤会显示这个已有主目录，此时选择“使用现有主目录”，让ODI组件写进同一个目录。不要另建新主目录，分离的两个目录会导致后续config.cmd建域时找不到ODI模板，代理也无法部署。
如果环境检查检测不到已有主目录，同时又弹出JDK home输入框，多半是前一章的安装出了问题，先别急着重装，检查C:\fmw12c目录是否存在oracle_common，再查第3章留存的那份安装日志。
4.2 双击odi64.exe：第一次指定JDK home的细节
安装完成后，进入C:\fmw12c\odi目录能看到odi64.exe。第一次双击它时，程序会弹出一个对话框，要求指定JDK home路径。弹出的原因很直接：odi64.exe不读取系统PATH，也不理会JAVA_HOME，它按自己内置的常用路径去找JDK，找不到就让用户手动填。
填写时注意两点。第一，填的是JDK的根目录，也就是bin和lib的上一级目录，例如C:\Java\jdk1.8.0_xxx；填到bin目录层级，确认后大概率直接闪退。第二，确认JDK是64位，odi64.exe是64位程序，用32位JDK在后面加载ODI基础库时会不兼容。填对后界面会短暂消失，然后重新出现启动画面；如果一闪而过，按第5章的坑2对照排查。
4.3 安装目录结构：odi、bin与studio
ODI本体安装完成后，C:\fmw12c下会出现odi目录。日常最常用到的入口有：
odi\bin\odi64.exe，客户端主程序入口；odi\bin\odi32.exe，32位版本，老机器才用；odi\studio\，Studio目录，图形设计器在这里。
另外，odi目录下还有agent、sdk等子目录，代理服务的运行文件在agent相关目录里。如果安装时没有复用已有主目录，安装日志中会显示“目标目录不为空”或“组件冲突”之类的记录，此时C:\fmw12c\odi里文件不完整，常见的是只有安装记录而没有实际的bin文件夹。这种状态都建议卸载重来，不要试图修补。
4.4 启动Studio前的环境准备：代理与域
ODI Studio要连上代理服务，前提是JEE模式下的WebLogic域已经建好。域的创建不是ODI安装向导自动完成的，而是由Fusion Middleware配置向导单独处理，常见位置是C:\fmw12c\oracle_common\common\bin下的config.cmd。运行后选择域模板时要把ODI相关模板勾上，再设置一个WebLogic管理员账号。
这个步骤很容易在安装完成当天被漏掉。我一般会把“运行config.cmd并建域”写进安装当天的任务清单，因为ODI安装结束后间隔时间一长，就容易忘记这个关联动作，导致Studio开了半天发现代理起不来。
5. 避坑记录：ODI 12cR1安装里最多人问的五个问题
这里记录的是实际部署里出现频率最高、也最容易被当成玄学处理的五个报错。每条按现象、原因、解决三个层面说清楚，排查时不至于盲目重装。
5.1 启动阶段的坑：java -jar没响应与JDK误报
坑1：java -jar执行后没有反应。
现象：cmd窗口里执行安装jar，回车后什么都没有，光标直接回到提示符。原因基本都是PATH里的Java指向了JRE或过低版本，安装程序初始化时直接退出。解决方法是加内存参数并观察输出：
C:\Java\jdk1.8.0_xxx\bin\java.exe -Xms256m -Xmx1024m -jar fmw_12.1.3.0.0_infrastructure.jar-Xms指定JVM初始堆大小，-Xmx指定最大堆大小。安装包加载阶段如果堆内存太小，图形界面会在初始化时静默退出。加了参数后如果cmd里有明确报错，就按报错内容定位，而不是继续双击jar。
坑2：填写JDK home后立即闪退。
现象：odi64.exe弹窗填完JDK路径，点确定后程序一闪就关了。原因大多是路径填到了bin层级，或者JDK位数不对。解决：重新右键odi64.exe选择以管理员身份运行，填入JDK根目录路径；如果仍然闪退，去JDK安装目录下确认bin\java.exe存在，并检查位数是否为64位。
5.2 连接阶段的坑：Studio连不上与代理不启动
坑3：Studio的代理服务始终不可用。
现象：ODI Studio的拓扑里创建物理代理时，测试状态一直失败。原因通常是Windows防火墙拦截了WebLogic与Agent的端口。JEE模式中WebLogic管理服务默认监听7001端口，Agent调用则常涉及20910端口。解决：在防火墙高级设置中添加入站规则放行这两个端口，放行时限定网段范围，不要对公网放开。改完端口后重启ODI代理服务再测试。
坑4：Studio启动正常，但拓扑里看不到默认连接。
现象：登录Studio后左边树里空空如也，没有带出的默认连接。原因大多是元数据仓储还没有初始化，会出现看不到连接项的情况。解决：先确认是否用ODI仓库创建工具（RCU，Repository Creation Utility）创建了主仓库和工作仓库，并将其登记到对应数据库中。这一步虽然不是ODI安装向导的界面，但初次接触的人最容易在这里断掉。
5.3 部署阶段的坑：忘建域与安装目录污染
坑5：建域时找不到ODI相关模板。
现象：运行config.cmd配置域时，模板列表里没有ODI选项。原因基本都是ODI安装时没有复用Infrastructure的已有Oracle Home，两组件的目录没有对齐。解决：退出配置向导，确认C:\fmw12c\odi下库文件齐全，然后回到ODI安装向导，重新安装一次并选择使用现有主目录。不要试图手工往wlserver里复制模板。
除这五个坑之外，还有两个预防性习惯：一是安装路径和账号不要用中文，这是血泪经验的来源之一；二是重装前把C:\fmw12c整个目录删干净再动手，Oracle中间件对脏目录的容忍度很低，这一点我自己吃过亏。
6. ODI Studio首次连接：把安装成果验证一遍
装好ODI后，别急着认为事情已经结束。安装流程走完并不等于环境可用，真正可信的标志是Studio跑通一条最简单的映射。我自己养成了习惯：任何一次ODI环境交付，最后都强制走一遍Studio连接验证。这套流程顺利的话十来分钟，能避免后续反复排查连接问题。
先启动odi64.exe，按4.2的方式填好JDK home。进入Studio后选择工作区目录，默认会创建在用户目录下，建议改到项目目录。登录界面用建域时设置的管理员账号和密码，连接模式选择本地仓库还是远程仓库由架构决定。接着在拓扑里新建一个Oracle数据源，填好JDBC连接串或监听地址，点测试连接返回成功，表示ODI到数据库的链路通畅。然后看代理节点，对应Agent服务在Windows服务列表里应是“正在运行”状态；如果显示失败，按5.2的方向处理。
再用一条最基础的查询和插入做验证：
SELECT * FROM SRC_TABLE; INSERT INTO TARGET_TABLE SELECT * FROM SRC_TABLE;这两句属于最基础的判定手段。真实ODI场景里不会直接敲这些SQL，而是用接口映射里的知识模块生成类似语句再交给Oracle执行。跑通过后，日志里有执行统计，能确认映射、KM引擎、代理、目标库这条链路都是活的。ODI安装到底成不成，到这一步才算有定论。
最后说一下我在这件事上的习惯。第一次做ODI环境时，我把“安装完成”当成了“安装成功”，跳过了建域和Studio连接验证，结果之后的几天都在为连不上代理翻日志，最后发现只是4.4章节的步骤漏了。从那以后，每次做完ODI环境我都强制走一遍：建域、测试连接、跑通一条最简映射，三步做完才放心。希望这篇ODI 12cR1安装笔记能帮到你，尤其是第一次跨过重装门槛的同学。
本文还有配套的精品资源，点击获取
