How to refresh device tree files in Power Monitoring Expert (PME)

Issue
Meters are not communicating and logging successfully. In the diagnostic viewer, the tree files for the devices are showing "dirty" or "not_responding."

Product Line
ION Enterprise (ION),
Struxureware Power Monitoring (SPM),
Power Monitoring Expert 7.x
Power Monitoring Expert 8.x
Power Monitoring Expert 9.x
Power Monitoring Expert 2020
Power Monitoring Expert 2021
Power Monitoring Expert 2022
Power Monitoring Expert 2023


Environment
Refreshing tree files

Cause
A meter that is communicating successfully should show a tree state of "clean." This means that the meter's current configuration has been confirmed and the Log Inserter will be able to upload historical data. If the device's tree state is showing "dirty" or "not_responding," this is likely due to a communications problem. The dirty or not responding state is not the cause of the communications problem, but more accurately the symptom of a communications problem. For a more detailed description of these statuses see Log Inserter Technical Reference for the Log Inserter Technical Reference.

One can also gain some understanding of the tree states by looking at the file size of the trees. The tree files are located in the [...\Program Files (x86)\Schneider Electric\Power Monitoring Expert\config\trees] directory.

0 KB -- New tree file
1 KB -- Device has been contacted for information to form a tree file; the system is waiting for a response
> 1 KB -- Tree file established and communicating.

Note that these are general guidelines. For a more accurate description of ION Trees, see What are ION tree files?

*Warning:  The information below pertains to deleting files in the config\trees directory should this be necessary. Be aware that deleting all tree files in large systems will result in considerable communications traffic that may take some time to work through. This approach should only be taken when all other avenues of diagnosing communication problems have been exhausted.

Resolution
*Warning: Take backups of any files prior to modifying or deleting them. Ensure the backups are in a location that will not be overwritten (i.e. the Desktop).
One of the possible methods used when troubleshooting device communication issues in ION Enterprise is to trigger a refresh of the tree files by deleting them which will force them to be rebuilt. This procedure is not meant as a fix-all, but rather as a step in the communications troubleshooting procedures. Prior to performing this task, the user should check the current state of the tree files. To do this:

1. Open Management Console.
2. Go to Tools > System > Diagnostics Viewer.
3. Expand the Diagnostics Viewer > "server name" > Service Diagnostics.
4. Select Communication Server > Tree States.
To delete the tree files, perform the following actions:
1. Stop the ION and Application Modules services.
2. Navigate to the tree files directory. By default it will be [...\Program Files (x86)\Schneider Electric\Power Monitoring Expert\config\trees]. Note: For SPM and ION Enterprise, it will not say Power Monitoring Expert in the directory.
3. There will be a file for each meter in your system. It is best to selectively delete the files, i.e. only delete them for devices that have trees NOT marked clean. Alternatively, you can simply delete all the files in the directory, but by doing so, you will place a burden on the system as all tree files will have to be resolved and in a large system it may take a significant amount of time to reach steady state.
4. Start the stopped ION services.

To delete just one device:
1. Download the batch file.
2. Enter the version number and device name.
3.  run the batch file attached as an Administrator.
This will stop the services, delete the tree file, and start the services back up.