Export (0) Print
Expand All
Expand Minimize

Troubleshooting RPS.Proxy Health Set

 

Applies to: Exchange Server 2013

Topic Last Modified: 2012-12-28

The RPS.Proxy health set monitors the overall health of the Remote PowerShell service.

If you receive an alert specifying that the RPS.Proxy is unhealthy, this indicates an issue that might prevent you from using Remote PowerShell to access Exchange.

The RPS service is monitored using the following probes and monitors:

 

Probe Health Set Dependencies Associated Monitors

RPSProxyTestProbe

RPS.Proxy

Active Directory

RPSProxyTestMonitor

For more information about probes and monitors, see Server health and performance.

When this probe fails there can be multiple reasons for the problem. Some of the more common issues include the following:

  • The application pool that is hosted on the monitored CAS server is not working properly.

  • The monitoring account credentials are incorrect.

  • The Domain Controllers are not responding.

It is possible that the service was able to recover after issuing the alert. Therefore, when you receive an alert that specifies that the health set is unhealthy, the first thing you should do is to verify that the issue still exists. If it does, then perform the appropriate recovery actions outlined in the following sections.

  1. Identify the health set name and the server name in the alert.

  2. The message details provide information about what exactly caused the alert to be raised. In most cases, the message details would provide sufficient troubleshooting information to identify the root cause. If the message details are not clear, do the following:

    1. Open Exchange Management Shell and run the following command to retrieve the details of the health set that issued the alert:

      Get-ServerHealth <server name> | ?{$_.HealthSetName -eq "<health set name>"}
      

      For example, to retrieve the RPS.Proxy health set details on server1.contoso.com run the following command:

      Get-ServerHealth server1.contoso.com | ?{$_.HealthSetName -eq "RPS.Proxy"}
      
    2. Review the command output and determine the monitor that reported the error. The AlertValue for the monitor that issued the alert will read Unhealthy.

    3. Rerun the associated probe for the monitor that is in unhealthy state. Refer to the table in the Explanation section to find the associated probe. To do so, run the following command:

      Invoke-MonitoringProbe <health set name>\<probe name> -Server <server name> | Format-List
      

      For example, let's assume that the failing monitor was RPSProxyTestMonitor. The probe associated with that monitor is RPSProxyTestProbe. To run that probe on server server1.contoso.com, run the following command:

      Invoke-MonitoringProbe RPS.Proxy\RPSProxyTestProbe -Server server1.contoso.com | Format-List
      
    4. In the command output, review the Result of the probe. If the value is Succeeded, then the issue was a transient error and no longer exists. Otherwise refer to the recovery steps outlined in the following sections.

When receiving an alert from a health set, the email will contain the following information:

  • The name of the CAS server that sent the alert.

  • Full exception trace including eroor messages, diagnostic data and specific HTTP header information. The information in the full exception trace can be used to help troubleshoot the issue.

  • The time and date when the issue occurred.

To help troubleshoot this issue, perform the following:

  1. Review the protocol logs on CAS servers. Protocol logs are located in the <exchange server installation directory>\Logging\HttpProxy\<protocol> folder on the CAS server.

  2. Create a test user account, and then logon to the CAS server by using the test user account, for example https:// <servername>/owa

  3. Start IIS Manager and connect to the server that is reporting the issue and verify that the MSExchangePowerShellFrontEndAppPool is running on CAS server.

  4. Click on Application Pools, and then recycle the MSExchangePowerShellFrontEndAppPool application pool by running the following command from the Exchange Management Shell:

    %SystemRoot%\System32\inetsrv\Appcmd recycle MSExchangePowerShellFrontEndAppPool
    
  5. Rerun the associated probe as shown in step 2.c. in the Verifying the issue still exists section.

  6. If the issue still exists, recycle the IIS service using the IISReset utility.

  7. Rerun the associated probe as shown in step 2.c. in the Verifying the issue still exists section.

  8. If the issue still exists, restart the server.

  9. After the server restarts, rerun the associated probe as shown in step 2.c. in the Verifying the issue still exists section.

  10. If the probe continues to fail, you may need assistance in resolving this issue. Contact a Microsoft Support professional to resolve this issue. To contact a Microsoft Support professional, visit the Exchange Server Solutions Center. In the navigation pane, click Support options and resources and use one of the options listed under Get technical support to contact a Microsoft Support professional. Because your organization may have a specific procedure for directly contacting Microsoft Product Support Services, be sure to review your organization's guidelines first.

 
Was this page helpful?
(1500 characters remaining)
Thank you for your feedback
Show:
© 2014 Microsoft