Difference between revisions of "OX6:Open-Xchange Mac OXtender Installation Guide"

 
(26 intermediate revisions by 6 users not shown)
Line 1: Line 1:
== Information and Installation of OXtender for Mac OS X (Beta Version) ==
+
{{DEPRECATED}}
 
+
This page is DEPRECATED. For using Open-Xchange with Mac OS X iCal and AddressBook please goto [[CalDAVClients]]
'''OXtender for Mac OS X is beta software for testing, and should be used at your own risk.'''
+
== Information and Installation of OXtender for Mac OS X ==
  
 
== Description ==
 
== Description ==
Line 11: Line 11:
  
 
In addition, it enables the InfoStore files to be accessed as Network Volume.
 
In addition, it enables the InfoStore files to be accessed as Network Volume.
 
Note: The new OXtender for Mac OS X is currently Beta software. If you want to test it, please backup your data first.
 
  
 
== Components ==
 
== Components ==
Line 25: Line 23:
 
== Requirements ==
 
== Requirements ==
  
* Mac OS X 10.5 and up
+
* Mac OS X 10.5  
 
* 26 MByte of storage space
 
* 26 MByte of storage space
 +
* Open-Xchange Server 6 SP4 Update 1 build 6610 or higher
 +
 +
The OXtender for Mac OS X is available for all customers with a Open-Xchange Hosting Edition, Open-Xchange Server Edition and Open-Xchange Appliance Edition Maintenance.
  
 
== Download ==
 
== Download ==
  
