EAS License实施支持指南.docx

1、EAS License实施支持指南EAS License实施支持指南1.License基本知识及使用指南1.1 重要概念packageName ：包名，在业务中是指每个业务功能所对应的全路径名。实际上具体是说当在EAS中打开一个界面时，每个界面都会有一个包名，此包名用来表明各个业务功能的归属和彼此之间的关系。申请License是根据包名所对应的模块来进行申请的。ModuleName ： 模块名称，一些相关业务功能组合在一起形成一个模块。此模块下面可能包含很多不同的业务功能包。模块和包的关系是1：n的关系。当每个界面申请license时，实际是申请对应的模块的license。Session ：

2、会话,一个Session代表一个客户端到服务端的链接。Session和ModuleName之间的关系是N-N的关系。尤其要注意一个用户在多台机器上登录的场景。License扣减原理： 客户打开一个功能界面-功能界面发送申请license请求-判断此界面的属性(是否无限制)-获取此界面对应的模块-判断模块的license数量-扣减模块的可用license数量-打开功能界面。（说明：站点数的计算以一个连接打开多少个模块来进行计算）1.2 新旧license策略比较 EAS License根据策略的处理可以划分为两个大阶段：5.2.0版本前：单个license文件，每个EAS服务器有且只能存在一个l

3、icense文件（server/deploy/目录下），没有正式license和试用license的区分。如果没有license文件或者license文件不正确，则认为是试用版本，试用期过期的判断和每个帐套相关，判断的标志是此帐套中总帐是否过三期，总帐过三期后所有的模块均不能使用，必须申请正式的license才能使用。此种策略控制方式存在着很多问题，由于EAS模块的独立性越来越来强，如HR人力资源模块，这说明我们EAS有能力满足客户分模块购买的需求的同时，也带来了新的问题没有购买总帐模块的不能有三期的试用期。5.2.0版本后：多个license文件，每个EAS服务器可以存在多个license文

4、件(通过管理控制台导入)，并且区分试用版本license文件和正式版本license文件。一些公用信息单独保存在配置文件中，灵活通过配置文件和多个license文件来进行各种license需求的管理。5.2.0版本的license管理兼容5.1版本的license文件。1.3 license文件的申请EAS安装盘中提供一个缺省的试用license文件，第一次打开管理控制台的时候会自动导入此试用版本的license文件，主要是满足急需安装EAS又不能马上申请到license文件的情况以及演示和试验使用。随安装包的license只作了时效的限制(初次导入3个月后过期)，模块包括了EAS所有的模块，

5、每个模块的站点数为3个站点（可能会有改动）。 如需某个模块更多的站点数或者需要申请正式的license文件，请直接到网站license申请页面进行申请。可以申请站点数更多的试用版本或者正式版本。如果对申请的要求和具体事宜有疑问，请直接联系总部生产部进行咨询。1.3 License安装说明EAS License安装： EAS520以前版本的license安装相对简单，直接将申请的license文件拷贝到服务端安装目录(server/deploy)下即可，无须任何其他操作EAS520以后版本的license安装，license文件由管理控制台导入，可以修改license文件（许可证）的名称（实际上

6、这是个别名），文件路径是指申请的license文件的放置路径，导入后统一复制一份放在/Server/server/deploy/licenses路径下。管理控制的license文件管理如图1所示。 图一导入license文件后检查特征码是否匹配，如果出现特征码不匹配的情况，管理控制台会给出相关信息。只有特征码匹配的license文件才能正确被license服务器识别。如下图图二所示： 图二选择每个license文件，会自动列出此license文件包含的模块名称，许可证数目，许可证类型，导入日期，过期日期等信息，如上图所示。License导入分两种情况。一种是在线方式导入，也即应用服务器没有停止

7、的情况下导入许可证，这种情况下license文件能立即启用，在license监控端刷新能看到license数目的变化（license监控请参看下文）。另一种情况是离线方式导入，即在应用服务器没有启动的情况下导入license，再启动应用服务器，这个时候license的启用状态还会是未启用状态，直到有客户端连接服务器，此时license服务器才会效验此文件是否能被启用，此时状态才会改变，属正确情况。（事实上这一列不应该叫“启用状态”，后续应该会改掉）License正式启用后会把第一次启用的时间纪录下来，以此作为许可证是否过期的判断依据，这里显示的导入日前与license的启用日期是没有关系的。L

