深入理解Oracle universal installer(oui)

www.oracledatabase12g.com 刘相兵 (Maclean Liu) [email_address] 深入理解 Oracle Universal Installer (OUI)

www.oracledatabase12g.com www.oracledatabase12g.com www.oracledatabase12g.com www.oracledatabase12g.com www.oracledatabase12g.com www.oracledatabase12g.com OUI 是什么？基于 Java 的图形用户界面 (GUI) 应用程序会从 products.xml 文件中读取组件信息并安装套件 OUI 提供了统一的用户安装界面使用 OUI 的先题条件 : 使用 OUI 需要用到 Java 运行时环境即 Java Runtime Environment (JRE), 在绝大多数平台上该 JRE 会由 OUI 自动安装 ( 少数如 itanium Linux 平台需要另外安装 ) 内存需求：基于不同平台及所安装的 Oracle 产品而不同，在绝大多数情况下至少需要 32MB 以上的空闲内存磁盘空间需求：在 Windows 上至少需要 60MB 空间而在 Unix 平台上则为 70MB 才能启动 OUI ，此外库信息文件 (inventory files) 大约占用 1MB 空间

www.oracledatabase12g.com www.oracledatabase12g.com www.oracledatabase12g.com www.oracledatabase12g.com www.oracledatabase12g.com www.oracledatabase12g.com OUI 能做什么？其核心功能无疑是安装各类 Oracle 产品或组件反安装组建或产品维护基于 XML 的产品信息仓库 (inventory) 为安装执行必要的安装前检查当需要时额外调用配置助手（如 Netca,DBCA,DBUA 等）从 oracle 11g 开始， OCM 也就是 Oracle Configuration Manager 也同样被综合到 OUI 的框架中信息库操作，包括附件节点列表

www.oracledatabase12g.com www.oracledatabase12g.com www.oracledatabase12g.com www.oracledatabase12g.com www.oracledatabase12g.com www.oracledatabase12g.com 启动阶段开始对用户可见，载入必要的文件并显示一个欢迎界面安装阶段用户选择安装或反安装某些产品；提供源和目标目录选择阶段需要安装的产品被勾选，可用磁盘空间及必要磁盘空间被显示，并会出现 summary 总结页面安装进度阶段实际安装过程中，显示安装进度条安装完成阶段要求用户运行 root.sh 脚本，并启动某种配置助理工具 (configuration assistants) OUI 具有那些阶段？

www.oracledatabase12g.com www.oracledatabase12g.com www.oracledatabase12g.com www.oracledatabase12g.com www.oracledatabase12g.com www.oracledatabase12g.com 互动模式用户使用图形界面访问各安装流程在对话框中并提供必要的安装信息，当提示时。在小范围安装中最为合适静默安装省略图形界面，由相应文件 (response file) 提供必要的信息。在安装过程中自动化实现，在众多服务器时。如 setup.exe -slient -responseFile <Path_to_ResponseFile) 安装模式

www.oracledatabase12g.com www.oracledatabase12g.com www.oracledatabase12g.com www.oracledatabase12g.com www.oracledatabase12g.com www.oracledatabase12g.com OUI 的初始化文件位于安装介质下的” install” 子目录中文档 How to Interpret the oraparam.ini File [ID 237097.1] 介绍了解释了 oraparam.ini 文件的内容 Oraparam.ini 的一些重要参数 SOURCE=Location of the products.jar file. This location is relative to the directory where oraparam.ini exists. JRE_LOCATION=Relative location of the Java Runtime Environment (JRE) which will be used by the Oracle Universal Installer JRE_MEMORY_OPTIONS=Set these variables to influence the behaviour of JRE.ie. max heap size for java (-mx), startup size of java heap (-ms), disabling JIT (-nojit). You should increase the -mx and -ms values if you're getting out of memory errors. Oraparam.ini

www.oracledatabase12g.com www.oracledatabase12g.com www.oracledatabase12g.com www.oracledatabase12g.com www.oracledatabase12g.com www.oracledatabase12g.com 在 windows 上 : <Disk>\setup.exe 安装后 %ORACLE_HOME%\oui\bin\setup.exe 在 unix 上 Cd <Disk1> ./runInstaller 安装后 Cd $ORACLE_HOME/oui/bin ./runInstaller 如何启动 OUI 互动模式 ?

