TimescaleDB部署
1、准备
操作系统： CentOS 7 64位操作系统
安装程序： postgresql-10.2.tar.gz
Timescale： timescaledb（只支持pgsql9.x和10.x）
Timescale release_tag： 1.0.0
cmake： cmake-3.10.2.tar（Timescale要求CMake 3.4或更高版本）
安装TimescaleDB时序数据库需要提前安装PostgresSQL数据库，因为TimescaleDB是实时数据库PostgresSQL的插件。并且，目前TimescaleDB只支持在PostgresSQL9.x和10.x中运行。
PostgresSQL数据库安装程序依然可以通过官网或第三方网站下载（坚定的支持从官网下载）。可以直接将程序下载到本地，然后通过FTP/SFTP方式上传到服务，也可以通过命令wget直接下载到服务器（如果服务器能够连接到以太网，推荐此方式）。
2、部署
Timescale的安装分为两部分。一部分为安装PostgresSQL，另一部分为安装TimescaleDB插件。
2.1、部署PostgresSQL
获取安装包
现将 PostgreSQL 的安装包下载到服务器器中，我们在 /opt/⽬目录下创建保存安装包的目录/postgresql_pkg。
此处选择直接从服务器器下载 PostgreSQL 安装包。
执⾏命令:
> mkdir /opt/postgresql_pkg
> cd /opt/postgresql_pkg
> wget https://ftp.postgresql.org/pub/source/v10.2/postgresql-10.2.tar.gz
关闭selinux
在Linux系统中，如果selinux没有设置为permissive或者是disable的情况下，有些Linux系统上的应用程序运行时可能会被拒绝，导致无法正常运行，所以需要关闭selinux（如果有专业运维人员可以进行详细配置来规避此问题）。
执行命令：
> vim /etc/selinux/config
修改内容：
SELINUX=disable
#SELINUXTYPE=targeted
创建用户
需要注意的是PostgresSQL是禁止使用超级管理员来运行服务命令的，所以我们需要创建一个账号来进行后续的PostgresSQL的安装。
我们创建一个用户组，向创建的用户组中添加一个用户账号，并且给该用户创建密码。
执行命令：
> groupadd postgres
> useradd -g postgres postgres
> passwd postgres
创建安装目录
创建 PostgreSQL需要的⽬录，并且为⽬录 /mnt/db1 赋予读写权限。
> mkdir -p /mnt/db1/pgdata/pgsql /mnt/db1/pgdata/pgtbs /mnt/db1/archivelog /backups
> chmod -R 775 /mnt/db1
> chown -R postgres:postgres /mnt/db1
安装依赖
在编译安装程序之前先安装PostgresSQL需要的依赖。
> yum install -y gcc gcc-c++ epel-release llvm5.0 llvm5.0-devel clang libicu-
devel perl-ExtUtils-Embed zlib-devel openssl openssl-devel pam-devel libxml2-devel
libxslt-devel openldap-devel systemd-devel tcl-devel python-devel
> yum install -y llvm5.0 llvm5.0-devel
编译安装
进入保存 PostgreSQL 安装包的目录 /opt/postgresql_pkg，解压、编译、安装等操作
执行命令：
> cd /opt/postgresql_pkg
进入保存安装包的目录之后，解压安装包并进入解压后的目录。
执行命令：
> tar -zxvf ./postgresql-11.1.tar.gz
> mkdir -p ./postgresql-11.1/build_dir
> cd ./postgresql-11.1/build_dir
开始编译
> ../configure --prefix=/usr/local/pgsql --without-readline --with-openssl
> make world
> make install
启动配置
添加启动配置文件。
执行命令：
> vim /usr/lib/systemd/system/postgresql-10.service
向新建的文件中贴入一下内容。
[Unit]
Description=PostgreSQL 10 database server
Documentation=https://www.postgresql.org/docs/10/static/
After=syslog.target
After=network.target
[Service]
Type=notify
User=postgres
Group=postgres
Environment=PGDATA=/mnt/db1/pgdata/pgsql/
OOMScoreAdjust=-1000
Environment=PG_OOM_ADJUST_FILE=/proc/self/oom_score_adj
Environment=PG_OOM_ADJUST_VALUE=0
ExecStart=/usr/local/pgsql/bin/postmaster -D ${PGDATA}
ExecReload=/bin/kill -HUP $MAINPID
KillMode=mixed
KillSignal=SIGINT
TimeoutSec=0
[Install]
WantedBy=multi-user.target
环境变量
需要设置环境变量，否则 PostgreSQL 的安装命令无法正常使用。
修改 /etc/profile文件。
执行命令：
> vim /etc/profile
向打开的配置文件最后处添加一下内容。
export PGPORT=5432
export PGHOME=/usr/local/pgsql
export PGDATA=/mnt/db1/pgdata/pgsql
export PATH=$PGHOME/bin:$PATH
export MANPATH=$PGHOME/share/man:$MANPATH
export LANG=en_US.UTF-8
export DATE='date +"%Y%m%d%H%M"'
export LD_LIBRARY_PATH=$PGHOME/lib:$LD_LIBRARY_PATH
export PGHOST=$PGDATA
export PGUSER=postgres
export PGDATABASE=postgres
保存之后，执行命令使环境变量生效。
> source /etc/profile
初始化数据库
初始化 PostgreSQL数据库，切换账号到postgres，进行初始化操作。
> su - postgres
> initdb -D $PGDATA -U postgres --locale=en_US.UTF8 -E UTF8
需要注意的是，如果此处没有切换账号，仍然使用root账号进行初始化时，会反馈错误信息，无法初始化数据库。
可能报出错误信息如下：
initdb: cannot be run as root
Please log in (using, e.g., "su") as the (unprivileged) user that will
own the server process.
报出此错误时需要先执行切换用户命令。
修改数据库参数
修改监听地址权限、端口等信息。
> vim /mnt/db1/pgdata/pgsql/postgresql.conf
需要修改如下内容：
listen_addresses = '*'
unix_socket_directories = '.'
port = 5432
此处需要注意，PostgreSQL默认端口为5432，此处将端口修改为8432。
修改访问权限
> vim /mnt/db1/pgdata/pgsql/pg_hba.conf
添加如下命令
host all all 0.0.0.0/0 trust
所有配置文件修改成功后，执行 exit命令退出 postgres用户。
> exit
设置防火墙规则
> firewall-cmd --zone=public --add-port=5432/tcp --permanent
> firewall-cmd --reload
设置开机自启动
设置开机自动启动服务，并且启动PostgreSQL服务。
> systemctl enable postgresql-10.service
> systemctl start postgresql-10.service
至此PostgreSQL已经安装成功并且启动。
2.2、部署TimescaleDB
安装Cmake
在当前操作系统中检查是否安装了Cmake，如果已经安装，并且版本高于3.4则跳过本操作。
查看版本号命令：
> cmake --version
如果已经安装了Cmake并且版本低于3.4则需要卸载Cmake重新安装更高版本。
卸载Cmake命令：
> yum -y remove cmake
开始安装高版本的Cmake，此处选择版本号为3.10.2。通过wget命令获取安装包，并且进行解压。
> wget https://cmake.org/files/v3.10/cmake-3.10.2.tar.gz
> tar -zxvf cmake-3.10.2.tar.gz && cd cmake-3.10.2
开始编译安装Cmake。
执行命令：
> ./bootstrap
> gmake
> gmake install
查看编译后的cmake版本
执行命令：
> /usr/local/bin/cmake --version
新建软连接
执行命令：
> ln -s /usr/local/bin/cmake /bin/
终端查看版本
执行命令：
> cmake --version
出现版本表示成功！
cmake编译完成。
获取TimescaleDB
通过git命令获取TimescaleDB的安装包。
进入PostgresSQL的安装目录（是否存在强制要求，暂时不确定，不过可以直接放到PostgresSQL的安装目录之下），载TimescaleDB。
> git clone https://github.com/timescale/timescaledb/
> cd timescaledb
获取timescaledb的安装版本。
> wget https://github.com/timescale/timescaledb/archive/1.0.0.tar.gz
编译TimescaleDB
此操作最容易发生错误，如果发生错误，请仔细查看错误日志。错误日志上都会有详细的错误信息。
开始编译TimescaleDB
执行命令：
> ./bootstrap
> cd ./build && make
> make install
出现如下信息则编译安装成功（可能存在却别）。
[ 2%] Built target sqlupdatefile
[ 4%] Built target sqlfile
[100%] Built target timescaledb
Install the project...
-- Install configuration: "Release"
-- Installing: /home/dege.zzz/pgsql10/share/extension/timescaledb.control
-- Installing: /home/dege.zzz/pgsql10/share/extension/timescaledb--1.0.0.sql
-- Installing: /home/dege.zzz/pgsql10/share/extension/timescaledb--0.7.1--0.8.0.sql
-- Installing: /home/dege.zzz/pgsql10/share/extension/timescaledb--0.1.0--0.2.0.sql
-- Installing: /home/dege.zzz/pgsql10/share/extension/timescaledb--0.2.0--0.3.0.sql
-- Installing: /home/dege.zzz/pgsql10/share/extension/timescaledb--0.3.0--0.4.0.sql
-- Installing: /home/dege.zzz/pgsql10/share/extension/timescaledb--0.4.0--0.4.1.sql
-- Installing: /home/dege.zzz/pgsql10/share/extension/timescaledb--0.4.1--0.4.2.sql
-- Installing: /home/dege.zzz/pgsql10/share/extension/timescaledb--0.4.2--0.5.0.sql
-- Installing: /home/dege.zzz/pgsql10/share/extension/timescaledb--0.5.0--0.6.0.sql
-- Installing: /home/dege.zzz/pgsql10/share/extension/timescaledb--0.6.0--0.6.1.sql
-- Installing: /home/dege.zzz/pgsql10/share/extension/timescaledb--0.6.1--0.7.0.sql
-- Installing: /home/dege.zzz/pgsql10/share/extension/timescaledb--0.6.1--0.7.1.sql
-- Installing: /home/dege.zzz/pgsql10/share/extension/timescaledb--0.7.0--0.7.1.sql
-- Installing: /home/dege.zzz/pgsql10/lib/timescaledb.so
配置postgresql.conf，在数据库启动时自动加载timescale lib库。
vi $PGDATA/postgresql.conf
shared_preload_libraries = 'timescaledb'
pg_ctl restart -m fast
对需要使用timescaledb的数据库，创建插件.
psql
psql (10.2)
Type "help" for help.
postgres=# create extension timescaledb ;
执行后会展示如下信息：
waiting for server to shut down.... done
server stopped
waiting for server to start....2018-11-14 15:42:53.803 CST [8593] LOG: listening on IPv4 address "0.0.0.0", port 5432
2018-11-14 15:42:53.803 CST [8593] LOG: listening on IPv6 address "::", port 5432
2018-11-14 15:42:53.845 CST [8593] LOG: listening on Unix socket "./.s.PGSQL.5432"
2018-11-14 15:42:53.929 CST [8594] LOG: database system was shut down at 2018-11-14 15:42:53 CST
2018-11-14 15:42:53.954 CST [8593] LOG: database system is ready to accept connections
2018-11-14 15:42:53.955 CST [8600] LOG: TimescaleDB background worker launcher connected to shared catalogs
done
server started
[postgres@localhost ~]$ exit
logout
[root@localhost build]# psql
psql (10.2)
Type "help" for help.
postgres=# create extension timescaledb;
2018-11-14 15:43:26.909 CST [8605] WARNING:
WELCOME TO
_____ _ _ ____________
|_ _(_) | | | _ \ ___ \
| | _ _ __ ___ ___ ___ ___ __ _| | ___| | | | |_/ /
| | | | _ ` _ \ / _ \/ __|/ __/ _` | |/ _ \ | | | ___ \
| | | | | | | | | __/\__ \ (_| (_| | | __/ |/ /| |_/ /
|_| |_|_| |_| |_|\___||___/\___\__,_|_|\___|___/ \____/
Running version 1.0.0
For more information on TimescaleDB, please visit the following links:
1. Getting started: https://docs.timescale.com/getting-started
2. API reference documentation: https://docs.timescale.com/api
3. How TimescaleDB is designed: https://docs.timescale.com/introduction/architecture
Note: TimescaleDB collects anonymous reports to better understand and assist our users.
For more information and how to disable, please see our docs https://docs.timescaledb.com/using-timescaledb/telemetry.
2018-11-14 15:43:26.909 CST [8605] CONTEXT: PL/pgSQL function inline_code_block line 3 at RAISE
WARNING:
WELCOME TO
_____ _ _ ____________
|_ _(_) | | | _ \ ___ \
| | _ _ __ ___ ___ ___ ___ __ _| | ___| | | | |_/ /
| | | | _ ` _ \ / _ \/ __|/ __/ _` | |/ _ \ | | | ___ \
| | | | | | | | | __/\__ \ (_| (_| | | __/ |/ /| |_/ /
|_| |_|_| |_| |_|\___||___/\___\__,_|_|\___|___/ \____/
Running version 1.0.0
For more information on TimescaleDB, please visit the following links:
1. Getting started: https://docs.timescale.com/getting-started
2. API reference documentation: https://docs.timescale.com/api
3. How TimescaleDB is designed: https://docs.timescale.com/introduction/architecture
Note: TimescaleDB collects anonymous reports to better understand and assist our users.
For more information and how to disable, please see our docs https://docs.timescaledb.com/using-timescaledb/telemetry.
CREATE EXTENSION
3、维护
维护后期会持续更新。