Arch linux LXR 安装过程
参考网页：
http://lxr.sourceforge.net/en/1-0-InstallSteps/1-0-install.php
我选择的版本：2.2， 我自己的操作系统是arch linux
安装必要环境：
perl：sudo pacman -S perl
ctags： sudo pacman -S ctags
MariaDB：sudo pacman -S mariadb
Apache httpd：
安装之后，需要先进行以下的配置：在启动服务之前：
# mysql_install_db --user=mysql --basedir=/usr --datadir=/var/lib/mysql
# sudo systemctl start mysqld
设置密码：'/usr/bin/mysqladmin' -u root password 'new-password' 或 '/usr/bin/mysqladmin' -u root -h <username> password 'new-password
mod_perl:
1、下载的地方：https://aur.archlinux.org/packages/mod_perl/ 在这里下载git，https://aur.archlinux.org/mod_perl.git， 然后使用makepkg -sri。这里会有一个unknown public key的错误，gpg --keyserver hkps://hkps.pool.sks-keyservers.net --search-keys AB34BA0040E92ECE （曾经有用），但我一般都是直接用--skippgpcheck。来进行安装：makepkg -sri --skippgpcheck
2、 然后还要根据页面配置https://wiki.archlinux.org/index.php/Mod_perl#Installation
我使用第一种方法：创建一个httpd-vhosts.conf的文件，然后填入
# /etc/httpd/conf/extra/httpd-vhosts.conf
<VirtualHost perlwebtest:80>
DocumentRoot /srv/http/perlwebtest
ErrorLog /var/log/httpd/perlwebtest-error.log
CustomLog /var/log/httpd/perlwebtest-access.log combined
<Directory /srv/http/perlwebtest>
PerlResponseHandler ModPerl::Registry
Options +ExecCGI
PerlOptions +ParseHeaders
AllowOverride All
Order allow,deny
Allow from all
</VirtualHost>
然后在配置文件当中进行包含：
Include conf/extra/httpd-vhosts.conf
要确保配置文件没有 这个选项：
Options Indexes FollowSymLinks
把下面这一行添加到/etc/hosts
127.0.0.1 localhost yourhostname perlwebtest
Glimpse：http://webglimpse.net/download.php，
Perl database driver interface DBI and the relevant DBD driver for the database：
sudo cpan install DBI::mysql
sudo cpan install DBD::mysql
Perl File::MMagic ：
sudo cpan install File::MMagic
源码下载：https://sourceforge.net/projects/lxr/?source=typ_redirect
到这里， 第一部分，就基本完成了。后面还需要再次配置服务器。到那儿再继续
其实无论是哪种系统，只要把这些依赖都安装好，最后都是能够使用的。
第二部分： 安装LXR的源码
我是安装在系统范围内的，执行以下命令：
参考命令：
$ cd /usr/local/share
$ tar -zxf ~/Download/lxr-x.y.z.tgz
实际命令：
$ cd /usr/local/share
$ sudo tar -zxf ~/Downloads/LXR/lxr-2.2.1.tgz
sudo mv lxr-2.2.1/ lxr
sudo chown -R <username> lxr
进入到目录当中
cd /usr/local/share/lxr
检查当前的环境是否符合
$ ./genxref --checkonly
第三部分：
配置部分：配置部分，是最需要去看文档的地方了。在这里，我贴出我所有的选择，如果想要快速的创建，可以按我的直接输入，并且按我的文件名的安排来参考怎么设置。
开启配置的命令：
$ ./scripts/configure-lxr.pl -vv
* LXR configurator (version: 2.2) *
LXR root directory is /usr/local/share/lxr
Configuration will be stored in custom.d/
directory custom.d created
directory custom.d/db-scripts.d created
Configure for single/multiple trees? [S/m] > s
Do you intend to add other trees later? [yes/NO] > n
* LXR web server configuration *
Many different configurations are possible, they are related to the way
LXR service is accessed, i.e. to the structure of the URL.
Refer to the User's Manual for a description of the variants.
LXR can be located at the server-root (so called dedicated)
or lower in the server hierarchy (shared because there are
usually other pages or sections).
Server type? [dedicated/SHARED] > shared
The computer hosting the server is described by an URL.
The form is scheme://host_name:port
where:
- scheme is either http or https (http: can be omitted),
- host_name can be given as an IP address such as 123.45.67.89
- port may be omitted if standard for the scheme.
--- Host name or IP? [//localhost] >
--- Alias name or IP? >
URL section name for LXR in your server? [/lxr] >
* LXR database configuration *
The choice of the database engine can make a difference in indexing performance,
but resource consumption is also an important factor.
* For a small personal project, try SQLite which do not
* For medium to large projects, choice is between MySQL,
Oracle is not a free software, its interface has not been
tested for a long time.
* PostgreSQL databases are smaller than MySQL's
* MySQL is at its best with large-sized projects
of bigger databases.
* Take also in consideration the number of connected users.
Database engine? [MYSQL/oracle/postgres/sqlite] > mysql
--- Directory for glimpse databases? > /home/<username>/glimpse_DB
file .htaccess written into LXR root directory
file apache2-require.pl written into configuration directory
file apache-lxrserver.conf written into configuration directory
file lighttpd-lxrserver.conf written into configuration directory
file nginx-lxrserver.conf written into configuration directory
file thttpd-lxrserver.conf written into configuration directory
Mercurial support files written into configuration directory
* LXR master configuration file setup *
*** Configuring auxiliary tool paths
*** Host name previously defined as http://localhost
*** Configuring HTML parameters
*** 'Buttons-and-menus' interface is recommended for the kernel
*** to avoid screen cluttering.
--- Use 'buttons-and-menus' instead of 'link' interface? [YES/no] > y
*** Configuring file subsection
*** Configuring "common factors"
*** Marking tree section
* LXR master configuration file setup *
SQL script for database initialisation
*** Configuring LXR server parameters
*** The virtual root is the fixed URL part after the hostname.
*** You previously defined the virtual root as /lxr
--- Caption in page header? (e.g. Project XYZZY displayed by LXR) > Projec Read Source Code displayerd by LXR
Do you need a specific encoding for this tree ? [yes/NO] > n
*** Describing tree location
How is your tree stored? [FILES/cvs/git/svn/hg/bk] > F
*** A source directory contains one sub-directory for every version.
--- Source directory? (e.g. /home/myself/project-tree) > /home/<username>/Documents/SourceCode
Name to display for the path root? (e.g. Project or $v for version) [$v] >
*** Enumerating versions
Label for version selection menu? [Version] >
*** Versions can be explicitly enumerated, be read from a file or computed
*** by a function. The latter case is recommended for VCS-stored trees.
Version enumeration method? [LIST/file/function] >
--- Version name? > klib
--- Version name? (hit return to stop) > libevent-2.1.8
--- Version name? (hit return to stop) > linux-2.6.39
--- Version name? (hit return to stop) > linux-4.10.10
--- Version name? (hit return to stop) > memcached
--- Version name? (hit return to stop) > other1
--- Version name? (hit return to stop) > other2
--- Version name? (hit return to stop) >
*** By default, first version in list is displayed. You may also indicate
*** a prefered version.
--- Default displayed version is first in 'range'? [YES/no] > y
*** Setting directory lists
*** Some directories may contain non-public project data (binaries,
*** compilers caches, SCM control data, ...). They can be hidden from LXR.
--- Directory to ignore, e.g. CVSROOT or CVS? (hit return to stop) >
*** If your source code uses "include" statements (#include, require, ...)
*** LXR needs hints to resolve the destination file.
--- Include directory, e.g. /include? (hit return to stop) > /usr/include
--- Include directory, e.g. /include? (hit return to stop) > /usr/local/include
--- Include directory, e.g. /include? (hit return to stop) > /usr/lib/gcc/x86_64-pc-linux-gnu/6.3.1/include
--- Include directory, e.g. /include? (hit return to stop) >
*** Configuring data storage
--- Database name? > lxr_ReadSourceCode
--- DB user name? [lxr] >
--- DB password? [lxrpw] >
--- DB table prefix? [lxr_] >
创建数据库
$ ./custom.d/initdb.sh
然后会显示
Enter password:
*** MySQL - Creating tree user lxr
Enter password:
*** MySQL - Creating tree database lxr_ReadSourceCode
*** MySQL - Configuring tables lxr_ in database lxr_ReadSourceCode
复制配置到当前
$ cp custom.d/lxr.conf .
第三部分 漫长的索引开始
直接产生所有版本：
$ ./genxref --url=http://localhost/lxr --allversions
也可以只产生某个版本
$ ./genxref --url=http://localhost/lxr --version=v1
经过一晚上后，可以了。
显示了这样的一个信息：
*** other2 /tools/
--- other2 install_venv.py 1491296469-4352 82079 +++ 140/138
--- other2 normalize_json.py 1491296469-958 82080 +++ 28/10
--- other2 ryu-manager.spec 1491296469-715 82081 +++ 29/31
--- other2 topology_graphviz.py 1491296469-1021 82082 +++ 34/5
--- other2 with_venv.sh 1491296469-752 82083 +++ 22/8
*** other2 /
--- other2 run_tests.sh 1491296469-5040 82084 +++ 191/181
--- other2 setup.py 1491296469-956 82085 +++ 31/9
Summary for http://localhost/lxr == Version other2
Free-text indexing : 0:00:00
Definitions parsing: 0:00:09
References parsing : 0:00:17
...Total duration..: 0:00:26
Database optimisation ... Done
第四个：配置服务器
在arch linux上的http的配置文件夹是/etc/httpd/conf （我的没有最后面的d）
# cp custom.d/apache-lxrserver.conf /etc/httpd/conf
然后，在我的版本里面，并没有自动的包含这个文件，也不会自动的包含conf里面的配置文件的语句，所以还需要自己包含这个配置文件
Include conf/apache-lxrserver.conf
需要重启服务：
$ sudo systemctl restart httpd
第一次开启，并不能够成功启动。使用status来进行查看，是没有启动成功，原因是Invalid command 'PerlResponseHandler'
尝试去注释了http.conf里面的 Options Indexes FollowSymLinks
取消了注释也没问题
出现了FEATAL的问题，不能够创建文件夹，有可能是因为/home/<user name>的文件夹中，设置的权限，因为这个文件夹，other是不能够进行读取的，需要添加权限后，就能够访问了
错误：
DBI.c: loadable library and perl binaries are mismatched (got handshake key 0xdb80080, needed 0xde00080)
出现这个错误的原因，根据我的观察，是因为perl从5.24升级到了5.26,另外，apache 的mod_perl也升级了，我不确定这两个，哪个才是主要原因，反正我是因为升级，出现了这个错误。
解决办法：
去cpan的网站下再DBI的包，重新编译安装，就可以解决了。
http://search.cpan.org/~timb/DBI/DBI.pm
重新编译的命令是：
perl Makefile.PL make sudo make install
用着，好像更新了perl之后，修复了上面的错误，重新配置，出现了这个错误，但其实，这个虽然出错了，还是能够正确显示源代码的。指示Glimpse_DB里面没有了那些文件，我不知道这会有什么影响，我重新配置，还是能够访问自己的网站
Processing http://localhost/lxr == Version libevent-2.1.8
cp: cannot stat '/home/andrew/glimpse_DB/lxr//libevent-2.1.8': No such file or directory
Cannot change directory to /home/andrew/glimpse_DB/lxr//%@%glix%@%/
usage: /usr/bin/glimpseindex [-help] [-a] [-d] [-f] [-i] [-n [X]] [-o] [-r delim] [-s] [-t] [-w X] [-B] [-F] [-H DIR] [-I] [-M X] [-R] [-S X] [-T] [-V] NAMES
List of options (see http://webglimpse.net/ for more details):
-help: outputs this menu
-a: add given files/directories to an existing index
-b: build a (large) byte-level index
-B: use a hash table that is 4 times bigger (256k entries instead of 64K)
-d NAMES: delete (file or directory) NAMES from an existing index
-D NAMES: delete NAMES from the list of files (but not from the index!)
-E: do not run a check on file types
-f: incremental indexing (add all newly modified files)
-F: the list of files to index is obtained from standard input
-h: generates some hash-tables for WebGlimpse
-H DIR: the index is put in directory DIR
-i: make .glimpse_include take precedence over .glimpse_exclude
-I: output the list of files that would be indexed (but don't index)
-M X: use X MBytes of memory for temporary tables
-n [X]: index numbers as well as words; warn (into .glimpse_messages)
if file adds > X% numeric words: default is 50
-o: build a small (rather than tiny) size index (the recommended option!)
-r delim: build an index at the granularity of delimiter `delim'
to do booleans by reading ONLY the index
-R: recompute .glimpse_filenames_index from .glimpse_filenames if it changes
-s: build index to support structured (Harvest SOIF type) queries
-S X: adjust the size of the stop list
-t: sort the indexed files by date and time (most recent first)
-T: build .glimpse_turbo for very fast search with -i -w in glimpse
-U: there is extra information after filenames: works only with -F
-w X: warn (into .glimpse_messages) if a file adds >= X words to the index
-X: extract titles of all documents with .html, .htm, .shtm, .shtml suffix
-z: customizable filtering using .glimpse_filters
For questions about glimpse, please contact: `glimpse-mail@webglimpse.net'
chmod: cannot access '/home/andrew/glimpse_DB/lxr//%@%glix%@%/.glimpse*': No such file or directory
Permissions changed to rw-r--r--
mv: cannot stat '/home/andrew/glimpse_DB/lxr//libevent-2.1.8': No such file or directory
mv: cannot stat '/home/andrew/glimpse_DB/lxr//%@%glix%@%/': No such file or directory