www.oracledatabase12g.com www.oracledatabase12g.com www.oracledatabase12g.com www.oracledatabase12g.com www.oracledatabase12g.com www.oracledatabase12g.com 在 windows 上：记录相关的相应文件： Setup.exe -record -responseFile <ResponseFilename> 以静默模式安装 Setup.exe -slient -responseFile <ResponseFilename> 在 UNIX 上：记录相关的响应文件： ./runInstaller -record -responseFile <ResponseFilename> 在静默模式下安装 ./runInstaller -slient -responseFile <ResponseFileName> 参考 OUI Guide:Oracle Universal Installer command line options and arguments Note 782918.1 如何启动 OUI 静默模式？

www.oracledatabase12g.com www.oracledatabase12g.com www.oracledatabase12g.com www.oracledatabase12g.com www.oracledatabase12g.com www.oracledatabase12g.com 每次 OUI 启动都会产生日志，日志名会以时间戳的形式归档这些日志包含了安装过程中丰富的信息。我们推荐在安装完成后复验一遍日志一般来说这些日志存放在中心信息库中 (inventory) ，在 logs 子目录下的并以如下形式命名 : installActions<year-mm-dd_hh-mi-ss><AM|PM>.log oraInstall<year-mm-dd_hh-mi-ss><AM|PM>.err oraInstall<year-mm-dd_hh-mi-ss><AM|PM>.out 中心信息库的位置可以通过库指针文件了解到库指针文件的默认位置：在 windows 上：注册表中的” HKLM\Software\oracle\inst_loc” 在 unix 上：例如 Solaris 平台 :/var/opt/oracle/oraInst.loc 其他平台如 Linux:/etc/oraInst.loc OUI 日志存放在哪里？

www.oracledatabase12g.com www.oracledatabase12g.com www.oracledatabase12g.com www.oracledatabase12g.com www.oracledatabase12g.com www.oracledatabase12g.com 使用 OUI 启动 OUI 并尝试点击” Installed Products” 也可以使用 Opatch 工具 Opatch lsinventory -detail 如何确认已安装的产品

www.oracledatabase12g.com www.oracledatabase12g.com www.oracledatabase12g.com www.oracledatabase12g.com www.oracledatabase12g.com www.oracledatabase12g.com OUI 工具存在” -debug” 选项将启用最精细级别的信息日志将显示启动阶段的信息（例如抽取 JRE) 在对 OUI 进行可能由 java 引起的问题诊断时十分有效距离来说 : ./runInstaller -debug 另一方面可以对 OUI 启用系统调用跟踪 trace, 一般我们使用操作系统提供的 tracing 工具举例而言 :truss -aefo /tmp/oui_trace.log ./runInstaller 参考文档： Note 110888.1 介绍了如何 trace Unix 下的系统调用绝大多数 OUI 意外终止的问题可以从 .ERR 文件中找到相关问题 OUI: "Abnormal program termination" with java.io.IOException in .err file [ID 798338.1] 如何启用 OUI 的 debug 和 trace 功能？

www.oracledatabase12g.com www.oracledatabase12g.com www.oracledatabase12g.com www.oracledatabase12g.com www.oracledatabase12g.com www.oracledatabase12g.com Oracle Inventory 的层次信息库指针文件 :oraInst.loc <InventoryLoc>/ContentsXML/inventory.xml <InventoryLoc>/ContentsXML/comps.xml 得到集中信息库位置得到独立产品信息 <OH>/inventory/ContentsXML/comps.xml <OH>/inventory/ContentsXML/oraclehomeproperties.xml 得到各 Oracle Home 位置针对独立的 Oracle Home 获取组件信息获取平台和 GUID 等信息

www.oracledatabase12g.com www.oracledatabase12g.com www.oracledatabase12g.com www.oracledatabase12g.com www.oracledatabase12g.com www.oracledatabase12g.com 默认的信息库指针：在给定平台上的某个标准位置存放着该指针文件，该文件包含了中心信息库的位置。 /etc/oraInst.loc (Linux 上 ) /var/opt/oracle/oraInst.loc(Solaris 上 ) \\HKEY_LOCAL_MACHINE\\Software\Oracle\inst_loc(Windows 上 ) 示例内容 inventory_loc=/u01/oraInventory inst_group=maclean 信息库指针文件

