FAQ
From MSure
This FAQ in other languages:
Contents |
Work in progress.
What is MSure and how do I get started?
Is is problably easier to understand what MSure is by stating what it is not.
MSure is not an application that you install and then get everything served by it. The idea behind MSure is to provide the user with the tools to do what he/she wants, not what the developer thinks the user may or may not want. This is a major difference compared to other applications, such as LogTemp and Lämpömittari.
To achieve this goal, MSure provides a set of modules that are run under a common kernel - the Window service. Each module has a plethoria of settings that can be adjusted via the configuration files. There are no pre-configured configuration files included in the installation kit; it is up to the user to create these based on the templates that are provided in the Wiki.
To give a new user a little help on the way, the tool MSure Auto Config has been made available. Based on very little input from the user this tool creates a set of configuration files - specifically tailored to the users 1-Wire network - that results in data from the 1-Wire network being saved to a database, and graphs for each 1-Wire device beeing generated at a specified interval. Then it is up to the user to do what he/she wants with the configurations.
The learning curve for MSure is doubtless more steep than for 'point-and-click' applications, but the possibilites are endlessly more numerous.
It cannot be stressed anough that reading the Wiki is imperative to understand how to use MSure; all settings that can be changed are documented there in. Of course, if there is something unclear there is always the possibility to ask questions in the forum.
Always check the log files when you have problems with your MSure installation, any error that is encountered at runtime is logged. The log files are placed in the Logs folder in the installation directory. Each module logs to its own log file so there may be more than one.
Everything was OK when I ran MAC, but no graphs are generated / no data is inserted into the database
- Check for errors in the 1-Wire log, if you have an error "1-Wire network can't be found" and you are using a serial (possibly homebuilt) adapter, restart MAC and check in "Treat COM adapters as HOMEBREW" in the 1-Wire configuration.
- Check the path where the graphs are to be saved. If you want to save the pictures to a network share, make sure that the access rights are properly set-up. Keep in mind that MSure runs as "Local Service", and as such has no rights on the network by default.
I have run MAC and started the service, how do I know if MSure works?
Depending on the interval you selected in the graph configuration, it will take a while before the first graphs are generated, so have patience. You can also read the log files to see what is going on.
How do I move MSure from computer A to computer B without loosing my configuration or data?
- Install MSure on computer B.
- Shutdown the MSure service on computer A
- Copy MSure.xml and all other files that you have included in your configuration (for example OneWire.xml, Graph.xml) and all files in the directory \MSure\UserModules. Place these files in corresponding place on computer B.
- The procedure to save your data depends on which database you are suing and if it is located on the same computer as your original MSire installation. In the case of SQLite it is just a matter of copying the database files (as specified in your configuration). For MySQL and SQL Server, the procedure is more complex, but both applications provide backup tools which can do what you want.
- Edit your configuration as needed (new file paths, changed IP-addresses etc.)
- Start the MSure service on computer B and verify that it works as it did on computer A.
