内容


IBM InfoSphere Federation Server V9.7 和 IBM InfoSphere Branded ODBC Dirver 的安装与配置

Comments

准备知识

IBM Federation Server 需要安装在 DB2 ESE 或者 DB2 CONSV 之上。通过 Federation Server 安装程序,您可以:

  • 在一个已有的 DB2 ESE 或 DB2 CONSV 上,安装 Federation Server。
  • 同时安装一个 Federation Server 和限制版的 DB2 ESE。
  • 更新当前已有的 Federation Server 产品,为其增加新的数据源支持。

建议您在安装 Federation Server 之前安装并测试好您的客户端数据源,否则在安装 Federation Server 之后,您需要手工配置您的数据源。

如何获得 DRDA 数据源支持、 Infomix 数据源支持和 Web Service 数据源支持

从 V9.7 开始,DB2 ESE 安装程序默认包含 Web Service 数据源支持,并提供 DRDA 和 Infomix 数据源支持的安装选项,如果只是需要这三种数据源支持,那么并不需要额外安装 Federation Server 。需要注意的是,在安装 DB2 ESE 时,DRDA 数据源支持是默认安装选项,而 Informix 数据源支持则需要用户在安装过程中选择”定制”安装,并选中 Informix 数据源支持。

图 1. 选择安装 Informix 数据源支持
图 1. 选择安装 Informix 数据源支持
图 1. 选择安装 Informix 数据源支持

如何从试用版升级成正式版

Federation Server 试用版许可证只能注册一次,并允许使用 90 天。从 Federation Server 试用版转换到正式版,只需要通过 db2licm 命令删除试用版许可证 (isfs_t.lic),并添加正式版许可证(isfs.lic)即可。例如:

db2licm – r isfs // 删除 Federation Server 许可证
db2licm – a isfs.lic // 添加 Federation Server 正式版许可证

在 Unix/Linux 平台上 root 与 nonroot 用户安装的区别

Federation Server V9.7 支持 root 和 nonroot 安装。在 root 安装过程中,用户可以定制安装路径,但 nonroot 安装只能安装在相应的 USER_ID/sqllib 下,不能更改默认安装路径且不能创建实例用户。

Federation Server 的安装、配置与卸载

重要安装组件介绍

图 2. Federation Server 安装包文件结构
图 2. Federation Server 安装包文件结构
图 2. Federation Server 安装包文件结构
  • ESE: DB2 ESE 安装文件。
  • license: 包含 Federation Server 许可证(isfs.lic、isfs_t.lic 或 isfs_d.lic)及 DB2 ESE 限制版许可证 (db2ese_o.lic) 。
  • windows: 这是以操作系统名命名的文件夹,它里面包含两个文件夹 rcon 和 lsdc 。其中 rcon 是关系型数据源支持安装文件,lsdc 是非关系型数据源支持安装文件。

通过 GUI 图形界面方式安装和配置 Federation Server

因为 AIX 平台支持 Federation Server 支持的所有数据源,所以本文将以在 AIX 上的实际安装操作为例,详细介绍安装与配置的步骤。其他平台上安装与配置的过程与 AIX 类似。

以 root 用户登录操作系统并调用 ./iisetup 启动 Federation Server 安装程序。

图 3. 启动界面
图 3. 启动界面
图 3. 启动界面
图 4. 欢迎界面
图 4. 欢迎界面
图 4. 欢迎界面

可以选择安装 Federation Server 和生成响应文件。如果用户期望备份一个与生产环境完全一样的测试环境,可以在生产环境安装的时,选择生成安装响应文件。生成的响应文件中将会记录用户在生产环境上的每个选项与输入。之后,用户可在测试机上直接使用此响应文件,进行静默安装,以备份生产环境。

图 5. 安装产品和生成响应文件界面
图 5. 安装产品和生成响应文件界面
图 5. 安装产品和生成响应文件界面

