简介：用友NC65安装操作手册是一份面向实施顾问及新手用户的原创实操资料，围绕用友NC65环境搭建的全流程展开，弥补官方文档零散、步骤不连贯的不足。手册从Oracle数据库安装入手，详细说明以管理员身份运行安装程序、设定全局数据库名与管理口令等关键环节，随后借助SQL*Plus创建NNC_DATA01和NNC_INDEX01表空间，创建用户并授予connect和dba权限，完整覆盖数据准备阶段。在NC65安装部分，依次讲解运行setup.bat选择产品、配置home目录，通过sysconfig.bat完成数据源及安全日志数据源初始化、部署EJB组件，启动系统后经admin.jsp配置编码与数据源，直至建库向导执行数据库安装脚本，并附有license激活特别提示，整套流程step-by-step呈现并强调易错点。资源打包为单个doc文档，大小933KB，内容紧凑便于查阅；目前已有3426人学习，适合自测或快速部署用友NC65及NCC高版本产品的读者，可有效降低环境配置的摸索成本。

1. 用友NC65安装到底在装什么：先想清楚这三层再动手

用友NC65的安装，最劝退的一点是：它没有一个“下一步到底”的安装向导。很多人从实施方拿到压缩包，解压后盯着十几个子目录发呆，卡在数据库字符集、中间件Profile、License机器码这些词上，一卡就是三五天。NC65的安装本质是三层：数据库（Oracle/DB2/SQL Server）存数据，中间件（WebSphere或内置中间件）当运行容器，NC65的应用包承载业务逻辑。三层之间靠数据源、JNDI和License文件串起来，任何一层对不上号，整个系统就起不来。这篇是自己编制安装操作手册时沉淀的笔记，适合实施工程师、企业IT和刚接手NC65的运维，目标是把“解压了但不知道下一步”带到“能启动、能登录、能交差”。

2. 安装前的环境准备：JDK、数据库字符集、中间件选型这么定

2.1 JDK版本与目录约定：先定版本再动手装

NC65对JDK的依赖比较“娇气”，不同小版本之间都可能有兼容差异。常见做法是装64位JDK 1.8，个别老版本对应JDK 1.6/1.7，安装前先跟你的安装包说明核对，别凭感觉下载最新版。另一个经验是安装路径不要带空格和中文，Windows下我一般直接放D:\Java\jdk1.8.0_202，Linux放/usr/local/jdk1.8.0_202，这个路径后面写脚本、改配置都要反复用，路径越简单越不容易出低级错误。

Linux下的环境变量配置，我一般这么写：

# 解压JDK到约定目录 tar -zxvf jdk-8u202-linux-x64.tar.gz -C /usr/local/ # 追加环境变量到 /etc/profile cat >> /etc/profile <<'EOF' export JAVA_HOME=/usr/local/jdk1.8.0_202 export PATH=$JAVA_HOME/bin:$PATH export CLASSPATH=.:$JAVA_HOME/lib/dt.jar:$JAVA_HOME/lib/tools.jar EOF # 让配置立即生效并验证 source /etc/profile java -version

JAVA_HOME必须指向实际解压目录，PATH把$JAVA_HOME/bin放前面，是为了防止系统自带的OpenJDK把版本带偏。CLASSPATH开头那个“.”代表当前目录，少了它后面跑一些诊断脚本会找不到类。验证时看java -version输出的位数和版本号，64位会显示Java HotSpot(TM) 64-Bit Server VM，如果跑出32位，安装NC65基本走不远——中间件内存一上来就崩。

Windows下设置环境变量我习惯用命令行，因为NC65相关的服务脚本经常要在管理员CMD里跑：

setx JAVA_HOME "D:\Java\jdk1.8.0_202" /M setx PATH "D:\Java\jdk1.8.0_202\bin;%PATH%" /M

setx的/M参数写入系统环境变量，新开的CMD窗口才生效，已开的窗口需要重开。这里有个血泪经验：setx写入PATH是整条覆盖，如果你的原PATH很长，可能被截断到1024字符，操作前先把原PATH值备份到文本文件。

2.2 数据库选型：Oracle为主，字符集和表空间是重点

