在线文档预览安装手册.docx
17页
文档预览安装手册系统环境：Windows Server 2016 64位（推荐）、2012 64位 或 2008 R2 64位(最低版本，不推荐)硬件配置：线上推荐内存8G或以上，如果预览量较大，推荐配置SSD硬盘一、安装和配置软件以下部分软件下载地址1. 下载并安装Microsoft Office 2016 64位（推荐）或Microsoft Office 2013 64位，office需要激活2. 安装公有软件：下载idocv_public_soft.zip压缩包，解压后将里面的idocv目录放到D盘或其他盘根目录，目录结构：D:\idocv\...3. 安装私有软件：将您购买的私有软件解压到D:\idocv目录下，目录结构：文档转换器：D:\idocv\converter\...WEB应用：D\idocv\docview\...4. 其他配置（可选）如需进行其他高级配置，如“受保护的视图”文档预览、设置上下文等，可参考附录注：a). 如您的操作系统是Windows Server 2012 64位或以下版本，可能需要额外安装：Visual_CPP_Redistributable_for_Visual_Studio_2015_x64.exe，如果安装出错，则可以选择安装低版本Visual_CPP_Redistributable_for_Visual_Studio_2012_x64.exe，选择低版本后，相应的apache也需要用低版本，可将D:\idocv\start.bat和D:\idocv\stop.bat脚本里的apache_2.4.41改为apache_2.4.10。
b). 如您的操作系统是Windows Server 2008 R2 64位，可能需要额外安装：dotnet_framework_4.5_x64和Windows6.1-KB2731284-v3-x64二、启动服务右键以管理员身份运行：D:\idocv\start.bat三、验证服务浏览器访问登录用户名/密码：admin/admin（注：线上环境建议修改默认用户名密码，可到D:\idocv\db\mongodb_x.x\db_init.js文件里修改，重启服务即可生效）点击“上传一个文档”，提示成功后在文档列表区点击刚刚上传的文档进行预览All done! Have fun :) 其他高级配置请参考以下附录附 录注：以下无特别说明，配置文件均为双击打开D:\idocv\setting.bat（盘符可能不同）Office设置（“受保护的视图”文档预览）用Office打开的时候提示“受保护的视图”的文档默认无法预览，如需预览，可做以下设置：打开Office（Word，Excel或PPT），选择 文件 -> 选项 -> 左侧“信任中心” -> 右侧“信任中心设置” -> 左侧“受信任位置” -> 右侧“添加新位置” -> 填写预览文件存储根路径，如：D:\ -> 勾取“同时信任此位置的子文件夹” -> 确定 -> 勾选“允许网络上的受信任位置” -> 点击左侧“受保护的视图” -> 分别取消勾选右侧三项“为来自Internet的文件启用受保护的视图”、“为位于可能不安全位置的文件启用受保护视图”和“为Outlook附件启用受保护的视图” -> 确定 -> 确定。
word、excel和PPT需要分别操作三遍）另外，部分客户可能设置网络共享存储或NAS存储作为预览服务的存储路径，以上方式无法将网络路径设置为受信任路径，这时可以尝试用修改注册表的方式来设置，参考：注册表设置有的时候打开xls文档时，会提示“文件格式和扩展名不匹配文件可能已损坏或不安全除非您信任其来源，否则请勿打开是否仍要打开它?”，默认情况下该类型文件无法预览，可以做如下设置：1. win键+R键，打开“运行”，输入regedit打开“注册表编辑器”2. 找到HKEY_CURRENT_USER\SOFTWARE\Microsoft\Office\15.0\Excel\Security，选中“Security”3. 在右边，右击鼠标，新建 - DWORD（32位）值- 名称改为“ExtensionHardening” - 值改为0这样设置后，此类文件就可以正常预览了Office设置（启动速度）如果office启动速度慢，可以参考以下链接进行设置：跨域上传通过ajax上传文档时，可能因为跨域限制无法上传，可做如下设置以允许跨域POST上传1. Apache设置编辑主配置文件D:\idocv\server\apache_*.*.*\conf\ httpd.conf，开启模块：LoadModule headers_module modules/mod_headers.so编辑vhost配置文件D:\idocv\server\apache_2.7.10\conf\extra\httpd-vhosts.conf，设置：Header set Access-Control-Allow-Origin "*"2. Tomcat设置编辑文件D:\idocv\server\tomcat_9.0.0\conf\web.xml添加以下配置：
添加上下文后预览URL格式为：http://host:port/previewIdocv/view/
有时候源url文件可能会更新，也就是相同的下载链接url但实际文件不同，这时可以配置只根据md5去重（配置thd.upload.unique=md5），如果需要，md5去重也可以取消（配置thd.upload.unique=none）当只根据md5去重时，预览服务每次都需要拉取原始文件并判断md5，对于大文件来说，有一定的性能影响，为避免出现该情况，url预览支持传入md5参数（md5参数可以是文件实体的md5值，也可以是您业务系统中的文件ID，只要确保相同的文件md5值相同，不同的文件md5值不同即可），例如：http://host:port/view/url?url=***&md5=***预览服务会优先判断预览链接中是否有md5参数，如果有就判断是否有相同md5的文件预览过，有就直接预览，否则走上面的去重预览流程，即最终去重预览流程如下：1. 判断预览链接中的md5参数；2. 判断预览链接中的url参数；3. 根据url参数获取文件，算出文件实体md5值，判断md5值；4. 新文件预览流程文件大小限制预览服务默认配置限制单个上传和预览文件均在20M以内，如您需要放大该限制，可以打开预览服务配置文件，修改如下参数：upload.max.size=20000000默认值适用于大部分情况。
如果您在局域网或可信环境中，确实需要预览较大文件，可以设置大一点，但尽量不要超过100000000，即单个文件尽量不要超过100M，以免给服务器造成较大压力Apache服务降级在少数低版本操作系统（如部分Windows Server 2008 R2 64位）中可能无法启动新版Apache服务，可能提示如下错误：httpd.exe – 系统错误无法启动此程序，因为计算机中丢失api-ms-win-crt-conio-l1-1-0.dll尝试重新安装该程序以解决此问题这时可以降级到旧版Apache，降级方式如下：1. 右键管理员运行D:\idocv\stop.bat停止现有服务；2. 安装3. 将脚本D:\idocv\start.bat和D:\idocv\stop.bat中的apache_2.4.34修改为apache_2.4.10；4. 右键管理。
