简介面向数据集成工程师与中间件运维人员的ODI 12cR1安装实操文档聚焦Oracle Data Integrator 12.1.3.0.0在JEE企业模式下的部署路径。内容从安装包获取与前置条件入手讲清先装Oracle Fusion Middleware Infrastructure、再装ODI的先后顺序并记录借助JDK执行jar启动图形向导、指定JDK主目录、选择安装位置与类型等关键界面对安装顺序、JDK版本要求、数据库连接与用户权限、中间件服务器配置等均有涉及同时延伸到ODI Studio连接实例、创建Operator与拓扑、设计接口映射及配置知识模块等后续环节可帮助读者建立对ODI部署链路的整体认识。压缩包共1个docx文件约2.23MB以图文步骤记录为主按安装阶段组织内容便于对照操作与检索。该文档已有265人学习适合需要按部就班完成安装、减少试错的中初级读者也可作为部署与配置阶段的排错参照。1. 装 ODI 12cR1最容易踩的不是技术是安装顺序有个做数据迁移的同行下载了fmw_12.1.3.0.0_odi_Disk1_1of1.zip解压、java -jar、一路下一步向导没报任何错。装完打开 ODI Studio 想连资料库却发现根本连不上日志里也没说明真正原因。折腾到第二天他才弄明白企业级安装里ODI 只是中间件上的一个组件前面必须先把 Oracle Fusion Middleware Infrastructure 12.1.3.0.0 装好不然装出来的东西缺基础服务看起来装完了实际用不了。ODI 12cR1 这套环境在企业数据集成场景里非常常见装它的人多半是要做数据迁移、转换、加载。这篇安装笔记按「环境清单 → 先装基础设施 → 再装 ODI 本体 → 建资料库和域 → 踩坑排查 → 装完验证」的顺序把 ODI 12.1.3.0.0 的安装过程拆成能照着执行的步骤新手能走通熟手能对上版本和参数。2. 装前清单ODI 12.1.3.0.0 到底要准备什么动手前先确认三件事JDK 用哪个、走企业安装还是独立安装、哪几个文件必须下载。这三件事想错一个后面几个小时基本白装。我见过最常见的浪费时间方式是 JDK 版本随手用了系统里现成的装到一半报版本不符再回头卸、换 JDK、重装。2.1 JDK 1.7 是硬要求但别直接拿系统里那个 java 凑合ODI 12cR112.1.3.0.0安装器本身是 jar 包要靠java -jar启动ODI 运行环境又要求 JDK 1.7 以上。这两条结合起来意味着你需要一个明确的、路径固定的 JDK而不是命令行里java碰巧指向哪个就用哪个。我一般会单独装一个 JDK 1.81.7 也能跑但 1.8 在中间件 12.1.3 上更稳放在不带空格、不带中文的目录比如D:\Java\jdk1.8.0_202。装完先验证一遍别信安装器的默认值:: 先看命令行里真正生效的是哪个 java很多机器这里指向的是 Oracle 自带的 jre where java java -version :: 把 JAVA_HOME 临时指到刚装的 JDK只对当前 cmd 窗口生效安全 set JAVA_HOMED:\Java\jdk1.8.0_202 set PATH%JAVA_HOME%\bin;%PATH% :: 再验一次确认输出的版本号和你装的一致 java -versionset只在当前窗口有效关掉就还原。这样做的好处是验证阶段不会污染系统环境变量装坏了也不影响机器上其他依赖 java 的程序。确认没问题后再决定要不要写进系统环境变量。路径里不要出现空格和中文——这是常见做法安装器大部分时候能扛住但 odi64.exe 这类小工具对路径敏感一旦翻车排查成本很高。2.2 企业安装和独立安装走错路线后面全白费原文里那句括号说明是关键企业安装之前必须安装 Oracle Fusion Middleware Infrastructure独立安装则不需要。这不是可选项而是两条完全不同的安装路径。对比项企业安装JEE独立安装Standalone是否要先装 Infrastructure必须先装fmw_12.1.3.0.0_infrastructure.jar不需要是否需要 WebLogic 域需要靠配置向导建域不需要是否需要 RCU 建资料库需要需要但可以简化适合场景多环境、Agent 分布式部署、有监控需求单机开发、学习验证、快速跑通装错后的代价缺基础服务Studio 连不上资料库想上生产要整体重来判断标准其实简单如果你的目标是「在本机把 ODI 跑起来、做几个接口验证思路」独立安装够用如果后面要接 Agent、要做调度、要让别人连你的环境那就必须走企业安装。这篇文章按企业安装这条完整路径写因为踩坑最集中的就是这条路。2.3 下载与解压两个 zip 对应两个 jar需要下载的文件就两个解压后各得到一个 jar安装包zip解压后得到作用fmw_12.1.3.0.0_infrastructure_Disk1_1of1.zipfmw_12.1.3.0.0_infrastructure.jar中间件基础设施先装fmw_12.1.3.0.0_odi_Disk1_1of1.zipfmw_12.1.3.0.0_odi.jarODI 本体后装从官方下载页按文件名找就行两个包版本号必须对齐——都是 12.1.3.0.0。我碰到过一次基础设施是 12.1.3ODI 包拿成了别的版本安装器不报错装完建域时组件列表里根本找不到 ODI。版本号对不上就是这种不报错、装完没东西的毛病。解压的时候注意两点解压到一个独立目录比如D:\install\odi1213\别直接解压到桌面再挪解压后检查 jar 大小如果只有几十 KB那是下载被截断重新下。磁盘上至少留出 15 GB 空闲中间件加 ODI 加域加资料库装完就是这个量级。3. 先装基础设施Fusion Middleware Infrastructure 12.1.3.0.0 落地步骤这一章的流程是用指定的 JDK 启动 Infrastructure 安装器 → 选 Oracle Home 和安装类型 → 过前置检查 → 装完检查目录。每一步都有容易忽略的地方尤其是第一步和第二步。3.1 用哪个 java 启动安装器决定了后面会不会白装原文写得很直白进入 JDK 的 bin 目录运行java –jar 路径\fmw_12.1.3.0.0_infrastructure.jar。这个「进入 bin 目录」不是多余动作它的本质是确保用的是这个 JDK而不是 PATH 里别的 java。:: 进到 JDK 的 bin 目录再执行保证用的是这个 JDK cd /d D:\Java\jdk1.8.0_202\bin :: 启动 Infrastructure 安装器jar 路径写绝对路径别用相对路径 java -jar D:\install\odi1213\fmw_12.1.3.0.0_infrastructure.jar逻辑说明cd /d里的/d是允许跨盘符切换不加的话从 C 盘切到 D 盘会失败很多人卡在这儿以为命令写错了。java -jar后面跟绝对路径是为了避免「当前目录下找不到 jar」这种低级但高频的问题。等价写法是%JAVA_HOME%\bin\java -jar D:\install\odi1213\fmw_12.1.3.0.0_infrastructure.jar效果一样好处是不用切目录。两种都行选一种固定下来别每次换。启动后会弹出图形化安装向导。如果双击 jar 没反应、或者弹窗一闪就没了说明系统把.jar关联到了别的程序这时候只能走命令行别在文件关联上浪费时间。3.2 Oracle Home 和安装类型路径定下来就别改向导里真正需要你决策的只有两页安装位置和安装类型。安装位置就是 Oracle Home。我的习惯是固定成D:\Oracle\Middleware\Oracle_Home原因是后面 ODI 安装、RCU、建域、启动脚本全都要引用这个路径路径一旦带空格或者层级太深写脚本时引号漏一个就出问题。安装类型选「典型安装」就够了。典型会带上 WebLogic Server、Coherence、OMS 等一套组件精简会少装东西后面建域时想加组件还得回来补。这一页没有技术含量但选错了补装很烦。其余页面基本是一路下一步欢迎页 → 自动更新跳过内网环境连不上更新服务器勾了只会卡住→ 前置条件检查 → 安装摘要 → 安装进度 → 完成。提示自动更新那一页一定要取消勾选。默认勾选状态下安装器会尝试连外网检查补丁内网机器上这一步能卡十几分钟然后超时看起来像死机。3.3 前置检查没过先看这三处前置条件检查报红是最常见的中断点。Windows 上无非三处第一处是临时目录空间。安装器要往%TEMP%解压一堆东西C 盘剩余空间不足 5 GB 时经常在这一步失败。做法是把 TEMP 临时指到大盘:: 把当前窗口的临时目录指到空间充足的盘避免安装器解压失败 set TEMPD:\temp set TMPD:\temp mkdir D:\temp第二处是杀毒软件。装中间件会往系统目录写服务、注册组件某些安全软件会拦。这一步我是直接临时关掉实时防护装完再开——比一条条加白名单省事。第三处是操作系统版本和字体。Windows Server 上如果缺中文字体向导界面会显示成方框但功能正常靠记住按钮位置也能装完。这不是必须解决的问题知道就行。3.4 装完先验证目录别急着开第二个 jarInfrastructure 装完向导会问要不要启动快速入门Quick Start。这时候直接取消先做目录验证。:: 检查 Oracle Home 下是否出现了这些关键目录 dir D:\Oracle\Middleware\Oracle_Home :: 重点确认三个目录存在oracle_common、wlserver、oui dir D:\Oracle\Middleware\Oracle_Home\oracle_common dir D:\Oracle\Middleware\Oracle_Home\wlserveroracle_common是公共组件wlserver是 WebLogic 主体oui是安装器自己的记录目录。三个都在说明 Infrastructure 这一层是完整的。如果只有oui一个那就是安装中断过或者装到了别的路径——去D:\Oracle\Middleware\下翻一遍别在错误路径上继续装 ODI。这一步的意义在于把问题挡在门前。Infrastructure 没装完整ODI 安装器照样能启动、照样能装完只是装出来的东西是残的后面建域才会暴露。早检查一次省下两小时。4. 再装 ODI 本体fmw_12.1.3.0.0_odi.jar 的安装与 JDK Home 指定基础设施就位之后ODI 这一层相对顺。但有两个地方必须说清楚Oracle Home 该选哪儿以及 odi64.exe 第一次启动要的 JDK Home 到底填什么。4.1 第二个 jar 的安装位置要和第一个对上启动方式和上一次完全一样还是进 JDK 的 bin 目录cd /d D:\Java\jdk1.8.0_202\bin :: 启动 ODI 12.1.3.0.0 安装器 java -jar D:\install\odi1213\fmw_12.1.3.0.0_odi.jar关键的差异在「安装位置」这一页。企业安装下ODI 要装进刚才那个 Oracle Home而不是新建一个。常见做法是安装器检测到已有 Oracle Home会把它列出来你直接选中D:\Oracle\Middleware\Oracle_Home继续往下走。装的过程中安装器会把 ODI 作为组件叠加进去完成后这个 home 下会多出odi目录。如果安装器让你新建 home说明它没识别到已有的基础设施——这时候不要硬装退回去检查上一步的 Oracle Home 路径是不是写错了、或者 Infrastructure 装到了别的目录。硬装的结果是机器上出现两个互不认识的 home建域时组件列表里找不到 ODI Agent。装完检查一下:: 确认 odi 目录已出现在 Oracle Home 下 dir D:\Oracle\Middleware\Oracle_Home\odi :: 确认 Studio 目录存在这是后面验证要用的 dir D:\Oracle\Middleware\Oracle_Home\odi\studio\binodi\studio\bin下有odi.exe就说明 ODI 本体装到位了。4.2 odi64.exe 首次启动要的 JDK Home不是 bin 也不是 jreODI 安装完成后第一次双击odi64.exe会弹窗让你指定 JDK home 路径。这一步很多人填错填成...\bin或者 JDK 里面的jre目录然后程序启动闪退。正确做法是填 JDK 的根目录填法结果D:\Java\jdk1.8.0_202正确根目录D:\Java\jdk1.8.0_202\bin错误程序找不到 jvmD:\Java\jdk1.8.0_202\jre错误缺开发工具链D:\Java\jdk1.8.0_202\jre\bin错误同上判断标准很简单这个路径下面应该同时有bin、jre、lib三个目录。看一眼就知道填得对不对。弹窗里的路径填一次就行程序会记下来。如果后面换了 JDK 目录这个配置不会自动更新得手动改回来——这也是为什么我建议 JDK 装在固定路径、装完之后别动。4.3 RCU 建资料库和配置向导建域顺序不能倒到这一步软件装完了但还不能用。ODI 需要一个资料库Repository存元数据需要一个域Domain跑服务。这两件事的顺序是先用 RCU 建资料库再用配置向导建域。:: 启动 RCU创建资料库 schema D:\Oracle\Middleware\Oracle_Home\oracle_common\bin\rcu.batRCU 向导里需要勾选的组件常见做法是Common Infrastructure Services这个必勾存的是公共配置 Oracle Data Integrator。数据库连接填你准备好的库schema 前缀用一个短标识比如DEV建完会得到类似DEV_STB、DEV_ODI_REPO这样的 schema。密码规则要注意中间件这套对特殊字符开头有要求别用纯数字或者数字开头的密码。:: 启动配置向导创建 WebLogic 域 D:\Oracle\Middleware\Oracle_Home\oracle_common\common\bin\config.cmd配置向导里选「创建新域」模板勾选 ODI 相关的几个Agent、Console、Studio 配套服务然后一路填域名、域路径、管理账号密码、Node Manager 端口、RCU 连接信息。域路径我一般放D:\Oracle\Middleware\Oracle_Home\user_projects\domains\base_domain。建域过程中会问你 RCU 的 schema 密码就是刚才建的那套。这一步对不上就前功尽弃所以 RCU 那一步的密码要记下来。域建完两个启动脚本就位:: 启动管理服务器第一次启动会比较慢等日志里出现 RUNNING 再操作 D:\Oracle\Middleware\Oracle_Home\user_projects\domains\base_domain\bin\startWebLogic.cmd :: 另开一个窗口启动 Node ManagerAgent 要靠它拉起来 D:\Oracle\Middleware\Oracle_Home\user_projects\domains\base_domain\bin\startNodeManager.cmd到这里服务这层就齐了。Studio 的启动入口是D:\Oracle\Middleware\Oracle_Home\odi\studio\bin\odi.exe。5. 避坑与排查ODI 12cR1 安装里五个最常见的翻车点这一章的五条全是「现象 → 原因 → 解决」的实录。装 ODI 的坑大多不是玄学是有明确因果的只是报错信息不给提示得靠经验反推。5.1 双击 jar 没反应或者窗口一闪就没了现象双击fmw_12.1.3.0.0_infrastructure.jar要么完全没动静要么黑窗口闪一下就关闭看不到任何错误。原因Windows 把.jar关联给了别的解压软件比如某些压缩工具会抢占这个关联双击打开的是解压器而不是 java。或者关联到了老的javaw.exe图形界面起不来也不报错。解决不要双击。老老实实开 cmd进 JDK 的 bin 目录执行java -jar 绝对路径。命令行里报错信息会直接打在窗口上能看清是版本问题还是 jar 损坏。这条我吃过一次亏之后就成了固定动作——安装类 jar 一律命令行启动。5.2 装 ODI 时报 JDK 版本不满足现象ODI 安装器启动到一半弹出提示说需要 JDK 1.7 或更高版本但机器上明明装了 1.8。原因安装器读的是JAVA_HOME环境变量或者它自己探测到的那个 java跟你命令行里用的不是同一个。系统里可能同时存在多个 JDK还有中间件自带的 jre。解决在启动安装器的同一个 cmd 窗口里先set JAVA_HOMED:\Java\jdk1.8.0_202再set PATH%JAVA_HOME%\bin;%PATH%然后java -version确认版本最后才启动安装器。关键是这三个命令要在同一个窗口里连着执行窗口一关环境就还原了。5.3 odi64.exe 指定 JDK Home 后启动闪退现象弹窗里指定了 JDK 路径点确定程序起不来或者下次启动又要重新指定。原因路径填成了bin或jre子目录程序找不到完整的 JDK 结构或者 JDK 装在带中文、带空格的路径下解析失败。解决路径填 JDK 根目录且根目录下必须同时有bin、jre、lib。路径全部用英文不要有空格。如果已经填错了导致配置被记住去用户目录下找 ODI 的配置文件改回来或者换一个干净的 JDK 目录重新指定。5.4 建域时组件列表里找不到 ODI现象跑config.cmd建域模板列表里只有 WebLogic 和基础服务ODI 相关的模板一个都没有。原因ODI 装到了另一个 Oracle Home和 Infrastructure 不是同一个。安装器当时没识别出已有 home你也没注意就新建了一个结果两个 home 互不认识。解决回到D:\Oracle\Middleware\下看有几个目录找出真正带odi子目录的那个。如果确认是装错位置卸载重装 ODI 部分——只重装 ODI 那个 jarInfrastructure 不用动安装时手动把路径指到已有 home。重装前先把错的目录清掉避免安装器又识别错。5.5 RCU 建库失败报密码或表空间错误现象RCU 跑到创建 schema 那一步报错提示密码不符合策略或者表空间不足。原因中间件这套对密码有策略要求纯数字、太短、以数字开头的密码会被拒。表空间不足则是数据库那边默认的临时表空间或用户表空间配额不够。解决密码用「大小写字母 数字 特殊字符」的组合别以数字开头长度 8 位以上。表空间问题找 DBA 确认USERS和TEMP的可用空间ODI 资料库不算大留 2 GB 以上比较稳妥。RCU 失败后不要直接重跑先把建了一半的 schema 删干净否则第二次会因为对象已存在继续报错。6. 装完怎么验证从 Studio 登录到跑通第一个映射软件装完、域建好剩下的问题是怎么确认这套环境真的能用而不是「看起来装完了」。我的验证顺序是固定的四步从底层往上层走哪一步断了就停在哪一步查。步骤检查动作通过标准1看管理服务器日志出现RUNNING状态无 SEVERE 报错2浏览器打开控制台用建域时的账号能登进管理控制台3启动 ODI Studio能进主界面不闪退4Studio 里连资料库测试连接成功能看到工作资料库第 4 步是真正的验收点具体做法Studio 里新建一个资料库连接填主机、端口、资料库 schema 的用户名密码就是 RCU 建的那套DEV_ODI_REPO点测试连接。连上了说明 RCU、域、监听三者的配置是对齐的连不上问题多半在监听端口或 schema 密码上去管理控制台看数据源配置。再往上一层是跑通第一个映射。建一个最简单的接口源和目的人都指向同一张测试表字段一一对应执行一次。能在「执行」页看到会话状态变成「完成」才算这套环境真跑起来了。这一步不做等到真接业务数据时才发现知识模块没配、Agent 没连上排查范围会大得多。注意第一次启动管理服务器可能要三到五分钟日志滚动很慢别以为卡死了就强杀进程。强杀一次域里的临时文件可能损坏下次启动直接失败恢复起来比重装还麻烦。从那以后我每次装完 ODI不管多赶时间都强制走一遍这四步尤其是第四步的 Studio 连接测试。装完不验证等于给自己留了个黑匣子——真出问题时你分不清是装错了、配错了还是用错了。希望帮到你。本文还有配套的精品资源点击获取