forked from TarsCloud/Tars
-
Notifications
You must be signed in to change notification settings - Fork 1
/
Install_faq.md
143 lines (87 loc) · 5.21 KB
/
Install_faq.md
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
[点我查看中文版](Install_faq.zh.md)
## 1. You can't deploy service on IP `127.0.0.1` 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 `127.0.0.1` 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 [Install.md](Install.md).
## 4. The steps of deploying Tars must follow the specified order described in [Install.md](Install.md)
## 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 tars_start.sh, 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 by yourself. The others are general services, can be published via management system.
The core services:
|-tarsAdminRegistry
|-tarsregistry
|-tarsnode
|-tarsconfig
|-tarspatch
The general services:
|-tarsstat
|-tarsproperty
|-tarsnotify
|-tarslog
|-tarsquerystat
|-tarsqueryproperty
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
```
/usr/local/app/tars/app_log/Test/HelloServer/
```
Executable file path: `/usr/local/app/tars/tarsnode/data/${Application}.${ServiceName}/bin/`, such as
```
/usr/local/app/tars/tarsnode/data/Test.HelloServer/bin/
```
Template config file path: `/usr/local/app/tars/tarsnode/data/${Application}.${ServiceName}/conf/`, such as
```
/usr/local/app/tars/tarsnode/data/Test.HelloServer/conf/
```
Cache file path: `/usr/local/app/tars/tarsnode/data/${Application}.${ServiceName}/data/`, such as
```
/usr/local/app/tars/tarsnode/data/Test.HelloServer/data/
```
## 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:
```sh
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 Install.md 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
```
TarsFramework/sql/upgrade2IPv6.sh
```