个人文档管理工具OpenKM安装设置及汉化过程

    为了更好地管理自己的文档（未必能坚持用下去啊O(∩_∩)O哈哈~），这几天比较了几款免费开源的文档管理工具。其中LogicalDoc安装很顺利，使用也OK，但是社区版的只能预览PDF文件，这就很不爽了。同时，也不具有字典、类别等功能，搜索方式较简单吧——初步印象。OpenDocMan似乎只是文档管理，没有预览功能。国产的几个，限制文件尺寸，不实用。OpenKM一开始尝试了一次，由于不是JDK1.8，安装失败，就放弃了；后来了解到OpenKM支持各种文档的预览，还有字段、类别等功能，甚合我意。折腾了一两天，算是弄好了吧。记录一下，算是小结。如果有问题，可以qq我（9609891）。

    说明一下，我只关心个人文档的管理，所以多用户、协同、共享等功能没有去关注。另外，需要把JDK降到1.8，否则拒绝安装。我是在1.14基础上又装了一个1.8，并把JAVA_HOME指向1.8，安装成功。后来发现，即是把JAVA_HOME再指向1.14，运行OpenKM服务后，java -version还是返回1.8，估计是被OpenKM改回去了。如果你必须用1.8以上的JDK，可能需要暂时停掉OpenKM，避免冲突了。好在可以多JDK版本共存，就是麻烦点。

    说说最后结果吧：安装完成，汉化了，支持中文路径，能够创建目录、添加文档，可浏览pdf、word、excel、ppt、txt、图片等文件（可自定义MIME），而且可以全屏预览（爽!）。这个预览实现方式是：把所有东西都转换为pdf，存到缓冲目录中，所以第一次预览时可能要等一下。OpenKM社区版的启动也不快。至于容量限制，根据网上的信息，社区版对仓库大小、用户数并无限制，但是规模增加后，性能可能会下降。OpenKM应该还支持OCR识别，还没试过。对文档还可以添加类别属性（然后就可以根据类别查看文档了——视图思想吧，很好的功能）、关键词（建立词典）。最后，OpenKM的迁移（到新电脑或新版本）还没机会尝试，就我现在的理解，应该不是问题——OpenKM主要就是数据库（MariaDB或Mysql常用）、Tomcat（和文档关系不大，主要是server.xml设置）和仓库，数据库和仓库复制一下应该就搞定了。

    书归正传，说一下安装过程：

1、安装MariaDB或Mysql（尽量用3306端口——缺省值；如需修改，去tomcat\conf\server.xml中搜3306）
2、创建数据库和用户
   进入数据库（通过命令行客户端），输入以下命令（创建的数据库名是okmdb，123456是用户openkm的密码）：

    CREATE DATABASE okmdb DEFAULT CHARACTER SET utf8 DEFAULT COLLATE utf8_bin;
    CREATE USER openkm@localhost IDENTIFIED BY '123456';
    GRANT ALL ON okmdb.* TO openkm@localhost WITH GRANT OPTION;
3、JDK必须是1.8.x。可保留原来的JDK，但需要设置JAVA_HOME=C:\Program Files\Java\jdk-1.8.x
4、下载安装包OKMInstaller.jar，https://sourceforge.net/projects/openkm/files/common/，

    选择或创建待安装目录（如d:\mydocmgmt\），把OKMInstaller.jar复制到这里

    进入命令行方式，cd到d:\mydocmgmt，运行java -jar OKMInstaller.jar

    安装期间，要输入数据库类型（建议mariadb或mysql），密码要与上面第2步部数据库的一致（如'123456'）；

    安装过程中会自动下载、解压（安装）：Tomcat、Extras、OpenKM（慢慢等），并安装OpenKM服务——可能需要手动启动服务
    缺省端口是8080，如果有冲突，可以在tomcat\conf\server.xml中修改
5、为了预览文档，安装LibreOffice（或OpenOffice）。

     其实tomcat\extras中有LibreOfficePortable和OCR工具等，但是我还是单独安装了一个
6、启动OpenKM服务，访问http://localhost:8080/OpenKM
    启动比较慢，尤其是第一次；
    用okmAdmin:admin登录
7、进行设置（预览文档、支持中文路径）

    点击上方最右侧的Tab（Administration），再点击其中的第二项（Configuration）
    找到并设置参数：   system.openoffice.dictionary        C:\Program Files\LibreOffice
                                    system.openoffice.program          C:\Program Files\LibreOffice\program\soffice.exe
                                    tomcat.connector.uri.encoding     UTF-8
8、汉化
    下载OpenKM_6_zh-CN.sql（https://www.openkm.com/wiki/index.php/Language_Packs）
    在Administration中点击Language（从右边数第四个，绿色的）
    在下方，选中sql文件，点击按钮Add new translation，得一会，出现zh-CN
    再回到Administration，还是点击Configuration（第二个），找到并设置default.lang    为    zh-CN
    退出，再次登录，在左下角选择语言为：中文简体

9、使用

    切换到文件公共桌面（desktop），公共文档，可以创建目录，添加文件，文件会保存到仓库（repository目录）下，但是不是原来的名字，后缀也没了。

    可以增加文档类别（自定义分类）、关键词（字典），并为每个文档设置其类别和关键词。

    点击预览，第一次需要等一下，文档会转换为pdf，存放到缓冲区（repository\cache目录下）——除了pdf，还有swf和dxf。

 

祝你顺利！