Debian/Ubuntu架设nginx+bugzilla

题注

最近需要一个简单快速的bug追踪工具，考虑到系统环境以及学习成本，决定采用bugzilla。不试不知道，原来这里面还有这么多的坑需要一个个踩平~，遂随笔一下以备后用。

我采用的系统组成是debian+mysql+nginx+bugzilla，使用centos的亲可能需要注意nginx的安装方式和配置文件位置不一样，需要灵活变通；至于使用apache的同学，请参考其它文章设置转发部分。

一、安装nginx、perl-fpm、mysql

不同于apache使用的cgi方式，nginx采用fcgi来调度php、perl等编程语言。所以我们需要安装并配置perl的fpm。

安装

aptitude install nginx libfcgi-perl mysql-server

我本来想通过下载编译的方式安装fcgi(https://metacpan.org/pod/FCGI)不料安到一半发现发行版里竟然有！于是乎瞬间采用更好的方案解决了。发行版里找不到这个包的同学可以自行下载安装（nginx也是一个道理）

安装完后发现，这个lib没有启停脚本，于是上网上找了两个脚本安上去：

wget http://nginxlibrary.com/downloads/perl-fcgi/fastcgi-wrapper -O /usr/bin/fastcgi-wrapper.pl
wget http://nginxlibrary.com/downloads/perl-fcgi/perl-fcgi -O /etc/init.d/perl-fcgi
chmod +x /usr/bin/fastcgi-wrapper.pl
chmod +x /etc/init.d/perl-fcgi
update-rc.d perl-fcgi defaults
insserv perl-fcgi

执行完上述脚本后，我们在/etc/init.d/里面安装了一个服务perl-fcgi，它将在开机后自动运行/usr/bin/fastcgi-wrapper.pl

配置

fastcgi-wrapper.pl调用libfcgi-perl并监听socket端口，nginx将通过该端口与之通信。默认地址为127.0.0.1:9000。为了提升性能，我将其改为命名管道方式：

vim /usr/bin/fastcgi-wrapper.pl

找到原来的启动监听语句将其修改为：

$socket = FCGI::OpenSocket( "/tmp/perl-fcgi.sock", 10 );

保存后，启动perl-fcgi

service perl-fcgi start

如果启动失败，提示`account not available`，可能是www-data用户被禁止登陆，执行以下命令：

usermod -s /bin/sh www-data

 进入nginx的配置目录，创建配置文件：

cd /etc/nginx/sites-available
vim bugzilla

配置文件如下(将域名和端口替换成你的访问地址)：

server {
        listen          8008; # listening port
        server_name     bugzilla.example.com; # server name

        root            /var/www/bugzilla; # installation path

        location /skin/ {}
        location /js/ {}

        location / {
                include         fastcgi_params;
                fastcgi_pass    unix:/tmp/perl-fcgi.sock;
                fastcgi_index   index.cgi;
                fastcgi_param   SCRIPT_FILENAME $document_root$fastcgi_script_name;
        }
}

接下来，将配置文件链接到sites-enabled目录中，并启动应用（如果之前nginx已经启动，调用reload重载入配置文件）：

cd ../sites-enabled/
ln -s ../sites-available/bugzilla .
service nginx start

mysql的安装与配置在网上相当多，在此不再赘述。

二、安装bugzilla

搞定了基础环境，接下来开始正式安装bugzilla

安装

从bugzilla.org下载并解压到/var/www

mkdir -p /var/www
cd /var/www
chown -R www-data .
wget http://ftp.mozilla.org/pub/mozilla.org/webtools/bugzilla-4.4.5.tar.gz
tar zxf bugzilla-4.4.5.tar.gz
mv bugzilla-4.4.5 bugzilla
cd bugzilla

配置

接下来需要对bugzilla进行配置。bugzilla依赖某些perl组件本机可能没有安装，而我在使用其自带的安装脚本时始终无法成功安装，网上搜索后找到一个解决方案是使用cpanm来安装。

下载并安装cpanm：

sudo curl -L http://cpanmin.us | perl - --sudo App::cpanminus

接下来我们执行checksetup.pl来进行配置。配置过程中checksetup.pl需要执行若干次以完成环境检查。第一次执行后，可能会提示有模块未安装，按照未安装的模块列表使用cpanm命令进行安装即可

perl checksetup.pl
cpanm YAML
cpanm DateTime
...

安装完成后，再次执行checksetup.pl，此时依赖模块应该都检查通过。如果有模块已安装但检查不到，可以尝试强制重新安装，如：

cpanm DateTime -f

模块检查通过后，checksetup.pl会提示mysql连接失败，我们现在进入mysql配置用户与数据库：

CREATE database bugs default charset utf8 collate utf8_bin;
CREATE user bugs@localhost identified by 'bugs';
grant all on bugs.* to bugs@localhost;
flush privileges;

修改数据库配置：

vim localconfig

找到并修改以下项：

$webservergroup = 'www-data';

$db_pass = 'bugs';

注：如果使用远程数据库等，请自行进行配置用户名、密码等

至此，我们完成了所有的配置。再次执行checkconfig.pl，会提示输入管理员邮箱和密码，并保存配置到数据库。

尝试打开你配置的访问地址（如：http://bugzilla.example.com:8008/)，如果能打开并排版显示正确，就表明可以访问了。