MegaZine3 on IIS

From MegaZine3
Jump to navigation Jump to search


Because MegaZine3 uses custom extension as of version 2.0 (.mz3 for the book description and .asul for the GUI description), and those types are unknown to IIS per default (and IIS doesn't like serving file types it doesn't know), you'll have to add the two as MIME types to the configuration of the Site serving MegaZine3.

Alternatively you could rename all *.asul files to *.xml and the megazine.mz3 to megazine.xml and set book@asulextension to xml.

If using the MZ3-Tool3 (a compiled batch command file, supporting automatic building of megazine.mz3 files and doing a PDF conversion, available on our download page), you only had to set the 'make' parameter <IIS_server> to 'true'. With <IIS_server> set to 'true', the megazine.mz3 will be created as megazine.xml and the index.html file will be adjusted. The book@asulextension parameter will be included in the megazine.mz3 (or megazine.xml in this case) and set to 'xml'. In case of a 'std' version, where all ASUL files are accessible in the megazine/gui folder, the ASUL files will be renamed accordingly (*.asul -> *.xml). No further changes are necessary on the IIS server side to make a MegaZine3 working.

Alternatively, if you want to keep the default extensions, you should do the following steps to adjust the MIME setting of your IIS server:

Step 1: Open the Server Manager

Iis7-step0.png

Step 2: Navigate to the Site serving MegaZine3

Iis7-step1.png

To the left, open the Roles category, in it open the Web Server (IIS) category, and click on "Internet Information Services (IIS) Manager".

In the right frame, open the server hosting the site, in it open "Sites" and select the site serving MegaZine3.

To the right, find the element "MIME Types". Open it (double click).

Step 3: Add MIME Types

Iis7-step2.png

As the .mz3 and .asul files are XML files, we want to have them treated as such. Under the entry ".xml" you will see the type is marked as "text/xml".

To the right ("Actions"), click on "Add..." to open the dialog for adding a new MIME Type.

Step 3.1: Add .mz3 extension

Iis7-step3.png

Enter the text into the fields as displayed in the image, i.e. ".mz3" in the "File name extension" field, and "text/xml" in the "MIME type" field. Click OK.

Step 3.2: Add .asul extension

Open the dialog a second time by clicking "Add..." one more time.

Iis7-step4.png

Enter the text into the fields as displayed in the image, i.e. ".asul" in the "File name extension" field, and "text/xml" in the "MIME type" field. Click OK.


Conclusion

That's it, you're done. Note that these example steps were performed on an IIS7, so they might slightly differ for IIS6. But the basic principle is the same.