F Installing Oracle Collaboration Suite Clients

This chapter describes how to install Oracle Collaboration Suite clients that can communicate successfully with the servers on which Oracle Collaboration Suite components are installed. The procedures for the different platforms are explained in separate sections.

The chapter contains the following sections:

• Section F.1, "Installing Oracle Calendar Clients"

• Section F.2, "Installing Oracle Connector for Outlook 10.1.2.x"

• Section F.3, "Installing Oracle Connector for Outlook 10.1.3"

• Section F.4, "Installing Oracle Records Management Add-In for Outlook"

• Section F.5, "Installing Oracle Real-Time Collaboration Clients"

F.1 Installing Oracle Calendar Clients

This section discusses the installation of Oracle Calendar clients. It contains the following topics:

• Section F.1.1, "Installing the Oracle Calendar Desktop Client"

• Section F.1.2, "Installing Oracle Calendar Sync"

• Section F.5, "Installing Oracle Real-Time Collaboration Clients"

The installation files for these clients can be found in the /client folder on the Oracle Collaboration Suite DVD.

F.1.1 Installing the Oracle Calendar Desktop Client

This section discusses the installation of the Oracle Calendar desktop client for Linux, Macintosh, Solaris, and Windows platforms. It contains the following topics:

• Installing the Oracle Calendar Desktop Client for Linux

• Installing the Oracle Calendar Desktop Client for Macintosh

• Installing the Oracle Calendar Desktop Client for Solaris

• Installing the Oracle Calendar Desktop Client for Windows

F.1.1.1 Installing the Oracle Calendar Desktop Client for Linux

Table F-1 lists the system requirements for installing the Oracle Calendar desktop client on different Linux platforms.

Table F-1 System Requirements for Installing the Oracle Calendar Desktop Client for Linux

Item	Requirement
Operating Systems	One of the following: Red Hat Linux 9 or later SUSE Linux 9 or later Linux x86 with kernel 2.4.9 or later Note: You need Netscape Navigator 4.0 or later, or Mozilla, to use the Oracle Calendar desktop client online help. The directory that contains the Netscape or Mozilla executable file must be set in the installation path you specify.
Disk Space	40 MB
RAM	128 MB
Calendar Servers	One of the following: Oracle Calendar server 9.0.3.x Oracle Calendar server 9.0.4.x Oracle Calendar server 10.1.1.x (10gR1) Oracle Calendar server 10.1.2.x (10gR1)

To install the Oracle Calendar desktop client for Linux:

1. Unpack the distribution archive in a temporary directory, as follows:

   gtar zxvf /tmp/cal_linux_1012.tar.gz
   
   

2. Change to the OracleCalendar_inst directory, as follows:

   cd OracleCalendar_inst
   
   

3. To install using a full graphical interface, run gui_install.sh.

4. If you prefer to install using a text mode interface, run text_install.sh. You will be prompted for installation and shortcut directories.

Installing the Oracle Calendar Desktop Client for Linux in Silent Mode

1. Unpack the distribution archive in a temporary directory, as follows:

   gtar zxvf /tmp/cal_linux_1012.tar.gz
   
   

2. Create the directory OracleCalendar_inst.

3. Change to the OracleCalendar_inst directory, as follows:

   cd OracleCalendar_inst
   
   

4. To install the Oracle Calendar desktop client for Linux with no user interaction, run ./silent_install.sh.

The OracleCalendar_inst/ocal.conf directory contains a silent.properties file. To alter the location where the Oracle Calendar desktop client is installed, define new paths for the following parameters:

• USER_INSTALL_DIR

• USER_SHORTCUTS

F.1.1.2 Installing the Oracle Calendar Desktop Client for Macintosh

Table F-2 lists the system requirements for installing the Oracle Calendar desktop client on the Macintosh platform.

Table F-2 System Requirements for Installing the Oracle Calendar Desktop Client for Macintosh

item	Requirement
Operating Systems	Mac OS 10.1.5 to 10.4 Mac OS 10.4.3 (Intel)
Disk Space	50 MB minimum
RAM	128 MB minimum 256 MB recommended
Calendar Servers	One of the following: Oracle Calendar server 9.0.3.x Oracle Calendar server 9.0.4.x Oracle Calendar server 10.1.1.x (10gR1) Oracle Calendar server 10.1.2.x (10gR1)

To install the Oracle Calendar desktop client for Macintosh:

Note: You must have administrative privileges on the computer on which you want to install the Oracle Calendar desktop client.

1. Double-click cal_mac_OSX_1012x.dmg. The Oracle Calendar mounted disk appears.

2. Double-click the Oracle Calendar mounted disk icon.

3. Select the Oracle Calendar and readme files and drag them to the folder where you want to install the Oracle Calendar desktop client for Macintosh.

Note: Oracle recommends installing the Oracle Calendar desktop client for Macintosh in your Applications folder. If you choose to install in the Applications folder, you may be prompted to enter an administrator password.

F.1.1.3 Installing the Oracle Calendar Desktop Client for Solaris

Table F-3 lists the system requirements for installing the Oracle Calendar desktop client on the Solaris platform.

Table F-3 System Requirements for Installing the Oracle Calendar Desktop Client for Solaris

Item	Requirement
Operating Systems	Solaris 8, 9 (SPARC only) Note: You need Netscape Navigator 4.0 or later, or Mozilla, to use the Oracle Calendar desktop client online help. The directory that contains the Netscape or Mozilla executable file must be set in the installation path you specify.
Disk Space	50 MB
RAM	128 MB
Calendar Servers	One of the following: Oracle Calendar server 9.0.3.x Oracle Calendar server 9.0.4.x Oracle Calendar server 10.1.1.x (10gR1) Oracle Calendar server 10.1.2.x (10gR1)

To install the Oracle Calendar desktop client on Solaris:

1. Unpack the distribution archive in to a temporary directory, as follows:

   gtar zxvf /tmp/cal_solaris_1012.tar.gz
   
   

2. Change to the OracleCalendar_inst directory, as follows:

   cd OracleCalendar_inst
   
   

3. To install using the graphical interface, run gui_install.sh. To install using a text mode interface, run text_install.sh.

4. If you prefer to install using a text mode interface, run text_install.sh. You will be prompted for installation and shortcut directories.

Installing the Oracle Calendar Desktop Client for Solaris in Silent Mode

1. Unpack the distribution archive in a temporary directory, as follows:

   gtar zxvf /tmp/cal_solaris_1012.tar.gz
   
   

2. Create the directory OracleCalendar_inst.

3. Change to the OracleCalendar_inst directory, as follows:

   cd OracleCalendar_inst
   
   

4. To install the Oracle Calendar desktop client for Linux with no user interaction, run ./silent_install.sh.

The OracleCalendar_inst/ocal.conf directory contains a silent.properties file. To alter the location where the Oracle Calendar desktop client for Solaris is installed, define new paths for the following parameters:

• USER_INSTALL_DIR

• USER_SHORTCUTS

F.1.1.4 Installing the Oracle Calendar Desktop Client for Windows

Section F.1.1.4 lists the system requirements for installing the Oracle Calendar desktop client on Microsoft Windows platforms.

Table F-4 System Requirements for Installing the Oracle Calendar Desktop Client for Windows

Item	Requirement
Operating Systems	Microsoft Windows 2000 Microsoft Windows XP Home or Professional Note: Windows XP Service Pack 1 is required, but Oracle recommends Windows XP Service Pack 2.
Disk Space	50 MB
RAM	128 MB minimum 256 MB recommended
Calendar Servers	One of the following: Oracle Calendar server 9.0.3.x Oracle Calendar server 9.0.4.x Oracle Calendar server 10.1.1.x (10gR1) Oracle Calendar server 10.1.2.x (10gR1)

To Install the Oracle Calendar desktop client for Windows:

1. Log in with administrative privileges if you are installing on Windows 2000 or XP.

2. Double-click cal_win_1012.exe.

3. Follow the instructions on the screen.

Upgrading the Oracle Calendar Desktop Client for Windows

Upgrading from a previous release of the Oracle Calendar desktop client must be done using the original profile, meaning the user who originally installed the application. To upgrade the installation correctly, you should upgrade using the original user account. Otherwise, you must uninstall the Oracle Calendar desktop client using the original user account. Then reinstall the application using the new release.

The installation package upgrades any previous releases of the Oracle Calendar desktop client existing on the computer of the user. It also upgrades any beta versions of the Oracle Calendar desktop client for the Oracle Calendar server 10.1.2.

Installing the Oracle Calendar Desktop Client for Windows in Silent Mode

The Oracle Calendar desktop client for Windows 10.1.2 offers silent and customizable installations for administrators. To perform a silent installation, enter the executable file name followed by the argument for silent mode, the argument for passing command-line options and public property values to the Microsoft installer (msiexec.exe), and the argument for a completely silent installation.

Table F-5 defines the command-line options that you can use to customize a silent installation.

Table F-5 Command-Line Options for a Silent Installation of the Oracle Calendar Desktop Client for Windows

Option	Function
/s	This option extracts installation package files in silent mode.
/v	This option passes command-line options and values to the Microsoft installer (msiexec.exe).
/qn	This option specifies a completely silent installation with no user interface.
/qb	This option provides basic user feedback during the installation such as progress indicators, but prevents users from modifying any installation parameters or information. For example, users can see the progress indicator while files are being copied, but are not allowed to specify the destination path.

For example, to install cal_win_1012x.exe in silent mode and pass the command-line options and values to the Microsoft installer, without any user interface or prompts, enter the following command:

cal_win_1012x.exe /s /v"qn"

Notes: Command-line options are not case-sensitive. For more information on the levels of user interaction available with the Microsoft Windows Installer /q option, refer to the Microsoft Windows Installer documentation available at http://msdn.microsoft.com/library/default.asp?url=/library/en-us/msi/setup/command_line_options.asp The /V option should always be the last option specified in the command line.

Extracting Installation Package Files in Administrative Mode

To extract the installation package files in administrative mode, run cal_win_1012.exe as follows:

cal_win_1012.exe /a

Note: If you have an earlier release of the Oracle Calendar desktop client, then the new version will overwrite it.

The following files are extracted when you run cal_win_1012.exe in administrative mode:

• The Oracle Calendar.msi package

• Various redistributable files

• A folder hierarchy identical to the one in the installed product, containing the files OCal.exe and unison.ini

Table F-6 provides definitions for the extracted files.

Table F-6 Files Extracted While Running cal_win_1012x.exe in Administrative Mode

Files	Description
Oracle Calendar.msi	This file is the main installer package that runs in the MSI installer engine.
OCal.exe	This file contains the InstallShield setup scripts. It is the InstallShield wrapper that runs the MSI installer engine with the Oracle Calendar.msi file. This file installs the MSI installer engine if it does not already have the same.
unison.ini	This is a template file for user preferences.

F.1.1.4.1 Additional Administrative Tasks for Installing Oracle Calendar Desktop Client for Windows

This section discusses additional administrative tasks you may need to perform for installing the Oracle Calendar desktop client for Windows. It contains the following topics:

• Customizing the Oracle Calendar Initialization File

• Performing an Advertised Installation of the Oracle Calendar Desktop Client for Windows

• Deploying the Oracle Calendar Desktop Client for Windows Package Using Group Policy

• Assigning Oracle Calendar

Customizing the Oracle Calendar Initialization File

You can specify the calendar preferences and setup information by using the client-side unison.ini file.

When you install the Oracle Calendar desktop client, you can provide the installer with a template unison.ini file preset with a variety of preferences and other information. The template unison.ini file is used only if no previous unison.ini file exists. After a personal unison.ini file is created for a user, subsequent client upgrades will not remove or replace it. In other words, the ability to preset unison.ini preferences for the client installer is only available for users who have not yet used any version of the Oracle Calendar desktop client on the current computer. There are two reasons for this:

The user upgrading the application will not necessarily be able to view or modify the unison.ini files stored in the profile folders of other users. In other words, the installer cannot locate all the unison.ini files on the current computer and therefore will not be able to replace them with the new template.

All user preferences not specified in the template unison.ini file or stored directly on the Oracle Calendar server are lost if the previous unison.ini file of the user is replaced.

Performing an Advertised Installation of the Oracle Calendar Desktop Client for Windows

When advertising an installation of the Oracle Calendar desktop client for Windows on a user's computer, the Oracle Calendar desktop client for Windows shortcuts are installed, its icons appear in the Start menu, and the file types become registered, but the product's files are not actually installed until the user accesses one of these items to start the application. You can advertise the Oracle Calendar desktop client for Windows on the user's computer, but only if one of the following operating systems is running on it:

• Microsoft Windows 2000

• Microsoft Windows XP Home or Professional

• Microsoft Windows 2003

To advertise an installation of the Oracle Calendar desktop client for Windows package on each user's computer, enter the following command:

msiexec.exe -jm "Oracle Calendar.msi" ALLUSERS=1

Deploying the Oracle Calendar Desktop Client for Windows Package Using Group Policy

You can use the included tools to install and maintain software applications by using Group Policy on Microsoft Windows 2000 or later. An administrator can advertise Oracle Calendar on the local computer by assigning the Oracle Calendar.msi package to users' computers through Active Directory and Group Policy.

Assigning Oracle Calendar

Assigning the Oracle Calendar desktop client for Windows is the easiest way to use Group Policy to manage an installation package. With this method, Oracle Calendar is automatically installed on the computer of the user the first time a designated computer is started and Group Policy is applied. The Oracle Calendar desktop client for Windows is then available to all users of this computer.

Note: Only an administrator can permanently remove the application.

F.1.2 Installing Oracle Calendar Sync

This section discusses the installation of Oracle Calendar Sync for Palm and Oracle Calendar Sync for Pocket PC. It contains the following topics:

• Installing Oracle Calendar Sync for Palm for Macintosh

• Installing Oracle Calendar Sync for Palm for Windows

• Installing Oracle Calendar Sync for Pocket PC

F.1.2.1 Installing Oracle Calendar Sync for Palm for Macintosh

This section contains the following topics:

• System Requirements for Oracle Calendar Sync for Palm for Macintosh

• Oracle Calendar Sync for Palm for Macintosh Preinstallation Instructions

• Installing Oracle Calendar Sync for Palm for Macintosh

System Requirements for Oracle Calendar Sync for Palm for Macintosh

Table F-7 lists the system requirements for installing Oracle Calendar Sync for Palm on Macintosh platforms.

Table F-7 System Requirements for Installing Oracle Calendar Sync for Palm for Macintosh

Item	Requirement
Operating Systems	Mac OS 10.2.x to 10.4.5 (PowerPC) Mac OS 10.4.3 (Intel)
Disk Space	10 MB
RAM	8 MB minimum 64 MB recommended
Calendar Servers	One of the following: Oracle Calendar server 9.0.3.x Oracle Calendar server 9.0.4.x Oracle Calendar server 10.1.x (10gR1)
Palm Desktop	4.0 to 4.2.1 Note: Later releases of Palm Desktop may be compatible, but were not certified at the time Oracle Calendar Sync 9.0.4.2.11 was released.
Devices	The following devices are certified for compatibility with Oracle Calendar Sync for Palm for Macintosh. Similar devices may also be compatible, but were not certified at the time Oracle Calendar Sync 9.0.4.2.11 was released. For a complete list of the devices that are certified for compatibility with Oracle Calendar Sync for Palm for Macintosh, refer to "Oracle Calendar Sync" in Chapter 1 of the Oracle Collaboration Suite Certification Guide. Tungsten T Tungsten T3 Zire 31 Zire 72 Treo 600 Sony Clie PEG-TG50C Treo 650 Tungsten T5 Note: Treo 650 and Tungsten T5 require Palm OS 5.4.8 or higher. The following devices do not work with Oracle Calendar Sync for Palm for Macintosh. Tungsten E2 LifeDrive Mobile Manager

Oracle Calendar Sync for Palm for Macintosh Preinstallation Instructions

If you already have a previous release of Oracle Calendar Sync installed on your computer, or if you are changing your device, Oracle recommends that you perform a full synchronization before you install Oracle Calendar Sync for Palm for Macintosh.

If you have a Beta release of Oracle Calendar Sync installed, or you have release 2.1.4 or an earlier release of Oracle Corporate Sync installed, then you must do the following before installing Oracle Calendar Sync for Palm for Macintosh, to protect your data.

1. Remove the Oracle Calendar Sync application (also known as CS Setup) from your Palm organizer.

2. Purge all items from your Date Book and To Do List. If you do not do this, duplicate items will be created when you perform the first HotSync after the installation. Apply the following guidelines when purging data:

• Ensure that Save archive copy on PC is selected.

• To Do items that have not been marked as completed must be manually deleted.

• To delete the Date Book events, advance the date on your organizer by several years, then purge data. For example, change organizer date to 2015, then purge all events older than 1 week to delete all events from the past until the year 2015.

Installing Oracle Calendar Sync for Palm for Macintosh

Note: If you have a previous version of Oracle Calendar Sync installed, or if you are changing your device, Oracle recommends that you perform a full synchronization before you install Oracle Calendar Sync for Palm for Macintosh.

To install Oracle Calendar Sync for Palm for Macintosh, perform the following steps:

1. Double-click cal_syncpalm_macOSX_904211.dmg. This creates the Oracle Calendar Sync installer.

2. Double-click the OracleSync Installer mounted disk icon.

3. Double-click OracleSync Installer.

4. Follow the on-screen instructions.

Troubleshooting the Oracle Calendar Sync for Palm for Macintosh Installation

After installing Oracle Calendar Sync for Palm for Macintosh, you may have difficulties performing a HotSync operation. This may be because of a conflict with Palm Desktop files. To troubleshoot this problem, perform the following tasks:

1. Delete the Users directory located at /Users/your_user_name/Documents/Palm/Users.

   In the preceding example, your_user_name is the user name you used to log in.

2. Delete the com.palm.Desktop.plist file located at /Users/your_user_name/Library/Preferences.

