Resetting Local Modules To Remove Or Update Custom DLL
  • Updated on 15 Aug 2017
  • 1 minute to read
  • Print
  • Dark
    Light

Resetting Local Modules To Remove Or Update Custom DLL

  • Print
  • Dark
    Light

This tutorial demonstrates how to reset Local Modules to remove or update custom DLLs using Decisions.LocalModuleReset.exe tool.
To learn how to deploy custom DLLs, please click here .
This tool is important because by design Decisions stores custom DLLs in the database so a Decisions High Availability Cluster can have these DLLs applied to all nodes within the cluster without having to apply DLLs manually to all servers within that cluster. On startup of Decisions any custom DLL in the C:\Program Files\Decisions\Decisions Services Manager\modules\Decisions.Local\ServicesDlls directory will be automatically added back into Decisions .
Therefore, it is important to useDecisions.LocalModuleReset.exe tool to avoid unexpected results while updating or deleting custom DLLs .
Example :
In this example we have a simple custom FlowStep.dll located inC:\Program Files\Decisions\Decisions Services Manager\modules\Decisions.Local\ServicesDlls directory.
customDll.png

Our goal is to remove this custom step.
First, we need to stop Service Host Manager located in Windows Local Services.
stopShm.png

After Service Host Manager is stopped we delete FlowStep.dll file.
deleteCustomDll.png

Our custom DLL file is deleted…
customDllDeleted.png

…And we can start Service Host Manager back up.
startShm.png

At this point we will receive unexpected results. Service Host Manager may fail to start because our custom DLL is missing, or our custom DLL may come back from the database.
shmErrorsToStart.png

To avoid these unexpected results, each time we delete or update custom DLLs we need to run Decisions.LocalModuleReset.exe tool (as Administrator) located in in C:\Program Files\Decisions\Decisions Services Manager (in default installation).
runResetTool.png

Then, we can safely Start Service Host Manager
startShmAfterReset.png

And, it starts without errors and with all our custom DLLs updated.
shmRunning.png

Was this article helpful?