Installing MobiLink server on Windows (optional)

This section describes how to install MobiLink server on Windows, if you want to use MobiLink to deploy mobile applications to devices. Basically you:

Install the Adaptive Server Enterprise ODBC driver (15.00.00.140 or higher), needed to communicate between Adaptive Server Enterprise and MobiLink, onto the Windows machine.
Unzip the MobiLink software onto the same Windows machine.
Run scripts to configure MobiLink to communicate with Unwired Accelerator running on Linux on POWER.

Before you install the MobiLink server on the Windows machine, you must:

Make sure you have the correct MSXML Service Pack installed on the Windows machine (as described in “Installing MSXML 4.0 SP2”).
Create a log file directory on the Windows machine, typically X:\tmp\logs. The MobiLink log file (ml.Log) will be written to this directory.

You must have Internet access to install MobiLink.

Installing MSXML 4.0 SP2

Before you start installing MobiLink server, make sure MSXML 4.0 Service Pack 2 is installed. MobilLink requires this version of MSXML, which includes the ulxml.exe file, to generate schema files for clients.

On the Windows 2003 or Windows XP machine, make sure MSXML 4.0 Service Pack 2 (SP2) is installed.

To check the version:
1. Locate the msxml4.dll file, typically found in x:\WINDOWS\system32.
  
  You will find multiple msxml files; be sure to find msxml4.dll.
2. Right-click msxml4.dll, and select Properties | Version to display the version.
If you do not have MSXML 4.0 SP2 installed, you can download it from the Microsoft download site. Search for “MSXML 4.0” to find the MSXML 4.0 Service Pack 2 download.

If you choose the MSI file option, you need Windows Installer 2.0 on the Windows machine. You may have an older version of Windows Installer installer on the Windows machine; if it is not sufficient, you are prompted to download a more current version.
Follow the instructions on the Microsoft Web site to download the software. See the MSXML 4.0 SP2 Release Notes for additional information.

You can start the installation immediately, or copy the download to your Windows machine and install the software at a later time.

If you chose to install MSXML using the MSI file option, and have an older version of Windows Installer on the Windows machine, you may be prompted to download a more current version.

Installing MobiLink server

Install MobiLink server on a Windows 2003 or Windows XP machine with network and Internet access.

Install the Adaptive Server Enterprise ODBC driver (15.00.00.140 or higher), which is needed to communicate between MobiLink and Adaptive Server Enterprise. To do so:
1. Obtain the ODBC driver:
  1. On the Windows machine, go to the Sybase download site.
  2. Log in using your account.
  3. Select “Software Development Kit.”
  4. Scroll down to Windows x86.
  5. Download “Software Development Kit – EBF 13955: 15.0 ESD #6 (16 Oct 2006).”
2. Install the ODBC driver on the Windows machine.
3. Create the ODBC connection by configuring DSN so that the Adaptive Server Enterprise ODBC driver points to the Adaptive Server Enterprise installed on Linux on POWER.
Make sure JAVA_HOME is set, and the executable is in the PATH.
On the Installation CD, locate mlForWindowsPPC.zip.
Unzip mlForWindowsPPC.zip onto the Windows 2003 or Windows XP machine. You can unzip the file into any directory, as long as the directory path uses contiguous characters, and includes no spaces (spaces in the path name causes problems); for example, C:\Sybase\MobiLink or C:\MobiLink. This creates a directory mlForPPC and includes some .bat script files and the /asa directory.

In this document, %SYBASE% is used to indicate the Unwired Accelerator MobiLink installation directory on Windows 2003 or XP.
Edit the %SYBASE%\setenv.bat script:
1. Modify the DB_DSN name to be the ODBC DSN name you just created.
2. Set INSTALL_FOR_PPC to true.
Edit the %SYBASE%\configML.sql script to change database URL’s, user names, and passwords for the UASMS and UAUSM gateway entries:
1. Open the file in a text editor.
2. Make the following changes:
  - Check the UASMS URL value; it should contain ...:5000/portaldatabase so that gateway ends up in the portaldatabase where the tables it needs are.
  - Check the UAUSM value; it should change to ...:5000/uaml to use the consolidated database.
  - Check db_user and db_pwd, and change the default values if you changed them.
    
    Your entries should look similar to:
```
exec ml_add_property 'SIS', 'com.sybase.ua.gateway.USMGateway(UAUSM)',
'database_url', 'jdbc:sybase:Tds:powerplay2.sybase.com:4101/uaml' ;
...
exec ml_add_property 'SIS', 'com.sybase.ua.gateway.USMGateway(UAUSM)',
'db_user', 'sa' ;
exec ml_add_property 'SIS', 'com.sybase.ua.gateway.USMGateway(UAUSM)',
'db_pwd', '' ;
```
  - Edit other properties if you made additional configuration changes to set up your environment.
3. Save the file.
Run the %SYBASE%\setAsaRegistry.bat script to set the values in the registry.
Run the %SYBASE%\configml.bat script to define the MobiLink values in the portaldatabase.
Run the %SYBASE%\startmlsrv.bat script to start MobiLink.

If you encounter any problems, see the MobiLink error log in X:\tmp\logs\ml.log for information.

Updating MobiLink database with new server/port settings (optional)

This step is only necessary if you changed the HTTP server or port values during installation, and are using the Pocket PC client developed by the .NET API. This step updates the MobiLink database with the new server or port value, so you can synchronize mobile applications successfully. [CR #447165]

Log in to Mobile Web Studio.
Click the MobiLink menu item. This automatically updates all the appropriate database entries with the new server/port settings.

Uninstalling MobiLink server

Do the following to uninstall the Unwired Accelerator MobiLink server from the Windows 2003 or XP machine:

Run the %SYBASE%\delAsaRegistry.bat script to remove the ASA registry entries
Remove the directory %SYBASE%\mlForPPC.
Uninstall the Adaptive Server Enterprise PC Client software using the uninstaller software.