NC65官方支持Oracle、DB2、SQL Server，国内项目十有七八是Oracle，下面以Oracle为例。选型不光是选厂商，还要定字符集。NC65在Oracle上最常见的字符集是AL32UTF8和ZHS16GBK，必须在建库前定死，因为建库后改字符集是伤筋动骨的事。

字符集为什么重要：Oracle数据库字符集、客户端NLS_LANG、NC65导入数据时用的字符集三者必须一致。我自己就见过一次“中间层和页面都正常，唯独从Excel导出的单据在报表里变问号”，查到最后就是NLS_LANG和数据库字符集不一致。所以不推荐搞花活，直接统一成AL32UTF8，生产库也抗折腾。如果条件允许，数据库服务器和应用服务器时区也一并对齐，避免单据时间显示差几个小时的诡异问题。

表空间的命名没有强制要求，但实施圈里习惯用NNC_DATA01和NNC_INDEX01，好处是后面看数据文件、做备份恢复时一眼能认出来。新建表空间和业务用户的SQL我一般这样写：

-- 创建NC65数据表空间，路径按实际数据文件目录改 CREATE TABLESPACE NNC_DATA01 DATAFILE '/oracle/oradata/ORCL/nnc_data01.dbf' SIZE 8G AUTOEXTEND ON NEXT 512M MAXSIZE 32G; -- 索引表空间，通常比数据表空间小一半 CREATE TABLESPACE NNC_INDEX01 DATAFILE '/oracle/oradata/ORCL/nnc_index01.dbf' SIZE 4G AUTOEXTEND ON NEXT 256M MAXSIZE 16G; -- 创建业务用户，密码带特殊字符时要用双引号包住 CREATE USER nc65 IDENTIFIED BY "Nc65#Passw0rd" DEFAULT TABLESPACE NNC_DATA01 QUOTA UNLIMITED ON NNC_DATA01 QUOTA UNLIMITED ON NNC_INDEX01; -- 实施阶段先用DBA权限把安装跑通，生产环境再按最小权限收缩 GRANT CONNECT, RESOURCE, DBA TO nc65;

SIZE给的是初始大小，AUTOEXTEND是自动扩展，MAXSIZE是上限。给8G初始是因为NC65初始化导入的数据量不小，太小会导致导入过程中频繁扩展，拖慢速度；MAXSIZE 32G是防止某天业务量上去把磁盘写满。密码建议带大小写和特殊字符，但要用双引号包住，否则Oracle会把密码自动转成大写，后面JDBC连接配置里的密码就容易对不上。表空间路径这里，Windows环境记得用反斜杠或正斜杠统一，别混用。

2.3 中间件选型：外置WebSphere和内置中间件的取舍

NC65有两种落地方式：外置中间件和内置中间件。外置最常见的是WebSphere，版本常见用8.5.5，也有项目用WebLogic，但用友官方对WebSphere的支持更成熟，排错资料也多。内置中间件是NC65配套的轻量化容器，部署简单，启动快，集群能力和管理界面都不如WebSphere。

我的选择逻辑：单机测试、演示环境、验证License用内置中间件，省事；生产环境、多节点集群、以后可能要上负载均衡的，老老实实外置WebSphere。两条路的安装差异主要在中间件这一层，数据库和应用部署的步骤是共通的。外置中间件的安装器（IBM Installation Manager）本身是个图形向导，按默认一路下一步就行，真正的门槛在创建Profile，这个在3.2节细说。

做决定时还要考虑一个现实因素：团队里有没有人会维护WebSphere。WAS日常要管Profile、节点同步、应用更新，如果没人碰过，上线后出一次问题就抓瞎。内置中间件至少logs目录清楚，重启脚本简单，小团队反而能少踩坑。按项目规模来选，别一味追求“生产必须外置”。

2.4 磁盘、内存与端口规划：安装前先列一张表

NC65安装失败有一小半是环境和端口冲突，而且这种问题报错往往不直观。我一般在动手前把下面这张表打印出来，逐项确认。

