记录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插件也会编译不通过,于是我也把它给注释了:

记录hyperic-hq搭建开发环境遇到的坑_第1张图片

  • 在hq-server项目的pom文件,我加了一个plugin:
复制代码
			
				org.apache.maven.plugins
				maven-compiler-plugin
				
					1.6
					1.6
				
			
复制代码

 

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目录指向上面生成的目录。如:
    • 记录hyperic-hq搭建开发环境遇到的坑_第2张图片
    • 将配置的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 成功的经验写上来。

你可能感兴趣的:(JAVA,监控,运维,监控,运维,HQ,Java)