Plugin cannot connect to the Proxy Service - AMAG Symmetry 3.1

AMAG Symmetry Plugin Guide 3.1

series
AMAG Symmetry 3.1
revised_modified
2020-01-28

In Config Tool, the plugin role is in a warning state (yellow) and shows the warning message: "Cannot connect to the ProxyService : Cannot retrieve the proxy configuration from the ProxyService. It might be down." To help you troubleshoot this issue, learn about its possible causes and their respective solutions.

If the plugin cannot connect to the AMAG Symmetry server, you need to verify that the IP address and port properties are set properly, and that the plugin can communicate with the proxy service.

Port mismatch

Description of cause: The proxy service and the plugin are configured to use different ports.

Solution: Make sure that the port that is configured in the plugin role's Properties page matches the port configured in the proxy service.

To change the port settings:
  1. On the expansion server that hosts the plugin:
    1. From the home page in Config Tool, open the Plugins task.
    2. In the entity browser pane, select the AMAG Symmetry plugin, and then click the Properties tab.
    3. Take note of the value set for the Port.
    4. Click the Configure proxy button.
  2. If the Amag Symmetry Proxy Configuration Page opens and you see that the Proxy Port matches the Port in the plugin role's Properties page, then try the next solution below.
  3. If the Amag Symmetry Proxy Configuration Page does not open, on the proxy server, configure the port of the proxy service to match the port set on the plugin.

Incorrect host

Description of cause: The host name or IP address configured on the plugin role's Properties page or Proxy configuration page is correct.

Solution: Make sure that the correct host name or IP address is configured.

  1. Confirm that your computer can communicate with both the plugin server and the proxy server.
    1. Ping the IP address or host name of the plugin server. If it responds, go to next step.
    2. Ping the IP address or host name of the proxy server. If it responds, go to next step.
  2. On the expansion server that hosts the plugin:
    1. From the home page in Config Tool, open the Plugins task.
    2. In the entity browser pane, select the AMAG Symmetry plugin, and then click the Properties tab.
    3. Take note of the value set for the Host.
    4. Click the Configure proxy button.
  3. If the Amag Symmetry Proxy Configuration Page opens and you see that the Host matches the Host set in the plugin role's Properties page, then try the next solution below.

IP unreachable

Description of cause: If you still observe an issue, verify that the IP address of the AMAG Symmetry server, which hosts the proxy service, is reachable from the server that hosts the plugin role. You can use the ping command.

Server is offline

Description of cause: The proxy server is offline.

Solution: Make sure that the plugin server and the proxy server are turned on and running.

Ports blocked on network devices

Description of cause: The ports used by the proxy and plugin (defaults are 1312 and 1313) are blocked on the servers, switches, and routers between the proxy server and the plugin server.

Solution: Make sure that the ports used by the proxy and plugin (defaults are 1312 and 1313) are not blocked on the servers, switches, and routers between the proxy server and the plugin server.

To verify is a port is open, open the command prompt as an administrator and enter the following command: telnet <IP address> <port number>. For example, if your IP address is 172.10.10.10 and you want to check port 4502, enter: telnet 172.10.10.10 4502.

To enable Telnet Client, in Windows, click Control Panel > Programs and Features > Turn Windows features on or off, and then select Telnet Client from the list of features.