安装程序会为用户提供安装限制版的 DB2 ESE 和 Federation Server 的选项。

  • 若用户系统上已有 DB2 ESE 或 DB2 CONSV,安装程序将提供在已有 DB2 上安装 Federation Server 的选项。
  • 若用户已有 Federation Server V9.7,还可以通过安装程序更新现有安装,添加新的数据源支持。
  • 但如果系统上没有相应版本的 DB2 或 Federation Server,安装程序将不会提供后面两个选项。
图 6. 安装类型选择界面
图 6. 安装类型选择界面
图 6. 安装类型选择界面

安装过程中,如果安装程序检测到系统上没有创建 DAS,安装程序将根据用户输入信息,帮助用户创建一个 DAS 。这里,如果系统上有多个 DB2,他们将共用一个 DAS,此时安装程序将不会帮用户再次创建。

图 7. 创建 DAS 界面
图 7. 创建 DAS 界面
图 7. 创建 DAS 界面

安装程序还可以帮助用户创建实例。安装成功后,用户登录到这个实例即可创建 wrapper 。也可以此时不创建实例,而在安装成功之后手工创建。

图 8. 用户实例界面
图 8. 用户实例界面
图 8. 用户实例界面
图 9. 创建用户实例界面
图 9. 创建用户实例界面
图 9. 创建用户实例界面

通过安装程序配置 Federation Server 关系型数据源支持。 建议用户在安装 Federation Server 之前安装和调试好各个数据源的客户端,这样在安装过程中,安装程序可以根据用户输入的信息,帮助用户自动配置 Federation Server:

安装程序会帮用户把 Federated 参数设置为 yes,确保 MAX_CONNECTIONS 与 MAX_COORDAGENTS 相等,并向 db2dj.ini 里面写入数据源必须的环境变量,运行 djxlink 。但数据源的可选环境环境变量,则只能在安装之后手工写入 db2dj.ini 。若在安装过程中,不配置数据源,也可在安装之后手工配置。

图 10. 配置 Oracle 数据源支持
图 10. 配置 Oracle 数据源支持
图 10. 配置 Oracle 数据源支持

这里实际上是帮助用户向 db2dj.ini 写入中环境变量 ORACLE_HOME 。

图 11. 配置 Microsoft SQL Server 数据源支持
图 11. 配置 Microsoft SQL Server 数据源支持
图 11. 配置 Microsoft SQL Server 数据源支持

填写 ODBC driver installation directory (ODBC 驱动安装目录 ) 实际上是帮助用户向 db2dj.ini 写入环境变量 DJX_ODBC_LIBRARY_PATH 。 填写 Path to the odbc.ini file (odbc.ini 文件路径 ) 实际上是帮助用户向 db2dj.ini 写入环境变量 ODBCINI 。

图 12. 配置 Sybase 数据源支持
图 12. 配置 Sybase 数据源支持
图 12. 配置 Sybase 数据源支持

填写 Sybase client directory (Sybase 客户端目录 ) 实际上是帮助用户向 db2dj.ini 写入环境变量 SYBASE 。

填写 Sybase OCS directory (Sybase OCS 目录 ) 实际上是帮助用户向 db2dj.ini 写入环境变量 SYBASE_OCS 。

图 13. 配置 Teradata 数据源支持
图 13. 配置 Teradata 数据源支持
图 13. 配置 Teradata 数据源支持

填写 Path to libcliv2.so library (libcliv2.so 库文件路径 ) 实际上是帮助用户向 db2dj.ini 写入环境变量 COPLIB 。

填写 Path to the errmsg.cat file (errmsg.cat 文件路径 ) 实际上是帮助用户向 db2dj.ini 写入环境变量 COPERR 。

通过安装程序配置 Federation Server 非关系型数据源支持。用户只需确定一个要配置的实例,即可完成配置。

图 14. 配置非关系型数据源
图 14. 配置非关系型数据源
图 14. 配置非关系型数据源

按照安装向导一步一步操作之后,将会得到安装成功和安装日志界面。安装日志目录 iiv97 将会生成在系统 temp 目录下。在 windows 上,如果不确定系统 temp 目录的位置,可以通过“我的电脑” --> “属性” --> “高级” --> “环境变量”中 temp 变量的值获得。在 Unix/Linux 上,如下所示。