www.oracledatabase12g.com www.oracledatabase12g.com www.oracledatabase12g.com www.oracledatabase12g.com www.oracledatabase12g.com www.oracledatabase12g.com 集中信息库：该信息库以目录形式存在，包含了该主机上安装的所有 Oracle 产品的信息举例来说在 Unix 上 :/u01/oraInventory 而在 Windows 平台上 : C:\Program Files\Oracle\Inventory 信息库文件：已注册的 ORACLE_HOME 的列表 <inventory_location>/ContentsXML/inventory.xml 示例内容： <INVENTORY> <VERSION_INFO> <SAVED_WITH>10.2.0.1.0</SAVED_WITH> <MINIMUM_VER>2.1.0.6.0</MINIMUM_VER> </VERSION_INFO> <HOME_LIST> <HOME NAME="OraDb10g_home1" LOC="/u01/oracle/product/10.2.0/db_1" TYPE="O" IDX="1"/> </HOME_LIST> </INVENTORY> 集中信息库 (Central Inventory)

www.oracledatabase12g.com www.oracledatabase12g.com www.oracledatabase12g.com www.oracledatabase12g.com www.oracledatabase12g.com www.oracledatabase12g.com 本地信息库：目录结构包含了 ORACLE_HOME 中 Oracle 软件的细节信息 $ORACLE_HOME/inventory 组件文件：各组件信息及其关联性，补丁集和 One-off patch 以及其所修复的 bug ， $ORACLE_HOME/inventory/ ContentsXML/comps.xml ORACLE_HOME 属性文件：关于 HOME 的 GUID ， ARU Id 和 Cluster_nodes 等信息： $ORACLE_HOME/inventory/ oraclehomeproperties.xml 本地信息库指针：指向自身注册的中心信息库（ 10Gr2 以后才出现 ) ORACLE_HOME/oraInst.loc 本地信息库 (local Inventory)

www.oracledatabase12g.com www.oracledatabase12g.com www.oracledatabase12g.com www.oracledatabase12g.com www.oracledatabase12g.com www.oracledatabase12g.com 前提是本地信息库没有被损坏或丢失使用 runInstaller 的 '-attachHome' 选项仅在 10gr1 以后可能在 10.1.0.3 以后， OUI 会重建指定位置的 oraInst.loc 集中信息库，即便 oraInventory 目录不存在命令语法 $ORACLE_HOME/oui/bin/runInstaller -slient -attachHome \ ORACLE_HOME=<ORACLE HOME PATH> ORACLE_HOME_NAME=<name of the ORACLE HOME> 在 oracle 10gr2 以后 attachhome 和 detachome 的脚本被自动包含 <ORACLE_HOME>/oui/bin/attachhome.sh <ORACLE_HOME>/oui/bin/detachhome.sh 如何重建集中信息库

www.oracledatabase12g.com www.oracledatabase12g.com www.oracledatabase12g.com www.oracledatabase12g.com www.oracledatabase12g.com www.oracledatabase12g.com 在 10g 以前 ( 经典的如 9iR2) ， OUI 与 JRE 组件一直作为非 ORACLE_HOME 组件而置于其独立位置上，与 ORACLE_HOME 相分离举例而言在 9i 中其安装位置 OUI 组件位于 <oraInventory>/../oui JRE 组件位于 <oraInventory>/../jre <oraInventory>/ContentsXML/comps.xml 包含了 9iR2 中 OUI 与 JRE 组件的相关信息到 10g 以后， JRE 与 OUI 组件被移动到独立的 ORACLE_HOME 中，以使得各个 ORACLE HOME 可以做到自包含并支持例如 clone 和 attachhome 等的操作举例来说从 10g 以后，安装位置位于 OUI 组件在 $ORACLE_HOME/oui JRE 组件在 $ORACLE_HOME/jre <OH>/inventory/ContentsXML/comps.xml 包含了关于 OUI 和 JRE 的信息 10g 以前和 10g 后安装的区别

