TigerGraph笔记（一）安装和卸载（centos）

       最近用到TigerGraph（TG），顺便记录一下笔记，以便以后查阅。另外，由于网上关于TG的资料比较少，笔记的大多数资料都是从TG官网获得的，个人理解若有错误之处还请指正。TG官网、官方文档、中文网站、中文文档，在此说明下建议去看英文文档，或者中英文文档结合看。中文文档往往更新不及时、资料不全，而且写的较为晦涩。

       TigerGraph是tigergraph公司开发的原生并行图数据库，支持分布式，支持互联网规模的实时数据分析，其处理速度可见一斑。TigerGraph 采用最新的高效大数据平台的设计理念(大规模并行处理架构和快速数据压缩算法)从零打造，提供了一个高速的、易扩展的，可进行深度探索和查询数据商业价值的企业级图数据平台，底层采用C++设计（速度保证）。这玩意好是好，不过价格也是和速度一样6，具体详情可以去官网咨询。

       现在市场上用的比较出名的图数据库应该就是Neo4j和TigerGraph，其他的还有很多，如TiTan等，但是个人觉得使用的话还是从这两个里面挑一个就好了，毕竟优势还是很大的。Neo4j做的早一些，资料也比较齐全，尤其是中文资料，用户也比较多，并且它的社区版功能也很不错；相比之下TG的资料就比较少，但是最近TG似乎有后来居上的趋势。

       TG提供了开发者版本和企业版，开发者版本永久免费，不过一般只用来学习、研究，用户也可申请30天的企业版试用，关于这两种版本的区别和下载链接，可以点击这里获取。我申请的30天试用License一直验证无效，不通过，所以只能装了一个开发者版本研究下，后面也试用了分布式的企业版。言归正传，后面一一介绍。

安装

       我用的是开发者版本2.2.4，下载的tar包为tigergraph-developer-latest.tar.gz，如果下载的企业版就是tigergraph-2.2.4-offline.tar.gz。如果是安装分布式企业版，请参考最后一节。当然，单机安装也可以参考企业版安装过程，采用非交互式方法安装。安装之前注意事项：
1、在安装之前注意和TG内置服务有关的服务都要先停掉，不知道的，安装过程中TG也会提示你需要停掉XX服务，例如kafka。
2、cd到解压目录，用root用户运行安装脚本。
3、在安装之前确保~目录下有可用空间，因为linux创建新用户需要使用。
4、确保安装目录至少有20G可用空间。
5、如果是开发者版本直接执行 ./install.sh；如果是企业版执行 ./install.sh -s -l License（证书号）。

首先跳出用户协议，不愿意看的直接按q跳出到下面选项：

输入y

设置一个TG的用户，这个也是TG的超级用户，默认名字是tigergraph，如果想换一个输入y，然后输入名字，不想换的输入N，TG会同时为这个用户创建一个Linux用户，后面再执行gsql shell的时候需要切换到这个用户。

这个用户密码默认是tigergraph，想换的话输入y，不想换的话输入N就好了。

TG的安装目录，不改变输N，换路径的话输入y，再输入自定义路径。
稍等五分钟，安装完毕，出现下面界面，并自动切换到tigergraph用户。

输入gsql，就会出现gsql-shell窗口。

输入ls，可以看到没有任何顶点、边、子图等。

输入exit或者quit可以退出gsql-shell
使用 IP:14240可以访问 web ui界面

查看配置信息

##查看TG占用的端口
gadmin --dump-config | grep -i port 
##查看gadmin命令信息       
gadmin -h                     
##修改UI端口号                           
gadmin –configure nginx.services.port   
##再执行下面命令
gadmin config-apply && gadmin restart -fy
##停止服务
gadmin stop -fy

常用的GADMIN命令

1. 查看服务状态：gadmin status  ##如果某个服务出现问题，可以先用此条命令查看状态
2. 启动服务： gadmin start
3. 停止服务： gadmin stop -fy
4. 重启服务： gadmin restart -fy
5. 修改配置： gadmin --configure
6. 应用配置： gadmin config-apply
7. 修改runtime变量： gadmin --configure runtime
8. 查看license有效期： gadmin status license
9. 更新license： gadmin set-license-key [new_license]
10. 查看gse log位置： gadmin log -v gse
11. 查看节点和边总个数： gadmin status -v graph
12. 详细信息可以使用 gadmin -h 查看