8、icense的移除目前只支持一种方式即离线方式移除，只有停止了服务器才能在管理控制台移除此license文件，当服务器重启后，不会加载已经被移除的license文件。BOS工具BOSModular License安装：打开BOSModular工具，点击“帮助”菜单，出现如图三所示 图三继续点击“BOSLicense管理菜单”此处可以查看目前的license情况，如需要申请license，直接点击“申请”按钮按照界面提示进行申请和导入即可。1.5 License格式和注册限制：License文件区分试用版本和正式版本，试用版本是根据使用期限来进行管理，比如某个客户申请了一个包含凭证的50个站点,

9、使用期限为100天的试用版本文件，则从导入之日算起100天之后自动过期。正式版本license文件明确了过期日期，在过期日期之后自动过期。License管理存在如下一些限制条件和策略，请注意：每个服务器只能注册一个试用版本的license文件每个服务器只能注册一个520以前版本的license文件(兼容考虑)相同一份license文件只能注册一次只有机器特征码匹配的license文件才能注册成功只有存在有效license模块的文件才能注册进服务器 过期的license文件不能被注册错误格式的license文件不能被注册手工修改了的license文件不能被注册只有 License初始化时间机器系

10、统时间安全管理license监控，有基本信息、占用明细、使用情况三个菜单项。基本信息记录的license的服务器地址、授权模块的模块编码、别名和授权许可证数目等信息，如图2所示。图2其中讴，刷新EAS包配置为重新载入eas license的配置文件(注意：只是在配置文件被修改了情况下才需要做此操作)。在控制台导入新license文件后，在基本信息页签刷新模块和站点数都应该能反应出变化。呆滞时间上限设置设定用户被允许的最长呆滞时间，图3。图3连接到服务器的用户可用在占用明显里看到，其中就有每个用户的呆滞时间记录，当用户的呆滞时间到了呆滞时间上限后，此用户占用的license会自动被释放掉。图4。

11、图4在使用情况页面可以监控到每个模块的license使用情况，如图5。图5License手工释放：管理员可以在license的3个监控页面中可以根据各种条件手工释放被占用的模块license，根据模块释放模块所有被占用的license，根据用户释放此用户占用的所有license，根据用户和模块释放此用户占有的该模块的所有license。注意：释放license并不会对用户的使用造成任何影响，只是当用户重新做业务功能操作的时候会重新去申请license。如下图所示：2.解决license问题思路由于License服务是后台服务，所以不会有一些很明确的信息抛出到客户端，所以出现了license相关

12、的问题，只是会记录日志到服务器日志文件和客户端日志文件中(后续会加强)，首先请查看“应用服务器日志和客户端日志(客户端安装目录/logs/log4j.log)”,并在其中搜索“license”字样查看具体错误信息，此错误信息是解决判断license问题的基准（5.3版本在客户端出错界面详细信息中提供了出问题的包名和对应的模块名，可以直接获取此信息并进行判读）。如不能从日志中明白是什么问题，请检查如下点：1申请的license文件是否是EAS的license文件，经常发现用户将BOS工具的license或者apusic的license当成EAS license使用，肯定是有问题的。判断方法：用文

13、本编辑器打开申请的license文件，如果第一行为kingdee eas for j2ee则表示是EAS的license文件。2申请的EAS License文件的特征码是否和当前机器匹配，目前特征码是根据ip进行加密生成的，需要判断此license文件是否和机器匹配。在520以后的版本中通过管理控制台导入时都可以看到此信息。3是否正确导入了license文件，查看管理控制台是否有有效的license被启用了(状态为启用)，同时用管理员登录进出查看license监控信息是否有有效license模块和站点数。经常碰到客户未导入license而导致所有的业务功能不能用。4.检查是否修改过系统日期，目

14、前license的判断是如果修改了系统日期，重新改回以前的系统日期时license会失效，这点请注意。5.检查license文件是否过期，在管理控制台可以查看过期日期和导入日期，查看是否是由于license文件过去导致业务功能不能使用。6.检查是否手工修改了license文件，license文件不能被人为手工修改，如果修改了里面信息，会导致license效验失败而导致license文件失效。7.检查“服务端安装目录（server/deploy）是否存在“easlicense.config” 文件，如不存在此文件，则从标准安装包中拷贝一份放置此目录即可。3.常见问题解答1、EAS5.1及以前版本

