ubuntu 16.04搭建OpenGrok

//查看当前ubuntu系统版本

$ cat /etc/lsb-release
DISTRIB_ID=Ubuntu
DISTRIB_RELEASE=16.04
DISTRIB_CODENAME=xenial
DISTRIB_DESCRIPTION="Ubuntu 16.04.6 LTS"

在Ubuntu 16.04.6安装opengrok

1.下载并编译universal-ctags

如果没有安装git, autoconf，先安装

sudo apt install git autoconf

不要再使用 Exuberant ctags，因为已经不再维护更新，对于新版本的Opengrok支持度不好，给代码建立索引时，要使用到universal-ctags工具，但是一般通过apt-get安装的都是exuberant-ctags，所以要先删除原有的ctags版本，然后安装universal-ctags.

sudo apt-get remove --purge exuberant-ctags

下载并编译universal-ctags
参考：https://github.com/universal-ctags/ctags

To build with Autotools (Autoconf, Automake, and Libtool) on GNU/Linux, OSX, or Windows 10 WSL,

  $ git clone https://github.com/universal-ctags/ctags.git$ cd ctags$ ./autogen.sh$ ./configure --prefix=/where/you/want # defaults to /usr/local/bin/ctags$ make$ make install

安装好后 ctags --version查看版本信息，说明安装成功

$ ctags --version
Universal Ctags 5.9.0(80753d6), Copyright (C) 2015 Universal Ctags Team
Universal Ctags is derived from Exuberant Ctags.
Exuberant Ctags 5.8, Copyright (C) 1996-2009 Darren HiebertCompiled: Jan 11 2022, 12:27:15URL: https://ctags.io/Optional compiled features: +wildcards, +regex, +gnulib_regex, +iconv, +option-directory, +packcc, +optscript

2.下载并安装tomcat8

OpenGrok 是基于网页访问, 需要一个 Web 系统来支撑,所以必须安装Web服务器.
下载源码：https://tomcat.apache.org/download-80.cgi
我下载的版本apache-tomcat-8.5.73.tar.gz
解压缩：

tar zxvf apache-tomcat-8.5.73.tar.gz

将tomcat代码mv到/opt/tomcat8
在/opt/tomcat8/bin$执行 ./startup.sh 启动Tomcat服务后在浏览器中输入网址：http://localhost:8080/ 能够显示以下页面证明Tomcat运行成功。

3.下载OpenGrok

下载官网：http://opengrok.github.io/OpenGrok/
我下载的版本opengrok-1.1-rc5.tar.gz，解压缩 tar zxvf opengrok-1.1-rc5.tar.gz
将lib目录下的source.war拷贝到tomcat8/webapps目录下

cp /data2/ynwang/opengrok-1.1-rc5/lib/source.war /opt/tomcat8/webapps

此时打开网址http://localhost:8080/source 看到以下界面证明OpenGrok运行成功。这是Opengrok的雏形，是因为还未建立索引，所以configuration.xml还没生成，先不用关注：

cd opengrok-1.1-rc5
mkdir etc data src //创建配置、数据、代码目录
cd opengrok-1.1-rc5/src
ln -s 源文件目标文件 //创建android源代码的软链接

4. 配置src root

访问localhost:8080/source/以在tomcat下生成source目录，在/opt/tomcat8/webapps/source/WEB-INF/web.xml中修改configuration.xml的路径：

<display-name>OpenGrok</display-name><description>A wicked fast source browser</description><context-param><description>Full path to the configuration file where OpenGrok can read its configuration</description><param-name>CONFIGURATION</param-name><param-value>/data2/ynwang/opengrok-1.1-rc5/etc/configuration.xml</param-value></context-param>

5. 建立索引

java -jar /data2/ynwang/opengrok-1.1-rc5/lib/opengrok.jar -c /usr/local/bin/ctags -P -S -v -s /data2/ynwang/opengrok-1.1-rc5/src -d /data2/ynwang/opengrok-1.1-rc5/data -W /data2/ynwang/opengrok-1.1-rc5/etc/configuration.xml -m 256

#-Xmx8g：配置Java 最大堆内存为8g，防止内存溢出
#-jar：指定opengrok.jar包
#-c：指定universal-ctags的路径，configure配置的路径，此时使用which ctags得到的路径是/usr/local/bin/ctags
#-s：指定源码路径，就是上面的新建的src
#-d：指定索引文件存放路径，就是上面新建的data
#-W：指定configuration.xml的路径，就是上面新建的etc
#-m：指定opengrok索引时的缓存大小，默认只有16M

6. 添加新的代码索引

在opengrok-1.1-rc5/src目录建立新的源码的软链接，然后重新执行步骤5的命令即可。

最终如图：