2.1.1 Installation trouble shooting

1. Installation failure

2. Connection failure

After server package installation, first trouble would be client's connection failure.

2.1 Check list

  • Check whether servers are started normally?
  • Check whether ports are opened?
  • Check hostnames are same?
  • After server's external IP changing, do you restart all server?
  • MySql 5.7.5+ has a issue with ProPTT2.

2.2 Check whether servers are started normally?

You need to check whether servers are opened. We recommand to use telnet client to test it in server in-side.
If there is a problem, you need to check server starting.

2.3 Check whether ports are opened?

You need to check whether ports are opened. Client is using below ports.
8080, 8088, 41022, 41322, 41323, 41324, 41342, 41343
We recommand to use telnet client to test it in external computer.
If there is a problem, you need to check network. (Firewall, Port-forwarding etc)

Sometimes server system use IPv6 by default. Then servers are binded to IPv6. You can check it by below command.
In this case, when server is started, you need to set up the Java option. "-Djava.net.preferIPv4Stack=true"
The option need to be added at java run command in each server's startup script file. (start-server.bat/start-server.sh, Tomcat's catalina.bat/catalina.sh)

2.4 Check hostnames are same?

Thare are 3 hostnames. They must be all same.
- server name of server in adminWeb.
- hostname in server machine.
- hostname in /etc/hosts file in server machine.
ProPTT2 servers check information by hostname.

2.5 Internally the app can access the server but when we try to access from the outside using our WAN IP we can't connect.

If there is no firewall issue, you have to change ProPTT2 server's exteral IP to public IP.
It can be changed at server setup in adminWeb and need to restart all servers.

1) Port issue - server test is failure.

ProPTT2 server's ports must be opened in NAT configuration.

2) NAT IP issue - client login is failure.

Sometimes NAT changed client's IP to NAT IP. For routing to External IP or Internal IP of ProPTT2 server, ProPTT2 server is using client IP to detect client's location. (In B class, 192.168.*.*) So if NAT changed it, ProPTT2 server would route to internal IP. And internet client can not login. (Only server test would be successful)
NAT must support keeping client IP.
In provisionning process, ProPTT2 server is using HTTP. If NAT can support "X-Forwarded-IP" header, ProPTT2 server can use it.

If it is no problem, you can set public IP to the external and internal IP both.

3) Secure channel issue - client login is failure.

In 4G or LTE of some countries, sometimes the secure channel could have a issue at the login time.
Then you need to set off the secure option in login option. It would be fixed at next server version(3.0.x~).

2.6 MySql 5.7.5+ has a issue with ProPTT2.

Please refer to MySql guide.

3. Log verification

Through server log verification, you can find the reason of issue.

3.1 Tomcat log

tail -f apache-tomcat/logs/catalina.out

1) No license case - Please input server license

INFO : com.imptt.proptt.debug - call getProvision
INFO : com.imptt.proptt.debug - call getProvision
INFO : com.imptt.proptt.error - HTTP,,/pv/provisionUser,getProvision::NoLicensedMgmtHost

3.2 PTT log

tail -f logs/service/PTT.service.log

1) Start failure - Please check server name and IP at server info in adminWeb, hosts file and real server name

2016-11-01 05:26:01.241 +0000 main ERROR - ServiceConfig.java initialize(109)
2016-11-01 05:26:02.978 +0000 main ERROR - PTTServerManager.java main(260) Failed to initialize Config