15、升级到5.2之后，以前的功能都提示缺少License许可？原因和解决方法：由于EAS5.1以后License文件格式做过重大更新，因此license文件无法从5.1以前版本自动升级到后续版本，请重新申请新版本license。2、EAS5.1.1及以后版本升级后也提示缺少License许可。 原因和解决方法：这种问题基本上都是原始License文件未导入的缘故，从EAS5.2开始，License文件支持多份License同时生效，因此在管理控制台提供了EAS License许可的导入功能。当出现上述问题的时候，请首先在管理控制台中查看License许可证，默认情况下会自动将安装包中的试用Lice

16、nse导入，因此能看到有一条License文件记录，请通过”导入“按钮导入以前的License文件，正常情况下应该可以在管理控制台中看到新导入的License文件信息。导入的同时，系统会将该License文件拷贝到EAS的deploy/license/目录下。3、已按要求导入License，但是模块仍然提示没有License许可 原因和解决方法：出现这种情况，请使用Administrator登录EAS，在License监控功能中查看目前具有哪些模块的许可，由于EAS本版存在部分原有免费模块开始收费的情况，因此有可能是因为这种原因造成无法使用。或者是对标准产品进行了调整导致映射到的模块在原有的l

17、icense许可文件中不存在，这种情况请单独申请这些模块的License。具体模块信息请参考发版说明。4、已经按要求导入，但是部分二次开发模块提示缺少License许可 原因和解决方法：从EAS 5.2开始，为保护二次开发功能，对二次开发模块都采用了License控制机制，其原理是凡是不属于EAS出厂默认功能配置部分都属于二次开发模块，统一验证CUSTOM二次开发License。该模块License可由分公司向生产部申请，此模块申请免费，分公司提交申请站点数即可。试用License中CUSTOM模块默认有30个站点数，因此在申请License期间可以先通过该试用License保证客户的正常使用

18、。5.客户进行大批量的二次开发，但发现没有占用二次开发的license许可，而是占用了标准产品某个模块的许可数目，为什么会出现这种情况原因和解决方法：二次开发模块的控制见上条描述。出现此问题的原因是客户二次开发的时候将二次开发的内容放置到了EAS标准产品某功能模块的包下面，因为EAS是根据包名进行license扣减的，同时标准产品的功能模块都已经映射到了具体的模块，这样就会导致直接扣减标准产品模块的许可数目。解决此问题直接将客户开发的包移动到客户自己目录，不要挂在标准产品的目录下面即可。 6、有正式License，但系统仍然显示 “演示版” 原因和解决方法：请确认是否已将正式License文件

19、导入，参考问题2的说明，并在license监控中查看是否有标志为“正式版”的模块。7、使用的是试用License，但某天突然不能用了，试用的license许可有什么约束？ 原因和解决方法：试用License是为保证给客户试用及演示，其约束条件为：其中每个模块都有2个站点数，试用时间为90天，从导入该License起计时，一个系统中只可能同时拥有一份演示版License。8、系统有两个license文件，试用license文件每个模块2个站点，正式license文件20个模块，每个模块50个站点，为什么在监控中有些模块是2个站点，有些是50个站点，试用License与正式License有什么关系

20、？ 原因和解决方法：某个模块如果有正式License许可的情况下，只会使用正式License的许可数，试用License的2个站点数无效。否则将使用试用License的站点数，受试用条件的控制，即试用版本license和正式版本模块站点数不能进行叠加。9. 在EAS中点击某一个功能菜单，会出现“您没有有效的许可或试用过期” 的提示并且不能进行业务操作原因和解决方法: 未正确放置license文件,模块未能使用 license未正确导入 license文件本身问题,未包含正确的模块映射关系(此需反馈给总部处理) license文件被手工修改导致的错误 不正确的license文件,特征码不和机器不

21、匹配请查看license问题解决思路段落描述。推荐解决方法：首先使用控制台检查功能检查License文件是否正确，然后查看license监控页面，查看license信息是否正常，最后检查客户端和服务器日志进行分析。10在管理控制台导入license，界面显示此license为未启用状态 原因和解决方法:license文件的特征码和本机器不匹配，此时会显示特征码不匹配并且不能被启用 如果是在线方式导入的则是license里面模块过期，效可用的模块的数量为0 或者license文件过期离线方式导入的license，导入后不会进行有效性的检查只有在服务器启用并且客户端进行访问的时候才进行效验，此时刷

