Upgrade your PostgreSQL in Mac
起因
我本地安装了PostgreSQL的9.5版本,在某次神秘力量的引导下,我无知无觉的升级了PostgreSQL到9.6版本而没有检查兼容性
今天在试图运行PostgreSQL服务时得到了报错:
pg_ctl: another server might be running; trying to start server anyway
然后naive的我试图终止PostgreSQL服务,得到了另一个报错:
pg_ctl: could not send stop signal (PID: 60961): No such process
吓得我赶紧查看了一下PostgreSQL的log:
tail -f /usr/local/var/postgres/server.log
得到的日志信息如下:
FATAL: database files are incompatible with server
DETAIL: The data directory was initialized by PostgreSQL version 9.5, which is not compatible with this version 9.6.1.
长舒一口气,只是PostgreSQL例行的版本升级不兼容而已
升级
我是从9.5升级到9.6,因此如果你的PostgreSQL的版本号跟我的不同,需要改动下面命令中的版本号,执行的每个命令我都会尽量标注清楚我们在干什么
1、终止PostgreSQL服务
launchctl unload -w ~/Library/LaunchAgents/homebrew.mxcl.postgresql.plist
launchctl在Apple官网找到的文档比较老旧,这里附一个wikipedia的链接,如果你希望看到更完整的关于该命令的介绍,建议在终端执行:man launchctl
进行查看
简单来说:
launchctl
命令用于加载(load)和卸载(unload)系统启动时自动运行的服务,服务的具体描述储存在对应的plist文件,位置一般是~/Library/LaunchAgents
或/Library/LaunchAgents
。上面命令中的plist很明显能看出我的PostgreSQL是使用Homebrew安装的
unload
子命令额外能够终止正在运行的服务
-w
参数用于复写plist文件中不可用键对应的值为false(对应load
子命令)或者true(unload
子命令),以让你的命令能够不被神秘力量阻止运行
2、备份现有PostgreSQL数据
mv /usr/local/var/postgres /usr/local/var/postgres95
将现有的PostgreSQL数据文件夹postgres备份为postgres95
3、升级Homebrew
brew update
4、升级PostgreSQL
brew upgrade postgresql
5、初始化PostgreSQL
initdb /usr/local/var/postgres -E utf8
这是初始化PostgreSQL数据库的标准方式了,使用utf8字符集编码
6、升级PostgreSQL的bin文件夹及你旧版本数据库数据
pg_upgrade -b /usr/local/Cellar/postgresql/9.5.5/bin -B /usr/local/Cellar/postgresql/9.6.1/bin -d /usr/local/var/postgres95 -D /usr/local/var/postgres
该命令有点长,不过实际很简单,只需要知道下面一条规则:
pg_upgrade -b oldbindir -B newbindir -d olddatadir -D newdatadir [option...]
如果你不知道你的PostgreSQL的bin目录是什么,可以使用ls -f /usr/local/Cellar/postgresql
该命令查看你的postgresql目录下的PostgreSQL版本文件夹,每个版本号下都会有对应的bin目录
上面命令中:
postgresql/9.5.5/bin
是9.5.5(原有)版本数据库的bin文件夹
postgresql/9.6.1/bin
是9.6.1(当前)版本数据库的bin文件夹
postgres95
是我们在第2步备份的原数据文件
postgres
是当前PostgreSQL数据库文件目录
7、拷贝plist文件到正确位置
cp /usr/local/Cellar/postgresql/9.6.1/homebrew.mxcl.postgresql.plist ~/Library/LaunchAgents/
将升级后的PostgreSQL数据库的plist文件拷贝到其应在的位置
8、清理备份数据文件
rm -rf /usr/local/var/postgres95
将第2步备份的数据文件删除掉
9、启动PostgreSQL
pg_ctl -D /usr/local/var/postgres -l /usr/local/var/postgres/server.log start
数据库版本升级完毕,数据文件升级完毕,启动我们的PostgreSQL试试,理论上,能正常启动的,相信我
10、关闭PostgreSQL
pg_ctl -D /usr/local/var/postgres stop -s -m fast
关闭PostgreSQL试试,理论上也能正常关闭的
另外
由于PostgreSQL启动和终止服务的命令过于反人类,建议将其写入你的bash_profile文件,以下是我本地的alias
#postgresql start&stop
alias psqlstart='pg_ctl -D /usr/local/var/postgres -l /usr/local/var/postgres/server.log start'
alias psqlstop='pg_ctl -D /usr/local/var/postgres stop -s -m fast'
记得在每次修改了bash_profile文件后执行source ~/.bash_profile
或者重启你的终端或机器