www.oracledatabase12g.com www.oracledatabase12g.com www.oracledatabase12g.com www.oracledatabase12g.com www.oracledatabase12g.com www.oracledatabase12g.com OUI 是基于 Java 的图形化工具启动 JRE 必须要用到 JRE(Java 运行时环境 Java Runtime Environment) 在绝大多数平台上安装包中已经包含了启动 OUI 必要的 JRE runInstaller/setup.exe 在引导阶段会自动去解压并使用 oraparam.ini 中 JRE_LOCATION 所指向的 JRE 程序 OUI 可以不使用自带的 JRE ，而使用用户指定的安装在操作系统上的 JRE 程序 JRE 最低版本要求 OUI 2.2.0.X 要求 JRE 版本不低于 1.3.1( 某些老版本的 OUI 只接受少数几个较早版本 JRE ，有时这些 JRE 往往已经找不到了 ) OUI 10.1.0.X 和 10.2.0.X 要求 JRE 版本不低于 1.4.2 OUI 11.1.0.X 则要求不低于 1.5 使用 OUI 的前提 : 合适的 JRE

www.oracledatabase12g.com www.oracledatabase12g.com www.oracledatabase12g.com www.oracledatabase12g.com www.oracledatabase12g.com www.oracledatabase12g.com JRE 一般对应与 OUI 版本和安装套件打包在一起安装套件使用 OUI 10.2.0.x 版包含了扩展的 JRE 套件 cat oraparam.ini |grep JRE_LOCATION JRE_LOCATION=../stage/Components/oracle.swd.jre/1.4.2.8.0/1/DataFiles filegroup1.jar filegroup2.jar filegroup3.jar filegroup4.jar filegroup5.jar 11g 中 installer 在 oraparam.ini 中引入了 BOOTSTRAP_COMPS 与 JRE_SCRATCH_LOC 参数；通过使用这些参数， 11g 安装器可以抽取并使用 JDK 组件 ( 即 oracle.jdk) 由安装套件自带的。 BOOTSTRAP_COMPS="oracle.swd.oui:11.1.0.6.0,oracle.swd.oui.core:11.1.0.6.0,oracle.jdk:1.5.0.1.1" JRE_SCRATCH_LOC=jdk/jre JRE 是如何与安装套件打包的

www.oracledatabase12g.com www.oracledatabase12g.com www.oracledatabase12g.com www.oracledatabase12g.com www.oracledatabase12g.com www.oracledatabase12g.com 安装套件 (10.2.0.x 和 11g) 使用 OUI 版本 10.2.0.X 和 11.X ，支持使用” -jreloc” 选项以使用用户提供的 JRE 软件。 ./runInstaller -jreloc /usr/local/jdk1.6.0_24 (Unix) Setup.exe -jreloc C:\jdk1.6 (Windows) 安装套件 ( 版本 9.2.0.5 至 9.2.0.8 和 10.1.0.x) 使用 OUI 版本 10.1.0.X ，可以参考 Metalink 文档” Note 298163.1” 以了解创建“ bin.jar 和 all_exception_bin.jar” 安装套件 ( 版本 9.2.0.2 至 9.2.0.4) 使用 OUI 版本 2.2.0.X ，通过修改 oraparam.ini 并替换 JRE_LOCATION 所指向的位置，可以利用用户想要使用的 JRE 。如何使用可选的 JRE 协同 OUI 工作

www.oracledatabase12g.com www.oracledatabase12g.com www.oracledatabase12g.com www.oracledatabase12g.com www.oracledatabase12g.com www.oracledatabase12g.com Bug 5391050 - DB 10.2.0.1 INSTALLATION FAILS ON MONTECITO CHIP H/W Note 400227.1 How To Install Oracle RDBMS Software On Itanium Servers With Montecito Processors Bug 5530274 PATCH "P4547809_92080_SOLARIS64.ZIP" JAVA VERSION 1.3.1 - SR NUMBER 5746016.992 Note 393199.1 Oui provided with Patchset 9.2.0.8 fails with exception 安装套件自带 JRE 已知的 Bug/ 问题