3. Delete the following files, which are located in the /Users/your_user_name/Library/Preferences/ByHost directory:

   • com.palm.HS.T.S.xxxxxxxx.plist

   • com.palm.HS.T.PC.xxxxxxxx.plist

   • com.palm.HS.T.USB.xxxxxxxx.plist

4. Start HotSync Manager. You will be prompted for a user name.

5. Enter your user name and any other necessary HotSync information.

6. Close HotSync Manager, and perform a HotSync.

F.1.2.2 Installing Oracle Calendar Sync for Palm for Windows

This section contains the following topics:

• System Requirements for Oracle Calendar Sync for Palm for Windows

• Installing Oracle Calendar Sync for Palm for Windows

• Selecting Conduits for Synchronization

System Requirements for Oracle Calendar Sync for Palm for Windows

Table F-8 lists the system requirements for installing Oracle Calendar Sync for Palm on Microsoft Windows.

Table F-8 System Requirements for Installing Oracle Calendar Sync for Palm for Windows

Item	Requirement
Operating Systems	Microsoft Windows 2000 Microsoft Windows XP Home or Professional Note: Windows XP Service Pack 1 is required, but Oracle recommends Windows XP Service Pack 2.
Disk Space	75 MB
RAM	128 MB
Calendar Servers	Oracle Calendar server 9.0.3.x Oracle Calendar server 9.0.4.x Oracle Calendar server 10.1.1.x (10gR1) Oracle Calendar server 10.1.2.x (10gR1)
Software	Palm Desktop 3.1 to 4.1.4 Note: Later releases of Palm Desktop may be compatible, but were not certified at the time Oracle Calendar Sync 10.1.2 was released. Microsoft .NET Microsoft .NET Framework 1.1
Devices	The following devices (for Palm operating systems 4.1 to 5.4 inclusive) are certified for compatibility with Oracle Calendar Sync for Palm for Windows. Similar devices may also be compatible. Tungsten T Tungsten T3 Tungsten T5 Zire 31 Zire 72 Treo 600 Treo 650 Sony Clie PEG-TG50C

Installing Oracle Calendar Sync for Palm for Windows

If you have a previous version of Oracle Calendar Sync installed, or if you are changing device, Oracle recommends that you perform a full synchronization before you install Oracle Calendar Sync for Palm for Windows.

1. Before you install Oracle Calendar Sync for Palm on your computer, verify that your Palm device is set to the correct date. An incorrect date leads to unexpected results when performing a synchronization.

2. Run the cal_syncpalm_win_1012.exe file provided with the distribution package and follow the InstallShield instructions on the screen.

3. Select an installation type, Complete or Custom.

   
   

   Notes: A Complete installation replaces the Date Book, To Do List, and Address conduits to synchronize with Oracle Calendar's Events, Tasks, and Address Book respectively. In a Custom installation, there is no difference between This feature will be installed on local hard drive and This feature, and all subfeatures, will be installed on local hard drive. Select the conduits you want to install. For example, you can synchronize the Palm Date Book with Oracle Calendar while keeping your existing conduit settings for To Do List and Address so they can synchronize with the Palm desktop.

   
   

4. Enter the following Sign In settings in the Synchronization Settings dialog box:

   1. User: Enter the user name.

   2. Password: Enter your password.

   3. Server: Enter the domain name or the IP address of your calendar server.

      
      

      Note: If you do not have the server information and you are using Oracle Connector for Outlook or the Oracle Calendar desktop client, check for the server name in the Oracle Connector for Outlook Profile Settings dialog box or the Connection Manager dialog box.

      
      

   4. Node: Most server configurations do not require you to specify a node. However, if synchronization fails, view the message log.

5. Ensure that your device is in its cradle, then perform a synchronization. The first time you perform synchronization after installation, a full synchronization is performed.

Selecting Conduits for Synchronization

Use the Custom dialog box to view or change the HotSync Manager conduits and actions for each user name.

To select a conduit for synchronization:

1. To display the Custom dialog box, select Custom from the HotSync Manager menu.

2. Select a conduit from the list and click Change to select how you want to synchronize your Calendar, Tasks, and Contact information.

If you are using a recent Palm device, you may notice that the three conduits, Date Book, To Do List, and Address, are duplicated in the form of Calendar, Tasks, and Contacts. Choosing to synchronize two conduits with similar data produces an error. For example, you should not synchronize both Calendar and Date Book. You must disable one set of conduits (for example, Date Book, To Do List, and Address) before initiating the next synchronization.

Older Palm operating systems (for example, Palm OS 3.1-5.0) continue to synchronize their files with the Date Book, To Do List, and Address conduits. One device that uses this operating system is the Treo 600.

Newer Palm operating systems (for example, Palm OS 5.2 and later) synchronize their files with the Calendar, Tasks, and Contacts conduits. Devices that use these operating systems include Tungsten T, Tungsten T3, Zire 31, and Zire 72.

F.1.2.3 Installing Oracle Calendar Sync for Pocket PC

This section includes the following topics:

• System Requirements for Oracle Calendar Sync for Pocket PC

• Installing Oracle Calendar Sync for Pocket PC

System Requirements for Oracle Calendar Sync for Pocket PC

Table F-9 discusses system requirements for installing Oracle Calendar Sync for Pocket PC on Microsoft Windows.

Table F-9 System Requirements for Installing Oracle Calendar Sync on Pocket PC

Item	Requirement
Operating Systems	Microsoft Windows 2000 Microsoft Windows XP Home or Professional Note: Windows XP Service Pack 1 is required, but Oracle recommends Windows XP Service Pack 2.
Disk Space	75 MB
RAM	128 MB
Calendar Servers	Oracle Calendar server 9.0.3.x Oracle Calendar server 9.0.4.x Oracle Calendar server 10.1.1.x (10gR1) Oracle Calendar server 10.1.2.x (10gR1)
Pocket PC	Pocket PC devices with any of the following processors: Multiprocessor without Interlocked Pipeline Stages (MIPS) SH3 (a processor developed by Hitachi Corporation that can be found in the Pocket PC) Advanced RISC Machine (ARM), or XScale (a next-generation ARM-based processor from Intel that can operate between 300 and 400MHz)
Software	ActiveSync Version 3.0 to 3.8, as appropriate for your device. If you are running an older release of Microsoft ActiveSync, check the vendor site for updates. Note: Later releases of Microsoft ActiveSync may be compatible, but were not certified at the time Oracle Calendar Sync 10.1.2 was released. Microsoft .NET Microsoft .NET Framework 1.1
Devices	The following devices are certified for compatibility with Oracle Calendar Sync for Pocket PC. Similar devices running the same Pocket PC operating system with MIPS, SH3, ARM, or XScale processor may also be compatible. Dell Axim X50 (Windows Mobile 2003 - Second Edition) HP iPAQ H1910 (Pocket PC 2002) HP iPAQ 3600 (Pocket PC 2002) HP iPAQ h5550 series (Windows Mobile 2003 - Premium Edition) HP iPAQ h6300 series (Windows Mobile 2003 - Phone Edition)

Installing Oracle Calendar Sync for Pocket PC

If you have a previous version of Oracle Calendar Sync installed, or if you are changing device, Oracle recommends that you perform a full synchronization before you install Oracle Calendar Sync for Pocket PC. Ensure the following:

1. Before you install Oracle Calendar Sync for Pocket PC on your computer, verify that your Pocket PC is set to the correct date. An incorrect date leads to unexpected results when performing a synchronization.

2. Verify that ActiveSync is installed on your computer.

3. Run the cal_syncppc_win_1012.exe file provided with the distribution package and follow the InstallShield instructions on the screen.

4. Select an installation type, Complete or Custom.

   
   

   Note: A Complete installation replaces the Calendar, Tasks, and Contacts conduits to synchronize with Oracle Calendar's Events, Tasks, and Address Book respectively. In a Custom installation, there is no difference between This feature will be installed on local hard drive and This feature, and all subfeatures, will be installed on local hard drive. Select the conduits you want to install. For example, you can synchronize the Pocket PC Calendar with Oracle Calendar while keeping your existing conduit settings for Tasks and Contacts so they can synchronize with Microsoft Outlook.

   
   

5. When prompted by the application, install Oracle Calendar Sync Helper files. Your pocket PC device must be connected to install these files.

   
   

   Note: To connect and install the Helper files later, click Start, Programs, Oracle Calendar Sync for Pocket PC, and then Install Device Files.

   
   

6. Follow the remaining instructions on the screen to complete the installation.

7. Check your mobile device screen for any additional steps required to complete the installation.

8. Enter the following Sign In settings in the Synchronization Settings dialog box:

   1. User: Enter your user name.

   2. Password: Enter your password.

   3. Server: Enter the domain name or the IP address of your calendar server.

      
      

      Note: If you do not have the server information and you are using Oracle Connector for Outlook or the Oracle Calendar desktop client, check for the server name in the Oracle Connector for Outlook Profile Settings dialog box or the Connection Manager dialog box respectively.

      
      

   4. Node: Most server configurations do not require you to specify a node. However, if synchronization fails, view the message log.

9. Synchronize your device. The ActiveSync Partnership Wizard starts.

10. Follow the on-screen instructions to create a new ActiveSync Partnership.

11. From the lists, select Oracle Calendar as your personal information manager for the Calendar, Contacts, and Tasks conduits.

12. Open Microsoft ActiveSync if it does not open automatically.

13. Click Sync if synchronization is not automatically initiated. The first time you synchronize, a full synchronization occurs.

14. From the Microsoft ActiveSync dialog box, click Options.

15. Select the Schedule tab in the Options dialog box.

16. Select when you want ActiveSync to synchronize information between the mobile device and the desktop computer. The three options are:

    • Continuously while the device is connected

    • Only upon connection

    • Manually

Note: Oracle Calendar Sync for Pocket PC supports all three desktop scheduling modes, but we recommend choosing Manually if you want to control when synchronization occurs.

F.2 Installing Oracle Connector for Outlook 10.1.2.x

Note: If you are using Oracle Connector for Outlook 10.1.3, please see Section F.3.

This section contains the following topics:

• Section F.2.1, "System Requirements"

• Section F.2.2, "Preinstallation Requirements"

• Section F.2.3, "Installing Oracle Connector for Outlook 10.1.2.x in Interactive Mode"

• Section F.2.4, "Installing Oracle Connector for Outlook Using the con_outlook_1012x.exe Utility"

• Section F.2.5, "Installing Oracle Connector for Outlook Using the msiexec.exe Utility"

• Section F.2.6, "Configuring Oracle Connector for Outlook Using the ocprofwiz.exe Utility"

• Section F.2.7, "Configuring the Initialization File Used in the Silent Installation of Oracle Connector for Outlook"

• Section F.2.8, "Upgrading Oracle Connector for Outlook"

• Section F.2.9, "Modifying, Repairing, or Removing Oracle Connector for Outlook"

• Section F.2.10, "Troubleshooting an Oracle Connector for Outlook Installation"

F.2.1 System Requirements

Table F-16 lists the system requirements for installing Oracle Connector for Outlook 10.1.2.x.

Table F-10 System Requirements for Oracle Connector for Outlook 10.1.2.x

Item	Requirement
Operating Systems	Microsoft Windows NT 4.0 Microsoft Windows 2000 Microsoft Windows XP Note: Administrative privileges are required to install Oracle Connector for Outlook on Microsoft Windows NT, Microsoft Windows 2000, and Microsoft Windows XP.
Disk Space	Free disk space approximately equivalent to the size of the user's Internet Message Access Protocol 4 (IMAP4) mailbox.
RAM	Refer to the RAM requirements for Microsoft Outlook client.
Microsoft Outlook	Microsoft Outlook 2000 Microsoft Outlook 2002 with Service Pack 2 (SP2 or later) Microsoft Outlook 2003 Note: A native language version or Multilingual User Interface Pack (MUI) is required for non-English version localization. Refer to Table F-14 for a list of supported languages.
Calendar Servers	Oracle Calendar server 9.0.3.x and above
E-mail Servers	Oracle Mail server 9.0.3.x and above: Simple Mail Transfer Protocol (SMTP) server for outgoing mail included with Oracle Collaboration Suite, Oracle Internet Message Access Protocol 4 (IMAP4) Server Other e-mail servers implemented based on the open standards of SMTP, and IMAP4. reference implementations of Cyrus and University of Washington. Note: Reference IMAP4 implementations of CMU Cyrus and University of Washington.
Conduits for PDA Synchronization	PocketMirror PocketJournal Desktop To Go 2.5 Desktop To Go 2.509 (for Microsoft Outlook 2002 only) ActiveSync 3.0, 3.1, 3.5, 3.7, or 3.8 HotSync Manager (4.0 for Microsoft Windows XP only) Blackberry Desktop Manager up to version 3.6 (SP1 or later are not supported)
Devices	The following devices are certified with Oracle Connector for Outlook. Similar devices may work, but the user experience may vary. Pocket PC Compaq iPAQ Pocket PC 2002 - Models 3870, 3970 HP iPAQ Pocket PC 2003 - Model h 1940 Palm Palm V Handheld PalmOne Zire 72 Palm Tungsten T Blackberry Blackberry 6710 Wireless Handheld Blackberry 6820 Wireless Handheld

F.2.2 Preinstallation Requirements

Before installing Oracle Connector for Outlook 10.1.2.x, verify that the following requirements are met:

• A supported Microsoft Outlook version installed on a supported platform

• Administrative privileges for installing Oracle Connector for Outlook on Microsoft Windows NT, Microsoft Windows 2000, and Microsoft Windows XP

• Outlook 2000 installed in the Corporate or Workgroup (CWG) mode

  To verify the Microsoft Outlook configuration, select Options, Mail Services, and Reconfigure Mail Support from the Tools menu.

  
  

  Caution: If you use offline folders, you need to synchronize your offline folders before upgrading to avoid loss of information.

  
  

F.2.3 Installing Oracle Connector for Outlook 10.1.2.x in Interactive Mode

You can install Oracle Connector for Outlook in interactive or silent mode. You can perform an interactive installation by using the con_outlook_1012x.exe executable file. This section discusses the installation of Oracle Connector for Outlook in interactive mode.

Note: Configuring a messaging application programming interface (MAPI) profile to be used with Oracle Connector for Outlook is not part of the installation process.

See Also: The silent install section in Section F.2.4.3 for information on silent mode installation.

In an interactive installation using the con_outlook_1012x.exe file, the installation wizard guides you through the installation process. When you run con_outlook_1012x.exe, the installation wizard determines the language of the operating system and starts the installation wizard in that language

1. Exit all Microsoft Windows applications.

2. Double-click the con_outlook_1012x.exe file to start the InstallShield Wizard.

3. Click Next on the Welcome screen of the InstallShield Wizard.

4. Enter your name in the User Name field and your company name in the Organization field. Click Next.

5. Click Next to install in the default folder. To install Oracle Connector for Outlook in a different folder, click Change and navigate to that folder.

6. Select the languages you want to install.

   You can also add more languages after the installation.

   
   

   See Also: Section Section F.2.7.3 for information on how to modify the languages.

   
   

7. To review the information you entered in previous screens, click Back. Otherwise, click Install.

8. Click Finish to start the Configuration Wizard. If you intend to configure Oracle Connector for Outlook later, deselect Start Configuration.

Note: If you have upgraded your Microsoft Outlook installation, you must reinstall Oracle Connector for Outlook.

F.2.4 Installing Oracle Connector for Outlook Using the con_outlook_1012x.exe Utility

This section describes how to install and customize Oracle Connector for Outlook using the con_outlook_1012x.exe file as a utility. It contains the following topics:

• Command Syntax

• Description

• Options

• Examples

F.2.4.1 Command Syntax

con_outlook_1012x.exe /lang language_id

con_outlook_1012x.exe /s path_to_INI_file

C:\temp\con_outlook_1012x.exe /s path_to_INI_file

con_outlook_1012x.exe /s UI=value path_to_INI_file

con_outlook_1012x.exe /log path_to_log_file

con_outlook_1012x.exe /admin admin_argument

con_outlook_1012x.exe /admin admin_argument admin_argument

con_outlook_1012x.exe /admin image=cd trans=path_to_INI_file

F.2.4.2 Description

Using the con_outlook_1012x.exe utility, you can install Oracle Connector for Outlook in administrative mode, silent mode, and you can run the installation wizard in a language other than the language of the operating system of the destination computer. You can also upgrade to a new version of Oracle Connector for Outlook in silent mode.

To install Oracle Connector for Outlook in silent mode, use the /s option. Silent installations require no user participation. To install in silent mode, you can use an initialization file that contains all the required installation information. However, if you do not specify an initialization file, Oracle Connector for Outlook is installed with the default settings.

In addition to silent mode installations, the con_outlook_1012x.exe file can be used to perform additional administrative tasks in silent mode, like upgrading, maintaining, or removing Oracle Connector for Outlook. When you run the new installation package in silent mode, it upgrades the installation of Oracle Connector for Outlook to the new version without using an initialization file.

In addition to installing Oracle Connector for Outlook in administrative mode, you can extract the con_outlook.msi installation package to multiple files or a single file from the con_outlook_1012x.exe utility using the /admin option.

See Also: Section F.2.7 on configuring initialization files.

F.2.4.3 Options

