alligata.xml

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

</guilabel>
							</term>
							<listitem>
								<para>If selected, causes the WAP Box to be started automatically every time the computer is booted.
</para>
							</listitem>
						</varlistentry>
						<varlistentry>
							<term>
								<guilabel moreinfo="none">Start the SMS Box at boot
</guilabel>
							</term>
							<listitem>
								<para>If selected, causes the SMS Box to be started automatically every time the computer is booted.
</para>
							</listitem>
						</varlistentry>
						<varlistentry>
							<term>
								<guilabel moreinfo="none">Alligata example sites
</guilabel>
							</term>
							<listitem>
								<para>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>
								<guilabel moreinfo="none">Apache Web server
</guilabel>
							</term>
							<listitem>
								<para>Installs the Apache Web server. You will need Apache, or a similar HTTP server, to view the example sites.
</para>
							</listitem>
						</varlistentry>
						<varlistentry>
							<term>
								<guilabel moreinfo="none">Development files for the Apache Web server (Linux only)
</guilabel>
							</term>
							<listitem>
								<para>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 automatically updates the Apache configuration for WML and Wireless Bitmap (WBMP) file formats.
</para>
							</listitem>
						</varlistentry>
						<varlistentry>
							<term>
								<guilabel moreinfo="none">Apache manuals (Linux only)
</guilabel>
							</term>
							<listitem>
								<para>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>
								<guilabel moreinfo="none">PHP language
</guilabel>
							</term>
							<listitem>
								<para>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>
								<guilabel moreinfo="none">IMAP module for the PHP language (Linux only)
</guilabel>
							</term>
							<listitem>
								<para>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>
								<guilabel moreinfo="none">Documentation for the PHP language (Linux only)
</guilabel>
							</term>
							<listitem>
								<para>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>
								<guilabel moreinfo="none">CGI module for Perl
</guilabel>
							</term>
							<listitem>
								<para>Installs the 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>
								<guilabel moreinfo="none">HTML module for Perl
</guilabel>
							</term>
							<listitem>
								<para>Installs the HTML Perl module. This module is needed to view the Alligata Server&apos;s Perl example site.
</para>
							</listitem>
						</varlistentry>
						<varlistentry>
							<term>
								<guilabel moreinfo="none">HTML tables module for Perl
</guilabel>
							</term>
							<listitem>
								<para>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>
								<guilabel moreinfo="none">WML module for Perl
</guilabel>
							</term>
							<listitem>
								<para>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>Click <guibutton moreinfo="none">Begin Install</guibutton>.
</para>
					<para>The Alligata Server will be installed on your system. Installation progress information appears in the terminal window from which you launched the installation program.
</para>
				</listitem>
				<listitem>
					<para>When all the files have been copied to your system, the dialog box in Figure 4.4 is displayed.
</para>
					<mediaobject>
						<imageobject>
							<imagedata fileref="nearlydone&figtype;">
						</imageobject>
						<caption>
							<para>Figure 4.4: &apos;Thank You&apos; dialog box
</para>
						</caption>
					</mediaobject>
					<para>Click <guibutton moreinfo="none">Launch browser</guibutton> to go to the 3G LAB Web site, where you can receive information about Alligata Server updates and support.
</para>
					<para>Click <guibutton moreinfo="none">Exit</guibutton> to cancel the installation.
</para>
					<para>Click <guibutton moreinfo="none">View Readme</guibutton> to view the Readme file.
</para>
					<para>Click <guibutton moreinfo="none">Continue</guibutton> to complete the installation.
</para>
				</listitem>
				<listitem>
					<para>If you clicked <guibutton moreinfo="none">Continue</guibutton>, the dialog box in Figure 4.5 will appear.
