alligata.xml

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

</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 SMS Box you want to add.
</para>
				</listitem>
			</orderedlist>
</Para>
</FormalPara>

		</chapter>
	</part>
	<part>
		<title>Part Two: Using the Alligata Server</title>
		<chapter>
			<title>7  Introduction to Part Two</title>
			<para>Welcome to Part Two of the <citetitle>Alligata Server User Manual, Using the Alligata Server</citetitle>. This part of the user manual explains how to:
</para>
			<itemizedlist>
				<listitem>
					<para>start, stop and administer the Alligata Server
</para>
				</listitem>
				<listitem>
					<para>change the Alligata Server&apos;s configuration settings
</para>
				</listitem>
				<listitem>
					<para>view the example WAP sites provided with the Alligata Server
</para>
				</listitem>
				<listitem>
					<para>create WAP sites using Wireless Markup Language (WML)
</para>
				</listitem>
				<listitem>
					<para>create dynamic WAP sites using the Perl scripting language
</para>
				</listitem>
				<listitem>
					<para>create dynamic WAP sites using the PHP scripting language
</para>
				</listitem>
				<listitem>
					<para>use the Alligata Server&apos;s SMS features to deliver World Wide Web and other content to mobile phones
</para>
				</listitem>
				<listitem>
					<para>use the Alligata Server to send SMS messages from a computer workstation
</para>
				</listitem>
				<listitem>
					<para>configure a mobile phone for a WAP service &apos;over the air&apos; using the Alligata Server&apos;s SMS features
</para>
				</listitem>
			</itemizedlist>
			<para>This part of the user manual assumes you have installed the Alligata Server successfully on a computer workstation running Linux or Solaris. If you have not yet installed the Alligata Server, please follow the installation instructions in Sections 4 to 6.</para>
		</chapter>
		<chapter>
			<title>8  Running the Alligata Server</title>
			<para>
				<emphasis role="bold">Note:</emphasis> to run an Alligata Server command line command, you must be logged in as <emphasis role="bold">root</emphasis>. Therefore, before using any of the command line commands in this section, change to <emphasis role="bold">root</emphasis> as follows:
</para>
			<orderedlist inheritnum="ignore" continuation="restarts">
				<listitem>
					<para>At the command prompt, type su and press ENTER.
</para>
					<para>You will be prompted for the password of <emphasis role="bold">root</emphasis>.</para>
				</listitem>
				<listitem>
					<para>Type the password of <emphasis role="bold">root</emphasis> and press ENTER.
</para>
					<para>You will be returned to the command prompt as <emphasis role="bold">root</emphasis>.
</para>
				</listitem>
			</orderedlist>
			<para>Once the Alligata Server is running, its user will change from <emphasis role="bold">root</emphasis> to that specified by the user variable in the Core group of the configuration file. By default, this user is <emphasis role="bold">alligata</emphasis>.</para>
			<section>
				<title>8.1 Starting the Alligata Server
</title>
				<para>Each box in the Alligata Server needs to be started separately. The Bearer Box must be started before any of the WAP or SMS Boxes. There are three methods of starting the Alligata Server.
</para>
				<para>To start the Alligata Server:
</para>
				<section>
					<title>8.1.1 Method 1
</title>
					<para>If, when you installed the Alligata Server, you selected &apos;Start the Bearer Box at boot&apos;, &apos;Start the WAP Box at boot&apos; or &apos;Start the SMS Box at boot&apos;, then the relevant box will start automatically each time you boot up the computer.
</para>
				</section>
				<section>
					<title>8.1.2 Method 2
</title>
					<section>
						<title>Linux users
</title>
						<para>
At the command prompt, type</para>
						<para>
							<userinput moreinfo="none">
								/etc/rc.d/init.d/<replaceable>box</replaceable> start
							</userinput>
						</para>
						<para>where <replaceable>box</replaceable> is one of the strings <userinput moreinfo="none">bearerbox</userinput>, <userinput moreinfo="none">wapbox</userinput> or <userinput moreinfo="none">smsbox</userinput>. Press ENTER.
</para>
						<para>The procedure to start the Bearer Box, WAP Box and SMS Box on a single Linux workstation is therefore as follows:
</para>
						<orderedlist inheritnum="ignore" continuation="restarts">
							<listitem>
								<para>To start the Bearer Box, type
</para>
								<para>
									<userinput moreinfo="none">
										/etc/rc.d/init.d/bearerbox start
									</userinput>
								</para>
								<para>at the command prompt and press ENTER.
</para>
								<para>The Bearer Box will start up.
</para>
							</listitem>
							<listitem>
								<para>To start the WAP Box, type