Option	Description	Accepted Arguments
/lang	Specify the installation wizard language If you do not have a previous version of Oracle Connector for Outlook installed and you want to run the installation wizard in a language other than the language of the operating system of the destination computer, run con_outlook_1012x.exe with the /lang option. The installation wizard will run in this language the next time you repair, modify, remove, or upgrade Oracle Connector for Outlook.	A supported language For a list of languages supported by Oracle Connector for Outlook, see Table F-14.
/s	Install in silent mode Install Oracle Connector for Outlook in silent mode, using an initialization file that contains all the required installation information. If you do not specify an initialization file, Oracle Connector for Outlook is installed with the default settings. For more on the INI file, see Section F.2.7. You can also upgrade to a new version of Oracle Connector for Outlook in silent mode. When you run the new installation package in silent mode, it upgrades the installation of Oracle Connector for Outlook to the new version without the need for an initialization file. Configure how much visual feedback to provide during a silent installation by using the various optional UI arguments with the /s option. UI=1 There is no user interface, except for a single dialog box at the end of the installation to indicate it completed successfully. UI=2 A basic user interface is provided during the silent installation. UI=3 A basic user interface is provided in addition to a modal dialog box at the end of the installation, indicating successful installation. The modal dialog box is not displayed if the user cancels the installation.	UI=1 UI=2 UI=3 path_to_INI_file
/log	Troubleshoot an installation When you install Oracle Connector for Outlook using the con_outlook_1012x.exe utility, a log file called ocsetup.log is generated in the Temp folder. This log file is a useful source of information for troubleshooting installation failures. It records all events and errors during installation with brief descriptions and messages explaining the possible causes of a failed installation. To generate the log file in a different location, use this option with the variable path_to_log_file set to the full path to the log file.	path_to_log_file
/admin	Extract the MSI installation package Extract the con_outlook.msi package into multiple files or a single file from the con_outlook_1012x.exe utility. From these files, install Oracle Connector for Outlook. The following arguments can be passed with the /admin option: image=msiExtracts the con_outlook.msi installation package to a single file. image=cdExtracts the con_outlook.msi installation package to multiple files. Multiple files comprise an msi file: the Oracle Connector for Outlook files and the .mst files that contain the transformation for the installation language. trans=path_to_INI_fileCan be used with image=cd and image=msi. Used with the image=cd argument, creates a transform called silent.mst along with the other language transforms. Used with the image=msi argument, an embedded transform called silent is created. The created transforms change the SILENTINIPATH public property of the original MSI package. This public property must include the path to the initialization file. The path can also point to a network location. Note: The variable path_to_INI_file in the trans=path_to_INI_file argument represents the full path to the initialization file and should be accessible by all the computers to which Oracle Connector for Outlook is being deployed. For more on the INI file, see Section F.2.7.	image=msi image=cd trans=path_to_INI_file

Notes: Although the options in the preceding table are shown as lower-case letters, these command-line options are not case-sensitive. You can enter a slash mark (/) or a minus sign (-) before an option at the command line.

F.2.4.4 Examples

The following examples represent command lines you can enter when installing Oracle Connector for Outlook with the con_outlook_1012x.exe utility:

• Specifying the installation wizard language

  If you do not have a previous version of Oracle Connector for Outlook installed and you want to run the installation wizard in French, enter the following command:

  con_outlook_1012x.exe /Lang 1036
  
  

• Installing in silent mode

  Install Oracle Connector for Outlook in silent mode using the con_outlook_1012x.exe file if the executable and initialization files are located in the C:\Temp folder:

  C:\temp\con_outlook_1012x.exe /s C:\temp\con_outlook_silent.ini
  
  

• Customizing a silent installation with some visual feedback

  Maintain visual feedback during a silent installation using the con_outlook_1012x.exe file if the executable and initialization files are located in the C:\Temp folder:

  C:\temp\con_outlook_1012x.exe /s UI=2 C:\temp\con_outlook_silent.ini
  
  

• Extracting the installation package to a single file

  Extract con_outlook.msi to a single file:

  con_outlook_1012x.exe /admin image=msi
  
  

• Extracting the installation package to multiple files

  Extract con_outlook.msi to multiple files:

  con_outlook_1012x.exe /admin image=cd
  
  

• Creating a transform

  Create a transform called silent.mst along with the other language transforms:

  con_outlook_1012x.exe /admin image=cd trans=path_to_INI_file
  
  

• Creating an embedded transform

  Create an embedded transform called silent:

  con_outlook_1012x.exe /admin image=msi trans=path_to_INI_file
  
  

• Generating the log file in a different location

  con_outlook_1012x.exe /log path_to_log_file
  
  

  In this example, path_to_log_file represents the complete path to the log file.

F.2.5 Installing Oracle Connector for Outlook Using the msiexec.exe Utility

This section describes how to install Oracle Connector for Outlook using the con_outlook.msi package. It contains the following topics:

• Command Syntax

• Description

• Options

• Examples

• Installing Oracle Connector for Outlook with Elevated Privileges

F.2.5.1 Command Syntax

msiexec.exe /i "con_outlook.msi"

msiexec.exe /i "con_outlook.msi" TRANSFORMS=1036.mst

msiexec.exe /i "con_outlook.msi" TRANSFORMS=:setup_language

msiexec.exe /i "con_outlook.msi" /qn SILENTINIPATH=path_to_INI_file

msiexec.exe /x {product_code} /qn

msiexec.exe /jm "con_outlook.msi" ALLUSERS=1

msiexec.exe /i "con_outlook.msi" /l path_to_log_file

F.2.5.2 Description

Using the msiexec.exe utility, you can install Oracle Connector for Outlook in silent mode, specify the installation language for a first-time installation, advertise an installation of the Oracle Connector for Outlook package on each user's computer, upgrade to a new version of Oracle Connector for Outlook in silent mode, generate a log file to troubleshoot an installation, and uninstall in silent mode.

Run the msiexec.exe utility with the MSI installation package (con_outlook.msi) which you can extract from the con_outlook_1012x.exe utility by using the /admin option.

See Also: Section F.2.4.3 for more information on extracting he con_outlook.msi package into multiple files or a single file from the con_outlook_1012x.exe utility.

To install Oracle Connector for Outlook in silent mode, use the /qn option. Silent installations require no user participation. To install in silent mode, you can use an initialization file that contains all the required installation information. However, if you do not specify an initialization file, Oracle Connector for Outlook is installed with the default settings.

F.2.5.3 Options

Option	Description	Accepted Arguments
/i	Install or upgrade Install or upgrade Oracle Connector for Outlook from the MSI installation package using the msiexec.exe utility. You can use the /i option in conjunction with the /qn option. Notes: The variable setup_language is the ID number of the language that you want to use for the installation. Use TRANSFORMS=: when installing directly from the MSI installation package contained in a single file. Use TRANSFORMS= when installing from the MSI installation package extracted to multiple files. When upgrading from a previous version of 10.1.2, add the following argument: msiexec /i "con_outlook.msi" REINSTALL=ALL REINSTALLMODE=vomus When upgrading from a version below 10.12, add the following argument: msiexec /i "con_outlook.msi"	TRANSFORMS=:setup_language TRANSFORMS=setup_language
/jm	Advertise an installation Advertise an installation of the Oracle Connector for Outlook package on users' computers. You are required to pass the ALLUSERS=1 argument with the /jm option. See the section on performing an advertised installation in Section F.2.5.5.	ALLUSERS=1
/l	Generate a log file When you install Oracle Connector for Outlook using con_outlook.msi, you can generate a log file with the /L option if you are using the msiexec utility. Use the /l option in conjunction with the /i option.	path_to_log_file
/qn	Install in silent mode Install Oracle Connector for Outlook in silent mode using the MSI installation package. You can use an initialization file that contains all the required installation information. If you do not specify an initialization file, Oracle Connector for Outlook is installed with the default settings. Use the /qn option in conjunction with the /i option. When you install Oracle Connector for Outlook in silent mode, you must must specify the path to the initialization file.Enter the full path to the initialization file after SILENTINIPATH. For more on the INI file, see Section F.2.7.	SILENTINIPATH=path_to_INI_file
/x	Uninstall Uninstall Oracle Connector for Outlook using the msiexec utility. Use the /x option in conjunction with the /qn option to uninstall in silent mode.	Product code of Oracle Connector for Outlook

Notes: Although the options in the preceding table are shown as lower-case letters, these command-line options are not case-sensitive. You can enter a slash mark (/) or a minus sign (-) before an option at the command line. These arguments must be entered entirely in capital letters: SILENTINIPATH= ALLUSERS=1 TRANSFORMS=:setup_language TRANSFORMS=setup_language

F.2.5.4 Examples

The following examples represent some commands you can enter when installing Oracle Connector for Outlook with the msiexec.exe utility:

• Specifying the installation language from the single file extracted

  Specify French as the installation language for a first-time installation directly from the MSI installation package contained in a single file:

  msiexec.exe /i "con_outlook.msi" TRANSFORMS=:1036
  
  

• Specifying the installation language after extracting to multiple files

  Specify French as the installation language for a first-time installation if the MSI installation package is extracted to multiple files:

  msiexec.exe /i "con_outlook.msi" TRANSFORMS=1036.mst
  
  

• Performing an advertised installation

  Advertise an installation of the Oracle Connector for Outlook package on each user's computer:

  msiexec.exe /jm "con_outlook.msi" ALLUSERS=1
  
  

  The Oracle Connector Configuration Wizard option will be available from the Oracle Connector For Outlook program submenu. Users can then run the installation with elevated privileges by selecting this shortcut.

• Installing in silent mode

  Install Oracle Connector for Outlook in silent mode using the MSI installation package:

  msiexec.exe /i "con_outlook.msi" /qn C:\temp\con_outlook_silent.ini
  
  

  In this example, con_outlook_silent.ini is the initialization file and is located in the C:\Temp folder. For more on the initialization file, see Section F.2.7.

• Upgrading

  Upgrade Oracle Connector for Outlook using the MSI installation package

  msiexec.exe /i "con_outlook.msi"
  
  

• Uninstalling

  Uninstall Oracle Connector for Outlook in silent mode:

  msiexec.exe /x {0AF6C5A4-E29B-4D1E-B6FF-D73F4FBB44DA} /qn
  
  

  In this example, the necessary command-line options and values are passed to the Microsoft installer to uninstall Oracle Connector for Outlook in silent mode. This command is the silent-mode equivalent of uninstalling the application through Add or Remove Programs in the Control Panel. In this example, the /x option instructs the Microsoft installer to uninstall Oracle Connector for Outlook, whose product code is specified in the braces {} and /qn specifies a completely silent mode.

• Troubleshooting

  Troubleshoot an installation performed with the MSI installation package by generating a log file:

  msiexec.exe /i "con_outlook.msi" /l C:\OcLog.log
  

Note: When you install using a language other than English, the log file is generated partially in English and partially in the installation language you selected.

F.2.5.5 Installing Oracle Connector for Outlook with Elevated Privileges

As an administrator, you can use one of the following methods to enable non-administrative users to install Oracle Connector for Outlook:

• Setting the AlwaysInstallElevated Registry Policy

• Performing an Advertised Installation of Oracle Connector for Outlook

• Deploying the Oracle Connector for Outlook Package Using Group Policy With Active Directory

• Applying a Transform to Oracle Connector for Outlook

When using one of these methods, you must use the MSI installation package included with con_outlook_1012x.exe.

Setting the AlwaysInstallElevated Registry Policy

By setting the AlwaysInstalledElevated policy on a user's computer, you give a user appropriate installation privileges to install Oracle Connector for Outlook. However, setting this policy can expose a user's computer to security risks because this method enables users to access secure locations on the computer.

See Also: Refer to the following URL about the AlwaysInstalledElevated registry entry: http://windowssdk.msdn.microsoft.com/en-us/library/ms700292.aspx

To configure elevated installation privileges, set the AlwaysInstallElevated policy under the following key in the registry:

HKEY_LOCAL_MACHINE\Software\Policies\Microsoft\Windows\Installer

Note: This applies to a per-computer installation.

If Oracle Connector for Outlook is installed with elevated installation privileges as part of an installation performed on each computer, the AlwaysInstallElevated policy can be removed without affecting future repairs to the installation. Users will still be able to repair the Oracle Connector for Outlook installation with elevated privileges.

Performing an Advertised Installation of Oracle Connector for Outlook

When advertising an installation of Oracle Connector for Outlook on a user's computer, Oracle Connector for Outlook shortcuts are installed, the shortcut icons appear in the Start menu, and the file types become registered, but the files are not actually installed until users access one of these items to start the application. You can advertise Oracle Connector for Outlook on a user's computer, but only if one of the following operating systems is running on it:

• Microsoft Windows 2000

• Microsoft Windows XP

• Microsoft Windows 2003

To advertise an installation of the Oracle Connector for Outlook package on each user's computer, enter the following command:

msiexec.exe /jm "con_outlook.msi" ALLUSERS=1

Deploying the Oracle Connector for Outlook Package Using Group Policy With Active Directory

You can use Microsoft Windows Server 2003 or Microsoft Windows 2000 Server tools to install and maintain software applications by using Group Policy and Active Directory.

Assigning Oracle Connector for Outlook is the easiest way to use Group Policy to manage an installation package. With this method, Oracle Connector for Outlook is automatically installed on a user's computer the first time a designated computer is started and Group Policy is applied. Oracle Connector for Outlook is then available to all users of this computer.

You can deploy Oracle Connector for Outlook on a local computer by assigning the con_outlook.msi package to users' computers through Active Directory and Group Policy.

To deploy Oracle Connector for Outlook using Group Policy:

Notes: Perform the following steps after you have extracted the Oracle Connector for Outlook files to a shared network location that can be accessed by all the computers to which Oracle Connector for Outlook is being deployed. Oracle recommends performing all the steps. This will ensure that Oracle Connector for Outlook is installed on the computer the next time the computer starts, and that it is available to all users of the computer.

1. From the Start menu, select Programs, Administrative Tools, then Active Directory Users and Computers.

2. Create an organization unit that includes all the computers on which you want to deploy Oracle Connector for Outlook. (You can make use of an existing organization unit.)

3. Right-click the organization unit node in the navigation tree.

4. From the shortcut menu, select Properties.

5. Select the Group Policy tab.

6. To add a new group policy, click Add. To edit an existing group policy, click Edit.

7. In the Group Policy Object Editor, expand Computer Configuration. Here you can set policies to be applied to computers, regardless of who logs onto them.

8. Expand the Software Settings folder located under Computer Configuration.

9. Right-click Software installation, select New, and then Package.

10. Browse to the location where you extracted con_outlook.msi and select this file.

11. Select the Advanced option to customize your installation with transforms. Otherwise, select Assigned. Click OK.

12. Proceed to the step 13 if you selected the Assigned option. Select the Modifications tab and add one installation language transform. If you create a transform called silent.mst, you need to add it to the list.

    
    

    See Also: Applying a Transform to Oracle Connector for Outlook for more information on applying a transform.

    
    

13. Click OK in the Properties dialog box.

14. Exit the Active Directory Users and Computers console.

The preceding steps complete the package setup for Oracle Connector for Outlook. You need to verify that the package is available for installation. To do so, restart any computer in the domain. Oracle Connector for Outlook installation will start as soon as the computer restarts.

Using this installation setup, users with no administrative privileges can also modify the supported Oracle Connector for Outlook languages by selecting Add or Remove Languages from the Program menu. In addition, users can repair their installation of Oracle Connector for Outlook.

Note: Only an administrator can permanently remove the application.

See Also: Table F-14 for a list of languages supported in Oracle Connector for Outlook.

Applying a Transform to Oracle Connector for Outlook

When you use a Group Policy to assign the con_outlook.msi package, you can still control the installation of Oracle Connector for Outlook with a silent initialization file. This is done by applying a transform (MST file) to the original Oracle Connector for Outlook package (MSI file).

A transform should only change the SILENTINIPATH public property of the original con_outlook.msi package. This public property must include the path to the initialization file. The path can also point to a network location.

See Also: Section F.2.7 on configuring initialization files.

Notes: If you want to deploy Oracle Connector for Outlook with the default values, you do not need to create an initialization file. The path to the INI file (path_to_INI_file) in the trans=path_to_INI_file argument should be accessible by all computers to which Oracle Connector for Outlook is being deployed. If you are configuring the OcConfigWizard section of the initialization file, the path to the PRF file should be accessible by all computers to which Oracle Connector for Outlook is being deployed.

The structure of the initialization file is the same as the one used for the silent installation.

See Also: Refer to the following URL for a step-by-step guide to software installation and maintenance: http://www.microsoft.com/windows2000/techinfo/planning/management/swinstall.asp

F.2.6 Configuring Oracle Connector for Outlook Using the ocprofwiz.exe Utility

This section describes how to configure Oracle Connector for Outlook using the ocprofwiz.exe utility. It contains the following topics:

• Command Syntax

• Description

• Options

• Examples

• Methods for Launching the Configuration Wizard

F.2.6.1 Command Syntax

ocprofwiz.exe /s path_to_PRF_file

ocprofwiz.exe /L language_id

ocprofwiz /d

ocprofwiz /p

ocprofwiz /p /l language_id

F.2.6.2 Description

The ocprofwiz.exe utility, or configuration wizard, is a standalone application that is useful for both administrators and end users because it integrates the creation and configuration of PRF files and profiles. The configuration wizard reads information from an existing PRF file and creates a new profile, or modifies an existing profile, with the appropriate settings. This utility can be started from the command prompt or from Windows Explorer. You can find ocprofwiz.exe in the following directory:

C:\Program Files\Oracle\Outlook Connector\

The following list describes various uses of the ocprofwiz.exe utility:

• You can start the configuration wizard in interactive mode.

• You can start the configuration wizard in silent mode. You can use an existing PRF file with all the required settings information to create and configure the first profile for the user.

• As an administrator, you can use the configuration wizard to generate the PRF files to save the updated settings.

• As an administrator, you can use the configuration wizard to back up the Oracle Connector for Outlook settings for an existing profile and restore these settings later.

• As an administrator, you can modify profile settings in the PRF file generated by the Oracle Connector for Outlook configuration wizard.

Note: While configuring a profile, it only configures the Oracle Connector for Outlook settings. You can run only one instance of the configuration wizard at a time. If you try to launch the configuration wizard a second time, the instance previously started will be displayed in the foreground.

F.2.6.3 Options

Use the command-line options described in this section to customize the configuration wizard:

Option	Description	Accepted Arguments
/d	Set as Default Profile option in the configuration wizard Specifies that Set as Default Profile should be selected by default on the final screen of the configuration wizard.	Not applicable
/l	Specify the configuration wizard language Use to specify the language for running the configuration wizard. This language must already be installed (from the installation of Oracle Connector for Outlook). Can be used in conjunction with the /p option. For a list of languages supported by Oracle Connector for Outlook, see Table F-14.	A supported language
/p	Create a profile in interactive mode Runs the configuration wizard in the interactive profile creation mode, creating a PRF file. Can be used in conjunction with the /l option.	Not applicable
/s	Create a profile in silent mode Runs the Oracle Connector Configuration Wizard in silent profile creation mode. Enter the full path to the PRF file after path_to_PRF_file.	path_to_PRF_file

Notes: Although the options in the preceding table are shown as lower-case letters, these command-line options are not case-sensitive. You can enter a slash mark (/) or a minus sign (-) before an option at the command line.

F.2.6.4 Examples

The following examples represent some commands you can enter to customize the configuration wizard:

• Specifying the Language of the Configuration Wizard

  Run the configuration wizard in German:

  ocprofwiz.exe /l 1031
  

  
  

  Note: The language you specify must have been installed during the installation of Oracle Connector for Outlook.

  
  

• Interactive Profile Creation Using the Configuration Wizard

  Run the ocprofwiz.exe utility in the interactive profile creation mode to create the PRF file:

  ocfoprofwiz.exe /p
  
  

  Run the configuration wizard in German, in the interactive profile creation mode:

  ocprofwiz.exe /p /l 1031
  
  

• Silent Profile Creation

  Run the configuration wizard in silent profile creation mode:

  ocprofwiz.exe /s "C:\Program Files\Oracle\Outlook Connector\source.prf"
  
  

• Setting the Set as Default Profile Option

  Ensure that Set as Default Profile is selected in the Congratulations screen of the configuration wizard:

  ocprofwiz.exe /d
  

F.2.6.5 Methods for Launching the Configuration Wizard

The configuration wizard can be launched in three different modes:

• Interactive Profile Creation and Configuration Mode

• Interactive PRF File Creation Mode

• Silent Profile Creation Mode

Interactive Profile Creation and Configuration Mode

The interactive profile creation and configuration mode is the default mode. Use this mode to specify settings and create or modify a profile. You can configure an existing profile or create a new profile by using the Profile Settings screen of the configuration wizard. However, you can configure only one profile in one session. You can also remove an existing profile on the Profile Settings screen.

To run the configuration wizard:

1. Close Microsoft Outlook before starting the configuration wizard.

2. Launch the wizard by double-clicking the Oracle Connector Configuration Wizard icon on your desktop. Alternatively, select Oracle Connector For Outlook, then Oracle Connector Configuration Wizard from the Start menu on your desktop.

3. From the Welcome screen, click Next.

4. If you want to create a new profile, select New and enter a name for the new profile. If you want to configure an existing profile, select it from the Profiles list. Click Next.

5. You can view or modify settings for the selected user profile on the Service Settings screen. All non-password fields must be filled to enable Next. To configure advanced settings, such as resetting your local mailbox cache, setting a folder refresh rate for incoming mail, or selecting a refresh option for the Global Address Book, click More Settings.

   
   

   Note: If Microsoft Outlook is open and you are using the same profile while you are configuring profile settings, the fields on the Service Settings screen are disabled.

   
   

6. When the Congratulations screen is displayed, verify that Set as Default Profile is selected. The Outlook Address Book service is added to a new profile by default.

Interactive PRF File Creation Mode

As an administrator, you can run the ocprofwiz.exe utility in the interactive PRF file creation mode. You can create a PRF file by starting with a blank template or by importing information from an existing profile or PRF file.

By default, the PRF file created is a blank template. For security reasons, password fields are not saved in the resulting PRF file if information is imported from an existing profile. The final PRF file contains user profile information, and settings information, which can be used by the configuration wizard or by the NewProf.exe file.

Depending on the source template used, the Outlook Address Book information is added to the [Service List] section in the output PRF file. In the profile template, where information is imported from an existing profile, it depends on whether or not the profile has the Outlook Address Book service. In the PRF template, where information is imported from an existing PRF file, it again depends on whether or not the PRF contains an Outlook Address Book information in the Service List section.

To run ocprofwiz.exe in the interactive PRF file creation mode:

1. Close Microsoft Outlook before starting the configuration wizard.

2. Enter /p at the command line. For example:

   ocprofwiz.exe /p
   
   

3. Under Source Template in the PRF Configuration Settings screen, select one of the following options for the PRF file:

   • Empty PRF File: If you select this option as the source template, you must manually specify the settings.

   • Existing PRF File: If you select this option as the source template, initial settings information is imported from the source PRF file.

   • MAPI Profile: If you select this option as the source template, initial settings information is imported from the source profile.

4. Enter the name and location of the new PRF file under Destination File.

5. In the Profile Options screen, configure the settings for the General section of the new PRF file. Table F-11 shows the relationship between the fields in the Profile Options screen and the parameters in the General section of the PRF file:

6. You can view or modify Oracle Connector for Outlook settings for the selected user profile in the Service Settings screen. All non-password fields must be filled to enable Next.

   To configure advanced settings, such as resetting your local mailbox cache, setting a folder refresh rate for incoming mail, or selecting a refresh option for the Global Address Book, click More Settings. The Oracle Connector for Outlook settings information will be saved to the new PRF file.

7. If View PRF File is selected when the Congratulations screen is displayed, the wizard displays the newly created PRF file. You can then verify the information or modify parameters in the PRF file.

Table F-11 Relationship Between Fields in the Profile Options Screen and Settings in the General Section of the PRF File

Field in Profile Options Screen	Parameter in the General Section of the PRF File
Profile Name	ProfileName
Default Store	DefaultStore
Use this profile as the default MAPI profile.	DefaultProfile=Yes/No
Overwrite existing profile with the same name.	OverwriteProfile=Yes/No

Silent Profile Creation Mode

An existing PRF file is used as the template for creating a corresponding profile. When installing Oracle Connector for Outlook in silent mode, you can start the configuration wizard after the installation is complete. The configuration wizard reads information from an existing PRF file and creates a new profile, or modifies an existing profile, with the appropriate settings.

Note: Oracle recommends that you use a PRF file generated by the Oracle Connector for Outlook configuration wizard. Most of the parameters in the PRF file can be configured through the configuration wizard in the interactive PRF file creation mode. If you modify a value manually, then you must verify that the new value falls within the valid range of values. To verify that you are within the valid range of values, consult the PRF file distributed with the installation package.

See Also: Section F.2.7 on configuring initialization files.

The Outlook Address Book service is imported into the profile if it is listed in the [Service List] section. Limited support is also available for some other types of message services.

When Oracle Connector for Outlook is configured in silent mode, a log file is created to record success and error information. This log file is stored in a temporary folder on the computer. For example:

C:\Documents and Settings\user\Local Settings\Temp\ocfoConfigWizardLog\ocfoConfigWizard.log

In the preceding command, user represents the login name of the local user.

Notes: If you are configuring Oracle Connector for Outlook in silent mode, then you must check the log file to verify the results. The log file contains a record of errors, as well as successful imports of information into the profile. The configuration wizard may write some information to the log file in interactive profile creation and configuration mode and interactive PRF file creation mode. Usually, high-level warning messages are displayed and low-level technical information is recorded in the log file.

F.2.7 Configuring the Initialization File Used in the Silent Installation of Oracle Connector for Outlook

You can configure the following sections in the initialization file. The initialization file can be called ctoc.ini but you can name it something else. You can also choose the location of the initialization file.

• The [General] Section

• The [Settings] Section

• The [Languages] Section

• The [OcConfigWizard] Section

F.2.7.1 The [General] Section

In the [General] section of the initialization file, you can specify the name of the user Oracle Connector for Outlook is registered to, the company name, and the location where you want to install Oracle Connector for Outlook.

Table F-12 Parameter Values for Configuring the [General] Section in the INI File

Parameter	Description	Accepted Values	Default Value
UserName	Specify the name of the user Oracle Connector for Outlook is registered to.	A string specifying a user name.	No default
Company	Specify the name of the company who has purchased the software license.	A string specifying a company name.	No default
InstallPath	Specify the path to install Oracle Connector for Outlook (other than the default installation path). If empty, the default installation path is used: [current drive]\Program Files\Oracle\Outlook Connector	A string specifying the installation path.	No default

The following excerpt of the initialization file shows the parameters with examples in the [General] section:

[General]
UserName=OCFOUSER
Company=ORACLE
InstallPath=C:\Program Files\Oracle\Outlook Connector

F.2.7.2 The [Settings] Section

In the [Settings] section of the initialization file, you can force your computer to reboot after installation, disable Control Panel options, disable mail server functions, and more. Refer to the following table for the parameters you can configure in this section of the initialization file:

Table F-13 Parameters for Configuring the [Settings] Section in the INI File

Parameter	Description	Accepted Values	Default Value
ForceReboot	Set to 1 to force the computer to restart after the installation.	0 1	0
DisablePwd	Set to 1 to prevent the user from saving a password.	0 1	0
HideCalendarPwdMenu	Set to 1 to hide the Change password menu item from the user.	0 1	0
NoServerMail	If defined, by default the mail servers have no accounts. When you create a new profile, the pages for these are not accessible. Set to one of the following values to disable specific mail server functions: 0, no restrictions 1, no IMAP or SMTP 2, no IMAP 3, no SMTP	0 1 2 3	0
NoDesktopShortcut	Set to 1 to remove the Oracle Connector Configuration Wizard shortcut from the desktop.	0 1	0
DisableCfgUI	Set to 1 to disable Control Panel options.	0 1	0

The following excerpt of the initialization file shows the parameters with examples in the [Settings] section:

• [Settings]
  ForceReboot=0
  DisablePwd=1
  HideCalendarPwdMenu=1
  NoServerMail=3
  DisableCfgUI=1
  NoDesktopShortcut=1
  

F.2.7.3 The [Languages] Section

In the [Languages] section, you can specify additional languages that Oracle Connector for Outlook will support during installation.

Refer to Table F-14 for a list of supported languages.

You can add or delete languages in silent mode, by modifying the [Languages] section. This is valid as long as you consistently use the same installation package.

The following excerpt of the initialization file shows the parameters that would be used in the [Languages] section if English, French, and German are specified as additional languages:

[Languages]
;English US
1033=us
;French
1036=f
;German
1031=d

Table F-14 Languages Supported by Oracle Connector for Outlook

Language Name	ID Number
English US	1033
Chinese (Simplified)	2052
Chinese (Traditional)	1028
Czech	1029
Danish	1030
Dutch (Netherlands)	1043
Finnish	1035
French	1036
German	1031
Greek	1032
Hungarian	1038
Italian	1040
Japanese	1041
Korean	1042
Norwegian	1044
Polish	1045
Portuguese (Brazil)	1046
Portuguese (Portugal)	2070
Romanian	1048
Russian	1049
Spanish	1034
Swedish	1053
Turkish	1055

F.2.7.4 The [OcConfigWizard] Section

In the [OcConfigWizard] section, you can specify the location of the PRF file, the file that contains the user profile information. Oracle Connector for Outlook uses the PRF file to configure user profiles.

Table F-15 Parameter for Configuring the [OcConfigWizard] Section in the INI File

Parameter	Description	Accepted Values	Default Value
Path	Specify the absolute path of the PRF file.	A string specifying the location.	No default
AutoRepair	Should only be used in Active Directory deployment to automatically create the specified profile for the user. A value of 1 creates the profile for only the first user who logs into the system after the installation takes place. A value of 2 creates the profile for all users logging into the system.	1 2	No default

The following excerpt of the initialization file shows the parameters and values in the [OcConfigWizard] section:

[OcConfigWizard]
Path=c:\MyPrfName.prf
AutoRepair=2

Sample Initialization File Used in the Silent Installation of Oracle Connector for Outlook

The following excerpt displays a sample initialization file used for silently installing Oracle Connector for Outlook.

Note: With the exception of the [Languages] section, the parameters in the initialization file can only be configured for first-time installations. If you already installed Oracle Connector for Outlook, you can only modify the settings after uninstalling the application.

[General]
UserName=OCFOUSER
Company=ORACLE
InstallPath=C:\Program Files\Oracle\Outlook Connector

[Settings]
ForceReboot=0
DisablePwd=1
HideCalendarPwdMenu=1
NoServerMail=3
DisableCfgUI=1
NoDesktopShortcut=1

[Languages]
;English US
1033=us
;Chinese (PRC) (S)
2052=zhs,_936
;Chinese (Singapore) (S)
4100=zhs,_936
;Chinese (Hong Kong) (T)
3076=zht,_950
;Chinese (Macau) (T)
5124=zht,_950
;Chinese (Taiwan) (T)
1028=zht,_950
;Czech
1029=cs
;Danish
1030=dk
;Dutch (Netherlands)
1043=nl
;Finnish
1035=sf
;French
1036=f
;German
1031=d
;Greek
1032=el
;Hungarian
1038=hu
;Italian
1041=i
;Japanese
1041=ja
;Korean
1042=ko
;Norwegian (Bokmal)
1044=n
;Polish
1045=pl
;Portuguese (brazilian)
1046=ptb
;Portuguese
2070=pt
;Romanian
1048=ro
;Russian
1049=ru
;Spanish
1034=e
;Swedish
1053=s
;Turkish
1055=tr

[OcConfigWizard]
Path=c:\PRFNAME.prf
AutoRepair=2

F.2.8 Upgrading Oracle Connector for Outlook

You can use the con_outlook_1012x.exe utility or the msiexec.exe utility to upgrade the existing version of Oracle Connector for Outlook. When you run con_outlook_1012x.exe or con_outlook.msi, the installation language used for the upgrade is determined based on the current version of Oracle Connector for Outlook.

To upgrade in interactive mode, run con_outlook_1012x.exe and follow the instructions on the screen. To upgrade using the msiexec.exe utility, refer to Section F.2.4.3 for the options you need to enter to upgrade Oracle Connector for Outlook using the MSI installation package.

F.2.9 Modifying, Repairing, or Removing Oracle Connector for Outlook

You can modify, repair, or remove an Oracle Connector for Outlook installation using the InstallShield wizard. This section discusses the following topics:

• Modifying the Selection of Installed Languages in Oracle Connector for Outlook

• Repairing Oracle Connector for Outlook

• Removing Oracle Connector for Outlook

F.2.9.1 Modifying the Selection of Installed Languages in Oracle Connector for Outlook

To modify the language settings of Oracle Connector for Outlook, perform one of the following tasks:

• Run con_outlook_1012x.exe or con_outlook.msi. Select Modify in the Program Maintenance screen.

• Double-click Add or Remove Programs in the Control Panel. Click Change. Select Modify from the screen.

• From the Start menu, select Oracle Connector for Outlook, and then Add or Remove Languages.

F.2.9.2 Repairing Oracle Connector for Outlook

To repair an Oracle Connector for Outlook installation, perform one of the following tasks:

• Run con_outlook_1012x.exe or con_outlook.msi. Select Repair from the Program Maintenance screen.

• Double-click Add or Remove Programs in the Control Panel. Click Change. Select Repair from the Program Maintenance screen.

Note: When you repair the Oracle Connector for Outlook installation, registry keys that were deleted or corrupted are automatically reinstalled.

F.2.9.3 Removing Oracle Connector for Outlook

To remove Oracle Connector for Outlook, perform one of the following tasks:

• Run con_outlook_1012x.exe or con_outlook.msi. In the Program Maintenance screen, click Remove.

• Double-click Add or Remove Programs in the Control Panel. Click Remove next to Oracle Connector for Outlook.

F.2.10 Troubleshooting an Oracle Connector for Outlook Installation

The method you use for troubleshooting an Oracle Connector for Outlook installation depends on which installation package was used to install the application, con_outlook_1012x.exe or con_outlook.msi.

See Also: Section F.2.4.3 for more information on troubleshooting when you installed Oracle Connector for Outlook using con_outlook_1012x.exe. Section F.2.5.3 for more information on troubleshooting when you installed Oracle Connector for Outlook using con_outlook.msi.

F.2.10.1 Troubleshooting an Installation Performed With the Executable File

When you install Oracle Connector for Outlook using con_outlook_1012x.exe, a log file called ocsetup.log is generated in the Temp folder.

This log file is a useful source of information for troubleshooting installation failures. It records all events and errors during installation with brief descriptions and messages explaining the possible causes of a failed installation.

F.3 Installing Oracle Connector for Outlook 10.1.3

This section contains the following topics:

Note: If you are using Oracle Connector for Outlook 10.1.2.x, please see Section F.2.

• Section F.3.1, "System Requirements"

• Section F.3.2, "Preinstallation Requirements"

• Section F.3.3, "Installing Oracle Connector for Outlook in Interactive Mode"

• Section F.3.4, "Installing Oracle Connector for Outlook Using the con_outlook_1013.exe Utility"

• Section F.3.5, "Installing Oracle Connector for Outlook Using the msiexec.exe Utility"

• Section F.3.6, "Configuring Oracle Connector for Outlook Using the ocfoprofwiz.exe Utility"

• Section F.3.7, "Configuring the Initialization File Used in the Silent Installation of Oracle Connector for Outlook"

• Section F.3.8, "Upgrading Oracle Connector for Outlook"

• Section F.3.9, "Modifying, Repairing, or Removing Oracle Connector for Outlook"

• Section F.3.10, "Troubleshooting an Oracle Connector for Outlook Installation"

• Section F.3.11, "Deploying Oracle Connector for Outlook Using the Automatic Update Feature"

• Section F.3.12, "Using the Automatic Update Feature to Configure Client Registry Settings"

• Section F.3.13, "Oracle Connector for Outlook Using the Remote Installer"