/tmp/iiv97/iisetup.log-------- 安装程序日志       
/tmp/iiv97/db2/db2.log --------DB2 安装日志         
/tmp/iiv97/rw/rw.log -------- 关系型数据源安装日志        
/tmp/iiv97/rw/rw.log -------- 非关系型数据源安装日志
图 15. 安装完成信息
图 15. 安装完成信息
图 15. 安装完成信息
图 16. 安装日志信息和返回代码
图 16. 安装日志信息和返回代码
图 16. 安装日志信息和返回代码

通过 silent 命令方式安装和配置 Federation Server

用户通过安装程序以图形界面方式在生产环境安装和配置好 Federation Server 后,往往希望在测试环境上安装和配置一套和生产环境一模一样的系统。在这种情景下,silent 模式安装将是用户的首选。 Silent 模式即是静默模式安装,在安装过程中安装程序将不会与用户进行任何交互,而是根据用户在响应文件中的输入,帮助用户自动安装。

  • 如何获得响应文件
    在进行 silent 安装之前,用户首选要创建一个响应文件。用户可以通过图形安装界面自动记录输入信息,例如在生产环境上用图形界面安装的同时选择生产响应文件如图 5,创建响应文件,这样安装程序会记录用户的每一项输入,并在安装结束之后同时生成一个响应文件,这份响应文件里记录了在生产环境中的具体配置,然后把这个响应文件复制到测试环境上即可;也可以手工创建响应文件。
    若想手工创建一个响应文件,可以参考安装介质中 sample 目录下的样本响应文件 sample_platform.rsp 。
  • 响应文件参数说明
    用户可以通过样本响应文件中的具体说明了解响应文件中参数的具体含义,并可根据当前机器环境为参数赋值。
  • 安装命令
    在创建好响应文件之后,用户只要调用静默安装命令,即可实现在测试环境下的静默安装。这里需要注意的是,windows 环境下,用户在命令行模式下输入静默安装命令后,会马上出现命令提示符,但实际安装程序还在后台进行并没有退出,你需要根据系统 temp 目录中的日志判断安装是否完成。
    静默安装命令:
    在 windows 上: iisetup.exe – options response_file  – silent
    在 Unix/Linux 上: iisetup – options response_file  	– silent

如何输出调试日志

若安装失败,可以查看系统目录下的日志以确定出错原因。还可以通过调用以下命令输出调试日志,以获得更为详细的安装日志。

在 windows 上: iisetup.exe -is:javaconsole -debug -is:log  logfilename         
在 Unix/Linux 上: ./iisetup -is:javaconsole -debug >  logfilename 2>&1

安装错误诊断

错误1:安装程序出现“ InstallShield is preparing the InstallShield Wizard, which will guide you through the rest of process. Please wait … Preparing Java(tm) Virtual Machine ”后无法继续正常启动安装程序。

诊断:这是一个系统环境相关的问题。可能由多种原因造成,用户可以按照ISMP 错误诊断中的文档诊断并排除错误,也可以采用其他方式进行安装。这里推荐用户采用其他方式安装绕开这个错误,因为系统环境的问题一般较难重现和诊断。用户可以分别运行安装介质中 rcon/db2setup 安装关系数据源支持,lsdc/db2setup 安装非关系型数据源支持 ,然后通过命令 db2licm – a license/isfs.lic 注册 IFS 许可证文件。如果不想通过图形界面安装 IFS,您也可以选择静默安装方式。具体操作如下 :

首先为关系型数据源支持生成响应文件 rw.rsp,例如:

PROD=II_RELATIONAL_WRAPPERS        
LIC_AGREEMENT=ACCEPT        
INSTALL_TYPE = CUSTOM        
FILE=/opt/IBM/db2/V9.7        
KILL_PROCESSES=YES        
DB2_COPY_NAME=DB2COPY1        
MIGRATE_PRIOR_VERSIONS=NO        
REBOOT=NO        
INSTANCE=DB2_01        
DB2_01.NAME=DB2_01        
DEFAULT_INSTANCE=DB2_01        
DB2_01.FEDERATED=YES        
LANG=EN        
COMP=ODBC_DATA_SOURCE_SUPPORT        
COMP=ORACLE_DATA_SOURCE_SUPPORT        
COMP=CUSTOM_DATA_SOURCE_SUPPORT        
COMP=SYBASE_DATA_SOURCE_SUPPORT        
COMP=SQL_SERVER_DATA_SOURCE_SUPPORT        
COMP=TERADATA_DATA_SOURCE_SUPPORT        
INSTALL_OVERRIDE=YES

非关系型数据源支持生成响应文件 nw.rsp,例如:

PROD=II_NONRELATIONAL_WRAPPERS        
LIC_AGREEMENT=ACCEPT        
INSTALL_TYPE = CUSTOM        
FILE=/opt/IBM/db2/V9.7        
KILL_PROCESSES=YES        
DB2_COPY_NAME=DB2COPY1        
MIGRATE_PRIOR_VERSIONS=NO        
REBOOT=NO        
INSTANCE=DB2_01        
DB2_01.NAME=DB2_01        
DEFAULT_INSTANCE=DB2_01        
DB2_01.FEDERATED=YES        
LANG=EN        
COMP=IINR_APPLICATIONS_WRAPPER        
COMP=IINR_SCIENTIFIC_WRAPPER        
COMP=IINR_STRUCTURED_FILES_WRAPPER        
COMP=IINR_USER_DEFINED_FUNCTIONS        
INSTALL_OVERRIDE=YES

在 Unix/Linux 上运行:

/v97ga_image/aix/rcon/db2setup -l logfile -u 
rw_response_file        
/v97ga_image/aix/lsdc/db2setup -l logfile -u 
nw_response_file        
/v97ga/aix/rcon/db2setup -l /tmp/iiv97/rw/rw.log -u 
/tmp/iiv97/rw/rw.rsp        
/v97ga/aix/lsdc/db2setup -l /tmp/iiv97/nw/nw.log -u 
/tmp/iiv97/nw/nw.rsp

在 Windows 上运行:

/v97ga_image /windows/IIRW/db2/windows/wininst.exe /u 
rw_response_file /l logfile /t tracefile /SMS -n 
DB2_COPY_NAME          
/v97ga_image /windows/IINW/db2/windows/wininst.exe /u 
rw_response_file /l logfile /t tracefile /SMS -n 
DB2_COPY_NAME          
/v97ga_image /windows/IIRW/db2/windows/wininst.exe /u 
c:\rw.rsp /l c:\rw.log /t c:\rw.trc /SMS -n DB2COPY1          
/v97ga_image /windows/IINW/db2/windows/wininst.exe /u 
c:\nw.rsp /l c:\nw.log /t c:\nw.trc /SMS -n DB2COPY1

错误2:在 Unix/Linux 上安装失败并得到 DB2 错误代码 87,查看 /tmp/iiv97/iisetup.log 发现如下信息:

$USER:		 null        
primary group: root    
primary group name: root      
reset installLocation to null/sqllib for nonroot install.

查看 /tmp/iiv97/db2/ese.trc 发现如下信息:

1377 ||| ureGetString 70 -DATA- , STRING = A Response file 
error occurred. The value "null/sqllib" is not valid for the 
keyword "FILE" 。

诊断:你没有 export USER=root 或者没有把“ whoami ”命令加入到 PATH 中。为了解决这个问题,首先你应该确定以 root 用户登录系统,然后运行 echo $USER, 如果 echo $USER 没有返回 root,则运行 export $USER=root 并运行 iisetup 安装程序。

错误3:在 Windows 上运行安装程序返回 " A domain name is longer than 14 characters"。

诊断:安装程序不支持超过 14 位的域名,你可以通过运行安装介质中的 /ESE/setup.exe,/rcon/setup.exe,和 /lsdc/setup.exe 分别安装 DB2 ESE、关系型数据源支持、和非关系型数据源支持,然后注册 IFS 许可证文件。

错误4:在 Unix/Linux 上安装失败并得到错误代码 67。

