This section discusses installing Unwired Accelerator in a network environment. Installation takes five to ten minutes, depending on the speed of your machine.
You can install Unwired Accelerator using the installer, or from the console. Both procedures are provided.
Installing Unwired Accelerator (installer)
Typically you can use any account to install Unwired Accelerator in Tomcat.
Insert the Installation CD.
Launch the installer by running setupLinux.bin. This may take a few moments. The Sybase splash screen displays, followed by the Welcome window.
Click Next. The End-User License window displays.
Select the license agreement appropriate for the country or region where you are installing the software. The license displays.
Read the license agreement and select “I do agree to the terms of the Sybase license, for the install location specified.” Click Next.
In the next window, accept the default installation directory, or enter the directory in which to install Unwired Accelerator. For example, enter /opt/sybase/UA80. The installation directory is referred to as $SYBASE in this guide.
The installer checks for available disk space. If there is not enough disk space, the installer reports the problem and closes. You must free up disk space and start again.
The installer also verifies you have sufficient permission to create the directory. If there is not, the installer reports the problem and closes. You must fix the permissions and start again.
In the next window, enter host and domain information, or accept the default values:
Domain Name – the installer inserts the name of the domain (and subdomain if used) of the machine on which you are installing Unwired Accelerator; for example, sybase.com.
Host Name – the installer inserts the name
of the machine on which you are installing Unwired Accelerator;
for example, labxp.
Click Next.
In the next window, enter Adaptive Server Enterprise database parameters, or accept the defaults:
ASE Database Host – the machine name on
which the Adaptive Server Enterprise database is installed; for
example, myASE.
ASE Database Port – by default, the installer
inserts 5000 for the Adaptive
Server Enterprise database (see Table 2-2).
ASE Database Username – the Adaptive Server
Enterprise user name; for example, the default is sa.
ASE Database Password – the Adaptive Server
Enterprise user password; for example, the default for sa is
blank (no password).
In the same window, indicate how to handle database and log devices:
If the Create Default File-Based Data and Log Devices check box is not selected, the installer verifies the devices for portalData, portalLog, uamlData, and uamlLog exist.
If they do not exist, an error message displays, and the installation does not proceed until these devices are created or the check box is selected.
If the check box is marked, the installer creates four files in the specified directory to be used as ASE data devices: portalData, portalLog, uamlData, and uamlLog.
If insufficient disk space is available for the given directory, an error message displays and the installation does not continue.
The databases (portaldatabase, uaml)
that will use these devices are created and populated during the configuration
phase later in the installation process.
Click Next.
The installer uses the values to connect to the database. If the connection fails, or the database version is not as expected, an error message displays and the installation process stops until a successful connection can be made.
In the next window, enter Unwired Accelerator server port numbers, or accept the defaults:
HTTP Port – by default, the
installer inserts 4040 for
the Unwired Accelerator HTTP port (see Table 2-2). Accept the default or
provide another valid value. Note that UA configuration files use 4040 as
the default Unwired Accelerator HTTP port.
HTTPS Port – by default, the installer
inserts 4443 for the Unwired Accelerator
HTTPS port (see Table 2-2). Accept the default or
provide another valid value.
If you change the server or port value, and are using
the Pocket PC client developed by the .NET API, you will need to
update the MobiLink database with the new value (as described in
the postinstallation procedure, “Updating MobiLink database with new server/port settings (optional)”). [CR #447165]
Click Next.
The Installation Progress window displays. During installation, these files are updated with the configuration information you supplied:
global.properties.xml – changes the default host name and domain name to the machine name and domain name that you provided. The global.properties.xml file is located in:
$SYBASE/tomcat/webapps/onepage
domain.js – changes the default domain name to the name you provided. The domain.js file is located in:
$SYBASE/tomcat/webapps/onepage/javascript
server.xml – changes the default port number to the number you provided. The server.xml file is located in:
$SYBASE/tomcat/conf/
The Installation Summary window displays and reports success or failure of the installation.
Click Finish.
In the terminal window, from $SYBASE,
enter starttomcat.sh or startua.sh.
This starts the Tomcat application server and Unwired Accelerator
(if Adaptive Server Enterprise is running).
If
you are using port 80 (HTTP) and port 443 (HTTPS), you must log
in as root to start Tomcat.
When Tomcat starts, you see a series of messages in the Tomcat window, including the following:
Using CATALINA_BASE: $SYBASE/tomcat Using CATALINA_HOME: $SYBASE/tomcat Using CATALINA_TMPDIR: $SYBASE/tomcat/temp Using JAVA_HOME: ./JDK1.5.0_05
The Unwired Accelerator installation is complete. See “Verifying the installation” to verify the network installation works correctly
If you cannot connect to the application, go to $SYBASE/tomcat/logs and check the catalina.out file for Tomcat errors, or go to $SYBASE/logs for Unwired Accelerator and installer logs.
Installing Unwired Accelerator (from the console)
You can install Unwired Accelerator using a script from the console, instead of the GUI installer. Sybase recommends installing as root from the console.
Log in as root.
Insert the Installation CD.
Launch the installer by running setupLinux.bin -console. The installer panels appear in the same order as in the GUI installer.
Enter a value for each item in order. For an item with
a choice, select the option using numbers (such as 1/2/3)
and press Enter.
You can navigate on each panel using back/next/cancel,
and refresh the panel using redisplay.
Once the installer script finishes:
If you installed UA as root, you can
either restart the machine to start the Tomcat application server
automatically as a service, or you can use starttomcat.sh or startua.sh to
start Tomcat application server and Unwired Accelerator manually
without restarting the machine.
If you did not install as root, you can use either starttomcat.sh or startua.sh to
start the Tomcat application server and Unwired Accelerator.
