alligata.xml

The Kannel Open Source WAP and SMS gateway works as both an SMS gateway, for implementing keyword b

<?xml version="1.0" encoding="UTF-8"?>

<!DOCTYPE book PUBLIC "-//OASIS//DTD DocBook V3.1//EN" [
  <!ENTITY figtype "#FIGTYPE#">
  <!ENTITY timestamp "#DATE#">
  <!ENTITY version "#VERSION#">
]>

<book>
	<title>Server User Manual &version;</title>
	<bookinfo>
		<address format="linespecific">e-mail: <email>[e-mail]</email>
Web site:  www.3glab.com</address>
		<title>Copyright</title>
		<copyright>
			<year>(c) 2001</year>
			<holder>3G LAB Limited. ALL RIGHTS RESERVED.</holder>
		</copyright>
		<legalnotice>
			<para>The 3G LAB logo and Alligata logo are copyright of 3G LAB Limited in the US and other countries. In addition no part of any documentation contained in or on this packaging may be reproduced in any form (whether by electronic means, by photocopying or in any permanent or temporary form) without the express written permission of 3G LAB Limited or except as in accordance with the provisions of the Copyright Designs and Patents Act 1988 as amended or superseded from time to time.
</para>
			<para>Linux is a registered trademark of Linus Torvalds.
</para>
			<para>Solaris is a registered trademark of Sun Microsystems, Inc.
</para>
			<para>UltraSPARC is a registered trademark of SPARC International, Inc.
</para>
			<para>Wavecom and WM02 are registered trademarks of Wavecom S.A.
</para>
			<para>Nokia and Premicell are registered trademarks of Nokia Corporation.
</para>
			<para>Siemens and M20T are registered trademarks of Siemens AG.
</para>
			<para>Openwave is a trademark of Openwave Systems, Inc.
</para>
			<para>3G LAB recognises that other trademarks displayed are the property of their respective holders.</para>
		</legalnotice>
  <revhistory>
    <revision>
      <revnumber>&version;</revnumber>
      <date>&timestamp;</date>
    </revision>
  </revhistory>

	</bookinfo>
	<part>
		<title>Part One: Getting Started</title>
		<chapter>
			<title>1  Welcome</title>
			<para>Welcome to the <citetitle>Alligata Server User Manual</citetitle>. This manual is in two parts:
</para>
			<itemizedlist>
				<listitem>
					<para>This part, <citetitle>Getting Started</citetitle>, provides an overview of the Alligata Server, and explains how to install the program. It covers the following topics:
</para>
					<itemizedlist>
						<listitem>
							<para>How the Alligata Server fits into the architecture of the Wireless Application Protocol (WAP), the Short Message Service (SMS) and the World Wide Web
</para>
						</listitem>
						<listitem>
							<para>The internal functioning of the Alligata Server
</para>
						</listitem>
						<listitem>
							<para>The hardware and software you need to run the Alligata Server
</para>
						</listitem>
						<listitem>
							<para>How to install the Alligata Server from a Linux/Solaris windowing system, or from the Linux/Solaris command prompt
</para>
						</listitem>
						<listitem>
							<para>How to spread an installation of the Alligata Server across several computers in order to maximise processing capacity
</para>
						</listitem>
					</itemizedlist>
				</listitem>
				<listitem>
					<para>The second part, <citetitle>Using the Alligata Server</citetitle>, is a detailed guide to running, configuring and using the Alligata Server. It covers the following topics:
</para>
					<itemizedlist>
						<listitem>
							<para>How to start, stop and administer the Alligata Server
</para>
						</listitem>
						<listitem>
							<para>How to change the Alligata Server&apos;s configuration settings
</para>
						</listitem>
						<listitem>
							<para>How to view the example WAP sites provided with the Alligata Server
</para>
						</listitem>
						<listitem>
							<para>How to create WAP sites using Wireless Markup Language (WML)
</para>
						</listitem>
						<listitem>
							<para>How to create dynamic WAP sites using the Perl scripting language
</para>
						</listitem>
						<listitem>
							<para>How to create dynamic WAP sites using the PHP scripting language
</para>
						</listitem>
						<listitem>
							<para>How to use the Alligata Server&apos;s SMS features to deliver World Wide Web and other content to mobile phones
</para>
						</listitem>
						<listitem>
							<para>How to use the Alligata Server to send SMS messages from a computer workstation
</para>
						</listitem>
						<listitem>
							<para>How to configure a mobile phone for a WAP service &apos;over the air&apos; using the Alligata Server&apos;s SMS features
</para>
						</listitem>
					</itemizedlist>
				</listitem>
			</itemizedlist>
			<section>
				<title>1.1 The Alligata Server Package
</title>
				<para>Your Alligata Server package contains:
</para>
				<itemizedlist>
					<listitem>
						<para>An installation CD-ROM from which you can install the Alligata Server, some example WAP sites, the Apache Web server, the PHP scripting language and some modules for the Perl scripting language that are useful for developing Mobile Internet sites.
</para>
					</listitem>
					<listitem>
						<para>A booklet, <citetitle>Your Pocket Guide to the Mobile Internet</citetitle>.
</para>
					</listitem>
					<listitem>
						<para>This <citetitle>Alligata Server User Manual</citetitle>.
</para>
					</listitem>
					<listitem>
						<para>An <citetitle>Alligata Server Quick Reference Guide</citetitle>. 
