Table of contents
Updated at 2020-03-20 16:00:22

1. You can't deploy service on IP for the following reasons:

  1. each service has at least one obj to serve foreign clients;

  2. each service has a obj for administration, it binds to ip and the same port which servant obj binds to.

2. Tars consists of RPC framework, basic services, web management system, etc.

The RPC framework supports C++ and Java. Each language has its related baselib, idl generate-code tools, and implementation of client's and server's code.

The C++ stuff only supports run on linux, the Java's supports run on linux & windows.

The basic framework is developed by C++, on linux.

3. The software and tools that Tars depends must be prepared before deploy Tars, see

4. The steps of deploying Tars must follow the specified order described in

5. Mysql can be installed from source code or by yum. Be care that Tars will search mysql library at the path /usr/local/mysql/ by default .

If mysql is installed in different path, please modify the CMakeLists.txt (framework/tarscpp/CMakeLists.txt, framework/CMakeLists.txt) before compiling.

6. After executing of, please execute command ps -ef|grep tars to check that the core service processes of Tars are alive, ie, tarsregistry, tarsAdminRegistry, tarsnode, tarsconfig and tarspatch.

7. If you haven't set sql_mode in file my.cnf which mysql used, then when deploy tars web management system, you'll see the tips Deploy failed! Contact admin please..


8. You should compile tars java framework at first, because web management system depends on some jar package offered by tars java framework.


9. There are two kinds of framework services: core services(required), must be deployed and updated by yourself. The others are general services, can be update via management system.

The core services:


The general services:


The command make framework-tar pack core services, the core services can't be seen on management system except tarsconfig and tarspatch.

When you deploy general services via web management platform, be care of selection of the name and protocol of the obj.

10. The paths in which services deployed as below:

Log file path: /usr/local/app/tars/app_log/${Application}/${ServiceName}/, such as


Executable file path: /usr/local/app/tars/tarsnode/data/${Application}.${ServiceName}/bin/, such as


Template config file path: /usr/local/app/tars/tarsnode/data/${Application}.${ServiceName}/conf/, such as


Cache file path: /usr/local/app/tars/tarsnode/data/${Application}.${ServiceName}/data/, such as


11. How to check logs

For example, there will be a log file named Test.HelloServer.log in directory /usr/local/app/tars/app_log/Test/HelloServer/. If something failed, please check it.

12. When deploy java service, please select tars.tarsjava.default as template.


13. If you upload file which size is larger than 50MB, modify spring-context-mvc.xml as below:


The source path is web/src/main/resources/conf-spring, deploy path is WEB-INF/classes.

14. Check query conditon if you have problem with monitor data.


15. messy code in resin.

No such problem in English environment.

16. Can not find dependents when compile mvn.


Compile framework first.

17. Failed because can't connect to registry.


Check the core services are alive, ie, tarsregistry、tarsAdminRegistry、tarsnode、tarsconfig、tarspatch. Such as use the command to check:

ps -ef|grep tars

If any of them is not exist, check the db configuration.

Then check whether rsync process exists.

Finally check error logs of tarsnode.


Check section 4.3 of about web management system installation, the correct configuration is as following:


one of the error configurations is as following:


18. Failed and find the size of tars java war is different

check if the machine installed unzip

19. No response when publish tgz package with large size

change the 的maxUploadSize in src/main/resources/conf-spring/spring-context-mvc.xml and restart resein

20. Update old version to support IPv6 (v1.6.0 or later), database update script

Execute the following update script,and make sure that the password od database is right


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

Please restart tarsnode after install jdk