The Innovyze Live Server provides a log of automatic runs (scheduled and externally triggered) initiated by ICMLive Operator Client. This run log may be accessed by a third party software product in order to query the status of an automatic run to determine if the run succeeded or failed. When the run fails, the run log contains information to help diagnose the problem.
Run logs are XML files produced by the Innovyze Live Server itself and contain a high level view of the run transaction. Please note that the Innovyze Live Server delegates some tasks to the local InfoWorks Agent and Workgroup Data Server in order to run a simulation to completion.
All of the runs that have the same run origin date will be written to a single log file per day. There is a log file per manifest.
Run logs are XML files that are maintained in a fixed location, determined by the Innovyze Live Server.
This default location is %ProgramData%/Innovyze/LiveServerData/<database_guid>/run_logs.
Log files are updated dynamically, as information becomes available, and will usually contain intermediate state information. Once the run transaction is completed (either succeeded or failed) no further updates will be made to the affected item in the run log.
The rules for accessing, editing and deleting run logs are as follows:
Details of the structure of the run log files, including date and time format and descriptions of the run, run log, run status and run fail reason attributes, are available on request from us.
Maintenance of the log file is performed by the Innovyze Live Server. Run logs older than a configurable number of days will be automatically deleted. Maintenance occurs on a daily basis at a pre-defined time.
Only files that are in a valid run log format (as described in Structure of the Run Log Files section above) will be considered for deletion, based off of the run origin date used in the file name.
For details on configuring maintenance settings such as the time at which purging is initiated and the number of elapsed days before the run log is deleted, please refer to the Innovyze Live Server Administration Guide available for download here.