WML Server (MIME Types) Setup Guide
4600 Series IP Telephone
16-300507 Issue 2.5 April 2005
Copyright 2005, Avaya Inc. • Theft (such as, of intellectual property, financial assets, or toll All Rights Reserved facility access) Notice • Eavesdropping (privacy invasions to humans) Every effort was made to ensure that the information in this • Mischief (troubling, but apparently innocuous, tampering) document was complete and accurate at the time of printing. • Harm (such as harmful tampering, data loss or alteration, However, information is subject to change. regardless of motive or intent)
Be aware that there may be a risk of unauthorized intrusions Trademarks associated with your system and/or its networked equipment. Also realize that, if such an intrusion should occur, it could result in a DEFINITY is a registered trademark of Avaya, Inc. MultiVantage variety of losses to your company (including but not limited to, is a trademark of Avaya, Inc. HTTP Server functionality is human/data privacy, intellectual property, material assets, provided by the GoAhead WebServer 2.1, Copyright © 2004 financial resources, labor costs, and/or legal costs). GoAhead Software, Inc. All Rights Reserved.
Responsibility for Your Company’s Telecommunications Disclaimer Security Avaya is not responsible for any modifications, additions or The final responsibility for securing both this system and its deletions to the original published version of this documentation networked equipment rests with you - Avaya’s customer system unless such modifications, additions or deletions were performed administrator, your telecommunications peers, and your managers. by Avaya. Customer and/or End User agree to indemnify and Base the fulfillment of your responsibility on acquired knowledge hold harmless Avaya, Avaya's agents, servants and employees and resources from a variety of sources including but not limited against all claims, lawsuits, demands and judgments arising out to: of, or in connection with, subsequent modifications, additions or deletions to this documentation to the extent made by the • Installation documents Customer or End User. • System administration documents
• Security documents API Support • Hardware-/software-based security tools This support is limited to the API. We can not provide assistance with generic configuration, servers, other software, or network • Shared information between you and your peers issues. Please visit the Application Support Forum for more information. • Telecommunications security experts To prevent intrusions to your telecommunications equipment, you and your peers should carefully program and configure: How to Get Help • Your Avaya-provided telecommunications systems and their For additional support telephone numbers, go to the Avaya interfaces support Web site: http://www.avaya.com/support. If you are: • Your Avaya-provided software applications, as well as their • Within the United States, click the Escalation Management link. underlying hardware/software platforms and interfaces Then click the appropriate link for the type of support you need. • Any other equipment networked to your Avaya products • Outside the United States, click the Escalation Management link. Then click the International Services link that includes telephone TCP/IP Facilities numbers for the international Centers of Excellence. Customers may experience differences in product performance, reliability and security depending upon network Providing Telecommunications Security configurations/design and topologies, even when the product performs as warranted. Telecommunications security (of voice, data, and/or video communications) is the prevention of any type of intrusion to (that is, either unauthorized or malicious access to or use of) your company's telecommunications equipment by some party. To order copies of this and other documents: Your company's “telecommunications equipment” includes both this Avaya product and any other voice/data/video equipment that Call: Avaya Publications Center could be accessed via this Avaya product (that is, “networked Voice 1.800.457.1235 or 1.207.866.6701 equipment”). FAX 1.800.457.1764 or 1.207.626.7269 An “outside party” is anyone who is not a corporate employee, agent, subcontractor, or is not working on your company's behalf. Write: Globalware Solutions Whereas, a “malicious party” is anyone (including someone who 200 Ward Hill Avenue may be otherwise authorized) who accesses your Haverhill, MA 01835 USA telecommunications equipment with either malicious or Attention: Avaya Account Management mischievous intent. E-mail: [email protected] Such intrusions may be either to/through synchronous For the most current versions of documentation, go (timemultiplexed and/or circuit-based) or asynchronous to the Avaya support Web site: (character, message-, or packet-based) equipment or interfaces for reasons of: http://www.avaya.com/support • Utilization (of capabilities special to the accessed equipment)
Table of Contents
INTRODUCTION ...... 5
SERVER SETUP...... 5 CONFIGURING MICROSOFT INTERNET INFORMATION SERVICES (IIS)...... 5
CONFIGURING APACHE WEB-SERVER...... 7
REFERENCE:...... 7
Table of Figures
FIGURE 1: IIS SETUP ...... 6
______
WML Server Setup Guide Page 4 Avaya, Inc. Introduction
This document discusses how to set Wireless Application Protocol (WAP) Multipurpose Internet Mail Extensions (MIME) types for Microsoft IIS and for Apache so that a customer's server has the capability to handle Wireless Markup Language (WML) pages. MIME specifies data content type. Servers insert the MIME header at the beginning of a Web transmission. Although this document only provides information on IIS and Apache web servers, WML pages can be served on almost every web server. Contact you server provider for additional information on how to configure your server for WML.
Server Setup
Sections below provide step-by-step instructions for WML set up on IIS and Apache web servers, respectively.
Configuring Microsoft Internet Information Services (IIS) Microsoft Internet Information Server (IIS) is a free Web server that can be acquired with the following operating systems to serve WML pages:
• Microsoft Windows NT 4 – IIS version 4.0 comes in the NT 4.0 option pack.
• Microsoft Windows 2000/server – IIS 5.0 is built in to Windows 2000.
• Microsoft Windows XP – IIS 5.1 is built in to Windows XP.
• Microsoft Windows 2003 – IIS 6.0 is built in to Windows 2003.
IIS has a graphical user interface, the Internet Service Manager, for configuring all aspects of the Web server.
The following step-by-step guide can be used to set up MIME types:
1. Start the Microsoft Management Console (Start => Run =>MMC) and load the IIS snap- in from the c:\winnt\system32\inetsrv\iis directory.
The Internet Services Manager can also be opened from Start => Control Panel => Administrative Tools => ‘Internet Information Services Manager’ or ‘Internet Information Services’ depending on the version and Windows Operating System.
2. Right click on the node that matches the name of your web server (by default: ‘Default Web Site’) and choose the Properties option.
______
WML Server Setup Guide Page 5 Avaya, Inc. 3. Click on the edit button next to the master properties drop down box.
4. Select the HTTP Headers tab, and click on the file type button. This will load the registered file types dialog.
5. Click on the new type button and create a new file type using the below parameters (Refer to figure 1 below). Repeat the procedure for each associated extension:
1. File Type 1:
• Associated extension: wml
• Content type: text/vnd.wap.wml
2. File Type 2:
• Associated extension: wbmp
• Content type: image/vnd.wap.wbmp
6. Click OK to close all of the open dialogs, and then close MMC or Internet Services Manager itself.
7. Restart ‘IIS Admin Service’ from the ‘Services’. (Click Start program, Administrative Tools, and click on the Services application) so that the newly added MIME types are picked up.
Figure 1: IIS Setup
______
WML Server Setup Guide Page 6 Avaya, Inc.
Configuring Apache Web-server Apache is an open-source Web server that’s available on many platforms, including Linux and Windows. Basic familiarity with UNIX is necessary to configure it.
Apache may be downloaded from the following link: http://www.apache.org/dist/httpd/binaries/.
Please download the apache server file appropriate to your operating system. NOTE: Release 2.0.49 and Release 1.3.31 is the latest stable release when this document is published. Please download this release. Older releases of Apache would also work as the WML server.
The following is a step-by-step guide for configuring Apache Web-server:
1. To set MIME types in Apache, a plain text file called httpd.conf is used. The location for this file varies depending on the individual setup, but the most usual path is /etc/httpd/conf/httpd.conf – this is the default location if Linux is installed via the RPM method. If the operating system is Windows, then look for a folder called conf under where Apache is installed.
2. Open httpd.conf in a text editor such as Notepad.
3. Scroll down to the AddType section (usually at the bottom of the file) and add the following lines:
• AddType text/vnd.wap.wml wml
• AddType image/vnd.wap.wbmp wbmp
4. Save the file.
5. Restart Apache so that it recognizes the newly added MIME types.
Reference:
More information about WAP and WML can be obtained from the WAP Forum at the following HTML link: http://www.wapforum.org/
Please also see the Application Programmer Interface (API) Guide, which discusses all the WML 1.2 tags that are supported as well as how they are rendered on the phone:
______
WML Server Setup Guide Page 7 Avaya, Inc. This document can be downloaded from the Avaya Support Website.
The above document(s) can be located by using the following navigation matrix on the Avaya’s Support Site:
Home > Support > 4600 IP Telephones > Application Developer Information
______
WML Server Setup Guide Page 8 Avaya, Inc.