端口这块要特别注意：9060/9080/9443只是WAS默认值，如果机器上已经装了别的程序占用这些端口，创建Profile时直接报错。Linux下先跑netstat -tlnp看端口占用，Windows下用netstat -ano | findstr 端口。防火墙也要提前确认，尤其是中间层服务器和数据库服务器分机部署的场景，1521和9080的放行要两边同时检查，只放一半是“环境已通但应用连不上”最常见的翻车现场。主机名那行别小看，我见过有人把机器名改成带下划线的，结果License和节点同步同时出问题，前后折腾两天。

3. 数据库与中间件的安装：从建库脚本到WAS部署的最小操作序列

3.1 Oracle实例创建与NC65建库：字符集、监听、sys密码

如果DBA已经帮你建好Oracle实例，这一步可以跳过。如果是自己从零装，建实例时把字符集选成AL32UTF8，其他用默认。实例建好后，先确认监听在跑：

# 查看监听状态，确认服务名和端口正常 lsnrctl status # 输出里能看到 Service "ORCL" 有 1 个实例， # 如果报 TNS-12541 或 No listener，先起监听再往下走

NC65建库不是拿空库直接连，而是要导入用友提供的数据字典和初始化数据脚本。常见做法是先按2.2节建好用户和表空间，再用sqlplus以nc65用户执行安装包里的建库SQL文件。执行顺序别乱：先跑结构脚本，再跑初始化数据，最后跑和版本补丁相关的脚本。如果你的压缩包里只有应用包没有建库脚本，去跟提供包的人确认，不要拿生产库试错。执行脚本时打开日志输出，中途报错要停下来看，别等导入完才发现少了几张表。

数据库这层的验证标准就一条：用业务用户能连上，能看到表和视图。命令行验证最直接：

sqlplus nc65/"Nc65#Passw0rd"@//192.168.1.10:1521/ORCL SQL> select count(*) from user_tables;

能正常返回表数量，说明用户权限和数据导入没问题。如果连不上，先看是密码问题还是监听问题：ORA-01017是用户名密码错，ORA-12541是监听没起来，ORA-12514多半是服务名不对，这三个错误覆盖九成现场。另外提醒一句：数据库密码里的特殊字符在shell里转义很麻烦，先确认你的连接命令没被终端吃掉字符。

3.2 WebSphere安装与Profile创建：关键参数一次填对

WebSphere的安装器本身是个图形向导，按默认一步步走就行，悬念不大。真正的门槛在创建Profile这一步，很多人就是在hostName或nodeName上填错，导致后面部署时应用找不到目标服务器。命令行创建Profile我一般这样写：

/opt/IBM/WebSphere/AppServer/bin/manageprofiles.sh \ -create \ -profileName AppSrv01 \ -profilePath /opt/IBM/WebSphere/AppServer/profiles/AppSrv01 \ -templatePath /opt/IBM/WebSphere/AppServer/profileTemplates/default \ -nodeName nc65Node \ -cellName nc65Cell \ -hostName nc65-server \ -enableAdminSecurity true \ -adminUserName wasadmin \ -adminPassword 'Was#Admin123'

profileName是逻辑名，profilePath是磁盘位置，两者可以不一致但我习惯保持一致，少一个要记的参数。hostName必须填服务器能被反向解析的主机名，不要填IP，也不要带下划线，否则License和节点同步都会出问题。enableAdminSecurity开启管理控制台密码，wasadmin相当于WAS的管理员账号。命令跑完，访问http://服务器IP:9060/ibm/console能弹出登录框就算成功。

创建完Profile后，建议把WAS的JVM堆内存先调大，默认值对NC65来说太小，后面部署完应用一启动就容易内存溢出。管理控制台路径是“服务器>服务器类型>WebSphere application servers>server1>Java和进程管理>进程定义>Java虚拟机”，初始堆和最大堆改成1024和2048，具体数值按服务器内存来。这一步在图形界面里做，也可以后面用wsadmin脚本批量调，关键是别忘。

3.3 NC65应用包部署：ear包安装到WAS的步骤

应用部署可以用管理控制台图形操作，也可以写成脚本批量执行。图形界面不容易出错，适合第一次装；脚本可重复，适合后面升级或重建环境。我倾向于把关键的安装动作写成wsadmin脚本，至少环境重建的时候不用从头点一遍。

