pgAdmin4 CentOS7部署
pgAdmin4 CentOS7部署
-
- 一、前言
- 二、安装流程
-
- 2.1 安装pgAdmin4
- 2.2 配置Apache服务器
- 2.3 建立数据保存路径
- 2.4 修改config_local.py
- 2.5 创建pgadmin登录用户
- 2.6 SElinux配置
- 2.7 防火墙通行
- 2.8 运行
- 三、常见错误
-
- 3.1 setup.py依赖错误
- 3.2 运行问题
- 3.3 Internal Server Error
一、前言
实习老板要求我开发一个PostgreSQL的数据库管理工具，要求是B/S型。我当场疑惑，这不是安装的时候就自带一个pgAdmin4，而且完美符合他的要求吗？一问之下才发现，原来数据库在公司里一直是部署在Linux(CentOS7)上的，一方面Linux上默认不装图形界面，另外大家也习惯用Navicat去做连接，所以才会提出这个需求。
好家伙，这不是白给？然而当我尝试在虚拟机中部署pgAdmin4的时候才发现，网上（包括Google）的一众教程，没一个能一遍顺下来的的，多多少少有点问题。我总结了一下部署流程中遇到的问题，希望能给有需要的人提供帮助。
二、安装流程
以下的安装流程，参考的是这篇文章，修正了其中的一些问题（或者说指出了一些注意事项），但流程不变。
2.1 安装pgAdmin4
首先需要添加包含PostgreSQL一系列软件的rpm源。这一步应该在安装PostgreSQL时就已经做过了，以下的安装流程也是建立在已经安装好PostgreSQL的前提下进行的。
sudo yum -y install epel-release
sudo yum -y install https://download.postgresql.org/pub/repos/yum/reporpms/EL-7-x86_64/pgdg-redhat-repo-latest.noarch.rpm
sudo yum -y update
确保rpm源安装过后，就可以安装pgadmin4了
sudo yum -y install pgadmin4
2.2 配置Apache服务器
pgadmin4是Web Based的Python程序，所以需要用Apache服务器，使用yum安装时会解决这些环境问题。下面需要配置服务器设置：
sudo cp /etc/httpd/conf.d/pgadmin4.conf.sample /etc/httpd/conf.d/pgadmin4.conf
首先复制一个（修改后缀）自动生成的样例文件，然后将其改为如下内容（不建议copy）:
ServerName pgadmin.example.com
LoadModule wsgi_module modules/pgadmin4-python3-mod_wsgi.so
WSGIDaemonProcess pgadmin processes=1 threads=25
WSGIScriptAlias /pgadmin4 /usr/lib/python3.6/site-packages/pgadmin4-web/pgAdmin4.wsgi
# Apache 2.4
Require all granted
# Apache 2.2
Order Deny,Allow
Deny from All
Allow from 127.0.0.1
Allow from ::1
这里我说不建议copy的原因是python版本可能不一样，你只需要添加ServerName xxx.com和这三行就可以了。修改完毕后检查一下是否符合httpd的语法要求，然后就可以启动Apache服务了。
sudo httpd -t
sudo systemctl restart httpd
2.3 建立数据保存路径
sudo mkdir -p /var/lib/pgadmin4/ /var/log/pgadmin4/
修改这两个文件夹的权限，让Apache服务器能够写入数据：
sudo chown -R apache:apache /var/lib/pgadmin4 /var/log/pgadmin4
2.4 修改config_local.py
这里要注意，包括我一开始贴出的参考教程，他们写的版本都是python2.7。至少对于我而言这是不对的，我使用yum安装后pgadmin4-web是在python3.6的路径中的，要以/usr/lib/python(2.7或3.x)/site-packages/pgadmin4-web这个文件夹所在位置为准（或者你可以去看看前面pgadmin4.conf中的路径）。
sudo gedit /usr/lib/python3.6/site-packages/pgadmin4-web/config_distro.py
在其中添加以下路径设置：
LOG_FILE = '/var/log/pgadmin4/pgadmin4.log'
SQLITE_PATH = '/var/lib/pgadmin4/pgadmin4.db'
SESSION_DB_PATH = '/var/lib/pgadmin4/sessions'
STORAGE_DIR = '/var/lib/pgadmin4/storage'
2.5 创建pgadmin登录用户
在config_local.py的同目录下有一个setup.py，这是用来创建用户的。
sudo python3 /usr/lib/python3.6/site-packages/pgadmin4-web/setup.py
输入一个邮箱和密码即可创建用户。
这里一定要调用正确版本的python，一般Linux都会自带python2，如果用python2去调用上述语句会出现语法错误（input邮箱后会报Syntax Error）。这里可能还会遇到一些包依赖问题，在下面的常见错误中我会总结。
2.6 SElinux配置
这玩意在虚拟机里我都关掉，但是真的部署估计会需要开启，那么需要做如下设置：
sudo semanage fcontext -a -t httpd_sys_rw_content_t "/var/lib/pgadmin4(/.*)?"
sudo semanage fcontext -a -t httpd_sys_rw_content_t "/var/log/pgadmin4(/.*)?"
sudo restorecon -R /var/lib/pgadmin4/
sudo restorecon -R /var/log/pgadmin4/
sudo systemctl restart httpd
2.7 防火墙通行
sudo firewall-cmd --permanent --add-service=http
sudo firewall-cmd --reload
2.8 运行
在浏览器中输入以下格式去使用pgAdmin4：http://localhost/pgadmin4或者http://ip_address/pgadmin4
三、常见错误
这里我也只能总结一些我遇到过的问题，如果你有其他问题可以在评论中写出来。
3.1 setup.py依赖错误
一开始我没有意识到python版本的问题，所以在2.5步中我用python2.7去运行的setup.py，我遇到了一个报错：No module named builtins。
这个问题可以通过pip install future解决。
我不清楚一开始就用python3调用会不会有这个问题，但如果你遇到了，也可以用上面的方法解决。
3.2 运行问题
在我给出的参考教程中，他最后提供的启动方法是：http://pgadmin.example.com/pgadmin4，中间的部分应该是在/etc/httpd/conf.d/pgadmin4.conf中添加的ServeName，但是我实测这种方法无法启动，也许我还有一些配置没有完成。我实测只有回环地址127.0.0.1，localhost，和本机内网ip三种方式可以启动。
3.3 Internal Server Error
为了确保该教程有效，我又在阿里云服务器上测试了一次，发现走一遍下来，浏览器跳转后会提示：Internal Server Error。首先这说明Apache服务器配置是有效的，不然会提示没有该服务或者无权限访问，然后就是解决问题。
我确认了一遍文件中的内容和虚拟机中一致，所以最后又再次修改了log和lib的权限就好了。
sudo chown -R apache:apache /var/lib/pgadmin4
sudo chown -R apache:apache /var/log/pgadmin4
我现在无法确认是写在同一行没有生效，还是不应该在创建文件夹后立即修改权限。但如果你遇到了这个问题，修改权限可以解决。