Installing Unwired Accelerator (EAServer)

If you plan to install Unwired Accelerator in EAServer, instead of Tomcat, you must use EAServer 5.2, and you must install EAServer 5.2 before you install Unwired Accelerator. If you already have EAServer 5.0 installed, upgrade to EAServer 5.2, and then install Unwired Accelerator.

To install EAServer, use the EAServer automated Install Shield package and follow EAServer installation documentation. If you have problems or questions, see the EAServer installation documentation.

Before you install Unwired Accelerator:

• Install EAServer 5.2 EBF #12978. See the Release Bulletin for information about required EAServer patches or EBFs.

• Verify that JDK 1.4 is installed

• Verify you are running EAServer in normal mode (not debug mode).

Installing Unwired Accelerator in EAServer

Typically you can use any account to install Unwired Accelerator in EAServer. However, if you plan to use port 80 (HTTP) and port 443 (HTTPS), you must log in as root to install Unwired Accelerator.

1. If you plan to use ports 80 (HTTP) and 443 (HTTPS), log in as root. Otherwise, skip this step.

2. Make sure EAServer is running in normal mode before you proceed. Note the following requirements:

   • Server name – must be Jaguar

   • Default HTTP port – 8080

   • Default HTTPS port – 8081

3. Make sure that EAserver has been started with JDK version 1.4 ($JAGUAR/bin/serverstart -jdk14), by checking the Jaguar.log for the following:

   Jul 20 13:27:58 2004: 180389-Java virtual machine initialized: javaversion 1.4.2_06Jul 20 13:27:58 2004: 180389-Java virtual machine initialized: Java HotSpot(TM
   Client VM (version 1.4.2_06-b03, mixed mode)
   

4. Make sure no other Adaptive Server Anywhere instance is using port 4747.

5. From a terminal window, make sure the $SYBASE, $JAGUAR, and $JAVA_HOME environment variables are set. If not, set them; for example:

   setenv SYBASE /opt/sybase
   setenv JAGUAR $SYBASE/EAServer
   setenv JAVA_HOME $SYBASE/shared/jdk1.4.0
   

   The $SYBASE environment variable is set to the parent directory of $JAGUAR if $SYBASE is not set. You can also set $JAVA_HOME to a JDK 1.4 installation, otherwise it is set to the JDK 1.4 version that is used by EAServer.

6. Optionally, set the $JAGTOOL and $JAGTOOLARGS environment variables, which are supported by the setupsetup.sh file. For example, if you are using a non-default IIOP port in EAServer, you can set the environment to:

   setenv JAGTOOL $JAGUAR/bin/jagtool
   setenv JAGTOOLARGS "-n 9100"
   

7. If you plan to use ports 80 (HTTP) and 443 (HTTPS), log in as root. Otherwise, skip this step.

8. Insert the Installation CD. If AutoStart is enabled, the InstallShield wizard starts and the Welcome window displays. If AutoStart is disabled, launch the Installer from the CD by double-clicking ua70setup.bin. The Welcome window displays.

9. Click Next. The Installer window displays.

10. Select the license agreement appropriate for the country or region where the software is being installed, from the drop-down list. The license displays.

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

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

13. Click Next.

    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.

14. On the IP Parameters and Ports window, supply values for these fields:

    • Domain name – enter the domain (and subdomain if used). Note that UA configuration files use sybase.com as the default domain.

    • Host name – enter the name of the machine on which Unwired Accelerator is installed; for example, lab2k. Note that UA configuration files use demo as the default host.

    • UA 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 AGDB Host – enter the machine name, for example lab2K.

    • M-Business AGDB 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 Existing Sybase EAServer.

15. Click Next. The EAServer connection window displays.

16. On the EAServer connection window, supply values for these fields:

    • EAS Directory – defaults to null. Enter a valid directory.

    • EAS Hostname – enter the name of the machine on which EAServer is installed.

    • EAS IIOP port – defaults to 9000.

    • EAS User name – defaults to jagadmin.

    • EAS password – defaults to blank.

    • UA HTTP Port – the default is 8080.

    • UA HTTPS Port – the default is 8081.

17. Click Next. The Installer tries to open a connection to EAServer using the given parameters. You can proceed to the next window only when the connection succeeds. Messages indicate any problems with the parameters supplied. The Installation Summary window reports success or failure of the installation.

18. Click Next. The Installation Progress window shows the installation progress. 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 that you provided. The global properties.xml file is located in $SYBASE/UnwiredAccelerator70/tomcat/webapps/onepage/config and contains many system settings.

      The Unwired Accelerator Administration Guide provides additional information about the global.properties.xml file.

    • domain.js – changes the default domain name to the name you provided. The domain.js file is located in $JAGUAR/Repository/ WebApplication/onepage/javascript.

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

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

19. Click Finish.

20. Verify that EAserver restarted with JDK version 1.4 by checking the Jaguar.log for the following:

    Jul 20 13:27:58 2004: 180389-Java virtual machine initialized: javaversion 1.4.
    2_03Jul 20 13:27:58 2004: 180389-Java virtual machine initialized: Java HotSpot(TM)
    Client VM (version 1.4.2_03-b02, mixed mode)
    

    If not, stop EAServer, then restart it by using JAGUAR\bin\serverstart -jdk14$JAGUAR/bin/serverstart.sh -jdk14.

21. Verify that Adaptive Server Anywhere started correctly.

    You can select Start | Programs | Sybase | UnwiredAccelerator | Start UnwiredAccelerator and Start | Programs | Sybase | UnwiredAccelerator | Stop UnwiredAccelerator to start and stop ASA and Internet Explorer.

    Alternatively, you can use the start and stop scripts, which are located in $SYBASE/UnwiredAccelerator70, for Sybase ASA:

    • startdb.sh – starts the ASA portaldatabase on port 4747

    • stopddb.sh – stops the ASA portaldatabase

22. The Unwired Accelerator installation is complete. Verify the Unwired Accelerator installation by accessing Mobile Web Studio from a Web browser window:

    http://HOSTNAME.PORTALDOMAIN:port/onepage/loader.html

    For example:

    http://lab2k.sybase.com:8080/onepage/index.html

    Be sure to use port 8080 when running Unwired Accelerator from EAServer.

    See “Verifying the installation” to make sure the network installation works correctly. See “Getting started with Portal Interface” and “Getting started with Mobile Web Studio” for information.

    If you are setting up a SAP connection, see “Setting up a SAP connection”.

Copyright © 2005. Sybase Inc. All rights reserved.

View this book as PDF