部署Tomcat服务时,解决Cannot invoke Tomcat Manager 异常
最近,在使用Jenkins对工程一键部署的时候,出现调用Tomcat Manager 异常,对其解决方案特记于次。
异常信息
可能存在的异常:(1)Cannot invoke Tomcat manager: Error writing to server ;(2)Cannot invoke Tomcat manager: Connection refused: connect -> [Help 1]。
异常原因
经查询资料,安装Tomcat时,默认带着manager工程,其负责WAR包的部署等功能。由于使用manager需要账户与密码进行验证,所以如果没有配置账户与密码,就会报这样的异常。
但还存在这种情况,下边该配置的都配置了,但还会报这个异常,这时候需要你重启一下Tomcat,然后再部署。(原因是由于Tomcat的远程地址拦截器造成的结果,需要在/conf/Catalina/localhost/manager.xml中添加RemoteAddrValve属性,参考文献3)
解决方案
1. web工程的pom文件中添加的tomcat-maven-plugin插件,该插件用于将由maven构建的war包部署到指定的远程Tomcat容器,并配置账号与密码等信息,该账户密码需要与对应Tomcat的conf/tomcat-user.xml配置一致。
1 <plugin> 2 <groupId>org.codehaus.mojo</groupId> 3 <artifactId>tomcat-maven-plugin</artifactId> 4 <version>1.1</version> 5 <configuration> 6 <url>http://ip/manager/text</url> 7 <username>tomcat</username> 8 <password>tomcat</password> 9 <update>true</update> 10 <path>/xxxx</path> 11 </configuration> 12 </plugin>
其中,url指定远程Tomcat,path对应webapps中的具体路径。
2. 在conf/tomcat-user.xml中添加如下角色信息,以及具有这些角色的用户
1 <role rolename="manager-gui" /> 2 <role rolename="manager-script" /> 3 <role rolename="admin-gui" /> 4 <role rolename="admin-script" /> 5 <user username="tomcat" password="tomcat" roles="manager-gui,manager-script,admin-gui,admin-script" />
3. 有人说还需要修改Maven用户仓库路径下的配置文件(USER_HOME/.m2/settings.xml),本人没有改,也成功了(也写在这做参考)。该配置是本地maven仓库访问远程仓库时,需要配置的用户名和密码。
1 <settings> 2 ... 3 <servers> 4 ... 5 <server> 6 <id>my-tomcat</id> 7 <username>manager</username> 8 <password>managerPwd</password> 9 </server> 10 </servers> 11 12 </settings>
参考:
- https://stackoverflow.com/questions/16230666/failed-to-execute-goal-org-codehaus-mojotomcat-maven-plugin1-1deploy-default
- http://tomcat.apache.org/tomcat-7.0-doc/manager-howto.html
- http://www.cnblogs.com/xyb930826/p/5725340.html