诊断:有可能由于系统 tmp 空间不足,请释放 tmp 空间后再试。如问题没有解决,请直接运行如下命令,以得到更多的错误信息。

/v97ga_image/aix/rcon/db2setup -l logfile -u 
rw_response_file        
/v97ga_image/aix/lsdc/db2setup -l logfile -u 
nw_response_file

错误5:在 Linux 上无法启动安装程序。

诊断:你必须通过运行 /usr/sbin/setenforce 0 注销系统 enforcing 参数。

错误6:

com.sun.java.swing.plaf.motif.MotifLookAndFeel/icons/UpFolder.gif 
not found.         
com.sun.java.swing.plaf.motif.MotifLookAndFeel/icons/ListView.gif 
not found.         
com.sun.java.swing.plaf.motif.MotifLookAndFeel/icons/Computer.gif 
not found.         
com.sun.java.swing.plaf.motif.MotifLookAndFeel/icons/File.gif 
not found.         
com.sun.java.swing.plaf.motif.MotifLookAndFeel/icons/Directory.gif 
not found.         
com.sun.java.swing.plaf.motif.MotifLookAndFeel/icons/FloppyDrive.gif 
not found.         
com.sun.java.swing.plaf.motif.MotifLookAndFeel/icons/NewFolder.gif 
not found.         
com.sun.java.swing.plaf.motif.MotifLookAndFeel/icons/DetailsView.gif 
not found.         
com.sun.java.swing.plaf.motif.MotifLookAndFeel/icons/HomeFolder.gif 
not found.         
com.sun.java.swing.plaf.motif.MotifLookAndFeel/icons/HardDrive.gif 
not found.         
com.sun.java.swing.plaf.motif.MotifLookAndFeel/icons/JavaCup.gif 
not found.

诊断:用户可以忽略这个错误。这是一个已知的 It's a jdk1.4 bug. 可以参考以下链接 :sun bug database

Federation Server V9.7 更加灵活的卸载方式

Unix/Linux 平台上的卸载全部数据源支持和部分数据源支持的方法:

  1. 响应文件方法 :
    这是 V9.7 中新加入的非常灵活的卸载方式,它可以灵活地删除某个组件或全部组件。可以参考安装路径下 install 文件夹中的 db2un.rsp 卸载样本响应文件以定制自己的卸载文件。然后调用命令:
    ./install_path/install/db2_deinstall -r rsp_File 完成卸载。
  2. 命令模式 :
    也可以直接调用命令 ./install_path/install/db2_deinstall -F feature_ID 卸载指定的组件例如:
    ./db2_deinstall -F ODBC_DATA_SOURCE_SUPPORT -F IINR_STRUCTURED_FILES_WRAPPER 完成卸载。

Windows 平台上的卸载全部数据源支持和部分数据源支持的方法:

  1. 响应文件方法 :
    这是 V9.7 中新加入的非常灵活的卸载方式。之前在 windows 平台上,无法卸载某个组件,只能全部卸载关系型数据源支持或非关系型数据源支持,现在用户可以参考安装路径下 install 文件夹中的 db2un.rsp 卸载样本响应文件定制自己的卸载文件,可以灵活地删除某个组件或全部组件。然后调用命令
    ./install_path/install/db2_deinstall -r rsp_File 完成卸载。
    例如可在自己的卸载响应文件中指定:
    REMOVE_COMP =ODBC_DATA_SOURCE_SUPPORT 以卸载 ODBC 数据源支持。
  2. 控制面板的“添加和删除程序”分别删除关系型数据源支持和非关系型数据源支持。在“添加和删除程序”中,必须先分别删除关系型数据源支持和非关系型数据源支持,然后再删除响应的 DB2 产品。

Branded ODBC Driver 的安装、配置与卸载

在 Linux32、AIX64、HP-UX64、Linux64、zLinux 和 Solaris 上,IBM 为 IFS 用户提供了 Branded ODBC Driver,用户无需单独购买 ODBC Driver 。并从 V9.7 开始 Federation Server 和 Branded ODBC Driver 将放在一张 CD 中,当然用户也可以通过 ftp://ftp.software.ibm.com 单独下载 Branded ODBC Driver 安装介质。

