Installation tasks

Typically, you install Unwired Accelerator in a network environment.

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

Create an installation directory in which to install Unwired Accelerator; for example, C:\Sybase. This directory is referred to as %SYBASE% in this guide.

Do not use spaces in the directory name. Due to a problem with Tomcat, when you install into a directory with spaces in the name, Unwired Accelerator does not run properly.

Copy the UA65.zip file from the CD into the installation directory.

Extract the UA65.zip file into the installation directory. The command for extracting the file depends on the zip utility you are using.

Make sure the zip utility allows the archive to create new folders in the location where you unzip it.

Run the config file to set up the portal to be available to all machines that can reach it on the network. By default, Unwired Accelerator is configured to use demo.sybase.com:4040 for the host, domain, and port. The config file modifies the host and domain values for your environment.

To run config:

Open a Command Prompt window, and navigate to:
```
%SYBASE%\UA65
```
Enter the following command to change both the host name and your domain in the global.properties.xml file (substitute your domain):
```
config domain
```
For example, if your domain is acme.org, enter:
```
config acme.org
```
Alternatively, enter the following command to change only the host name in the global.properties.xml file, or double-click the file in Windows Explorer:
```
config
```
This command modifies:
- global.properties.xml – changes the host name to the machine’s name, and the domain name to the name you provided in the command. The global properties.xml file is located in %SYBASE%\UA65\tomcat\webapps\onepage\config and contains many system settings.
- domain.js – changes the domain name to the name you provided in the command. The domain.js file is located in %SYBASE%\UA65\tomcat\webapps\onepage\javascript.
The config file can only be run once to configure the domain name, since it changes the default name to the name you provide, and cannot be used to reconfigure the domain name. If you enter the domain name incorrectly, you must manually correct the domain value in the global.properties.xml and domain.js files.

If necessary, modify the global.properties.xml file. By default, the domain name in the global.properties.xml file is “sybase.com” and the Unwired Accelerator port is 4040. You may want to change the file if you:

Did not supply the domain name in the preceding step.
Supplied an incorrect domain name in the preceding step.
Want to change the port number, if 4040 is already used.

To modify global.properties.xml:

Use a text editor to open the global.properties.xml file, located in %SYBASE%\UA65\tomcat\webapps\onepage\config.
Search for all instances of sybase.com, and replace each instance with your domain name.
Search for all instances of 4040, and replace each instance with the new port number (if necessary, usually the default is fine).
Save the global.properties.xml file and close it.

If you did not change the port number in the preceding step, you can skip this step.

If you changed the port number in the preceding step, you must also change the port number in the server.xml file.

To modify server.xml:

Use a text editor to open the server.xml file, located in %SYBASE%\UA65\tomcat\conf.
Search for all instances of 4040, and replace each instance with the new port number, if you changed it in the global.properties.xml file.
Save the server.xml file and close it.

From the Command Prompt window, navigate to %SYBASE%\UA65 and enter startdb, or double-click the file in Windows Explorer.

This starts the Adaptive Server Anywhere database. When the database starts, you see the icon for the Sybase ASA database in your taskbar.

From the Command Prompt window, enter starttomcat, or double-click the file in Windows Explorer.

When Tomcat starts, you see a series of messages, including the following:

Starting service Tomcat-Standalone
Apache Tomcat/4.1.29

When you see this message, minimize the Tomcat window (do not close the window). You can ignore the rest of the messages.

If you do not see this message, you can check the datamanager.log, located in x:\tmp\logs, for more information

The Unwired Accelerator installation is complete. See “Verifying the installation” to make sure the network installation works correctly.