Ubuntu下opengrok的安装

opengroke是一个代码索引、浏览的工具，可以帮你快速搜索、对照、定位你的源代码树。作者因为要查看Android系统源码，所以需要这么一个工具来辅助，实验证明它是非常好用的，比source insight好用很多，那么接下来就来说一下它在Ubuntu下是怎么搭建起来的。

=================================================

首先说一下有哪些步骤：

1、搭载Java环境

2、安装ctags

3、安装Tomcat

4、安装和配置opengrok

=================================================

提醒一下，作者的系统是64bit的Ubuntu-12.04。接下来说一下具体各个步骤要做的有哪些。

1、搭载Java环境

   1.1 作者准备使用的Java版本是jdk-6u45-linux-x64.bin，大家可以下载新的版本

   1.2 将jdk-6u45-linux-x64.bin拷贝到Ubuntu的/usr/java/目录下，没有请创建一个 mkdir /usr/java/

       cp /mnt/hgfs/eleven/tool/jdk-6u45-linux-x64.bin /usr/java/

   1.3 进入/usr/java/目录，修改jdk-6u45-linux-x64.bin的可执行权限

       chmod u+x jdk-6u45-linux-x64.bin

   1.4 执行jdk-6u45-linux-x64.bin进行安装，其实是在解压这个文件

       ./jdk-6u45-linux-x64.bin

   1.5 接下来配置环境变量

      1.5.1 打开/etc/profile

         gedit /etc/profile

       1.5.2 在文件最后添加以下内容

             export JAVA_HOME=/usr/java/jdk1.6.0_45
            export CLASSPATH=.:$JAVA_HOME/lib/dt.jar:$JAVA_HOME/lib/tools.jar
            export PATH=$PATH:$JAVA_HOME/bin

       1.5.3 执行下面命令，让配置立即生效

             source /etc/profile

       1.5.4 验证以下是否安装成功

            执行 java -version 出现下面字段

             java version "1.6.0_45"
             Java(TM) SE Runtime Environment (build 1.6.0_45-b06)
             Java HotSpot(TM) 64-Bit Server VM (build 20.45-b01, mixed mode)

             或者测试一下各个变量是否能用，下面举例JAVA_HOME，其他以此类推

             执行 echo $JAVA_HOME 出现下面字段
             /usr/java/jdk1.6.0_45

             至此，Java环境安装完成

2、安装ctags

   直接在Ubuntu终端上输入 sudo apt-get install ctags，即可完成安装

3、安装Tomcat

   3.1 首先准备好Tomcat，作者用的是apache-tomcat-6.0.44.tar.gz
   3.2 解压缩，这里需要提醒一下，为了减少因为权限问题而造成的麻烦，最好把Tomcat和opengrok安装在自己有权限的目录下，执行以下命令，完成解压
       tar -xvf apache-tomcat-6.0.44.tar.gz
   3.3 解压后进入Tomcat的bin目录，启动Tomcat服务
       cd apache-tomcat-6.0.44/bin/
       ./startup.sh 
   3.4 启动Tomcat服务后，在浏览器中输入网址：http://localhost:8080/ 能够显示以下页面证明Tomcat运行成功。

4、安装和配置opengrok
   4.1 首先准备好opengrok，作者用的是opengrok-0.11.1.tar.gz，OpenGrok下载地址：http://opengrok.github.io/OpenGrok/ 
   4.2 解压缩，上面已经说了，注意权限问题，执行以下命令，完成解压
       tar -zxvf opengrok-0.11.1.tar.gz
   4.3 解压后进入opengrok的lib目录，将source.war拷贝到apache-tomcat/webapps目录下
       cp source.war ~/tool/apache-tomcat-6.0.44/webapps/
       这里的~/tool/apache-tomcat-6.0.44/webapps/为作者Tomcat的安装目录
   4.4 在浏览器中输入 http://localhost:8080/source/ 网址看到以下界面证明OpenGrok运行成功。（注意：因为作者已经建立过索引了，所有右边project有显示，第一次打开是没有的）

   4.5 开始配置opengrok
       4.5.1 进入opengrok的bin目录，并打开脚本文件OpenGrok
             cd ~/tool/opengrok-0.11.1/bin//此处为作者opengrok的安装目录
             gedit OpenGrok
       4.5.2 找到DefaultInstanceConfiguration函数里面的
             OPENGROK_INSTANCE_BASE="${OPENGROK_INSTANCE_BASE:-/var/opengrok}"
             路径/var/opengrok其实就是默认寻找你的源码路径src和存放生成的data、etc等目录文件的位置，也可以根据自己的要求进行修改，以下为作者修改过的路径：

       4.5.3 修改JavaHome路径，如图第422行：

       4.5.4 添加tomcat路径，如图第521行：

       4.5.5 打开并修改web.xml配置文件
   4.6 部署，进入opengrok的bin目录，执行以下命令进行部署
       ./OpenGrok deploy
   4.7 建立Android源码索引
       ./OpenGrok index ~/aosp //~/aosp为Android源码路径
       因为Android源码的庞大，建立索引需要一段比较长的时间，请耐心等候