Difference between revisions of "Reconfiguring the System"

From Control Solutions IoTServer Documentation
Jump to navigation Jump to search
Line 15: Line 15:
 
NOTE: The Force Reconfig button cannot be used until all tasks are stopped. You can use the Stop Tasks button to do that. If you try to use the Force Reconfig button with tasks running, you will get the following error message:
 
NOTE: The Force Reconfig button cannot be used until all tasks are stopped. You can use the Stop Tasks button to do that. If you try to use the Force Reconfig button with tasks running, you will get the following error message:
  
 
+
[[File:ForceReconfigTaskWarning.jpg]]
  
 
== Managed Deconfigure ==
 
== Managed Deconfigure ==
  
 
The more graceful approach to completely unconfiguring the IoTServer so you can start over is outlined here.
 
The more graceful approach to completely unconfiguring the IoTServer so you can start over is outlined here.

Revision as of 03:05, 16 May 2019

Forced Reconfigure - Hidden Reset Button

You have the option of unconfiguring the IoTServer using the brute force method available with the reset button. This is talked about in the Reset Button Handling section of Hardware Details.

If you use the reset button to force a reconfigure, the global.xml file will be overwritten with one that only provides for a Data Engine. The configuration file created for the data engine will be defaultobjects.xml and it will contain only one data object. This will be a very minimal configuration, even more minimal than the "minimal" configuration originally shipped.

Forced Reconfigure - "Force Reconfig" Button on Web Page

Task manager buttons force reconfig.jpg

You will find these two buttons at the bottom of the Task Configuration page. Force Reconfig means wipe out the databases, and reload everything from the XML files that are displayed for the various tasks within the task configuration page and task selections. After clearing out all of the existing databases, then click Reboot Device to force a reboot, at which time it will reload the databases from the XML files provided.

IMPORTANT: The Force Reconfig button clears the configuration database. But upon reboot, the task list will be rebuilt from global.xml, and all tasks defined in global.xml will be reconfigured from their respectively assigned XML files. If you want to truly clear out all configuration, follow the Managed Deconfigure process below.

NOTE: The Force Reconfig button cannot be used until all tasks are stopped. You can use the Stop Tasks button to do that. If you try to use the Force Reconfig button with tasks running, you will get the following error message:

ForceReconfigTaskWarning.jpg

Managed Deconfigure

The more graceful approach to completely unconfiguring the IoTServer so you can start over is outlined here.