tarsdocs
  • Readme.md
  • CLA
  • LICENSE
  • 基础介绍
    • 简介
    • 基础概念
    • 基础通信协议 Tars
    • 统一通信协议 Tup
    • 开发模式介绍
    • 模板配置
    • 服务市场
    • 服务扩展
    • 框架版本说明
  • 开源版框架介绍
    • 开源版本部署
      • 部署总体介绍
      • Docker环境安装
      • Mysql安装
      • 框架源码部署(Linux/Mac)
      • 框架源码部署(Windows)
      • 框架Docker部署
      • 框架节点部署
      • 业务服务容器化
      • 框架K8SDocker 部署
      • 框架K8STARS 部署
      • 框架K8SFramework 部署(强烈推荐)
      • 框架更新及扩容
      • 调用链升级注意事项
      • TarsWeb-v3.0.3升级说明
    • 开源版管理平台
      • TarsWeb说明
      • web用户体系
      • web管理平台 API
  • 企业版本介绍
    • 企业版说明
    • 框架集群化机制
    • 框架单节点机制
    • 使用二进制包部署
    • 使用容器部署
    • 业务服务一主多备机制
    • 命令行控制终端
    • IP-LIST级联缓存机制
    • 多数据中心管理
    • 多网络支持
    • 第三方服务管理
    • 数据产生和管理机制
    • 密码重置
    • TarsPython介绍
  • 框架关键特性
    • 业务配置
    • 服务监控
    • 无损发布/重启
    • 调用链
    • IDC分组
    • 鉴权功能
  • TarsCPP
    • 编译
    • 快速开发入门
    • 使用指南
    • 开发规范
    • 服务线程说明文档
    • protobuf 协议支持文档
    • 第三方协议支持
    • HTTP1 支持
    • HTTP2 支持
    • TLS 通信支持
    • Push 功能说明
    • PushCallback 功能说明
    • Cookie 支持
    • 队列模式
    • 手动绑定
    • 性能数据
    • 2.x 版本变化
    • 3.x 版本变化
    • 协程版本说明
    • 基础类库说明
    • [案例]
      • 框架快速入门
      • Http 服务示例
  • TarsJava
    • 快速开始
    • 快速开发入门
    • [使用指南]
      • Tars 服务开发与上线
      • HTTP 服务开发与上线
      • 生成接口调用文件
    • [性能测试]
      • tars java 压测代码
  • TarsGo
    • 基本介绍
    • 快速开始
    • 使用指南
    • cmake 管理代码
    • pb2tarsgo
    • 性能数据
    • 使用示例
  • TarsPHP
    • 搭建 php 环境
    • 快速开发入门
    • [快速起步]
      • 搭建 HttpServer
      • 搭建 TimerServer
      • 搭建 TcpServer
      • 搭建 WebSocketServer
      • 弹幕活动实战
    • [框架简介]
      • 简介
      • tars-server
      • tars-client
      • tars-config
      • tars-deploy
      • tars-extension
      • tars-log
      • tars-monitor
      • tars-registry
      • tars-report
      • tars-utils
      • tars2php
    • [高阶应用]
      • PHP 的 Swoole 框架如何接入 Tars
      • 与 thinkphp 结合使用
      • 与 Swoft 结合使用
      • 与 Laravel 结合使用
      • 与 Yii2 结合使用
      • 持续集成方案
    • [其他]
      • 常见问题
      • 如何 Debug
      • changelog
      • 其他外部文档
  • Tars.js
    • 基本介绍
    • 脚手架
    • 快速开发入门
    • @tars/stream
    • @tars/rpc
    • @tars/logs
    • @tars/config
    • @tars/monitor
    • @tars/notify
    • @tars/utils
    • @tars/dyeing
    • @tars/node-agent
    • @tars/winston-tars
    • tars2node
  • K8SFramework
    • [安装和使用说明]
      • 介绍
      • 特性
      • 安装
      • 升级
      • 云原生运维
      • 管理平台
      • 证书
    • [开发环境构建]
      • Dockerfile 说明
      • 服务发布流程说明
      • 制作基础编译镜像
      • 制作业务服务镜像
      • 制作 Helm 包
      • 发布业务镜像到 K8S 集群
      • 服务发布示例
      • 如何调试业务服务
  • 服务扩展
    • 云告警
    • 接口及压测工具
    • 网关服务
    • dcache缓存服务
    • 发送邮件服务
    • 一致性存储服务
    • 一致性存储web管理平台
    • 唯一计数服务
  • 常见问题
    • 安装常见问题
    • Issues
    • Issues-tarscpp
    • Issues-tarsjava
    • Issues-tarsgo
    • Issues-tarsphp
  • 开源合作
    • TarsFramework 项目 Git 合作规范
  • 直播视频
    • B 站 TARS 培训系列课程
  • 相关文章
    • TARS 技术文章
  • 其它资源分享
    • 下载
    • Tars 介绍.pptx
    • TarsPHP 解密.pdf
    • TarsJava 本地调试.pdf
    • 微服务在腾讯的业务实践.pptx