F.3.1 System Requirements

Table F-16 lists the system requirements for installing Oracle Connector for Outlook 10.1.3.

Table F-16 System Requirements for Oracle Connector for Outlook 10.1.3

Item	Requirement
Operating Systems	Microsoft Windows 2000 Microsoft Windows 2003 Server Microsoft Windows XP Home or Professional Notes Administrative privileges are required to install Oracle Connector for Outlook on Microsoft Windows 2000 and Microsoft Windows XP. Windows XP Service Pack 1 is required, but Oracle recommends Windows XP Service Pack 2.
Disk Space	200 MB minimum Hard disk usage varies according to configuration. Custom installation options may require more or less hard disk space. The amount of online data the user accesses may also affect the disk space requirement.
RAM	Refer to the RAM requirements for Microsoft Outlook client.
Microsoft Outlook	Microsoft Outlook 2000 (with Service Pack 3) Microsoft Outlook 2002 (with Service Pack 3) Microsoft Outlook 2003 (with Service Pack 2) Notes Oracle recommends the service pack versions mentioned above. However, other service packs may also work with Oracle Connector for Outlook. A native language version or Multilingual User Interface Pack (MUI) is required for non-English version localization. Refer to Table F-20 for a list of supported languages.
Calendar Servers	Oracle Calendar server 9.0.4.x and above
E-mail Servers	Oracle Mail server 9.0.4.x and above: Simple Mail Transfer Protocol (SMTP), Internet Message Access Protocol 4 (IMAP4), and POP3) Other e-mail servers whose implementations are based upon the open standards of SMTP, POP3, and IMAP4 Note: Reference IMAP4 implementations of CMU Cyrus and University of Washington.
Conduits for PDA Synchronization	PocketMirror PocketJournal Desktop To Go 2.5 Desktop To Go 2.509 (for Microsoft Outlook 2002 only) ActiveSync 3.x, 4.0, 4.1, or 4.2 HotSync Manager (4.0 for Microsoft Windows XP only) Blackberry Desktop Manager 4.0 and 4.1 (requires an Intellisync patch provided by Oracle)
Devices	The following devices are certified with Oracle Connector for Outlook. Similar devices may work, but the user experience may vary. Pocket PC Compaq iPAQ Pocket PC 2002 - Models 3870, 3970 HP iPAQ Pocket PC 2003 - Model h 1940 Palm Palm V Handheld PalmOne Zire 72 Palm Tungsten T Blackberry Blackberry 6710 Wireless Handheld Blackberry 6820 Wireless Handheld

F.3.2 Preinstallation Requirements

Before installing Oracle Connector for Outlook, verify that the following requirements are met:

• A supported Microsoft Outlook version installed on a supported platform

• Administrative privileges for installing Oracle Connector for Outlook on Microsoft Windows 2000 and Microsoft Windows XP

• Outlook 2000 installed in the Corporate or Workgroup (CWG) mode

  To verify the Microsoft Outlook configuration, select Options, Mail Services, and Reconfigure Mail Support from the Tools menu.

  
  

  Caution: If you use offline folders, synchronize your offline folders before upgrading to avoid loss of information. If you are upgrading to Oracle Connector for Outlook 10.1.3 from a previous version, you need to reset the profile's local storage and restore the default Send/Receive and View settings. Oracle recommends backing up any client-side e-mail rules and fully synchronizing PDA data (if a PDA device is used) before upgrading.

  
  

F.3.3 Installing Oracle Connector for Outlook in Interactive Mode

You can install Oracle Connector for Outlook in interactive or silent mode. You can perform an interactive installation by using the con_outlook_1013.exe executable file. This section discusses the installation of Oracle Connector for Outlook in interactive mode.

Note: Configuring a messaging application programming interface (MAPI) profile to be used with Oracle Connector for Outlook is not part of the installation process.

See Also: Section F.3.4.3 for information on silent mode installation.

In an interactive installation using the executable file con_outlook_1013.exe, the installation wizard guides you through the installation process. When you run con_outlook_1013.exe, the installation wizard determines the language of the operating system and starts the installation wizard in that language.

If the language used by the operating system is not supported by Oracle Connector for Outlook, the installation wizard is started in English. In addition, the Add/Remove Languages dialog box lists the languages supported by Oracle Connector for Outlook. You can select the languages you want in addition to English. However, you cannot remove English language support because it serves as a reliable backup in case of failure in other languages.

Perform the following steps to install Oracle Connector for Outlook on the desktop:

1. Exit all Microsoft Windows applications.

2. Double-click the con_outlook_1013.exe file to start the InstallShield Wizard.

3. Click Next on the Welcome screen of the InstallShield Wizard.

4. Enter your name in the User Name field and your company name in the Organization field. Click Next.

5. Click Next to install in the default folder. To install Oracle Connector for Outlook in a different folder, click Change and navigate to that folder.

6. Select the languages you want to install.

   You can also add more languages after the installation.

   
   

   See Also: Section Section F.3.7.3 for information on how to modify the languages.

   
   

7. To review the information you entered in previous screens, click Back. Otherwise, click Install.

8. Click Finish to start the Configuration Wizard. If you intend to configure Oracle Connector for Outlook later, deselect Start Configuration.

Note: If you have upgraded your Microsoft Outlook installation, you must reinstall Oracle Connector for Outlook.

F.3.4 Installing Oracle Connector for Outlook Using the con_outlook_1013.exe Utility

This section describes how to install and customize Oracle Connector for Outlook using the con_outlook_1013.exe file as a utility. It contains the following topics

• Command Syntax

• Description

• Options

• Examples

F.3.4.1 Command Syntax

con_outlook_1013.exe /lang language_id

con_outlook_1013.exe /s path_to_INI_file

c:\temp\con_outlook_1013.exe /s path_to_INI_file

con_outlook_1013.exe /s UI=value path_to_INI_file

con_outlook_1013.exe /log path_to_log_file

con_outlook_1013.exe /admin admin_argument

con_outlook_1013.exe /admin admin_argument admin_argument

con_outlook_1013.exe /admin image=cd trans=path_to_INI_file

F.3.4.2 Description

Using the con_outlook_1013.exe utility, you can install Oracle Connector for Outlook in administrative mode, silent mode, and you can run the installation wizard in a language other than the language of the operating system of the destination computer. You can also upgrade to a new version of Oracle Connector for Outlook in silent mode.

To install Oracle Connector for Outlook in silent mode, use the /s option. Silent installations require no user participation. To install in silent mode, you can use an initialization file that contains all the required installation information. However, if you do not specify an initialization file, Oracle Connector for Outlook is installed with the default settings.

In addition to silent mode installations, the con_outlook_1013.exe file can be used to perform additional administrative tasks in silent mode, like upgrading, maintaining, or removing Oracle Connector for Outlook. When you run the new installation package in silent mode, it upgrades the installation of Oracle Connector for Outlook to the new version without using an initialization file.

In addition to installing Oracle Connector for Outlook in administrative mode, you can extract the con_outlook.msi installation package to multiple files or a single file from the con_outlook_1013.exe utility using the /admin option.

See Also: Section F.3.7 on configuring initialization files.

F.3.4.3 Options

Option	Description	Accepted Arguments
/lang	Specify the installation wizard language If you do not have a previous version of Oracle Connector for Outlook installed and you want to run the installation wizard in a language other than the language of the operating system of the destination computer, run con_outlook_1013.exe with the /lang option. The installation wizard will run in this language the next time you repair, modify, remove, or upgrade Oracle Connector for Outlook.	A supported language For a list of languages supported by Oracle Connector for Outlook, see Table F-20.
/s	Install in silent mode Install Oracle Connector for Outlook in silent mode, using an initialization file that contains all the required installation information. If you do not specify an initialization file, Oracle Connector for Outlook is installed with the default settings. For more on the INI file, see Section F.3.7. You can also upgrade to a new version of Oracle Connector for Outlook in silent mode. When you run the new installation package in silent mode, it upgrades the installation of Oracle Connector for Outlook to the new version without the need for an initialization file. Configure how much visual feedback to provide during a silent installation by using the various optional UI arguments with the /s option. UI=1 There is no user interface, except for a single dialog box at the end of the installation to indicate it completed successfully. UI=2 A basic user interface is provided during the silent installation. UI=3 A basic user interface is provided in addition to a modal dialog box at the end of the installation, indicating successful installation. The modal dialog box is not displayed if the user cancels the installation. UI=4 The installation is run in full interactive mode. This mode is similar to running the installation without the /s option except that users can now use an INI file to initialize the application with the automatic update settings specified in the initialization file. Note: Only the AutoUpdate section is used in this mode. For more on the AutoUpdate section in the INI file, see Section F.3.7.5.	UI=1 UI=2 UI=3 UI=4 path_to_INI_file
/log	Troubleshoot an installation When you install Oracle Connector for Outlook using the con_outlook_1013.exe utility, a log file called ocsetup.log is generated in the Temp folder. This log file is a useful source of information for troubleshooting installation failures. It records all events and errors during installation with brief descriptions and messages explaining the possible causes of a failed installation. To generate the log file in a different location, use this option with the variable path_to_log_file set to the full path to the log file.	path_to_log_file
/admin	Extract the different packages These packages help administrators deploy Oracle Connector for Outlook in different environments. The following arguments can be passed with the /admin option: image=msiExtracts the installation package to a single file, con_outlook.msi. image=cdExtracts the installation package to multiple files. Multiple files comprise an msi file: the Oracle Connector for Outlook files and the .mst files that contain the transformation for the installation language. image=updateExtracts the XML update file from the Oracle Connector for Outlook patch or release package when a new release is available. This file can be used with the automatic update feature. For information on configuring the automatic update feature in the AutoUpdate section in the INI file, see Section F.3.7.5. image=doubleclickExtracts the distributed executable, known as the Remote Installer, from the Oracle Connector for Outlook package. When users double-click the distributed executable, the Oracle Connector for Outlook package will be downloaded and launched. For information on the Remote Installer, see Section F.3.13. trans=path_to_INI_fileCan be used with image=cd, image=msi, and image=doubleclick. Used with the image=cd argument, creates a transform called silent.mst along with the other language transforms. Used with the image=msi argument, an embedded transform called silent is created. The created transforms change the SILENTINIPATH public property of the original MSI package. This public property must include the path to the INI file. The path can also point to a network location. Note: The variable path_to_INI_file in the trans=path_to_INI_file argument represents the full path to the initialization file and should be accessible by all the computers to which Oracle Connector for Outlook is being deployed. For more on the INI file, see Section F.3.7. Used with the image=doubleclick argument, the Remote Installer executable will be created according to the options in the INI file. For information on the Remote Installer, see Section F.3.13.	image=msi image=cd image=update image=doubleclick trans=path_to_INI_file

Notes: Although the options in the preceding table are shown as lower-case letters, these command-line options are not case-sensitive. You can enter a slash mark (/) or a minus sign (-) before an option at the command line.

F.3.4.4 Examples

The following examples represent command lines you can enter when installing Oracle Connector for Outlook with the con_outlook_1013.exe utility:

• Specifying the installation wizard language

  If you do not have a previous version of Oracle Connector for Outlook installed and you want to run the installation wizard in French, enter the following command:

  con_outlook_1013.exe /Lang 1036
  
  

• Installing in silent mode

  Install Oracle Connector for Outlook in silent mode using the con_outlook_1013.exe file if the executable and initialization files are located in the C:\Temp folder:

  C:\temp\con_outlook_1013.exe /s C:\temp\con_outlook_silent.ini
  
  

• Customizing a silent installation with some visual feedback

  Maintain visual feedback during a silent installation using the con_outlook_1013.exe file if the executable and initialization files are located in the C:\Temp folder:

  C:\temp\con_outlook_1013.exe /s UI=2 C:\temp\con_outlook_silent.ini
  
  

• Extracting the installation package to a single file

  Extract con_outlook.msi to a single file:

  con_outlook_1013.exe /admin image=msi
  
  

• Extracting the installation package to multiple files

  Extract con_outlook.msi to multiple files:

  con_outlook_1013.exe /admin image=cd
  
  

• Creating a transform

  Create a transform called silent.mst along with the other language transforms:

  con_outlook_1013.exe /admin image=cd trans=path_to_INI_file
  
  

• Creating an embedded transform

  Create an embedded transform called silent:

  con_outlook_1013.exe /admin image=msi trans=path_to_INI_file
  
  

• Generating the log file in a different location

  con_outlook_1013.exe /log path_to_log_file
  
  

  In this example, path_to_log_file represents the complete path to the log file.

F.3.5 Installing Oracle Connector for Outlook Using the msiexec.exe Utility

This section describes how to install Oracle Connector for Outlook using the con_outlook.msi package. It contains the following topics:

• Command Syntax

• Description

• Options

• Examples

• Installing Oracle Connector for Outlook 10.1.3 with Elevated Privileges

F.3.5.1 Command Syntax

msiexec.exe /i "con_outlook.msi"

msiexec.exe /i "con_outlook.msi" TRANSFORMS=1036.mst

msiexec.exe /i "con_outlook.msi" TRANSFORMS=:setup_language

msiexec.exe /i "con_outlook.msi" /qn SILENTINIPATH=path_to_INI_file

msiexec.exe /x {product_code} /qn

msiexec.exe /jm "con_outlook.msi" ALLUSERS=1

msiexec.exe /i "con_outlook.msi" /l path_to_log_file

F.3.5.2 Description

Using the msiexec.exe utility, you can install Oracle Connector for Outlook in silent mode, specify the installation language for a first-time installation, advertise an installation of the Oracle Connector for Outlook package on each user's computer, upgrade to a new version of Oracle Connector for Outlook in silent mode, generate a log file to troubleshoot an installation, and uninstall in silent mode.

Run the msiexec.exe utility with the MSI installation package (con_outlook.msi) which you can extract from the con_outlook_1013 utility by using the /admin option.

See Also: Section F.3.4.3 for more information on extracting he con_outlook.msi package into multiple files or a single file from the con_outlook_1013 utility.

To install Oracle Connector for Outlook in silent mode, use the /qn option. Silent installations require no user participation. To install in silent mode, you can use an initialization file that contains all the required installation information. However, if you do not specify an initialization file, Oracle Connector for Outlook is installed with the default settings.

F.3.5.3 Options

Option	Description	Accepted Arguments
/jm	Advertise an installation Advertise an installation of the Oracle Connector for Outlook package on users' computers. You are required to pass the ALLUSERS=1 argument with the /jm option. See the section on performing an advertised installation in Section F.3.5.5.	ALLUSERS=1
/i	Install or upgrade Install or upgrade Oracle Connector for Outlook from the MSI installation package using the msiexec.exe utility. You can use the /i option in conjunction with the /qn option. Notes: The variable setup_language is the ID number of the language that you want to use for the installation. Use TRANSFORMS=: when installing directly from the MSI installation package contained in a single file. Use TRANSFORMS= when installing from the MSI installation package extracted to multiple files. When upgrading from a previous version of 10.1.3, add the following argument: msiexec /i "con_outlook.msi" REINSTALL=ALL REINSTALLMODE=vomus	TRANSFORMS=:setup_language TRANSFORMS=setup_language
/l	Generate a log file When you install Oracle Connector for Outlook using con_outlook.msi, you can generate a log file with the /L option if you are using the msiexec utility. Use the /l option in conjunction with the /i option.	path_to_log_file
/qn	Install in silent mode Install Oracle Connector for Outlook in silent mode using the MSI installation package. You can use an initialization file that contains all the required installation information. If you do not specify an initialization file, Oracle Connector for Outlook is installed with the default settings. Use the /qn option in conjunction with the /i option. When you install Oracle Connector for Outlook in silent mode, you must must specify the path to the initialization file.Enter the full path to the initialization file after SILENTINIPATH. For more on the INI file, see Section F.3.7.	SILENTINIPATH=path_to_INI_file
/x	Uninstall Uninstall Oracle Connector for Outlook using the msiexec utility. Use the /x option in conjunction with the /qn option to uninstall in silent mode.	Product code of Oracle Connector for Outlook

Notes: Although the options in the preceding table are shown as lower-case letters, these command-line options are not case-sensitive. You can enter a slash mark (/) or a minus sign (-) before an option at the command line. These arguments must be entered entirely in capital letters: SILENTINIPATH= ALLUSERS=1 TRANSFORMS=:setup_language TRANSFORMS=setup_language

F.3.5.4 Examples

The following examples represent some commands you can enter when installing Oracle Connector for Outlook with the msiexec.exe utility:

• Specifying the installation language from the single file extracted

  Specify French as the installation language for a first-time installation directly from the MSI installation package contained in a single file:

  msiexec.exe /i "con_outlook.msi" TRANSFORMS=:1036
  
  

• Specifying the installation language after extracting to multiple files

  Specify French as the installation language for a first-time installation if the MSI installation package is extracted to multiple files:

  msiexec.exe /i "con_outlook.msi" TRANSFORMS=1036.mst
  
  

• Performing an advertised installation

  Advertise an installation of the Oracle Connector for Outlook package on each user's computer:

  msiexec.exe /jm "con_outlook.msi" ALLUSERS=1
  
  

  The Oracle Connector Configuration Wizard option will be available from the Oracle Connector For Outlook program submenu. Users can then run the installation with elevated privileges by selecting this shortcut.

• Installing in silent mode

  Install Oracle Connector for Outlook in silent mode using the MSI installation package:

  msiexec.exe /i "con_outlook.msi" /qn C:\temp\con_outlook_silent.ini
  

  In this example, con_outlook_silent.ini is the initialization file and is located in the C:\Temp folder. For more on the initialization file, see Section F.3.7.

• Upgrading

  Upgrade Oracle Connector for Outlook using the MSI installation package

  msiexec.exe /i "con_outlook.msi"
  
  

