This section discusses installing Unwired Accelerator in a network environment. Installation takes five to ten minutes, depending on the speed of your machine.
Installing Unwired Accelerator
Typically you can use any account to install Unwired Accelerator in Tomcat. However, if you plan to use port 80 (HTTP) and port 443 (HTTPS), you must log in as root to install Unwired Accelerator.
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, from the drop-down list. 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/UA70. 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.
In the next window, enter host and domain information, or accept the default values:
Host Name – the installer inserts
the name of the machine on which you are installing Unwired Accelerator;
for example, lab2k
.
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.
Click Next.
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 a new 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 a new value.
Click Next.
In the next window, enter Adaptive Server Enterprise database parameters, or accept the defaults:
ASE Database Host – enter the name of the
machine 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). Accept the default or
provide a new value.
ASE Database Username – enter the Adaptive
Server Enterprise user name; for example, the default is sa
.
ASE Database Password – enter 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 you created Adaptive Server Enterprise data and log devices as part of the “Preinstallation tasks”, click Next to proceed. The installation wizard verifies that the data and log file devices exist.
If they do, the installation proceeds. If they do not, an error message displays:
The devices portalData and portalLog were not found on the database server. Please create the devices before proceeding. Consult the Installation Guide for instructions.
If you did not create Adaptive Server Enterprise data and log devices in advance, you must create them at this time. To do so:
Connect to the Adaptive Server Enterprise server, $SYBASE/ASE.
Create the devices using information in “Preinstallation tasks”.
In the installer window, click Next to proceed.
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
. This starts
the Tomcat application server.
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.4.2_06
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 errors.