www.oracledatabase12g.com www.oracledatabase12g.com www.oracledatabase12g.com www.oracledatabase12g.com www.oracledatabase12g.com www.oracledatabase12g.com OUI 简易安装流程

www.oracledatabase12g.com www.oracledatabase12g.com www.oracledatabase12g.com www.oracledatabase12g.com www.oracledatabase12g.com www.oracledatabase12g.com 11g 数据库安装流程

www.oracledatabase12g.com www.oracledatabase12g.com www.oracledatabase12g.com www.oracledatabase12g.com www.oracledatabase12g.com www.oracledatabase12g.com ORACLE_BASE 目前可以充当一个新的会话变量了例如 ./runInstaller ORACLE_BASE=<location of ORACLE_BASE> 目前在 GUI 模式下界面会提示用户是否想要使用已有的 ORACLE_BASE 或者指定一个新的在安装之后， ORACLE_BASE 信息会被记录到本地信息库中的以下文件 <OH>/inventory/ContentsXML/oraclehomeproperties.xml 参考 Note 454442.1 11g Install : Understanding about Oracle Base, Oracle Home and Oracle Central/Global Inventory locations [ID 454442.1] 11g 新特性： ORACLE_BASE

www.oracledatabase12g.com www.oracledatabase12g.com www.oracledatabase12g.com www.oracledatabase12g.com www.oracledatabase12g.com www.oracledatabase12g.com 引入了可客制化的引导程序功能这样做的出发点：软件自带的 JRE 无法正常引导或工作用户未安装 OS 级别的 JRE/JDK ，由此 runInstaller 无法使用 -jreloc 选项 Oraparam.ini 文件中的新参数 BOOTSTRAP_COMPS="oracle.swd.oui:11.1.0.6.0,oracle.swd.oui.core:11.1.0.6.0,oracle.jdk:1.5.0.1.1" JRE_SCRATCH_LOC=jdk/jre ，该参数指定了启动 java 引擎所在位置的相对起点举例来说 JRE_SCRATCH_LOC=jdk/jre, 那么在引导完成后， JRE 在 <scratch>/jdk/jre/bin/java 的位置被启动 runinstaller 目前出现了新的选项： -bootstarponly ，即仅针对指定的组件启动引导操作 . ./runInstaller –bootstraponly BOOTSTRAP_LOC=<location> 11g 新特性： JRE

www.oracledatabase12g.com www.oracledatabase12g.com www.oracledatabase12g.com www.oracledatabase12g.com www.oracledatabase12g.com www.oracledatabase12g.com OUI 所使用 JRE 位置的优先级如下若指定了 -jreloc ，则使用指定的位置指定了的 JRE_SCRATCH_LOCATION 使用已引导的 oracle.swd.jre 组件，位置由 oraparam.ini 指定的 JRE_LOCATION 决定否则提示用户输入 JRE_LOCATION Preparing to launch Oracle Universal Installer from /tmp/OraInstall2011-03-17_01-30-30PM. Please wait ... Please specify JRE/JDK location ( Ex. /home/jre ), <location>/bin/java should exist :/fds Please specify a valid JRE location : 11g 新特性： JRE

www.oracledatabase12g.com www.oracledatabase12g.com www.oracledatabase12g.com www.oracledatabase12g.com www.oracledatabase12g.com www.oracledatabase12g.com 信息库常见问题 Unix 或 Windows 上 OUI 启动问题检查列表常见问题

www.oracledatabase12g.com www.oracledatabase12g.com www.oracledatabase12g.com www.oracledatabase12g.com www.oracledatabase12g.com www.oracledatabase12g.com 集中信息库或本地信息库可能丢失会损坏造成的使用” opatch lsinventory -detail” 或者 OUI 界面上点击 installed Products 时找不到 ORACLE HOME 虽然 opatch lsinventory -detail 或者 OUI 界面上 installed products 点击可以显示相应 ORACLE_HOME 但无法列出详细信息，一般是 ORACLE_HOME 相关的信息库丢失或者损坏了若集中信息库丢失或损坏，可以通过还原来回复，前提是备份过我们极力推荐日常备份 ORACLE_HOME 和集中信息仓库，在升级或打 patch 之前使用 9.2.0.2 的客户需要注意，有报告说明 OUI 2.2.0.12 存在损坏信息库的 bug, 推荐参考文档 Note 229773.1 信息库 (inventory) 常见问题