• Uninstalling

  Uninstall Oracle Connector for Outlook in silent mode:

  msiexec.exe /x {0AF6C5A4-E29B-4D1E-B6FF-D73F4FBB44DA} /qn
  
  

  In this example, the necessary command-line options and values are passed to the Microsoft installer to uninstall Oracle Connector for Outlook in silent mode. This command is the silent-mode equivalent of uninstalling the application through Add or Remove Programs in the Control Panel. In this example, the /x option instructs the Microsoft installer to uninstall Oracle Connector for Outlook, whose product code is specified in the braces {} and /qn specifies a completely silent mode.

• Troubleshooting

  Troubleshoot an installation performed with the MSI installation package by generating a log file:

  msiexec.exe /i "con_outlook.msi" /l C:\OcLog.log
  

Note: When you install using a language other than English, the log file is generated partially in English and partially in the installation language you selected.

F.3.5.5 Installing Oracle Connector for Outlook 10.1.3 with Elevated Privileges

As an administrator, you can use one of the following methods to enable non-administrative users to install Oracle Connector for Outlook:

• Setting the AlwaysInstallElevated Registry Policy

• Performing an Advertised Installation of Oracle Connector for Outlook

• Deploying the Oracle Connector for Outlook Package Using Group Policy With Active Directory

• Applying a Transform to Oracle Connector for Outlook

When using one of these methods, you must use the MSI installation package included with con_outlook_1013.exe.

Setting the AlwaysInstallElevated Registry Policy

By setting the AlwaysInstalledElevated policy on a user's computer, you give a user appropriate installation privileges to install Oracle Connector for Outlook. However, setting this policy can expose a user's computer to security risks because this method enables users to access secure locations on the computer.

See Also: Refer to the following URL about the AlwaysInstalledElevated registry entry: http://windowssdk.msdn.microsoft.com/en-us/library/ms700292.aspx

To configure elevated installation privileges, set the AlwaysInstallElevated policy under the following key in the registry:

HKEY_LOCAL_MACHINE\Software\Policies\Microsoft\Windows\Installer

Note: This applies to a per-computer installation.

If Oracle Connector for Outlook is installed with elevated installation privileges as part of an installation performed on each computer, the AlwaysInstallElevated policy can be removed without affecting future repairs to the installation. Users will still be able to repair the Oracle Connector for Outlook installation with elevated privileges.

Performing an Advertised Installation of Oracle Connector for Outlook

When advertising an installation of Oracle Connector for Outlook on a user's computer, Oracle Connector for Outlook shortcuts are installed, the shortcut icons appear in the Start menu, and the file types become registered, but the files are not actually installed until users access one of these items to start the application. You can advertise Oracle Connector for Outlook on a user's computer, but only if one of the following operating systems is running on it:

• Microsoft Windows 2000

• Microsoft Windows XP

• Microsoft Windows 2003

To advertise an installation of the Oracle Connector for Outlook package on each user's computer, enter the following command:

msiexec.exe /jm "con_outlook.msi" ALLUSERS=1

Deploying the Oracle Connector for Outlook Package Using Group Policy With Active Directory

You can use Microsoft Windows Server 2003 or Microsoft Windows 2000 Server tools to install and maintain software applications by using Group Policy and Active Directory.

Assigning Oracle Connector for Outlook is the easiest way to use Group Policy to manage an installation package. With this method, Oracle Connector for Outlook is automatically installed on a user's computer the first time a designated computer is started and Group Policy is applied. Oracle Connector for Outlook is then available to all users of this computer.

You can deploy Oracle Connector for Outlook on a local computer by assigning the con_outlook.msi package to users' computers through Active Directory and Group Policy.

To deploy Oracle Connector for Outlook using Group Policy:

Notes: Perform the following steps after you have extracted the Oracle Connector for Outlook files to a shared network location that can be accessed by all the computers to which Oracle Connector for Outlook is being deployed. Oracle recommends performing all the steps. This will ensure that Oracle Connector for Outlook is installed on the computer the next time the computer starts, and that it is available to all users of the computer.

1. From the Start menu, select Programs, Administrative Tools, then Active Directory Users and Computers.

2. Create an organization unit that includes all the computers on which you want to deploy Oracle Connector for Outlook. (You can make use of an existing organization unit.)

3. Right-click the organization unit node in the navigation tree.

4. From the shortcut menu, select Properties.

5. Select the Group Policy tab.

6. To add a new group policy, click Add. To edit an existing group policy, click Edit.

7. In the Group Policy Object Editor, expand Computer Configuration. Here you can set policies to be applied to computers, regardless of who logs onto them.

8. Expand the Software Settings folder located under Computer Configuration.

9. Right-click Software installation, select New, and then Package.

10. Browse to the location where you extracted con_outlook.msi and select this file.

11. Select the Advanced option to customize your installation with transforms. Otherwise, select Assigned. Click OK.

12. Proceed to the step 13 if you selected the Assigned option. Select the Modifications tab and add one installation language transform. If you create a transform called silent.mst, you need to add it to the list.

    
    

    See Also: Applying a Transform to Oracle Connector for Outlook for more information on applying a transform.

    
    

13. Click OK in the Properties dialog box.

14. Exit the Active Directory Users and Computers console.

The preceding steps complete the package setup for Oracle Connector for Outlook. You need to verify that the package is available for installation. To do so, restart any computer in the domain. Oracle Connector for Outlook installation will start as soon as the computer restarts.

Using this installation setup, users with no administrative privileges can also modify the supported Oracle Connector for Outlook languages by selecting Add or Remove Languages from the Program menu. In addition, users can repair their installation of Oracle Connector for Outlook.

Note: Only an administrator can permanently remove the application.

See Also: Table F-20 for a list of languages supported in Oracle Connector for Outlook.

Applying a Transform to Oracle Connector for Outlook

When you use a Group Policy to assign the con_outlook.msi package, you can still control the installation of Oracle Connector for Outlook with a silent initialization file. This is done by applying a transform (MST file) to the original Oracle Connector for Outlook package (MSI file).

A transform should only change the SILENTINIPATH public property of the original con_outlook.msi package. This public property must include the path to the initialization file. The path can also point to a network location.

See Also: Section F.3.7 on configuring initialization files.

Notes: If you want to deploy Oracle Connector for Outlook with the default values, you do not need to create an initialization file. The path to the INI file (path_to_INI_file) in the trans=path_to_INI_file argument should be accessible by all computers to which Oracle Connector for Outlook is being deployed. If you are configuring the OcConfigWizard section of the initialization file, the path to the PRF file should be accessible by all computers to which Oracle Connector for Outlook is being deployed.

The structure of the initialization file is the same as the one used for the silent installation.

See Also: Refer to the following URL for a step-by-step guide to software installation and maintenance: http://www.microsoft.com/windows2000/techinfo/planning/management/swinstall.asp

F.3.6 Configuring Oracle Connector for Outlook Using the ocfoprofwiz.exe Utility

This section describes how to configure Oracle Connector for Outlook using the ocfoprofwiz.exe utility. It contains the following topics:

• Command Syntax

• Description

• Options

• Examples

• Methods for Launching the Configuration Wizard

F.3.6.1 Command Syntax

ocfoprofwiz.exe /s path_to_PRF_file

ocfoprofwiz.exe /L language_id

ocfoprofwiz /d

ocfoprofwiz /p

ocfoprofwiz /p /l language_id

F.3.6.2 Description

The ocfoprofwiz.exe utility, or configuration wizard, is a standalone application that is useful for both administrators and end users because it integrates the creation and configuration of PRF files and profiles. The configuration wizard reads information from an existing PRF file and creates a new profile, or modifies an existing profile, with the appropriate settings. This utility can be started from the command prompt or from Windows Explorer. You can find ocfoprofwiz.exe in the following directory:

C:\Program Files\Oracle\Outlook Connector\

The following list describes various uses of the ocfoprofwiz.exe utility:

• You can start the configuration wizard in interactive mode.

• You can start the configuration wizard in silent mode. You can use an existing PRF file with all the required settings information to create and configure the first profile for the user.

• As an administrator, you can use the configuration wizard to generate the PRF files to save the updated settings.

• As an administrator, you can use the configuration wizard to back up the Oracle Connector for Outlook settings for an existing profile and restore these settings later.

• As an administrator, you can modify profile settings in the PRF file generated by the Oracle Connector for Outlook configuration wizard.

Note: While configuring a profile, it only configures the Oracle Connector for Outlook settings. You can run only one instance of the configuration wizard at a time. If you try to launch the configuration wizard a second time, the instance previously started will be displayed in the foreground.

F.3.6.3 Options

Use the command-line options described in this section to customize the configuration wizard:

Option	Description	Accepted Arguments
/d	Set as Default Profile option in the configuration wizard Specifies that Set as Default Profile should be selected by default on the final screen of the configuration wizard.	Not applicable
/l	Specify the configuration wizard language Use to specify the language for running the configuration wizard. This language must already be installed (from the installation of Oracle Connector for Outlook). Can be used in conjunction with the /p option. For a list of languages supported by Oracle Connector for Outlook, see Table F-20.	A supported language
/p	Create a profile in interactive mode Runs the configuration wizard in the interactive profile creation mode, creating a PRF file. Can be used in conjunction with the /l option.	Not applicable
/s	Create a profile in silent mode Runs the Oracle Connector Configuration Wizard in silent profile creation mode. Enter the full path to the PRF file after path_to_PRF_file.	path_to_PRF_file

Notes: Although the options in the preceding table are shown as lower-case letters, these command-line options are not case-sensitive. You can enter a slash mark (/) or a minus sign (-) before an option at the command line.

F.3.6.4 Examples

The following examples represent some commands you can enter to customize the configuration wizard:

• Specifying the Language of the Configuration Wizard

  Run the configuration wizard in German:

  ocfoprofwiz.exe /l 1031
  

  
  

  Note: The language you specify must have been installed during the installation of Oracle Connector for Outlook.

  
  

• Interactive Profile Creation Using the Configuration Wizard

  Run the ocfoprofwiz.exe utility in the interactive profile creation mode to create the PRF file:

  ocfoprofwiz.exe /p
  
  

  Run the configuration wizard in German, in the interactive profile creation mode:

  ocprofwiz.exe /p /l 1031
  
  

• Silent Profile Creation

  Run the configuration wizard in silent profile creation mode:

  ocfoprofwiz.exe /s "C:\Program Files\Oracle\Outlook Connector\source.prf"
  
  

• Setting the Set as Default Profile Option

  Ensure that Set as Default Profile is selected in the Congratulations screen of the configuration wizard:

  ocprofwiz.exe /d
  

F.3.6.5 Methods for Launching the Configuration Wizard

The configuration wizard can be launched in three different modes:

• Interactive Profile Creation and Configuration Mode

• Interactive PRF File Creation Mode

• Silent Profile Creation Mode

Interactive Profile Creation and Configuration Mode

The interactive profile creation and configuration mode is the default mode. Use this mode to specify settings and create or modify a profile. You can configure an existing profile or create a new profile by using the Profile Settings screen of the configuration wizard. However, you can configure only one profile in one session. You can also remove an existing profile on the Profile Settings screen.

To run the configuration wizard:

1. Close Microsoft Outlook before starting the configuration wizard.

2. Launch the wizard by double-clicking the Oracle Connector Configuration Wizard icon on your desktop. Alternatively, select Oracle Connector For Outlook, then Oracle Connector Configuration Wizard from the Start menu on your desktop.

3. From the Welcome screen, click Next.

4. If you want to create a new profile, select New and enter a name for the new profile. If you want to configure an existing profile, select it from the Profiles list. Click Next.

5. You can view or modify settings for the selected user profile on the Service Settings screen. All non-password fields must be filled to enable Next. To configure advanced settings, such as resetting your local mailbox cache, setting a folder refresh rate for incoming mail, or selecting a refresh option for the Global Address Book, click More Settings.

   
   

   Note: If Microsoft Outlook is open and you are using the same profile while you are configuring profile settings, the fields on the Service Settings screen are disabled.

   
   

6. When the Congratulations screen is displayed, verify that Set as Default Profile is selected. The Outlook Address Book service is added to a new profile by default.

Interactive PRF File Creation Mode

As an administrator, you can run the ocfoprofwiz.exe utility in the interactive PRF file creation mode. You can create a PRF file by starting with a blank template or by importing information from an existing profile or PRF file.

By default, the PRF file created is a blank template. For security reasons, password fields are not saved in the resulting PRF file if information is imported from an existing profile. The final PRF file contains user profile information, and settings information, which can be used by the configuration wizard or by the NewProf.exe file.

Depending on the source template used, the Outlook Address Book information is added to the Service List section in the output PRF file. In the profile template, where information is imported from an existing profile, it depends on whether or not the profile has the Outlook Address Book service. In the PRF template, where information is imported from an existing PRF file, it again depends on whether or not the PRF contains an Outlook Address Book information in the Service List section.

To run ocfoprofwiz.exe in the interactive PRF file creation mode:

1. Close Microsoft Outlook before starting the configuration wizard.

2. Enter /p at the command line. For example:

   ocfoprofwiz.exe /p
   
   

3. Under Source Template in the PRF Configuration Settings screen, select one of the following options for the PRF file:

   • Empty PRF File: If you select this option as the source template, you must manually specify the settings.

   • Existing PRF File: If you select this option as the source template, initial settings information is imported from the source PRF file.

   • MAPI Profile: If you select this option as the source template, initial settings information is imported from the source profile.

4. Enter the name and location of the new PRF file under Destination File.

5. In the Profile Options screen, configure the settings for the General section of the new PRF file. Table F-17 shows the relationship between the fields in the Profile Options screen and the parameters in the General section of the PRF file:

6. You can view or modify Oracle Connector for Outlook settings for the selected user profile in the Service Settings screen. All non-password fields must be filled to enable Next.

   To configure advanced settings, such as resetting your local mailbox cache, setting a folder refresh rate for incoming mail, or selecting a refresh option for the Global Address Book, click More Settings. The Oracle Connector for Outlook settings information will be saved to the new PRF file.

7. If View PRF File is selected when the Congratulations screen is displayed, the wizard displays the newly created PRF file. You can then verify the information or modify parameters in the PRF file.

Table F-17 Relationship Between Fields in the Profile Options Screen and Settings in the General Section of the PRF File

Field in Profile Options Screen	Parameter in the General Section of the PRF File
Profile Name	ProfileName
Default Store	DefaultStore
Use this profile as the default MAPI profile.	DefaultProfile=Yes/No
Overwrite existing profile with the same name.	OverwriteProfile=Yes/No

Silent Profile Creation Mode

An existing PRF file is used as the template for creating a corresponding profile. When installing Oracle Connector for Outlook in silent mode, you can start the configuration wizard after the installation is complete. The configuration wizard reads information from an existing PRF file and creates a new profile, or modifies an existing profile, with the appropriate settings.

Note: Oracle recommends that you use a PRF file generated by the Oracle Connector for Outlook configuration wizard. Most of the parameters in the PRF file can be configured through the configuration wizard in the interactive PRF file creation mode. If you modify a value manually, then you must verify that the new value falls within the valid range of values. To verify that you are within the valid range of values, consult the PRF file distributed with the installation package.

See Also: Section F.3.7 on configuring initialization files.

The Outlook Address Book service is imported into the profile if it is listed in the Service List section. Limited support is also available for some other types of message services.

When Oracle Connector for Outlook is configured in silent mode, a log file is created to record success and error information. This log file is stored in a temporary folder on the computer. For example:

C:\Documents and Settings\user\Local Settings\Temp\ocfoConfigWizardLog\ocfoConfigWizard.log

In the preceding command, user represents the login name of the local user.

Notes: If you are configuring Oracle Connector for Outlook in silent mode, then you must check the log file to verify the results. The log file contains a record of errors, as well as successful imports of information into the profile. The configuration wizard may write some information to the log file in interactive profile creation and configuration mode and interactive PRF file creation mode. Usually, high-level warning messages are displayed and low-level technical information is recorded in the log file.

F.3.7 Configuring the Initialization File Used in the Silent Installation of Oracle Connector for Outlook

You can configure the following sections in the initialization file. The initialization file can be called ctoc.ini but you can name it something else. You can also choose the location of the initialization file.

• The [General] Section

• The [Settings] Section

• The [Languages] Section

• The [OcConfigWizard] Section

• The [AutoUpdate] Section

F.3.7.1 The [General] Section

In the [General] section of the initialization file, you can specify the name of the user Oracle Connector for Outlook is registered to, the company name, and the location where you want to install Oracle Connector for Outlook.

Table F-18 Parameter Values for Configuring the [General] Section in the INI File

Parameter	Description	Accepted Values	Default Value
UserName	Specify the name of the user Oracle Connector for Outlook is registered to.	A string specifying a user name.	No default
Company	Specify the name of the company who has purchased the software license.	A string specifying a company name.	No default
InstallPath	Specify the path to install Oracle Connector for Outlook (other than the default installation path). If empty, the default installation path is used: [current drive]\Program Files\Oracle\Outlook Connector	A string specifying the installation path.	No default

The following excerpt of the initialization file shows the parameters with examples in the [General] section:

[General]
UserName=OCFOUSER
Company=ORACLE
InstallPath=C:\Program Files\Oracle\Outlook Connector

F.3.7.2 The [Settings] Section

In the [Settings] section of the initialization file, you can force your computer to reboot after installation, disable Control Panel options, disable mail server functions, and more. Refer to the following table for the parameters you can configure in this section of the initialization file:

Table F-19 Parameters for Configuring the [Settings] Section in the INI File

Parameter	Description	Accepted Values	Default Value
ForceReboot	Set to 1 to force the computer to restart after the installation.	0 1	0
DisablePwd	Set to 1 to prevent the user from saving a password.	0 1	0
HideCalendarPwdMenu	Set to 1 to hide the Change password menu item from the user.	0 1	0
NoDesktopShortcut	Set to 1 to remove the Oracle Connector Configuration Wizard shortcut from the desktop.	0 1	0
DisableCfgUI	Set to 1 to disable Control Panel options.	0 1	0

