cloudy cloudy

Author Topic: New User installation instructions (for Full MML v1.03)  (Read 12440 times)

0 Members and 1 Guest are viewing this topic.

Offline administrator

  • Administrator
  • Posts: 10,882
  • Get answers to your questions - use Forum SEARCH!
  • Blackpool, UK
New User installation instructions (for Full MML v1.03)
« on: July 30, 2006, 11:59:17 AM »
1) Download and install a copy of MML into a sub-directory on your web site. Make sure that MML is working in evaluation mode before continuing. The documentation supplied in the MML download package explains how to install MML onto your site.

2) After purchasing a full MML licence + annual data subscription, log in to MML Management Centre at

2) Click on the 'Start Here' menu option and follow the process described below to set up your first MML map and create the configuration file that you will need to upload to your web site. Even if you don't want to use one of the pre-defined maps it is recommended that you follow the process described here to set up your first map. This process should ensure that MML is set up and working properly on your site. You can customise the MML installation, either manually or using the on-line configuration utility, once you have it working properly with the first map installed.

3) On the 'Start Here' page, read the instructions and then tick the first box to confirm that MML is working correctly in evaluation mode on your web site. If MML doesn't work in evaluation mode, don't go any further. Ask for assistance by posting a message in this board.

4) Next, enter the URL of your evaluation MMLCONFIG.XML file into the 'Start Here' page, then tick the box to say you want to set up a standard map. Click 'Save and Continue'.

5) On the 'Add a pre-defined MML map' page, select one of the pre-defined maps, click 'Submit' and then wait until the map is configured for you. This will take approximately 30 seconds. The MML server will send an email to the email address you registered with explaining where you can download a copy of the map image file for the map you have chosen.

6) On the 'Maintain Map Details' page, configure the MML map settings for your selected map. At this stage you can leave these as the default settings because you can go back and modify them once you're sure MML is working properly. Make a note of the 'Map Image URL' and make sure you place a copy of the map image (notified by email) at this location. The image filename must be exactly as defined here. You may also need to change the 'MML URL for this map' if your installation of MML isn't loaded by 'index.html' at the displayed URL. Click 'Save Changes, then Select Stations'.

7) The 'Select Stations for Display' page will now be displayed. Review the list of randomly selected stations for display on your map. You can add or remove stations as required, or just leave the default list as it is for now. This list can be modified at any time once you have things working.  Click 'Update Visible Stations List' to continue.

8 ) The 'Select Priority Stations and Initial Display Station' page is displayed next. Select zero, one or more priority stations. Priority stations display 'on top of' other nearby stations when plotted on your map. You can also select the initial station that will be displayed in the side panel when this map is selected. The details on this page can also be left as the default and edited later. Click 'Update Priority Stations List' to go to the next page.

9) On the next page 'Manage MML Configuration data', you can configure the general (non-map specific) MML settings. Once again, these can safely be left at the default values for now and changed later when you've got things working. Click 'Submit' to continue.

10) The final page of the configuration process displays your finished configuration file. Cut and paste the contents from the table into the mmlconfig.xml file on your web site. You may need to store a copy of the configuration data into a file on your PC and then upload that file to your web site. click 'Submit' to return to the menu.

11) Now access MML on your web site and your first map should be displayed with the selected stations displayed on it. You can now go back and use the 'Map Management' menu option to modify the settings for this map, or the 'Modify MMLCONFIG' option to change the general MML settings. When you've made changes, use the 'Display MMLCONFIG' option to display the new mmlconfig.xml file contents for your current settings. The configuration settings are stored in the MML database which means you can return to them at any time to modify them without having to re-enter all the details again. Remember to upload a new copy of the mmlconfig.xml file to the server each time you change it. You don't need to do this if you just want to add or remove stations from your map.

12) To add more pre-defined maps to your MML installation, select the 'Map Management' option from the main menu and then the 'Add a pre-defined map' option on the next page. This will repeat the process described above from step (5). Remember to upload each new map image to your web site and also to upload the new mmlconfig.xml file each time you add a new map.

Finally, within a few hours your maps will be included in the index of weather maps at,com_bookmarks/Itemid,56/mode,0/catid,246/navstart,0/search,*/ so that others can find and enjoy your maps and weather site.
Weather Forum Administrator