标签 wiki.js 下的文章

PostgreSQL数据库安装踩坑记——升级安装 wiki.js 2.0

前言：

之前搭了个Wiki，用的wiki.js 1.0，如今发现wiki.js 2.0不知更新了几个版本了，这次就把它更新一下。了解了一下，Wiki JS1.X使用的数据库是MongoDB，而2.0则支持多种数据库，包括PostgreSQL、MySQL、MariaDB等多种数据库，但想获得最佳支持，需要使用PostgreSQL，而且如果想实现中文搜索，网上只找到了使用PostgreSQL装zhparser扩展的资料。毫无疑问，笔者只能选择这个之前从未用过的PostgreSQL。整个过程也是参考知乎大佬的帖子完成，因为笔者技术太菜，踩了很多坑。

装完后回过头来发现，如果安装时看到合适的文档，很多坑都是可以避免的。本文不是教程，仅用于排错时参考，切勿跟随本文进行任何安装！

此处以安装后的视角总结PostgreSQL安装如何避免踩坑。新安装时参考官方的安装指导（安装指导居然在Download里面，我开始没看见踩了坑）,通过yum安装一定要跟随版本号，否则下载下来的是默认的旧版本，发现不对删除再安装新的就会踩各种坑。如果之前出现了这种情况，参考本文编译zhparser部分，将旧版的包完全删除后再通过官方的方式安装新的包，不要装完新的再删旧的，否则还会有很多小问题。

以下为踩坑记录：

删除旧的wikijs 1.0

Linux下杀死进程后进程自动重启怎么处理

使用kill -15 或 kill -9 可以杀掉进程。但有时会发现杀掉的进程会再次启动，我们可以使用以下命令找到进程的父系进程( PPid )，将其杀掉。杀掉前最好看一下是啥,有的可不能随便杀呀。

cat /proc/<PID>/status

使用 ps -ef | grep 进程关键字 语法查询进程。关键字可以是进程名字，也可以是PID。

以上使用ps -aux也可。

PM2管理器

此处通过查询，发现父系进程是PM2管理器，难怪进程杀掉又起来，居然这玩意有PM2管理器。

使用 pm2 list 可显示所有node项目，此处可以看到每一个应用的id。使用 pm2 stop <编号> 可以停止对应应用。

使用 pm2 monit <编号> 可查看此应用详细信息，比如找出应用目录在什么地方。

安装数据库

connections on Unix domain socket "/var/run/postgresql/.s.PGSQL.5432"?

首先，用某面板程序里自带的脚本装了一下，装完按照大佬们写的Docker下的配置贴尝试继续，发现执行命令 psql 直接报错，好家伙，第一步就进坑了。

psql: could not connect to server: No such file or directory
    Is the server running locally and accepting
    connections on Unix domain socket "/var/run/postgresql/.s.PGSQL.5432"?

最后在StackExchange上找到了某个帖子，全是洋文，看了开头几回帖子说装了没版本号的就这样，建议卸除，手动重装带版本号的。

于是骂着面板边去网上找了篇帖子在CentOS下快速安装和配置PostgreSql，按照帖子里面说的装完了，这里我装的是PostgreSQL 13。或可参考：PostgreSQL官方文档

配置数据库并安装插件

Peer authentication failed for user "XXX"

服务起来后创建了wikiJS的数据库，为其配置了对应的用户和密码，也提升了权限。登录又遇到了错误，提示 Peer authentication failed for user "XXX"，网上找了一下，说是因为计算机名和数据库名不一致，这种情况要把默认的 Peer authentication 改成 md5 authentication。

配置文件 pg_hba.conf 用以下命令打开，不同版本路径会有不同，看一下估计就明白了：

vim /var/lib/pgsql/13/data/pg_hba.conf

找到下面的一行：

local  all       postgres                peer

改成：

local  all       postgres                md5

按 ESC 、： 、wq、Enter，保存文件退出。

然后执行 systemctl restart postgresql-13 重启服务，这样就解决了。

ERROR: could not open extension control file "/usr/pgsql-xx...nsion/pg_trgm.control": No such file or directory

紧接着，我就在以下命令处再次进坑了：

CREATE EXTENSION pg_trgm;

出现以下错误提示：

ERROR:  could not open extension control file "/usr/pgsql-13/share/extension/pg_trgm.control": No such file or directory

网上搜了一下，Linux 上PostgreSQL 12 pg_trgm扩展安装 一文给出了方法。我把12换成13就可以啦。

root@VPS # yum install postgresql13-contrib.x86_64
···
database=# CREATE EXTENSIONpg_trgm;
CREATE EXTENSION

然后使用以下命令检查是已经安装的插件：

database=# SELECT * FROM PG_EXTENSION;
  oid  | extname | extowner | extnamespace | extrelocatable | extversion | extconfig | extcondition
-------+---------+----------+--------------+----------------+------------+-----------+--------------
 14160 | plpgsql |       10 |           11 | f              | 1.0        |           |
 16386 | pg_trgm |    16384 |         2200 | t              | 1.5        |           |
(2 rows)

可以看到已经成了。

编译zhparser

