部署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配置一致。

<plugin>
    <groupId>org.codehaus.mojo</groupId>
    <artifactId>tomcat-maven-plugin</artifactId>
    <version>1.1</version>
    <configuration>
         <url>http://ip/manager/text</url>
         <username>tomcat</username>
         <password>tomcat</password>
         <update>true</update>
         <path>/xxxx</path>
    </configuration>
</plugin>

 其中，url指定远程Tomcat，path对应webapps中的具体路径。

2. 在conf/tomcat-user.xml中添加如下角色信息，以及具有这些角色的用户

<role rolename="manager-gui" />
<role rolename="manager-script" />
<role rolename="admin-gui" />
<role rolename="admin-script" />
<user username="tomcat" password="tomcat" roles="manager-gui,manager-script,admin-gui,admin-script" />

3. 有人说还需要修改Maven用户仓库路径下的配置文件（USER_HOME/.m2/settings.xml），本人没有改，也成功了（也写在这做参考）。该配置是本地maven仓库访问远程仓库时，需要配置的用户名和密码。

<settings>
    ...
    <servers>
        ...
        <server>
            <id>my-tomcat</id>
            <username>manager</username>
            <password>managerPwd</password>
        </server>
    </servers>

</settings>

参考：

1. https://stackoverflow.com/questions/16230666/failed-to-execute-goal-org-codehaus-mojotomcat-maven-plugin1-1deploy-default
2. http://tomcat.apache.org/tomcat-7.0-doc/manager-howto.html
3. http://www.cnblogs.com/xyb930826/p/5725340.html