安装指南

本指南将说明如何安装单节点和多节点集群的TigerGraph平台。

准备

这一部分是针对初次安装的。如果想要了解如何从已有版本升级,可以直接读下面的

在开始安装TigerGraph平台之前,首先确认以下事项:

  1. 满足 TigerGraph的软件和硬件要求v2.0 (附录:软硬件要求)的一台或多台linux服务器,并且有充足的内存和磁盘空间来存储图数据。

  2. 超级用户权限。

  3. TigerGraph提供的授权密匙。

  4. TigerGraph平台的安装包。

  5. 如果安装包是以tar.gz为后缀的文件,请准备必须的软件。

下载TigerGraph安装包

如果你还没有TigerGraph的安装包,你可以从以下地址获取www.tigergraph.com.cn/download/

以tar.gz为后缀的安装包必须软件依赖

如果安装包的后缀是tar.gz,那么在安装之前必须要确认系统中有以下必要的软件。

  1. 事先确保安装好以下Linux系统基础工具:

    • tar

    • curl

    • ip

    • more

    • uuidgen

    • crontab

    • ssh/sshd (确保开启超级用户访问权限)

    • netstat

    • semanage

  2. 如果要安装集群的话,还要安装:

    • ntpd

    • iptables/firewalld

    • iptables-persistent

  3. 如果选择密码登录方式代替SSH密匙的方式安装,那么需要安装:

    • sshpass

单节点安装

  1. 解压安装包:

    # 示例:解压2.0.0版本
    
    tar -xzf tigergraph-2.0.0-offline.tar.gz
  2. 将有一个名为 tigergraph-<version>-offline 的文件夹被创建出来。进入这个文件夹。用默认的配置来安装,只需要执行 install.sh 并带上-s的参数就可以了:

    # 安装的单机版本是2.0.0
       
    sudo ./install.sh -s

    安装的过程中将会问一些问题:

    • Do you agree to the License Terms and Conditions?

    • What is your license key?

    • Do you want to use the default TigerGraph user name or select/create your own?

    • Do you want to use the default TigerGraph user password or create your own?

    • Do you want to use the default installation folder or select/create your own?

    默认设置的具体内容和如何自定义安装将在后面的安装选项中详细说明。

  3. 安装程序将用su指令切换到tigergraph用户。

    确定是否安装成功:

    a. 可以尝试命令  `gadmin status`
    
    如果系统成功安装,命令执行后将会输出**zk**,**kafka**,**dict**,**nginx**, **gsql**和**Visualization**已经启动
    
    并且就绪。因为一开始系统中还没有数据,所以**gse**,**gpe**和**restpp**并没有初始化。
    
    b. 尝试命令  `gsql —version`
  4. 基本的安装操作就是这些!可以去看下面的安装之后的一些提示。

安装选项

如果没有指定选项,那么将会按照以下默认配置安装:

  • 安装程序将创建用户tigergraph,密码是tigergraph

  • 安装好的程序的根目录(即为 <TigerGraph.Root.Dir>)将是在TigerGraph用户目录下一个叫tigergraph的文件夹,例如:/home/tigergraph/tigergraph

在执行install.sh脚本的同时,指定选项可以自定义安装:

[选项]:
-h -- 查看帮助
-u -- TigerGraph用户名 [默认: tigergraph]
-p -- TigerGraph密码 [默认: tigergraph]
-r -- TigerGraph安装根目录 [默认:<TigerGraph用户路径>/tigergraph]
-l -- TigerGraph 许可密匙
-s -- 单节点选项: 在一台服务器上安装tigergraph平台
-c -- 集群选项: 将tigergraph安装在集群上
-n -- 非交互选项:用默认的选项安装
[注意]: 
如果用 -c -n 一起使用将会非交互的方式安装tigergraph平台到集群上,配置使用的是“cluster_config.json”这个文件的内容。在这种情况下,配置文件需要在安装前更改好并且其他的选项将会被忽略。

集群安装和配置

