Oracle® Collaboration Suite Installation Guide 10g Release 1 (10.1.1) for Linux Part Number B15793-02 |
|
|
View PDF |
You might want to install Oracle Collaboration Suite clients on various platforms that can communicate successfully with the servers on which Oracle Collaboration Suite components are installed. This chapter explains the procedure for installing Oracle Collaboration Suite clients on different platforms.
The chapter contains the following sections:
This section discusses the installation of Oracle Calendar clients. It contains the following topics:
Section D.1.1, "Installing the Oracle Calendar Desktop Client"
Section D.3, "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 Windows, Macintosh, Linux, and Solaris platforms. It contains the following topics:
Table D-1 lists the system requirements for installing the Oracle Calendar desktop client on different Linux platforms.
Table D-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_1011.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_1011.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
.
In the directory OracleCalendar_inst/ocal.conf
is a file called silent.properties
which defines where the installation is done. 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 D-2 lists the system requirements for installing the Oracle Calendar desktop client on the Macintosh platform.
Table D-2 System Requirements for Installing the Oracle Calendar Desktop Client for Macintosh
item | Requirement |
---|---|
Operating Systems | Mac OS 10.1.5 to 10.4 |
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_1011.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.The installer extracts the application and copies the Readme.htm file in to the destination folder you select.
The installer also extracts all shared libraries to /Library/CFMSupport.
The installer copies Oracle Calendar Help to /Library/Documentation/Help.
Table D-3 lists the system requirements for installing the Oracle Calendar desktop client on the Solaris platform.
Table D-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_1011.tar.gz
Change to the OracleCalendar_inst
directory, as follows:
cd OracleCalendar_inst
To install using a full 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_1011.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
.
In the directory OracleCalendar_inst/ocal.conf
is a file called silent.properties
which defines where the installation is done. 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
Table D-4 lists the system requirements for installing the Oracle Calendar desktop client on Microsoft Windows platforms.
Table D-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_1011x.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.1.
Installing the Oracle Calendar Desktop Client for Windows in Silent Mode
The Oracle Calendar desktop client for Windows 10.1.1 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 switches and public property values to the Microsoft installer (Msiexec.exe), and the argument for a completely silent installation.
Table D-5 defines the command-line switches that you can use to customize a silent installation.
Table D-5 Command-Line Switches for a Silent Installation of the Oracle Calendar Desktop Client for Windows
Switch | Function |
---|---|
/s |
This parameter extracts installation package files in silent mode. |
/v |
This parameter passes command-line switches and values to the Microsoft installer (Msiexec.exe). |
/qn |
This parameter specifies a completely silent installation with no user interface. |
/qb |
This parameter 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_1011x.exe
in silent mode and pass the command-line switches and values to the Microsoft installer, without any user interface or prompts, enter the following command:
cal_win_1011x.exe /s /v"qn"
Notes:
Command-line switches are not case-sensitive.
For more information on the levels of user interaction available with the Microsoft Windows Installer /q
option, refer to the Microsoft Windows Installer documentation available at
http://msdn.microsoft.com/library/default.asp?url=/library/en-us/msi/setup/command_line_options.asp
The V
switch should always be the last option specified in the command line.
Extracting Installation Package Files in Administrative Mode
To extract the installation package files, run cal_win_1011x.exe
in administrative mode, as follows:
cal_win_1011x.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_1011x.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 D-6 provides definitions for the extracted files.
Table D-6 Files Extracted While Running cal_win_1011x.exe in Administrative Mode
Files | Description |
---|---|
Oracle Calendar.msi |
This file is the main installer package that runs in the MSI installer engine. |
OCal.exe |
This file contains the InstallShield setup scripts. It is the InstallShield wrapper that runs the MSI installer engine with the Oracle Calendar 10.1.1.msi file. This file installs the MSI installer engine if it does not already have the same. |
unison.ini |
This is a template file for user preferences. |
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.
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 D-7 lists the system requirements for installing Oracle Calendar Sync for Palm on Macintosh platforms.
Table D-7 System Requirements for Installing Oracle Calendar Sync for Palm for Macintosh
Item | Requirement |
---|---|
Operating Systems | Mac OS 10.2.x to 10.4.1 |
Disk Space | 5 MB
Note: If the Oracle Calendar desktop client for Macintosh is already installed, 15 MB of disk space is required. |
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 10.1.1 was released. |
Devices | The following devices are certified for compatibility with Oracle Calendar Sync for Palm for Macintosh. Similar devices may also be compatible.
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
To install Oracle Calendar Sync for Palm for Macintosh, perform the following steps:
Run cal_syncpalm_macOSX.hqx
. This creates the Oracle Calendar Sync installer.
Double-click Oracle Calendar Sync Install. The installer first checks for existing Oracle Calendar Sync files and then installs the program. Depending on your setup, this may take several minutes.
Note:
Some error messages might be logged in the install log. You can ignore these messages.Start the HotSync Manager.
From the HotSync menu, choose Conduit Settings. A list of synchronizable items appears.
Select a user name from the User menu (if there is only one user name, it is selected by default).
Choose how you want Oracle Calendar Events and Tasks to be synchronized by double-clicking each item. A dialog box appears with the following choices:
Synchronize the files: Synchronizes all information that exists on both your Palm organizer and on the Oracle Calendar server.
Macintosh overwrites hand-held: Information in your Oracle Calendar Agenda overwrites Events, Tasks, or Addresses on the Palm organizer.
Do Nothing: The specified Entry type is not synchronized.
Note:
Set Calendar, Contacts, and Tasks to Do Nothing if you want to synchronize with the Oracle Calendar server.Exit the Conduit Settings dialog box.
If you already have Calendar Sync software installed on your computer and you have data stored in Palm Desktop, then you must install Oracle Calendar Sync for Palm on your mobile device. Start the HotSync Manager on your desktop computer.
From the HotSync menu on your desktop, select Install Handheld Files.
Select the user from the list in the Install Handheld Files dialog box.
Click Add To List.
From the Applications menu, select Palm and then Add-on.
Click Oracle Calendar Sync.prc.
Click Add file. The file is added to the list.
Close the Install Handheld Files dialog box.
Connect your Palm device to your computer.
From your device, initiate synchronization. Oracle Calendar Sync for Palm is automatically installed on your device. Following a first synchronization, a new application called Oracle Setup appears on your device.
Note:
Before you perform a synchronization, make sure you are not signed in to the Oracle Calendar desktop client.Open Oracle Setup on your Palm organizer and enter your Oracle Calendar server sign-in settings:
User: Enter the user name.
Password: Enter your password.
Server: Enter the domain name or the IP address of your calendar server.
Node: Many server configurations do not require you to specify a node. However, if synchronization fails, view the message log.
Notes:
To synchronize your address book, then you must download the offline files. Sign in to the Oracle Calendar desktop client once before synchronization and download the offline files when prompted.
Before you perform a synchronization, make sure you are not signed in to the Oracle Calendar desktop client.
Before you begin using Oracle Calendar Sync for Palm, verify that your Palm device is set to the correct date. An incorrect date leads to unexpected results when performing a synchronization.
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 D-8 lists the system requirements for installing Oracle Calendar Sync for Palm on Microsoft Windows.
Table D-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_1011.exe
file provided with the distribution package and follow the InstallShield instructions on the screen.
Select an installation type, Complete or Custom.
Notes:
A Complete installation replaces the Date Book, To Do List, and Address conduits to synchronize with Oracle Calendar's Events, Tasks, and Address Book respectively.
In a Custom installation, there is no difference between This feature will be installed on local hard drive and This feature, and all subfeatures, will be installed on local hard drive. Select the conduits you want to install. For example, you can synchronize the Palm Date Book with Oracle Calendar while keeping your existing conduit settings for To Do List and Address so they can synchronize with the Palm desktop.
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 respectively.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 D-9 discusses system requirements for installing Oracle Calendar Sync for Pocket PC on Microsoft Windows.
Table D-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.
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_1011.exe
file provided with the distribution package and follow the InstallShield instructions on the screen.
Select an installation type, Complete or Custom.
Notes:
A Complete installation replaces the Calendar, Tasks, and Contacts conduits to synchronize with Oracle Calendar's Events, Tasks, and Address Book respectively.
In a Custom installation, there is no difference between This feature will be installed on local hard drive and This feature, and all subfeatures, will be installed on local hard drive. Select the conduits you want to install. For example, you can synchronize the Pocket PC Calendar with Oracle Calendar while keeping your existing conduit settings for Tasks and Contacts so they can synchronize with Microsoft Outlook.
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, then Programs, Oracle Calendar Sync for Pocket PC, 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 onscreen 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 D.2.3, "Installing Oracle Connector for Outlook on the Desktop"
Section D.2.4, "Installing Oracle Connector for Outlook in Interactive Mode"
Section D.2.5, "Installing Oracle Connector for Outlook in Silent Mode"
Section D.2.7, "Using the Configuration Wizard to Configure Oracle Connector for Outlook"
Table D-10 lists the system requirements for installing Oracle Connector for Outlook.
Table D-10 System Requirements for Oracle Connector for Outlook
Hardware Component | 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 |
|
E-mail Servers |
|
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 you have the following requirements:
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:
Synchronize your offline folders before upgrading to avoid loss of information.Perform the following steps to install Oracle Connector for Outlook on the desktop:
Exit all Microsoft Windows applications.
Double-click the con_outlook_1011x.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.
For information on how to modify the languages, refer to Section D.2.4.3.
To review your input from the 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, which is selected by default.
Note:
If you have upgraded your Microsoft Outlook installation, then you must reinstall Oracle Connector for Outlook.You can install Oracle Connector for Outlook in interactive or silent mode.
In an interactive installation, the installation wizard guides you through the installation process. Interactive installations can be performed by using either the con_outlook_1011x.exe
file or the con_outlook.msi
package.
To install using the con_outlook.msi
package, extract it from the con_outlook_1011x.exe
file using the /admin
command.
You can extract the con_outlook_msi
package to multiple files or a single file. Use the following command to extract the installation package to multiple files:
con_outlook_1011x.exe/admin image=cd
The multiple files comprise an msi
file, the Oracle Connector for Outlook files, and the .mst
files that contain the transformation for the installation language.
Use the following command to extract the installation package to a single file:
con_outlook_1011x.exe/admin image=msi
The instructions in this section are for a first-time installation. When you run con_outlook_1011x.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.
Follow these steps if you do not have a previous version of Oracle Connector for Outlook installed:
To run the installation wizard in a language other than the language of the operating system of the destination computer, run con_outlook_1011
x
.exe
with the following language command:
con_outlook_1011.exe/Lang {setup_lang_id_no}
x
In the preceding syntax, {setup_lang_id_no}
is the ID number of the language you want to specify for the installation wizard. For example, to run the installation wizard in French, enter the following command:
con_outlook_1011.exe/Lang 1036
x
Note:
You can select the language used to run the installer only for a first-time installation. The installation wizard will run in this language the next time you repair, modify, remove, or upgrade Oracle Connector for Outlook.If you prefer to run the installation directly from the .msi package, enter the following command to apply the appropriate transformation:
msiexec/i "con_outlook.msi" TRANSFORMS=:{setup_lang_id_no}
In the preceding command, setup_lang_id_no
is the ID number of the language that you want to use for the installation. For example, to run the installation wizard in French, enter the following command for the installation package contained in a single file:
msiexec/i "con_outlook.msi" TRANSFORMS=:{setup_lang_id_no}
If the installation package is extracted to multiple files, use the following command to run the installation wizard (French is used in this example):
msiexec/i "con_outlook.msi" TRANSFORMS=:1036.mst
Table D-11 lists the languages supported by Oracle Connector for Outlook and their ID numbers.
Table D-11 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 |
Note:
Configuring a messaging application programming interface (MAPI) profile to be used with Oracle Connector for Outlook is not part of the installation process.You can use the con_outlook_1011x.exe
file or the con_outlook.msi
package to upgrade the existing version of Oracle Connector for Outlook.
To upgrade using con_outlook_1011x.exe
, run con_outlook_1011x.exe
and follow the instructions on the screen.
To upgrade using con_outlook.msi
, use one of the following commands, depending on the version you are upgrading from:
If you are upgrading from version 10.1.1:
msiexec/i "con_outlook.msi" REINSTALL=ALL REINSTALLMODE=vomus
If you are upgrading from version 9.0.4.2.x:
msiexec/i "con_outlook.msi"
Determining the Installation Language for an Upgrade
When you run the con_outlook_1011x.exe
or con_outlook.msi
, the installation language used for the upgrade is determined based on the current version of Oracle Connector for Outlook.
If you are upgrading from Oracle Connector for Outlook 9.0.4.2.x or earlier, the language used in the operating system of the destination computer is detected and the upgrade wizard is started in that language. However, if you are upgrading from Oracle Connector for Outlook 10.1.1 or later, the installation language used is the same as the one used in the first-time installation.
You can modify, repair, or remove Oracle Connector for Outlook installation by using the InstallShield wizard.
Modifying the Selection of Installed Languages in Oracle Connector for Outlook
To modify the language settings of Oracle Connector for Outlook, perform one of the following tasks:
Run con_outlook_1011x.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 Program Maintenance screen.
From the Start menu, select Oracle Connector For Outlook, and then Add or Remove Languages.
Repairing Oracle Connector for Outlook
To repair the Oracle Connector for Outlook installation, perform one of the following tasks:
Run con_outlook_1011x.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.Removing Oracle Connector for Outlook
To remove Oracle Connector for Outlook, perform one of the following tasks:
Run con_outlook_1011x.exe
or con_outlook.msi
. On the Program Maintenance screen, click Remove.
Double-click Add or Remove Programs in the Control Panel. Click Remove.
When you install Oracle Connector for Outlook using con_outlook_1011x.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.
To generate the log file in a different location, enter the following command:
con_outlook_1011x.exe/path
In the preceding command, path
represents the complete path of the log file.
When you install Oracle Connector for Outlook using con_outlook.msi
, enable logging policy or use the /L
option if you are using the msiexec.exe
file.
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.You can install Oracle Connector for Outlook in the silent mode. This mode requires 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.
You can install Oracle Connector for Outlook in silent mode by using the con_outlook_1011x.exe
file or the con_outlook.msi
package.
To install Oracle Connector for Outlook in silent mode using the con_outlook_1011x.exe
file, enter the following command:
con_outlook_1011x.exe /s Path\con_outlook_silent.ini
In the preceding command, Path
represents the absolute path, or the exact location, to the initialization file.
To install Oracle Connector for Outlook in silent mode using the MSI
package, enter the following command:
msiexec /i "con_outlook.msi" /qn Path\con_outlook_silent.ini
In the preceding command, Path
represents the absolute path, or the exact location, to the initialization file.
Example D-1 displays a sample initialization file used for silent installation of 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 have already installed Oracle Connector for Outlook, you can only modify the settings after uninstalling the application.Example D-1 Example of the initialization File for Oracle Connector for Outlook
[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
You can configure the following sections in the initialization file:
In the General section, 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.
The following snippet of the initialization file shows the parameters and values in the General section:
[General] UserName=OCFOUSER Company=ORACLE InstallPath="C:\Program Files\Oracle\Outlook Connector"
The Settings Section
In the Settings section, you can:
Force your computer to restart after the installation by setting the ForceReboot
parameter to 1
.
Disable the option to save your password by setting the DisablePwd
parameter to 1
.
Hide the Change Calendar pwd menu item by setting the HideCalendarPwdMenu
parameter to 1
.
Remove the Oracle Connector Configuration Wizard shortcut from the desktop by setting the NoDesktopShortcut
parameter to 1
.
Disable Control Panel options by setting the DisableCfgUI
parameter to 1
.
Disable specific mail server functions by setting the NoServerMail
parameter to one of the following values:
0
for no restriction (default value)
1
for no IMAP or SMTP
2
for no IMAP
3
for no SMTP
The following excerpt from the initialization file shows the parameters and values 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 D-11 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.
In the OcConfigWizard section, you can specify the path where the PRF file is located. the PRF file contains the user profile information. Oracle Connector for Outlook uses the PRF file to configure user profiles.
The following snippet of the initialization file shows the parameters and values in the OcConfigWizard section:
[OcConfigWizard] Path=c:\MyPrfName.prf
You can 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 using the INI settings in the initialization file.
To maintain visual feedback during silent installations, enter the following command:
con_outlook_1011x.exe/s UI=value path
In the preceding command, value
represents the UI
parameter value and path
represents the complete path to the initialization file.
Table D-12 lists the UI
parameter values for configuring visual feedback.
Table D-12 UI Parameter Values for Configuring Visual Feedback
UI Parameter Values | Visual Feedback |
---|---|
1 |
There is no UI, except for a single dialog box at the end of the installation, indicating that the installation was successful. |
2 |
A basic UI is provided. |
3 |
A basic UI 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. |
To uninstall Oracle Connector for Outlook in silent mode, enter the following command:
Msiexec.exe /x {0AF6C5A4-E29B-4D1E-B6FF-D73F4FBB44DA} /qn
The preceding command passes the necessary command-line switches and values 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 the command, /x
instructs the Microsoft installer to uninstall Oracle Connector for Outlook, whose product code is specified in the brackets {}
and /qn
specifies a completely silent mode.
As an administrator, you can use one of the following methods to enable 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
When using one of these methods, you must use the MSI package included with con_outlook_1011x.exe
.
By setting the AlwaysInstalledElevated
policy on the user's computer, you give users appropriate installation privileges to install Oracle Connector for Outlook. However, setting this policy can expose the user's computer to security risks because this method enables the user to access secure locations on the computer.
To configure elevated installation privileges, set the AlwaysInstallElevated
value to 1
under the following key in the registry:
HKEY_LOCAL_MACHINE\Software\Policies\Microsoft\Windows\Installer
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. The user will still be able to repair the Oracle Connector for Outlook installation with elevated privileges.
When advertising an installation of Oracle Connector for Outlook on a user's computer, Oracle Connector for Outlook 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 Oracle Connector for Outlook on the 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
When you run this command, the Oracle Connector Configuration Wizard option will be available from the Oracle Connector For Outlook program submenu. You can then run the installation with elevated privileges by selecting this shortcut.
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 Connector for Outlook on the local computer by assigning the con_outlook.msi
package to users' computers through Active Directory and Group Policy.
Assigning Oracle Connector for Outlook
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 the computer of the user 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.
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. Users can also repair their installation of Oracle Connector for Outlook, but only an administrator can permanently remove the application.
Applying a Transform to Oracle Connector for Outlook
When you use 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 a network location.
The structure of the initialization file is the same as the one used for the silent installation.
See Also:
Section D.2.5.2 for more information on configuring initialization files.You can create a transform by using a third-party application like Orca, InstallShield, or Wise Solutions. You can also specify the trans
parameter with the admin
switch when you extract the con_outlook.msi
package with the following command:
con_outlook_1011x.exe/admin image=cd trans=INI_path
In the preceding command, INI_path
represents the actual path to the initialization file.
This command creates a transform called silent.msi
along with the other language transforms. If the image=msi
parameter is used instead, an embedded transform called silent
is created.
See Also:
Refer to the following URL for a step-by-step guide to software installation and maintenancehttp://www.microsoft.com/windows2000/techinfo/planning/management/swinstall.asp
The configuration wizard is a standalone application that can be started from the command prompt or from Windows Explorer. The configuration wizard is useful for both administrators and end users because it integrates the creation and configuration of PRF files and profiles.
The following list describes various uses of the configuration wizard:
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 a user, you can use the configuration wizard to modify profile settings. You can use the template PRF file distributed by the administrator for this purpose.
The configuration wizard only works with Oracle Connector for Outlook settings. 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 invoke the configuration wizard a second time, the instance previously started will be displayed in the foreground.
The configuration wizard can be invoked in three different modes:
The interactive profile creation and configuration mode is the default mode. You can use this mode to specify settings and create or modify a profile.
Use the following command-line options to configure the configuration wizard:
Enter L
(not case-sensitive) at the command line to specify the language of the configuration wizard. The language that you specify must be installed during the installation of Oracle Connector for Outlook. For example, to run the configuration wizard in German, use the following command:
ocprofwiz -L 1031
Enter D
(not case-sensitive) at the command line to ensure that Set as Default Profile is selected by default on the final screen of the configuration wizard. The command to do so is:
ocprofwiz -D
Close Microsoft Outlook before starting the configuration wizard. 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.
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. 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. To configure advanced settings, click More Settings. 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.
In the interactive PRF file creation mode, administrators can create a PRF file by starting with a blank template, or importing information from an existing profile or PRF file.
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.
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 Outlook Address Book information in the Service List section is added to the output PRF file, depending on the source template used. In the profile template, where information is imported from an existing profile, it depends on whether or not the profile has 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.
You can configure interactive PRF file creation with the following command-line switches:
Enter P
(not case-sensitive) at the command line to run the configuration wizard in the interactive PRF file creation mode, as follows.
ocprofwiz -P
Use the L
(not case-sensitive) switch at the command line to specify the language. For example, to run the configuration wizard in the german language, use the following command:
ocprofwiz -P -L 1031
The language you specify must have been installed during the installation of Oracle Connector for Outlook.
Before you start the configuration wizard, close Microsoft Outlook. In the PRF Configuration Settings screen, specify the source template for the PRF file and the location where you want to save the new PRF file.
If you select Empty PRF File as the source template, you must manually specify the settings. If you select Existing PRF File as the source template, initial settings information is imported from the source PRF file. If you select the MAPI profile to import settings from an existing profile, initial settings information is imported from the source profile.
In the Profile Options screen, configure the settings for the General section of the new PRF file. The following parameters show the relationship between the fields in the Profile Options screen and the settings in the General section of the PRF file:
ProfileName: Profile Name
DefaultStore: Default Store
DefaultProfile=Yes/No: Use this profile as the default MAPI profile.
Overwrite Profile=Yes/No: Overwrite existing profile with the same name.
You can view or modify Oracle Connector for Outlook settings in the Service Settings screen. To configure advanced settings, click More Settings. The Oracle Connector for Outlook settings information will be saved to the new PRF file. In the Congratulations screen, if View PRF file is selected, then the wizard displays the newly created PRF file. You can then verify the information or modify parameters in the PRF file.
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.
The Outlook Address Book service is imported in to the profile if it is listed in the Service List section. (Limited support is also available for some other types of message services.)
To run the configuration wizard in silent profile creation mode, use the S
(not case-sensitive) switch at the command line, as follows:
ocprofwiz -S "C:\Program Files\Oracle\Outlook Connector\source.prf"
When Oracle Connector for Outlook is configured in silent mode, a log file is created to record success and error information. This log file is stored in a temporary folder on the computer. For example:
C:\Documents and Settings\user\Local Settings\Temp\ocfoConfigWizardLog\ocfoConfigWizard.log
In the preceding command, user
represents the login name of the local user.
Notes:
If you are configuring Oracle Connector for Outlook in silent mode, then you must check the log file to verify the results. Both, successful imports of information in to the profile and errors is recorded in the log file.
The configuration wizard may write some information to the log file in interactive profile creation and configuration mode and interactive PRF file creation mode. Usually, high-level warning messages are displayed and low-level technical information is recorded in the log file.
We recommend 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.
This section contains the following topics:
Section D.3.1, "System Requirements for Oracle Real-Time Collaboration Clients"
Section D.3.2, "Installing the Oracle Web Conferencing Client"
Table D-13 lists the system requirements for installing Oracle Real-Time Collaboration Clients on various Microsoft Windows platforms.
Table D-13 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 onscreen 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.