# 连接WAS管理控制台，端口默认8879，按实际改 conn = AdminControl.connect('nc65-server', '8879', 'wasadmin', 'Was#Admin123') # 安装NC65的应用包，contextroot决定访问路径 AdminApp.install('/nc65/deploy/app.ear', '[-cell nc65Cell -node nc65Node -server server1 -contextroot nc65 -appname NC65]') # 保存配置并启动应用 AdminConfig.save() AdminControl.invoke('AdminControl.completeTopicName', 'startApplication(NC65)') # 实际部署包文件名以你拿到的安装包为准，路径也按实际挂载点改

AdminApp.install的第一个参数是ear包完整路径，第二个参数里的cell、node、server指定应用装到哪个单元、节点、服务器上，这三项必须和3.2节创建Profile时填的对应值一致，填错会报“找不到目标节点”。contextroot决定访问URL是http://IP:9080/nc65还是别的路径，这个前后要保持一致，很多人在这一步栽了404的跟头。appname是应用在WAS里的显示名，后面启停应用、查日志都会用到。

如果版本要求在部署时绑定数据源，部署参数里还要带资源绑定部分，这取决于应用包是war还是ear、包里有没有写死JNDI。最简单的判断方法：装完去管理控制台看应用是否成功启动，报错信息里出现NameNotFoundException之类，基本就是JNDI没绑上，回到3.4配置数据源。

3.4 数据源与连接池配置：JNDI名称别写错

NC65跑起来以后，中间件要去数据库拿数据，全靠数据源。在WAS里数据源配置分三步：装JDBC驱动、建JDBC Provider、建DataSource。Oracle的JDBC驱动就是ojdbc6.jar或ojdbc8.jar，放到WAS的lib目录，或通过管理控制台上传。

数据源的关键参数就这几个，配置时逐项核对：

JNDI名称是应用和中间件之间的约定，NC65在sysConfig里也有一份相同配置，两边必须一致。我见过一个现场，WAS数据源配好了，sysConfig里填的JNDI多了一个后缀，应用启动正常但一点菜单就报“找不到数据源”，查了一天才发现是这个细节。所以配完数据源以后，进sysConfig核对JNDI名称，逐字符比一遍，这个习惯能省很多时间。连接池初始连接可以设1，最大连接数别一上来就设200，数据库端进程数没调大，连接池建起来反而把Oracle拖死。50左右起步，跑一段时间看监控数据再调。

4. 首次启动与License授权：从控制台到登录页的临门一脚

4.1 启动顺序：数据库、中间件、应用，一个都不能乱

装完之后最激动也最容易出错的就是启动。NC65的启动顺序有讲究：先数据库，再中间件，最后应用。数据库没起来就启动应用，应用会报数据源连接失败；中间件没起来就启应用，控制台里根本看不到应用状态。这个顺序看着简单，但分层部署时经常有人忘：数据库和应用在两台机器上，中间层服务器重启了，没检查数据库就直接启应用，报错半天才发现数据库服务没起。

Oracle的启动常规是监听先起，实例跟着起：

# 以Oracle用户执行 lsnrctl start sqlplus / as sysdba <<'EOF' startup EOF

WAS这边就是启动nodeagent和应用服务器：

# 先启节点代理，再启server1，顺序反了节点状态会不对 /opt/IBM/WebSphere/AppServer/profiles/AppSrv01/bin/startNode.sh /opt/IBM/WebSphere/AppServer/profiles/AppSrv01/bin/startServer.sh server1

每步做完都要看输出，别一把梭。startNode.sh跑完会打印端口和状态，startServer.sh最后会显示“Server server1 open for e-business”，看到这句话才算中间件这层就绪。用内置中间件的环境顺序也一样，先数据库后中间件，只是启动脚本换成对应的startup脚本。Linux下不放心还可以ps -ef | grep java确认进程在。

日志位置也要记下来：WAS的日志在profiles/AppSrv01/logs/server1/SystemOut.log，应用自己的日志在各自应用目录的logs下。出问题第一反应去看SystemOut.log的堆栈，比瞎猜快很多。

4.2 License申请与导入：机器码、授权文件、有效期三件套

