Oracle® Beehive Installation Guide Release 2 (2.0.1.8) for Linux x86 Part Number E16641-07 |
|
|
PDF · Mobi · ePub |
This chapter describes how to install and configure Oracle Beehive Extensions for Outlook.
Oracle recommends that you install and deploy Oracle Beehive Extensions for Outlook using Oracle Beehive's Device Management Service (DMS). This installation method is recommended for almost all desktops with standard environments and administrative privileges. A desktop based, non-DMS installation, deployment, and configuration method is available for custom environments and lockdown systems with limited administrative privileges. Locked down users may also install Oracle Beehive Extensions for Outlook using an Active Directory group policy.
This chapter covers the following topics:
Installing Oracle Beehive Extensions for Outlook Using Active Directory
Using Oracle Beehive Extensions for Outlook as Profile Migration Tool
This section describes the software and hardware requirements for Oracle Beehive Extensions for Outlook. For updated list of certified hardware platforms and operating system version, review the certification matrix on the My Oracle Support Web site at the following URL:
Oracle Beehive Extensions for Outlook supports the following Microsoft® Windows® operating systems, running Microsoft Outlook 2003, 2007, 2010, and 2010 64-bit:
Microsoft Windows XP - Home or ProfessionalMicrosoft Windows 7 (32-bit and 64-bit edition) - Home Premium, Professional, Ultimate or EnterpriseMicrosoft Windows 2003 Server
Microsoft Windows 2008 Server
Microsoft Windows 2008 Server R2
Note:
You need administrative privileges to install Oracle Beehive Extensions for Outlook on Windows XP and Windows 2003 Server.You must install Windows XP Service Pack 2 on Windows XP computers if you intend to use non-English locales with Oracle Beehive Extensions for Outlook. Attempting to run Oracle Beehive Extensions for Outlook with a non-English locale on a computer with Windows XP Service Pack 1 (or earlier) may result in the computer failing to operate normally.
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.
Refer to the RAM requirements of your Microsoft Outlook client.
Microsoft Outlook 2010 (32-bit and 64-bit)
Microsoft Outlook 2007 (with Service Pack 2)
Microsoft Outlook 2003 (with Service Pack 3)
Note:
Oracle certifies and recommends the latest service pack version for Microsoft Outlook. However, other service packs may also work with Oracle Beehive Extensions for Outlook.You must install a native language version or Multilingual User Interface Pack (MUI) for non-English version localization.
Oracle recommends that you install and deploy Oracle Beehive Extensions for Outlook using Oracle Beehive's Device Management Service (DMS). This installation method is recommended for almost all desktops with standard environments and administrative privileges. It is designed for centralized installation, configuration, management of auto-updates, and deployment.
This section covers the following topics:
Installing Oracle Beehive Extensions for Outlook Using Remote Downloader
Updating and Configuring Oracle Beehive Extensions for Outlook Through DMS
Uninstalling and Downgrading Oracle Beehive Extensions for Outlook (DMS Process)
You may install Oracle Beehive Extensions for Outlook by distributing a remote downloader to end users. The remote downloader enables end users to download and install the provisioned Oracle Beehive Extensions for Outlook application from the Device Management Service (DMS) repository. By default, the DMS contains a pre-seeded Oracle Beehive Extensions for Outlook application that is provisioned for all end users.
For more information on how to provision applications for specific users or groups of users, refer to "Managing the Device Management Service" in Oracle Beehive Administrator's Guide. You may do this in silent mode. Refer to "Installing Oracle Beehive Extensions for Outlook Using Remote Downloader Using Silent Mode" for more information.
Obtain the Oracle Beehive Extensions for Outlook remote downloader, outlook_extensions_downloader.exe
in the directory <Oracle Beehive home>
/beehive/bootstrap/obio/downloader
.
You may also obtain the remote downloader from Oracle Beehive Central, a Web-based client that provides users a central location to download supported clients and set their preferences for Oracle Beehive functionality.
Pre-Seeding Server Name in Remote Downloader
The remote downloader prompts the end user to provide a server name, account name, and password to initiate download and installation. If you want to pre-seed a server name to prevent end users from having to specify a server name on their own, rename the remote downloader to <fully qualified server name>
.exe
. For example, if your server name is faulkner.oracle.com
, your remote downloader name would be faulkner.oracle.com.exe
.
You may pre-seed the port number that Oracle Beehive Extensions for Outlook uses to connect to the server.
For example, if your remote downloader name is faulkner.oracle.com.exe
and you want to pre-seed the port number in the downloader, rename the file to faulkner.oracle.com,443.exe
, where 443
is your port number.
Note:
The pre-seeded port number is the port number of the DMS on the server that is used to obtain the settings for direct and HTTPS connections.You may also use the Oracle Beehive Extensions for Outlook downloader to provide a full, non-interactive deployment option. To do so, use the silent switch, /s
.
Specify the required connection parameters through the command line or in an initialization file.
The following is an example of specifying connection parameters through the command line (line breaks have been added for clarity):
outlook_extensions_downloader.exe /server example.com /user OracleBeehiveUserName /direct port=5224 secure=true /https port=443 secure=true /s UI=1
The following table describes the Oracle Beehive Extensions for Outlook downloader's command line options:
Table 25-1 Oracle Beehive Extensions for Outlook Downloader Options
Option | Description |
---|---|
|
Oracle Beehive server address |
|
Oracle Beehive user account |
|
User's password Note: It is recommended that you use the option |
|
Specifies the following for direct connection:
|
|
Specifies the following for HTTPS connection:
|
|
Available in Oracle Beehive Release 1 (1.5.1.2) or later. Determines if an Oracle Beehive Extensions for Outlook profile should be created on the user's computer during installation. This parameter may be assigned one of the following values:
|
|
Specifies the port number of the DMS on the server to obtain the settings for direct and HTTPS connections.By using this option, you do not need to specify either the |
|
Available in Oracle Beehive Release 1 (1.5.1.2) or later. Changes the name of the profile created during installation of Oracle Beehive Extensions for Explorer. The default profile name is |
|
Available in Oracle Beehive Release 1 (1.5.1.2) or later. Downloads and reinstalls the MSI package from the DMS if the installed version on the user's computer is the same version as the MSI package. If |
|
Use silent mode |
Specify the full path of the initialization file you want to use as follows. In this example, C:\testSilentDownloader.ini
is the full path of the initialization file:
outlook_extensions_downloader.exe /s C:\testSilentDownloader.ini
If you use the silent switch with a UI=1
parameter, the connection dialog will be presented in which all the controls are disabled and only the password field is enabled:
outlook_extensions_downloader.exe /s UI=1 C:\testSilentDownloader.ini
The downloader will return a value of 1
or 0
, which indicates whether the operations performed by it failed (1
) or were successful (0
). You may use this returned value in a script to determine whether or not the remote downloader was successful.
Use the following template to create a silent initialization file:
Example 25-1 Template for Silent Initialization File
[General] Server= User= Password= Direct_Port= Direct_Secure= Discover_Port= HTTPS_PORT= HTTPS_Secure= Proxy_Type= Proxy=
The following table describes the silent initialization file's parameters:
Table 25-2 Initialization FIle Parameters
Initialization File Parameter | Description |
---|---|
|
Oracle Beehive server address |
|
Oracle Beehive user account |
|
User's password Note: It is recommended that you use the option |
|
Valid port number to be used to establish a direct connection |
|
Boolean value; specifies whether to use a direct connection (TRUE) or not (FALSE) |
|
Valid port number used to connect to the DMS on the server to obtain the settings for direct and HTTPS connections By using this parameter, you do not need to specify any of the following parameters: |
|
Valid port number to be used to establish an HTTPS connection |
|
Boolean value; specifies whether to use an HTTPS connection (TRUE) or not (FALSE) |
|
Specifies the proxy type. It may have a value of 0, 1, or 2:
|
|
Manual proxy configuration (for example, |
You may update the version of Oracle Beehive Extensions for Outlook in the DMS repository. Afterwards, if Oracle Beehive Extensions for Outlook is running on an end user's computer, it will automatically prompt the end user to download and install updates from the DMS repository.
In addition, end users may also manually search for updates by selecting About Oracle Beehive Extensions for Outlook from the Help menu and clicking Check for Updates.
You may also apply customized configuration settings to end users' computers from the DMS.
The following topics are covered in this section:
Updating Oracle Beehive Extensions for Outlook in DMS Repository
Updating Language Pack for Oracle Beehive Extensions for Outlook
Follow these steps to update the version of Oracle Beehive Extensions for Outlook in the DMS repository:
Enure the application package for the updated version of Oracle Beehive Extensions for Outlook is accessible to the Oracle Beehive server.
Upload the updated version of Oracle Beehive Extensions for Outlook to the DMS repository by running the following command:
beectl upload_client_application
--file <Path to Oracle Beehive Extensions for Outlook zip file>
Note:
This command will upload the new version of the Oracle Beehive Extensions for Outlook application to the DMS repository and will make it available for those who are already provisioned to it.If you have not provisioned Oracle Beehive Extensions for Outlook, run the provisioning commands (such as beectl add_client_application_provisioning
). Refer to "Managing the Device Management Service" in Oracle Beehive Administrator's Guide for more information.
If Oracle Beehive Extensions for Outlook is running on an end user's computer, it will automatically prompt the end user to download and install updates from the DMS repository. The end users may also manually search for updates by selecting About Oracle Beehive Extensions for Outlook from the Help menu and clicking Check for Updates.
You may localize the user interface of Oracle Beehive Extensions for Outlook to match Microsoft Outlook languages by updating the language pack with the one found at <Oracle Beehive home>
/beehive/bootstrap/obio/languagepack
. The following languages are currently supported in the language pack:
French
German
Italian
Spanish
Brazilian Portuguese
Japanese
Korean
Simplified Chinese
Traditional Chinese
To update the language pack for Oracle Beehive Extensions for Outlook, upload it to the DMS repository using the beectl upload_client_application
command. By default, the language pack is uploaded and provisioned to all users. Follow these steps to update the language pack:
Ensure the language pack for Oracle Beehive Extensions for Outlook is accessible to the Oracle Beehive server.
Upload the language pack for Oracle Beehive Extensions for Outlook to the DMS repository by running the following command:
beectl upload_client_application
--file <Path to Oracle Beehive Extensions for Outlook language pack>
If Oracle Beehive Extensions for Outlook is running on an end user's computer, it will automatically prompt the end user to download and install updates (including language packs) from the DMS repository. End users also may manually search for updates by selecting About Oracle Beehive Extensions for Outlook from the Help menu and clicking Check for Updates.
Note:
The language installed by the Oracle Beehive Extensions for Outlook language pack will automatically match the Outlook language installed by the end user, provided that Oracle Beehive Extensions for Outlook supports the language. If the end user has installed Microsoft Outlook in an unsupported language, Oracle Beehive Extensions for Outlook will default to English.When deploying Oracle Beehive Extensions for Outlook from DMS, you may apply customized configuration settings to end users' computers. You may associate the configuration settings to a specific version or all versions of the provisioned Oracle Beehive Extensions for Outlook software. Configuration settings associated with all versions are persistent and are always available regardless of the version of Oracle Beehive Extensions for Outlook provisioned to the user. However, configuration settings associated with a specific version are only applied when users are provisioned to that specific version of the software.
Note:
When settings are applied to the specific version level, if the user is later provisioned to a newer software release, the configurations settings are no longer applied.This section covers the following topics:
Associating Configuration Settings to All Versions of Application
Associating Configuration Settings to Specific Version of Application
Associating Configuration Settings to All Versions of Application
Follow these steps to apply configuration settings at the application level from the DMS:
Create an application package. This is a zip file that contains the following two files:
metadata.xml
: This is an XML provisioning file that includes all the setting parameters you want to apply. Refer to Example 25-2, "Sample metadata.xml XML Provisioning File" for an example.
readme.txt
: This is simply a text file. You may place any content you want in this file.
Upload the application package into the DMS repository with the following command:
beectl upload_client_application --file <path to application package zip file>
Obtain your enterprise EID by running the following command:
beectl list_enterprises --entity_format id
Obtain your application ID by running the command beectl list_client_applications
and looking for "Application Settings for Oracle Beehive Extensions for Outlook" in the generated list. This is what is in the sample metadata.xml
provisioning file.
Provision the new application by running the following command:
beectl add_client_application_provisioning --community <enterprise EID obtained in step 3> --application <application ID obtained in step 4>
Example 25-2 Sample metadata.xml XML Provisioning File
The following is a sample XML provision file. It sets the parameter FILE:profile.ini:GENERAL:GAL-DOWNLOAD-UDS-ON-DEMAND-CACHING-ONLY
to FALSE
:
<?xml version="1.0" encoding="UTF-8"?> <application> <property> <name>Application Settings for Oracle Beehive Extensions for Outlook </name> <description> Oracle Beehive Extensions for Outlook Package Settings </description> <os>Windows_NT</os> <processor>x86</processor> <deviceclass>OUTLOOK-WORKSTATION</deviceclass> <language>ALL</language> <version>1</version> <versionnumber>1</versionnumber> <patchsetnumber>0</patchsetnumber> <vendor>Oracle</vendor> </property> <modules> <module> <name>readme.txt</name> <src>.</src> <dest>/</dest> <contenttype>application/octet-stream</contenttype> </module> </modules> <configuration> <param name="FILE:profile.ini:GENERAL:GAL-DOWNLOAD-UDS-ON-DEMAND-CACHING-ONLY" value="FALSE"></param> </configuration> </application>
Associating Configuration Settings to Specific Version of Application
Follow these steps to apply configuration settings at the specific version level from the DMS:
Create an XML provisioning file that includes all the setting parameters you want to apply. For more information, refer to "Customizing Installation Settings".
Obtain your Oracle Beehive Extensions for Outlook identifier by running the beectl list_client_applications
command and locating the identifier from the generated list.
Obtain your Oracle Beehive Extensions for Outlook version identifier by running the following command:
beectl list_client_application_versions --application <identifier>
<identifier>
is the Oracle Beehive Extensions for Outlook identifier you obtained in the previous step.
Include the obtained Oracle Beehive Extensions for Outlook version identifier in your XML provisioning file. For more information on beectl
commands, see the module "Oracle Beehive Command-Line Utility" in the Oracle Beehive Administrator's Reference Guide.
Upload your XML provisioning file to the server by running the following command:
beectl add_client_application_configuration
--file <path to XML provisioning file>
Provision end users for the uploaded application configuration object by running the following command:
beectl add_client_application_provisioning --community <enterprise ID> --configuration <application configuration ID>
To customize installation settings, create an XML provisioning file with your customized settings as described in "Creating XML Provisioning File to Customize Installation Settings". Once you have uploaded the provisioning file to DMS, you may apply your customized settings to your end users' computers as described in "Applying Configuration Settings from DMS".
This section describes how to create an XML provisioning file and the configuration settings you may customize. It covers the following topics:
You may control general installation settings by creating an XML provisioning file and adding or modifying Property
nodes in the config
section of the file. Each Property
node should contain two parameters: name
and value
.
You may modify the default public properties in your provisioning file by changing the value
parameter associated with any of the INSTALL:
<X>
Property
nodes.
The following is a sample XML provisioning file. To upload a provisioning file to DMS and then apply its settings to end users' computers, refer to "Applying Configuration Settings from DMS".
Example 25-3 Sample XML Provisioning File
<?xml version="1.0" encoding="UTF-8"?> <ClientAppConfig> <Name>Oracle Beehive Extensions for Outlook-test2</Name> <Version CollabId="6EAB:574C:capv:4672A63200D4B462E040548C17821C2E000000014C0A"/> <Config> <!--Install Company name--> <Property name="INSTALL:COMPANYNAME" value="TestCompany"></Property> <!--Install user name --> <Property name="INSTALL:USERNAME" value="Edith Wharton"></Property> <!--Install directory--> <Property name="INSTALL:INSTALLDIR" value="C:\Program Files\Oracle\myinstall"></Property> <!--Allow Downgrade--> <Property name="INSTALL:AllowDowngrade" value="TRUE"></Property> <!--Install Create Profile--> <Property name="INSTALL:CREATE_PROFILE" value="2"></Property> <!--Install Profile Name--> <Property name="INSTALL:PROFILE_NAME" value="OracleBeehive"></Property> <!--Install ForceUpgrade--> <Property name="INSTALL:ForceClientVersion:Larger" value="20201"></Property> <!--Install Grace Period for ForceUpgrade--> <Property name="INSTALL:graceperioddate" value="20080215"></Property> <Property name="INSTALL:graceperioditerations" value="3"></Property> <!--ini File Modification--> <Property name="FILE:Beehive.ini:OBIO:APP-AUTOUPDATE-STARTUP" value="FALSE"></Property> <!--Registry Modification--> <!--ADD Section--> <!--ADD Key--> <Property name="REG:ADD:HKCU\Software\1\2\3:" value=""></Property> <!--ADD String Value (remove line breaks from the value of the name parameter) --> <Property name= "REG:ADD:HKLM\Software\Microsoft\Exchange\Client\Extensions: Outlook Setup Extension1:String" value="4.0;Outxxx.dll;7;00000000000000;0000000;OutXXX"></Property> <!--ADD DWORD Value (remove line breaks from the value of the name parameter) --> <Property name="REG:ADD:HKLM\Software\Microsoft\Exchange\Client\Extensions: Outlook Setup Extension2:DWORD" value="50"></Property> <!--ADD Binary Value (remove line breaks from the value of the name parameter) --> <Property name="REG:ADD:HKLM\Software\Microsoft\Exchange\Client\Extensions: Outlook Setup Extension3:Binary" value="1234567890ABCDEF"></Property> <!--Delete Section--> <!--Delete Key--> <Property name="REG:DELETE:HKCU\Software\1\2" value=""></Property> <!--Delete Value (remove line breaks from the value of the name parameter)--> <Property name= "REG:DELETE:HKLM\Software\Microsoft\Exchange\Client\Extensions: Outlook Setup Extension1" value=""></Property> </Config> </ClientAppConfig>
The following table describes the public properties you may specify in your XML provisioning file:
Property | Function |
---|---|
|
Sets the name of the registered Oracle Beehive Extensions for Outlook end user that appears in the About box. |
|
Sets the name of the registered company that appears in the About box. |
|
Sets the location of the Oracle Beehive Extensions for Outlook installation. |
|
Determines if an Oracle Beehive Extensions for Outlook profile should be created on the user's computer during installation. This parameter may be assigned one of the following values:
|
|
Changes the name of the profile created during installation of Oracle Beehive Extensions for Outlook. The default profile name is |
Note:
The values you set for the first three parameters in the table only apply when you are installing Oracle Beehive Extensions for Outlook for the first time and do not apply to product upgrades.A new feature has been introduced in Oracle Beehive Extensions for Outlook that controls what is initially downloaded in the Global Address List (GAL). By default, the Global Address List of any user with a new or migrated profile initially contains only the logged in user's manager, peers, direct reports, and groups. Additional contacts are downloaded and added to the local Global Address List on an ad-hoc basis whenever the user performs an action that requires a contact lookup against the server (for example, creating or receiving e-mail and creating or receiving meetings). This is referred as the Smart GAL mode.
To disable this behavior, the administrator can push the following configuration parameter through the DMS:
Name: FILE:profile.ini:GENERAL:GAL-DOWNLOAD-UDS-ON-DEMAND-CACHING-ONLY
Value: FALSE
Provision this parameter to users by following the steps described in "Applying Configuration Settings from DMS".
Users do not have to wait till the entire GAL is downloaded.
The initial GAL size is small and it does not take long to download and construct the initial list.
The GAL grows dynamically and adds entries in the local list incrementally as the user communicates with other users and groups.
Adding new contacts and groups is easy and automatic.
The initial local GAL does not contain the full list as on the server.
If needed, users have to initiate the download of the full GAL manually from the menu options.
Server lookup for new contacts and groups is necessary when they are not in the local GAL.
You may modify the registry information on end-user computers by changing the values for certain Property
nodes in your provisioning file. Modifying registry information enables you to control end user settings from the server side.
WARNING:
If you modify the registry incorrectly, serious problems may occur that could require you to reinstall your operating system. Modify the registry at your own risk.
Adding Key or Registry Value: To add a key or registry value, use the following in your provisioning file:
<Property name="REG:ADD:{HIVE}\{keypath}:{Value Name}:{DataType}" value="{Value Data}"> </Property>
The value for {HIVE}
may be either HKLM
or HKCU
, which are the two locations where user registry information may be stored and which correspond to HKEY_LOCAL_MACHINE
and HKEY_CURRENT_USER
in the registry.
The value for {DataType}
may be String
, Binary
, or Dword
.
If you are adding a key, you do not need to provide values for {Value Name}
, {DataType}
, or {Value Data}
.
Deleting Key or Registry Value: To delete a key or registry value, use the following in your provisioning file:
<Property name="REG:Delete:{HIVE}\{keypath}:{Value Name}" value=""></Property>
If you are deleting a key, do not provide a value for {Value Name}
. Additionally, the key must reside at least two levels under the user hive.
Modify Oracle Beehive Extensions for Outlook INI settings by including a property with the following structure:
<Property name="FILE:Beehive.ini:{Section Name}:{Property Name}" value="{Value Data}"> </Property>
You may force end users to upgrade to a new version of Oracle Beehive Extensions for Outlook that you have uploaded to the DMS. End users will not be able to use Oracle Beehive Extensions for Outlook until they upgrade.
Forcing End Users to Upgrade to New Version of Oracle Beehive Extensions for Outlook: In your XML provisioning file, add a property with the following structure:
<Property> name="INSTALL:ForceClientVersion:{comparison operation}" value="{build number}"> </Property>
{build number}
is the Oracle Beehive Extensions for Outlook build number, which will be used for the comparison operation.
Allowing End Users to Use Older Version of Oracle Beehive Extensions for Outlook Until Certain Date: Optionally, you may allow end users to continue using their old version of Oracle Beehive Extensions for Outlook for a specific period of time or for a fixed number of logins to Oracle Beehive.
In your XML provisioning file, add a property with the following structure:
<Property>
name="INSTALL:graceperioditerations"
value="{number of logins}">
</Property>
{number of logins}
is the number of times end users are allowed to login to Oracle Beehive Extensions for Outlook before they are forced to upgrade.
Use the following methods to uninstall or downgrade Oracle Beehive Extensions for Outlook.
End users may remove Oracle Beehive Extensions for Outlook from their computers by selecting Add/Remove Programs from the Control Panel, selecting Oracle Beehive Extensions for Outlook from the list, and clicking Remove.
By default, Oracle Beehive Extensions for Outlook will only detect updates if the server version is newer than the currently installed version. If you want to allow end users to install downgraded versions of Oracle Beehive Extensions for Outlook as updates, set the value of the INSTALL:AllowDowngrade
Property node to TRUE
in your provisioning file.
It is recommended to install Oracle Beehive Extensions for Outlook using Oracle's Device Management Service (DMS). However, custom environments and lockdown systems with limited administrative privileges may require custom or alternative methods of installation, deployment, and configuration that is non-DMS based.
This section covers the following topics:
Installing Oracle Beehive Extensions for Outlook Using Executable File
Configuring Oracle Beehive Extensions for Outlook Using Configuration Wizard
Upgrading Oracle Beehive Extensions for Outlook Installation
Updating Language Pack for Oracle Beehive Extensions for Outlook (Non-DMS)
Uninstalling and Downgrading Oracle Beehive Extensions for Outlook (Non-DMS Process)
You may give end users direct access to the Oracle Beehive Extensions for Outlook installer. The end users install the product by double-clicking the installer and following the on-screen instructions.
Retrieve the installer outlook_extensions_setup.exe
from <Oracle Beehive home>
/beehive/bootstrap/obio/setup
.
To install Oracle Beehive Extensions for Outlook in silent mode, run the following command:
outlook_extensions_setup.exe /s UI=<installer UI option>
<installer UI option>
is one of values in the following table:
Table 25-4 Installer UI Options
Value | Function |
---|---|
|
No user interface during install |
|
Displays only a progress bar during install |
|
Presents an install screen with different dialog boxes but does not require user input to run |
|
Runs a fully interactive installer requiring user input |
To uninstall Oracle Beehive Extensions for Outlook in silent mode, use the msiexec.exe
utility and specify the Oracle Beehive Extensions for Outlook MSI product code as follows:
msiexec.exe /x {A634A2AF-2495-4F36-B88F-0B24B84A183C} /qn
You may create customized Oracle Beehive Extensions for Outlook profiles for locked down users. This involves running the Oracle Beehive Extensions for Outlook MSI installer package and specifying the profile parameters as in the command line as public properties. This method assumes that Oracle Beehive Extensions for Outlook was previously installed by an administrator. It does not reinstall Oracle Beehive Extensions for Outlook; it only recreates the Oracle Beehive Extensions for Outlook profile for the locked down user.
Ideally, run the Oracle Beehive Extensions for Outlook MSI installation package on the lockdown system in the locked down user's Windows login script or add an entry to run it, in the runOnce key in the registry.
Run the Oracle Beehive Extensions for Outlook MSI installation package with the following command line options (line breaks have been inserted for clarity):
msiexec -i {MSI_PRODUCT_CODE} REINSTALL=ALL REINSTALLMODE=u CREATE_PROFILE=3 PROFILE_NAME=MyProfileName {List of public properties with their values} /qn
The following is an example of running the MSI package:
msiexec -i {A634A2AF-2495-4F36-B88F-0B24B84A183C} REINSTALL=ALL REINSTALLMODE=u CREATE_PROFILE=3 PROFILE_NAME=MyprofileName BEEHIVE_SERVER=staqm05.us.oracle.com BEEHIVE_USER=ferasa BEEHIVE_PORT_DIRECT=12345 BEEHIVE_PORT_HTTPS=5533 BEEHIVE_TIMEOUT=40000 BEEHIVE_PROXY_TYPE=0 BEEHIVE_DATA_DIRECT=65536 BEEHIVE_DATA_HTTPS=257 /qn
The following table describes the public properties you may specify:
Table 25-5 MSI Package Public Properties
Property | Description |
---|---|
|
Determines if an Oracle Beehive Extensions for Outlook profile should be created on the user's computer during installation. This parameter may be assigned one of the following values:
|
|
Changes the name of the profile created during installation of Oracle Beehive Extensions for Outlook. The default profile name is |
|
Oracle Beehive server address. |
|
Oracle Beehive user account. |
|
Valid port number to be used to establish a direct connection. |
|
Valid port number to be used to establish an HTTPS connection. |
|
The Timeout duration before reporting failure to connect. (milliseconds) |
|
Specifies the proxy type:
|
|
|
|
|
The obioprofwiz.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. (A PRF file is a text file that Microsoft Outlook uses to generate a profile.) The configuration wizard reads information from an existing PRF file and creates a new profile or modifies an existing profile with the appropriate settings. Start this utility from the command prompt or Windows Explorer. Find obioprofwiz.exe
in C:\Program Files\Oracle\Outlook Extensions
.
You may perform the following with the configuration wizard:
Start the configuration wizard in interactive mode.
Start the configuration wizard in silent mode; you may use an existing PRF file with all the required settings to create and configure the first profile for users.
As an administrator, generate the PRF files to save updated settings.
As an administrator, back up Oracle Beehive Extensions for Outlook settings from an existing profile and restore these settings later.
As an administrator, modify profile settings in the PRF file generated by the configuration wizard.
Refer to "Configuration Wizard Modes" for more detailed information about the different modes of the configuration wizard.
Note:
While configuring a profile, it only configures Oracle Beehive Extensions for Outlook settings. You may 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.obioprofwiz.exe /s
<full path to PRF file>
obioprofwiz /d
obioprofwiz /p
Table 25-6 Configuration WIzard Command Line Options
Option | Description |
---|---|
|
Specifies that the Set as Default Profile option should be selected by default on the final screen of the configuration wizard. |
|
Runs the configuration wizard in interactive profile creation mode and creates a PRF file. |
|
Runs the configuration wizard in silent profile creation mode. Specify the full path to the PRF file after this option. |
Note:
Although the options in the preceding table are shown as lower-case letters, these command-line options are not case-sensitive.You may enter a slash (/
) or a minus sign (-
) before an option at the command line.
Create a profile interactively:
obioprofwiz.exe
Run the configuration wizard in silent profile creation mode:
obioprofwiz.exe /s "C:\Program Files\Oracle\Outlook Extentions\source.prf"
Ensure that the Set as Default Profile option is selected in the Congratulations screen of the configuration wizard.
obioprofwiz.exe /d
This section describes the following modes in which you can run the configuration wizard:
The interactive profile creation and configuration mode is the default mode. Use this mode to specify settings and create or modify a profile. Configure an existing profile or create a new profile by using the Profile Settings screen of the configuration wizard. However, you may configure only one profile in one session. You may also remove an existing profile on the Profile Settings screen.
Close Microsoft Outlook before starting the configuration wizard.
Launch the wizard by double-clicking the Oracle Beehive Extensions for Outlook configuration wizard, obioprofwiz.exe
, from the installation directory.
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 may view or modify settings for the selected user profile in the Service Settings screen. You must fill all non-password fields to proceed to the next screen. 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. Click Next to proceed.
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.
As an administrator, you may run the obioprofwiz.exe
utility in interactive PRF file creation mode. In this mode, you may 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 may be used by the configuration wizard or by the NewProf.exe
utility.
Close Microsoft Outlook before starting the configuration wizard.
Run the configuration wizard with the /p
option at the command line. For example:
obioprofwiz.exe /p
In the 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.
Note:
If you import information from an existing PRF file or MAPI profile, Microsoft Outlook address book information is added to the Service List section of the output PRF file if the existing PRF file or MAPI profile already contains address book information or the Outlook Address Book service, respectively.Enter the name and location of the new PRF file in the Destination File field.
In the Profile Options screen, configure the settings for the General section of the new PRF file. The following table shows the relationship between the fields in the Profile Options screen and the parameters in the General section of the PRF file:
Table 25-7 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 General Section of PRF File |
---|---|
Profile Name |
|
Default Store |
|
Use this profile as the default MAPI profile |
|
Overwrite existing profile with the same name |
|
View or modify Oracle Beehive Extensions for Outlook settings for the selected user profile in the Service Settings screen. All non-password fields must be filled to proceed to the next screen. Click Next to proceed.
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 Beehive Extensions 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 may then verify the information or modify parameters in the PRF file.
In this mode, you may use an existing PRF file as a template to create a corresponding profile. When installing Oracle Beehive Extensions for Outlook in silent mode, you may 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 Beehive Extensions for Outlook configuration wizard. You may configure most of the parameters in the PRF file with 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 Beehive Extensions 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 with a path and file name similar to C:\Documents and Settings\user\Local Settings\Temp\obioConfigWizardLog\obioConfigWizard.log
, where user
is the login name of the currently logged in Windows user.
Note:
If you are configuring Oracle Beehive Extensions for Outlook in silent mode, then you must check the log file to verify the results. The log file contains a record of errors, as well as successful imports of information into the profile.The configuration wizard may write some information to the log file in interactive profile creation and configuration mode and interactive PRF file creation mode. Usually, high-level warning messages are displayed on the screen, while low-level technical information is recorded in the log file.
When you provision a new version of Oracle Beehive Extensions for Outlook in the DMS repository, end users will be notified about the new update and will be able to download and install it.
If administrators prefer to upgrade to a newer version of Oracle Beehive Extensions for Outlook on end users' systems without relying on the DMS upgrade process (because, for example, the computers they want to upgrade are lockdown systems), then they need to deploy the new version of Oracle Beehive Extensions for Outlook before performing any server updates.
Alternatively, you may remove any Oracle Beehive Extensions for Outlook packages from the DMS repository so that end users are never prompted to upgrade to newer versions. Perform the following steps to remove Oracle Beehive Extensions for Outlook packages:
Run the following command:
beectl list_client_applications
The previous command should list the following two Oracle Beehive Extensions for Outlook application packages and their identifiers:
Oracle Beehive Extensions for Outlook
Oracle Beehive Extensions for Outlook Language Pack
Remove both client applications by running the following command (for each application):
beectl delete_client_application
--application <identifier of client application>
The default localization of the user interface of OBEO can be changed according to the user preference. This can be done by supplying newer xliff files for the preferred languages that would contain the required changes. If the default language pack is satisfactory, however, then no change will be required and hence no updating of the language pack will be necessary.
Follow the steps below to update the modified language packs:
Obtain the default language pack from the following location:
<Oracle Beehivehome>/beehive/bootstrap/obio/languagepack
Unzip the package.
Find the corresponding xliff file of the language that needs to be modified and make the changes.
Place the changed file in a folder.
For example: c:\lab\Updates (This would be the path to xliff chm files)
These modified files can be deployed on the users' machines using one of the following commands:
outlook_extension_setup.exe /package_langpack {path_to_a_folder_of_xliff_chm_files}
This command generates a newer installation package with the updated xliff files packaged inside it. This full installation package is generated in the same folder of the original installation package. It can then be executed normally by the users to install and update their deployed language pack in the deployed location (usually C:\Program Files\Oracle\Outlook Extensions\languages\Updates).
outlook_extension_setup.exe /install_langpack {path_to_a_folder_of_xliff_chm_files}
This command does not generate a new installation package. Instead, it copies the modified files directly to its deployed location. It can be used by the user to update the deployed language pack, provided that the user running the installation has access to the folder where the updated files are located (this can be a network location) during the installation time.
Use the following methods to uninstall or downgrade Oracle Beehive Extensions for Outlook.
If your end users are running systems on Windows XP or Windows Vista that are locked down, they may install Oracle Beehive Extensions for Outlook using an Active Directory group policy. To perform an Active Directory installation, the domain administrator must create a package for Oracle Beehive Extensions for Outlook in the Active Directory Administrative Tool and then assign the package to the organization units that contain the intended end users. The software will then be installed on end users' computers during startup.
This section covers the following topics:
Creating MSI installation package for Oracle Beehive Extensions for Outlook
Deploying Oracle Beehive Extensions for Outlook using Active Directory Group Policy
Verifying that Oracle Beehive Extensions for Outlook Is Available for Installation
Active Directory only recognizes software packaged in the MSI file format, which contains information about the application setup and installation. Follow these steps to create an MSI installation package for Oracle Beehive Extensions for Outlook:
Extract the outlook_extensions_application.msi
file from the Oracle Beehive Extensions for Outlook package using the outlook_extensions_setup.exe /export type=client
<extracted folder path>
command.
Extract the prerequisite.msi
file from the Oracle Beehive Extensions for Outlook package using the outlook_extensions_setup.exe /export type=system
<extracted folder path>
command.
Before proceeding, ensure you have extracted the MSI files for Oracle Beehive Extensions for Outlook to an accessible location. Follow these steps to deploy Oracle Beehive Extensions for Outlook using an Active Directory group policy:
From the Start menu, select Control Panel, then Administrative Tools.
Click Active Directory Users and Computers.
Create an organization unit that includes all the computers on which you want to install Oracle Beehive Extensions for Outlook. Alternatively, select an existing organization unit.
Right-click your chosen organization unit in the Active Directory Users and Computers tree.
From the Shortcut menu, click Properties.
In the Properties dialog box, click the Group Policy tab.
Click Edit if you are modifying an existing group policy, or Add if you are creating a group policy.
Note:
The following steps will ensure that Oracle Beehive Extensions for Outlook is installed on all computers in your chosen organization unit. It also ensures that all users of a given computer have access to Oracle Beehive Extensions for Outlook.Select and expand the Computer Configuration node.
Under the Computer Configuration node, expand the Software Settings folder.
Right-click Software Installation and select New.
From the Shortcut menu, click Package.
Enter the path to your extracted prerequisite.msi file.
Selected Assigned and click OK.
Repeat steps 10-13 for your extracted outlook_extensions_application.msi
file.
Note:
For more information on how to obtain MSI files for Oracle Beehive Extensions for Outlook, see Creating MSI installation package for Oracle Beehive Extensions for Outlook.In the Properties dialog box, click OK.
Exit the Active Directory Users and Computers console.
To verify that Oracle Beehive Extensions for Outlook is available to end users for installation, restart any computer in the domain and make sure that Oracle Beehive Extensions for Outlook installation starts when the computer restarts.
You may also use the Oracle Beehive Extensions for Outlook downloader as a tool to migrate and integrate some configurations settings into an Oracle Beehive Extensions for Outlook profile. This includes the following options:
Migrating existing personal folder data files (files with a .pst extension) from previous profiles
Migrating LDAP settings from previous profiles
Adding new LDAP settings
Adding new personal folders data file
Use the /migrate
switch as follows:
outlook_extensions_downloader.exe /migrate C:\migrateinifile.ini
If you do not provide an initialization file (such as C:\migrateinifile.ini
in the previous example), you will be presented with an interactive user interface that enables you to choose the personal folders data files and the LDAP settings from previous profiles to migrate.
Use the following template to create a migration initialization file:
Example 25-4 Template for Migration Initialization File
[migrate_psts] Src= Dest= CopyFile= [migrate_ldaps] Src= Dest= [add_pst] Path= Dest= [add_ldap] Name= Host= Port= Base= SSL= Dest= [migrate_NK2] Src= Dest=
Table 25-8 Migration Initialization File Parameters
Section Name | Parameter Name | Description |
---|---|---|
|
|
Migrates existing personal folder data files (files with a
|
|
Existing Oracle Beehive Extensions for Outlook profile to which the migrated settings should be added. This may be the Oracle Beehive profile created with the downloader. |
|
|
One of the following values:
|
|
|
|
Migrates LDAP settings from the specified profile or profiles. It may have one of the following values:
|
|
Existing Oracle Beehive Extensions for Outlook profile to which the migrated settings should be added. This may be the Oracle Beehive profile created with the downloader. |
|
|
|
Adds the settings from a specified PST file. It may have one of the following values:
|
|
Existing Oracle Beehive Extensions for Outlook profile to which the settings should be added. This may be the Oracle Beehive profile created with the downloader. |
|
|
|
Display name of LDAP |
|
LDAP host name |
|
|
LDAP port number |
|
|
LDAP base distinguished name (DN) |
|
|
Boolean value; specifies whether SSL is enabled ( |
|
|
Existing Oracle Beehive Extensions for Outlook profile to which the settings should be added. This may be the Oracle Beehive profile created with the downloader. |
|
|
|
Migrates nickname cache from specified profile or profiles. It may have one of the following values:
|
|
Existing Oracle Beehive Extensions for Outlook to which the migrated settings should be added. This may be the Oracle Beehive profile created with the downloader. |
In certain cases, an application process (such as Windows Search) may lock a file that is part of the Oracle Beehive Extensions for Outlook upgrade, resulting in incomplete installation. The installation process will display a message similar to the following:
The following applications are using files that need to be updated by this setup. Close these applications and click Retry to continue.
If this occurs, follow the below mentioned suggestions:
Click Retry to see if the installation proceeds.
If Retry does not work, click Ignore to see if the installation proceeds.
If Ignore allows the installation to proceed, then you may be prompted to reboot to complete the installation.
If Ignore does not work, then Exit the installation, wait several minutes, and then re-try the installation.
If the problem persists despite waiting for a reasonable period, then you will need to disable the Windows Search service, perform the Oracle Beehive Extensions for Outlook installation, and then re-enable the Windows Search service.