记录hyperic-hq搭建开发环境遇到的坑

这个星期接到一个新的任务：解决HQ（一个用JAVA开发的开源的运维监控平台）如今遇到的snmp升级到3.0后bug。公司用的HQ是4.6版本。因而，我把项目从gitlab上clone下来后，就开始了个人填坑之旅。坑了几天坑，到目前，正常状况，应该只有最后一个坑了，应该是关于tomcat运行环境的。闲话很少说，开始填坑之旅……

项目maven build坑：

• maven版本必须为2.X版本的，3.X版本的maven，是绝对不会build成功的
• 切换到2.2版本的maven后，直接运行mvn clean install也是编译失败，各类尝试后，最终可以编译的命令为：
  

  clean compile install -Dmaven.javadoc.skip=true -DCI-build -Dall-installers -Dmaven.test.skip=true -e

  解释一下吧，用maven.javadoc.skip=true是由于项目中的注释，有太多太可能是不符合javadoc规范的，因此若是编译javadoc的话，会出现一推警告，而后编译失败。

• 由于上面不编译javadoc的缘故，因此在项目agent中，要把对hq-pdk项目的javadoc的依赖给去掉，否则这个项目也会编译失败，我把改后的文件对比放上来：

　　assembly.xml：

pom.xml

• 我也不知道什么缘由，在项目编译的时候，hq-pdk/src/main/java/org/hyperic/hq/product/validation/PluginXmlValidator.java 这个类老是会报异常，说代码异常出如今185行，是没法找到apache的log4j的一个类方法，如是我就把它给注释了，这块就不报异常了。

• 可能跟我用的是IDEA或者我用的是公司内网的maven库有关吧，项目hq-rendit的pom文件中的maven-eclipse-plugin插件也会编译不经过，因而我也把它给注释了：

• 在hq-server项目的pom文件，我加了一个plugin：

			<plugin>
				<groupId>org.apache.maven.plugins</groupId>
				<artifactId>maven-compiler-plugin</artifactId>
				<configuration>
					<source>1.6</source>
					<target>1.6</target>
				</configuration>
			</plugin>

 

OK，到如今为止，我遇到的maven的build坑基本差很少了。通过上面的改造后，个人hq项目可以install成功了。不过，install成功后，本地运行hq-web项目时，遇到的坑，深坑，比build过程要艰难的多，在这里我也记录一下，与君共勉。

 

hq-web 项目运行遇到的坑：

• 首先是要在你的user.home目录下新建一个文件，路径为：{user.home}/.hq/build.properties。关于这个，官方的github上的BUILD.txt也有说明：

    	Add the following properties to ~/.hq/build.properties to connect the schema installer, hq-web app, or integration tests to your DB:
        	server.database-url=jdbc:mysql://localhost:3306/hqdb
        	server.database-driver=com.mysql.jdbc.Driver
        	server.database=MySQL
        	server.database-user=hq
        	server.database-password=hq
        	server.admin.username=hqadmin
        	server.admin.password=hqadmin

• 运行web有两种方式，第一种是直接用tomcat-maven-plugin方式(tomcat:run)运行，这种方式运行我最后仍是由于运行的tomcat内存不足而抛出内存溢出而失败。因此下面我介绍怎样用本身下载的tomcat运行web。
  • 首先从官方下载tomcat，并在IDEA中配置这个tomcat。这个就不用介绍了
  • 运行tomcat:deploy maven命令，这个将会在hq-web项目的target目录下生成一个hq-web-4.6的目录
  • 打开IDEA的项目配置界面，切换到Artifacts界面，新建一个hq-web项目的Web Application:Exploded。并将output directory目录指向上面生成的目录。如：
  • 将配置的hq-web:war exploded 配置到tomcat运行中
  • 在运行以前，仍是要作几件事，起码我这里要作这些事情
    • 将mysql的驱动包（若是你用其余的驱动包应该也差很少），复制到tomcat服务器目录的lib目录下。由于个人tomcat （tomcat7）运行时，项目总会报找不到mysql驱动的异常，把驱动jar包拷贝到lib目录后就行了

    • 生成hyperic.keystore 证书的密码为：hyperic（记住，这个证书密码必须是这个，否则会出错），由于我是想进行项目的debug，因此我修改了源码中对证书路径的校验代码，让我能够指定证书的文件路径，经过jvm的运行参数：文件为：org.hyperic.hq.security.ServerKeystoreConfig:68

      • 　　

                    // ...make sure this exists
                    if (!keystoreFile.exists()) {
                        /**
                         * 添加keystore path的自定义参数路径
                         */
                        String keystorePath = System.getProperty("yiji.hq.keystore.path");
                        if(keystorePath != null){
                            keystoreFile = new File(keystorePath);
                            if(!keystoreFile.exists()){
                                throw new ConfigPropertyException("The keystore path [" + keystoreFile.getPath() + "] does not exist. If setting a relative path, it must be relative to the server's hq-server directory.");
                            }
                        }
        //                throw new ConfigPropertyException("The keystore path [" + keystoreFile.getPath() + "] does not exist. If setting a relative path, it must be relative to the server's hq-server directory.");
                    }

         

         

      • 可使用这个命令进行证书的生成

      • keytool -genkeypair -alias "test1" -keyalg "RSA" -keystore "test.keystore"

        
        
      • 配置tomcat的运行jvm参数，主要是指定证书路径以及tomcat的运行参数。都是必须的

      • -Dyiji.hq.keystore.path=/Users/QianL/Desktop/hyperic.keystore -server -Xms1024m -Xmx2048m -XX:PermSize=512M -XX:MaxNewSize=1024m -XX:MaxPermSize=1024m

         

我通过上面的折腾后，项目就能够经过IDEA进行tomcat debug运行调试了。

 

其实项目的坑远不止这些，不如若是使用tomcat插件运行的，还会报 sigar包找不到本地的动态库文件 和 找不到 hq-plugins 插件目录的异常，不过若是是经过我上面的那种运行方式，这两个以上我都没有遇到了。

 

 后面有时间我也把官方目前最新的HQ5.8的build 成功的经验写上来。