NC65安装后还不能直接用，必须先过License这道关。第一次访问应用时，系统会生成一个机器码，这个机器码跟服务器的主机名、网卡、中间件实例都有关。常见做法是把机器码提交给提供软件的厂商，他们会根据合同生成对应的授权文件（一个.lic或类似格式的文件），拿回来导入。

导入方式一般两种：界面引导导入，或者放到安装目录的指定位置重启。我比较推荐界面导入，因为可以立刻看到导入结果和License有效期。如果你拿到的授权文件导入失败，先看提示，通常“机器码不匹配”是最常见的失败原因，说明当前机器码和申请时的不一致。

这里有个重要经验：License绑定的机器码和主机名强相关，安装完成后不要随便改主机名，不要动网卡配置，也不要改WAS的hostName。真到了必须改的地步，提前规划好重新申请License的时间，不然改完主机名系统直接不能用。重新申请流程通常要走一两天，项目验收现场卡在这里非常尴尬。

提示：装完系统第一件事就是把机器码、License有效期、主机名三个值截图存档，下次排查授权问题直接对照，不用重新生成确认。

4.3 浏览器访问与缓存清理：验证安装成功的三个标志

License导入成功后，用浏览器访问http://服务器IP:9080/nc65，能看到登录页。到这里，安装算成功了一半。我一般按三个标志依次验证：登录页能打开、能输入账号密码登录、登录后首页能正常加载菜单。

如果登录页能开但登录后白屏，优先怀疑浏览器兼容模式和缓存。NC65的登录页对老的IE内核有兼容要求，新装环境用Chrome内核的浏览器或兼容模式先试。缓存问题更常见：应用重新部署后，浏览器缓存里还是旧版静态资源，菜单点了没反应，用无痕窗口访问一次就能区分是缓存还是应用问题。页面如果直接报500，那就回到日志里找堆栈，通常是应用初始化和数据源这两类问题。

4.4 配置文件检查：sysConfig与关键参数核对

系统能登录只是第一步，想让NC65稳定跑，还要把sysConfig里的关键参数过一遍。sysConfig是NC65的配置工具，图形界面，主要配数据源、缓存、日志级别。这里的数据源配置必须和WAS里的数据源一致，尤其是JNDI名称，已经强调过，这里再核对一遍不亏。

除了数据源，sysConfig里还有几个参数值得关注：日志级别、临时文件目录、缓存大小。日志级别先设在“错误”，跑一周没问题再调成“警告”，全开“调试”会让日志文件一天涨几个G，小磁盘环境容易被打爆。缓存大小按服务器内存调整，内存只有16G就别往大了设，留一半给数据库和中间件。

配置改完，凡是涉及数据源和缓存的修改，都有可能需要重启应用才生效。有人在sysConfig改了参数觉得“保存了就行”，结果第二天发现没生效，心里骂系统是黑匣子，其实只是差了一次重启。所以养成习惯：改完配置，重启应用，再验证一次登录页，确认没有引入新问题。这一步虽然枯燥，但能让后面的稳定性少很多隐患。

5. 安装避坑：五个高频问题与排查路径

5.1 应用部署成功但访问404：先查Context Root再查目标服务器

现象：WAS控制台显示应用已启动，浏览器访问http://IP:9080/nc65报404。

原因：最常见的是contextroot填了别的值，比如填成nc或者大小写不对，访问路径对不上；另一个是应用没有部署到server1，部署到了别的server。

解决：先回管理控制台看应用详情里的Context Root，确认真实值；再确认应用的目标服务器是server1。如果两处都对，把访问URL改成和contextroot完全一致再看。这个报错很直白，按顺序排查一般十分钟内能定位。404还有一个隐蔽来源：Nginx或IIS前置代理把请求转发到了错误的端口，这种场景下中间件访问正常但外网访问404，要查代理配置而不是应用本身。

5.2 数据源连接失败，报ORA-01017或ORA-12514

现象：应用启动日志里出现数据源连接异常，错误码是ORA-01017（用户名密码错误）或ORA-12514（服务名不对）。