Powered by GitBook
On this page
  • 安装常见问题
  • 11. tarsnode can not run java server: cannot execute java
  • TarsCPP 常见问题
  • TarsJava 常见问题
  • TarsNodejs 常见问题
  • TarsPHP 常见问题

Was this helpful?

  1. 常见问题

安装常见问题

Previous唯一计数服务NextIssues

Last updated 2 years ago

Was this helpful?

安装常见问题

1. 部署ip不能为127.0.0.1,原因如下:

  1. 每个服务一般都有一个或者多个对外服务的obj,obj要对外提供访问,不能用 127.0.0.1;

  2. 每个服务都有一个管理的obj,它使用的ip是127.0.0.1,端口和obj的端口一样;

2. Tars主要包括rpc开发框架、框架基础服务、web管理系统。

其中,rpc开发框架支持c++, java, php, go, nodejs,都有自己的基础库、idl代码生成工具、客户端和服务端实现,互不依赖。

且都可以运行在linux/mac/windows

3. Tars依赖的软件或者工具,在部署Tars时,必须事先安装好,参见 .

4. Tars部署安装步骤要按 文档先后顺序进行。

5. 执行tars_start.sh脚本后,需要确定一下tars核心基础服务的进程是否是活的

可以使用命令:ps -ef|grep tars,看看 tarsregistry、tarsAdminRegistry、tarsnode、tarsconfig、tarspatch进程是否存在

6. 服务部署的相关路径,如下

服务打的日志路径在 /usr/local/app/tars/app_log/${服务的应用名}/${服务的服务名}/ 目录下,例如:

/usr/local/app/tars/app_log/Test/HelloServer/

服务的可执行文件在 /usr/local/app/tars/tarsnode/data/${服务的应用名}.${服务的服务名}/bin/ 下,例如:

/usr/local/app/tars/tarsnode/data/Test.HelloServer/bin/

服务的模版配置文件在 /usr/local/app/tars/tarsnode/data/${服务的应用名}.${服务的服务名}/conf/ 下, 例如:

/usr/local/app/tars/tarsnode/data/Test.HelloServer/conf/

服务的缓存信息文件在 /usr/local/app/tars/tarsnode/data/${服务的应用名}.${服务的服务名}/data/ 下,例如:

/usr/local/app/tars/tarsnode/data/Test.HelloServer/data/

7. 查看日志的方法

例如:

/usr/local/app/tars/app_log/Test/HelloServer/ 目录下会有 Test.HelloServer.log , 发布失败的话,可以看看里面有什么错误日志,其日志级别为ERROR。

8. java的服务部署时,模版配置要选择 tars.tarsjava.default

9. 服务监控数据展示问题,注意查询条件

10. 老版本升级到支持IPv6版本(v1.6.0及以上),数据库升级方法

执行以下数据库升级脚本,注意保证数据库密码正确性

TarsFramework/sql/upgrade2IPv6.sh

11. tarsnode can not run java server: cannot execute java

安装jdk以后重启tarsnode

/usr/local/app/tars/tarsnode/util/start.sh

TarsCPP 常见问题

Tars C++开发环境如何搭建?

  • 参考tars_install.md

Tars C++如何快速上手?

  • 文档参考tars_cpp_quickstart.md,相关示例代码参考examples目录

tars/tup协议是什么?

  • 具体参考tars_tup.md

Tars C++是否支持自定义协议(比如:http)?

  • Tars C++除了支持tars/tup协议之外,还支持业务自定义协议,具体参考tars_cpp_thirdprotocol.md

Tars C++如何拉取业务配置文件?

  • Tars C++支持通过使用addConfig方法获取指定的业务配置文件,业务配置相关远离,可以参考tars_config.md

在Tars框架中运行的服务是如何被监控的?

  • 具体参考tars_server_monitor.md

Tars C++通讯器如何创建?

  • 如果服务基于TAF框架,请直接从Applicatin获取,不要自己创建。例如:

Application::getCommunicator()->stringToProxy<NotifyPrx>(ServerConfig::Notify);
  • 如果服务非基于TAF框架,只是TAF客户端,可以用new Communicator(conf) 初始化通信器。例如:

TC_Config conf(“config.conf”);
CommunicatorPtr c = new Communicator(conf);

Tars C++调用的超时时间如何设置?

  • 具体参考tars_cpp_user_guide.md

服务发布后但没有运行怎么查看原因?

  • 是否服务配置文件没有正确获取。例如:在web平台上配置的配置文件名与在程序add下载的配置文件名不一致。

  • 查找问题时,首先看web上"服务当前报告"是否提示正常,例如:配置文件有没下载成功,服务启动时下载的配置文件。

  • 再查找服务自己打印log日志。日志一般在/usr/local/app/tars/app_log/应用名/服务名/目录下。

  • 若仍有问题请查看node日志。

