Installation tasks

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.

1. Insert the Installation CD. Launch the installer by running setupLinux.bin. This may take a few moments.

2. Click Next. The End-User License window displays.

3. Select the license agreement appropriate for the country or region where you are installing the software, from the drop-down list. The license displays.

   Reade the license agreement and select “I agree to the terms of the Sybase license for the installation location selected.” Click Next.

4. In the next window, accept the default installation directory, or enter the directory in which to install Unwired Accelerator. For example, enter /opt/sybase. The installation directory is referred to as $SYBASE in this guide.

5. 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.

6. In the next window, enter:

   • Domain Name – enter the domain (and subdomain if used).

     The UA configuration file uses sybase.com as the default domain name.

   • Host Name – enter the name of the machine on which you are installing Unwired Accelerator; for example, lab2k. The UA configuration files use demo as the default host.

   • Database Port – by default, the Installer inserts 4747 for the ASA database (see Table 2-2). Accept the default or provide a new value.

   • M-Business Anywhere Database Host – enter the name of the machine on which you are installing UA, for example lab2K.

     The Installer does not install the M-Business server, you must enter these parameters to configure UA to work with M-Business.

   • M-Business Anywhere Database Port – by default the Installer inserts 8099 for the AGDB database port (see Table 2-2). Accept the default or provide a new value.

   • Application Server – select either:

     • Install Apache Tomcat, or

     • Existing Sybase EAServer

   Click Next.

7. If you selected Sybase EAServer, see Appendix A, “Installing Unwired Accelerator in EAServer 5.2” for instructions.

   If you selected Apache Tomcat as the application server, the Tomcat Parameters window displays. Enter the values for these parameters 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.

     If you are using Netscape 7.0.x for Web browser access, and using HTTPS to protect passwords during login, you must use port 80 for the Unwired Accelerator HTTP port.

   • HTTPS Port – by default, the Installer inserts 4443 for the Unwired Accelerator HTTP port (see Table 2-2). Accept the default or provide a new value.

     Before accepting the default, keep in mind:

     • If you are using Netscape 7.0.x for Web browser access, and using HTTPS to protect passwords during login, you must use port 443 for the Unwired Accelerator HTTPS port.

     • If you have M-Business Anywhere server installed on the same machine you are installing Tomcat on, there is a conflict with port 4443, so you must use a different port for HTTPS.

8. 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 detected in the Windows registry, or to those that you provided. The global.properties.xml file is located in $SYBASE/UnwiredAccelerator70/tomcat/webapps/onepage.

   • domain.js – changes the default domain name to the name you provided. The domain.js file is located in $SYBASE/UnwiredAccelerator70/tomcat/webapps/onepage/javascript.

   • server.xml – changes the default port number to the number you provided. The server.xml file is located in $SYBASE/UA70/tomcat/conf/.

   The Installation Summary window displays and reports success or failure of the installation.

9. Click Finish.

10. In the terminal window, from $SYBASE/UnwiredAccelerator70, enter startdb.sh.

    This starts the Adaptive Server Anywhere database. When the database starts, you see “Ping server successful.”

11. In the terminal window, from $SYBASE/UnwiredAccelerator70, 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/infoedition/tomcat
    Using CATALINA_HOME:   $SYBASE/infoedition/tomcat
    Using CATALINA_TMPDIR: $SYBASE/infoedition/tomcat
                           /temp
    Using JAVA_HOME:       ./jdk1.4
    

12. 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/UnwiredAccelerator70/tomcat/logs and check the catalina.out file for errors.

Copyright © 2005. Sybase Inc. All rights reserved.

View this book as PDF