Unable to restart Stream service from the Citrix Provisioning (PVS) console

Unable to restart Stream service from the Citrix Provisioning (PVS) console

book

Article ID: CTX457828

calendar_today

Updated On:

Description

When attempting to restart the SOAP stream service from the PVS console, it gives a "failed" message, however the Citrix PVS stream service can be restarted successfully from windows services.msc MMC snap-in.

Environment

This software application is provided to you as is with no representations, warranties or conditions of any kind. You may use and distribute it at your own risk. CITRIX DISCLAIMS ALL WARRANTIES WHATSOEVER, EXPRESS, IMPLIED, WRITTEN, ORAL OR STATUTORY, INCLUDING WITHOUT LIMITATION WARRANTIES OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE, TITLE AND NONINFRINGEMENT. Without limiting the generality of the foregoing, you acknowledge and agree that: (a) the software application may exhibit errors, design flaws or other problems, possibly resulting in loss of data or damage to property; (b) it may not be possible to make the software application fully functional; and (c) Citrix may, without notice or liability to you, cease to make available the current version and/or any future versions of the software application. In no event should the software application be used to support ultra-hazardous activities, including but not limited to life support or blasting activities. NEITHER CITRIX NOR ITS AFFILIATES OR AGENTS WILL BE LIABLE, UNDER BREACH OF CONTRACT OR ANY OTHER THEORY OF LIABILITY, FOR ANY DAMAGES WHATSOEVER ARISING FROM USE OF THE SOFTWARE APPLICATION, INCLUDING WITHOUT LIMITATION DIRECT, SPECIAL, INCIDENTAL, PUNITIVE, CONSEQUENTIAL OR OTHER DAMAGES, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGES. You agree to indemnify and defend Citrix against any and all claims arising from your use, modification or distribution of the software application.

Resolution

In order to restart the stream service from the Citrix Provisioning (PVS) console, the network service will need to be allowed to restart the stream service. The ability for the network service to restart a service is not enabled by default in Windows for security. To set the required permissions:
 
  1. Ensure the stream service is running on the Citrix Provisioning (PVS) server
  2. Download and extract process explorer onto the PVS server, it can be obtained here: https://docs.microsoft.com/en-us/sysinternals/downloads/process-explorer
  3. Run Process explorer as an administrator
  4. Locate the process for the stream service (streamservice.exe)
  5. Right click on the process and select properties
  6. Click on the services tab
  7. Click permissions which now brings you to the Access Control List (ACL) for the service.
  8. Add the Windows Network service but do not grant any permissions from the tick boxes below.
  9. Click on advanced permissions
  10. Click on Network Service and click edit
  11. Click on special permissions
  12. Select Start, Stop and Pause/Resume permissons and click ok.
  13. Click ok on the remaining open windows until you are back to process explorer itself.
  14. Restart the PVS server

Problem Cause

Accounts such as those used with the PVS console that utilize the network service cannot restart services by default on windows systems so the ACL for the stream service network account needs to be edited and only Start, Stop and Pause/Resume permissions added.

Additional Information

See "Important Considerations" heading in this documentation page:https://docs.citrix.com/en-us/provisioning/current-release/configure/configure-server.html