Oracle® Collaboration Suite Installation Guide 10g Release 1 (10.1.2) for AIX 5L Based Systems (64-Bit) Part Number B25471-10 |
|
|
View PDF |
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.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"
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.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.
This section discusses the installation of the Oracle Calendar desktop client for Linux, Macintosh, Solaris, and Windows platforms. It contains the following topics:
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:
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:
|
To install the Oracle Calendar desktop client for Linux:
Unpack the distribution archive in a temporary directory, as follows:
gtar zxvf /tmp/cal_linux_1012.tar.gz
Change to the OracleCalendar_inst
directory, as follows:
cd OracleCalendar_inst
To install using a full graphical interface, run gui_install.sh
.
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
Unpack the distribution archive in a temporary directory, as follows:
gtar zxvf /tmp/cal_linux_1012.tar.gz
Create the directory OracleCalendar_inst
.
Change to the OracleCalendar_inst
directory, as follows:
cd OracleCalendar_inst
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
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:
|
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. |
Double-click cal_mac_OSX_1012x.dmg
. The Oracle Calendar mounted disk appears.
Double-click the Oracle Calendar mounted disk icon.
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. |
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:
|
To install the Oracle Calendar desktop client on Solaris:
Unpack the distribution archive in to a temporary directory, as follows:
gtar zxvf /tmp/cal_solaris_1012.tar.gz
Change to the OracleCalendar_inst
directory, as follows:
cd OracleCalendar_inst
To install using the graphical interface, run gui_install.sh
. To install using a text mode interface, run text_install.sh
.
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
Unpack the distribution archive in a temporary directory, as follows:
gtar zxvf /tmp/cal_solaris_1012.tar.gz
Create the directory OracleCalendar_inst
.
Change to the OracleCalendar_inst
directory, as follows:
cd OracleCalendar_inst
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
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 |
|
Disk Space |
50 MB |
RAM |
128 MB minimum 256 MB recommended |
Calendar Servers |
One of the following:
|
To Install the Oracle Calendar desktop client for Windows:
Log in with administrative privileges if you are installing on Windows 2000 or XP.
Double-click cal_win_1012.exe
.
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 |
---|---|
|
This option extracts installation package files in silent mode. |
|
This option passes command-line options and values to the Microsoft installer ( |
|
This option specifies a completely silent installation with no user interface. |
|
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:
|
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 |
---|---|
|
This file is the main installer package that runs in the MSI installer engine. |
|
This file contains the InstallShield setup scripts. It is the InstallShield wrapper that runs the MSI installer engine with the |
|
This is a template file for user preferences. |
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:
Performing an Advertised Installation of the Oracle Calendar Desktop Client for Windows
Deploying the Oracle Calendar Desktop Client for Windows Package Using Group Policy
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 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. |
This section discusses the installation of Oracle Calendar Sync for Palm and Oracle Calendar Sync for Pocket PC. It contains the following topics:
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
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 |
|
Disk Space |
10 MB |
RAM |
8 MB minimum 64 MB recommended |
Calendar Servers |
One of the following:
|
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.
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.
|
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.
Remove the Oracle Calendar Sync application (also known as CS Setup) from your Palm organizer.
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:
Double-click cal_syncpalm_macOSX_904211.dmg
. This creates the Oracle Calendar Sync installer.
Double-click the OracleSync Installer mounted disk icon.
Double-click OracleSync Installer.
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:
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.
Delete the com.palm.Desktop.plist
file located at /Users/
your_user_name
/Library/Preferences.
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
Start HotSync Manager. You will be prompted for a user name.
Enter your user name and any other necessary HotSync information.
Close HotSync Manager, and perform a HotSync.
This section contains the following topics:
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 |
|
Disk Space |
75 MB |
RAM |
128 MB |
Calendar Servers |
|
Software |
Palm Desktop
Microsoft .NET
|
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.
|
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.
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.
Run the cal_syncpalm_win_1012.exe
file provided with the distribution package and follow the InstallShield instructions on the screen.
Select an installation type, Complete or Custom.
Notes:
|
Enter the following Sign In settings in the Synchronization Settings dialog box:
User: Enter the user name.
Password: Enter your password.
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. |
Node: Most server configurations do not require you to specify a node. However, if synchronization fails, view the message log.
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:
To display the Custom dialog box, select Custom from the HotSync Manager menu.
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.
This section includes the following topics:
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 |
|
Disk Space |
75 MB |
RAM |
128 MB |
Calendar Servers |
|
Pocket PC |
Pocket PC devices with any of the following processors:
|
Software |
ActiveSync
Microsoft .NET
|
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.
|
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:
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.
Verify that ActiveSync is installed on your computer.
Run the cal_syncppc_win_1012.exe
file provided with the distribution package and follow the InstallShield instructions on the screen.
Select an installation type, Complete or Custom.
Note:
|
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. |
Follow the remaining instructions on the screen to complete the installation.
Check your mobile device screen for any additional steps required to complete the installation.
Enter the following Sign In settings in the Synchronization Settings dialog box:
User: Enter your user name.
Password: Enter your password.
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. |
Node: Most server configurations do not require you to specify a node. However, if synchronization fails, view the message log.
Synchronize your device. The ActiveSync Partnership Wizard starts.
Follow the on-screen instructions to create a new ActiveSync Partnership.
From the lists, select Oracle Calendar as your personal information manager for the Calendar, Contacts, and Tasks conduits.
Open Microsoft ActiveSync if it does not open automatically.
Click Sync if synchronization is not automatically initiated. The first time you synchronize, a full synchronization occurs.
From the Microsoft ActiveSync dialog box, click Options.
Select the Schedule tab in the Options dialog box.
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. |
This section contains the following topics:
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.9, "Modifying, Repairing, or Removing Oracle Connector for Outlook"
Section F.2.10, "Troubleshooting an Oracle Connector for Outlook Installation"
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 |
|
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 |
|
Calendar Servers |
Oracle Calendar server 9.0.3.x and above |
E-mail Servers |
Note: Reference IMAP4 implementations of CMU Cyrus and University of Washington. |
Conduits for PDA Synchronization |
|
Devices |
The following devices are certified with Oracle Connector for Outlook. Similar devices may work, but the user experience may vary. Pocket PC
Palm
Blackberry
|
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. |
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
Exit all Microsoft Windows applications.
Double-click the con_outlook_1012x.exe
file to start the InstallShield Wizard.
Click Next on the Welcome screen of the InstallShield Wizard.
Enter your name in the User Name field and your company name in the Organization field. Click Next.
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.
Select the languages you want to install.
You can also add more languages after the installation.
To review the information you entered in previous screens, click Back. Otherwise, click Install.
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. |
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:
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
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.
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 |
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 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
|
/log |
Troubleshoot an installation
When you install Oracle Connector for Outlook using the |
path_to_log_file |
/admin |
Extract the MSI installation package
Extract the The following arguments can be passed with the image=msiExtracts the image=cdExtracts the trans=path_to_INI_fileCan be used with Used with the The created transforms change the SILENTINIPATH public property of the original Note: The variable |
image=msi
|
Notes:
|
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.
This section describes how to install Oracle Connector for Outlook using the con_outlook.msi
package. It contains the following topics:
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
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 hecon_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.
Option | Description | Accepted Arguments |
---|---|---|
/i |
Install or upgrade
Install or upgrade Oracle Connector for Outlook from the Notes:
msiexec /i "con_outlook.msi" |
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 |
/l |
Generate a log file
When you install Oracle Connector for Outlook using |
path_to_log_file |
/qn |
Install in silent mode
Install Oracle Connector for Outlook in silent mode using the 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= path_to_INI_file |
/x | Uninstall
Uninstall Oracle Connector for Outlook using the |
Product code of Oracle Connector for Outlook |
Notes:
|
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. |
As an administrator, you can use one of the following methods to enable non-administrative users to install Oracle Connector for Outlook:
Performing an Advertised Installation of Oracle Connector for Outlook
Deploying the Oracle Connector for Outlook Package Using Group Policy With Active Directory
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 theAlwaysInstalledElevated registry entry:
|
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:
|
From the Start menu, select Programs, Administrative Tools, then Active Directory Users and Computers.
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.)
Right-click the organization unit node in the navigation tree.
From the shortcut menu, select Properties.
Select the Group Policy tab.
To add a new group policy, click Add. To edit an existing group policy, click Edit.
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.
Expand the Software Settings folder located under Computer Configuration.
Right-click Software installation, select New, and then Package.
Browse to the location where you extracted con_outlook.msi and select this file.
Select the Advanced option to customize your installation with transforms. Otherwise, select Assigned. Click OK.
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. |
Click OK in the Properties dialog box.
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. |
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.
Notes:
|
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:
|
This section describes how to configure Oracle Connector for Outlook using the ocprofwiz.exe
utility. It contains the following topics:
ocprofwiz.exe /s path_to_PRF_file ocprofwiz.exe /L language_id ocprofwiz /d ocprofwiz /p ocprofwiz /p /l language_id
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. |
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 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 |
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 |
path_to_PRF_file |
Notes:
|
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
The configuration wizard can be launched in three different modes:
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:
Close Microsoft Outlook before starting the configuration wizard.
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.
From the Welcome screen, click Next.
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.
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. |
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:
Close Microsoft Outlook before starting the configuration wizard.
Enter /p
at the command line. For example:
ocprofwiz.exe /p
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.
Enter the name and location of the new PRF file under Destination File.
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:
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.
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 |
---|---|
|
|
|
|
|
|
Overwrite existing profile with the same name. |
|
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. |
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:
|
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.
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 |
---|---|---|---|
|
Specify the name of the user Oracle Connector for Outlook is registered to. |
A string specifying a user name. |
No default |
|
Specify the name of the company who has purchased the software license. |
A string specifying a company name. |
No default |
|
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
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 |
---|---|---|---|
|
Set to 1 to force the computer to restart after the installation. |
0 1 |
0 |
|
Set to 1 to prevent the user from saving a password. |
0 1 |
0 |
|
Set to 1 to hide the Change password menu item from the user. |
0 1 |
0 |
|
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 1 2 3 |
0 |
|
Set to 1 to remove the Oracle Connector Configuration Wizard shortcut from the desktop. |
0 1 |
0 |
|
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
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 |
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 |
---|---|---|---|
|
Specify the absolute path of the PRF file. |
A string specifying the location. |
No default |
|
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
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.
You can modify, repair, or remove an Oracle Connector for Outlook installation using the InstallShield wizard. This section discusses the following topics:
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.
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. |
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.
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 |
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.
This section contains the following topics:
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.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"
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 |
Notes
|
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 |
|
Calendar Servers |
Oracle Calendar server 9.0.4.x and above |
E-mail Servers |
Note: Reference IMAP4 implementations of CMU Cyrus and University of Washington. |
Conduits for PDA Synchronization |
|
Devices |
The following devices are certified with Oracle Connector for Outlook. Similar devices may work, but the user experience may vary. Pocket PC
Palm
Blackberry
|
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:
|
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. |
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:
Exit all Microsoft Windows applications.
Double-click the con_outlook_1013.exe
file to start the InstallShield Wizard.
Click Next on the Welcome screen of the InstallShield Wizard.
Enter your name in the User Name field and your company name in the Organization field. Click Next.
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.
Select the languages you want to install.
You can also add more languages after the installation.
To review the information you entered in previous screens, click Back. Otherwise, click Install.
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. |
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
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
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.
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 |
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 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 Note: Only the |
UI=1
|
/log |
Troubleshoot an installation
When you install Oracle Connector for Outlook using the |
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 image=msiExtracts the installation package to a single file, 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 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 The created transforms change the SILENTINIPATH public property of the original Note: The variable Used with the |
image=msi
|
Notes:
|
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.
This section describes how to install Oracle Connector for Outlook using the con_outlook.msi
package. It contains the following topics:
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
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 hecon_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.
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 |
/i |
Install or upgrade
Install or upgrade Oracle Connector for Outlook from the Notes:
|
TRANSFORMS=: setup_language
|
/l |
Generate a log file
When you install Oracle Connector for Outlook using |
path_to_log_file |
/qn |
Install in silent mode
Install Oracle Connector for Outlook in silent mode using the 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= path_to_INI_file |
/x | Uninstall
Uninstall Oracle Connector for Outlook using the |
Product code of Oracle Connector for Outlook |
Notes:
|
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. |
As an administrator, you can use one of the following methods to enable non-administrative users to install Oracle Connector for Outlook:
Performing an Advertised Installation of Oracle Connector for Outlook
Deploying the Oracle Connector for Outlook Package Using Group Policy With Active Directory
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 theAlwaysInstalledElevated registry entry:
|
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:
|
From the Start menu, select Programs, Administrative Tools, then Active Directory Users and Computers.
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.)
Right-click the organization unit node in the navigation tree.
From the shortcut menu, select Properties.
Select the Group Policy tab.
To add a new group policy, click Add. To edit an existing group policy, click Edit.
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.
Expand the Software Settings folder located under Computer Configuration.
Right-click Software installation, select New, and then Package.
Browse to the location where you extracted con_outlook.msi and select this file.
Select the Advanced option to customize your installation with transforms. Otherwise, select Assigned. Click OK.
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. |
Click OK in the Properties dialog box.
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. |
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.
Notes:
|
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:
|
This section describes how to configure Oracle Connector for Outlook using the ocfoprofwiz.exe
utility. It contains the following topics:
ocfoprofwiz.exe /s path_to_PRF_file ocfoprofwiz.exe /L language_id ocfoprofwiz /d ocfoprofwiz /p ocfoprofwiz /p /l language_id
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. |
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 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 |
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 |
path_to_PRF_file |
Notes:
|
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
The configuration wizard can be launched in three different modes:
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:
Close Microsoft Outlook before starting the configuration wizard.
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.
From the Welcome screen, click Next.
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.
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. |
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:
Close Microsoft Outlook before starting the configuration wizard.
Enter /p
at the command line. For example:
ocfoprofwiz.exe /p
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.
Enter the name and location of the new PRF file under Destination File.
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:
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.
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 |
---|---|
|
|
|
|
|
|
Overwrite existing profile with the same name. |
|
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. |
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:
|
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.
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 |
---|---|---|---|
|
Specify the name of the user Oracle Connector for Outlook is registered to. |
A string specifying a user name. |
No default |
|
Specify the name of the company who has purchased the software license. |
A string specifying a company name. |
No default |
|
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
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 |
---|---|---|---|
|
Set to 1 to force the computer to restart after the installation. |
0 1 |
0 |
|
Set to 1 to prevent the user from saving a password. |
0 1 |
0 |
|
Set to 1 to hide the Change password menu item from the user. |
0 1 |
0 |
|
Set to 1 to remove the Oracle Connector Configuration Wizard shortcut from the desktop. |
0 1 |
0 |
|
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
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 |
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 |
---|---|---|---|
|
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
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 |
---|---|---|---|
|
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 |
|
Specify if the client requires a proxy to connect to the location. Note: The parameters See also: |
0 (no proxy is needed, connection is direct) 1 (the browser proxy settings are used) 2 (manual settings are used) |
0 |
|
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 |
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 |
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) |
|
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) |
|
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) |
|
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 See also: |
0 (Disable checking) 1 (Check on Outlook startup) 2 Check on Windows login) 3 (Scheduled check) |
|
ScheduledFrequent |
Specify the time interval for checking for updates. |
0 (Daily) 1 (Weekly) 2 (Monthly) |
|
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. |
|
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) |
|
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) |
|
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) |
|
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) |
|
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
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.
You can modify, repair, or remove an Oracle Connector for Outlook installation using the InstallShield wizard. This section discusses the following topics:
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.
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. |
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.
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 |
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.
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:
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
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 thecon_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.
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. |
<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>
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 |
---|---|---|---|
|
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: |
|
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 |
|
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 |
<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>
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 |
---|---|---|
|
Using a character string, specify what action is to be executed. |
Add Replace Delete |
|
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 (*). |
|
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 < |
Binary DWORD String |
Data |
Using a character string, specify the data type of the registry value. This parameter should only be used when the < |
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 < |
Binary DWORD String |
oldData |
Using a character string, specify the data of the previous registry value. This parameter should only be used when the < |
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>
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>
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.
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
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 |
---|---|---|---|
|
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 |
|
Specify if the client requires a proxy to connect to the location. Note: The parameters See also: |
0 (no proxy is needed) 1 (the browser proxy settings are used) 2 (manual settings are used) |
0 |
|
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 |
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 |
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
This section contains the following topics:
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 |
Notes
|
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 |
|
.NET Framework |
Microsoft .NET Framework 1.1 or higher is required in order to to install Oracle Records Management Add-In for Outlook. |
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
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:
Exit all Microsoft Windows applications.
Double-click the rec_manager_outlook_10xx.exe
file to start the InstallShield Wizard.
Click Next on the Welcome screen of the InstallShield Wizard.
Enter your name in the User Name field and your company name in the Organization field. Click Next.
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.
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.
You can choose to enter the records management server and account information in the proper fields. Click Next.
To review the information you entered in previous screens, click Back. Otherwise, click Install.
Click Finish.
If you do not have .NET Framework installed, an option to install is displayed.
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 |
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"
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 |
|
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:
Notes:
|
Java Virtual Machine |
|
To install the Oracle Web Conferencing client:
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.
Open the Real-Time Collaboration Web Application page and click Home.
Click New User.
Click the Download icon that is displayed next to Web Conferencing.
Follow the on-screen instructions to install the Oracle Web Conferencing client.
To install the RTC Messenger client:
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.
Open the Real-Time Collaboration Web Application page and click Login.
Enter your Single Sign-on login and password.
Click Download RTC Messenger.
Click the Download icon that is displayed next to the Oracle RTC Messenger.
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.
Enter your Single Sign-on login and password, and click OK to start the RTC Messenger.