Frequently Asked Question

Symptom

• Need4Viz services cannot be started/stopped manually or through the Central Configuration Manager.
  

Environment

• Windows Server
• Need4Viz : all versions

Resolution

To restart Need4Viz services :

1. Open the Central Configuration Manager and stop the BOEXI40Need4Viz service : 
2. Open a PowerShell command window as local administror of the server
3. Check if services are stopped, run a pm2 -list command. You should get the following screen, if it's the case go to step 8 : 
   
4. If services are started, you should get the following screen :
5. At this step, you can kill all the services with the pm2 -kill command. You should get after that the screen as in step 3. If some services are always running at this step, run again a pm2 -kill command (do not run a pm2 -list command after that). 
6. Open the Windows task mananger and go to the Details tab. Kill manually all the residuals node.exe processes : 
7. When no node.exe process is running in the Windows task manager, run a pm2 -list command. You should get the screen as in step 3.
8. Now you can start Need4Viz services through the Central Configuration Manager :
9. Check if services are started, run a pm2 -list command. You should get the following screen : 
   

After these steps, you should be able to stop/start correctly the Need4Viz services through the Central Configuration Manager. Close the PowerShell window. You can check via the Windows Task Manager that the node services are correctly started/stopped : 

You can do the same thing by using the scripts Start_Need4Viz.ps1 and Stop_Need4Viz.ps1 in the ~Need4Viz_folder_installation/Scripts/ directory.

Possible issue

In case of restricted policy to execute scripts in the PowerShell window :

1. run the set-executionpolicy unrestricted command
2. answer o for the validation