系统维护中的常见问题

如何使用和更新我的注册码?

如果已经拥有一个1.0版本的字符串格式注册码，则你可以选择将该注册码作为参数在初始安装时导入：

./install.sh -l <your_license_key>

也可以选择在系统提示时输入。

如果该注册码为全新，则请使用以下命令：

gadmin set-license-key <your_license_key>

如果你拥有的是一个2.0版本的注册码文件，且该文件指向某台特定的机器或集群，则：

• 如果是第一次安装，或者是对旧注册码文件进行更新，请参考文档： Activating a System-Specific License

• 如果是从1.0版本升级为2.0版本的注册码，请联系 [e-mail] 获取正确的操作步骤。

我的注册码何时过期?

针对1.0版本的注册码，请使用以下命令查看有效期：

gadmin status license

针对2.0版本的注册码文件，请使用以下命令查看有效期：

curl -X GET "localhost:9000/showlicenseinfo"

TigerGraph平台有哪些组件构成?

GPE
GSE
RESTPP
ZK
KAFKA
NGINX
DICT
GSQL
GLIVE
VISUALIZATION (GraphStudio)

关于各组件的详细介绍，请参考 TigerGraph Platform Overview 文档的Glossary章节。

如何查看系统当前状态?

下面的命令可查看当前系统状态：

gadmin status

如果你想得到更多基于单个组件的进程、内存和处理器的信息，请再命令后添加-v参数：

gadmin status -v

如何获得某个服务的端口号?

默认的RESTful API端口号为9000，该参数可在配置中修改。下面的命令可以获得当前RESTful API的端口号：

gadmin --dump-config | grep nginx.port

GraphStudio UI端口号默认为14240 (若TigerGraph的版本为1.2或更早，则端口号为44240)。下面的命令可获得当前配置信息：

gadmin --dump-config | grep nginx.services.port

如果正在使用的是远程GSQL客户端，该客户端通过8123端口与GSQL服务器通讯。

gadmin --dump-config | grep gsql.server.port

该命令列出所有端口：

gadmin --dump-config | grep port

如何备份数据?

GBAR工具用于备份和恢复TigerGraph数据。在开始备份前，GBAR需要做一定的配置。具体细节请参考 数据的备份与恢复文档。

备份当前系统:

gbar backup -t <tag_of_the_backup>

请注意：GBAR只备份数据和配置信息。日志文件和软件本身不会被存档。

如何恢复备份?

从已有备份恢复数据可运行命令:

gbar restore <tag_of_the_backup>

请注意：恢复数据的动作会强制停止所有服务并清除现有数据。

如何获得现有的图数据的统计数据?

下述命令可实现：

gadmin status graph -v

该命令可统计已有图数据的大小，顶点的数目和边的数目。

如何获得系统收到请求的统计数据?

TigerGraph 提供一个RESTful规范的API，可用于统计该数据。假设REST端口号为9000，则命令格式为：

curl -l http://localhost:9000/statistics

如何重启一个服务?

下面的命令可重启所有服务：

gadmin restart

若只想重启某些组件，则可以将组件名添加在命令后：

gadmin restart <component_name(s)>

不同组件间用空格分隔。

如何停止某些或全部服务?

通常情况下，我们没有必要手动停止任何服务。然而，如果真的要做的话，也是可以的：

# 停止（几乎）所有服务
gadmin stop
​
# 停止某些服务
gadmin stop <component_name(s)>

注意：运行 "gadmin stop" 实际上并不能停止所有TigerGraph的服务。例如用于监控其他服务的Ts3服务会仍然运行。Admin server也将仍然运行，用于管理其他服务。如果用户试图完全关闭系统（例如计划进行软件升级或硬件更换），则需要按照以下步骤执行命令：

gadmin stop ts3 -y
gadmin stop -f -y
gadmin stop admin -y

为什么某个服务会停止工作?

服务停止工作的原因有很多，以下为一些常见原因：

1. 注册码过期。请再次确认您的注册码失效时间，若注册码已失效，请联系 [e-mail] 获取帮助。系统在导入新的注册码后便可重新上线。通常TigerGraph会在注册码失效前通知用户，请用户在收到该提示后及时获取新的注册码。

2. 内存不足。TigerGraph的运行需要消耗大量内存空间。当内存不足时，Linux系统可能会自动关闭一些进程。我们建议用户在TigerGraph启动后检查内存使用状况，并确保至少30%的内存可用。使用 dmesg 命令可以检查是否有TigerGraph进程因内存不足而停止运行。

3. 硬盘可用空间不足。TigerGraph在向磁盘写入数据的同时，也会写入一些日志文件和临时文件。足够的可用空间是系统能够正常运行的前提条件。若TigerGraph或其中的某个组件停止工作，请检查系统存储空间是否已满。 df 工具可用于磁盘空间查验工作。

哪里可以找到日志文件?

下面的命令可列出每个组件对应的日志文件位置：

gadmin log

针对某个特定的组件的日志文件：

gadmin log <component>

若用户只想查看日志文件的最后N行：

gadmin log -v [component] [-n number_of_lines]

为何某个请求会超时?

每条系统接收的请求都可能超时。若该请求的运行时间超过的设定的阈值，则该请求会被终止。默认的超时阈值为16秒。

若用户想要增加该超时参数阈值，可运行以下命令：

gadmin --configure timeout_seconds

输入想要设定的参数（单位为秒）；然后将该参数配置到系统并重启服务。

gadmin config-apply gadmin restart

哪里可以找到内核转储文件

内核转储文件是在某个进程意外终止时由操作系统生成的记录文件。该记录文件保存了进程终止瞬间的内存数据镜像；该镜像文件可用于对程序意外终止的原因进行事后分析（例如使用gdb工具）。

TigerGraph进程将操作系统生成的内核转储文件放置在其根目录下，文件名格式为： core-%e-%s-%p.%t，其中：

• %e: 可执行文件名

• %s: 激发dump动作的信号编号

• %p: dump进程的PID名

• %t: 时间 (UNIX Epoch 时间的秒数)

内核转储动作的配置命令格式为：

echo "$coreLocation/core-%e-%s-%p.%t" > /proc/sys/kernel/core_pattern

若用户想要改变转储文件的保存位置，或更改文件名格式，则可以尝试修改配置文件： /proc/sys/kernel/core_pattern