通过 GUI 图形界面方式安装 Branded ODBC driver:

  1. 首先运行命令 gunzip file_name.tar.gz 解压安装文件。
  2. 然后运行 tar – xvf file_name.tar 解 tar 包。
  3. 最后运行 ./odbcsetup.bin 即可。

通过 silent 命令方式安装 Branded ODBC driver:

  1. 如何获得响应文件 : 用户可以通过 GUI 安装界面生成一个响应文件,也可以手工创建一个响应文件。
  2. 响应文件参数说明 Branded ODBC Driver 的响应文件很简单,用户只需在响应文件中输入以下 2 行:
    -G licenseAccepted=true
    -P wsodbc.installLocation="/usr/opt/ibm/WSII/odbc"
    注意: licenseAccepted=true 表明接受安装许可证
    wsodbc.installLocation 设置安装路径
  3. 安装命令 ./odbcsetup.bin -options odbc.rsp -silent。

通过 silent 命令方式安装 Branded ODBC driver:

安装完 ODBC dirver 之后,用户需要为其配置一个系统文件,通常把其命名为 odbc.ini。

以下是一个为 MS SQL 配置的 odbc.ini 样本文件。

[ODBC data sources]          
mssqlserver=Microsoft SQL Server 2000                   

[ODBC]          
Trace=0          
TraceDll=/usr/opt/ibm/WSII/odbc/lib/odbctrac.so          
InstallDir=/usr/opt/ibm/WSII/odbc          
quotedID=yes                   

[Microsoft SQL Server]          
Driver=/usr/opt/ibm/WSII/odbc/lib/VMmsss22.so          
Description=Microsoft SQL Server Driver for AIX          
Database=database_name          
Address=ip_addr,port_number

"VMmsss22.so" 是 MS SQL 的驱动文件名。

运行样本程序以检验安装与配置。你可以在安装路径下的 example 目录中找到一个用 C 语言编写的样本程序 example 。可参见与其在相同路径下的 readme 文件编译并运行样本程序。

在运行样本程序之前,要先设置 ODBCINI 环境变量,并使其指向配置文件 odbc.ini 所在路径。 并确保:

AIX:          
/usr/opt/ibm/WSII/odbc/lib

HP-UX:          
SHLIB_PATH (32-bit and 64-bit) or LD_LIBRARY_PATH (64-bit) 			 
中包含目录 /usr/opt/ibm/WSII/odbc/lib  

Linux and Solaris:         
LD_LIBRARY_PATH 中包含目录 /usr/opt/ibm/WSII/odbc/lib

当你运行样本程序后,会得到以下警告信息:

Warning:[DataDirect][ODBC SQL 
Server Driver][SQL Server]The DataDirect ODBC driver you 
are attempting to access has been provided to you by IBM 
Corporation for exclusive use with IBM Information 
Server. You are not licensed to use this driver with any 
application other than IBM Information Server. If you 
would like to purchase a driver for some other use, 
please call 800-876-3101 or visit DataDirect at 
www.datadirect.com NetConn: 100

这是由于 IBM Branded ODBC dirver 只能用于 IBM 产品,而这个样品程序是由 Data Direct 公司提供的,所以返回警告信息。在这里,你可以忽略它。 在 Windows,MS SQL 数据源支持将使用微软自带的驱动程序。

卸载 Branded ODBC driver: 在安装路径下运行 ./_uninstall 即可卸载 ODBC driver 程序。

结束语

本文详细描述了 InfoSphere Federation Server 和 InfoSphere ODBC Driver 的安装过程以及相关组件的简要介绍,并对安装中的常见问题进行了解答。


相关主题


评论

添加或订阅评论,请先登录注册

static.content.url=http://www.ibm.com/developerworks/js/artrating/
SITE_ID=10
Zone=Information Management
ArticleID=438215
ArticleTitle=IBM InfoSphere Federation Server V9.7 和 IBM InfoSphere Branded ODBC Dirver 的安装与配置
publish-date=10192009