1、学习elasticsearch 源码,通过搜索“elasticsearch源码”,进行相关搜索。
2、因源码gradle编译,选择gradle-3.5可以编译通过,对应elasticsearch 5.5.0,其他高版本gradle可能编译不过,
编译源码时需注意这一点。
3、elasticsearch版本选择tag 版,tag为发布版,配置与代码一致。
4、依赖jdk版本为1.8,idea设置ProjectSetting Project jdk版本,以及gradle jdk版本,以及complie jdk版本
5、idea -Des.path.home=D:\source\elasticsearch-5.5.3 -Dlog4j2.disable.jmx=true -Dtests.security.manager=false
idea相关配置解决编译时各种报错。
以及主class配置、以及classpath of module配置。
5、jdk 1.8版本前几个版本jdk编译lambda存在bug,需要高版本jdk。
6、idea module配置是core_main。
7、module下jar采用对应发布版下module,里面为编译好的jar包。
8、编译时plugins文件夹要有内容运行时可以没有内容。
9、elasticsearch release版本下载链接 https://www.elastic.co/downloads/past-releases
可能遇到的异常
-
ERROR: the system property [es.path.conf] must be set
原因是没有指定es.path.conf,设置-Des.path.conf=你调试源码版本对应的conf目录
-
Exception in thread "main" java.lang.IllegalStateException: path.home is not configured
原因是因为没有为elasticsearch配置path.home参数,可以在Edit Configuation中设置虚拟机参数:-Des.path.home=你下载的对应的elasticsearch的安装目录,这么做的原因 是elasticsearch在启动中会加载一些默认配置以及插件,我们直接加载elasticsearch安装目录下的配置和插件即可,后面会在源码中体现
-
2017-06-23 14:00:44,760 main ERROR Could not register mbeans java.security.AccessControlException: access denied ("javax.management.MBeanTrustPermission" "register")
原因是因为elasticsearch在启动过程中使用到了jmx,我们这里禁止使用即可,配置也是在Edit Configuation中设置虚拟机参数 -Dlog4j2.disable.jmx=true
-
org.elasticsearch.bootstrap.StartupException: org.elasticsearch.bootstrap.BootstrapException: java.lang.IllegalStateException: jar hell!或Classname: org.elasticsearch.search.aggregations.matrix.MatrixAggregationPlugin due to jar hell
原因是因为elasticsearch中大量存在一个类或一个资源文件存在多个jar中,我们注释掉相应代码即可,主要是PluginsService中374行的JarHell.checkJarHell(union)以及 Bootstrap中220行的JarHell.checkJarHell(),最简单的方式就是将JarHell.checkJarHell()中的方法体注释掉
-
org.elasticsearch.bootstrap.StartupException: java.lang.IllegalArgumentException: plugin [aggs-matrix-stats] is incompatible with version [7.0.0-alpha1]; was designed for version [5.6.1]
原因是一般情况下我们调试的源码非某个发布版本,有些配置项并未发布,我们的配置与当前代码的版本匹配不上,这个时候我们需要将调试的源码设置成某个发布版本,一般来说,Elasticsearch每发布 一个稳定版本,都会有一个对应的tag,我们进入到ES源码目录下执行git tag, 我这里调试的版本为v5.6.1,所以执行git checkout v5.6.1,切换到v5.6.1tag.
参考链接:
https://bugs.openjdk.java.net/browse/JDK-8129589
待续。。。