Powered by WebcatEE

1. 常见问题

1. 登录提示用户不存在。

请确保Java安装目录，Tomcat安装目录，应用目录的路径中不包含空格。

2. 登录提示系统错误。

某些服务器会有此情况，请更新最新版。

3. 用户登录之后什么也看不到

权限设置需要先为用户赋主机权限，再赋文件权限。主机名和工作空间名称必须是host.xml里面对应的主机名或者工作空间名。

4. 上传文件对话框没有反应

可能是用户没有相应的写权限，请使用admin登录后台为用户赋写权限。

5. 不能上传文件，右键菜单中的上传是灰色的

1. 首先检查启动Tomcat的用户是否拥有指定工作空间的写权限（操作系统的权限控制）；

2. 管理控制台，检查工作空间是否是只读的，如果是只读，任何用户都没有写权限（包括管理员）；

3. 管理控制台，确保对应的用户拥有该工作空间的write权限。

提示：上传文件支持拖拽上传，文件夹上传，截图可以使用Ctrl+V上传。

6. 集群环境配置成功，但是通过master访问不到其他机器上的文件

后台主机管理，请确保你填写的url是正确的。

重要提示：检查你是如何部署的，是否按照文档解压到了ROOT目录，如果没有解压到ROOT目录，那么请确保你知道什么是contextPath，如果不知道就老老实实的按照文档来，解压到ROOT！！！如果你比较懂，那么请随意！

如果你解压到了ROOT，那么finder的访问地址是：http://192.168.1.1/finder

如果你解压到了其他目录，那么finder的访问地址是：http://192.168.1.1/xxxx/finder，此处的xxxx就是你解压的目录名，这个就是contextPath。host.xml里面的url也应该这样填写。

7. 集群配置添加主机失败，目标主机访问失败

首先要确保填写的url地址是目标机上部署的finder的正确的访问地址，例如192.168.1.1这台机器是master，要添加主机192.168.1.2，可以使用浏览器先在192.168.1.1上访问部署在192.168.1.2这台机器上的finder，检查是否能访问到，如果访问不到，请先解决网络问题。

windows系统，如果tomcat端口号使用的不是80端口，那么请注意检查每台机器上的防火墙配置，一般系统默认开放80端口，其他端口会被防火墙阻止。

确保所有服务器使用的是相同的版本，新版新增了接口，老版没有这些接口也可能导致添加失败，最好全部升级为新版。

8. 中文相关

请设置TOMCAT_HOME\conf\server.xml文件，如下配置：


<Connector port="80" protocol="HTTP/1.1" connectionTimeout="20000"
    redirectPort="8443" URIEncoding="UTF-8" maxPostSize="1073741824"/>

URIEncoding：请求的URL参数编码集，请设置为utf-8。

maxPostSize：tomcat允许的最大post body大小，finder默认大文件分段上传每次上传5M的数据，此处配置须大于5M。

9. 帮助文档中文乱码

TOMCAT_HOME/conf/web.xml, 添加 fileEncoding 参数

修改完之后重启Tomcat，然后强制刷新页面或者清空浏览器缓存再次访问。帮助文档是静态页面，Tomcat默认会对静态文件做缓存设置。


<servlet>
    <servlet-name>default</servlet-name>
    <servlet-class>org.apache.catalina.servlets.DefaultServlet</servlet-class>
    <init-param>
        <param-name>debug</param-name>
        <param-value>0</param-value>
    </init-param>
    <init-param>
        <param-name>fileEncoding</param-name>
        <param-value>UTF-8</param-value>
    </init-param>
    <init-param>
        <param-name>listings</param-name>
        <param-value>false</param-value>
    </init-param>
    <load-on-startup>1</load-on-startup>
</servlet>

10. 大文件上传失败

参考上节设置 server.xml 中的maxPostSize

如果使用了Nginx，请检查nginx的client_max_body_size设置，请修改client_max_body_size设置。

也可以在FinderWeb的后台将上传的分片大小改为0.5M, 但是这样上传大文件会较慢，所以建议修改Tomcat和Nginx的设置。

11. 上传升级包失败

后台升级使用了分片上传，每分片1M，参考第7，8两节修改服务器配置。

12. 忘记密码

finderweb初始账号：admin 1234

普通账号：使用管理员账号登录管理后台，重置密码即可。

管理账号：如果忘记管理账号密码，请登录服务器，从安装包中找到admin.dat文件手动替换到程序目录即可。

13. less 403 not allowed.

默认情况下，只有log, txt, text, js, css, htm, html, xml, ini, conf等文件才会被认为是文本文件，允许使用tail, less, grep等功能。

管理控制台 - 一般设置，修改允许打开的文本文件类型。

14. 其他错误

最好从apache官网重新下载Tomcat，尽可能不要使用从其他地方拷贝的Tomcat，拷贝的Tomcat可能是被其他人改过各种设置的版本，Tomcat同样的设置在不同的版本含义可能是不同的，可能导致出现各种不可预料的错误。

15. finderweb和ELK的区别

这二者没有任何可比性，finderweb是个web文件管理器，就好象windows的资源管理器，只不过它是web的。finderweb的tail，less，grep功能可以理解为windows中的一种文件打开方式，仅此而已。

而ELK是个庞大的软件，集日志收集，日志传输，日志分析，日志查询等等功能，可以满足更多业务上的数据需求，而且在功能上跟finderweb没有重合的地方；规模上ELK要庞大的多，代码量上finderweb跟ELK不可同日而语；finderweb只是一个小软件、小工具，它针对的是有web操作服务器上文件的需求的用户，看日志仅仅是这个web文件管理器的一个附加功能，而且这个功能还是针对开发人员的，不是针对业务的。

16. 如何在登录界面不显示默认的用户名和密码

finderweb默认的用户名密码是: admin 1234, 为了方便新用户部署之后能够快速登录到系统，登录界面会自动输入默认的用户名密码。若要不显示默认的登录名和密码，请在 管理控制台 - 一般设置，将演示账号/演示账号密码置空即可。

2. Tomcat设置

1. 考虑到Finder的特殊性，可能与生产系统运行在同一台机器上，所以Finder本身尽可能的瘦身，减少第三方软件的依赖（第三方软件大多大而全），Finder本身只有2.5M，其中将近2M都是资源文件，主要是文件图标占用的体积大，静态资源会在Finder启动的时候全部加载到内存。Finder本身对内存的使用非常小，所以建议只保留足够tomcat运行使用的内存大小即可，tomcat的内存设置在：

TOMCAT_HOME\bin\catalina.bat文件中，请搜索JAVA_OPTS进行设置。

2. chrome浏览器在播放mp3的时候控制台报错: ERR-CONTENT-LENGTH-MISMATCH

原因是chrome太"聪明"，其他浏览器无此问题，请将Tomcat的connectionTimeout设置的足够大，不过一般建议忽略该错误。


<Connector port="80" protocol="HTTP/1.1" connectionTimeout="300000"
    redirectPort="8443" URIEncoding="UTF-8" maxPostSize="1073741824"/>


3. Linux上Tomcat启动慢的解决办法

有两种解决办法：

1）在Tomcat环境中解决

可以通过配置JRE使用非阻塞的Entropy Source。

在catalina.sh中加入java启动选项：-Djava.security.egd=file:/dev/./urandom


2）在JVM环境中解决

打开$JAVA_PATH/jre/lib/security/java.security这个文件，找到下面的内容：

securerandom.source=file:/dev/urandom

替换成

securerandom.source=file:/dev/./urandom

Powered by WebcatEE