</para>
					</listitem>
				</itemizedlist>
			</section>
		</chapter>
		<chapter>
			<title>2  System Requirements</title>
			<para>There are two versions of the Alligata Server, one for the Linux operating system and one for the Sun Solaris operating system.
</para>
			<section>
				<title>2.1 Linux Version
</title>
				<section>
					<title>Minimum System Requirements
</title>
<FormalPara>
<title>Hardware:</title>
<para>
					<itemizedlist>
						<listitem>
							<para>100% IBM-compatible PC with at least 16 MB of RAM
</para>
						</listitem>
						<listitem>
							<para>Hard disk with at least 30 MB free
</para>
						</listitem>
						<listitem>
							<para>Connection to the telephone network via modem or similar
</para>
						</listitem>
					</itemizedlist>
</para>
</FormalPara>
<FormalPara>
<title>Software:</title>
<para>
					<itemizedlist>
						<listitem>
							<para>Red Hat Linux version 6.0, 6.1 or 6.2 
or 
Mandrake Linux version 7.0 or 7.1
</para>
							<para>(The Alligata Server may run on some other distributions of Linux)
</para>
						</listitem>
						<listitem>
							<para>Perl version 5.0 or higher. Perl is standard in most Linux distributions. If you do not have Perl installed, download it from <ulink url="http://www.perl.org">www.perl.org</ulink>
							</para>
						</listitem>
					</itemizedlist>
</para>
</FormalPara>
				</section>
				<section>
					<title>Optional Hardware Accessories</title>
					<itemizedlist>
						<listitem>
							<para>Connection to the Internet, either dial-in or dedicated
</para>
						</listitem>
						<listitem>
							<para>GSM modem (Wavecom WM02, Nokia Premicell or Siemens M20T) <emphasis role="bold">or</emphasis> subscription to an SMS Centre (SMSC) <emphasis role="bold">or</emphasis> GSM mobile phone with integrated modem, for sending and receiving SMS messages
</para>
						</listitem>
					</itemizedlist>
				</section>
			</section>
			<section>
				<title>2.2 Solaris Version
</title>
				<section>
					<title>Minimum System Requirements
</title>
<FormalPara>
<title>Hardware:</title>
<Para>
					<itemizedlist>
						<listitem>
							<para>Sun UltraSPARC with at least 128 MB of RAM
</para>
						</listitem>
						<listitem>
							<para>Hard disk with at least 30 MB free
</para>
						</listitem>
						<listitem>
							<para>Connection to the telephone network
</para>
						</listitem>
					</itemizedlist>
</Para>
</FormalPara>
<FormalPara>
<title>Software:</title>
<Para>
					<itemizedlist>
						<listitem>
							<para>Sun Solaris version 7 or 8
</para>
						</listitem>
					</itemizedlist>
</Para>
</FormalPara>
				</section>
				<section>
					<title>Optional Hardware Accessories 
</title>
					<itemizedlist>
						<listitem>
							<para>Connection to the Internet, either dial-in or dedicated
</para>
						</listitem>
						<listitem>
							<para>GSM modem (Wavecom WM02, Nokia Premicell or Siemens M20T) <emphasis role="bold">or</emphasis> subscription to an SMS Centre (SMSC) <emphasis role="bold">or</emphasis> GSM mobile phone with integrated modem, for sending and receiving SMS messages
</para>
						</listitem>
					</itemizedlist>
				</section>
			</section>
			<section>
				<title>2.3 Optional Software Included with the Alligata Server
</title>
				<para>In addition to the Alligata Server software, the Alligata Server CD-ROM includes the following items of open source software, which you may find useful in setting up Mobile Internet services:
</para>
				<itemizedlist>
					<listitem>
						<para>Apache Web server
</para>
					</listitem>
					<listitem>
						<para>PHP scripting language
</para>
					</listitem>
					<listitem>
						<para>Common Gateway Interface (CGI), HTML parser, HTML tables and WML modules for the Perl scripting language
</para>
					</listitem>
				</itemizedlist>
				<para>The Alligata Server installation program gives you the option of installing any or all of these pieces of software at the same time as installing the Alligata Server.</para>
			</section>
		</chapter>
		<chapter>
			<title>3  About the Alligata  Server</title>
			<section>
				<title>3.1 What is the Alligata Server?
</title>
				<para>The Alligata Server is two applications in one: a WAP gateway and an SMS server.
</para>
				<para>As a WAP gateway, the Alligata Server is an entry point to the Mobile Internet. If you are a system administrator, you can use it to link your company&apos;s employees&apos; or clients&apos; mobile WAP phones to a local intranet or to the whole Mobile Internet. By using your own installation of the Alligata Server rather than a WAP gateway belonging to a telephone network operator or an Internet Service Provider (ISP), you have complete control over what services you offer your WAP phone users, and you can guarantee they will not be restricted to sites &apos;approved&apos; by a network operator or an ISP.
</para>
				<para>As an SMS server, the Alligata Server allows you to send messages to SMS phone users from a computer workstation, and to implement dynamic SMS keyword services such as retrieval of information from the World Wide Web. Although SMS is much less flexible than WAP, it is available on almost all modern Global System for Mobile Telecommunications (GSM) mobile phones. With its SMS messaging features, the Alligata Server provides limited access to Internet content even to users of non-WAP phones.