</para>
					<mediaobject>
						<imageobject>
							<imagedata fileref="done&figtype;">
						</imageobject>
						<caption>
							<para>Figure 4.5: &apos;Install Complete&apos; dialog box</para>
						</caption>
					</mediaobject>
				</listitem>
				<listitem>
					<para>Click <guibutton moreinfo="none">Exit</guibutton> to finish the installation, or <guibutton moreinfo="none">View Readme</guibutton> to view the Readme file.
</para>
				</listitem>
				<listitem>
					<para>To start the Alligata Server, follow the instructions in Section 8.1.
</para>
				</listitem>
			</orderedlist>
</Para>
</FormalPara>

		</chapter>
		<chapter>
			<title>5  Installation from the Command Line</title>
			<para>If your Linux or Solaris system does not include a graphical user interface, the installation program will install the Alligata Server using the command line procedure described in this section.</para>
<FormalPara>
<title>To install the Alligata Server from the command line:</title>
<Para>
			<orderedlist inheritnum="ignore" continuation="restarts">
				<listitem>
					<para>Place the Alligata Server CD-ROM in the CD-ROM drive.
</para>
				</listitem>
				<listitem>
					<para>At the command prompt, type </para>
					<para>
						<userinput moreinfo="none">
							su
						</userinput>
					</para>
					<para> and press ENTER.
</para>
					<para>You will be prompted for the <emphasis role="bold">root</emphasis> password.
</para>
				</listitem>
				<listitem>
					<para>Type the password of the <emphasis role="bold">root</emphasis> user and press ENTER.
</para>
					<para>You will be prompted for the <emphasis role="bold">root</emphasis> password.
</para>
				</listitem>
				<listitem>
					<para>
At the command prompt, type
</para>
					<para>
						<userinput moreinfo="none">
							mount
							<replaceable>path_of_your_system&apos;s_CD-ROM_mount_point
</replaceable>
						</userinput>
					</para>
					<para>
(In Linux the path of the CD-ROM mount point is usually <filename moreinfo="none">/mnt/cdrom</filename>, in Solaris it is usually <filename moreinfo="none">/cdrom/cdrom0</filename> or something similar.) For example:
</para>
					<para>
						<userinput moreinfo="none">
							mount /mnt/cdrom
						</userinput>
					</para>
					<para>Press ENTER.
</para>
					<para>If your version of Linux or Solaris automounts CD-ROMs, you can ignore this step.
</para>
				</listitem>
				<listitem>
					<para>Change directory to your system&apos;s CD-ROM mount point. For example, Linux users should type

</para>
					<para>
						<userinput moreinfo="none">
							cd /mnt/cdrom
						</userinput>
					</para>
					<para>and press ENTER.
</para>
				</listitem>
				<listitem>
					<para>Type </para>
					<para>
						<userinput moreinfo="none">
							./install
						</userinput>
					</para>
					<para> and press ENTER.
</para>
				</listitem>
				<listitem>
					<formalpara>
						<title>Solaris users</title>
						<para>The installation program requires Perl to be installed on your system. If Perl is not found (for example, if you are running the default Solaris 7 system), you will be prompted to install it:
</para>
					</formalpara>
					<screen format="linespecific">Perl is not installed or is not in your command path.
  Do you want to install Perl now ? (y/N)
</screen>
					<para>Type Y, ENTER to install Perl or N, ENTER to abort installation.
</para>
				</listitem>
				<listitem>
					<para>Information on the licence agreements used by the Alligata Server package will be displayed on the screen, together with the question,
</para>
					<screen format="linespecific">Do you agree with the licence? [Y/n]
</screen>
					<para>If you agree, type Y, ENTER or just ENTER.
</para>
				</listitem>
				<listitem>
					<para>Information on the installation and binary paths appears on the screen. For example:
</para>
					<screen format="linespecific">Install path set to: /usr/share/alligata
Binary path set to: /usr/bin
</screen>
					<para>
						<emphasis role="bold">Note:</emphasis> you cannot change the installation and binary paths.
</para>
				</listitem>
				<listitem>