3.3 Installing the Mobility Service

Before you run the Mobility Service Installation program, ensure that you have done the following:

Review Section 3.1, Planning a Mobility System.
Fill out the GroupWise Mobility Service Installation Worksheet.

If you are setting up a multi-server Mobility system, ensure that you have an Installation Worksheet for each Mobility server. Each Mobility server is independent of other Mobility servers, so you can set them up in whatever order is convenient, based on the overall configuration of your Mobility system.
Complete the tasks in Section 3.2, Preparing to Install the Mobility Service.

The following sections step you through the process of installing the Mobility Service and configuring a Mobility system.

3.3.1 Obtaining the GroupWise Mobility Service 2.1 ISO

You can obtain the GroupWise Mobility Service 2.1 ISO from these locations:

Novell Customer Center

Log in to the Novell Customer Center.
In the Organization drop-down list (next to your name in the upper-right corner), select your organization that is entitled to GroupWise Mobility Service.
Click Software.
In the Novell GroupWise section, locate Novell GroupWise Mobility Service 2.1, then click to display the download page.
Follow the online instructions to download the GroupWise Mobility Service ISO to a convenient temporary directory on the Mobility server.
```
novell-groupwise-mobility-service-2.1.0-x86_64-build_number.iso
```
Skip to Running the Mobility Service Installation Program.

Novell Downloads Website

On Novell Downloads, under Patches, click Search Patches to display Patch Finder.
In the Select a Product drop-down list, select GroupWise.
At the bottom of the GroupWise product list, click GroupWise Mobility Service 2.1 to list the available patches.
Click GroupWise Mobility Service 2.1.0, review the product description, then click Proceed to Download.
Follow the online instructions to download the GroupWise Mobility Service ISO to a convenient temporary directory on the Mobility server.
```
novell-groupwise-mobility-service-2.1.0-x86_64-build_number.iso
```
Continue with Running the Mobility Service Installation Program.

3.3.2 Running the Mobility Service Installation Program

Ensure that you know the location where the Mobility Service ISO was downloaded on the Mobility server:
```
novell-groupwise-mobility-service-2.1.0-x86_64-build_number.iso
```
On your Linux desktop, click Computer > YaST to open the YaST Control Center.
Enter the root password.
Under Groups, click Software, then click Add-On Products.
On the Installed Add-On Products page, click Add.
On the Media Types page, select Local ISO Image, then click Next.
In the Repository Name field, specify a name for the repository that will hold the Mobility Service software, such as Mobility Service.
In the Path to ISO Image field, specify the full path name of the ISO file from Step 1, then click Next.
Accept the License Agreement, then click Next.
Under Primary Functions, select Novell GroupWise Mobility Service.
Click Accept to start the installation.
Click Continue to acknowledge the automatic changes to other aspects of the server that will be made as the Mobility Service software is installed.

IMPORTANT:Do not click Next at this point.
After the software has been installed, click Change > GroupWise Mobility Service Configuration to configure your Mobility system.
Use the information that you have entered on the GroupWise Mobility Service Installation Worksheet to provide the information that the Mobility Service Installation program prompts you for. Click Next to move from page to page.

User/Server Settings:
- GroupWise
- LDAP
LDAP Server Settings (if you selected LDAP as the user source):
Mobility Service Settings (LDAP only):
Mobility Service Settings:
- Mobility Service Database Password
GroupWise Sync Agent Settings:
Device Sync Agent Settings:
Novell Customer Center Registration:
- Customer Center Email Login
- Mobility Service Activation Code
On the Mobility Service Configuration page, click Next to save the configuration settings and install the Mobility Service software.

You see the GroupWise Mobility Service listed on the Installed Add-on Products page.
Click OK to return to the YaST Control Center.

If you encounter any problems during the installation, check the Mobility Service Installation program log file for information about the problem:

/var/log/datasync/install.log

For additional assistance, see Section A.0, GroupWise Mobility Service Installation Troubleshooting.

The Mobility Service Installation program creates the following directories and files:

/opt/novell/datasync
/etc/init.d/rcgms
/etc/datasync
/var/lib/datasync
/var/log/datasync
/var/run/datasync
/var/lib/pgsql

IMPORTANT:Although you use the YaST Add-On Products installer to install the Mobility Service, you must use the Mobility Service uninstall.sh script to uninstall it. For instructions, see Section 3.3.5, Uninstalling the Mobility Service. If you do not uninstall the Mobility Service correctly, you cannot successfully install it again.

3.3.3 Checking the Status of the Mobility Service

The Mobility Service Installation program starts the Mobility Service for you. If the installation proceeded normally, all components of the Mobility Service should be running.

In a terminal window on the Mobility server, become root by entering su - and the root password.
Use the following command to check the status of the Mobility Service:
```
rcgms status
```
Use the following commands to manually start and stop the Mobility Service:
```
rcgms start
rcgms restart
rcgms stop
```

3.3.4 Using the Mobility Admin Console

The Mobility Service Installation program starts the GroupWise Sync Agent and the Device Sync Agent for you. Use the Mobility Admin console to check sync agent status.

In your web browser, access the Mobility Admin console at the following URL:
```
https://mobility_server_address:8120
```
Replace mobility_server_address with the IP address or DNS hostname of the server where the Mobility Service is installed.
Log in as the Mobility administrator (the LDAP Admin user that was set up during installation, or root).

The sync agents should display a status of Running.
(Conditional) If one or both sync agents are not yet running:
1. Start the GroupWise Sync Agent first.
2. Start the Device Sync Agent second.
  
  The GroupWise Sync Agent accesses the GroupWise Address Book to obtain information needed by the Device Sync Agent.
(Conditional) If you encounter problems starting the sync agents, see the following troubleshooting resources:
Skip to Section 3.4, Adding Users to Your Initial Mobility System.

3.3.5 Uninstalling the Mobility Service

IMPORTANT:When you uninstall the Mobility Service software, certificate files are also deleted. If you have obtained commercially signed certificates for use in your Mobility system, back them up before you uninstall the Mobility Service software.

In a terminal window on the Mobility server, become root by entering su - and the root password.
Change to the following directory:
```
/opt/novell/datasync
```
Run the Mobility Uninstallation script:
```
./uninstall.sh
```
The Uninstallation script stops the Mobility Service, the sync agents, and the PostgreSQL database server It also uninstalls all Mobility Service RPMs, drops the Mobility Service PostgreSQL database, and deletes the following directories and files from the Mobility server:
```
/opt/novell/datasync
/etc/init.d/rcgms
/etc/datasync
/var/lib/datasync
/var/log/datasync
/var/run/datasync
/var/lib/pgsql
```
Remove the Mobility Service repository from the Linux server.

IMPORTANT:If you do not remove the existing Mobility Service repository, you cannot successfully install the next version of the Mobility Service software.
1. In YaST, click Software > Software Repositories.
2. Select the Mobility Service repository, then click Delete.
(Conditional) If you encounter problems reinstalling the Mobility Service after uninstalling it, see A reinstallation of the Mobility Service software does not proceed normally.