www.oracledatabase12g.com www.oracledatabase12g.com www.oracledatabase12g.com www.oracledatabase12g.com www.oracledatabase12g.com www.oracledatabase12g.com Itanium Montecito processors 相关的 JRE 问题 Note 401332.1 How To Identify A Server Which Has Intel® Montecito Processors Installed Note 400227.1 How To Install Oracle RDBMS Software On Itanium Servers With Montecito Processors UNIX 上的 OUI 启动失败检查列表 DISPLAY 环境变量设置不当 Note.153960.1 FAQ X Server Testing and Troubleshooting /tmp 临时目录至少需要 400MB 的空间并且对 oracle 安装用户来说可写实在没有办法的时候，可以修改临时目录变量 $TMP 到别的目录 Note 339657.1 Unable To Start OUI: not enough room in /tmp Note 177902.1 How To Set Temporary Space Directory 调用 OUI 时使用” -debug” 选项以确认在 JRE 解压阶段没有出现错误在调用 java 命令启动 OUI 阶段没有出现错误若在 JRE 解压完成后 (java 命令失败） OUI 启动失败，那么一般可以确认是自带的 JRE 在目标系统上存在问题 UNIX 上常见的 OUI 启动问题

www.oracledatabase12g.com www.oracledatabase12g.com www.oracledatabase12g.com www.oracledatabase12g.com www.oracledatabase12g.com www.oracledatabase12g.com 为了确认 JRE 的问题，手动解压自带的 JRE 并确认 java 命令 cd database/stage/Components/oracle.swd.jre/1.4.2.8.0/1/DataFiles/ mkdir /tmp/java_test cp *.jar /tmp/java_test cd /tmp/java_test Unzip filegroup[1-5].jar cd jre/1.4.2/bin chmod 755 java [maclean@rh8 bin]$ ./java -version java version "1.4.2_08" Java(TM) 2 Runtime Environment, Standard Edition (build 1.4.2_08-b03) Java HotSpot(TM) Client VM (build 1.4.2_08-b03, mixed mode) 可以看到在我们的场景中 java 命令运行正常，若以上测试的最后结果中 java 命令出错则说明 Oracle 安装介质自带的 JRE 存在问题，这可能是个例，在安装介质传输过程中出现网络错误所导致的文件损坏可能引起以上问题；可以通过 checksum 等方式验证安装介质包 /ISO 文件无误。若经过验证发现安装介质没有损坏，那么很有可能是自带 JRE 在目标操作系统上无法正常运行，用户可以到 java.sun.com 网站去下载指定平台最新可用的 JDK 软件，在成功安装后 JDK 后再次尝试以” -jreloc” 选项启动 runInstaller 程序，命令示例如下 : ./runInstaller -debug -jreLoc <JRE Install Home> UNIX 平台上的 OUI 启动问题

www.oracledatabase12g.com www.oracledatabase12g.com www.oracledatabase12g.com www.oracledatabase12g.com www.oracledatabase12g.com www.oracledatabase12g.com Oracle Universal Installer Users Guide Note.736819.1 How to Log Good Service Request for Oracle Universal Installer (OUI) issues? Note.454442.1 11g: Understanding about Oracle Base, Oracle Home and Oracle Central/Global Inventory locations Note 71919.1 Debugging OUI on windows Note 137200.1 Checklist when Oracle Universal Installer (OUI) fails for Windows Note 208944.1 How to Resolve Issues of the OUI Hanging on UNIX Note 266617.1 OUI may appear and then disappear on Windows 2000 with SP4 Note 338507.1 10gR2 OUI Error "OUI-10094:Problem in saving inventory" Note 301883 .1 OUI Deinstallation From Home1 Can Affect Home2 相关 Support 文档

深入理解Oracle universal installer(oui)

More Related Content

What's hot (20)

Viewers also liked (20)

Similar to 深入理解Oracle universal installer(oui) (20)

More from maclean liu (20)

深入理解Oracle universal installer(oui)

Editor's Notes