接下来毫无疑问， CREATE EXTENSION zhparser; 出现了错误，这是因为没有安装该插件导致的。按照知乎大佬评论区给出的项目链接找到了编译安装指引。整个过程输出信息几乎完全看不懂，但是最后编译安装的回显信息感觉不太对。装完果然补星。

ERROR:  could not open extension control file "/usr/pgsql-13/share/extension/zhparser.control": No such file or directory

网上看了某个网友的踩坑过程,感觉自己又行了。于是跟着大佬思路一通操作，终于将编译出来的文件安装到 /usr/pgsql-13/share/extension 目录了。

再次执行 CREATE EXTENSION zhparser;，我们得到了以下错误。

ERROR:  incompatible library "/usr/pgsql-13/lib/zhparser.so": version mismatch
DETAIL:  Server is version 13, library is version 9.2.

这次的错误信息我能看懂了，明显是表示系统里有不同版本的PostgreSQL，我运行的服务端是13，这定是之前不知什么时候装了个9.2，然后编译出来的也是9.2，不匹配呀。

想来环境中没有其他项目使用PostgreSQL，那么接下来删除这个没用的玩意儿！先使用 rpm -qa | sort 命令查看装了哪些软件包。此处找到了如下9.2软件包：

postgresql-9.2.24-7.el7_9.x86_64
postgresql-contrib-9.2.24-7.el7_9.x86_64
postgresql-devel-9.2.24-7.el7_9.x86_64
postgresql-libs-9.2.24-7.el7_9.x86_64

挨个将其卸除：

yum remove postgresql-9.2.24-7.el7_9.x86_64

以上命令执行时会自动卸除相关依赖：postgresql-contrib、postgresql-devel

yum remove postgresql-libs-9.2.24-7.el7_9.x86_64

顺便扫了一眼13版的包，发现少装了个 postgresql13-devel.x86_64 ，赶紧 yum install postgresql13-devel.x86_64给装上了。

此时，再次执行 make && make install 发现还是补星。提示：

make: pg_config: Command not found
make: *** No targets.  Stop.

问题回归了，提示找不到文件，看GitHub文档意思说可以这么写为指定的版本编译扩展：

PG_CONFIG=/usr/pgsql-13/bin/pg_config make && make install

还是报同样错误。随手搜一下，Stackoverflow大佬说环境变量问题，大佬写的环境变量前面有 export 。

于是，我在 zhparser 目录下，执行以下代码：

export PG_CONFIG=/usr/pgsql-13/bin/pg_config
make &&make install

这次没错误了，相信插件应该生成了。

bash: XXXX: command not found

还是老命令 psql 连数据库，发现命令无效了。

# psql
-bash: psql: command not found

早知如此，就不卸载旧的了。肯定是把变量空间配置之类的搞丢了。参考：Postgresql -bash: psql: command not found来处理。首先我们需要知道失效的命令对应的文件在哪，此处大量折腾我已经知道在哪了，如果不知道，可以使用 find 命令查找。执行命令 vim ~/.bash_profile ，添加以下行后保存退出，这样，当前的root账户下次登录时就可以了。

export PATH=/usr/pgsql-13/bin:$PATH

重新登录或su切换到postgres账号连接数据库继续配置zhparser插件：

CREATE EXTENSION zhparser;
CREATE EXTENSION

至此，zhparser插件安装成功。

接着继续配置：

CREATE EXTENSION zhparser;
CREATE TEXT SEARCH CONFIGURATION pg_catalog.chinese_zh (PARSER = zhparser);
ALTER TEXT SEARCH CONFIGURATION chinese_zh ADD MAPPING FOR n,v,a,i,e,l WITH simple;

-- [二、PostgerSQL全文检索系统之中文支持_jjj的博客-CSDN博客](
-- https://blog.csdn.net/weixin_40746796/article/details/89209316
-- )
-- 忽略标点影响
ALTER ROLE wikijs SET zhparser.punctuation_ignore = ON;
-- 短词复合
ALTER ROLE wikijs SET zhparser.multi_short = ON;

-- 看看 chinese_zh 在不在
\dF
-- 测试一下
select ts_debug('chinese_zh', '白垩纪是地球上海陆分布和生物界急剧变化、火山活动频繁的时代');

接下来退出连接，重新连入 postgres 数据库，关闭 wikijs superuser权限：

\q
psql -U postgres -d postgres
ALTER USER wikijs WITH NOSUPERUSER;
\q

至此，数据库装完了。

安装配置wikijs 2.x

wiki.js 配置管理页信息后登录提示用户名或密码错误

剩下的安装就比较简单了，参考官方文档，新建一个用户，下载、解压Wikijs文件到合适的地方，将 config.sample.yml重命名为 config.yml .使用文本编辑器打开文件，在指定位置填写数据库配置信息、访问端口等。然后node server 运行，浏览器打开，配置管理员信息。注意管理员的邮箱不能有大写字母，否则待会儿登录时会提示用户名或密码错误。

测试可行后 Ctrl +c 停止，参考官方文档 写systemctl，然后添加自启动并运行服务即完成搭建。

域名访问

wikijs本身不支持域名访问，想要通过域名访问，需要套一个反向代理。笔者用的nginx，因为之前装1.0时已经做过了，我这次不需要再做了。

参考：