Chapter 2: Installation Procedures

Installing M-Business Anywhere server and client

This section describes how to install M-Business Anywhere server and client software, and to integrate M-Business Anywhere with Unwired Accelerator.

Typically, M-Business Anywhere is installed on the same machine as Unwired Accelerator, but you can install it on any supported machine or platform. If you install on different machines, you must make additional configuration changes.

Mobile applications deployed through M-Business Anywhere require database PODs to run on mobile devices. PODs are binary files compiled from C code to access the Client Extension API. PODs are installed automatically during installation, and enable you to run applications even when the mobile devices are not connected to the server.

For more POD information, see Administrator Guide for M-Business Server (located at http://hostname:8091/enterprise_doc/Admin_MBiz.pdf, where hostname is the machine on which the M-Business Anywhere server is installed).

Installing M-Business Anywhere server software on Linux

In this step, download and install the M-Business Anywhere server software on Linux. In later steps, you will install the M-Business Anywhere client software on a Windows platform and make configuration changes.

Before you begin, stop the Tomcat application server and the Unwired Accelerator ASA database using the instructions in “Starting and stopping the system”.

If the ASA database is running, you will not be able to configure the M-Business Anywhere server and start its processes successfully.
Create an installation directory in which to install M-Business Anywhere server; for example, /opt/MBiz. This directory is referred to as $MBUSINESS_SERVER in this guide.
Download the M-Business Anywhere server software to $MBUSINESS_SERVER using the URL and password that was sent to you in the order-confirmation e-mail when you purchased Unwired Accelerator.

Select M-Business Anywhere Developer Edition, and follow the online instructions for downloading.
Log on as root.
Using a zip utility, extract the MBAnywhereL.tar.gz file into $MBUSINESS_SERVER. The command for extracting the file depends on the utility you are using.

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

Use one of the following commands to unzip:
```
tar -zxvf MBAnywhereL.tar.gz
```
```
gunzip -c MBAnywhereL.tar.gz | tar xvf -
```

Navigate to $MBUSINESS_SERVER/avantgoserver/conf.

Enter the following to launch the installation script:

./installAvantGoServer

Keep in mind the following when using the installation script:

When prompted for a license key, enter the license key that was sent to you in the order-confirmation e-mail when you purchased Unwired Accelerator.
When prompted for a user, accept the default.
When prompted for “sync server port,” enter 8092 (to prevent port conflicts with port 80, which is used by many Web servers). If port 8092 is in use, select another port number.
Accept the machine name, such as “lab2k,” as the machine name.

The installation script:

Starts the following services: httpd, ASA, sync, and soap.
Creates the avantgoserver directory.

If you encounter problems starting the services, the Unwired Accelerator ASA database is probably running. Stop the ASA database and restart the installAvantGoServer script.

Table 2-3 provides several useful M-Business Anywhere server commands for this phase of the installation. Issue all commands from $MBUSINESS_SERVER/avantgoserver/conf. See the Administrator Guide for M-Business Server for additional information (located at http://machine:8091/enterprise_doc/Admin_MBiz.pdf, where machine is the machine on which the M-Business Anywhere server is installed).

**Table 2-3: M-Business Anywhere server toolbox**
Command	Description
`./agserver status`	Check the status of the M-Business Anywhere services, including httpd, ASA, sync, and soap.
`./agserver stop all`	Stops all M-Business Anywhere services in the correct order.
`./agserver start all`	Starts all M-Business Anywhere services in the correct order.
`./installAvantGoServer`	Restarts the installation script, and starts up M-Business Anywhere services.

When the httpd, ASA, sync, and soap services are running successfully, log off as root.
Restart the Unwired Accelerator ASA database and the Tomcat application server using instructions in “Starting and stopping the system”.

Installing M-Business Anywhere client software

In this step, download and install client software for Windows, and for your mobile device.

Download the M-Business Anywhere client software for Windows, using the URL and password that was sent to you in the order-confirmation e-mail when you purchased Unwired Accelerator.
Install M-Business Anywhere client software on Windows.
Open a Web browser and enter the M-Business Anywhere server URL:
```
http://machine:8091
```
Where machine is the machine on which the M-Business Anywhere server software is installed.

The M-Business Anywhere login screen displays.

You can access the M-Business Client User Guide from the login screen, or at http://machine:8091/enterprise_doc/Admin_MBiz.pdf.
From the M-Business Anywhere login screen, download the M-Business Anywhere client software for your mobile device:
1. Select “Download Client Software Only.”
2. Select the language.
3. Select the client software to download for your mobile device.
  - PalmOS – install Palm Desktop 4.x with HotSync.
  - Microsoft PocketPC 2003 – install ActiveSync 3.7.x.
  For other mobile devices, obtain client software from the manufacturer.
4. Install the software on your mobile device.

Connecting M-Business Anywhere and M-Business Client software

In this step, create a connection from the M-Business Client software to the M-Business Anywhere server for each user created.

From the desktop or mobile device, select Start | Programs | M-Business Client | M-Business Connect.

For some mobile devices, if you have synchronized before, use Start | Programs | M-Business Client | Tools | Server Options.
On the M-Business Connect window, select Properties.
On Edit Server Profile window, specify the connection information:
- Hostname – specify your machine name, for example lab2k.
- Port – specify the port number, for example 8092. This is the M-Business Client port (or “sync port”) described in Table 2-2.
- Your account – enter the M-Business user name and password. See “Self-registration” for user account information.
- Connection options – select “Connect to this server during device synchronizations,” and “Refresh all content at next sync.”
Optionally, select Test to test the client-to-server connection. If the test fails, make sure you entered the connection values correctly. Close the Test Server window.
Click OK to save the changes.
Close the M-Business Connect window.

View this book as PDF