The following excerpt of the initialization file shows the parameters with examples in the [Settings] section:

• [Settings]
  ForceReboot=0
  DisablePwd=1
  HideCalendarPwdMenu=1
  DisableCfgUI=1
  NoDesktopShortcut=1
  

F.3.7.3 The [Languages] Section

In the [Languages] section, you can specify additional languages that Oracle Connector for Outlook will support during installation.

Refer to Table F-20 for a list of supported languages.

You can add or delete languages in silent mode, by modifying the Languages section. This is valid as long as you consistently use the same installation package.

The following excerpt of the initialization file shows the parameters that would be used in the [Languages] section if English, French, and German are specified as additional languages:

[Languages]
;English US
1033=us
;French
1036=f
;German
1031=d

Table F-20 Languages Supported by Oracle Connector for Outlook

Language Name	ID Number
English US	1033
Chinese (Simplified)	2052
Chinese (Traditional)	1028
Czech	1029
Danish	1030
Dutch (Netherlands)	1043
Finnish	1035
French	1036
German	1031
Greek	1032
Hungarian	1038
Italian	1040
Japanese	1041
Korean	1042
Norwegian	1044
Polish	1045
Portuguese (Brazil)	1046
Portuguese (Portugal)	2070
Romanian	1048
Russian	1049
Spanish	1034
Swedish	1053
Turkish	1055

F.3.7.4 The [OcConfigWizard] Section

In the [OcConfigWizard] section, you can specify the location of the PRF file, the file that contains the user profile information. Oracle Connector for Outlook uses the PRF file to configure user profiles.

Table F-21 Parameter for Configuring the OcConfigWizard Section in the INI File

Parameter	Description	Accepted Values	Default Value
Path	Specify the absolute path of the PRF file.	A string specifying the location.	No default

The following excerpt of the initialization file shows the parameters and values in the OcConfigWizard section:

[OcConfigWizard]
Path=c:\MyPrfName.prf

F.3.7.5 The [AutoUpdate] Section

In the [AutoUpdate] section, you can specify the settings you want to use to force an automatic upgrade of Oracle Connector for Outlook. These settings include where the client will look for new Oracle Connector for Outlook automatic update packages, how often the client should look for the new packages, and how users will be notified. Refer to the following table for the parameters you can configure in this section of the initialization file:

Table F-22 Parameters for Configuring the [AutoUpdate] Section in the INI File