原因：ORA-01017几乎都是密码问题，数据库端密码带不带引号、JDBC连接串里密码大小写、以及中间层和数据库不在一个安全域导致的认证失败。ORA-12514则是URL里的服务名和Oracle实例的服务名不一致，比如实例是ORCL，URL里写成了orcl1。

解决：先用sqlplus用同样的用户密码手工连一遍数据库，排除数据库端问题；再检查URL的服务名和端口是否与监听一致；最后回到WAS数据源重新填入密码，保存后重启应用。WAS在保存数据源密码后，重启应用是常态操作，不用怀疑是自己点错了。

5.3 License导入显示机器码不匹配

现象：导入授权文件时报机器码不匹配，或者导入成功但登录页提示授权无效。

原因：应用生成机器码之后，服务器主机名被改过、网卡顺序变了、或者WAS的hostName被改过，都会导致重新生成的机器码和申请时不一致。

解决：先确认最近有没有改过主机名和网络配置。如果有，用当前机器码和厂商重新对一次授权；如果没有，把当前机器码重新提交，大概率是申请时复制漏了字符。这个问题的麻烦之处在于没有中间态，只能重新走流程。所以安装期间别动主机名，是最有效的避坑方式。

5.4 应用启动中途OutOfMemory或进程消失

现象：server1启动日志里出现OutOfMemoryError，或者启动到一半进程没了。

原因：WAS默认JVM堆太小，NC65应用加载大量类，堆一满就启动失败；如果装的是32位JDK，堆设置了也上不去，最多2G左右。

解决：按3.2节把JVM初始堆和最大堆调大，生产环境至少初始1024、最大2048起步，内存够就设4096。确认JDK是64位的，不是的话重新装并改JAVA_HOME。还有一个隐蔽因素：应用服务器的临时目录空间不足，WAS部署时要把应用包解压到临时目录，/tmp太小也会启动失败，清理一下就好。这两种情况在日志里的表现相似，先看完整堆栈再动手，别一上来就重装。

5.5 页面中文乱码或导出数据变问号

现象：登录页正常，但单据、报表里中文显示成问号或乱码，导出Excel后数字格式不对。

原因：数据库字符集、客户端NLS_LANG、应用连接串的字符集设置三者不一致。最常见的是建库用了ZHS16GBK，但应用侧按AL32UTF8连；或者客户端NLS_LANG没设置，默认用ASCII处理中文。

解决：统一三条链路：建库时定字符集，连接URL里明确字符集参数，客户端环境变量NLS_LANG按对应字符集配置。如果是已经在用的库，字符集不一致想事后纠正很麻烦，往往要导出导入一轮，所以最好在安装阶段按2.2节的做法规避。字符集问题一旦出现，先查这三处，比随机找答案靠谱。这块确实有些“玄学”成分，但七成案例都死在这三处不一致上。

6. 把“装上”升级为“能交差”：固化一套验证与维护清单

安装完成后，我习惯把验证动作固化成一张清单，直接写进自编的操作手册里。因为NC65环境不是装一次就完事，测试、验收、上线、扩容会反复重建环境，每次都从头想“该验证什么”太浪费。清单大致是：先检查六个进程（Oracle监听、Oracle实例、nodeagent、server1），再看两份日志（SystemOut.log、应用日志）有没有ERROR，最后过一遍登录、菜单、单据查询三个业务动作。这一套流程下来十五分钟，环境有没有问题基本心里有数。

维护习惯也要从第一天就建立。数据库的备份策略最晚在上线前定好，RMAN或逻辑导出至少跑通一次，别等到要恢复的时候才发现备份脚本从来没成功过。日志目录至少一个月清理一次，WAS和NC65的日志增长速度比你想象得快。License有效期记到日历上，提前两周走续期流程，我见过好几个项目是License过期当天才发现，业务全停，这种事故真的不值得。

我自己在多次安装里最深的教训是：每一步都别跳验收。字符集、主机名、JNDI三个点，哪次图省事略过，后面都要花更大的代价补回来。装完以后顺手把这些参数的记录留在手册里，下次重建环境直接照着填，比临时翻聊天记录问同事高效得多。把这套方法沉淀成你们自己的用友NC65安装操作手册，后面每个新人入场都能少走几天弯路，希望帮到你。

本文还有配套的精品资源，点击获取