Show last authors
1 When you encounter connection issues, first check the status of the frontend server. To check it, go to the URL {{code language="none"}}http://formcycle.eu/frontend-server{{/code}}.
2
3 {{figure image="frontend_server_error.png"}}
4 No connection: ERROR
5 {{/figure}}
6
7 {{figure image="frontend_server_503.png"}}
8 No connection: NOT_CONNECTED
9 {{/figure}}
10
11 {{figure image="frontend_server_200.png"}}
12 Connection status: CONNECTED
13 {{/figure}}
14
15 == Connection status ==
16
17 {{table width="700"}}
18 |=connected|=note
19 |true|A connection to the master server could be established successfully.
20 |false|There is no connection to the master server.
21 {{/table}}
22
23 === Logical status ===
24
25 There are several possible values for the connection status that you might see:
26
27 {{table width="700" dataTypeAlpha="0" preSort="0-asc"}}
28 |=Status|=Description
29 |CONNECTED|The connection has been established and opened.
30 |NOT_CONNECTED|No connection could be established.
31 |ERROR + error message|An error has occurred while trying to establish a connection. Usually an error message with details will be shown.
32 |DISCONNECTING|The connection is about to be closed.
33 |WAIT_FOR_CONNECTION|The frontend server has been started successfully and is listening on the configured port for an initial connection attempt by the master server.
34 |RECONNECTING|The server is trying to reconnect after the connection was disrupted.
35 |CONNECTING|The server is trying to establish a connection.
36 |AUTHENTICATING|The connection was established and the permissions are checked.
37 {{/table}}
38
39 === HTTP status ===
40
41 The HTTP status code that is returned when you open the frontend server status page. For example, you can use this status code to check the connection programmatically without having to parse the HTML status page.
42
43 ; 200
44 : There is a connection to the master server.
45 ; 503
46 : No connection could be made to the master server.
47
48 == Handling errors ==
49
50 {{warning}}
51 It is important to ensure that the same major Java version is used for the master and frontend server. If this is not the case, no connection can be established between the servers, even if the connection test was successful at some times.
52 {{/warning}}
53
54 === Initial connection fails ===
55
56 1. Check whether the frontend server has been started successfully and whether it is listening on the correct port.
57 1. When it is: Check whether the frontend server can be reached from the master server, for example via Telnet. Possibles reasons it may not be reachable include:
58 11. The firewall is blocking any connection attempt on the configured port.
59 11. The network architecture prevents the servers from seeing each other.
60 1. When the above applies: Check whether a key has already been assigned to the frontend server. When a key has already been assigned, an error message as shown in the screenshot to the right indicates this.
61 1. Sometimes restarting the application or the server may solve the issues.
62
63 ==== Connection closed (Connection could be established before) ====
64
65 When the connection to the frontend server cannot be established again automatically, it can be opened manually from the master server.
66
67 This requires the following steps:
68
69 1. Open the configuration interface of the master server in a web browser
70 1. Login to the master server with a valid system administrator account (username //sadmin//).
71 1. Go to the frontend server menu under system. Try to establish a connection manually by pressing on the reconnection button.
72 1. When you a success message, the connection has been established successfully.
73
74 ==== Other issues ====
75
76 Should all these measures fail, try the following:
77
78 1. Connect to the frontend server
79 1. Restart the Tomcat application of the frontend server
80 1. Open the status page of the frontend server in a browser with the following URL: {{code language="none"}}http://localhost/fs{{/code}}
81 1. When the status displays as //NOT_CONNECTED// or //WAIT_FOR_CONNECTION//, you need to reconnect to the master server, see above.
82 1. Open the status page of the frontend server again. It should now show the status //CONNECTED//.
83 1. Should this fail too, the Tomcat of the master server should be restarted.
84 1. Afterwards, check again if the connection has been established automatically, either by opening the configuration interface of the master server or by accessing the status page of the frontend server directly.
85 1. It may be necessary to establish the connection manually, see above.