TigerGraph集群可以将图数据分片在多台可以内网通讯的服务器节点上。这个集群可以是物理上的集群,也可以只是网络上的虚拟集群比如亚马逊提供的EC2。

  1. TigerGraph 2.0可以安装在亚马逊云服务EC2或者物理集群上。对于EC2需要确保所有的tcp端口对于集群中的所有节点都是相互开放的,否则服务将不会启动成功。

  2. 安装TigerGraph系统的机器可以在集群内部也可以在集群外部,如果是集群外的话,需要是在一台装有Linux操作系统的机器。

  3. 目前,在集群中的每一台机器都必须是拥有相同用户名和密码的超级用户或者拥有SSH密匙。

在配置集群的过程中,需要提供以下信息:

  • 每一个节点的ip地址,比如:172.30.3.2

  • 节点的访问权限

集群安装总览

下载TigerGraph安装包到集群中的任意一台机器上或者是一台可以访问集群网络的机器上。当执行安装脚本的时候,会出现上文提到的那些安装配置问题,如果选择非交互安装,将会读取安装包文件夹中cluster_config.json的内容。安装程序将会将TigerGraph的服务安装到集群中的每一个节点服务器上。

交互模式安装

在交互模式下,安装程序会和之前的单节点安装一样问一些基本的问题。然后会询问节点中有多少台机器,这些机器的ip分别是什么,然后会给这些机器分配名字为m1,m2,m3等。然后会询问这些机器的超级用户的用户名和许可信息。最后将会询问是否接受安装程序对系统进行的修改(下面的非交互模式将详细讲解访问许可的内容)。下面是交互模式安装的截图:

非交互式模式安装

在非交互模式安装之前,需要将所有的配置信息都在tigergraph-2.0.0-offline/cluster_config.json文件中配置好。

两个关键的参数配置如下:

  1. node.ip

集群中的每一台机器都被定义为键值对,键就是服务器被代指为m1,m2,m3等,可以添加任意多的键值对,在值的位置填写上服务器的ip地址。安装程序将自动检测本地网络来配置网络。如果本地IP地址不止一个,安装程序将会询问选择哪一个来配置。

  1. nodes.login

支持两种登录方式:

  • SSH密码

  • SSH密匙文件

对于SSH密码登录,必须要输入居然具有超级用户权限的用户名称和密码。对于SSH密匙文件登录方式,需要指定亚马逊EC2的密匙文件或者其他密匙文件。如果什么都没有提供,安装程序会用默认的ssh密匙文件比如~/.ssh/id_rsa

下面是一个cluster_config.json的例子。

# 示例:ccluster_config.json

{
  "tigergraph.user.name": "tigergraph",
  "tigergraph.user.password": "tigergraph",
  "tigergraph.root.dir": "/home/tigergraph/tigergraph",
  "license.key": "91583b19abf850cee381168e0e0cd41fcaceba2d734cd3a9e6f5fd393eda71171519710003",
  "nodes.ip": {
    "m1": "172.30.3.2",
    "m2": "172.30.3.3",
    "m3": "172.30.3.4",
    "m4": "172.30.3.5"
  },
  "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 sudo user, same password, or same key file",
    "chosen.method": "K",
    "P": {
        "sudo.user.name": "sudoUserName",
        "sudo.user.password": "sudoUserPassword"
    },
    "K": {
      "sudo.user.name": "centos",
      "ssh.key.file": "/home/centos/.ssh/gsql_east.pem"
    }
  }
}

集群安装命令