</para>
								<para>
									<userinput moreinfo="none">
										/etc/rc.d/init.d/wapbox start
									</userinput>
								</para>
								<para>at the command prompt and press ENTER.
</para>
								<para>The WAP Box will start up.
</para>
							</listitem>
							<listitem>
								<para>To start the SMS Box, type 
</para>
								<para>
									<userinput moreinfo="none">
										/etc/rc.d/init.d/smsbox start

									</userinput>
								</para>
								<para>at the command prompt and press ENTER.
</para>
								<para>The SMS Box will start up.
</para>
							</listitem>
						</orderedlist>
					</section>
					<section>
						<title>Solaris users
</title>
						<para>At the command prompt, type</para>
						<para>
							<userinput moreinfo="none">
								/etc/init.d/	<replaceable>box</replaceable> start
							</userinput>
						</para>
						<para>where <replaceable>box</replaceable> is one of the strings <userinput moreinfo="none">bearerbox</userinput>, <userinput moreinfo="none">wapbox</userinput> or <userinput moreinfo="none">smsbox</userinput>. Press ENTER.
</para>
						<para>The procedure to start the Bearer Box, WAP Box and SMS Box on a single Linux workstation is therefore as follows:
</para>
						<orderedlist inheritnum="ignore" continuation="restarts">
							<listitem>
								<para>To start the Bearer Box, type
</para>
								<para>
									<userinput moreinfo="none">
										/etc/init.d/bearerbox start
									</userinput>
								</para>
								<para>at the command prompt and press ENTER.
</para>
								<para>The Bearer Box will start up.
</para>
							</listitem>
							<listitem>
								<para>To start the WAP Box, type
</para>
								<para>
									<userinput moreinfo="none">
										/etc/init.d/wapbox start

									</userinput>
								</para>
								<para>at the command prompt and press ENTER.
</para>
								<para>The WAP Box will start up.
</para>
							</listitem>
							<listitem>
								<para>To start the SMS Box, type 
</para>
								<para>
									<userinput moreinfo="none">
										/etc/init.d/smsbox start

									</userinput>
								</para>
								<para>at the command prompt and press ENTER.
</para>
								<para>The SMS Box will start up.
</para>
							</listitem>
						</orderedlist>
					</section>
				</section>
				<section>
					<title>8.1.3 Method 3
</title>
					<para>This method of starting the Alligata Server allows you to enter command line options that customise the way each box runs. Using this method, the procedure to start up the Bearer Box, WAP Box and SMS Box on a single workstation is as follows:
</para>
					<orderedlist inheritnum="ignore" continuation="restarts">
						<listitem>
							<para> To start the Bearer Box, type</para>
							<para>
								<userinput moreinfo="none">
									bearerbox
								</userinput>
							</para>
							<para>at the command prompt and press ENTER. You can use command line options to override some of the settings in the configuration file. See <citetitle>Command Line Options</citetitle> below.</para>
							<para>The Bearer Box will start up.
</para>
						</listitem>
						<listitem>
							<para>To start the WAP Box, type
</para>
							<para>
								<userinput moreinfo="none">
									wapbox
								</userinput>
							</para>
							<para>at the command prompt and press ENTER. You can use command line options to override some of the settings in the configuration file. See <citetitle>Command Line Options</citetitle> below.
</para>
							<para>The WAP Box will start up.
</para>
						</listitem>
						<listitem>
							<para>To start the SMS Box, type
</para>
							<para>
								<userinput moreinfo="none">
									smsbox
								</userinput>
							</para>
							<para>at the command prompt and press ENTER. You can use command line options to override some of the settings in the configuration file. See <citetitle>Command Line Options</citetitle> below.
</para>
							<para>The SMS Box will start up.
</para>
						</listitem>
					</orderedlist>
					<para>For each box, you can use a different configuration file from the default file by including the path and name of the relevant file after the command. For example:
</para>
					<para>
						<userinput moreinfo="none">
							bearerbox /etc/alligata2.conf
						</userinput>
					</para>
					<section>
						<title>Command Line Options
</title>
						<para>If you start up the Alligata Server using Method 3, you can include options in the command line you use to start up each box. The format for command line options is
</para>
						<para>
							<userinput moreinfo="none">
								<replaceable>box option value</replaceable>
							</userinput>
						</para>
						<para>For example:
</para>
						<para>
							<userinput moreinfo="none">
								bearerbox -v 2

							</userinput>
						</para>
						<para>The available command line options are shown in Figure 8.1.
<table frame="all">
								<title>Figure 8.1: Alligata Server command line options</title>
								<tgroup cols="2">
									<tbody>
										<row>
											<entry