This chapter provides an overview of the Oracle Communications Mobile Synchronization Gateway installation process.
During the installation process, you install and configure the following components:
Java
Oracle GlassFish Server
Mobile Synchronization Gateway
Before installing Mobile Synchronization Gateway you must have already installed at least Oracle Communications Messaging Server. Additionally, Mobile Synchronization Gateway supports Oracle Communications Calendar Server, Oracle Communications Contacts Server, and Oracle Convergence Personal Address Book (PAB).
Refer to each Unified Communication Suite component product's documentation for installation and configuration instructions.
Mobile Synchronization Gateway depends on Oracle Directory Server Enterprise Edition for LDAP services. If your site does not currently have Directory Server deployed and you need to install it, see the Oracle Directory Server Enterprise Edition documentation for instructions, at:
The installation procedure follows these steps:
Plan your installation. When planning your installation, do the following:
Determine the scale of your implementation, for example, a small development system, or a large production system.
Determine how many physical machines you need, and which software components to install on each machine.
Plan the system topology, for example, how the system components connect to each other over the network.
Review system requirements. System requirements include:
Hardware requirements, such as disk space.
System software requirements, such as operating system (OS) versions and OS patch requirements.
Information requirements, such as IP addresses and host names.
Install and configure software upon which Mobile Synchronization Gateway is dependent:
Java
Oracle GlassFish Server
Prepare the Directory Server schema by installing and running the comm_dssetup script.
Configure the Directory Server host for SSL.
The Mobile Synchronization Gateway init-config script defaults to using SSL communications between itself and the Directory Server host.
Make sure that you are running at least Messaging Server version 8.0.
Configure Unified Communications Suite back-end servers for SSL.
The Mobile Synchronization Gateway init-config script defaults to using SSL communications between itself and Unified Communications Suite back-end servers. If you are using a CA-signed certificate, you do not need to install the certificate on the Mobile Synchronization Gateway host, as long as the instance of GlassFish Server you are using contains the root certificate of that CA. If you are using a self-signed certificate, you must import the certificate into the trustStore file that is used by GlassFish Server on the Mobile Synchronization Gateway host.
Install and configure Mobile Synchronization Gateway.
If you choose not to use SSL in the initial deployment, change the various back-end hosts' ports to use the non-SSL port.
(Optional) Configure additional Mobile Synchronization Gateway front-end hosts and Communications Suite back-end servers for a multiple host deployment.
Perform post-installation configuration tasks.
Verify the installation.
After Mobile Synchronization Gateway is installed, you might perform additional security-related tasks. For more information, see Mobile Synchronization Gateway Security Guide.
You install Mobile Synchronization Gateway in either interactive or silent mode. When you run the installer in silent mode, you are running a non-interactive session. The installation inputs are taken from the following sources:
A silent installation file
Command-line arguments
Default settings
You can use silent mode to install multiple instances of the same software component and configuration without having to manually run an interactive installation for each instance.
Only qualified personnel should install the product. You must be familiar with the UNIX operating system and Oracle GlassFish Server. You should be experienced with installing Java-related packages.
Follow these guidelines:
As you install each component, for example, GlassFish Server, verify that the component installed successfully before continuing the installation process.
Pay close attention to the system requirements. Before you begin installing the software, make sure your system has the required base software. In addition, ensure that you know all of the required configuration values, such as host names and port numbers.
As you create new configuration values, write them down. In some cases, you might need to re-enter configuration values later in the procedure.
Table 1-1 lists the placeholders that are used in this guide:
Table 1-1 Mobile Synchronization Gateway Directory Placeholders
| Placeholder | Directory |
|---|---|
|
MobileSyncGateway_home |
Specifies the installation location for the Mobile Synchronization Gateway software. The default is /opt/sun/comms/mobile. |
|
GlassFish_home |
Specifies the installation location for the Oracle GlassFish Server software. The default is /opt/glassfish3/glassfish. |
|
MessagingServer_home |
Specifies the installation location for the Oracle Communications Messaging Server software. The default is /opt/sun/comms/messaging64. |