升级MicroStrategy One后IIS部署Library遇404及日志缺失问题

一、优先排查isapi_redirect.dll本身问题 #

• 版本兼容性：MicroStrategy One可能配套了更新版本的Tomcat AJP连接器，旧版本（2021版）的isapi_redirect.dll大概率不兼容。确认dll是MicroStrategy One安装包自带的，或与当前Tomcat版本严格匹配（例如Tomcat 9对应1.2.48及以上版本的连接器dll）。
• 权限配置：
  • IIS应用池的运行账号，需对isapi_redirect.dll所在目录、Tomcat的temp/work目录拥有读写权限；
  • 给IIS_IUSRS组分配dll所在目录的读取权限；
  • 检查IIS的「ISAPI筛选器」，确认dll路径正确且已启用。

二、核心配置文件校验 #

1. workers.properties：
   • 确认Tomcat的AJP连接地址/端口正确（默认AJP端口为8009，需与Tomcat server.xml中<Connector protocol="AJP/1.3"配置一致）；
   • worker类型需设置为ajp13，确保转发协议匹配。
2. uriworkermap.properties：
   • 映射规则需覆盖Library的所有请求路径，例如/microstrategy/*=worker1或/*=worker1，避免请求未被转发到Tomcat。
3. isapi_redirect.properties：
   • 检查log_file配置的路径是否存在且有写入权限（例如log_file=C:\Tomcat\logs\isapi_redirect.log），路径无效或无权限会导致日志无法生成；
   • 可临时将log_level设为debug，开启详细日志输出辅助排查。

三、IIS配置细节检查 #

• ISAPI和CGI限制：必须添加isapi_redirect.dll的完整路径，并设置为「允许」状态；
• 虚拟目录/应用池：
  • 若用虚拟目录部署Library，物理路径需指向正确的MicroStrategy Library静态资源目录；
  • 应用池需设置为「无托管代码」，避免.NET环境干扰Java应用转发；
• AJP连通性测试：用telnet localhost 8009或类似工具测试Tomcat的AJP端口是否可连通，若不通则需检查Tomcat的AJP连接器是否开启（server.xml中对应配置未被注释）。

四、升级残留问题清理 #

• 删除2021版本遗留的ISAPI筛选器、虚拟目录等配置项，避免新旧配置冲突；
• 每次修改配置后，执行iisreset命令重启IIS，同时重启Tomcat服务，确保配置完全生效。

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