4.1.0 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

  • First, check server machine's specification.
  • 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?

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 whether 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. 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

2) No Captcha image in adminWeb's login - Please install fontconfig for java.

ERROR: com.imptt.proptt.debug - captcha e=java.lang.NullPointerException
      at sun.awt.FontConfiguration.:1264)
      at sun.awt.FontConfiguration.readFontConfigFile(FontConfiguration.java:219)
      at sun.awt.FontConfiguration.init(FontConfiguration.java:107)

In CentOS, "yum install fontconfig" and restart ProPTT2 servers
(Some java package don't have the font)
Please refer to https://stackoverflow.com/questions/30626136/cannot-load-font-in-jre-8

3.2 Loc log

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

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

If loc-server is not started and you can find "MyIP=null" in the log, it is server name would be mismatched.
2016-11-01 06:32:35.071 +0000 main INFO - SourceFile main(196) hostname=
2016-11-01 06:32:35.081 +0000 main INFO - SourceFile main(198)

3.3 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