卸载

以tigergraph用户运行以下命令：

gadmin stop -fy
pkill ts3svc
pkill gadmin_server
##下面这条命令默认没有更改TG的用户名tigergraph，也没有改变安装目录，如果更改了默认信息，请以实际为准
rm -rf ~/tigergraph ~/tigergraph_coredump ~/.gium ~/.gsql ~/.gsql_fcgi ~/.syspre ~/.venv

切换到root用户，kill掉tigergraph相关进程
运行下面命令，删除tigergraph用户：
userdel -r tigergraph

企业版安装

企业版的最大好处是支持HA分布式。另外，TG集群在增加机器的数量以后，对速度的提升也是极大地，具体详情可以参考TG官网。

企业版的安装虽然也可以按照交互式安装，但是不建议采用这种方法，建议采用非交互式方式安装。注意事项和前面单机安装过程差不多（建议先看一下前面交互式安装过程），需要注意的一点是，根据自己的license（TG的license是按照内存卖的，这一点倒是比较特殊）大小注意磁盘的空间大小。TG在每个节点上的安装目录是一样的，所以也需要注意安装目录位置。

1、启动防火墙，启动NTP服务。一定要启动防火墙和NTP，不然后面安装的时候也会打开防火墙。
2、安装sshpass、policycoreutils-python。在安装之前可以通过下面命令查看系统是否已经安装了相关服务。
      rpm -qa | grep sshpass、rpm -qa | grep policycoreutils-python
3、将安装包拷贝到其中一个节点上（只需拷贝到一台服务器即可），修改安装包下的配置文件cluster_config.json，参考下面配置。如果当前节点是m1，则以后的gsql操作都是在m1上操作。系统会自动创建一个你配置的TG用户；chosen.method选择的是P，也即是以密码登录，也可选择ssh-key登录；HA配置是false，后面会手动配置HA功能。

{
  "tigergraph.user.name": "TG用户名",
  "tigergraph.user.password": "上面用户密码",
  "tigergraph.root.dir": "安装目录",
  "license.key": "秘钥",
  "nodes.ip": {
    "m1": "m1 IP",
    "m2": "m2 IP",
    "m3": "m3 IP",
    "m4": "m4 IP"
  },
  "nodes.login": {
    "supported.methods (this is a comment)": "P. SSH with password; K. SSH with key file (e.g. ec2_key.pem)",
    "notes (this is a comment)": "All nodes must use the same ssh port, same sudo user, same password, or same key file",
    "ssh.port": "22",
    "chosen.method": "P",
    "P": {
        "sudo.user.name": "root",
        "sudo.user.password": "root密码"
    },
    "K": {
      "sudo.user.name": "sudoUserName",
      "ssh.key.file": "/path/to/my_key.pem (if empty, the installer will use default ssh key file such as ~/.ssh/id_rsa)"
    }
  },
  "HA.option": {
    "Notes of HA.option (this is a comment)": "option to install high-availability cluster (with at least 3 nodes), default value false",
    "enable.HA": "false"
  }
}

4、执行 ./install.sh -cn 。c是分布式安装，n是非交互式安装。TG只需在一台机器上执行这条命令即可，会自动把程序安装到你配置的m1、m2、...节点上去，安装目录相同。安装完毕后会自动切换到tigergraph用户。

5、配置HA
停止TG：
    gadmin stop ts3 -fy
    gadmin stop all -fy
    gadmin stop admin -fy

启用HA：
    gadmin --enable ha

安装软件包：
    gadmin pkg-install reset -fy

6、激活GraphStudio
打开 IP:14240，点击右上角图标感叹号图标，点击下拉的最后一项信息，输入license即可。

更新license

1、系统license更新
在tigergraph用户linux shell下执行：gadmin set-license-key license

2、GraphStudio license更新
打开GraphStdio，点击右上角感叹号，可以看到status是Expired。

点击UPDATE输入新的license即可。