Using Windows® Scheduled Tasks (Start menu > Accessories > System Tools > Scheduled Tasks), this utility can be run using the following parameters:
· RestartCOM.exe no arguments
The following form will be shown on screen every time this task gets executed.
· RestartCOM.exe restart
No form will be shown on the screen. The Descartes Route Planner DCF Components will be restarted.
· RestartCOM.exe trydcfbackend
No form will be shown on the screen, but a command xml for Listing Organizations will be sent.
¡ If it fails, Descartes Route Planner DCF Components will be restarted.
¡ If the call takes longer than the value specified in
¡ HKEY_LOCAL_MACHINE\SOFTWARE\DCF\RestartTimeOut (milliseconds default 1000 = 1 sec); or if the response time is longer than RestartTimeOut, then the entire system will be restarted.
¡ If it works and everything is all right it will check how many components are activated and if it is more than the maximum specified in HKEY_LOCAL_MACHINE\SOFTWARE\DCF\RestartMaxDCFObjects (default 100 objects), then it will check if there are any blocking process in the SQL Server and will kill the blocking processes and cycles again.
¡ If the problem still persists, it will restart the system.
· RestartCOM.exe trydcfbackendandsavestat
This option will do the same as the previous option (trydcfbackend), but will save statistics to a debug/log file found in c:\LNOS\bin\[ComputerName]RestartCOM.log.
· RestartCOM.exe trydcffrontend
No form will be shown on the screen, but the application will try list Orgs via UI post and if result is not successful it will:
¡ Try to restart ASP process and web services
¡ then try to get Orgs again and if it still does not work
¡ then application will stop and start IIS and WWW services
· RestartCOM.exe trydcfservices
No form will be shown on the screen, but the application will go through all DCFProcessSvc Windows® processes and check how much memory each uses, Correspondent service will be restarted if it uses (percent wise of VisiblePhysicalMemory) more then value in HKEY_LOCAL_MACHINE\SOFTWARE\DCF\MemoryUsagePercentage. This option will also find all pending services (stuck in starting for example) and terminate (using taskkill.exe) processes related to the services. At the end, the application checks if DCF services are not disabled, but not started and will start them.
· RestartCOM.exe stopservices
No form will be shown on screen, but all DCF services (Queue Services) will be stopped, as well as any Descartes Route Planner Services (BGO services).
· RestartCOM.exe startservices
No form will be shown on the screen, but all DCF services (Queue Services) will be started, as well as any Descartes Route Planner Services (BGO services). It will wait two seconds between services.
· RestartCOM.exe initservices
No form will be shown on the screen but all services will be initialized and all necessary dlls will be loaded.
· RestartCOM.exe purgemsmq
No form will be shown on screen, but all Descartes Route Planner Queues will be purged.
· RestartCOM.exe cleareventlog
No form will be shown on screen, but all event messages from "LNOS DCF" event log will be cleared.
· RestartCOM.exe archive
No form will be shown on screen, but the Descartes Route Planner tables and DCF messagelog tables will be archived (only 60 days data will be saved in Descartes Route Planner tables). This does not archive orphan locations.
· RestartCOM.exe restartsystem
No form will be on screen, but all above described events will be executed in the following order:
¡ check what services are running and stop DCF and Descartes Route Planner services in that order
¡ restart IIS and MSMQ services
¡ kill blocking processes in the DBs, if there are any
¡ purge Descartes Route Planner private queues
¡ restart DCF components
¡ start only services that were running
¡ clean event log and write to EventLog that system has been restarted
To create scheduled tasks refer to the Windows® Help documentation (screenshot below):
These scheduled tasks will be created automatically after Descartes Route Planner (LNOS FW) installation. It is recommended that users enable TestDCFBackend, TestDCFFrontend, and TestDCFServices tasks.
