Sm_AgentApi_Init Failed error is shown intermittently in the event viewer
Article ID: 7676
Updated On:
Products
Issue/Introduction
Most of the times, the IIS Web agent fails to start and gives a 500 error when the client tries to connect.
There is no error available in the Agent log or trace, and the only trace we find is that there is an Sm_AgentApi_Init Failed error message reported in the Windows Event Viewer.
When the problem occurs, the LLAWP process attempts to start but fails.
Why this is happening, and how we could solve this?
Cause
- When the agent machine is restarted the system stops the services, including the IIS Server. This will result in a shutdown call to the Web Agent which will close all the connections.
- When all the w3wp processes are shutting down they will unregister from the LLAWP in the web agent code. When LLAWP detects that there are zero 'clients' connected to it, it will wait 20 seconds, then it will shut down, closing its connections to the the Policy Server.
- The reason why it waits for 20 seconds is by design: if the IIS shuts down, but then it is restarted again, and the Web Agent initializes, it will be much faster since there will be no need to create again a LLAWP process as there is one which is already initialized - resulting in a faster initialization of the Web Agent. This is useful in IIS since the w3wp process itself exits after a short while of inactivity (so this scenario happens routinely).
- However, if the Operating System shuts down before these 20 seconds, LLAWP never closes the connections to the Policy server. This leaves connections open in the Policy Server machine, which does not know that the other side is no longer there. In the Policy Server machine, if running a 'netstat' command, we will see the connections coming from the Web Agent IP and port appear in the 'ESTABLISHED' state.
Assuming the process of restarting the agent machine is happening very frequently, this mechanism will cause a lot of connections to be left as 'ESTABLISHED' in the Policy Server machine, even if there is no corresponding LLAWP process on the other side.
It may happen that during the frequent reboots, at one point the Web Agent tries to create a connection but it is assigned a port number that corresponds to one of these abandoned connections. So when it tries to connect, the Policy Server machine will see this as irregular, and it will not be sending a SYN/ACK packet in response to the SYN, which will cause a TCP sequence mismatch, resulting in the Web Agent machine discarding this packet as it is out of sequence and believing it is not meant to be a response to the SYN.
Environment
Resolution
This is not really an error or defect, but the expected behaviour in the scenario described (very frequent reboots of the IIS agent machine). Thus it is unlikely to happen in a production environment, which should be very stable by design.
However, if there is a concern that such a situation may happen, there are several possible corrective actions available to mitigate it or eliminate it completely:
- Turn on keep alive in the Policy Server machine. To do this, you have to enable the following environment variables in both the Policy Server machine and the Web Agent machine:
SM_ENABLE_TCP_KEEPALIVE Enable the variable with the following value: 1
For Unix, SM_ENABLE_TCP_KEEPALIVE=1, and export the variable.
For Windows, create the following system environment variable with a value of 1:
SM_ENABLE_TCP_KEEPALIVE
- Review possible Windows settings which wait for a process (LLAWP) to exit before performing the shutdown. This will be specific to Windows versions and to each environment idiosyncrasy, so it should be researched in each case.
- Port range can be increased on the Web Agent machine. The following article by Microsoft may be of use:
Feedback
