alligata.xml

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

					<para>You will be presented with the questions listed in Figure 5.1. In response to each question, type Y, ENTER for &apos;yes&apos;, N, Enter for &apos;no&apos;, or ?, ENTER to receive help.
</para>
					<para>Pressing just ENTER in response to a question selects the first (capitalised) option in the square brackets after the question. For example, if the square brackets look like this:
</para>
					<screen format="linespecific">[N/y/?]</screen>
					<para>then pressing ENTER is equivalent to pressing N, ENTER.
</para>
					<para>
						<emphasis role="bold">Note:</emphasis> the Alligata Server installation program detects whether each item is already installed on your system. You will not be asked whether you want to install items that are already installed. For example, if your computer already contains an installation of the Apache server, the question &apos;Install Apache Web server?&apos; will be omitted.
</para>
					<variablelist>
						<title>Figure 5.1 Command Line Installation Options
</title>
						<varlistentry>
							<term>
								<computeroutput moreinfo="none">Install the Alligata Gateway (Kannel core)? [Y/n/?]
</computeroutput>
							</term>
							<listitem>
								<para>Y installs the Alligata Server on the current computer, including the Bearer Box, one WAP Box and one SMS Box. If you want to install extra WAP and SMS Boxes on other computers, see Section 6.
</para>
							</listitem>
						</varlistentry>
						<varlistentry>
							<term>
								<computeroutput moreinfo="none">Start the Bearer Box at boot? [N/y/?]
</computeroutput>
							</term>
							<listitem>
								<para>Y causes the Alligata Server&apos;s Bearer Box to be started automatically every time the computer is booted.
</para>
							</listitem>
						</varlistentry>
						<varlistentry>
							<term>
								<computeroutput moreinfo="none">Start the WAP Box at boot [N/y/?]
</computeroutput>
							</term>
							<listitem>
								<para>Y causes the WAP Box to be started automatically every time the computer is booted.
</para>
							</listitem>
						</varlistentry>
						<varlistentry>
							<term>
								<computeroutput moreinfo="none">Start the SMS Box at boot [N/y/?]
</computeroutput>
							</term>
							<listitem>
								<para>Y causes the SMS Box on the current computer to be started automatically every time the computer is booted.
</para>
							</listitem>
						</varlistentry>
						<varlistentry>
							<term>
								<computeroutput moreinfo="none">Install the Alligata examples? [Y/n/?]
</computeroutput>
							</term>
							<listitem>
								<para>Y installs the Alligata Server example WAP sites. In Linux, these are installed into <filename moreinfo="none">/home/httpd/alligata/wml</filename>. In Solaris 7, they are installed into <filename moreinfo="none">/usr/local/apache/alligata/wml</filename>. In Solaris 8, they are installed into <filename moreinfo="none">/etc/apache/alligata/wml</filename>.</para>
								<para>Section 12 provides a guide to viewing, using and understanding the example sites.
</para>
							</listitem>
						</varlistentry>
						<varlistentry>
							<term>
								<computeroutput moreinfo="none">Install Apache Web server? [N/y/?]
</computeroutput>
							</term>
							<listitem>
								<para>Y installs the Apache Web server. You will need Apache to view the example sites.
</para>
							</listitem>
						</varlistentry>
						<varlistentry>
							<term>
								<computeroutput moreinfo="none">Install Development files for the Apache Web server? [N/y/?] (Linux only)
</computeroutput>
							</term>
							<listitem>
								<para>Y installs the Apache development package. You will need this package if you plan to extend Apache, for example to write a new module.</para>
								<para>If the computer already contains an installation of Apache, the Alligata Server installation program updates the Apache configuration for WML and WBMP file formats.
</para>
							</listitem>
						</varlistentry>
						<varlistentry>
							<term>
								<computeroutput moreinfo="none">Install Apache manuals? [N/y/?] (Linux only)
</computeroutput>
							</term>
							<listitem>
								<para>Y installs the Apache manuals into the directory <filename moreinfo="none">/home/httpd/html/manual</filename>. To view the index page, open the file <filename moreinfo="none">index.html</filename> in a Web browser such as Netscape or Lynx.
