本文章记录了我自己遇到的问题及解决方法。
以下仅针对KKFileView4.0.0 官方版本。
文中提到的资源文件,网上都可以找到,实在找不到可以留言。
插件 – KKFileView(文件预览)
2.6.1 KKFileView安装
解压 安装包,进入bin目录 ./startup.sh 运行即可 端口8012
2.6.2 KKFileView 初始化
Bin目录下 ./startup.sh 会下载一些组件
2.6.3 使用方法及场景
在后端代码配置安装后的该服务地址即可,文件预览时候用。
2.6.4 常见问题
问题一
:安装完成之后启动logs日志遇到的错误:
启动出错找不到office组件,请确认’office.home’配置是否有误
原因 4.0版本linux依赖LibreOffice,需先下载(需要对应)LibreOffice_7.1.4.2_Linux_x86-64_rpm.tar.gz,,版本很重要
Ø 解压tar -zxvf LibreOffice_7.1.4.2_Linux_x86-64_rpm.tar.gz
Ø cd LibreOffice_7.1.4.2_Linux_x86-64_rpm/RPMS
Ø yum install *.rpm
问题二
:以上操作后依旧报错,安装环境变量。
1.自行安装Libre Office,以上第一条已写。
2.注册soffice命令
修改环境变量文件
vi /etc/profile
添加下面内容
export PATH=$PATH:/opt/libreoffice7.1/program
执行如下命令使环境变量生效
source /etc/profile
执行:soffice –version,成功返回版本号即表示已注册
问题三
:以上操作后依旧报错,尝试检查Libreoffice 安装是否完善。
1、/opt/libreoffice7.1/program/soffice –headless –accept=”socket,host=127.0.0.1,port=2001;urp;” –nofirststartwizard &
执行以上的命令查看office是否还缺少别的组件,缺什么就安装什么,安装完在运行,直到不缺了为止。
原因:无论是脚本还是手动安装的office组件都有可能不全。
dnf install xxx(缺少的组件名称)
缺少libcairo.so.2 运行 yum install gd
补充:如果组件下载不下来,去可以用的生产环境目录 /usr/lib64 下找对应的,Copy 过来。该方法很好用
问题四
:附上配置环境变量为固定目录的方法。
使用LibreOffice 用KKOFFICEHOME:default会找不到组件需要配置为{KK_OFFICE_HOME:/opt/libreoffice7.1/} 才能使用
文件目录为: ../kkFileView-4.0.0/config/application.properties
问题五
:如果以上操作完成依然报错。
排查office组件是否已经启动。
ps -ef | grep office
ps -ef | grep kk
将两个服务相关的进程都终止掉,再重新运行./startup.sh启动kkFileView 服务。
问题六
:文件预览不能实时查看,在线编辑修改过的的内容。
目前可采用修改配置文件的方式来解决。(浪费资源)
文件目录为: ../kkFileView-4.0.0/config/application.properties
修改自动清理缓存时间 0/5 * * * *?
cache.clean.cron = ${KK_CACHE_CLEAN_CRON:0 0 3 * * ?}
问题七
:预览乱码
字体问题
在centos上,使用如下命令进行安装:
yum install -y fontconfig mkfontscale
如果执行该命令有报错提示已存在安装包先,卸载掉再重新执行以上命令,卸载命令如下
yum erase xxxxxxxx(提示已存在的报名) -y
fc-list :lang=zh查看安装的中文字体
大部分Linux系统上并没有预装中文字体或字体不全,需要把常用字体拷贝到Linux服务器上,具体操作如下:
将Windows下的C:\Windows\Fonts 目录下的文件完整拷贝到Linux下的 /usr/share/fonts目录。然后依次执行mkfontscale 、mkfontdir 、fc-cache使字体生效