pg_resetxlog

功能介绍

pg_resetxlog是一个重新设置数据库事务文件的工具。

注意：
通过pg_resetxlog重新设置之前，需要先停止数据库。
在共享存储模式，关闭数据库之后需要先手动开启dssserver，然后执行pg_resetxlog操作。

前提条件

保证数据库目录存在且路径正确。

语法

pg_resetxlog [OPTION]... DATADIR

参数说明

OPTION取值如下所示：

• DATADIR

  需要修改的数据库目录，确保路径正确。

• -e XIDEPOCH

  设置下一个事务id的epoch值。

• -f

  强制更新。

• -l xlogfile

  为新的事务日志指定最小的WAL起始位置。(注意：xlogfile的值要大于当前最大的xlog文件名，否则该参数不生效，将按照默认逻辑处理，即新的日志文件名为执行该命令前最后一个日志文件的文件名加1.)

• -m XID

  设置下一个multitransaction ID。

• -n

  不更新，仅显示配置文件的值。

• -o OID

  设置下一个OID。

• -O OFFSET

  设置下一个multitransaction的偏移量。

• --enable-dss

  资源池化参数，开启资源池化模式。当输入包含vgname时，会自动开启该参数。

• --socketpath=SOCKETPATH

  资源池化参数，dss实例进程使用的socket文件路径，仅支持绝对路径，可不指定，默认值为$DSS_HOME/.dss_unix_d_socket。

• --vgname=VGDATA

  资源池化参数，资源池化的数据目录。

• -V, --version

  显示版本信息。

• -x XID

  设置下一个事务ID。

• -?, --help

  打印帮助信息。

使用举例（非资源池化模式）

pg_resetxlog [OPTION]... DATADIR

说明：

在非资源池化模式，OPTION的取值不能是资源池化参数。

使用举例（资源池化模式）

export DSS_MAINTAIN=TRUE
dssserver -D $DSS_HOME &
pg_resetxlog [OPTION]... DATADIR --enable-dss --vgname=VGDATA --socketpath=SOCKETPATH
export DSS_MAINTAIN=FALSE

资源池化模式使用说明：

在资源池化模式下，用户需要指定数据库节点文件系统的数据目录DATADIR，用于判断数据库是否关闭，同时也需要指定共享的数据目录，用于操作共享存储设备中的文件。由于备机dss不允许写入，用户只能在主机执行该工具，并且数据库必须是正常关闭的状态。用户在执行该工具之后，工具会自动识别主机并对主机的日志进行重置。