ThingJS-X环境迁移问题及对应方案

【首先注意：在迁移过程不能随意压缩解压缩迁移资源包，不同压缩软件或压缩方式，容易引起文件损坏！！！】

一、简介

使用ThingJS-X迁移时，操作如【图1】所示，也就是在“导出数据”和“导入数据”过程中出现的问题，此文将曾经出现的迁移问题列举整理，导致迁移问题的现象、原因、排查步骤以及解决方法。

     迁移涉及客户端（浏览器在哪哪就是客户端）、服务端（部署包在哪部署哪就是服务端）、数据库、及迁移文件还有客户端和服务端之间的网络几个要素。

     故现象、原因、排查步骤以及解决方法也会从几方面进行介绍。

     

为方便了解问题发生过程以及排查顺序，几个要素在迁移过程所在的流程节点如下面图所示。

二、问题发生的原因
2.1 迁出问题
客户端

    1.浏览器所在客户端电脑硬盘空间不足，导致迁出失败。

服务端

    2.服务所在服务端森X服务和文件权限不匹配导致导出失败；

      举例：服务端的启动用户为uinnova,非root,但导出的文件夹里有所属于root的文件夹,uinnova用户没有root文件的        权限。

    3.服务端硬盘空间不足。（当ES数据库在硬盘空间达到95%及以上时会锁定数据库此时无法进行操作）

    4.服务端内存不足。（将数据库文件及产品资源文件打包压缩成压缩包需要内存，内存不足时打包会失败）

网络

    5.网络超时，比如网速慢、比如网络路由中使用了第三方组件Nginx，Nginx超时。

2.2 迁入问题客户端

1.浏览器使用了谷歌翻译，然后在这个传统下导出迁移包然后在导入另一个环境。

服务端

    2.服务端硬盘空间不足。

    3.森X服务Java运行内存不足。

网络

    4.网络超时，比如网速慢、比如网络路由中使用了第三方组件Nginx，Nginx超时。

迁移文件

    5.迁移包不符合规则。

    6.迁移包太大。

三、同意排查和处理思路

1、检查浏览器版本比如，Chrome浏览器需要98以上，浏览器版本太低迁入后可能显示的页面样式有问题。

  检查方法：

  进入浏览器设置查看版本信息，不同浏览器不同以谷歌浏览器为例。

  

  解决方法：升级浏览器

2、检查迁移包大小

    一般迁移包太大发生在迁入过程，太大时导入时有如下提示报错，一般整个环境迁移包有2g+算大，其中模型文件对迁移影响较大一般有1g+算大。
   

   检查方法：

     一般整个环境迁移包有2g+算大，其中模型文件对迁移影响较大一般有1g+算大。

   处理方法：

     1、在迁出时分模块迁出，然后分模块迁入。大部分情况这种处理方式最简单，并且能解决大部分迁移问题。或者

     2、修改/uino/thingjsx-server/bin/start.sh文件，把-Xms -Xmx改大一点（两个值必须保持一致），改完重启森X即可

     

3、检查服务器/客户端的硬盘/内存空间相关信息：一般要求内存剩余空间大于等于2GB，硬盘空间使用率不超过85%。

Linux系统检查方法：

    a.检查内存使用情况：free -h，画红框部分free大于2GB一般说明处于安全状态

   

    b.检查硬盘使用情况：df -h，画红框部分已用%小于85%一般说明处于安全状态。

   

Linux硬盘满处理方法：

    参考FAQ:https://help.thingjs.com/hc/kb/article/1566171/,然后分别关闭森X服务，ES数据库，启动ES数据库，在启动森X服务。

Windows系统检查方法：

   a.检查内存使用情况：ctrl + alt +del 三个键一起按，点击任务管理器，空余部分大于2GB一般说明处于安全状态。

   

   b.检查硬盘使用情况：我的电脑，计算下使用率%小于85%一般说明处于安全状态。

   

  Windows硬盘满处理方法：

    清理磁盘空间,然后分别关闭森X服务，ES数据库，启动ES数据库，在启动森X服务。

4、网络相关（超时）问题，检查网络及网络相关组件

检查方法：

   此类问题一般伴随，在浏览器输入F12,观察console有

    a.time-out字样

    b.network error 字样  

    c.net::err_content_decoding_failed或net::err_failed 200 字样

    以报错net::err_failed 200为例

   

解决方法：

    a.对于Nginx超时。
       对于零代码平台修改Nginx配置如下，修改proxy_read_timeout 以及proxy_send_timeout 后面的数字。

      

    b.对于Tomcat超时。

       打开ThingJS-X系统的配置文件，路径如下下 :Thing-X\uino\ThingJSX\thingjsx-server\conf\application-system.properties设置超时时间，改大一些：

      

      比较方便的做法是两个都更改。

      特殊情况(发生频率很低)，森x前端接口配置的超时时间问题

      

      解决方法：

    需要修改/uino/thingjsx-server/src/main/webapp/auth/js目录下的chunk-vendors.xxxxx.js文件，搜索timeout，将timeout=36e5改为timeout=36e6后可以迁出。

      

5、检查权限

检查方法：

      一般权限问题发生在迁出过程，点击导出数据，界面会提示write out file error如下图所示，此时需要检查服务启动权限和文件权限。

     

检查森X服务启动权限和文件权限方法，如果两个图红框部分不匹配说明权限不一致，需要将权限变成一致，一般出现权限不匹配的背景是用root启动过森X服务然后又使用其他用户启动过森X服务，通常做法是重新用root方式启动森X服务。

a.检查文件权限。

    输入ll，红框内有root表示文件权限是root；

   

b.检查森X服务权限

    输入 ps -ef|grep thing；

   

处理方法：

    将文件和服务的用户权限变成一致，比较简单的做法是，使用root启动森X服务。

6、ES状态只读

    一般权限问题发生在迁入过程，点击导入数据，本来服务器中硬盘空间趋近于95%，然后此时继续导入数据，服务器硬盘空间很有可能超过95%，此时森X服务会停止运行，并且启动不成功，此时需要检查ES状态。

检查方法：

        - 查看健康状态 curl -u admin:Admin@123 http://ip:9200/_cat/health;

        -返回[FORBIDDEN/12/index read-only / allow delete (api)];

        说明ES状态为只读。
解决方法

        可参考FAQ“如何解决ES数据库只读模式问题”进行查询处理。