BIP高级版—常见问题手册高端客户成功事业部2023年文档修订摘要日期发布版本文档描述编写人2023/03/16V1.0创建基础组件:岳杏丽、张家媛、张帅系统组件：刘金伟、张帅中间件：王子旭、么贵敬、李德福数据库：王泓博、梁永升、冯建民友云音：张峰儒、周娟安全：郑健、曲晟整体方案：蔡平昕I版权©2023用友集团版权所有未经用友集团的书面许可，本文档描述任何整体或部分的内容不得被复制、复印、翻译或缩减以用于任何目的。本文档描述的内容在未经通知的情形下可能会发生改变，敬请留意。请注意：本文档描述的内容并不代表用友集团所做的承诺。II目录版权....................................................................................................II目录....................................................................................................III概述....................................................................................................11.基础组件........................................................................................21.1.Uclient...............................................................................21.1.1uclient安装...................................................................21.1.2uclient使用...................................................................21.1.3uclient迁移工作目录.......................................................31.1.4uclient替换apps和share目录.......................................61.1.5uclient常见问题.............................................................81.2.搜索服务器........................................................................101.2.1搜索服务器安装部署.......................................................101.2.2搜索服务器启停.............................................................121.2.3搜索服务器配置相关.......................................................131.2.4搜索服务器模糊搜索字长问题解决办法..............................171.2.5搜索服务器常见问题.......................................................181.3.文件服务器........................................................................191.3.1单服务文件服务器配置....................................................191.3.2集群文件服务器配置.......................................................191.3.3内外网文件服务器配置....................................................191.3.4文件服务器迁移配置.......................................................201.3.5文件服务器常见问题解决方案..........................................211.4.https................................................................................241.4.1安装部署......................................................................241.4.2启停.............................................................................401.4.3配置相关......................................................................411.4.4常见问题......................................................................42III2.系统组件......................................................................................452.1.sysConfig.........................................................................452.1.1sysConfig启动.............................................................452.1.2sysConfig配置介绍......................................................462.1.3部署.............................................................................522.1.4安全日志数据源.............................................................552.1.5专属服务器....................................................................562.1.6服务转发-UAP(Apache)集群...........................................572.1.7日志文件.......................................................................592.1.8系统配置.......................................................................602.1.9sysConfig查看日志......................................................612.1.10sysConfig常见问题....................................................622.2.NMC.................................................................................652.2.1NMC基本操作..............................................................652.2.2启停.............................................................................662.2.3NMC使用简介..............................................................672.2.4NMC常见问题..............................................................692.2.5NMC排查效率问题思路..................................................712.3.补丁部署要点&云巡检.........................................................752.3.1云管家打补丁................................................................752.3.2手工打补丁...................................................................772.3.3打补丁注意事项.............................................................792.3.4云巡检使用...................................................................803.中间件..........................................................................................823.1.中间件启停........................................................................823.1.1详细描述......................................................................823.3.2关键字..........................................................................823.3.3解决方案......................................................................823.2.中间件配置........................................................................843.2.1NC5系sysconfig配置..................................................84IV3.2.2NC6系sysconfig配置..................................................923.2.3NCC版本sysconfig配置...............................................953.3.日志获取...........................................................................983.3.1NC后台日志相关内容.....................................................983.3.2客户端日志如何获取.....................................................1033.3.3负载均衡日志（ihs、apache日志）..............................1043.3.4宕机日志的获取...........................................................1053.3.5spr日志获取...............................................................1093.3.6uap中间件日志...........................................................1143.3.7nginx日志.................................................................1153.4.宕机日志案例...................................................................1153.4.1NCC审批线程阻塞导致系统卡死....................................1153.4.2内存猛增导致宕机........................................................1173.4.3内存溢出导致宕机........................................................1203.4.4卡顿导致业务操作卡死案例分析.....................................1233.4.5缓存token导致NC65频繁宕机....................................1243.4.6堆内存耗尽案例分析.....................................................1253.4.7元空间内存溢出问题（进程高CPU问题）.......................1283.4.8ibm的jdk导致宕机.....................................................1323.4.9NC宕机问题...............................................................1333.4.10服务器cpu占用高导致宕机问题..................................1353.5.常见问题.........................................................................1393.5.1中间件无法启动类........................................................1393.5.2连接池类.....................................................................1433.5.3配置远程调试端口........................................................1443.5.4中间件日志类问题........................................................1473.5.5WAS中间件容器常见问题.............................................1513.5.6概要文件创建与删除类问题...........................................1663.5.7JDK、JVM操作类........................................................1683.5.8附件上传类问题...........................................................176V4.数据库........................................................................................1784.1.基础操作.........................................................................1784.1.1数据库启动方式...........................................................1784.1.2数据库关闭方式...........................................................1794.1.3数据库常用的系统表.....................................................1804.1.4连接数据库的常用命令格式...........................................1814.1.5数据库主要配置文件.....................................................1814.2.Oracle数据库日常维护操作...............................................1864.2.1查询表空间及数据文件信息...........................................1864.2.2查询数据库的连接情况.................................................1884.2.3查询数据库数据文件情况..............................................1884.2.4查询数据文件的io情况................................................1894.2.5查询redologbuffer的繁忙程度..................................1904.2.6查看等待事件..............................................................1914.2.7判断undo表空间的使用情况........................................1934.2.8查询数据库的字符集.....................................................1944.2.9查询sql执行计划........................................................1944.2.10如何执行数据库脚本...................................................1954.2.11如何dropoffline数据文件.........................................1954.2.12如何修改db_files参数...............................................1964.3.Oracle数据库表空间及文件管理........................................1974.3.1向表空间增加一个不自动扩展的数据文件........................1974.3.2创建一个表空间，增加一个自动扩展到最大值的数据文件..1974.3.3数据表空间文件迁移.....................................................1984.3.4修改redo日志的大小..................................................1994.3.6临时表空间迁移...........................................................2014.3.7控制文件迁移..............................................................2024.3.8重建及切换undo表空间...............................................2024.4.Oracle数据库常用备份方法...............................................2034.4.1逻辑备份导入导出的常用命令........................................203VI4.5.RMAN备份......................................................................2054.6.Oracle数据库常见问题排查...............................................2074.6.1如何初步判断数据库有问题...........................................2074.6.2如何获取排查数据库问题所需的日志..............................2084.6.3oracle无法启动..........................................................2084.6.4无法定位文件..............................................................2094.6.5内存参数设置文件.......................................................2094.6.6文件或块损坏..............................................................2114.6.7如何修改oracle系统参数............................................2114.6.8文件无法扩展..............................................................2124.6.9如何解决数据库用户被锁定问题....................................2124.6.10监听故障..............................................................2134.6.11.............................................................................ORA-121542134.6.12服务名无法解析.....................................................2144.6.13.............................................................................ORA-125182164.6.14....................................................................Listener无法启动2174.6.15...........................................................local_listener配置问题2194.6.16配置监听trace文件...............................................2204.6.17日志文件过大导致监听HANG.................................2214.7.达梦数据库（DM8）.........................................................2214.7.1基础操作....................................................................2214.7.2常用工具介绍..............................................................2244.8.PostgreSQL(华为PG).....................................................2294.8.1日常维护.....................................................................2294.8.2常见问题.....................................................................2304.9.Mysql数据库...................................................................230VII4.9.1启动mysql数据库.......................................................2304.9.2登入mysql数据库.......................................................2324.9.3mysql基础命令..........................................................2344.9.4mysql数据库备份与还原..............................................2454.10.阿里云polardb数据库......................................................2474.11.MSSQL...........................................................................2474.11.1建库脚本...................................................................2474.11.2内存修改...................................................................2504.11.3启动停止...................................................................2504.12.人大金仓.........................................................................2514.12.1概述.........................................................................2514.12.2数据库配置调整.........................................................2514.12.3建库脚本...................................................................2525.安全...........................................................................................2555.1.补丁部署.........................................................................2555.1.1打patch_1903BusinessAppServer命令执行漏洞补丁后，nc启动报错.........................................................................2555.1.2补丁文件检测错误:HostFilter.class,文件无Java源代码，安装后会始以后维护造成很大困难.还请加入源代码后继续安装.......2565.1.3打【NCC2105fastison漏洞补丁】后，登录报错：安全日志数据源异常，请联系环境管理员处理。....................................2565.1.4打【NCCLog4j反序列化漏洞方案NCC2005&NCC2105标准版本)V3】补丁后，安全检测报告中显示文件缺失.....................2575.1.565portal端打开单据报错，打了SP3安全增强补丁。......2585.1.6NCC2005，重量端报错：............................................2585.1.7安全补丁获取方式.......................................................2595.1.8安全补丁导致项目上用户签章失效.................................2605.1.9打补丁1903BusinessAppServer命令执行漏洞补丁，以后重启服务报错。.......................................................................2615.1.10打了安全补丁后客户签名图片都没了，这是跟哪个补丁有VIII关？2625.1.11打完补丁后portal端附件无法上传压缩包是哪个补丁的问题？2625.1.12...............................................NC6.x的要打什么版本的补丁？2635.1.13标红部分应该是删除还是这个是最新文件？...............2635.1.14..nc57的ActionHandlerServlet补丁，是不是不在云巡检里？2635.1.15打安全补丁后提示：抱歉，您请求的页面出错啦！这个是哪个补丁引起的？.................................................................2645.1.16打补丁【Apachelog4j1.x漏洞处理方案（方案）】后，启动报错。..........................................................................2655.2.云巡检.............................................................................2665.2.1安全补丁显示全部已安装，但是显示没有100分。且安全检测报告中存在乱码。.................................................................2665.2.2云巡检在测试连接的时候报错“解密异常”.....................2675.2.3上传体检报告报错........................................................2685.2.4云巡检显示补丁存疑.....................................................2685.2.5已经把之前的云巡检版本删除，服务端都是安装了3.4版本的，为什么还是提示版本不匹配呢？..............................................2695.2.6云巡检刚升级了一下，重新检测，日志显示拒绝访问？.....2695.2.7云巡检不会使用。........................................................2695.3.云管家.............................................................................2705.3.1打补丁提示：权限不够..................................................2705.3.2打补丁进度85%，卡在云平台补丁状态更新。.................2705.3.3补丁中java文件显示0kb.............................................2715.3.4云管家报错：补丁包格式校验失败：补丁文件路径：[nmcfastison漏洞补]/nmc/server/webapps/nmc/WEB-INF/lib/fastison-1.2.83.jar]不台法，补丁包根目录下只允许存在以下文件夹:..2715.3.5云管家报：该产品已过服务有效期，请尽快续费。云管家到期IX了，能申请免费试用吗？.......................................................2725.3.6补丁冲突是否可以直接覆盖？........................................2726.友云音........................................................................................2736.1.友云音安装部署................................................................2736.1.1环境检查.....................................................................2736.1.2租户申请.....................................................................2736.1.3安装部署.....................................................................2746.1.4配置相关.....................................................................2776.2.友云音部署检测................................................................2786.2.1Agent........................................................................2786.2.2服务探针.....................................................................2786.2.3客户端探针..................................................................2796.3.友云音启停......................................................................2796.4.友云音常见问题处理..........................................................2806.4.1【主机】显示已停止......................................................2806.4.2概览页面无数据...........................................................2806.4.3去除不可用实例...........................................................2816.4.4刚部署完，前台数据无显示...........................................2826.4.5告警消息频繁..............................................................2826.5.友云音基础使用................................................................2836.5.1业务操作分析..............................................................2836.5.2主机监控....................................................................2856.5.3JVM监控....................................................................2866.5.4实时采样....................................................................2876.5.5生成运维报告..............................................................289X概述本方案覆盖BIP高级版产品线基础组件、系统组件、中间件、数据库、安全、友云音技术领域，主要目的是为提高一线项目中解决问题的效率，减少基础性的问题从一线到区域再到总部的流转时间，对项目中经常遇到的高频和常见问题进行了疏理、归纳总结形成的技术顾问必备手册，内容涉及从安装部署、启停、配置，到日志获取、各组件常见问题解决方案等项目运维整个过程中的技术技能。使用时可以根据目录类别进行快速分类查找方案或使用关键字搜索定位方案。1/2901.基础组件1.1.Uclient1.1.1uclient安装关键字:uclient安装可以通过UClient官方网站http://uclient.yonyou.com/获取最新的客户端。下载完成后，确保uclient.exe所在文件路径无空格、特殊字符、中文字符等，双击即可启动uclient。1.1.2uclient使用关键字:uclient使用运行UClient客户端工具UClient.exe添加应用，在弹出的对话框中输入NC访问地址，如http://10.10.25.10:6699，点”搜索”，当应用服务器可用时，可添加搜索到可用的应用服务器，添加应用过程中，下2/290载运行NC所需资源。运行添加的NC应用,可访问NC。1.1.3uclient迁移工作目录关键字:uclient更改工作目录uclient工作目录默认在系统用户路径，如电脑系统用户名称带有空格或中文字符可能会导致应用无法登陆、报表无法打开等问题，需将工作目录迁移至无特殊字符路径。例如将工作目录迁移至D:\Ulient2目录。首先在对应路径下创建此目录3/290点击uclient界面右上角系统设置然后选择刚刚创建的Uclient2目录，点击确定。注意工作目录要选择一个空目录，一定不能选择磁盘根目录。4/290选择保存即开始迁移工作目录选择是后不要点击其他地方，如添加的应用较多迁移时间可能会比较长，请耐5/290心等待迁移完成的提示，如下图，点击是即自动重启uclient。uclient自动重启后再点击右上系统设置检查工作目录是否迁移成功。1.1.4uclient替换apps和share目录关键字:uclient更改工作目录、下载不了应用、应用添加不成功因网络原因导致某些客户端无法正常下载资源文件，可将正常的uclientapps、share目录复制到问题客户端工作目录下使用。首先找到一台正常使用的uclient客户端，找到uclient工作目录路径，可右键选择应用点击应用详情6/290点击安装目录自动弹出应用安装目录向上退两级目录即为工作目录将正常的uclient客户端下apps和share目录拷贝到有问题机器，拷贝前注意先完全退出uclient并删除有问题的uclient工作目录下的两个目录。7/2901.1.5uclient常见问题1.1.5.1增加客户端jvmxmx大小关键字:uclient白屏、卡死右键选择应用详情选择编辑模式8/290最大内存修改为4096解决问题：打开报表白屏、导入、导出白屏等数据量大时的白屏问题1.1.5.2调整嵌入/分离模式关键字:uclient白屏、卡死、进不去应用设置位置同1.1.5.1，选择分离模式后保存点退出编辑即可。9/290解决问题：个别客户端登录不了1.1.5.3个别客户端登不进去解决方案：修改客户端内存解决10/2901.2.搜索服务器1.2.1搜索服务器安装部署关键字:搜索服务器、部署、搭建NCCloud产品中的全文检索配置与以往NC6X系列的有所不同，搜索功能在NCCloud产品中已经默认运行自单独的搜索服务器上，与NCCloud的其他业务运行在不同的中间件上。下面是产品安装后，搜索服务器的配置和启动方法。1.NChome相关配置：如下图是NCCloud产品的安装目录：11/290图1NCCloud产品安装目录如图2，我们启动NCCloud安装目录下sysConfig配置工具，可以看到如下“专属服务器”的标签中已经默认勾选并启用了搜索服务器，并且通过“127.0.0.1：5550”这个IP和端口进行访问（也就是说不启动对应的搜索服务器根本不能提供搜索服务！）。图2搜索专属服务器在NChome中的配置信息搜索服务器的访问地址信息（地址和端口）也可以进行修改，比如NChome是水平集群的情况，我们需要把不同服务器上的NChome中的sysConfig搜索服务器访问地址配成同一个地址（不管应用服务器是单机还是水平集群，都只启用唯一一个搜索服务器），这种情况就不能简单的配置成127网段的地址，要配置多个服务器都能访问的IP地址。例如：应用服务器在192.168.1.1和192.168.1.2这两个服务器上，搜索服务器的服务器信息可以统一配成192.168.1.1：5550端口或者192.168.1.2：5550中的一个地址。（无论水平集群搭建在几个服务器上，搜索服务器都必须只选择一个启动，所以多个Home中sysConfig中的配置信息要完全一致！同时要注意，启动的搜索服务器要与配置的地址相符。也就是你配置的搜索服务器信息是192.168.1.1:5550，你就要在这个服务器地址上启动搜索服务器）12/2901.2.2搜索服务器启停关键字:搜索服务器启动、停止搜索服务器位置：目前在NCCloud产品中，搜索服务器不需要另外下载，默认在“home\microserver\SearchServer”目录下就存放了搜索服务器。搜索服务器启停方法：搜索服务器跟应用服务器目录结构相同，通过NC中间件进行启停并且只提供搜索功能的专属服务器（startserver.sh、stop.sh等命令进行启停，搜索服务器与应用服务器不同的是不能搭建集群或者用WAS中间件启动）。搜索服务器如何提供搜索服务：搜索服务器只负责根据数据源信息建立索引，然后提供给应用服务器的业务查询使用，应用服务器通过上一节中“sysConfig配置工具”中“专属服务器”标签中搜索服务器配置的地址信息访问搜索服务器，这个访问过程是代码根据配置的地址自动把搜索请求发到搜索服务器上的。注意：搜索服务器对于用户来说是无感的（用户不会访问搜索服务器的服务端口），搜索服务器也不关心应用服务器的结构（是否是集群等），它只是给应用服务器提供搜索服务。启动\NCChome\microserver\SearchServer\startup.bat（sh）停止\NCChome\microserver\SearchServer\stop.bat（sh）1.2.3搜索服务器配置相关关键字:搜索服务器、配置、安装（注意：以下搜索服务器相关配置，都在microserver\SearchServer\bin\sysConfig中配置）a.数据源配置：搜索服务器的数据源要与应用服务器数据源配置一致，可以通过拷贝${NChome}\ierp\bin\prop.xml配置文件到搜索服务器中${NChome}\microserver\SearchServer\ierp\bin\prop.xml的配置文件的方式得到应用服务器的数据源，但是替换文件的同时也会导致搜索服务器中其他信息也被替换13/290成应用服务器的信息，需要进行更正，包括服务器信息，IP端口号等。更正需要在搜索服务器中的sysConfig进行修改（${NChome}\microserver\SearchServer\bin\sysConfig.sh或sysConfig.bat）更正后如下图：（注意：一旦数据库进行了迁移，搜索服务器要跟应用服务器一样进行数据库更新，如果数据库名称改变了，还要在后续的“搜索源分组”标签中进行更新保存）图3搜索服务器服务器信息配置b.搜索源分组配置：配置好数据源以后就可以进行全文检索相关功能的配置了，搜索需要去数据库查询表信息，因此本节需要给每个支持全文检索的表配置数据源。如下图，左侧“搜索源分组”标签中，每个表中都需要选定数据源，点开每张表，然后点击“设置数据源”，为这张表配置搜索数据源，然后进行保存。14/290图4搜索源分组为每张索引表配置数据源c.搜索管理配置：本节为每张表选择索引信息更新频率，目前搜索服务器是实时更新数据库表的索引信息的，这里的配置是一个补充功能，可以在搜索更新发生异常时进行一定补救。也是要将每个表都点开选择更新频率（一般建议使用默认配置），然后保存。15/290图5搜索管理配置启动和停止搜索服务器：完成以上搜索服务器相关配置，配置好以后就可以启动搜索服务器进行数据表索引的建立和提供搜索服务了。我们通过运行搜索服务器目录下（microserver\SearchServer）的startup.sh(bat)命令启用搜索服务器，通过stop.sh(bat)停用搜索服务器，启用服务器之前如果搜索服务器目录下存在anteindex文件夹（表搜索需要的索引信息都在这个目录中），需要将其删除（删除anteindex文件可以删除旧的索引信息，进行新的初始化操作）再启动。搜索服务器索引文件介绍：启动后观察SearchServer目录下后再次生成anteindex文件夹，如图所示，进入此目录会发现有几个文件，其中“_history”文件夹中存放的是搜索服务器接收到的来自应用服务器请求的搜索内容，进入这个文件以后会有若干个txt文件存储搜索历史记录。“bd”开头的一些文件每个文件对应一个数据库表，这个文件里会存储这个表相关的所有索引信息。16/290图6搜索服务器索引文件介绍由于搜索服务器需要去数据库查询数据并在本地存储索引信息，是一个耗时操作，因此我们需要一个标志告诉我们什么时候搜索服务器可以完成索引建立的这个操作并且开始支持搜索功能。如图，我们在bd_customer文件中看到如下信息，bd_customer_table#1564535656754.stamp文件是一个时间戳文件，我们看到这个文件以后就可以知道这个“bd_customer”这个表现在可以提供搜索服务了。时间戳文件的修改时间会随着用户新增数据实时更新，stamp文件的修改时间表示该表当前支持搜索的数据的截止时间。例如：stamp文件的修改时间是15:30，那么15:32新增的数据就是还没有支持搜索。17/290图7每张表中的索引信息介绍搜索服务器异常处理：异常情况处理：服务器有可能会遇到宕机或者断网（连不上数据库服务器）的情况，这种情况下搜索服务器就没有办法实时去数据库更新表的索引信息了，这种情况需要停掉搜索服务器（注意是搜索服务器，不是NChome应用服务器，他们的启停解耦），然后删除搜索服务器的anteindex文件夹，再重启搜索服务器。这样可以恢复异常。更换数据源的情况：如果说客户环境更换了数据源，那么搜索服务器的配置也要更换数据源，并且修改搜索相关配置，一定要确保数据源与应用服务完全一致。然后保存配置，删除搜索服务器anteindex文件夹（也就是删除过时的旧的索引文件），然后重启搜索服务器，搜索服务器就会按照新的配置信息去更新后的数据源生成索引文件。1.2.4搜索服务器模糊搜索字长问题解决办法找到对应的配置文件，路径如图所示，将maxGramSize的值修改成为需要的长度即可。建议：搜索字长请不要过长，否则会占用大量的存储空间，降低搜索效率。一般建议不超过25.18/290修改完配置文件以后，需要对搜索重建索引。步骤如下:1.停搜索服务器(应用服务器不需要停)2.删除搜索服务器中anteindex文件夹3.重启搜索服务器，等待数分钟，上述的修改即可生效备注：ncc的话路径是ncchome/microserver/SearchServer/ierp/bin/searchmetadata1.2.5搜索服务器常见问题1.2.5.1nc...