</para>
							</listitem>
						</varlistentry>
						<varlistentry>
							<term>
								<computeroutput moreinfo="none">Install PHP language? [N/y/?]
</computeroutput>
							</term>
							<listitem>
								<para>Y installs the PHP scripting language. PHP is used by two of the Alligata Server example WAP sites. It can be very useful for developing Web and WAP applications.</para>
								<para>In the Solaris installation, this option includes the PHP IMAP module (see below).
</para>
							</listitem>
						</varlistentry>
						<varlistentry>
							<term>
								<computeroutput moreinfo="none">Install IMAP module for the PHP language? [N/y/?] (Linux only)
</computeroutput>
							</term>
							<listitem>
								<para>Y installs the IMAP PHP module. This module is used in the example WAP site PAT for liaising with your e-mail server.
</para>
							</listitem>
						</varlistentry>
						<varlistentry>
							<term>
								<computeroutput moreinfo="none">Install Documentation for the PHP language? [N/y/?] (Linux only)
</computeroutput>
							</term>
							<listitem>
								<para>Y installs documentation for the PHP language into the directory <filename moreinfo="none">/home/httpd/html/manual/mod/mod_php3</filename>. To view the index page, open the file <filename moreinfo="none">index.html</filename> in a Web browser such as Netscape or Lynx.
</para>
							</listitem>
						</varlistentry>
						<varlistentry>
							<term>
								<computeroutput moreinfo="none">Install CGI module for Perl? [N/y/?]
</computeroutput>
							</term>
							<listitem>
								<para>Y installs the Common Gateway Interface (CGI) Perl module, version 2.69. This module facilitates the output of Web files from Perl scripts. It is needed to view the Alligata Server&apos;s Perl example site. (The CGI modules supplied with most Linux distributions are too old and will not work with the example Perl site.)
</para>
							</listitem>
						</varlistentry>
						<varlistentry>
							<term>
								<computeroutput moreinfo="none">Install HTML module for Perl? [N/y/?]
</computeroutput>
							</term>
							<listitem>
								<para>Y installs the HTML Perl module. This module is needed to view the Alligata Server&apos;s Perl example site.</para>
							</listitem>
						</varlistentry>
						<varlistentry>
							<term>
								<computeroutput moreinfo="none">Install HTML tables modules for Perl? [N/y/?]
</computeroutput>
							</term>
							<listitem>
								<para>Y installs the HTML tables Perl module. This module is needed to view the Alligata Server&apos;s Perl example site.</para>
							</listitem>
						</varlistentry>
						<varlistentry>
							<term>
								<computeroutput moreinfo="none">Install WML module for Perl? [N/y/?]
</computeroutput>
							</term>
							<listitem>
								<para>Y installs the WML Perl module. This module is needed to view the Alligata Server&apos;s Perl example site.</para>
							</listitem>
						</varlistentry>
					</variablelist>
				</listitem>
				<listitem>
					<para>The following messages (or equivalents) will be displayed on the screen:
</para>
					<screen format="linespecific">Installing to /usr/share/alligata
xMb available, 5Mb will be installed
Continue install? [Y/n]</screen>
					<para>Selecting Y installs the Alligata Server and any other selected items on your system.
</para>
					<para>Installation progress is displayed on the screen.
</para>
				</listitem>
				<listitem>
					<para>When installation is complete, the following messages will be displayed on the screen:
</para>
					<screen format="linespecific">Thank you for installing the Alligata Server, 
3G LAB&apos;s Mobile Internet Server!
Please visit our Web site for updates and support.
Would you like to launch a Web browser? [Y/n]</screen>
					<para>To visit the 3G LAB Web site, select Y.
</para>
					<para>If you select N, the following message will be displayed on the screen:
</para>
					<screen format="linespecific">Installation complete.
</screen>
				</listitem>
				<listitem>
					<para>To start the Alligata Server, follow the instructions in Section 8.1.</para>
				</listitem>
			</orderedlist>
