Web NMS provides different procedures to configure the Server, Client, mode of data storage operations etc. All configurations are done through configuration files placed under <Web NMS Home>/ conf directory. The Configuration File Checker is a unique tool that checks the syntax of the file, displays errors (if any) and helps you rectify errors in the file. The Configuration File Checker is for all users of Web NMS who edit the conf files present in <Web NMS Home>/conf directory
When to use the Configuration File Checker
Identify the configuration files to be edited and edit the configuration file. Once the editing process is over, use the tool to check the syntax of the configuration files that have been edited. Ensure the tool is used before starting Web NMS.
Start the Configurator
tool from <Web NMS Home>/bin/developertools
ConfigFileChecker.sh/bat) or from Web NMS Launcher - Utilities - Configurator File Checker.
How to check a single configuration file for errors in syntax?
Click the Browse button to select a file/directory which needs to be processed
Click the Check button to start parsing the file.
Click the tab Summary in the Configuration File Status window for an overview of the status of the files checked.
Click the tab Tabular View to view the report of the file in a tabular form
The report generated lists out all syntactical error of the file parsed if any.
Click the View Source button to view the source of the file and rectify errors if any. Details on working with source editor is given in the section How to modify the source of the configuration file to rectify errors if any?
How to check all configuration files in Web NMS for errors in syntax?
Check All Configuration Files check box for checking all the files.
When the check box All Configuration Files is checked, the following directories and files are checked.
All files under <Web NMS Home>/conf directory, but not its sub-directories.
All files and directories under <Web NMS Home>/directory.
All files and directories under<Web NMS Home>/mapdata /menus directory.
All files and directories under<Web NMS Home>/users directory.
All files and directories under <Web NMS Home>/html/defaultsToNewUsers directory.
Click Summary tab on the Configuration File Status window for an overview of the status of the files checked.
Click Tabular View to check the status of each file parsed.
How to modify the source of the configuration file to rectify errors if any?
To edit the file with errors, select the file with Error/Warning Message in the Tabular View and click the View Source button. A new Dialog box View Source pops up.
Press Ctrl + g to go to a specific line with error(s) and edit the file based on the error displayed. Choose the Save button to save the file. On right-clicking the other options available are Cut, Copy, Paste, SelectAll and GoTo.
Click the Check button to see if the file is free of errors.
Handling External DTD references
When a XML document has an external DTD reference, the parser tries to make a HTTP connection and waits,but the application does not return. In such cases you should configure your proxy settings in this tool .Follow the instructions given below.
Click on the menu Options > Proxies.
A dialog box appears for you to enter your PROXY server name and the port number.
Now check the file using the tool. The DTD is fetched using a HTTP connection and status is reported based on the fetched DTD.