Follow this [http://software.open-xchange.com/OX6/OXtender-unstable/ link] to download the Installation package and the Release Notes.
+
Follow this [http://software.open-xchange.com/OX6/OXtender-stable/MacOXtender/ link] to download the Installation package and the Release Notes. (The LDB credentials have to be provided)
 +
 
 +
Follow this [http://software.open-xchange.com/OX6/doc/Mac-OXtender/ link] to download the User Manuals in different languages.
  
 
== Installation ==
 
== Installation ==
Line 45: Line 48:
 
* The first time the OXtender runs, a pop-up will appear and ask whether Python may use the key "oxsync". Answer "yes" to that.
 
* The first time the OXtender runs, a pop-up will appear and ask whether Python may use the key "oxsync". Answer "yes" to that.
 
* The OXtender will start at once. The orange circle on the OXtender icon indicates that it is running.
 
* The OXtender will start at once. The orange circle on the OXtender icon indicates that it is running.
 +
 +
== Uninstalling a previous OXtender version ==
 +
 +
The OXtender for Mac OS X comes with a program for uninstalling it. Just double-click on the respective entry and the program launches.
 +
 +
Now you can install the new OXtender as described above.
  
 
== Reporting of Bugs ==
 
== Reporting of Bugs ==
  
During the Beta phase for the OXtender for Mac OS X, please report Bugs and missing features via the [http://bugs.open-xchange.com/cgi-bin/bugzilla/enter_bug.cgi?product=OXtender%20for%20Mac%20OS%20X Open-Xchange Bugzilla]. Many thanks in advance for your support to help us deliver the final version of OXtender for Mac OS X toward the end of 2008.
+
Please report Bugs and missing features via the [http://bugs.open-xchange.com/cgi-bin/bugzilla/enter_bug.cgi?product=OXtender%20for%20Mac%20OS%20X Open-Xchange Bugzilla]. Many thanks in advance for your support.
  
== Further Information for Synchronization ==
+
== Further Information for Synchronization and Limitations==
  
Synchronization is a complex topic, ripe with synchronization errors and weird behavior. This survival guide tries to collect some advice for shielding the ambitious syncer from the worst effects:
+
Synchronization is a complex topic, ripe with synchronization errors and weird behavior. You will find further information for the Synchronization and Limitations at the [http://software.open-xchange.com/OX6/doc/Mac-OXtender/ User Manual]
  
* Make backups! This is important. By its very nature, a synchronization touches every entry on both systems, so whenever something goes horribly wrong a backup is your best defense. In Addressbook choose "File" -> "Export" -> "Address Book Archive" in iCal, similarly choose "File" -> "Export". Point your browser at https://[yourox]/servlet/webdav.ical, enter your credentials and save the resulting file. Point your browser at https://[yourox]/servlet/webdav.vcard, enter your credentials and save the resulting file. It will save your sound sleep and your data. Do this now!
+
[[Category: OX6]]
* Make backups! This bears repeating. Backups will save your data and your sanity.
 
* The first time the OXtender runs, it is going to bombard you with messages about conflicts. This is just the OXtender getting settled in. If this keeps occurring though, it is a wonderful opportunity to write a bug report.
 
* The OXtender for Mac OS X is easily duped by roaming between wireless networks. Whenever you have the suspicion that the syncer is not syncing anymore, go to the preferences pane and unselect and reselect the "Synchronize with OX" checkbox.
 
* Similarly the OXtender is duped by suspend / resume on laptops.
 
* When you are already syncing multiple macs via mobile me, choose one of the two systems and install the OXtender for Mac OS X on only one of those devices to bridge the gap.
 
* When you are syncing with mobile me, make sure that you sit at the computer that consolidates the mobile me and OX data to resolve sync conflicts immediately
 
* Resolve Sync Conflicts immediately. Whenever a sync conflict is in a pending state the sync services will refuse all updates to the respective entries, and DELETE THEM ON THE SYSTEMS REQUESTING THE SYNCS. This will lead to you losing data. It is imperative that you resolve sync conflicts quickly. If you're also syncing with mobile me make sure you are on hand to resolve sync conflict.
 
* Make backups! Seriously.
 
* It could well be that your system winds up in a strange state. Whenever an error repeatedly shows up, first tell us about it and then choose "additional options" -> "reset sync" in the preferences pane. This helps with a surprisingly broad range of problems. In order to make the synchronization efficient, the Mac has to remember which data is already present in the OX server. This state can be corrupted by certain errors in the synchronization process, at which point it is best to delete that state and start afresh. Pressing this button in the preference pane does just that.
 
* Slow Syncs may create duplicates. Both a slow sync and a reset sync may duplicate certain entries if it deems they are not similar enough.
 
*You made those backups, right?
 

Latest revision as of 11:41, 27 November 2015

This page is DEPRECATED. It either contains outdated information or information has been replaced by another page.

This page is DEPRECATED. For using Open-Xchange with Mac OS X iCal and AddressBook please goto CalDAVClients

Information and Installation of OXtender for Mac OS X

Description

The OXtender for Mac OS X synchronizes Open-Xchange Server 6 with your Mac OS X computer. Data of the following modules will be synchronized:

  • Calendar
  • Contacts
  • Task

In addition, it enables the InfoStore files to be accessed as Network Volume.

Components

Calendar, Contacts and Tasks: Objects will be regular synchronized via SyncServices. The following folders will be synchronized

  • Contacts - Private Address book and the Public Address book
  • Tasks - Private Tasks
  • Calendar - Private Calendar

If the user changes any data on their Mac OS X, the synchronization will be started after a 10 seconds waiting time via "Trickle-Sync".

Requirements

  • Mac OS X 10.5
  • 26 MByte of storage space
  • Open-Xchange Server 6 SP4 Update 1 build 6610 or higher

The OXtender for Mac OS X is available for all customers with a Open-Xchange Hosting Edition, Open-Xchange Server Edition and Open-Xchange Appliance Edition Maintenance.

Download

Follow this link to download the Installation package and the Release Notes. (The LDB credentials have to be provided)

Follow this link to download the User Manuals in different languages.

Installation

  • After the download of the package, you can start the installation by double-clicking on the package. You will then be asked for your administrator password. On the first screen, you will see some information about the MacOXtender. Please follow the installation steps at the wizard.
  • Please read carefully the license agreement for Open-Xchange.

Configuration

  • After the installation of the OXtender for Mac OS X, the user will find an Open-Xchange setting "OX Connector" in the System Preferences application of your Mac.
  • Please click on the OX icon. This will open the configuration dialog.
  • Please enter your synchronization details at the tab "User Account". You have to enter the server address, user account and password for the Open-Xchange Server.
  • On the second tab, you can change your synchronization settings for MacOXtender. Besides the setting "Slow-Sync" to compare the data on the Server and your Mac OS X, you can overwrite the data on the Server. Also, it is possible to restore the changed settings.
  • The first time the OXtender runs, a pop-up will appear and ask whether Python may use the key "oxsync". Answer "yes" to that.
  • The OXtender will start at once. The orange circle on the OXtender icon indicates that it is running.

Uninstalling a previous OXtender version

The OXtender for Mac OS X comes with a program for uninstalling it. Just double-click on the respective entry and the program launches.

Now you can install the new OXtender as described above.

Reporting of Bugs

Please report Bugs and missing features via the Open-Xchange Bugzilla. Many thanks in advance for your support.

Further Information for Synchronization and Limitations

Synchronization is a complex topic, ripe with synchronization errors and weird behavior. You will find further information for the Synchronization and Limitations at the User Manual