</Para>
</FormalPara>

		</chapter>
		<chapter>
			<title>6  Installing Multiple WAP and SMS Boxes</title>
			<para>The Alligata Server installation program installs a Bearer Box, a WAP Box and an SMS Box onto a personal computer running Linux or Solaris. 
</para>
			<para>The following instructions assume you have already installed the Alligata Server on a personal computer running Linux or Solaris (&apos;Computer A&apos;). If you have not yet installed the Alligata Server, please follow the instructions in Section 4 for installation from a graphical user interface, or Section 5 for installation from the command line.
</para>
			<para>You can add any number of extra WAP and SMS Boxes to an installation of the Alligata Server.
</para>

<FormalPara>
<title>To add a WAP Box to an installation of the Alligata Server:</title>
<Para>

			<orderedlist inheritnum="ignore" continuation="restarts">
				<listitem>
					<para>Connect a computer running Linux or Solaris (&apos;Computer B&apos;) to Computer A using TCP/IP.</para>
				</listitem>
				<listitem>
					<para>Install a complete copy of the Alligata Server onto Computer B as described in Sections 4 and 5.
</para>
				</listitem>
				<listitem>
					<para>On Computer B, open the configuration file <filename moreinfo="none">/etc/alligata.conf</filename> in a text editor such as vi or Emacs.
</para>
					<para>
						<emphasis role="bold">About the configuration file:</emphasis> the Alligata Server configuration is a list of variables divided into groups. Each group begins with the line</para>
					<para>
						<userinput moreinfo="none">
							group = <replaceable>x</replaceable>
						</userinput>
					</para>
					<para> where <replaceable>x</replaceable> is a group identifier. A blank line signifies the end of a group. (Full instructions for configuring the Alligata Server are provided in Section 9.)
</para>
				</listitem>
				<listitem>
					<para>In the configuration group beginning with the line </para>
					<para>
						<userinput moreinfo="none">
							group = wapbox
						</userinput>
					</para>
					<para>, change the value of the variable </para>
					<para>
						<userinput moreinfo="none">
							bearerbox-host
						</userinput>
					</para>
					<para> to the IP address or URL of the computer hosting the Bearer Box (that is, computer A). For example:
</para>
					<para>
						<userinput moreinfo="none">
							bearerbox-host = 10.0.0.1
						</userinput>
					</para>
				</listitem>
				<listitem>
					<para>Repeat steps 1-4 on a new computer for each WAP Box you want to add.
</para>
				</listitem>
			</orderedlist>
</Para>
</FormalPara>
<FormalPara>
<title>To add an SMS Box to an installation of the Alligata Server:</title>
<Para>

			<orderedlist inheritnum="ignore" continuation="restarts">
				<listitem>
					<para>Connect a computer running Linux or Solaris (&apos;Computer C&apos;) to Computer A using TCP/IP.
</para>
				</listitem>
				<listitem>
					<para>Install a complete copy of the Alligata Server onto Computer C as described in Sections 4 and 5.
</para>
				</listitem>
				<listitem>
					<para>On Computer C, open the configuration file <filename moreinfo="none">/etc/alligata.conf</filename> in a text editor such as vi or Emacs.
</para>
					<para>
						<emphasis role="bold">About the configuration file:</emphasis> the Alligata Server configuration is a list of variables divided into groups. Each group begins with the line where <replaceable>x</replaceable> is a group identifier. A blank line signifies the end of a group. (Full instructions for configuring the Alligata Server are provided in Section 9.)
</para>
					<para>
						<userinput moreinfo="none">
							group = <replaceable>x</replaceable>
						</userinput>
					</para>
				</listitem>
				<listitem>
					<para>In the configuration group beginning with the line </para>
					<para>
						<userinput moreinfo="none">
							group = smsbox
						</userinput>
					</para>
					<para>, change the value of the variable bearerbox-host to the IP address or URL of the computer hosting the Bearer Box (that is, computer A). For example: