Skip Headers
Oracle® Beehive End-User Information
Release 1 (1.4)

Part Number E13802-01
Go to Documentation Home
Home
Go to Book List
Book List
Go to Table of Contents
Contents
Go to Feedback page
Contact Us

Go to previous page
Previous
Go to next page
Next
View PDF

2 Using Standards-Based Clients

This module describes how to configure standards-based clients to connect to Oracle Beehive, and contains the following topics:

Web Clients (WebDAV)

Oracle Beehive supports the following WebDAV clients:

Cadaver

Operating System: Linux

To configure Cadaver to connect to Oracle Beehive:

  1. Open a shell.

  2. Execute the cadaver http://<Server-Name>:<Port-Number>/content/dav command. For example, if your server name is barton.oracle.com and your port number is 7777, your command would be cadaver http://barton.oracle.com:7777/content/dav.

  3. Enter your user name and password.

Internet Explorer 6.x and 7

Operating System: Windows XP

To configure Internet Explorer to connect to Oracle Beehive:

  1. In the Address field, enter the URL to connect to Oracle Beehive using the following structure:

    http://<Server-Name>:<Port-Number>/content/dav

    Example:

    Your server name is barton.oracle.com and your port number is 7777, so the URL you enter is http://barton.oracle.com:7777/content/dav.

    If you do not know your Oracle Beehive URL, please contact your system administrator.

  2. Enter your user name and password, and click OK.

To log out of Oracle Beehive:

Click the Logout link in the top right-hand corner of the page.

Folder Names with Symbols

If you create a folder with a name that contains symbols using Windows XP Web Folders, you may not be able to access the folder in Internet Explorer by clicking the folder link in your personal workspace. To access the folder in Internet Explorer, copy the address from your Windows XP Web Folder and paste it in the Internet Explorer Address field.

Mac OS X Finder Web Access

Operating System: Mac OS X 10.4.9

To configure Mac OS X Finder to connect to Oracle Beehive:

  1. From the Go menu, select Connect to Server.

  2. In the Server Address field, enter the URL to connect to Oracle Beehive using the following structure:

    http://<Server-Name>:<Port-Number>/content/dav

    Example:

    Your server name is barton.oracle.com and your port number is 7777, so the URL you enter is http://barton.oracle.com:7777/content/dav.

    If you do not know your Oracle Beehive URL, please contact your system administrator.

  3. Click Connect.

  4. Enter your user name and password and click OK.

Transmit 3.5.0

Operating System: Mac OS X 10.4.9

To configure Transmit to connect to Oracle Beehive:

  1. In the Server field, enter the server name. For example, if your server is barton.oracle.com, you would enter barton.oracle.com in the Server field. If you do not know your server name, please contact your system administrator.

  2. Enter your user name and password.

  3. Enter /content/dav in the Initial Path field. If you do not know your initial path, please contact your system administrator.

  4. Enter the port number of your server.

  5. Select WebDav from the Protocol list.

  6. Click Connect.

Windows XP Web Folders

Configuration

To configure Windows XP Web Folders to connect to Oracle Beehive:

  1. In Windows Explorer, click My Network Places.

  2. Click Add a network place.

  3. Click Next.

  4. Select Choose another network location and click Next.

  5. In the Internet or network address field, enter the URL to connect to Oracle Beehive using the following structure:

    http://<Server-Name>:<Port-Number>/content/dav

    Example:

    Your server name is barton.oracle.com and your port number is 7777, so the URL you enter is http://barton.oracle.com:7777/content/dav.

    If you do not know your Oracle Beehive URL, please contact your system administrator.

  6. Enter your user name and password, and click OK.

  7. Enter a name for your network place, and click Next.

  8. If you want to access this network place immediately, select the Open this network place when I click Finish check box.

  9. Click Finish.

To log out of Oracle Beehive:

  1. Click the Logout link in the top right-hand corner of the page.

  2. Delete the corresponding network place from the My Network Places list.

    Caution:

    When logging out of Oracle Beehive, make sure that you have not performed any other WebDAV-related actions between step 1 and step 2.

Supported Web Folder Versions

Oracle Beehive supports the following versions of Windows XP Web Folders:

  • 11.0.6715.60 or later

  • 12.0.4518.1014 or later

Known Issues and Limitations

  • Microsoft Windows XP Professional 2002 Service Pack 2: When you create a folder in your personal workspace, you may receive an error message stating that an entity was not found. Ignore the error. The folder will be created normally.

  • Web Folders 12.0.4518.1014:

    • Opening a text file will generate an error message stating that the file name, directory name, or volume label syntax is incorrect. Ignore the error.

    • Moving or copying a file to a directory where a file with the same name exists will fail.

  • Explicit file versioning not supported in Manual mode: Microsoft Windows Web Folders does not support explicit versioning of files when versioning control is set to Manual mode. To update a file hosted by Web Folders when versioning is set to Manual mode, users must check out a file, change it, save it, and check it back in.

WebDAV Server Behavior in Mac OS X

When right-clicking a folder or document on a WebDAV server, the following Mac OS X options will not work:

  • Make Alias

  • Create Archive

If you want to reduce the number of files sent from your desktop to the Oracle Beehive WebDAV server, you can disable the creation of .DS_Store files on your Macintosh using instructions found at the following location: http://docs.info.apple.com/article.html?artnum=301711

However, disabling the creation of .DS_Store files on your Macintosh will prevent you from copying files from a Local File System to the Oracle Beehive WebDAV server. All other WebDAV operations should function normally.

FTP Clients

Oracle Beehive supports the following FTP clients:

FileZilla 2.x

Operating System: Windows XP

Configuration

To configure FileZilla to connect to Oracle Beehive:

  1. From the File menu, select Site Manager.

  2. Click New Site.

  3. Enter a name for the site.

  4. In the Host field, enter your server name (e.g. myserver.oracle.com).

  5. Enter your port number.

  6. From the Servertype list, select FTP.

  7. In the Logontype section, select the Normal check box.

  8. Enter your user name and password.

  9. Click Connect.

  10. Click Save and Exit.

Windows Character Sets and Uploading

Uploading a file to a directory using the Windows-1252 user character set and a non-English language will fail.

NCFTP 3.2.6

Operating System: Linux

To configure NCFTP to connect to Oracle Beehive:

  1. Launch NCFTP.

  2. Connect to the Oracle Beehive server using the open command with the -u (user name) and -P (port number) options and arguments. For example, if your user name, port number, and server name were jcoetzee, 7777, and barton.oracle.com, respectively, you would type open -u jcoetzee -P 7777 barton.oracle.com.

  3. For more information, consult the NCFTP documentation.

SmartFTP 2.5.0

Operating System: Windows XP

To configure SmartFTP to connect to Oracle Beehive:

  1. From the File menu, select New Remote Browser.

  2. Select Normal FTP from the Protocol list.

  3. In the Host field, enter the name of your server. For example, if your server name is barton.oracle.com, you would enter barton.oracle.com in the Host field. If you do not know your server name, please contact your system administrator.

  4. Enter the port number of your server in the Port field.

  5. Select Username and Password from the Login Type list.

  6. Enter your user name and password.

  7. Click OK.

Transmit 3.5.0

Operating System: Mac OS X 10.4.9

Configuration

To configure Transmit to connect to Oracle Beehive:

  1. In the Server field, enter the server name. For example, if your server name is barton.oracle.com, you would enter barton.oracle.com in the Server field. If you do not know your server name, please contact your system administrator.

  2. Enter your user name and password.

  3. Enter the port number of your server.

  4. Select FTP from the Protocol list.

  5. Click Connect.

Copying Document Aliases

When you transfer a document alias, Transmit will transfer the original document, not the alias.

Time Management Clients (CalDAV)

Oracle Beehive supports the following CalDAV clients:

iCal 3.0

Operating System: Mac OS X 10.5

To configure iCal to connect to Oracle Beehive:

  1. Open a Web browser and enter the location of your Oracle Beehive calendar data using the following structure:

    http://<Server-Name>:<Port-Number>/caldav

    Example:

    Your server name is barton.oracle.com and your port number is 7777, so the URL you enter is http://barton.oracle.com:7777/caldav.

    If you do not know your Oracle Beehive calendar data URL, please contact your system administrator.

  2. Enter your Oracle Beehive user name and password. Click OK.

  3. Click the Help link in the top right-hand corner of the window.

  4. Copy the URL next to Apple iCal.

  5. From the iCal menu, select Preferences.

  6. Click the Accounts tab.

  7. Click + to add an account.

  8. Enter a description for the account.

  9. Enter your Oracle Beehive user name and password.

  10. Click the Server Options arrow.

  11. In the Account URL field, paste the URL you copied in step 4.

  12. Click Add. If a warning appears, ignore it and click OK.

  13. Close the Accounts window. Your Oracle Beehive calendar is now listed as Default Calendar under the account description heading in the left-hand column.

Mozilla Lightning

Oracle Beehive supports Mozilla Lightning 0.8 and 0.9 on the Windows XP, Mac OS X 10.4.9, and Linux operating systems.

Configuration

To configure Mozilla Lightning to connect to Oracle Beehive:

Windows and Linux
  1. Make sure that Mozilla Thunderbird 2.0 is running and that you have installed the Lightning add-on.

  2. On the Calendars tab, click New.

  3. Select On the Network and click Next.

  4. Select CalDAV from the Format list.

  5. In the Location field, enter the location of your Oracle Beehive calendar data using the following structure:

    http://<Server-Name>:<Port-Number>/caldav/<Enterprise-ID>/home/<User-Email-Address>/calendars/MyCalendar

    Example:

    Your server name is barton.oracle.com, your port number is 7777, your enterprise ID is OracleBeehive, and your user ID is jcoetzee@acme.com. Therefore, your calendar URL is http://barton.oracle.com:7777/caldav/OracleBeehive/home/jcoetzee@acme.com/calendars/MyCalendar.

    If you do not know your Oracle Beehive calendar data URL, please contact your system administrator.

  6. Enter a calendar name, choose a display color for your calendar entries, and click Next.

  7. Enter your user name and password, and click OK.

  8. Click Finish. You are now subscribed to your Oracle Beehive calendar. It may take a few seconds for Lightning to retrieve the contents of your calendar from the server.

Macintosh
  1. Make sure that Mozilla Thunderbird 2.0 is running and that you have installed the Lightning add-on.

  2. On the Calendars tab, click New.

  3. Select On the Network and click Next.

  4. Select CalDAV from the Format list.

  5. In the Location field, enter the location of your Oracle Beehive calendar data using the following structure:

    http://<Server-Name>:<Port-Number>/caldav/<Enterprise-ID>/home/<User-Email-Address>/calendars/MyCalendar

    Example:

    Your server name is barton.oracle.com, your port number is 7777, your enterprise ID is OracleBeehive, and your user ID is jcoetzee@acme.com. Therefore, your calendar URL is http://barton.oracle.com:7777/caldav/OracleBeehive/home/jcoetzee@acme.com/calendars/MyCalendar.

    If you do not know your Oracle Beehive calendar data URL, please contact your system administrator.

  6. Enter a calendar name, choose a display color for your calendar entries, and click Next.

  7. Enter your user name and password, and click OK.

  8. Click Finish. You are now subscribed to your Oracle Beehive calendar. It may take a few seconds for Lightning to retrieve the contents of your calendar from the server.

Time Zone Settings

Make sure you select the appropriate time zone for your location before you begin working with your Oracle Beehive calendar. Otherwise, your calendar events may not appear at the right times.

Mozilla Sunbird

Oracle Beehive supports Mozilla Sunbird 0.8 and 0.9 on the Windows XP, Mac OS X 10.4.9, and Linux operating systems.

To configure Mozilla Sunbird to connect to Oracle Beehive:

Windows and Linux

  1. From the File menu, select Subscribe to Remote Calendar.

  2. Select On the Network and click Next.

  3. In the Format section, select CalDAV.

  4. In the Location field, enter the location of your Oracle Beehive calendar data using the following structure:

    http://<Server-Name>:<Port-Number>/caldav/<Enterprise-ID>/home/<User-Email-Address>/calendars/MyCalendar

    Example:

    Your server name is barton.oracle.com, your port number is 7777, your enterprise ID is OracleBeehive, and your user ID is jcoetzee@acme.com. Therefore, your calendar URL is http://barton.oracle.com:7777/caldav/OracleBeehive/home/jcoetzee@acme.com/calendars/MyCalendar.

    If you do not know your Oracle Beehive calendar data URL, please contact your system administrator.

  5. Click Next.

  6. Enter a calendar name, select a calendar color, and click Next.

  7. Enter your user name and password, and click OK.

  8. Click Finish. You are now subscribed to your Oracle Beehive calendar.

Macintosh

  1. From the File menu, select Subscribe to Remote Calendar.

  2. Select On the Network and click Continue.

  3. In the Format section, select CalDAV.

  4. In the Location field, enter the location of your Oracle Beehive calendar data using the following structure:

    http://<Server-Name>:<Port-Number>/caldav/<Enterprise-ID>/home/<User-Email-Address>/calendars/MyCalendar

    Example:

    Your server name is barton.oracle.com, your port number is 7777, your enterprise ID is OracleBeehive, and your e-mail address is jcoetzee@acme.com. Therefore, your calendar URL is http://barton.oracle.com:7777/caldav/OracleBeehive/home/jcoetzee@acme.com/calendars/MyCalendar.

    If you do not know your Oracle Beehive calendar data URL, please contact your system administrator.

  5. Click Continue.

  6. Enter a calendar name, select a calendar color, and click Continue.

  7. Enter your user name and password, and click OK.

  8. Click Done. You are now subscribed to your Oracle Beehive calendar.

Troubleshooting

This section covers ways to troubleshoot issues that might arise when using a CalDAV client with Oracle Beehive.

Mozilla Lightning and Mozilla Sunbird

Error Messages

Occasionally, you may encounter the following error message: "There has been an error reading data for calendar: <Your-Calendar-Name>. It has been disabled until it is safe to use it." This message occurs for one of the following reasons:

  • If you receive this message but you are still able to access some calendar data, it is a temporary problem with the Oracle Beehive server. If you are using Lightning 0.7 or later or Sunbird 0.7 or later, the problem should resolve itself. If you are using Lightning 0.5 or Sunbird 0.5, you must quit the application and restart for your data to appear normally.

  • You have entered the wrong calendar URL. Please verify your calendar URL with your system administrator.

Event Creation

If an event you have created does not appear in your Oracle Beehive calendar, make sure that you have not accidentally created the event in your local calendar instead.

Scheduling Meetings with Other Oracle Beehive Users

Meetings for which you have not yet indicated an attendance status appear with a ? in their titles. To confirm your attendance status for a meeting, change the ? to a +. To decline the meeting, delete it from your calendar, or change the ? to a -.

Optimizing Memory Usage

To avoid excessive memory use, set your calendar refresh interval to no less than 30 minutes by performing the following steps:

  1. From the Tools menu, select Options.

  2. Click the General tab.

  3. Select the Refresh calendars every check box and set the interval to at least 30 minutes.

  4. Click OK.

    Note:

    You can manually refresh your calendar at any time by selecting Reload Remote Calendars from the File menu.

Limitations

  • A maximum of 250 meetings are supported per calendar.

  • Oracle Beehive 1.3 only: When you assign delegate rights to another user, it may take up to six hours for the user to be able to work as your delegate.

  • When you create a meeting in a team workspace, all team workspace members are invited by default.

  • The date range for events in your calendar is limited to one month in the past and two years into the future.

  • Oracle Beehive does not support the following iCal features:

    • External attachments

    • Delegation

    • Managing available hours

    • Marking events or tasks as Private

    • Specifying whether one of your calendars affects your general availability

  • iCalendar categories do not map to Oracle Beehive tags.

  • You cannot create holidays in team workspaces.

E-mail Clients

Oracle Beehive supports the following e-mail clients:

Mail 2.1

Operating System: Mac OS X 10.4.9

To configure Mail to connect to Oracle Beehive:

  1. From the New Account dialog box, select IMAP from the Account Type list.

  2. Enter your name and e-mail address.

  3. Enter a description for your account and click Continue.

  4. Enter your incoming mail server and password in the appropriate fields and click Continue. If you encounter an error stating that your mail server cannot be reached, ignore it.

  5. Enter your outgoing mail server in the field and click Continue. If you encounter an error stating that your mail server cannot be reached, ignore it.

  6. Click Continue.

  7. Review the information you have entered. Click Go Back if you want to change any settings. Otherwise, click Continue to create your account.

  8. Click Done.

  9. Select your account from the list on the left-hand side and click the Account Information tab.

  10. Click Server Settings.

  11. Enter the port number for your outgoing mail server in the Server port field.

  12. Click the Advanced tab.

  13. Enter the port number for your incoming mail server in the Port field.

  14. Save your changes and exit the Accounts dialog box.

Microsoft Outlook 2003

Operating System: Windows XP

This section describes how to connect to Oracle Beehive using Microsoft Outlook with a standard IMAP server for e-mail access only. For a complete Oracle Beehive experience that includes e-mail, calendar, contacts, and tasks, you must install Oracle Beehive Integration for Outlook. Contact your system administrator for more information.

To configure Microsoft Outlook to connect to Oracle Beehive:

  1. From the Start menu, click Control Panel.

  2. Double-click the Mail icon.

  3. Click Show Profiles.

  4. Click Add.

  5. Enter a profile name and click OK.

  6. Select Add a new e-mail account and click Next.

  7. Select IMAP and click Next.

  8. Enter your name and e-mail address.

  9. Enter your user name and password.

  10. Enter your incoming and outgoing mail servers. If you do not know your mail servers, please contact your system administrator.

  11. Click More Settings.

  12. Click the Advanced tab and enter port numbers for your incoming and outgoing mail servers.

  13. Click OK.

  14. Click Next.

  15. Click Finish.

  16. Click OK to exit the Mail dialog box.

Microsoft Outlook 2007

Operating System: Windows XP

This section describes how to connect to Oracle Beehive using Microsoft Outlook with a standard IMAP server for e-mail access only. For a complete Oracle Beehive experience that includes e-mail, calendar, contacts, and tasks, you must install Oracle Beehive Integration for Outlook. Contact your system administrator for more information.

To configure Microsoft Outlook to connect to Oracle Beehive:

  1. In the E-mail accounts dialog box, Outlook will ask you if you want to set up a new e-mail account. Select Yes and click Next.

  2. Select the Manually configure server settings or additional server types check box and click Next.

  3. Select Internet E-mail and click Next.

  4. From the Account Type list, select IMAP.

  5. Enter your incoming and outgoing mail servers.

  6. Enter your user name and password.

  7. Click More Settings.

  8. Click the Advanced tab.

  9. Enter port numbers for your incoming and outgoing mail servers. Click OK.

  10. Click Next.

  11. Click Finish.

Mozilla Thunderbird 2.0

Operating Systems: Windows XP and Linux

To configure Mozilla Thunderbird to connect to Oracle Beehive:

  1. From the New Account Setup dialog box, select Email account, and click Next.

  2. Enter your name and e-mail address, and click Next.

  3. Select IMAP, enter the name of your incoming mail server, and click Next.

  4. Enter your user name and click Next.

  5. Enter a name for your account and click Next.

  6. Verify that all your information is accurate. If you want to edit your account information, click Back. Otherwise, click Finish to create your account.

  7. From the Tools menu, select Account Settings.

  8. Select Server Settings from the list on the left-hand side. Enter a port number for your incoming mail server.

  9. Select Outgoing Server (SMTP) from the list on the left-hand side. Select your server and click Edit.

  10. Enter a port number for your outgoing mail server and click OK.

  11. Click OK to save your account settings.

Instant Messaging Clients

Oracle Beehive supports the following instant messaging (IM) clients:

iChat 3.1.8

Operating System: Mac OS X 10.4.9

To configure iChat to connect to Oracle Beehive:

  1. From the iChat menu, select Preferences.

  2. Click + to create an account.

  3. Select Jabber Account from the Account Type list.

  4. Enter your e-mail address and password. The server field will automatically fill in the appropriate server name.

  5. Enter a description for this account and click Add.

  6. Click Server Settings and enter the port number for your Jabber server. If you do not know your port number, please contact your system administrator.

  7. From the iChat menu, select Log In to Jabber.

Oracle Messenger 10.1.2.3

Operating System: Windows XP

To configure Oracle Messenger to connect to Oracle Beehive:

  1. From the Tools menu, select Options.

  2. Click the Connection tab and select the Manual Configuration for XMPP Connection check box.

  3. In the XMPP Host field, enter the name of your server. For example, if your server name is barton.oracle.com, you would enter barton.oracle.com in the field.

  4. In the XMPP Port field, enter the port number for your server.

  5. Click OK.

  6. From the File menu, select Sign In.

  7. Enter your user name and password.

  8. In the Resource field, enter your enterprise identifier. If you do not know your enterprise identifier, please contact your system administrator.

  9. Click OK.

Pidgin 2.0

Operating Systems: Windows XP, Linux

To configure Pidgin to connect to Oracle Beehive:

  1. Click Add.

  2. On the Basic tab, choose XMPP from the Protocol list.

  3. Enter your screen name (typically your full e-mail address). If you do not know your screen name, please contact your system administrator.

  4. In the Domain field, enter your domain name. For example, if your server name were barton.oracle.com, you would enter oracle.com as the domain name.

  5. Click the Advanced tab. If you are not using TLS, select the Allow plaintext auth over unencrypted streams check box.

  6. Enter the full name of your server in the Connect server: field. For example, if your server name is barton.oracle.com, you would enter barton.oracle.com in the field.

  7. Click Save.

Trillian Pro

Operating System: Windows XP

To configure Trillian Pro to connect to Oracle Beehive:

  1. From the Trillian menu, select Trillian Preferences.

  2. Click Plugins.

  3. Select the Jabber check box.

  4. Click Identities & Connections in the list on the left-hand side.

  5. Select an identity and click Add a new connection. Select Jabber from the list.

  6. In the JID field, enter your user name and your XMPP domain name using the <User-Name>@<Domain-Name> structure. For example, if your user name is jcoetzee and your XMPP domain name is oracle.com, you enter jcoetzee@oracle.com in the JID field.

  7. Enter your server name.

  8. Enter your password.

  9. Click Connect.

Troubleshooting

You cannot transfer files securely when using an instant messaging client with Oracle Beehive. Though your SSL connection to the server is secure, files will be not securely transferred. When you attempt to transfer a file, you will be warned that the file transfer will be unsecure. You can then proceed with the unsecure file transfer or cancel the operation.