首页 > 代码库 > Arch linux LXR 安装过程

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>

Servername perlwebtest
DocumentRoot /srv/http/perlwebtest
ErrorLog /var/log/httpd/perlwebtest-error.log
CustomLog /var/log/httpd/perlwebtest-access.log combined
<Directory /srv/http/perlwebtest>
AddHandler perl-script .pl
PerlResponseHandler ModPerl::Registry
Options +ExecCGI
PerlOptions +ParseHeaders
AllowOverride All
Order allow,deny
Allow from all
</Directory>

</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

or a domain name like localhost or lxr.url.example,

- 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

need a server and is free from configuration burden.

* For medium to large projects, choice is between MySQL,

PostgreSQL and Oracle.
Oracle is not a free software, its interface has not been
tested for a long time.

* PostgreSQL databases are smaller than MySQL‘s

and performance is roughly equivalent.

* MySQL is at its best with large-sized projects

(such as kernel cross-referencing) where it is fastest at the cost
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 *

Global section part

 

*** 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 *

Tree section part
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

Purge : 0:00:00
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是不能够进行读取的,需要添加权限后,就能够访问了 

Arch linux LXR 安装过程