cloudy cloudy

Author Topic: Upgrade instructions for current users (for Full MML v1.03)  (Read 7558 times)

0 Members and 1 Guest are viewing this topic.

Offline administrator

  • Administrator
  • Posts: 10,828
  • Get answers to your questions - use Forum SEARCH!
  • Blackpool, UK
    • Weather-Watch.com
Important:

The convention for identifying maps in the full version of MML has changed between v1.02 and v1.03. In v1.02 maps are referred to by their MML server 'map number'. This has caused some confusion between the use of the <mapN> and the <number> tags. In v1.03 maps are now referred to by a mandatory unique (to the user) user-definable name rather than a number. The <mapN> tags now just indicate separate maps within the MMLCONFIG.XML file and the MML client software.

WDL-MML/MML-Lite continues to use the <number> tag. This is less of a problem in MML-Lite because only one map can be defined and the MML definition section in WDLCONFIG.XML is much simpler than the MMLCONFIG.XML file.

Therefore, before upgrading to MML v1.03 you must use the MML Management Centre to give each of your maps its unique name. You must then change you MMLCONFIG.XML file to remove the <number> tags and add a <mapName> tag for each map linking the map in the config file to the relevant map name on the server.


There is also more information stored about maps than was previously required. This data is used by the on-line configurator to allow you to create and maintain your MMLCONFIG.XML file on-line. Some of the data will also be used in new MML features that are under development, so it's worth entering the details. This is a once-off exercise because the details are stored in the database for future use.

We recommend you adopt one of two possible methods for upgrading:

a) Manual upgrade
b) Upgrading using the on-line configurator (preferred option)

Manual upgrade

1) Visit the MML Management Centre http://wxd.weather-watch.com/mml_sys/ and edit all of your maps to give them a unique name and also define the minimum amount of mandatory map information. Missing fields will be identified when you try to save the map.

2) Install MML v1.03 onto your web site

3) Edit your MMLCONFIG.XML file to remove all <number> tags and replace them with appropriate <mapName> tags.

4) Modify the HTML file that you use to run MML to change the SWF file references from v1.02 to v1.03 and then test MML.

Upgrading using the on-line configurator

1) Visit the MML Management Centre http://wxd.weather-watch.com/mml_sys/ and edit all of your maps to give them a unique name and also define the minimum amount of mandatory map information. Missing fields will be identified when you try to save the map.

2) Use the new MML Management Centre 'Load MMLCONFIG' option to load the settings from your current MMLCONFIG.XML file into the MML server database.

3) Use the new MML Management Centre 'Display MMLCONFIG' option to display a v1.03 compatible version of your MMLCONFIG.XML file, i.e with the old tags removed and new tags added. Cut a copy of this file from this page and paste it into a file on your own PC.

4) Install MML v1.03 onto your web site

5) Upload the newly created v1.03 MLCONFIG.XML file to the appropriate location on your web site.

6) Modify the HTML file that you use to run MML to change the SWF file references from v1.02 to v1.03 and then test MML.

If you upgrade using the on-line configurator you can now manage your MLMCONFIG.XML file using the new MML Management Centre 'Modify MMLCONFIG' option and then take a copy of the file to upload to your server whenever you make any changes. The on-line configurator should always result in a valid MMLCONFIG.XML file being generated each time it's used, so this approach is strongly recommended.

Finally, if you get a serial number the first time you access one of your newly modified map pages, this is probably due to your old format MMLCONFIG.XML file being retained in a web cache somewhere. Try refreshing the page, or if that doesn't work, shut down and re-start your browser. If you still get a serial number error, post a message and we'll look into it.
Chris
Weather Forum Administrator