OBIEE 12.2.1.4 Admin tool创建ODBC系统数据源失败问题咨询

故障根因 #

• 位数不匹配：OBIEE 12.2.1.4 Admin Tool默认是32位程序，若打开64位系统ODBC管理器，会无法正确加载32位的nqssetup.dll驱动文件
• 环境变量缺失：OBIEE客户端的依赖路径未加入系统Path变量，导致nqssetup.dll加载时无法找到关联的依赖库
• 权限不足：操作ODBC管理器时未使用管理员权限，或者当前账号对OBIEE客户端安装目录没有读取执行权限
• 安装损坏：Admin Tool客户端安装过程中出现文件丢失、损坏，导致驱动文件或其依赖库不完整
• 多客户端冲突：设备上同时安装了其他版本的OBIEE客户端、Oracle数据库客户端，导致dll加载优先级冲突

排查解决步骤 #

• 校验ODBC管理器位数与权限 #

  确认Admin Tool为32位版本的前提下，不要直接打开控制面板中的ODBC工具，需访问路径C:\Windows\SysWOW64\odbcad32.exe，右键选择「以管理员身份运行」32位ODBC管理器后再尝试创建系统DSN。

• 修复系统环境变量配置 #

  打开系统环境变量编辑界面，在系统变量的Path中追加以下3个路径（替换为你实际的OBIEE客户端ORACLE_HOME路径），配置完成后重启设备生效：
  • [ORACLE_HOME]\bi\bifoundation\server\bin
  • [ORACLE_HOME]\bin
  • [ORACLE_HOME]\oracle_common\bin

• 检查目录访问权限 #

  右键点击OBIEE客户端安装根目录，打开「安全」标签页，确认当前操作账号拥有该目录及子文件的「读取和执行」、「列出文件夹内容」、「读取」权限，权限不足时添加对应权限后重试。

• 修复客户端安装 #

  若上述操作无效，打开控制面板「程序和功能」，找到Oracle Business Intelligence 12c客户端项，选择「修复」选项执行安装修复，修复完成后重启设备再操作。

• 排查多客户端冲突 #

  若设备上安装了其他版本的Oracle客户端，临时将其他Oracle客户端的路径从系统Path变量中移除，重启设备后再尝试创建DSN，确认是否为多客户端优先级冲突导致。

内容的提问来源于stack exchange，提问作者user16647218