Parameter	Description	Accepted Values	Default Value
ServerURL	Set to the string specifying the location where the Oracle Connector for Outlook packages are available. This can be a shared network location, Web server, or an FTP server.	A string specifying the location.	No default
ProxyConnection	Specify if the client requires a proxy to connect to the location. Note: The parameters ProxyAddress and ProxyPort are also used when the value is set to 2. See also: ProxyAddress and ProxyPort	0 (no proxy is needed, connection is direct) 1 (the browser proxy settings are used) 2 (manual settings are used)	0
ProxyAddress	Specify the proxy URL if manual proxy settings will be used. Set this parameter if the client requires proxy to connect to the location. When this parameter is set, the ProxyConnection parameter needs to be set to 2.	The string specifying the proxy URL	No default
ProxyPort	Specify the port number the proxy should use. Set this parameter if the client requires a proxy to connect to the location. When this parameter is set, the ProxyConnection parameter needs to be set to 2.	A valid port number	No default
AutomaticCheck	Set to 0 to notify users before checking if there are new updates available. Set to 1 to automatically check if updates are available.	0 (Prompt) 1 (No prompt)	1
AutomaticDownload	Set to 0 to notify users before downloading updates. Set to 1 to automatically download updates — users are not prompted. The executable will automatically begin downloading the updates package.	0 (Prompt) 1 (No prompt)	0
AutomaticInstall	Set to 0 to notify users before installing updates. Set to 1 to automatically install updates — users are not prompted. The executable is automatically downloaded and launched.	0 (Prompt) 1 (No prompt)	1
AutomaticType	Specify how often to check for new Oracle Connector for Outlook updates. The default value is 3, and schedules checks at regular intervals and specified times. Note: When the AutomaticType parameter is set to 3, the ScheduledFrequent and ScheduleHour parameters are also used. See also: ScheduledFrequent and ScheduleHour	0 (Disable checking) 1 (Check on Outlook startup) 2 Check on Windows login) 3 (Scheduled check)	3
ScheduledFrequent	Specify the time interval for checking for updates.	0 (Daily) 1 (Weekly) 2 (Monthly)	0
ScheduleHour	Specify an hour of the day to check for Oracle Connector for Outlook updates. Note: If the computer is off during the scheduled time of notification, the user will be notified when the computer is restarted.	Values can range from 0-23, to specify any hour of the day.	9
ShowCheck	This parameter controls the Automatic Update page. Set to 1 to disable the option to allow users to change the previous automatic update settings when they click on the Oracle Connector Automatic Updates shortcut.	0 (Enable user preferences) 1 (Disable user preferences 2 (Hide user preferences)	0
ShowNotification	This parameter controls the Notification page alerting users that automatic updates are available. Set to 1 to disable the option to allow users to change the previous notification settings when they click on the Oracle Connector Automatic Updates shortcut.	0 (Enable user preferences) 1 (Disable user preferences 2 (Hide user preferences)	0
ShowServer	This parameter controls the Update Address settings. Set to 1 to disable the option to allow users to change the previous Update Address settings when they click on the Oracle Connector Automatic Updates shortcut.	0 (Enable user preferences) 1 (Disable user preferences 2 (Hide user preferences)	0
ShowProxy	This parameter controls the Proxy settings for when the client needs to use a proxy to connect to the centralized location. Set to 1 to disable the option to allow users to change the previous Proxy settings when they click on the Oracle Connector Automatic Updates shortcut.	0 (Enable user preferences) 1 (Disable user preferences 2 (Hide user preferences)	0

The following excerpt from the initialization file shows the parameters with examples in the [AutoUpdate] section:

[AutoUpdate]
ShowCheck=0           ;(0 Enable, 1 Disable, 2 Hide)
ShowNotification=0    ;(0 Enable, 1 Disable, 2 Hide)
ShowServer=2          ;(0 Enable, 1 Disable, 2 Hide)
ShowProxy=0                ;(0 Enable, 1 Disable, 2 Hide)

AutomaticCheck=1      ;(0 Notify, 1 Automatic)
AutomaticInstall=0    ;(0 Notify, 1 Automatic)
AutomaticDownload=1   ;(0 Notify, 1 Automatic)

ServerURL=http://connector.ca.oracle.com/WEBSITE/Update1/

ProxyConnection=0     ;(0 Direct, 1 , 2 Manual)
ProxyAddress=http://Mytest
ProxyPort=80

AutomaticType=3  ;0 disable,1 On Outlook startup,2 on Windows login,3 Scheduled
ScheduledFrequent=0   ;0 daily, 1 Weekly, 2 monthly
ScheduleHour=9        ;0-23

Sample Initialization File Used in the Silent Installation of Oracle Connector for Outlook

The following excerpt displays a sample initialization file used for silently installing Oracle Connector for Outlook.

Note: With the exception of the Languages section, the parameters in the initialization file can only be configured for first-time installations. If you already installed Oracle Connector for Outlook, you can only modify the settings after uninstalling the application.

[General]
UserName=OCFOUSER
Company=ORACLE
InstallPath=C:\Program Files\Oracle\Outlook Connector

[Settings]
ForceReboot=0
DisablePwd=1
HideCalendarPwdMenu=1
DisableCfgUI=1
NoDesktopShortcut=1

[Languages]
;English US
1033=us
;Chinese (PRC) (S)
2052=zhs,_936
;Chinese (Singapore) (S)
4100=zhs,_936
;Chinese (Hong Kong) (T)
3076=zht,_950
;Chinese (Macau) (T)
5124=zht,_950
;Chinese (Taiwan) (T)
1028=zht,_950
;Czech
1029=cs
;Danish
1030=dk
;Dutch (Netherlands)
1043=nl
;Finnish
1035=sf
;French
1036=f
;German
1031=d
;Greek
1032=el
;Hungarian
1038=hu
;Italian
1041=i
;Japanese
1041=ja
;Korean
1042=ko
;Norwegian (Bokmal)
1044=n
;Polish
1045=pl
;Portuguese (brazilian)
1046=ptb
;Portuguese
2070=pt
;Romanian
1048=ro
;Russian
1049=ru
;Spanish
1034=e
;Swedish
1053=s
;Turkish
1055=tr

[OcConfigWizard]
Path=c:\PRFNAME.prf

[AutoUpdate]
ShowCheck=0           ;(0 Enable, 1 Disable, 2 Hide)
ShowNotification=0    ;(0 Enable, 1 Disable, 2 Hide)
ShowServer=2          ;(0 Enable, 1 Disable, 2 Hide)
ShowProxy=0                ;(0 Enable, 1 Disable, 2 Hide)

AutomaticCheck=1      ;(0 Notify, 1 Automatic)
AutomaticInstall=0    ;(0 Notify, 1 Automatic)
AutomaticDownload=1   ;(0 Notify, 1 Automatic)

ServerURL=http://connector.ca.oracle.com/WEBSITE/Update1/

ProxyConnection=0  ;(0 Direct, 1 , 2 Manual)
ProxyAddress=http://Mytest
ProxyPort=80

AutomaticType=3  ;0 disable,1 On Outlook startup,2 on Windows login,3 Scheduled
ScheduledFrequent=0   ;0 daily, 1 Weekly, 2 monthly
ScheduleHour=9        ;0-23

F.3.8 Upgrading Oracle Connector for Outlook

Note: If you are upgrading to Oracle Connector for Outlook 10.1.3 from a previous version, you need to reset the profile's local storage and restore the default Send/Receive and View settings. Oracle recommends backing up any client-side e-mail rules and fully synchronizing PDA data (if a PDA device is used) before upgrading.

You can use the con_outlook_1013.exe utility or the msiexec.exe utility to upgrade the existing version of Oracle Connector for Outlook. When you run con_outlook_1013.exe or con_outlook.msi, the installation language used for the upgrade is determined based on the current version of Oracle Connector for Outlook.

To upgrade in interactive mode, run con_outlook_1013.exe and follow the instructions on the screen. To upgrade using the msiexec.exe utility, refer to Section F.3.5.3 for the options you need to enter to upgrade Oracle Connector for Outlook using the MSI installation package.

F.3.9 Modifying, Repairing, or Removing Oracle Connector for Outlook

You can modify, repair, or remove an Oracle Connector for Outlook installation using the InstallShield wizard. This section discusses the following topics:

• Modifying the Selection of Installed Languages in Oracle Connector for Outlook

• Repairing Oracle Connector for Outlook

• Removing Oracle Connector for Outlook

F.3.9.1 Modifying the Selection of Installed Languages in Oracle Connector for Outlook

To modify the language settings of Oracle Connector for Outlook, perform one of the following tasks:

• Run con_outlook_1013.exe or con_outlook.msi. Select Modify in the Program Maintenance screen.

• Double-click Add or Remove Programs in the Control Panel. Click Change. Select Modify from the screen.

• From the Start menu, select Oracle Connector for Outlook, and then Add or Remove Languages.

F.3.9.2 Repairing Oracle Connector for Outlook

To repair an Oracle Connector for Outlook installation, perform one of the following tasks:

• Run con_outlook_1012x.exe or con_outlook.msi. Select Repair from the Program Maintenance screen.

• Double-click Add or Remove Programs in the Control Panel. Click Change. Select Repair from the Program Maintenance screen.

Note: When you repair the Oracle Connector for Outlook installation, registry keys that were deleted or corrupted are automatically reinstalled.

F.3.9.3 Removing Oracle Connector for Outlook

To remove Oracle Connector for Outlook, perform one of the following tasks:

• Run con_outlook_1013.exe or con_outlook.msi. In the Program Maintenance screen, click Remove.

• Double-click Add or Remove Programs in the Control Panel. Click Remove next to Oracle Connector for Outlook.

F.3.10 Troubleshooting an Oracle Connector for Outlook Installation

The method you use for troubleshooting an Oracle Connector for Outlook installation depends on which installation package was used to install the application, con_outlook_1013.exe or con_outlook.msi.

See Also: Section F.3.4.3 for more information on troubleshooting when you installed Oracle Connector for Outlook using con_outlook_1013.exe. Section F.3.5.3 for more information on troubleshooting when you installed Oracle Connector for Outlook using con_outlook.msi.

F.3.10.1 Troubleshooting an Installation Performed With the Executable File

When you install Oracle Connector for Outlook using con_outlook_1013.exe, a log file called ocsetup.log is generated in the Temp folder.

This log file is a useful source of information for troubleshooting installation failures. It records all events and errors during installation with brief descriptions and messages explaining the possible causes of a failed installation.

F.3.11 Deploying Oracle Connector for Outlook Using the Automatic Update Feature

A network administrator can enhance the deployment of Oracle Connector for Outlook by enabling the automatic update feature. Oracle recommends configuring the automatic update feature during the initial deployment of Oracle Connector for Outlook, regardless of how the deployment is done — through the active directory, or through a silent or interactive installation. Once the automatic update feature is configured, it will be easier to upgrade Oracle Connector for Outlook. Then, when the automatic update feature is enabled, users can then check, download, or install new Oracle Connector for Outlook packages from a centralized location whenever they are available. Automatic updates can be configured manually or can be automated silently without any user intervention. This feature can help ensure that the Oracle Connector for Outlook installation is up to date. For the automatic update feature to work, administrators must make sure that certain requirements are met on both the client and the server.

This section discusses the requirements that need to be met on the client and the serve. It contains the following topics:

• Client Side Requirements

• Server Side Requirements

F.3.11.1 Client Side Requirements

The client should be pointing to the location where the administrator store new Oracle Connector for Outlook update packages. This can be done while administrators deploy Oracle Connector for Outlook or later, by users. There are three possible ways to configure automatic updates:

• Silent Installation With the /s Option

• Interactive Installation With the /s Option

• Accessing the Oracle Connector Automatic Updates User Interface

Silent Installation With the /s Option

Users can initialize the automatic update configuration by setting the values of the AutoUpdate section of the initialization file during a silent installation. Refer to the AutoUpdate Section in Section F.3.7 for further details about the AutoUpdate section of the initialization file. To run the silent installation with the /s option, use the following command:

con_outlook_1013.exe /s path_to_INI_file

See Also: Section F.3.4.3 for more information on options used with the con_outlook_1013.exe utility.

Interactive Installation With the /s Option

Users can set the automatic update configuration during an interactive installation using an initialization file, by using the following command:

con_outlook_1013.exe /s UI=4 path_to_INI_file

Accessing the Oracle Connector Automatic Updates User Interface

After installing the package, users can still change the automatic update settings by executing the ocupdates.exe package located in the C:\Program Files\Oracle\Outlook Connector directory using the /admin option or by launching the ÒOracle Connector Automatic UpdatesÓ shortcut from Start, All Programs, Oracle Connector For Outlook.

F.3.11.2 Server Side Requirements

The administrator should maintain a centralized location where new updates will be stored. This can either be an HTTP Web site, FTP site, a shared network location, or a local drive. When an update is available, store the following two files in the centralized location.

Note: The centralized location for storing updates is the value of the ServerURL parameter in the [AutoUpdate] section of the initialization file.

• The new ÒOracle Connector for OutlookÓ package

• An XML file called update.xml

When both requirements are satisfied, users will be notified accordingly when new updates are available in the centralized location.

When a new release of Oracle Connector for Outlook is available, extract the XML from the Oracle Connector for Outlook patch or release package using the following command line:

con_outlook_1013.exe /admin image=update

Follow the instructions on the screen to end up with an XML file called update.xml stored in the directory chosen. After you store this file at the ServerURL location, along with the Oracle Connector for Outlook patch or release package, users can download or install the new package.

See Also: Section F.3.7.5 on configuring the automatic update feature in the [AutoUpdate] section of the initialization file.

Caution: The following excerpt from the XML file is provided as an example only. Oracle recommends manually extracting the update.xml file from the Oracle Connector for Outlook package, using the above command.

Example F-1

<Update>
<OCFO version='3.7.349'>
<File src='con_outlook_1013_04.exe' dis_ver='10.1.3.0.4' InstallID='26388147'></File>
</OCFO>
<Update>

F.3.11.2.1 Configuring the Automatic Update Feature

You can modify the update.xml file to change the default behavior of the automatic update feature. You need to configure parameters in the <File> tag in update.xml to modify where Oracle Connector for Outlook patch or release packages are stored, when updates can be performed, and how the Update Wizard is displayed for users.

After you make changes to the file, you need to save it in ASCII encoding. Do not change the XML file name if the ServerURL parameter points to a folder location. In order to change the name from update.xml, you need to make sure that the ServerURL parameter value is the full location to where the XML file is located.

The following parameters define the parameters you can modify in or add to the <File> tag in update.xml:

Table F-23 UI Parameters for Configuring Inside the <File> Tag in the XML File

Parameter	Description	Accepted Values	Default Value
src	Using a character string, enter the name of the Oracle Connector for Outlook installation package if you store the Oracle Connector for Outlook patch or release package in the same location as the XML file. Alternatively, enter the full location where the file can be read. The full location should include the name of the package. The location can be an HTTP Web server, an FTP server, a shared network folder path, or a local drive. The location must be entered in English ASCII encoding.	The string must include the executable file name or the full location where the file can be read.	The package name corresponding to the release of Oracle Connector for Outlook. For example: con_outlook_1013.exe
dis_ver	Using a character string, specify the version number to display to users in the Update Wizard screens during the automatic update process.	The version number corresponding to the release of Oracle Connector for Outlook. For example: 10.1.3.0.4	The version number corresponding to the release of Oracle Connector for Outlook
dsc	Using a character string, specify what text to display as a description to users in the Update Wizard screens during the automatic update process. To display text on a new line in the Description field in the Update Wizard screen, enter the text on a new line in the XML file itself.	New Release for Oracle Connector for Outlook	No default
except	Specify days on which updates are not allowed. The exception days are the first two English letter abbreviations of the days of the week, separated by commas. Even if the automatic update feature finds a new update on one of the exception days, the automatic update will not be performed. The automatic update will be re-scheduled to the next day if the check was done as one of the weekly or monthly schedule cases.	Mo Tu We Th Fr Sa Su	No default

Example F-2

<Update>
<OCFO version='3.7.349'>
<File src='\\storm\testapp\ocfoUpdate.exe' except='Mo,Tu' dis_ver='10.1.3 RTM'  dsc='New Release for Oracle Connector for Outlook Please Upgrade…' InstallID='26388147'></File>
</OCFO>
<Update>

F.3.12 Using the Automatic Update Feature to Configure Client Registry Settings

The Automatic Update feature available in version 10.1.3 allows you to enhance the deployment of Oracle Connector for Outlook for end users. Once it is enabled, you can use the Automatic Update feature to change registry settings for Oracle Connector for Outlook on end users' computers.

In order to set up the Automatic Update feature to change registry settings on end users' computers, you need to add a <Registry> tag inside the <Update> tag in the XML file, update.xml. Then add as many actions as you need to within the <Update> tag. When the Automatic Update feature runs, the actions in the XML file are executed in order. For more information on setting up the XML file for using the Automatic Update feature to configure client registry settings, see the Configuring the XML File for Running the Automatic Update Feature.

Note: The registry setting changes will be applied on the clients within two hours from when update.xml is filed on the server. You can choose where to file update.xml on the server.

The following parameters define the actions you can add to the <Registry> tag in update.xml:

Table F-24 UI Parameters for Configuring Actions in the XML File

Parameter	Description	Accepted Values
Type	Using a character string, specify what action is to be executed.	Add Replace Delete
src	Using a character string, specify the location of the registry key.	The string should terminate with a backslash (\). To include multiple keys in one string, you can use the wildcard character (*).
Hive	The Hive parameter can be set to one of two values to indicate the registry hive on which to perform the operation.	HKCU HKLM
Value	Using a character string, specify the name of the registry entry. Add this parameter only if the action is not for a key.	A valid registry entry
DataType	Using a character string, specify the data type in the registry. This parameter should only be used when the <Type> value is Add or Replace.	Binary DWORD String
Data	Using a character string, specify the data type of the registry value. This parameter should only be used when the <Type> value is Add or Replace.	4008636142 OCFO_User
oldDataType	Using a character string, specify the data type of previous data in the registry. This parameter should only be used when the <Type> value is Replace.	Binary DWORD String
oldData	Using a character string, specify the data of the previous registry value. This parameter should only be used when the <Type> value is Replace.	2 EEEEEEEE

Note: The replace action will not be executed unless the values for oldDataType and oldData match the ones on the user's computer.

Template for Inserting an Action inside the Registry Tag

<Registry>
    <Action Type=''
            Hive=''
            src=''
            Value=''
            oldDataType=''
            oldData=''>
            dataType=''
            data=''>
    </Action>
</Registry>

F.3.12.1 Configuring the XML File for Running the Automatic Update Feature

The sample XML file provided in this section shows how update.xml is used with the Automatic Update feature to change the client registry settings. The file contains six actions that are performed in order. After each action, an excerpt of the XML file is shown, including all configurations up to and including the action. After the sixth action, the entire sample XML file is shown.

Action 1

Add a key under the HKey_current_user hive called

'SOFTWARE\Oracle\Outlook Connector\3.7\update\Test\

Sample XML showing Action 1:

<Update>
<OCFO version='3.7.400'>
<File src='Oldcon_outlook_1013.exe' dis_ver='10.1.3.0.2' InstallID  ='25332723'> </File>
</OCFO>

<Registry>
<Action Type='Add'
Hive='HKCU'
src='SOFTWARE\Oracle\Outlook Connector\3.7\update\Test\'>
</Action>
</Registry>
</Update>

Action 2

Add a string registry entry called User under the key created by Action 1. The string value is OCFO_User. Sample XML showing Action 2:

<Update>
<OCFO version='3.7.400'>
<File src='Oldcon_outlook_1013.exe' dis_ver='10.1.3.0.2' InstallID  ='25332723'> </File>
</OCFO>

<Registry>
<Action Type='Add'
Hive='HKCU'
src='SOFTWARE\Oracle\Outlook Connector\3.7\update\Test\'
Value='User'
dataType='String'
data='OCFO_USer'>
</Action>
</Registry>
</Update>

Action 3

Add a DWORD registry entry called myTimeZonesVer under the key \63c73641093d11d6a97400b0d0529047\Settings\ under all the profiles of the client. The Data value is set to 2. Sample XML showing Action 3:

<Update>
<OCFO version='3.7.400'>
<File src='Oldcon_outlook_1013.exe' dis_ver='10.1.3.0.2' InstallID  ='25332723'> </File>
</OCFO>

<Registry>
<Action Type='Add'
Hive='HKCU'
src='Software\Microsoft\Windows NT\CurrentVersion\Windows Messaging Subsystem\Profiles\*\63c73641093d11d6a97400b0d0529047\Settings\'
Value='myTimeZonesVer'
dataType='DWORD'
data='2'>
</Action>
</Registry>
</Update>

Action 4

Search under the key \63c73641093d11d6a97400b0d0529047\Settings\ of the client's profiles for a DWORD registry entry called myTimeZonesVer with a Data value of 2. If found, then replace it with a value of 2. Sample XML showing Action 4:

<Update>
<OCFO version='3.7.400'>
<File src='Oldcon_outlook_1013.exe' dis_ver='10.1.3.0.2' InstallID  ='25332723'> </File>
</OCFO>

<Registry>
<Action Type='replace'
Hive='HKCU'
src='Software\Microsoft\Windows NT\CurrentVersion\Windows Messaging Subsystem\Profiles\*\63c73641093d11d6a97400b0d0529047\Settings\'
Value='myTimeZonesVer'
data='1'
dataType='DWORD'
oldData='2'
oldDataType='DWORD'>
</Action>
</Registry>
</Update>

Action 5

Delete the key created by Action 1. Sample XML showing Action 5:

<Update>
<OCFO version='3.7.400'>
<File src='Oldcon_outlook_1013.exe' dis_ver='10.1.3.0.2' InstallID  ='25332723'> </File>
</OCFO>

<Registry>
<Action Type='delete'
Hive='HKCU'
src='SOFTWARE\Oracle\Outlook Connector\3.7\update\Test\' >
</Action>
</Registry>
</Update>

Action 6

Delete all the registry entries created by Action 3. Sample XML showing Action 6:

<Update>
<OCFO version='3.7.400'>
<File src='Oldcon_outlook_1013.exe' dis_ver='10.1.3.0.2' InstallID  ='25332723'> </File>
</OCFO>

<Registry>
<Action Type='delete'
Hive='HKCU'
src='Software\Microsoft\Windows NT\CurrentVersion\Windows Messaging Subsystem\Profiles\*\63c73641093d11d6a97400b0d0529047\Settings\'
Value='myTimeZonesVer'>
</Action>
</Registry>
</Update>

F.3.13 Oracle Connector for Outlook Using the Remote Installer

The Remote Installer is a method whereby organizations without an established mechanism for delivering new software (such as Active Directory) can deploy Oracle Connector for Outlook. The method entails the extraction of an executable, known as the Remote Installer, from the Oracle Connector for Outlook package. The Remote Installer can then be distributed to users via the Web, FTP, or e-mail.

Note: Users must have administrative rights on their computers in order to use the Remote Installer.

Using the Remote Installer, you can configure the information regarding where the Oracle Connector for Outlook installation package is stored on a Web server, FTP site, or shared network location. When users double-click the Remote Installer, the Oracle Connector for Outlook package will be downloaded and launched according to the command line you want to use.

You can also configure the Remote Installer to install Oracle Connector for Outlook with or without user participation, and to use a command option calling a remote initialization (INI) file. No user-side configuration is required after an upgrade or a full installation, as long as the remote initialization file is properly configured.

F.3.13.1 Extracting the Remote Installer from the Oracle Connector for Outlook Package

To extract the distributed executable known as the Remote Installer, use the following command:

con_outlook_1013.exe /admin image=doubleclick trans=path_to_INI_file

In the preceding command, path_to_INI_file represents the absolute path, or the exact location, to the remote initialization file. For example:

C:\Program Files\Connector\initialization.ini

F.3.13.2 Configuring the Remote Initialization File

In the AutoUpdate section, you can specify the settings you want to use to install the application. These settings include whether the user will be prompted to install Oracle Connector for Outlook. The AutoUpdate section in the initialization file should be specified with the following parameters:

Table F-25 Parameters for Configuring the AutoUpdate Section in the Remote Initialization File

Parameter	Description	Accepted Values	Default Value
ServerURL	Specify the location where the Oracle Connector for Outlook packages are located. This can be a shared network location, an HTTP Web server, an FTP server, or a UNC network shared drive.	For an HTTP Web server or an FTP server, the string should begin with "http" or "ftp" and terminate with a slash mark (/). For a UNC network shared drive, the string should begin with "unc" and two backslashes (\\) and terminate with a backslash (\).	No default
ProxyConnection	Specify if the client requires a proxy to connect to the location. Note: The parameters ProxyAddress and ProxyPort are also used when the value is set to 2. See also: ProxyAddress and ProxyPort	0 (no proxy is needed) 1 (the browser proxy settings are used) 2 (manual settings are used)	0
ProxyAddress	Specify the proxy URL if manual proxy settings will be used. Set this parameter if the client requires proxy to connect to the location. When this parameter is set, the ProxyConnection parameter needs to be set to 2.	The string specifying the proxy URL	No default
ProxyPort	Specify the port number the proxy should use. Set this parameter if the client requires a proxy to connect to the location. When this parameter is set, the ProxyConnection parameter needs to be set to 2.	A valid port number	No default
AutomaticInstall	Set to 0 to notify users before installing updates. Set to 1 to automatically install updates — users are not prompted. The executable is automatically downloaded and launched.	0 (Prompt) 1 (No prompt)	0
Command	Specify the command line to pass to the installation package. This can include any installation command line option. Note: If you want to use a command line option which needs an initialization file, you need to store the initialization file in the same location where the Oracle Connector for Outlook package is stored and specify %s in the command line. For example: /s %s	A valid command line.	No default
exeName	Specify the Oracle Connector for Outlook package names stored in the con_outlook.msi parameter. For example: exeName=con_outlook_1013.exe	The correct package names.	No default
iniName	Specify the name of the initialization file stored in the parameter con_outlook.msi. For example: iniName=con_outlook_silent_1013.ini	The correct INI file name.	No default

Sample AutoUpdate Section in the Remote Initialization File

The following excerpt from the [AutoUpdate] section of the remote initialization file shows the parameters and values used for creating the Remote Installer:

[AutoUpdate]

ServerURL=http://connector.ca.oracle.com/WEBSITE/Update1/

ProxyConnection=0
ProxyAddress=http://internal.mycompany.com/Connector/
ProxyPort=80

AutomaticInstall=1
Command=/s %s

exeName=con_outlook_1013.exe
iniName=con_outlook_silent_1013.ini

F.4 Installing Oracle Records Management Add-In for Outlook

This section contains the following topics:

• Section F.4.1, "System Requirements"

• Section F.4.2, "Preinstallation Requirements"

• Section F.4.3, "Installing Oracle Records Management Add-In for Outlook"

• Section F.4.4, "Modifying the Selection of Installed Languages in Oracle Records Management Add-In for Outlook"

F.4.1 System Requirements

Table F-26 lists the system requirements for installing Oracle Records Management Add-In for Outlook.

Table F-26 System Requirements for Oracle Records Management Add-In for Outlook

Item	Requirement
Operating Systems	Microsoft Windows 2000 Microsoft Windows XP Home or Professional Notes Administrative privileges are required to install Oracle Records Management Add-In for Outlook. Windows XP Service Pack 1 is required, but Oracle recommends Windows XP Service Pack 2.
Disk Space	Approximately 10 MB of free disk space are required to install Oracle Records Management Add-In for Outlook. Additional disk space may be required for .NET installation requirements.
RAM	Refer to the RAM requirements of your Microsoft Outlook client.
Microsoft Outlook	Microsoft Outlook 2000 Microsoft Outlook 2002 Microsoft Outlook 2003 Note: A native language version or Multilingual User Interface Pack (MUI) is required for non-English version localization. Refer to Table F-27 for a list of supported languages.
.NET Framework	Microsoft .NET Framework 1.1 or higher is required in order to to install Oracle Records Management Add-In for Outlook.

F.4.2 Preinstallation Requirements

Before installing Oracle Records Management Add-In for Outlook, verify that the following requirements are met:

• A supported Microsoft Outlook version installed on a supported platform

• Administrative privileges for installing Oracle Records Management Add-In for Outlook on Microsoft Windows 2000 and XP

F.4.3 Installing Oracle Records Management Add-In for Outlook

Note: If you upgrade your Microsoft Outlook installation, then you must reinstall Oracle Records Management Add-In for Outlook.

Perform the following steps to install Oracle Records Management Add-In for Outlook:

1. Exit all Microsoft Windows applications.

2. Double-click the rec_manager_outlook_10xx.exe file to start the InstallShield Wizard.

3. Click Next on the Welcome screen of the InstallShield Wizard.

4. Enter your name in the User Name field and your company name in the Organization field. Click Next.

5. Click Next to install in the default folder. To install Oracle Records Management Add-In for Outlook in a different folder, click Change and navigate to that folder.

6. Select the languages you want to install. You can also add more languages after the installation.

   For information on how to modify the languages, refer to Section F.4.4.

7. You can choose to enter the records management server and account information in the proper fields. Click Next.

8. To review the information you entered in previous screens, click Back. Otherwise, click Install.

9. Click Finish.

10. If you do not have .NET Framework installed, an option to install is displayed.

F.4.4 Modifying the Selection of Installed Languages in Oracle Records Management Add-In for Outlook

To modify the language settings of Oracle Records Management Add-In for Outlook, perform one of the following tasks:

• Run rec_manager_outlook_10xx.exe or rma_outlook.msi. Select Modify in the Program Maintenance screen.

• Double-click Add or Remove Programs in the Control Panel. Click Change. Select Modify from the Program Maintenance screen.

Table F-27 lists the languages Records Management Add-In for Outlook and their ID numbers.

Table F-27 Languages Records Management Add-In for Outlook

Language Name	ID Number
English US	1033
Chinese (Simplified)	2052
Chinese (Traditional)	1028
Czech	1029
Danish	1030
Dutch (Netherlands)	1043
Finnish	1035
French	1036
German	1031
Greek	1032
Hungarian	1038
Italian	1040
Japanese	1041
Korean	1042
Norwegian	1044
Polish	1045
Portuguese (Brazil)	1046
Portuguese (Portugal)	2070
Romanian	1048
Russian	1049
Spanish	1034
Swedish	1053
Turkish	1055

F.5 Installing Oracle Real-Time Collaboration Clients

This section contains the following topics:

• Section F.5.1, "System Requirements for Oracle Real-Time Collaboration Clients"

• Section F.5.2, "Installing the Oracle Web Conferencing Client"

• Section F.5.3, "Installing the RTC Messenger Client"

F.5.1 System Requirements for Oracle Real-Time Collaboration Clients

Table F-28 lists the system requirements for installing Oracle Real-Time Collaboration Clients on various Microsoft Windows platforms.

Table F-28 System Requirements for Installing Oracle Real-Time Collaboration Client

Item	Requirement
Operating Systems	Microsoft Windows 98 Microsoft Windows NT 4.0 Microsoft Windows 2000 Microsoft Windows XP
Privileges	You must have administrative privileges on your computer to install Real-Time Collaboration clients.
Screen Resolution	1024 x 768 pixels (required for Web Conferencing only)
Browser	Any one of the followings: Internet Explorer 5.5 or later Netscape 4.75 or later Mozilla 1.0 or later Firefox 1.1 or later Notes: All listed browsers can perform tasks in the Real-Time Collaboration Web Application pages, and use the conference whiteboard and desktop sharing features. Netscape 4.X browsers (prior to Netscape 4.75) can use most Web Application features, but they cannot use the Schedule tab to schedule a conference. Only Internet Explorer 5.5 browser or later can share documents in document presentation mode, stream voice data in a conference over PSTN, or play back a recorded conference. For this, JVM must be installed and enabled.
Java Virtual Machine	Microsoft JVM 1.1.4 build 3740 or later Sun JVM 1.3.1 or later

F.5.2 Installing the Oracle Web Conferencing Client

To install the Oracle Web Conferencing client:

1. Uninstall previous Oracle Web Conferencing clients. Select Add or Remove Programs from the Microsoft Windows Control panel and remove the previous Oracle Web Conferencing client versions.

2. Open the Real-Time Collaboration Web Application page and click Home.

3. Click New User.

4. Click the Download icon that is displayed next to Web Conferencing.

5. Follow the on-screen instructions to install the Oracle Web Conferencing client.

F.5.3 Installing the RTC Messenger Client

To install the RTC Messenger client:

1. Uninstall previous Oracle Web Conferencing clients. Select Add or Remove Programs from the Microsoft Windows Control panel and remove the previous Oracle Web Conferencing client versions.

2. Open the Real-Time Collaboration Web Application page and click Login.

3. Enter your Single Sign-on login and password.

4. Click Download RTC Messenger.

5. Click the Download icon that is displayed next to the Oracle RTC Messenger.

6. Follow the instructions on the screen to install the RTC Messenger client. After successful installation of the RTC Messenger client, you will be prompted to sign in.

7. Enter your Single Sign-on login and password, and click OK to start the RTC Messenger.