4 Convergence Pre-Installation Tasks

This chapter describes the pre-installation steps you must complete before installing and configuring Oracle Communications Convergence.

Installing Java

The application server (Oracle WebLogic Server) is a Java application and needs a Java environment to run.

Install the 32-bit Java JDK if you run a 32-bit OS. Install the 64-bit Java JDK if you run a 64-bit OS.

Download the Java software from the Oracle web site:

http://www.oracle.com/technetwork/java/javase/downloads/index.html

Satisfying Unified Communications Suite Software Dependencies

For each optional or required software application you plan to install to deliver Convergence services, you must satisfy its software requirements and pre-installation tasks. For example, if you plan to integrate Convergence with Oracle Communications Messaging Server, Oracle Communications Calendar Server, and Oracle Communications Contacts Server, you must satisfy the software requirements for each of these applications and complete all their pre-installation tasks.

Preparing the Directory Server

You prepare your directory server by running the directory server setup script (rundssetup) against it. You can run the script in either interactive or silent mode.

You must ensure that the directory server is running the correct version of the directory server setup script. See "System Requirements" for more information about the required script version.

To configure Oracle Unified Directory (OUD), use the rundssetup script.

Before running DS Setup, ensure that a Directory Server instance is already created, and install the following:
  • OUD 12.2.1.4

  • Python 2.7 and above

Note:

To install Oracle Unified Directory, refer to the Installing the Oracle Unified Directory Software in Oracle Fusion Middleware Installing Oracle Unified Directory.

To prepare the directory server:

  1. Download the DS Setup from:

    https://support.oracle.com

    The rundssetup script is available in the same software package as the Convergence software.

  2. Copy the directory server ZIP file to a temporary directory on your directory server hosts and extract the files.

  3. Log on to the directory server host machine as the superuser (root).

  4. Start the directory server, if necessary.

  5. Change to the directory where you extracted the rundssetup script.

  6. Install the rundssetup script.

    ./commpkg install
    

    Select Comms DSsetup from the list of applications to install and proceed with the installation.

    See "commpkg Reference" for more information about the commpkg command.

  7. rundssetup script can be executed in interactive mode or silent mode.

    python rundssetup --dsType OUD

    Answer the command-line prompts.

    Note:

    You can use either LDAP Schema 2 or Schema 1.

To execute rundssetup script in silent mode, refer "Running rundssetup in silent mode".

If the directory server is already installed at your site, users have already been provisioned. If you have just installed the directory server at your site, then you need to provision users. For information about provisioning users and schema, see Communications Suite Schema Reference.

Running rundssetup in silent mode

Following are the options supported for running in silent mode:
rundssetup [-h] [--version] [--debug] [--verbose] [-D BINDDN]

    [-j PASSWDFILE] [-i {yes,no}] [-R {yes,no}] [-d INSTLOC]

    [-r DCTREE] [-u UGSUFFIX] [-s {yes,no}] [-t {1,1.5,2}]

    [-m {yes,no}] [-f {yes,no}] [--silent SILENTFILE]

    [--dsType {OUD,DSEE}] [--createSuffixes {yes,no}]

    [--createSuffixDN {yes,no}] [--createMLusersSuffix {yes,no}]

    [--createPiServerDbSuffix {yes,no}]

For example,

schema 2:
rundssetup -D "cn=Directory Manager" -j /tmp/ds_pass -i yes -R yes -d /oracle/Oracle/Middleware/asinst_1 -u o=usergroup -s yes -t 2 -m yes -f yes --silent=NONE --dsType=OUD --createSuffixes yes --createSuffixDN no --createMLusersSuffix yes --createPiServerDbSuffix yes
schema 1:
rundssetup -D "cn=Directory Manager" -j /tmp/ds_pass -i yes -R yes -d /oracle/Oracle/Middleware/asinst_1 --schemaType 1 -r "o=internet" -u "o=usergroup" -s yes -t 1 -m yes -f yes --silent=NONE --dsType=OUD --createSuffixes yes --createSuffixDN no --createMLusersSuffix yes --createPiServerDbSuffix yes
For more information, run:
rundssetup --help

Installing and Configuring Unified Communications Suite Software

Install and configure the Oracle Communications software required to deliver your planned Convergence services.

Refer to the documentation for each Oracle Communications application for pre-installation, installation, configuration, and post-installation details.

Enabling MSHTTP in Messaging Server

You must enable HTTP service in Messaging Server by setting the related configuration parameters.

To enable MSHTTP, do one of the following and restart Messaging Server:

  • If Messaging Server is deployed with a legacy configuration, set service.http.enable parameter to 1.

  • If Messaging Server is deployed with a Unified Configuration, set the http.enable parameter to 1.

See the Messaging Server wiki for more information about http parameters:

http://msg.wikidoc.info/index.php?title=MSHTTP_options

Enabling Message Body Filtering in Messaging Server

You must enable email message body filtering in Messaging Server. Message body filtering allows users to create mail filter rules on the content of email messages.

To enable email message body filtering, do one of the following:

  • If Messaging Server is deployed with a legacy configuration, edit option.dat, locate the ENABLE_SIEVE_BODY parameter, and set it to 1.

  • If Messaging Server is deployed with a Unified Configuration, set the mta.enable_sieve_body parameter to 1.

See the Messaging Server wiki for more information about the enable_sieve_body parameter:

http://msg.wikidoc.info/index.php/Enable_sieve_body_MTA_option