深入理解oracle universal installer(oui)

www.oracledatabase12g.com

刘相兵 (Maclean Liu)[email protected]

深入理解 Oracle Universal Installer (OUI)

www.oracledatabase12g.com www.oracledatabase12g.com www.oracledatabase12g.com www.oracledatabase12g.comwww.oracledatabase12g.com www.oracledatabase12g.comwww.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 空间


OUI 能做什么？

其核心功能无疑是安装各类 Oracle 产品或组件反安装组建或产品维护基于 XML 的产品信息仓库 (inventory)

为安装执行必要的安装前检查当需要时额外调用配置助手（如 Netca,DBCA,DBUA 等）从 oracle 11g 开始， OCM 也就是 Oracle Configuration Manager 也同

样被综合到 OUI 的框架中信息库操作，包括附件节点列表


启动阶段开始对用户可见，载入必要的文件并显示一个欢迎界面

安装阶段用户选择安装或反安装某些产品；提供源和目标目录

选择阶段需要安装的产品被勾选，可用磁盘空间及必要磁盘空间被显示，并会

出现 summary 总结页面安装进度阶段

实际安装过程中，显示安装进度条安装完成阶段

要求用户运行 root.sh 脚本，并启动某种配置助理工具 (configuration assistants)

OUI 具有那些阶段？


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

安装模式


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


在 windows 上 :

<Disk>\setup.exe

安装后%ORACLE_HOME%\oui\bin\setup.exe

在 unix 上Cd <Disk1>

./runInstaller

安装后Cd $ORACLE_HOME/oui/bin

./runInstaller

如何启动 OUI 互动模式 ?


在 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 静默模式？


每次 OUI 启动都会产生日志，日志名会以时间戳的形式归档这些日志包含了安装过程中丰富的信息。我们推荐在安装完成后复验一遍日志一般来说这些日志存放在中心信息库中 (inventory) ，在 logs 子目录下的并以如下形式命名 :

installActions<year-mm-dd_hh-mi-ss><AM|PM>.logoraInstall<year-mm-dd_hh-mi-ss><AM|PM>.erroraInstall<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 日志存放在哪里？


使用 OUI

启动 OUI 并尝试点击” Installed Products”

也可以使用 Opatch 工具Opatch lsinventory -detail

如何确认已安装的产品


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 功能？


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 等信息


默认的信息库指针：在给定平台上的某个标准位置存放着该指针文件，该文件包含了中心信息库的位置。/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

信息库指针文件


集中信息库：该信息库以目录形式存在，包含了该主机上安装的所有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)


本地信息库：目录结构包含了 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)


前提是本地信息库没有被损坏或丢失使用 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

如何重建集中信息库


在 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 后安装的区别


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


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 是如何与安装套件打包的


安装套件 (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 工作


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/ 问题

https://webiv.oraclecorp.com/cgi-bin/webiv/do.pl/Get?WwwID=BUG:5391050

https://webiv.oraclecorp.com/cgi-bin/webiv/do.pl/Get?WwwID=note:400227.1

https://webiv.oraclecorp.com/cgi-bin/webiv/do.pl/Get?WwwID=bug:5530274

https://webiv.oraclecorp.com/cgi-bin/webiv/do.pl/Get?WwwID=note:393199.1


OUI简易安装流程


11g 数据库安装流程


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

https://support.oracle.com/CSP/main/article?cmd=show&type=NOT&doctype=BULLETIN&id=454442.1


引入了可客制化的引导程序功能

这样做的出发点：软件自带的 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


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


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

常见问题


集中信息库或本地信息库可能丢失会损坏造成的使用” 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)常见问题


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 启动问题

https://webiv.oraclecorp.com/cgi-bin/webiv//do.pl/Get?WwwID=note:401332.1

https://webiv.oraclecorp.com/cgi-bin/webiv//do.pl/Get?WwwID=note:400227.1


为了确认 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 启动问题


Oracle Universal Installer Users GuideNote.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 locationsNote 71919.1 Debugging OUI on windowsNote 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 SP4Note 338507.1 10gR2 OUI Error "OUI-10094:Problem in saving inventory" Note 301883.1 OUI Deinstallation From Home1 Can Affect Home2

相关 Support 文档

http://download.oracle.com/docs/cd/B28359_01/em.111/b31207/toc.htm

http://webiv.oraclecorp.com/cgi-bin/webiv/do.pl/GET?WwwID=Note.736819.1

http://webiv.oraclecorp.com/cgi-bin/webiv/do.pl/GET?WwwID=Note.Note.454442.1

http://webiv.oraclecorp.com/cgi-bin/webiv/do.pl/Get?WwwID=note:71919.1






http://webiv.oraclecorp.com/cgi-bin/webiv/do.pl/GET?WwwID=Note.301883.1

深入理解oracle universal installer(oui)

Technology