core文件如何打开,生成在什么地方?

  • core文件是在tafnode启动脚本添加ulimite -c unlimited 打开,目前core文件生成在 /usr/local/app/tars/app_log下.

主控Registry故障是否会影响业务服务的正常访问?

  • 不会影响业务服务正常访问,框架底层会缓存后端服务的ip列表。

通讯器Communicator是如何通过ServerName获取ip:prot的?

  • 1.创建代理,并不会请求主控获取ip列表,而是调用代理的接口时才会触发请求主控ip列表

  • 2.如果obj后面有ip列表信息,相当于直连,这个是不会请求主控registry的

  • 3.如果obj后面没有ip列表信息,相当于是间接方式,会请求主控registry

  • 4.请求主控registry的策略时,如果本地缓存有请求obj的ip列表,用本地缓存的,同时去异步请求一下主控registry获取最新的ip列表

  • 5.请求主控registry的策略时,如果本地缓存没有请求obj的ip列表,业务的请求会先缓存到队列里,同时异步去请求主控获取ip列表,获取到ip列表后,再从队列里把业务的请求拿出来,发送这个请求

  • 6.6.不是每次都刷新,定时刷新的(默认60s),定时刷新的触发是靠业务请求

TarsJava 常见问题

Tars java开发环境如何搭建?

  • 参考tars_install.md

如何在本地启动和开发调试tars

  • 首先在工程目录下执行 mvn tars:build -Dapp=TestApp -Dserver=HelloJavaServer -DjvmParams="-Xms1024m -Xmx1024m -Dcom.sun.management.jmxremote.ssl=false -Dcom.sun.management.jmxremote.authenticate=false -Xdebug -Xrunjdwp:transport=dt_socket,address=9000,server=y,suspend=n"

  • 在工程目录target/tars/bin/tars_start 启动服务

TarsNodejs 常见问题

为什么egg框架开发的nodejs应用在Tars平台上发布和重启偶尔会失败?

  • egg框架如果不是使用的single mode,会开启一个独立的worker进程来监听端口。当Tars发布或重启时,egg启动的端口监听进程并不会被杀死,导致再次启动时端口被占用,监听失败,服务启动失败。

  • Tars Nodejs的进程管理器node-agent包含了Cluster子进程、异常监控、进程拉起、监控上报等功能。普通的Nodejs程序只要发布上Tars平台自然就拥有了以上特性,无需再自己做进程管理。

TarsPHP 常见问题

问题:php服务的业务日志在哪里查看?

答:/usr/local/app/tars/app_log/$APPNAME/$SERVERNAME/$APPNAME.$SERVERNAME.log 不要忘记同时查看php_error哈

问题:Class 'TARS_Struct' not found in /usr/local/app/tars/tarsnode/data/PHPTest.PHPHttpServer/bin/src/vendor/phptars/tars-report/src/ServerInfo.php on line 5

答:请确认一下phptars扩展是否已经被安装,检查命令:php -m | grep phptars。 安装方式请见/php/php_extension下面的auto和auto7脚本内容以及相应文档

问题:搭建了http和tcp的服务,但是tcp服务无法正确回包,是什么问题?

答:请检查tcp服务状态是否正常,检查php_error、业务日志中是否有权限导致的服务无法启动问题; 请检查tcp服务是否使用了正确的模板,比如不能指定protocolName为http,因为tcp服务一定要使用tars协议进行通信的,并且一定要指定swoole自动拼包的package_length等配置参数; 使用tcpdump -iany -s0 port tcp服务端口 -XNNnn 进行抓包,看http服务是否正常发包给tcp服务了

问题:我可以不通过平台启动php的服务么?

答:显然是可以的,直接到服务目录下:/usr/local/app/tars/tarsnode/data/PHPTest.PHPHttpServer/bin 下面会有两个脚本tars_stop.sh和tars_start.sh,只要有权限,是可以直接启停服务的。

问题: 请求部分tcp的方法可以,但是部分不可以,可能什么原因?

答:一个可能的原因是你使用了format工具,破坏了server端自动生成的注释的结构(比如examples下面的Tars-tcp-server/src/servant/PHPtest/PHPServer/obj/TestTafServiceServant.php)。下载github上面最新的,或者用tars2php重新生成一下server的interface代码都可以解决这个问题。

问题: 调用Java服务, java接收不到参数,表现是报出illegalargumentException 如何解决?

答:之前java对tup的支持,没有放出,现在需要重新编译tars-core和maven-tars-plugin两个jar包, 并在项目的pom.xml中的 plugin配置里,添加true 的字样,这样生成之后就可以支持php调用默认的tup协议了。 重新生成后的接口文件会增加注解:@TarsMethodParameter,这样就能正常解析了。

注意点:

请务必安装phptars扩展 如果使用server,请务必安装swoole扩展

手动安装
手动安装