When there are any connection issues, the status of the frontend server should be checked first. To check, go to the URL http://myServer/frontend-server
.

The illustrations to the right give an overview of possible connection status that page might display. 

Failed to execute the [velocity] macro. Cause: [null]. Click on this message for details.
Fehlerhafte Verbindung: ERROR
Failed to execute the [velocity] macro. Cause: [null]. Click on this message for details.
Fehlerhafte Verbindung: NOT_CONNECTED
Failed to execute the [velocity] macro. Cause: [null]. Click on this message for details.
Fehlerfreie Verbindung: CONNECTED

Connection status

connectednote
trueA connection to the master server could be established successfully.
falseThere is no connection to the master server. 

Logical status of the frontend server

StatusDescription
CONNECTEDThe connection has been established and opened.
NOT_CONNECTEDNo connection could be established.
ERROR + FehlermeldungAn error has occurred while trying to establish a connection. Usually an error message with details will be shown.
DISCONNECTINGThe connection is about to be closed.
WAIT_FOR_CONNECTIONThe frontend server has been started successfully and is listening on the configured port for an initial connection attempt by the master server.

Possible errors

Initial connection fails

  1. Check whether the frontend server has been started successfully and whether it is listening on the correct port.
  2. 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:
    1. The firewall is blocking any connection attempt on the configured port.
    2. The network architecture prevents the servers from seeing each other.
  3. 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.   Change the configuration.
  4. Sometimes restarting the application or the server may solve the issues.

Connection closed (Connection could be established before)

When the connection to the frontend server cannot be established again automatically, it can be opened manually from the master server.

This requires the following steps:

  1. Open the configuration interface of the master server in a web browser
  2. Login to the master server with a valid administrator (sadmin) account.
  3. Go to System > frontend server and try to establish a connection manually by clicking on the chain icon with a red frame to the right.
  4. When the chain icon appears to the left, the connection has been established successfully.

Other issues

Should all these measures fail, try the following:

  1. Connect to the frontend server
  2. Restart the Tomcat application of the frontend server
  3. Open the status page of the frontend server in a browser with the following URL: http:~~/~~/localhost/fs
  4. When the status displays as NOT_CONNECTED or WAIT_FOR_CONNECTION, the connection to the master server
Tags:
Created by gru on 25.03.2019, 11:56
Translated into en by gru on 25.03.2019, 11:56
Copyright 2000-2025