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:

• Verify that EAServer 5.2 is installed.

• Install EAServer patches or EBFs. See the Release Bulletin for information about required EAServer patches or EBFs.

• Verify that JDK 1.4 is installed

Installing Unwired Accelerator in EAServer

1. Make sure EAServer is running before you proceed. Note the following requirements:

   • Server name – must be Jaguar

   • Default HTTP port – 8080

   • Default HTTPS port – 8081

2. 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)
   

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

4. From a Command Prompt window, make sure the %SYBASE%, %JAGUAR% and %JAVA_HOME% environment variables are set. If not, set them; for example:

   set SYBASE=c:\Sybase
   set JAGUAR=c:\Sybase\EAServer
   

   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.

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

   set JAGTOOL=%JAGUAR%\bin\jagtool
   set JAGTOOLARGS=-n 9100
   

6. 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.exe. The Welcome window displays.

7. Click Next. The Installer window displays.

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

9. Read the license carefully to make sure you agree to its terms.

10. Click the radio button to agree to the license terms, and click Next. The Installation Directory window displays.

11. Select an installation directory in which to install Unwired Accelerator, for example %SYBASE%\UnwiredAccelerator70.

12. Click Next.

    The Installer checks for available disk space. If there is not enough disk space, the Installer reports the problem and ends. You must free up disk space and start again.

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

    • Domain name – by default, the Installer inserts the domain listed in the Windows registry. Accept the default or enter the domain (and subdomain if used). Note that UA configuration files use sybase.com as the default domain.

    • Host name – by default, the Installer inserts the machine name listed in the Windows registry. Accept the default, or 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 – by default the Installer inserts the machine name, such as lab2K. Accept the default or provide a new value.

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

14. Click Next. The EAServer connection window displays.

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

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

    • EAS Hostname – defaults to the localhost name. If EAServer is installed on another machine, enter its name.

    • 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

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

17. Click Next. The Installation Progress window displays, and shows 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 %JAGUAR%\Repository\WebApplication\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 %JAGUAR%\Repository\tomcat\conf.

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

18. Click Finish.

19. 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 using standard procedures, and restart it by using JAGUAR\bin\serverstart -jdk14.

20. 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.bat – starts the ASA portaldatabase on port 4747

    • stopddb.bat – stops the ASA portaldatabase

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