i2 Analyst‘s Notebook 8.91安装部署：环境、许可与排错验收

简介IBM i2 Analysts Notebook 8.91 是一套面向情报分析、调查取证、金融风控与网络安全研判人员的可视化关联分析工具安装包重点解决多源数据整合、实体关系挖掘与图表化呈现等问题。压缩包共42个文件约443.77MB包含exe安装程序、htm部署向导页面、pdf快速入门与发布说明、msu系统补丁及dll/xml等配置组件并附培训教材和用户指南便于按部署流程完成环境准备。已有4683人学习说明其在同类工具中关注度较高。包内提供预装软件与安装管理组件涵盖.NET Framework、Visual C运行库、Windows Installer等依赖可减少环境配置阻力配套文档可用于理解数据导入、关联分析、智能搜索、模板工作流与版本回溯等功能适合需要搭建演示环境或系统学习情报分析流程的初中级用户参考。1. 安装 i2 Analysts Notebook 8.91 前先确定不该装在哪类机器上情报分析系统软件里i2 Analysts Notebook 8.91 是对运行环境要求最严格的一类它不是那种装完就能用的绿色工具而是要靠一套运行库、一套许可机制和一层 ODBC 数据桥接才能跑起来的桌面分析客户端。同一份安装包在一台刚重装过的干净机器上二十分钟能出图换到一台装了三年的办公本上可能就是许可服务连不上、关系图拖一下就白屏、中文实体名全是问号。这类软件真正的难点不在向导里的“下一步”而在装之前没把机器对齐。我见过最常见的失败是有人把安装包拷到一台 4GB 内存、机械硬盘、还开着实时防护的机器上装完能打开但一导入上万条实体就开始假死最后被当成“软件有问题”卸掉重来三遍。这篇按我实际部署的顺序写先对齐环境、再补运行库、然后装主程序配许可、接着做首次配置、最后用样例数据验收一遍链路。第一次上手的人可以照着走手上有一批机器要统一装的可以直接拿走第 3 章的静默安装命令。2. 环境清单Windows 版本、.NET 运行库与目录权限一次对齐装这类桌面分析工具的返工成本很高卸不干净会留注册表残留重装时又报“已存在更高版本”。所以动手前先花十分钟把机器盘一遍比装到一半卡住再回滚划算得多。下面这份清单是我按实际布过的几十台机器总结出来的不是官方最低配置的抄写而是“装完能正常干活”的那条线。2.1 系统与硬件一张能照着配的表先看表再解释为什么这么定。项目能装上的线我建议的配置原因操作系统Windows 10 64 位Windows 10 专业版 21H2 以上家庭版缺组策略和部分权限入口排查时很别扭CPU双核4 核以上图谱布局计算主要消耗单核性能核多不加分但核少会卡住主线程内存8 GB16 GB 起上千节点的关系图在 8 GB 机器上会频繁换页磁盘20 GB 空闲SSD预留 50 GB临时文件、缓存和导出图片都写这里显示1366×7681920×1080 起步双屏更舒服画布加属性面板单屏小分辨率基本没法看显卡集成显卡较新的集显或入门独显驱动走厂商官网渲染异常十有八九出在驱动上几点补充。系统版本别挑太老的Windows 10 1507、1607 这些早期版本缺的补丁太多装运行库时会连环报错也别挑刚发布的大版本更新驱动和 .NET 的兼容性还没跑稳。安装路径我一般固定成D:\Apps\i2ANB不带中文、不带空格、不放在Program Files下面——后一条不是洁癖是为了后面调权限和写日志时少踩 UAC 的坑。内存这条值得多说一句。8 GB 能装上也能打开但一旦做“展开节点”“按条件筛选后再布局”这类操作内存曲线会直接顶到 95% 以上鼠标转圈十几秒操作者会以为软件崩了。16 GB 是这条线里性价比最高的一档。2.2 运行库顺序先 .NET 后 VC反过来会缺 DLL这台机器的运行库要先确认两件事.NET Framework 4.x 的版本够不够Visual C 运行库的 x86 和 x64 是不是都齐。顺序很重要先补 .NET重启再装 VC再重启最后装主程序。反过来先装 VC 再补 .NET偶尔会出现主程序安装时找不到某个托管 DLL 的情况报错信息还特别含糊。查 .NET 版本不要看“程序和功能”里那一行直接读注册表的 Release 值更准# 读 .NET Framework 4.x 的 Release 值比控制面板里显示的版本号准 $ndp HKLM:\SOFTWARE\Microsoft\NET Framework Setup\NDP\v4\Full if (Test-Path $ndp) { Get-ItemProperty $ndp | Select-Object Version, Release } else { Write-Output 未检测到 .NET Framework 4.x需要先装运行库 }这段逻辑很直白v4\Full这个键存在说明装了 4.x 的完整版不存在就只有 3.5 或压根没装。Release是个 DWORD不同的值对应不同的小版本比对下面这张表就够了Release 值对应版本394802 及以上4.6.2461808 及以上4.7.2528040 及以上4.8533320 及以上4.8.1我的习惯是直接顶到 4.8别在 4.5、4.6 这些老版本上纠结老版本既缺补丁又容易和新版 VC 运行库打架。注意别去“降级”系统自带的更高版本Windows 10 后期版本自带的 .NET 已经比安装包里的新硬装低版本会把系统组件搞坏。VC 这边x86 和 x64 两套都要装一套都不能省。原因很简单主程序是 32 位进程但 ODBC 驱动、部分数据访问组件是 64 位的缺哪一套都会在某个环节报“找不到 xxx.dll”。# 列出已安装的 VC 运行库重点看有没有 2015-2022 的 x86 与 x64 Get-ItemProperty HKLM:\SOFTWARE\WOW6432Node\Microsoft\Windows\CurrentVersion\Uninstall\*, HKLM:\SOFTWARE\Microsoft\Windows\CurrentVersion\Uninstall\* -ErrorAction SilentlyContinue | Where-Object { $_.DisplayName -like *Visual C* } | Select-Object DisplayName, DisplayVersion | Sort-Object DisplayName两个注册表路径都要查是因为 32 位程序的卸载信息被重定向到WOW6432Node下面只查后者会漏掉 64 位的那些。输出里如果只看到 x64 条目说明 x86 那套没装补上。装完运行库一定要重启。这条不是形式主义.NET 的 NGEN 编译和 VC 的 DLL 注册都要在重启后生效不重启就装主程序很容易在最后一步报“组件注册失败”。2.3 目录权限与安全软件装完打不开的一半原因有一类故障特别隐蔽装的时候用管理员账号装完能开换普通账号登录双击图标没反应或者打开了但配置怎么改都不生效。八成是配置写不进目标目录被 UAC 的虚拟化重定向到了用户目录下的VirtualStore。排查这个先看配置到底写哪儿了# 检查是否存在 UAC 虚拟化留下的影子目录有就说明配置被重定向了 $vs $env:LOCALAPPDATA\VirtualStore if (Test-Path $vs) { Get-ChildItem $vs -Recurse -Depth 2 | Select-Object FullName }只要在VirtualStore里看到了这套软件的目录就说明它尝试往受保护路径写文件被拦下来了。解决办法不是关 UAC而是把安装目录换个位置或者提前把目录权限给足# 给分析工作区目录授权OI 继承到文件CI 继承到子目录M 是修改权限 icacls D:\i2Workspace /grant DOMAIN\analysis01:(OI)(CI)M /T/T是递归应用到已有子目录(OI)(CI)M里 OI 管对象继承、CI 管容器继承、M 是修改级权限——给到 M 就够别图省事给 F完全控制。第一次授权前先把已经存在的文件归属确认一下不然容易把别人放进去的共享数据一并改掉。安全软件这边我一般提前做三件事把安装目录和D:\i2Workspace加进实时扫描排除项把安装包解压目录也排除掉大 MSI 解压时被拦会报 1603确认没有开启“受控文件夹访问”这类会拦截写入的防护。这些设置改完再装能省掉一半莫名其妙的安装失败。3. 安装主程序与许可配置从解压到第一张关系图能存盘前置条件齐了进入主程序。这一步真正容易出错的地方不在安装向导而在许可以及显示这块——很多人装完能打开界面却卡在“许可无效”或者“拖图卡成幻灯片”然后开始怀疑安装包。3.1 安装包结构与静默安装参数解压后的目录结构各家打包方式大同小异通常是这样几块顶层的setup.exe、一个或多个.msi、prerequisites目录放运行库、license目录放许可申请模板、docs目录放部署说明。动手前先翻一遍docs里面的许可申请流程和各组件端口以它为准别照抄网上任何一份二手文档。单机装直接双击setup.exe走向导注意三个选项安装路径改成D:\Apps\i2ANB组件选择里把用不到的语言包去掉能省几百兆也少一堆文件被安全软件扫许可类型那一步先跳过等装完再配——向导里配许可失败会整段回滚白装一次。要批量装就得走静默。InstallShield 包的两层参数结构是/s让 setup.exe 自己静默/v后面的内容原样透传给内部的 MSI# 静默安装/s 是外层静默/v 里的 /qn 是 MSI 静默INSTALLDIR 用转义引号包住 $p Start-Process -FilePath .\setup.exe -ArgumentList /s,/v/qn INSTALLDIR\D:\Apps\i2ANB\ -Wait -PassThru $p.ExitCode-Wait必须加不加的话脚本会立刻往下走后面的许可配置在文件还没落盘时就执行了。ExitCode要判断0 是成功3010 是成功但需要重启1603 是致命错误多半是权限或安全软件拦截1605 是上一次安装没清干净。如果 setup.exe 这层总是出问题可以直接对 MSI 下手并且务必开详细日志# 绕过外层直接装 MSI并生成详细日志方便定位 1603 Start-Process msiexec.exe -ArgumentList ( /i,i2ANB.msi,/qn, INSTALLDIRD:\Apps\i2ANB, /L*v,C:\Temp\anb_install.log ) -Wait/L*v是“所有信息都记”日志文件动辄几十兆但出问题时它是唯一的黑匣子。看日志的方法是从后往前搜Return value 3那一行往上的十几行就是真正失败的动作比看弹窗有用得多。3.2 许可配置本地许可文件与许可服务两种接法这套软件的许可有两种落地方式一种是单机许可文件绑在这台机器上一种是指向许可服务多台客户端共享浮动授权。选哪种不看喜好看你有几台机器——一台就本地文件三台以上就走服务端否则每换一台机器都要重新走一遍申请。本地许可文件的方式最省事但有个坑许可通常和主机名、网卡地址这类信息绑定换了网卡、改了计算机名、甚至把系统从机械盘克隆到新机器许可都会失效。所以导入许可文件之前先把主机名定下来别装完再改。服务端方式要先把连通性测通别等打开软件才看到报错# 装完先测许可服务端口通不通在这一步就见分晓 Test-NetConnection -ComputerName 许可服务地址 -Port 许可服务端口 | Select-Object ComputerName, RemotePort, TcpTestSucceededTcpTestSucceeded为 True 只说明网络层通了如果客户端还是报许可无效那问题在许可服务本身的授权池被占满或者客户端版本号不在授权范围内得去服务端查。服务端许可还要确认服务本身在跑# 查许可相关服务的状态与启动类型Manual 的记得改成 Automatic Get-Service | Where-Object { $_.Name -match i2|license|sentinel } | Select-Object Name, Status, StartTypeStartType是 Manual 的服务重启后不会自己起来客户端第二天早上就会集体报许可失败。这种“昨天还好好的”类故障基本都是服务没设成自动启动。3.3 显示与图形设置关系图拖不动的三个开关界面能打开、许可也通了接下来最容易翻车的是渲染。上千节点的图在拖动时卡顿、缩放时出现白块、节点文字重叠错位这三类现象我遇到过很多次原因基本集中在三处。第一处是 DPI 缩放。系统缩放设成 125% 或 150% 时老版本桌面程序的图标和工具栏会错位属性面板的文字会被裁掉。最省事的做法是右键主程序 exe进“属性 - 兼容性 - 更改高 DPI 设置”勾上“替代高 DPI 缩放行为”缩放执行选“系统”。批量部署时这一步可以用注册表预置# 给主程序打上高 DPI 兼容标记等价于在兼容性选项卡里手动勾选 $exe D:\Apps\i2ANB\AnalystNotebook.exe $key HKCU:\Software\Microsoft\Windows NT\CurrentVersion\AppCompatFlags\Layers New-Item -Path $key -Force | Out-Null New-ItemProperty -Path $key -Name $exe -Value ~ HIGHDPIAWARE -PropertyType String -Force~ HIGHDPIAWARE就是“由系统接管缩放”的标记写进当前用户的注册表所以按用户逐个生效多用户机器要每个账号跑一次。动注册表之前先导出备份这是习惯。第二处是显卡驱动。集显机器上装完系统自带的老驱动硬件加速和新版渲染管线对不上就会出现缩放白块。去显卡厂商官网下对应型号的最新稳定版别用第三方驱动工具“一键更新”那些工具装的版本往往比官网还旧。第三处是图本身的规模。超过五千个节点还开着实时布局什么显卡都救不了。我的做法是先把自动布局关掉按类别分批展开需要整体视图时再手动跑一次布局跑完存盘。这个操作习惯比换机器有用。4. 首次配置数据源接入、中文字符集与模板路径装完能打开只是及格线真正的验收标准是“能把外部数据导进来、中文不乱码、配好的东西能搬到另一台机器上”。这三件事都发生在首次配置阶段也是返工率最高的地方。4.1 数据源接入ODBC 与 CSV 两条路接入数据有两条路结构化的走 ODBC 连数据库一次性的走 CSV 导入。两条路各有各的坑先说 ODBC。最关键的一点32 位程序必须用 32 位的 ODBC 管理器建 DSN。在开始菜单里搜“ODBC 数据源”打开的那个是 64 位的在里面建的 DSN32 位的主程序根本看不到你会对着一个明明存在的 DSN 反复报“数据源名称未找到”。# 32 位程序要连的 DSN 必须在 32 位 ODBC 管理器里建 Start-Process C:\Windows\SysWOW64\odbcad32.exe # 建完从这里确认 DSN 落在 32 位分支下 Get-ChildItem HKLM:\SOFTWARE\WOW6432Node\ODBC\ODBC.INI -ErrorAction SilentlyContinue | Select-Object -ExpandProperty PSChildNameSysWOW64这个目录名有迷惑性它装的恰恰是 32 位组件System32里才是 64 位的。注册表这边同理WOW6432Node下面才是 32 位程序看到的那份。基准测试的时候我一般两边都建一份同名 DSN省得后面分不清是哪边生效。ODBC 还要注意驱动版本和数据库版本匹配。SQL Server 的 ODBC 驱动有 11、13、17、18 好几个大版本用太老的驱动连新版本数据库会报加密协议不支持用太新的驱动连老数据库又可能报字符集问题。我一般取中间那一档装完先用系统自带的测试按钮连一次通了再去软件里配。CSV 这条路看起来简单实际九成的问题出在编码上。导入时如果中文全变问号先看文件是不是 GBK 编码被当成 UTF-8 读了。最稳的做法是另存为“UTF-8 带 BOM”几乎所有版本都能正确识别实在不行就转成 GBK但别两个文件混着导。字段映射那一步也别偷懒。日期字段要手工指定格式别指望自动识别——03/04/2024到底是 3 月 4 日还是 4 月 3 日程序猜错了不会报错只会在时间线上默默错位这种错误最难发现。4.2 中文、日期与区域设置乱码和时区偏移的根系统区域设置里有一个选项叫“Beta: 使用 Unicode UTF-8 提供全球语言支持”很多人为了折腾开发环境把它勾上了结果就是这类老桌面程序全面乱码。装这套软件之前务必确认它是关闭状态。# ACP 为 936 表示系统 ANSI 代码页是简体中文1252 或 65001 就要注意了 Get-ItemProperty HKLM:\SYSTEM\CurrentControlSet\Control\Nls\CodePage -Name ACP | Select-Object ACP # 看当前用户的区域、短日期格式日期解析错乱先查这里 Get-ItemProperty HKCU:\Control Panel\International | Select-Object LocaleName, sShortDate, sLongDateACP是 65001 就说明 UTF-8 Beta 被打开了去“区域设置 - 管理 - 更改系统区域设置”里把勾去掉重启。这一步改完之前导入失败的 CSV 往往重新导一次就正常了。sShortDate建议统一成yyyy-MM-dd。用dd/MM/yyyy的机器上导出的数据拿到MM/dd/yyyy的机器上打开时间线会整段错位而且不报任何错。多台机器协作的场景这一条比什么都重要。4.3 模板与工作区把配好的东西搬到另一台机器一台机器上配好的模板、自定义调色板、列布局、最近打开列表都存在用户目录下的应用数据文件夹里。要给第二台机器快速配好直接搬这个目录最快但要注意两点搬之前目标机器上的软件要先启动过一次保证目录结构存在搬的时候源端的软件要关掉不然文件正被占用。# 迁移用户配置/E 含空目录/ZB 断点续传/R:1 /W:1 出错只重试一次避免卡死 robocopy $env:APPDATA\产品配置目录 \\目标机器\C$\Users\目标账号\AppData\Roaming\产品配置目录 /E /ZB /R:1 /W:1 /LOG:C:\Temp\anb_cfg.log/R:1 /W:1这两个参数是我必加的默认失败重试一百万次、每次等 30 秒一旦碰到一个没权限的文件整个脚本就挂在那儿不动了。日志写到本地临时目录搬完翻一遍结尾的统计看“失败”那一栏是不是 0。工作区目录放.anb图表文件的那个不建议放在个人目录下。放在D:\i2Workspace这种固定路径好处是换人接手不用重新找文件备份策略也好写坏处是要提前把权限配好这点在第 2 章讲过。5. 常见问题排查装完打不开、许可掉线、渲染异常的五个现场下面这五条都是我在实际部署里反复遇到的按“现象 - 原因 - 解决”记遇到同类问题可以直接对号。现场一双击图标没反应任务管理器里进程闪一下就消失。原因基本是缺 32 位 VC 运行库程序加载阶段就退出了连错误框都来不及弹。查事件查看器的“应用程序”日志会看到一条应用程序错误模块名指向某个msvcp140.dll或vcruntime140.dll。解决就是把 2015-2022 的 x86 那套补上重启再试。如果补完还是不行再查是不是安装目录被杀软隔离了某个 DLL——这种情况日志里会写“找不到模块”。现场二启动报许可无效或者一直卡在“正在连接许可服务”。先按 3.2 的Test-NetConnection测端口。端口不通就是防火墙或网段的事别在客户端上折腾。端口通但还报许可无效多半是许可和主机绑定的信息变了——换过网卡、改过计算机名、或者虚拟机 clone 之后 MAC 地址变了。解决是重新走一遍许可申请把新的主机信息提上去。这条属于血泪经验克隆虚拟机之前一定先把许可释放掉。现场三CSV 导入后中文全是问号或者方块。先确认文件编码再确认系统 UTF-8 Beta 开关最后确认 ODBC 驱动位数。三者的排查顺序别搞反编码问题占七成系统区域设置占两成驱动位数占一成。乱码还有一种表现是“部分字正常部分字乱”那基本就是 GBK 文件里有 UTF-8 字符或者反过来只能重新导出。现场四关系图拖动卡顿、缩放出现白块。先在任务管理器里看内存和 GPU 占用。内存顶满就是图太大分批展开GPU 有占用但画面还是花就是显卡驱动。更新驱动之后如果反而更糟回滚到上一个稳定版别硬追最新。另外远程桌面连接下渲染异常是正常的这类程序在 RDP 会话里会退化到软件渲染别在远程会话里判断“性能有问题”。现场五改过的配置重启后又变回默认值。去%LOCALAPPDATA%\VirtualStore下面找有没有这套软件的目录有就说明写入被 UAC 重定向了。解决不是关 UAC而是把安装目录和工作区移到非受保护路径并给使用账号显式的修改权限。顺手把VirtualStore里那份残留删掉不然它会一直优先于真实配置生效像个甩不掉的幽灵。排查还有一个通用动作出问题第一时间抓日志别急着重装。安装日志在C:\Temp下前提是你加了/L*v运行日志一般在用户目录的应用数据文件夹里Windows 事件查看器的应用程序日志也值得翻。重装是最后一步不是第一步——很多人一遇到问题就重装结果把现场证据一起删了下次同样的坑还得再踩一遍。真要回滚顺序是控制面板卸载主程序 → 删掉安装目录残留 → 清掉%APPDATA%和%LOCALAPPDATA%下对应的配置目录先备份→ 重启 → 重新装。跳过清配置这步重装后大概率继承上一次的错误配置白忙一场。6. 验收用一份样例数据把“导入—分析—导出”走穿装完能打开界面不算跑通。我的验收标准只有一条用一份自己造的样例数据从导入开始到生成一张有关系、有时间线、有属性标注的图最后导出成图片和 PDF全程不报错、不卡死、中文正常。样例数据不用复杂几十行就够但字段要覆盖全实体名中文、类型、两个时间字段、一个数值字段、一组关联关系。用脚本生成比手写靠谱import csv, random from datetime import datetime, timedelta # 生成 60 条实体和 90 条关系覆盖中文、日期、数值三类字段 types [人员, 账户, 地址, 设备] with open(sample_entities.csv, w, newline, encodingutf-8-sig) as f: w csv.writer(f) w.writerow([实体编号, 实体名称, 类型, 首次出现时间, 关联金额]) base datetime(2024, 1, 1) for i in range(1, 61): w.writerow([ fE{i:04d}, f测试实体{i}号, # 中文名用来验编码 random.choice(types), (base timedelta(daysrandom.randint(0, 180))).strftime(%Y-%m-%d), round(random.uniform(100, 99999), 2) ]) # 关系文件两端实体编号 关系类型导入后用来验关联和布局 with open(sample_links.csv, w, newline, encodingutf-8-sig) as f: w csv.writer(f) w.writerow([源实体, 目标实体, 关系类型]) for _ in range(90): a, b random.sample(range(1, 61), 2) w.writerow([fE{a:04d}, fE{b:04d}, random.choice([通话, 转账, 同址, 共用设备])])encodingutf-8-sig是关键它写出来的是带 BOM 的 UTF-8能被绝大多数版本正确识别不加 BOM 的话某些环境会把中文读成乱码。日期统一用%Y-%m-%d避开斜杠格式的歧义。导入之后按这张表逐项过一遍每项都要亲手点一次不能只看界面有没有报错验收项通过标准不通过先看哪实体导入60 条全部入库中文名完整CSV 编码、字段映射的编码选项关系导入90 条关系全部匹配上无“孤立实体”告警实体编号是否有前导零被吃掉时间线日期落在 2024-01 到 2024-06 之间无错位系统短日期格式、字段的日期解析设置布局手动跑一次布局60 个节点 5 秒内完成内存占用、是否误开了实时布局条件格式按“类型”上色后颜色不串调色板配置是否被迁移覆盖导出导出 PNG 和 PDF 各一份中文不缺失字体是否嵌入、导出分辨率设置导出这一步最容易被忽略但它是唯一能证明“整条链路都通”的环节。字体没嵌入的 PDF 在别人机器上打开就是一堆方块自己的机器上看却完全正常——这种问题只有换台机器打开才能发现所以验收时导出完一定拿另一台机器开一次。我现在的习惯是每装完一台都强制走一遍这条链路哪怕只是给同事装个临时机器也跑一遍样例数据。有的时候是省事心理作祟觉得“装都装上了肯定没问题”结果一周后对方拿着乱码的图来找我回头查才发现是那台机器的区域设置里 UTF-8 Beta 开着。从那以后我每次装完都强制走一遍导入导出宁可多花二十分钟也不想再返工一次。随包的部署说明、许可申请模板和安装参数示例都在资源里按第 2 章的顺序对一遍环境再动手能省掉大半的弯路。希望帮到你。本文还有配套的精品资源点击获取