Manually Running the RestartCom.exe

This utility is located in the c:\LNOS\bin directory and it is called RestartCOM.exe. This is a small C# application used to restart Descartes Route Planner Application components.

These components include

·        DCF Component

·        IIS Server

·        DCF Services

 

To manually run the RestartCom.exe:

1   From Explorer, double-click the RestartCom.exe from c:\LNOS\bin.

The following popup appears.

2   Click one of the following buttons depending on what action you want to perform.

Ü   Note― For all actions, users will not see any changes on screen.

·        RestartComponents &endash; allows the DCF component application to be restarted. When finished, the application will close.

·        CheckComponets &endash; checks the DCF component connections to make sure they are working correctly. This application sends a light command xml to the Descartes Route Planner backend components. If successful, the application closes. If the call fails, then it will try to start the DCF components and will close when finished. It will also check the number of objects created in DCF and if they exceed a preconfigured number (found in the registry key HKEY_LOCAL_MACHINE\SOFTWARE\DCF\RestartMaxDCFObjects -default 100 objects), then it will restart DCF as well.

·        CheckIIS &endash; does the same thing as CheckComponents, but does it via post to ensure IIS works properly. Also, it will start IIS web service if it is down.

·        Check Services &endash; checks every DCF service for memory usage and status. It will generate a message in the Event Log if any service is restarted.

¡       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 VisiblePhycialMemory) more then in HKEY_LOCAL_MACHINE\SOFTWARE\DCF\MemoryUsagePercentage

¡       This option will also find all pending services (stuck in starting example) and terminate (using taskkill.exe) processes related to the service.

¡       At the end application checks if DCF services are not disabled, but not started and will start them.

·        StopServices &endash; stops every DCF Service. When finished, the application will close.

·        StartServices &endash; starts every DCF Service. When finished, the application will close.

Ü   NotePrior to starting, all DCF and LNOS Microsoft® Message Queueing (MSMQ) files that are currently on the system will be deleted. Starting the DCF Services will recreate these files. 

·        InitServices &endash; initializes all services by calling dummy functions. This will load/initialize necessary dlls.

·  Purge MSMQ &endash; purges every DCF MSMQ queue. This will get rid of any messages left in the queues. It will also clear journal(s) if this feature is enabled.

·        Clear EventLog &endash; clears the event log for the LNOS DCF category. When finished, the application will close.

·  Kill Blocking Processes &endash; kills any blocking Process from in the SQL Database. For instance, if you have a process that is holding up another process, and you click Kill Blocking Processes, the process that is holding up the other process is killed. Only the blocking process is killed, not any consecutive processes.

·    Archive &endash; runs archive procedure and will archive data for all organizations keeping only 60 days data. It will generate a message in the Event Log.

·        Restart System &endash; restarts any Descartes Route Planner related components 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 not running

¡       clean event log and write to EventLog that system has been restarted

¡       initialize all services

¡       generate a message in the Event Log