22、新界面应该可以看到正确状态。建议解决方法：查看服务器错误日志，查看license监控里面的信息是否正常。 11.在管理控制台进行导入和删除操作，详细信息里面有rpc error：server restarted字样原因和解决方法:管理控制台的bug，在导入过程中如果重启了服务器会出现此问题，522版本已经修复，如果出现此问题请重启管理控制台重新进行导入即可。12.在管理控制台导入license许可，始终导入不进去，报错信息类似与Caused by: org.jdom.input.JDOMParseException: Error on line 8 of document file licen

23、sefile.xml原因和解决方法: 读写licensefile.xml文件出错，license管理文件被认为损坏或者其他原导致文件不全或字符编码出现问题。出现此问题直接清空licensefile.xml(server/deploy目录)文件内容，只留下根节点，然后停止服务器和管理控制台，重新离线导入license。13. 在BIM工具中启动服务器和客户端，在登录EAS客户端后，进行业务操作的时候出现无license许可的情况，不能进行任何业务操作。原因和解决方法：出现此问题原因有两个：1.解决方案是从另外机器直接拷贝过来，BIM新建解决方案和导入解决方案都会导入license文件并会自动配置

24、服务器加载license文件的路径,如果是直接从别的机器拷贝过来的解决方案，此时并不会自动部署license加载路径，使用的还是另外机器上的配置，此时加载不到license文件导致业务功能都不能使用。此种情况下需要手工修改license文件的路径信息，请切换到解决方案目录deploy目录下，此目录下有个licensefile.xml文件，用文本编辑器打开，修改节点的uri字段指向正确的路径即可（一般是解决方案deploy目录/licenses目录下）。2.可能是license文件过期导致的，BIM默认自带的license文件期限为1年，首先请检查license路径是否正确，如1所描述步骤，如没

25、有问题则切换到BOSModulaer工具的的安装目录下的boscommon/eclipse/plugins/com.kingdee.bos.bim_5./configTemplet目录下，copy文件license文件到解决方案的deploy目录覆盖同名文件即可。14. EAS客户端不能登录，一直停留在检测更新画面，服务器报了一个license错误，原因和解决方法：出现此问题是由于使用了试用版本的apusic服务器，试用版本的apusic服务器只能同时允许5个用户在线，超过5个会使用不了一直停留在等待状态。请联系apusic公司申请更多的license许可即可。15.导入license的时候出

26、现错误提示，一致导入不了，错误信息类似于Caused by: java.lang.Error: kingdee eas for j2ee cant found in /kingdee/eas/server/deploy/licenses/license原因和解决方法：原因是导入的此license文件格式不正确，并不是EAS的license文件，或者被手工修改了，请检查license文件的格式，用文本编辑器打开查看第一行是否是kingdee eas for j2ee。16. 在进行业务功能操作的时候出现如下类似错误，导致业务功能都不能操作，错误类似于com.kingdee.eas.base.li

27、cense.LicenseException: Parameter user is null原因和解决方法：EAS客户端启动的时候没有加载license的服务导致的，已有相应的补丁进行处理，请联系总部基础开发组。17.license加载的过程中出现异常，服务器检测到license错误日志，错误信息类似于：ERROR at com.kingdee.eas.base.license.server.ormrpc.LicenseSrv._$4(?:?)没有合法的license文件或者license配置文件被损坏原因和解决方法：license文件格式错误或者easlicense.config文件被修改或

28、不存在，请检查上述文件的正确性。18. 在license装载的过程中出现如下异常：java.lang.NumberFormatException: For input string: .原因和解决方法：可能用到了510以前版本的license文件，新版本的license处理程序解析不了510以前版本的license许可文件，请确认版本信息并联系总部进行升级。19.为什么打开系统参数等界面会占用很多模块的license原因和解决方法：目前在生成子系统树的时候也会进行license的检查，此时也会扣减相应模块的license站点数，后续可能改进。20.昨天系统所有功能还能正常使用，今天突然不行，请问是什么原因原因和解决方法：两个原因：1.是否修改了系统时间，如果修改了系统时间又改回以前则会导致license文件失效 2.是否是license文件过期了，请用管理员帐户登录EAS系统查看license基本信息效验是否正确。