在修改好配置文件后,就可以做开始准备安装。

  1. 解压安装包。

    # 示例:解压版本为2.0.0
    
    tar -xzf tiger graph-2.0.0-offline.tar.gz
  2. 一个名为tigergraph-<version>-offline的文件夹将被创建出来。进入这个文件夹。用-c选项来开始交互式的分布式安装:

    # 示例:要交互式安装的分布式版本为2.0.0
    
    cd tigergrah-2.0.0-offline
    
    ##  方法1. 交互式
    
    ./install.sh -c

    如果想要非交互式使用cluster_config.json来配置安装,就要使用选项-c -n(也可以合并写成-cn

    # 示例:非交互式安装的分布式版本为2.0.0
    
    cd tigregraph-2.0.0-offline
    
    ## 方法2. 非交互式
     # 第一步:修改配置文件 "cluster_config.json"
     # 第二步:
     
    ./install.sh -cn
  3. 安装程序将会提示你登录节点m1,并且用su来切换到你的tigergraph账户

    确定是否安装成功:

    a. 可以尝试命令  `gadmin status`
    
        如果系统成功安装,命令执行后将会输出**zk**,**kafka**,**dict**,**nginx**, **gsql**和**Visualization**已经启动
    
               并且就绪。因为一开始系统中还没有数据,所以**gse**,**gpe**和**restpp**并没有初始化。
    
           b. 尝试命令  `gsql —version`
  4. 基本的安装操作就是这些!可以去看下面的安装之后的一些提示

安装之后的一些提示

修改密码

如果安装用的是默认密码,那么建议还是应该更换下密码。

其他的定制化

需要执行一些其他的额外配置,需要执行gadmin —configure(如果是集群必须在节点m1),然后执行gadmin config-apply.gadmin config-apply这个命令也必须执行在集群中的m1上。因为只有m1上才包含有pkg_pool的资源。如果你设置了更多的关于以下模块的的配置gpe.servers,gse.servers,restpp.servers,kafka.servers,zk.servers,dictserver.servers,gpe,replicas或者ges.replicas,你需要在节点m1上执行gadmin pkg-install reset来重新安装包。

学习如何使用TigerGraph

如果是第一次使用:

  1. 尝试跑一些实例:到<TIgerGraph的根目录>/document/DEMO文件夹下,运行./RUN_DEMO.sh

  2. 开始设计图结构,使用可视化界面。可以参考TigerGraph GraphStudio UI Guide

  3. 利用教程来学习GSQL这门语言,例如GSQL 101

将现有的系统的升级到最新

开发版不适用

开发版不支持从一个版本升级到另一个版本。 也无法将开发版升级到企业版。

本文将介绍升级到2.1版本的具体步骤。如果你需要查询其他版本的升级步骤(例如从1.1升到1.2),请参阅相关文档。

从v2.0升级到v2.1

v2.0版本可以升级为2.1企业版。v2.0版本的数据存储格式和GSQL语言脚本格式都向上兼容v2.1。

从v1.x升级到v2.x

单节点模式下,1.x的数据格式可向上适配到2.x版本中,但反向则不兼容。用户在从1.x升级到2.x时,不需要重新导入数据或创建图数据库纲目。但由于两个版本的GSQL语言仍有些许差别,所以某些加载作业和查询可能还是需要修改和重新安装。

集群模式下,当前不支持直接从1.x直接升级到2.x。你需要先把数据和元数据从1.x中导出,然后安装2.x版本,再将导出的数据和元数据导回新版本的系统中。与此同时,还必须进行一些必要的修改。如您需要相关细节,请联系我们的技术人员获得帮助:support@tigergraph.com

有关现有版本和目标升级版本的具体变动细节,可参阅版本说明(Release Notes)或联系我们的技术人员获得帮助:support@tigergraph.com

直接升级的操作步骤

  1. 请确认你的目标版本与现有版本的数据存储格式是兼容的。

  2. 仔细比较版本之间的变动并评估升级对应用的实际影响(包括加载作业和查询)。

  3. 停止向现有的TigerGraph系统提交任何请求并等待已提交的请求动作全部完成。

  4. (建议) 备份现有数据以防万一。

  5. 按照本文开始处新装机的步骤操作,安装程序会自动关闭TigerGraph系统并在升级完成后重新打开它。

请确保安装过程中使用的用户名和现有用户名相同。假设你使用了不同的用户名,则整个升级过程会被系统认为是一次全新安装,则在安装完成后你只能得到一个空的图数据库。

  1. 请仔细关注升级过程中的各种消息提示。其中的某些可能需要你手动介入并执行一些操作。

  2. 在升级完成并第一次运行gsql时,它会执行两个重要的操作:

    1. 将你的旧系统中的目录文件(catalog)复制到新的系统中。

    2. 比较旧的/dev_datetime/gdk/gsql/src目录下的文件和新的/dev/gdk/gsql/src目录下的文件。若新文件夹中缺失了某些文件,我们需要重点关注并找到原因,必要时需要将缺失的文件从旧文件夹复制到新文件夹中。下面是一个示例:

  3. 根据实际情况修改加载作业和查询。

Last updated