ChronoSync 4.5 Manual

ChronoSync
Mac OS X Manual
Version 4.5
! !
Updated for Version 4.5.0
June 9th, 2014
Econ Technologies, Inc.

1490 Sunshadow Drive Suite 2030
Casselberry, FL 32707
www.econtechnologies.com
_
Copyright 2002-2014
This manual is intended to cover the more advanced concepts of ChronoSync.

Most information needed to use and run ChronoSync can be found in ChronoSyncs Help, located within the application, and on our website in the Guides,
Video Guides and Tech Notes sections (http://www.econtechnologies.com).
Chapter 1. Introduction!
Welcome to ChronoSync!
8
8
Chapter 2. Basic Overview!
10
ChronoSync Documents!
10
Synchronizer documents!
10
Container Documents!
10
Backup Operation!
11
Blind Backup Operation!
11
Synchronize Bidirectional Operation!
11
Bootable Operation!
12
Setting Up A Synchronization!
14
Document Organizer Window!
14
Chapter 3. Scheduled Synchronization!
16
Background Synchronizations!
16
Sequential vs. Concurrent Execution!
16
Waking From Sleep!
16
Chapter 4. Advanced Concepts!
19
Change Detection!
19
Collection!
19
The Last Identity Test!
19
Triggers!
20
Anomalies?!
20
Baseline Synchronizations!
21
Extended Attributes & Access Control Lists!
21
Automatically Connecting to File Servers!
23
Other Server Options!
24
Removable Media!
24
File Comparison Helpers!
25
Archiving!
26
Connecting to ChronoAgent !
27
Connecting to InterConneX!
27
Chapter 5. Examples!
29
Synchronizing Desktops With Laptops!
29
Setting Up Your Synchronization!
29
Controlling Which Folders to Synchronize!
30
Cloning Data Using a Mirror Synchronization!
31
Changing Archive Location!
31
Synchronize 3 Macs!
32
Chapter 6. Common Errors!
35
Dealing With Conflicts & Errors!
35
Conflicts!
35
Date Roll Backs!
36
Daylight Savings!
37
Disk Full!
37
Apple Error Codes!
37
Econ Technologies, Inc. Software License Agreement

PLEASE READ THE FOLLOWING BEFORE USING THIS SOFTWARE: THIS IS A LEGAL AGREEMENT BETWEEN
YOU, THE END USER, AND ECON TECHNOLOGIES, INC. ("ECON"). PRIOR TO INSTALLING OR USING THIS
SOFTWARE, YOU MUST READ AND ACCEPT ALL THE TERMS AND CONDITIONS OF THIS AGREEMENT. IF
YOU DO NOT AGREE TO ALL OF THE TERMS AND CONDITIONS OF THIS AGREEMENT, PROMPTLY DESTROY
OR RETURN THE SOFTWARE AND ACCOMPANYING DOCUMENTATION TO ECON TECHNOLOGIES, INC.
This End-User License Agreement ("EULA") is a legal agreement between you (either an individual or a single entity)
and ECON for the ChronoSync software product, which includes computer software and may include associated
media, printed materials, and "online" or electronic documentation ("SOFTWARE PRODUCT"). By installing, copying,
or otherwise using the SOFTWARE PRODUCT, you agree to be bound by the terms of this EULA. If you do not agree
to the terms of this EULA, do not install or use the SOFTWARE PRODUCT.
The SOFTWARE PRODUCT and its accompanying documentation is protected by copyright laws and international
copyright treaties, as well as other international intellectual property laws and treaties. Upon your acceptance of this
EULA, ECON grants to you a nonexclusive license to use the SOFTWARE PRODUCT, provided that you agree to the
following:
1. GRANT OF LICENSE. The SOFTWARE PRODUCT is licensed, not sold. You own a copy of any media on which
the SOFTWARE PRODUCT may be shipped, but not a copy of the SOFTWARE PRODUCT itself. ECON retains all
title, copyrights, and other intellectual property rights in the SOFTWARE PRODUCT and any copies thereof. You may
install and use a copy of the SOFTWARE PRODUCT on one personal computer for which you have accepted the
terms of this EULA. You may also make copies of the SOFTWARE PRODUCT for backup and archival purposes. The
SOFTWARE PRODUCT is made available for installing or downloading solely for use by end users. Any reproduction
or redistribution of the SOFTWARE PRODUCT not in accordance with this EULA is expressly prohibited by law, and
may result in severe civil and criminal penalties. Violators will be prosecuted to the maximum extent possible.
WITHOUT LIMITING THE FOREGOING, COPYING OR REPRODUCTION OF THE SOFTWARE PRODUCT TO
ANY SERVER OR LOCATION FOR FURTHER REPRODUCTION OR REDISTRIBUTION IS EXPRESSLY PROHIBITED.
2. RESTRICTIONS. You must maintain all copyright notices on all copies of the SOFTWARE PRODUCT. You may
not distribute copies of the SOFTWARE PRODUCT to third parties. You may not modify, adapt, translate, reverse
engineer, decompile, disassemble, or otherwise attempt to learn the source code of the SOFTWARE PRODUCT,
except and only to the extent that such activity is expressly permitted by applicable law notwithstanding this limitation.
You may not rent, lease, or lend the SOFTWARE PRODUCT, or transport the SOFTWARE PRODUCT outside of the
country in which it was acquired.
3. TERMINATION. Your rights under this EULA terminate upon your termination of this EULA, or without prejudice to
any other rights, ECON may terminate this EULA if you fail to comply with its terms and conditions. In such event, you
must destroy all copies of the SOFTWARE PRODUCT.
4. DUTY TO BACKUP. It is your responsibility to maintain an archival copy of the SOFTWARE PRODUCT and to
perform periodic backups of all data and programs used in conjunction with the SOFTWARE PRODUCT to prevent
loss.
5. NO WARRANTY. The SOFTWARE PRODUCT is being delivered to you "AS IS" and ECON makes no warranty as
to its use or performance. ECON AND ITS SUPPLIERS DO NOT AND CANNOT WARRANTY THE PERFORMANCE
OR RESULTS YOU MAY OBTAIN BY USING THE SOFTWARE PRODUCT. ANY USE OF THE SOFTWARE PRODUCT IS AT YOUR OWN RISK. TO THE MAXIMUM EXTENT PERMITTED BY APPLICABLE LAW, ECON AND ITS
SUPPLIERS DISCLAIM ALL WARRANTIES AND CONDITIONS, EITHER EXPRESS OR IMPLIED, INCLUDING BUT
NOT LIMITED TO NON INFRINGEMENT OF THIRD PARTY RIGHTS AND IMPLIED WARRANTIES OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE, AND TITLE. ECON DOES NOT WARRANT THAT THE
OPERATION OF THE SOFTWARE PRODUCT WILL BE UNINTERRUPTED OR ERROR FREE, OR THAT ANY DEFECTS WILL BE CORRECTED.
6. LIMITATION OF LIABILITY. TO THE MAXIMUM EXTENT PERMITTED BY APPLICABLE LAW, IN NO EVENT
SHALL ECON OR ITS SUPPLIERS BE LIABLE FOR ANY SPECIAL, INCIDENTAL, INDIRECT, OR CONSEQUENTIAL DAMAGES OR ANY DAMAGES WHATSOEVER (INCLUDING, WITHOUT LIMITATION, DAMAGES FOR LOSS
OF BUSINESS PROFITS, BUSINESS INTERRUPTION, LOSS OF BUSINESS INFORMATION, LOSS OF SAVINGS,
OR ANY OTHER PECUNIARY LOSS) ARISING OUT OF THE USE OF OR INABILITY TO USE THE SOFTWARE
PRODUCT, OR FOR PROVISION OF OR FAILURE TO PROVIDE SUPPORT SERVICES, EVEN IF ECON HAS
BEEN ADVISED OF THE POSSIBILITY OF SUCH DAMAGES. Because some states and jurisdictions do not allow
the exclusion or limitation of liability for consequential or incidental damages, the above limitation may not apply to
you.
THE ENTIRE LIABILITY OF ECON AND YOUR EXCLUSIVE REMEDY UNDER THIS EULA IS, AT THE OPTION OF
ECON, CORRECTING OR WORKING AROUND ERRORS, OR REFUNDING THE PURCHASE PRICE. IN NO
EVENT SHALL ECON'S ENTIRE LIABILITY UNDER THIS EULA EXCEED THE PURCHASE PRICE OF THE
SOFTWARE PRODUCT.
7. MISCELLANEOUS. This EULA is governed by the laws of the State of Florida, U.S.A., and jurisdiction for any
action based on the SOFTWARE PRODUCT shall lie in a court located in Florida. If any part of this EULA is found
void and unenforceable, it will not affect the validity of the balance of the EULA, which shall remain valid and enforceable according to its terms.
Should you have any questions concerning this EULA, or if you desire to contact ECON for any reason, please write:
Econ Technologies, Inc.
1490 Sunshadow Drive Suite 2030
Casselberry, FL 32707
http://www.econtechnologies.com
Chapter One
Introduction
ChronoSync Users Manual!
Chapter 1 - Introduction
Chapter 1. Introduction
Welcome to ChronoSync
ChronoSync is a file synchronization and backup utility for Mac OS X. Its fundamental role is to take a
collection of files stored in one place and maintain an identical copy of those files stored in another place.
The places that ChronoSync will synchronize are called targets and the process of keeping both targets
identical is called synchronization. ChronoSync performs synchronization in a very efficient way - it
identifies and copies only the files that have changed since you last synchronized. This intelligence is
known as incremental or blind backup synchronization. Because it performs its job quickly and efficiently, using ChronoSync will not be a burden and will not significantly affect your daily workflow.
The situations in which synchronization is necessary are quite numerous and varied. ChronoSync offers a
tremendous degree of flexibility so that virtually any synchronization scenario can be handled.
The most common need for synchronization is to simply maintain a redundant backup of your data. In
this case, all the changes made in one target, the main target, will get copied over to another target, the
backup target. The user rarely, if ever, directly accesses files on the backup target - they exist merely as a
backup in case one of the files on the main target is accidentally deleted or becomes corrupt. In this scenario, ChronoSync would be configured to perform a backup, blind backup or bootable backup.
Another common need for synchronization is to keep two sets of files that are actively modified in sync
with each other. A perfect example is a laptop and desktop computer. You may work on certain files on
your desktop in your office - this would be your desktop target. You may then want to bring the same files
home on your laptop so you can work on them at night or on a business trip - this would be your laptop
target. When you return to the office, any changes you made to the files on your laptop need to be copied
back to your desktop. In this scenario, ChronoSync would be configured to perform a bidirectional synchronization.
Synchronizations really can be as simple as outlined above. They can, however, be much more intricate
and complex. ChronoSync is flexible and powerful enough to handle just about any synchronization scenario you can think of - some of which may even push the limits of the term synchronization.
Chapter Two
Basic Overview
Chapter 2 - Basic Overview
Chapter 2. Basic Overview

ChronoSync Documents
ChronoSync utilizes a document-based interface. This means that all your configuration settings as well
as specific information about the set of files being synchronized are contained in a single document. This
document may be saved anywhere on your computers hard disk. Likewise, a ChronoSync document can
be opened at a later date by simply double-clicking it from the Finder. This differs from an applicationbased interface where only a single set of data and options are presented. A word processing program is
an example of a document-based interface, because each document you create can be saved as a separate
file. Conversely, Apples iPhoto is an example of an application-based interface because only a single library of photos is managed and the user cannot open or save different libraries.
Once you configure a ChronoSync document to perform a desired synchronization, youre basically done
- all your settings are stored within the document. You can then open the saved document at any time, run
your synchronization then quit ChronoSync. If you desire, you can make changes to your ChronoSync
document to alter its behavior, but generally, you just set it and forget it!
Being document based, ChronoSync provides tremendous flexibility. The fact of the matter is that few
people have a singular synchronization need. This means that, more likely than not, you may need different types of synchronizations in various situations. For example you may want to keep a redundant
backup copy of all your working documents. Additionally, you may need to keep your desktop and laptop
computers synchronized with each other. With ChronoSync you would configure two separate documents
to perform each task - you simply open and execute the appropriate document at the appropriate time.
ChronoSync allows the creation of two types of documents: synchronizers and containers. A Synchronizer document contains all the information necessary to synchronize two targets. A Container document
contains one or more Synchronizer documents. Each is discussed in the following sections.
Synchronizer documents
A ChronoSync Synchronizer document contains all of the information necessary to keep two targets synchronized with each other. This includes a reference to each target, the type of synchronization to be performed, numerous option settings to control ChronoSyncs behavior and zero or more rules to inform
ChronoSync of what type of files need to be synchronized. A Synchronizer document also contains a
snapshot of every file being synchronized in each target. This snapshot is referred to as the synchronization tree because it maintains the same hierarchical relationships of files and folders as they exist in your
targets.
Container Documents
is like a folder to keep different backup or synchronization set ups
Simply put, a Container document contains one or more Synchronizer documents that have been previously saved. This allows you to synchronize several Synchronizer documents in one easy step. You simply drag documents in and out (or click the Add... or Remove toolbar icons) in the Documents panel.
Running a synchronization on a container will execute each contained Synchronizer document in the
listed order. Synchronizer documents in a container can be rearranged by dragging them, affecting the
order in which they run. In most other aspects, Container documents behave just like Synchronizer documents.
10
Synchronization Operations
The synchronization operation is specified on a Synchronizer documents Setup panel. ChronoSync offers
nine synchronization operations. These operations have five variants, Backup, Blind Backup, Mirror,
Bidirectional and Bootable. This section defines these variants and offers examples of how and when each
should be used.
if logic is applied to the names of the operations, the task performed by each one
Backup Operation
is better understood
ChronoSync employs its change detection logic to identify files in either target that have changed and, if
so, applies those changes to its counterpart. In a backup synchronization, as in all modes, the direction of
the synchronization is used to determine which target should be monitored for changes. For instance, if
left-to-right is the specified direction, only the files on the left target are monitored for changes. When a
change is detected, those changes are applied to the right target. Thus the change moves in a left-to-right
direction, hence the name. Conversely, when right-to-left is the specified direction, only the right target is
monitored for changes and, when detected, those changes are applied in a right-to-left direction.
Note: Backup synchronization is the operation of choice for the overwhelming majority of synchronization tasks.
Blind Backup Operation
I dont understand very well the purpose of this operation
The Blind Backup operation essentially pays no attention to files in the destination target. It only pays
attention to files in the source target. Basically, it performs similarly to Backup mode except the Last
Identity Test is never performed, nor does it care if a files counterpart exists or not.
For example, suppose you modify a file in your source target then use the Finder to copy the file over to
the destination target. In the Backup operation, the file will not be synchronized because its considered
the same in both targets (the last identity test told it so). In a Blind Backup synchronization, however, it
will be synchronized! Also, if a file in your destination target is deleted, the corresponding file in your
source target will not get synchronized. Only a change to your source file will cause it to get synchronized. ChronoSync is blind to what is happening on the destination side of your synchronization.
There is one critical exception to the above behavior - initial synchronizations. If ChronoSync has never
synchronized a file before, and thus has not collected any information on the file, then the Backup operation behavior is applied. This allows you to add files to your source target and have them get synchronized. It also allows you to perform an initial synchronization with an empty destination target and have
all your files synchronized. Once ChronoSync has collected information on a file, however, the blind
backup logic will forever after be used.
Synchronize Bidirectional Operation
The choice for working with the same files in two different
computers, i.e. home and work or laptop and desktop
This operation is similar to the Backup operation. The main difference is that with the bidirectional operation specified, both targets are monitored for changes and the most 'up-to-date' file between the two targets is selected, making sure that file is synchronized to the other target.
The bidirectional synchronization operation would be used when doing a Home-to-Home synchronization. Bidirectional includes both the "Left-to-Right" and "Right-to-Left" directions. Therefore, modifying
a file on the right target would result in replacing its left side counterpart. If both files in the targets
change, a conflict will arise.
11
Mirror Operation
When the Mirror operation is in effect, synchronizations will only be allowed to occur in one direction.
This feature, however, is more than skin deep! What this means is that ChronoSync will scan both targets
as it does in a bidirectional synchronization, but wont allow a synchronization to occur that will go
against the bias. In fact, it will invert the direction of such synchronizations!
For example, if you have mirror left-to-right enabled, synchronizations will only occur left-to-right. Under a bidirectional synchronization, if you modify a file on the right target, it will get synchronized back
to the left side. Under mirror left-to-right, however, modifying a file on the right side will result in it being overwritten by its left-side counterpart. A similar behavior is applied to deletions. In this scenario, if a
file were deleted on the right side, it would normally get deleted on the left, too. Not so in a mirror left-toright operation - the left file will get copied back to the right side!
Bootable Operation
the bootable operation is not described in detail
Under normal circumstances, it makes little sense to backup your entire boot drive. Outside of the Users
folder there are System and Application files. Backing up these files would serve no purpose since, in
most cases, you could not restore them, i.e. doing so requires knowledge and expertise of what files are
important and what role they play in the operation of the system. However if you backup your entire hard
drive with the correct settings, then you can restore files and even boot from this drive in the event your
internal hard drive fails. This is called a bootable backup.
When you choose a Bootable operation, ChronoSync will prompt you to enter your Admin password.
This allows you to access all the files and folders on the system, rather than being restricted to just your
'Home' user files. To authenticate before setting up your Synchronizer document, you can choose
Authenticate... from the ChronoSync application menu. This menu item is just an option for entering
your password instead of waiting for ChronoSync to prompt for the password. Once authenticated, ChronoSync will no longer ask for an Admin password and will allow Admin access to all files until the program is quit.
Note: A Deauthenticate choice appears in the menu after an authentication is complete, in case
you decide to no longer have ChronoSync authenticated. You may want to revoke such access, such
as in a situation where you are stepping away from your computer with ChronoSync still running
and you don't want someone else to sit at the machine and have full access to all files via ChronoSync.
12
Synchronization Operations Quick Guide

To help you quickly determine which operation is best for you, the following guide describes each operation in detail.
Backup Left-to-right
The left target will be monitored for changes and compared to the right target. Any changes detected will
be copied to the right target. Note: The first time a Backup Left-to-right synchronization is run, deleted
files from the left target will not be deleted from the right target.
Backup Right-to-left
The right target will be monitored for changes and compared to the left target. Any changes detected will
be copied to the left target. Note: The first time a Backup Right-to-left synchronization is run, deleted
files from the right target will not be deleted from the left target.
Synchronize Bidirectional
Both targets will be monitored for changes. Any changes detected will be copied to the opposite target.
Note that the first time a bidirectional synchronization is run, deleted files from one target will not be deleted from the other target.
Blind Backup Left-to-right
The left target will be monitored for changes. Any changes detected will be copied to the right target. Important: If a file in the right target is modified or deleted, it will not get replaced by the same file in the
left target unless the left file has actually changed. Also, the first time a Blind Backup Left-to-right synchronization is run, deleted files from the left target will not be deleted from the right target.
Blind Backup Right-to-left
The right target will be monitored for changes. Any changes detected will be copied to the left target. Important: If a file in the left target is modified or deleted, it will not get replaced by the same file in the
right target unless the right file has actually changed. Also, the first time a Blind Backup Right-to-left
synchronization is run, deleted files from the right target will not be deleted from the left target.
Mirror Left-to-right
Files will only be copied left-to-right. If a file on either the left or right target is modified, it will result in
the left file overwriting the right file. Note: The first time a Mirror Left-to-right synchronization is run,
deleted files from the left target will be deleted from the right target.
Mirror Right-to-left
Files will only be copied right-to-left. If a file on either the left or right target is modified, it will result in
the right file overwriting the left file. Note: The first time a Mirror Right-to-left synchronization is run,
deleted files from the right target will be deleted from the left target.
Bootable Left-to-right
A bootable clone of the left target will be copied to the right target. Only volumes can be specified for this
operation.
Bootable Right-to-left
A bootable clone of the right target will be copied to the left target. Only volumes can be specified for this
operation.
13
Bootable Mirror Left-to-right
A bootable clone of the left target will be copied to the right target. If a file on either the left or right target
is modified, it will result in the left file overwriting the right file. Only volumes can be specified for this
operation.
Bootable Mirror Right-to-left
A bootable clone of the right target will be copied to the left target. If a file on either the left or right target
is modified, it will result in the right file overwriting the left file. Only volumes can be specified for this
operation.
Setting Up A Synchronization
The first step to setting up a Synchronizer document is to decide which computer will be responsible for
the synchronization. It is highly recommended that this computer be the one that has to connect to the
other. Doing so will save you a step by automatically connecting to your shared computer. In our example, you should use your laptop. We also assume youll be selecting your laptop as your left target. This is
purely for the sake of example - if you prefer your laptop to be your right target, go ahead and select it as
such.
Launch ChronoSync. The Document Organizer window appears. From here, you can create a new Synchronizer document. Once the Synchronizer document opens and, if you so choose, a filename is given,
choose your left target by clicking the Choose... button in the Left group of the Setup panel. Use the
file selection dialog to locate the folder on your laptop that contains the documents you wish to synchronize.
Next choose your right target. This will be the folder on your desktop computer with which you will be
synchronizing. Click Choose... in the Right group and navigate to the folder on your desktop machine.
Once you have selected your targets, you may specify any other desired settings, such as the operation,
options or rules.
Document Organizer Window

The Document Organizer window keeps track of all recently used documents and presents them in a
convenient-to-use window. You can also create new Synchronizer and Container documents, view the
online help and visit our support page from buttons within the window. Right-clicking an entry in the
document list provides additional options such as duplication, renaming and deletion of the selected
documents. The visibility of this window can be controlled in General Preferences under the Window
Behavior section.
14
Chapter Three
Scheduled Synchronization
Chapter 3 - Scheduled Synchronization
Chapter 3. Scheduled Synchronization

The Chrono in the name ChronoSync comes from the fact that synchronizations can be scheduled to run
automatically at any time of the day. ChronoSync offers very sophisticated scheduling capabilities. You
can schedule any number of ChronoSync documents (synchronizers and containers) so they run automatically. You can even schedule the same document to run twice, at different intervals or on different days.
The scheduling options are extremely flexible to handle almost any scenario.
Background Synchronizations
ChronoSync does not have to be running for a scheduled synchronization to occur. ChronoSync automatically installs a separate program called the ChronoSync Backgrounder, which quietly and silently monitors the scheduled items database. When a scheduled synchronization is due to occur, the ChronoSync
backgrounder will launch ChronoSync, instruct it to do its job, and then quit ChronoSync, all without requiring user intervention. It does this in a manner that wont affect any work you are performing in another application.
Utilizing the ChronoSync backgrounder is the default behavior. If, for some reason you do not desire this
behavior, you can disable it via the Scheduler panel in ChronoSyncs Preferences dialog (located under
the ChronoSync application menu). Simply turn off the Use background scheduler option. Keep in
mind that with this option disabled, ChronoSync will always have to be running for scheduled synchronization to occur.
Sequential vs. Concurrent Execution

When two ChronoSync documents are scheduled to run at the same time, ChronoSync will perform the
synchronization in the order that they appear in the Scheduled Documents Manager window (top to bottom). This is called sequential (in-order) execution. If one synchronization is dependent upon the results
of another synchronization, you should ensure the proper order of execution in the Scheduled Documents
Manager. To modify the order, simply click-and-drag the entries in the Scheduled Documents Manager.
When you do so, a divider line appears where the entry will be placed if you were to release the mouse.
If there are no dependencies between synchronizations, and you have scheduled multiple synchronizations to occur simultaneously, you may want to disable sequential execution. The result is concurrent (simultaneous) execution. Concurrent execution will take advantage of Mac OS Xs multi-threading capabilities. It will generally result in faster synchronizations, especially if you have a computer with multiple
CPUs. However, concurrent execution will have no net benefit if you dont schedule multiple synchronizations to occur at the same time.
To enable sequential execution, visit the Scheduler pane of ChronoSyncs Preferences dialog. Turn on the
setting labeled Run scheduled items sequentially.
Waking From Sleep

If you schedule your synchronizations in the middle of the night, there is a good possibility that your
computer may be asleep at the time. Sleep is a low power mode in which the contents of the computers
memory are retained, but no application programs are actually running. Many users configure their computers to go to sleep after a certain period of inactivity.
If your computer is asleep when its time to run a synchronization, there is no way for the scheduler to
perform that synchronization because all programs are suspended while the computer is asleep. Fortunately, however, ChronoSync has the ability to program your computer to wake itself up when the time
draws near to run a synchronization. This is called the wake system to synchronize feature.
Wake system to synchronize is disabled by default. To enable it, visit the Scheduler pane of ChronoSyncs
Preferences dialog.
16
Chapter 3 - Scheduled Synchronization
Note: Once you have enabled this feature, you typically will not have to re-enable it. ChronoSync
will correctly handle any changes made to your schedule after enabling this feature. From time-totime, however, ChronoSync may lose the authorization to wake the computer up. This will typically happen after installing a new version of ChronoSync or perhaps upgrading your system software. If such occurs, the ChronoSync backgrounder will display a dialog informing you of the
situation and youll have to re-visit Preferences to turn this feature on again.
17
Chapter Four
Advanced Concepts
Chapter 4 - Advanced Concepts
Chapter 4. Advanced Concepts

There are so many powerful features you can take advantage of within ChronoSync. This section is
geared for those more advanced users who are interested and willing to push ChronoSync to the limits.
This section covers some advanced concepts in synchronization.
Note: If you encounter a specific situation not covered in this manual, use our online support form:
http://www.econtechnologies.com/support/open-ticket.php.
Change Detection
ChronoSync detects changes differently from how most other synchronization programs do so. Because
of this, weve prepared a simple primer on the logic employed for change detection. Understanding just
how ChronoSync detects file changes is very useful when configuring synchronizations. It is also very
useful to understanding some of the advanced concepts presented in this chapter.
The technique employed by ChronoSync for change detection is called relative state monitoring. In a nutshell, what this means is that ChronoSync compares the current state of a given file against the last known
state of the same file - the comparison is relative to the last known state. For example, if the current modification date of a file is April 13th, 2014 12:15 PM, but the last known modification date of the file is
April 19th, 2014 7:45 AM, ChronoSync determines that the file has changed, even though the current
modification date is older than the last known modification date. By monitoring for changes relative to
the last known state, ChronoSync can detect changes in various scenarios that would go undetected (or
worse - detected the wrong way) by simply comparing the files in each target against each other.
Collection
The first time ChronoSync encounters a file, such as in your initial synchronization or when a new file
has been created in a target, that file is in an uncollected state. This means that ChronoSync has never encountered this file before and thus has no reference information to compare it against. In such an instance,
ChronoSync has no choice but to compare the file against its counterpart - the same file in the opposite
target. If a difference is detected, the file is tagged for synchronization. After synchronization occurs, or if
the counterpart was determined to be identical, ChronoSync collects information on both files in the file
pair. Once it does this, ChronoSync will have recorded the last known state of both files and will employ
relative state monitoring for each subsequent synchronization.
Note: You can tell if ChronoSync has collected the state information for a file pair if the Last Synchronized column in the Analyze panel contains a date and time.
The Last Identity Test

When ChronoSync determines that a file has changed relative to its last known state, before it goes ahead
and tags that file as needing synchronization, it will perform one last test between the actual files on each
target. Basically, it tries to determine if the files stored in each target possess the same attributes as each
other. If so, it simply updates the information it has recorded on the files and moves on without synchronizing the file pair. This prevents unnecessary synchronizations from occurring in instances where you
may have manually copied a file from one target to another using the Finder or another program (which
may be ChronoSync via another Synchronizer document).
19
Deletions
Relative state monitoring makes it very easy for ChronoSync to detect deletions. In some synchronization
programs, deleting a file from one of your targets may result in its counterpart getting copied back over
the deleted copy. ChronoSync, however, can easily detect the deletion because a file for which it has previously collected state information simply doesnt exist anymore - a clear sign that it has been deleted!
Triggers
The above example uses a files modification date as the criteria for determining whether or not a file has
changed. This is by far the most common and universal method for detecting file changes since the operating system automatically updates a files modification date when data is written to it. However, there is
some information about files that arent stored within the file itself but are necessary to synchronize. This
information is known as metadata and it covers pieces of information such as who owns the file, its access
permissions, its Finder color label and whether or not its file extension is hidden, to name a few. ChronoSync can detect changes to a files metadata. Exactly which metadata ChronoSync should monitor for
changes are user definable and are called triggers.
You can mix and match which attribute changes will trigger a synchronization. This is useful in situations
where you may simply not care about changes to certain metadata or when you are synchronizing to a
device that does not support certain metadata and/or cannot support it reliably. An example would be a
file server for which there is no way to maintain the same owner/group membership as your local machine.
Anomalies?
While relative state monitoring produces more accurate synchronizations than alternate approaches, there
are times when it may appear that it is not synchronizing a file pair accurately. In such a case, for instance, you may have selected a file pair in the Analyze panel that ChronoSync indicates is synchronized
with each other (a check-mark for status), yet clearly, the detailed file information displays a discrepancy.
The cause for such a discrepancy could be many things, but is usually one of the following:
l
important l
l
l
l
Discrepancy #1 - Incapable File System: Not all file systems are created equal. Most non-HFS file systems, in fact, cannot associate all of the metadata that Mac OS X associates with its files. In such cases,
ChronoSync will attempt to apply the metadata to to the destination file, but if the file system doesnt
support it, nothing more can be done. However, since ChronoSync records the last known state of the destination file, it will know that the file cannot retain all of the properties of the original. Thus it wont consider the discrepancy a problem - it may be a problem in the purest sense of the word, but it isnt a
problem that ChronoSync, or any other application, could do anything about!
Note: Most external Firewire and USB hard drives are shipped pre-formatted with a Microsoft
Windows-specific file system. This filesystem is accessible by Mac OS X but does not support all of
the metadata that HFS supports. Unless you need to share such hard drives with Windows based
computers, they should be reformatted with the HFS-Extended file system using Disk Utility.
Discrepancy #2 - Source File Hasnt Changed: If performing a unidirectional (left-to-right or right-toleft) synchronization, and ChronoSync has collected information on a file pair, all that ChronoSync cares
about is whether or not the source file has changed. For example, if synchronizing left-to-right and you
modify a file on your right target, ChronoSync will still list that file pair as in sync. This is because the
file in your left target (your source target) hasnt changed at all, and its counterpart, which has changed, is
newer than your source. If you were synchronizing bidirectionally, however, ChronoSync would indicate
the file pair as out-of-sync and needing to be copied right-to-left.
Note: It is possible to configure ChronoSync so that it would detect the file pair in this example as
out-of-sync. Setting up this synchronization as a Mirror operation would do this.
20
Baseline Synchronizations
When configuring a synchronization document for the first time, you may have the need to perform a
baseline synchronization. A baseline synchronization goes through all the steps normally performed by a
full synchronization, but it doesnt actually synchronize any files. It collects the states of all files in your
targets, saving this recorded information in the Synchronizer document. Baseline synchronizations are
invoked using the Baseline scan... command in the Action menu.
Note: Baseline synchronization performs a specific role that is useful only in very specific and advanced scenarios. You do not need to invoke this function for so-called ordinary synchronizations.
If you do not understand this feature, but feel you may need to use it, contact support and well
help determine if a baseline synchronization is necessary.
Baseline synchronization is useful when starting with two targets that already contain a set of files that
you consider synchronized. For example, suppose you used the Finder to copy all your files over to an
external Firewire hard disk that is formatted using a Microsoft Windows compatible filesystem. As mentioned previously, numerous pieces of metadata will not get associated with the copied files. If you then
use ChronoSync to set up a synchronization, it will detect countless file differences because of the fact
that metadata was not correctly associated with the files. Rather than isolate and disable the trigger associated with the metadata discrepancy, you can simply perform a baseline synchronization - ChronoSync
will collect state information on every file and use that for its relative state monitoring on all subsequent
synchronizations.
Another popular use of a baseline synchronization is when configuring a Blind synchronization to function in a blind backup capacity. You may initially want to start with an empty target. The only way to prevent ChronoSync from copying all files to your empty target on its initial synchronization is to perform a
baseline synchronization first. See the section on the Blind synchronization mode for more information.
Extended Attributes & Access Control Lists

ChronoSync supports both Extended Attributes and Access Control Lists. Extended Attributes are arbitrary pieces of information that you can attach to any file. The information can be small (such as a version
number) or large (such as PDF data containing an entire user manual on how to use the file it is attached
to).
Access Control Lists are an extension to the standard UNIX access model. They provide much finer grain
control over what users and groups can access specific files. They can also override standard user/group
access limitations.
Whenever possible, ChronoSync will try to preserve extended attributes and access control lists. There are
occasions, however, such as when communicating with a foreign file system and/or file server, that such
preservation is not possible. In this instance, you may want to enable the "Ignore extended attribute and
access control list errors" option in the "Reporting & Error Handling" group in the Options panel or else a
large number of files may report errors when synchronized.
21
Package Files
Mac OS X packages are simply folders disguised to look like single files when presented in Finder. The
most common examples are applications. Within an applications package file, you may find property
lists, icons, string files, resources and any other supporting files necessary to run the application.
ChronoSync supports package files. By default, it continues to present and treat packages as single files,
not folders. Thus when ChronoSync detects a package file has changed, it really means that some file
within the package has changed and that when ChronoSync copies a package file, it is actually copying a
folder and all its contents.
If you don't want ChronoSync to treat packages as files, you should turn "Dissect Packages" ON, in the
Options panel. In doing this, packages will then be treated as folders.
Since a package is a folder masquerading as a file, you have the option of selecting a package as one of
your targets. This is useful for cases where packages are used to store massive amounts of data, such as
iPhoto libraries and such. To do this, choose the Allow package selection option in the file selection
sheet (when you select Choose... for your target).
Connecting to File Servers

Using ChronoSync to connect to a file server is a popular way to synchronize data between two computers or to backup your data in a central repository. You typically connect to a file server via a wired connection, such as Ethernet, or a wireless connection, such as Airport. Once connected, the remote computer
appears as a volume on your desktop. You can specify this volume, or more likely, a folder within this
volume as one of your targets in a ChronoSync Synchronizer document.
Regardless of the physical connection method, one of the two computers will have to be set up to allow
the other to share files. If you are synchronizing with a central file server, your servers administrator will
have to set up a user account and password for you. Once this is provided, you may skip ahead to Connecting Via File Sharing, later in this section.
However, if you are connecting directly to another computer (such as a laptop), you must enable file sharing on one of your computers. Either computer can have file sharing enabled, but you will have to do so
on the machine that will not be running ChronoSync. Thus if you have a desktop/laptop configuration,
and prefer to run ChronoSync from your laptop, youll have to configure file sharing to be enabled on
your desktop machine.
Enabling File Sharing
To enable file sharing, launch System Preferences and choose the Sharing pane. If File Sharing is
unchecked, turn it on by clicking the checkbox in the list (you may have to authenticate first). When file
sharing is enabled, a descriptive message on the Sharing pane provides information on how you can connect to this computer - you may want to make a note of this. Once file sharing is turned on, it will remain
on, even between restarts of the computer. The only way to turn it off is to revisit the Sharing preferences
panel and turn it off.
Connecting Via File Sharing
The next step in achieving connectivity is to connect to the shared computer from your other machine. For
the sake of this example, we will assume you are doing so from a laptop computer. To do this, open a
Finder window and look under the Shared group in the sidebar to find a list of servers.
A list of all available computers should appear, among which should be your desktop machine. Select it
and click Connect. You will be prompted for a name and password.
You should use the same name and password used on the desktop machine as your local user - thus if
your username on the desktop machine is jdoe, that is what you should specify when connecting to your
desktop machine via file sharing. This ensures you have access and privileges to all your local documents.
22
After doing this, a new icon will appear on the sidebar in Finder windows. This icon represents your
shared computer and you can open it and navigate the folders, just as if they were stored on your laptop.
Automatically Connecting to File Servers

The steps above show you how to enable file sharing, connect to a shared computer and specify the files
on a shared computer as one of your targets. When you select a folder on your shared computer as one of
your targets, ChronoSync automatically identifies that the target is residing on a file server. ChronoSync
then records information that it can use to automatically re-establish the connection to that file server
when performing synchronizations in the future. Seamlessly performing this operation requires a little
more information from you, however.
The first thing you need to decide is how will ChronoSync log in to your file server. There are three options:
1. No login: ChronoSync will not attempt to connect and login to your file server. In such situations,
it is your responsibility to connect to the file server before asking ChronoSync to perform a synchronization.
2. Keychain Based Login: ChronoSync will automatically attempt to connect and login to your file
server, but it will do so using a name and password that has been added to your users keychain.
3. Direct Login: ChronoSync will attempt to connect and login to your file server using a name and
password that you specify in your Synchronizer document.
Each of these options is detailed on the following pages.

No Login - If this option is desired, you will have to explicitly instruct ChronoSync that it should not try
to automatically connect to the file server. Doing so is simple. When you specified your file-server based
target in the Setup panel, an Options... dialog appeared above the Choose... button in the respective
target box.
Click the Options... button to see a list of server mounting options. The first option presented is Attempt to mount server. Turning this option OFF is all you must do to instruct ChronoSync to never attempt to connect to the selected file server when working with this Synchronizer document.
Keychain Based Login - The keychain is an operating system feature that serves as a repository for various services that require user authentication. It is a handy way to store names and passwords for various
different services and has the advantage of allowing the user to lock or unlock all entries in the keychain
in a single step.
Instructing ChronoSync to connect to a server using a keychain based name and password requires no
extra configuration in ChronoSync - it is the default technique that ChronoSync uses to connect to file
servers. When you specify a target that resides on a file server, ChronoSync assumes it should automatically attempt to connect to that file server and it should do so using a keychain-based authentication.
The extra steps that you do have to take, however, involve adding your name and password to the keychain. This is purely optional - if you dont take these steps, ChronoSync will present you with a name
and password authentication dialog whenever it is attempting to connect to a file server. If you correctly
supply this information, connection will be established and synchronization may proceed. If not, the synchronization process will be aborted.
If, however, you want to add your name and password to the keychain, you must take a couple extra steps.
These steps are taken when you initially connect to your file server.
First, you must follow the steps presented earlier in the Connecting Via File Sharing section (if you are
presently connected to a file server, you should dismount it by ejecting its icon). Once presented with the
login dialog (where you specify a name and password) you will notice the Remember this password in
my keychain checkbox at the bottom of the dialog. Choose this. You may then proceed to log in. If successful, the name and password you specified will be added to your keychain. You must then specify the
23
logged in file server, or a folder on that server, as one of your targets in ChronoSync. Forever after, ChronoSync will attempt to connect to the file server using the name and password you just added to your
keychain.
Direct Login - If you prefer not to add your name and password to your keychain, you can still configure
your Synchronizer document to automatically connect to the file server. Doing so is done in the server
options sheet, displayed by clicking Options... above your Synchronizer documents Choose... button.
Turn ON the Login as option. This enables direct login. You must then specify a username and password to connect to your file server. This should be the same user name and password you would specify
when connecting to the file server from the Finder.
When specifying direct login, your username and password are encoded in the Synchronizer document (in
an encrypted form) and used by ChronoSync when it attempts to connect to the file server.
It is worth noting that Direct Login may not work as expected under Leopard IF you also have keychain
entries for logging on to the same server. You should use the Keychain Access utility to delete any and all
keychain entries associated with this file server.
Note: If a volume cannot be mounted for whatever reason, scheduled synchronizations will not
grind to a halt. An error will be logged and the program will continue. Notifications are highly recommended to inform you that scheduled synchronizations are regularly occurring.
Other Server Options

The previous steps had you visit the server options sheet dialog in a Synchronizer documents Setup
panel. In addition to controlling the technique used for connecting to a file server, a few other options are
presented by this dialog.
The other notable settings are:
Only when synchronizing - This option is attached to the Attempt to mount server option. Turning it
on instructs ChronoSync that it should only attempt to mount the server when a Synchronize or Trial Synchronization operation is invoked. Leaving this setting off, ChronoSync will attempt to mount the server
when the Synchronizer document is first opened. The purpose of this setting is to allow you to work with
a Synchronizer document even when the file server it synchronizes with is unavailable.
Dismount server after synchronization - Instructs ChronoSync that it should automatically dismount
the server after synchronization completes. This is useful in situations where you connect to a file server
only to synchronize and have no other reason to directly access files on it.
Only if mounted by this document - This option is attached to the Dismount server after synchronization option. If turned on, it instructs ChronoSync to only dismount a server after synchronization if
ChronoSync itself was responsible for mounting the server in the first place. This option is useful if you
occasionally do have the need to connect to a server and directly access files on it outside of the synchronization process. If you established connection to the server prior to having ChronoSync perform a synchronization, you wont have to worry about ChronoSync destroying your connection to the server when
it completes.
Strict volume identification - If turned on, it instructs ChronoSync to differentiate between volumes
with the same name by comparing several low-level properties.
Removable Media
Using ChronoSync with removable media is really no different than using ChronoSync with local hard
drives. The only requirement is that your media must be mountable on the desktop, i.e. when you insert
the media into its device, an icon appears on Finders desktop. ChronoSync possesses no special knowledge about exotic devices and thus, if it cannot be mounted as a standard volume, it will not work with
ChronoSync.
24
When a volume is removable, ChronoSync detects it as such. Thus when you specify a target in a Synchronizer document that exists on a removable volume, the Setup panel will display the Options... button above the Choose.. button. Clicking Options... will display several removable media options.
Prompt to insert media - When this option is ON, ChronoSync will display a prompt dialog asking you
to insert the removable media that contains your target. This will only be displayed if the removable volume is not already mounted.
Only when synchronizing - This option is attached to the Prompt to insert media option. It indicates
that the prompt for media insertion will only be displayed when a Synchronize or Trial Synchronize operation is performed. This allows you to work with a Synchronizer document without actually having its
removable media target mounted.
Eject media after synchronization - When turned ON, this option causes ChronoSync to eject the media
containing one or both of its targets after synchronization completes.
Only if inserted for this document - is attached to the Eject media after synchronization option. This
indicates that media ejection will only occur if ChronoSync prompted the user to insert the media in the
first place. This way, if you previously inserted the media and are working with files on it, you dont have
to worry about having the media ejected on you after ChronoSync completes a synchronization.
Strict volume identification - If turned on, it instructs ChronoSync to differentiate between volumes
with the same name by comparing several low-level properties.
Note: If ChronoSync cant locate the media that contains one of its targets, the Cannot locate target message is displayed. It is your first indication that something is amiss. You can then simply
mount the volume by inserting it in the appropriate device. ChronoSync will recognize the mount
and correct its state.
File Comparison Helpers

The purpose of file helpers is to give you the ability to select the desired application that should be used to
open the specified types of files when the "Compare" function is chosen from the Analyze panel. This is
useful when you wish to open the files in an application other than the file's default application, or when
the file has no default application. If you wish to use the file's default application then no file helper entry
needs to be created.
The following is the logic that is used to determine which application will be launched when the "Compare" function is chosen:
1. First the file helper database is scanned for a helper associated with the files extension.
2. If no helper is found then the file helper database is scanned again. This time it is scanned for a
helper associated with the files type/creator code (if they are defined).
3. If no helper is found then an attempt is made to determine the default application that is used to
open the file (i.e. the application that would launch if the file were to be double-clicked on in
Finder).
4. If no default application is found then an alert is sounded and the file will not be opened. In this
case the user must set up a File Helper in order to use the "Compare" function on the file.
You may add, edit or remove entries in the file helper list. When adding or editing an entry, the file helper
editor sheet window appears.
Below is an explanation of each property in the file helper editor sheet window:
Application - This is a read-only field that displays the complete path of the application selected. The
area surrounding this field is also a drop-zone allowing you to drag an application to the area rather than
using the accompanying "Browse..." button. The selected application's icon and name will appear in the
"Application:" column of the File Helpers list.
25
Browse... - This will open the Open File dialog and allow you to select the desired application that should
be used to compare the specified type of files.
Filename Extension - This is used to specify the filename extension that a file must have in order for the
specified application to be used when opening the file. The filename extension is not case-sensitive. The
chosen filename extension will also be displayed in the "Extension:" column of the File Helpers list.
OS Type Code - This is used to specify the OS type that a file must have in order for the specified application to be used when opening the file. The OS type is case-sensitive and must be 4 characters long. The
chosen OS type code will also be displayed in the "OS Type:" column of the File Helpers list.
Note: The area surrounding the Filename Extension and OS Type Code fields is a drop-zone
for drag operations. This allows you to drag a file to the area, drop it, and have these fields automatically populated with the information that is derived from the file.
Archiving
Archiving data refers to having multiple backup copies of your data that were made at various points in
time. This maintains a history of your data. Archiving is often important since not all changes are necessarily improvements. After toiling with a spreadsheet for a week, for instance, we may come to realize
that all youve achieved is really screwing up the formulas - if only we could start over with last Fridays
version...
With archiving, it is possible to restore old files that you may have accidentally (or intentionally) deleted
or overwritten. Within the Archive panel, where these files are listed, the Restore operation can be performed to restore old files to their original location or any other location specified on the hard disk. Restoration can be accomplished by choosing "Restore..." from the Actions menu or by customizing your toolbar and choosing the Restore... toolbar icon.
Archiving is used as a way to maintain a collection of files that have been deleted or overwritten by the
synchronization process. Its a good method to use when using ChronoSync as a backup utility. ChronoSync offers archive handling options to help with the maintenance of the archived items. Using archiving
capabilities assures that older files are still available; it essentially allows you to go back in time to view
older files. Note that a separate archive is maintained for both targets.
There are two archiving instances worthy of mentioning: deleted files/folders and overwritten/replaced
files/folders.
Deleted - If the Synchronize Deletions option is turned on in the Setup panel and a file is deleted from
one target, ChronoSync will delete that file from the other target. If the Move to Archive option is selected, the deleted file will be moved to the archive where it can later be retrieved.
Overwritten/Replaced - If a newer file or folder exists in one target, ChronoSync will replace the older
file with the newer file. If archiving, the older file will be moved to the archive where it can later be retrieved.
In the Options panel there exists options specifically for the handling of archiving. The Limit duplicates
in archive to no less than # copies will act as a minimum number and will always keep at least the listed
number of versions of a file archived. The Limit duplicates in archive to no more than # copies will act
as a maximum number and will always keep no more than the listed number of versions of a file archived.
The Purge files archived more than # ago will remove files when their archive date matches the time
listed. If both features are used the Limit Duplicates... feature will take precedence.
The Archive panel is presented to you in what is known as an outline view. In this view, you are able to
expand/collapse folders, select files, perform actions and tunnel into a folder path. You can also sort and
re-arrange the columns. The Archive panel allows you view all of your archived files and lists information
about the files. You can also open, restore and delete files directly from the list by control-clicking on a
file selection.
26
Note: It is important to understand that archiving requires additional hard disk space to accommodate the extra files.
Connecting to ChronoAgent
ChronoAgent is a transparent piece of software that, when installed on a computer, allows a copy of
ChronoSync, located on another computer, to access all of the files on the ChronoAgent machine as if it
was a locally attached hard drive.
The agent is configured and controlled via a System Preferences pane. The ChronoAgent gives ChronoSync full root access to destination computers.
Once ChronoAgent has been configured on a computer, another computer running ChronoSync can connect to it. Before it can do so, however, a Connection Profile must first be defined in order to establish
communication with the agent. A connection profile can be set up within ChronoSyncs Preferences.
Check out this guide for instructions on configuring a connection profile:
http://www.econtechnologies.com/chronosync/guide-configure-profile.html
For more information on ChronoAgent and how ChronoSync connects, please consult the ChronoAgent
manual.
Note: ChronoAgent is a separate product available in a separate download.
Connecting to InterConneX
InterConneX is a file management app for the iPad and iPhone. With InterConneX, you can manage all
your files on your iDevice, connect and access your files on Macs and other iDevices, share your files
with others, and control accessibility of your files.
With InterConneX installed on an iPad or iPhone, you can set ChronoSync up to connect to an InterConneX sharespace and sync files between your iDevice and the Mac which has ChronoSync installed on it.
To do this, a Connection Profile must first be defined. A connection profile can be set up within ChronoSyncs Preferences. Check out this guide for instructions on configuring a connection profile:
http://www.econtechnologies.com/chronosync/guide-configure-profile.html
For more information on InterConneX, please visit www.econtechnologies.com.
Note: InterConneX is a separate product available in the App Store.
27
Chapter Five
Examples
Chapter 5 - Examples
Chapter 5. Examples
Synchronizing Desktops With Laptops
One of the most popular uses for file synchronization software is the synchronization of documents between laptops and desktop computers. In a hypothetical scenario, work in the office is usually performed
on a desktop computer, taking advantage of its greater processing power and additional resources. At the
end of the day (or the beginning of that business trip), all the work performed on the desktop computer
needs to be transferred over to your laptop.
Conversely, while at home (or on the road), changes are made to various documents. When returning to
the office, all changes made to documents on the laptop will need to be copied to the desktop machine, in
order to avoid accidentally modifying an out of date file.
The first step in providing a solution for this scenario is to establish connectivity between the two computers. This simply means that the two computers must be able to physically exchange information before
synchronization can occur. There are usually several ways to do this, and the exact method you use depends upon your hardware configuration and personal preference.
Setting Up Your Synchronization

Regardless of the physical connection method, one of your computers will be accessible to the other via
an icon on the desktop. The process of obtaining a connection to the other computer and having its icon
appear is called mounting. Once mounting has occurred, launch ChronoSync. The Document Organizer
window appears. From here, you can create a new Synchronizer document. Once the Synchronizer document opens and, if you so choose, a filename is given, choose your left target by clicking the Choose...
button in the Left target group of the Setup panel. Use the file selection dialog to locate the folder on
your laptop that contains the documents you wish to synchronize.
Next choose your right target. This will be the folder on your desktop computer with which you will be
synchronizing. Click Choose... in the Right target group and navigate to the folder on your desktop
machine.
The next step involves establishing the synchronizing operation. ChronoSync defaults to the Backup
Left-to-Right synchronization operation. This is deemed the safest setting and hence it is used by default.
For laptop-to-desktop synchronizations, however, you will usually want this to be Bidirectional. This
way, modifications made to files on either computer will get copied to the other machine.
You are now pretty much ready to perform your synchronization. Before you do so, however, you should
save the Synchronizer document. This document will save the settings youve just made, thus alleviating
the burden of specifying them each time you need to synchronize. To do this, just choose Save from the
Toolbar. By default, ChronoSync maintains all of your ChronoSync documents in a ChronoSync Documents folder under Documents. If you wish to change the document save location, you can do so by
choosing the path in General Preferences under Application Behavior. Here, you can also choose to
not have ChronoSync maintain a documents folder for you.
When this is all done, go ahead and click Synchronize in the Toolbar. An analysis begins, comparing all
the files in your left and right targets. After it is determined what files need to be copied, synchronization
will begin. Depending on how many files there are, this may possibly take a long time. The good news is
that, unless you make massive changes to documents when the two computers are apart, the first synchronization is the longest one youll ever perform. This is because from now on, only the files that actually
change will be synchronized.
After your first synchronization is performed, you will want to experiment and see how each successive
synchronization will occur. The first step is to quit ChronoSync. Next, disconnect from the shared computer. This is called dismounting. To do this, browse to the mounted volume in Finder and then drag that
volume to the trash in your Dock (the trash can changes to an Eject icon when doing so).
29
Once youve performed these steps, your computer is basically in the same state it would be when you
first come into the office. Locate the Synchronizer document you created and double click it. If you disconnected from the shared computer as instructed, the first thing that ChronoSync will do is to try to reconnect to it.
If the connection is via file sharing, this may involve a login dialog appearing where you need to specify
your name and password.
Now that youve done all this, how will you actually use ChronoSync on a daily basis? Given the scenario
weve been discussing, and assuming youre connecting via file sharing, heres how: At the beginning of
the day, you show up at the office and connect to your network using the usual means (Ethernet, AirPort,
etc.). Boot up both your laptop and desktop. After booting is complete, double click the Sync with my
desktop computer Synchronizer document on your laptop that you previously created. A connection will
automatically be made with your desktop. After this, simply click Synchronize. When the process completes, you can quit ChronoSync and proceed with your busy day.
At the end of the day, assuming your laptop is still connected to the network, just repeat the process double click Sync with my desktop computer and click Synchronize. Any changes made to documents on either machine will be synchronized. As long as you begin and end the day with this procedure,
all will be well.
Controlling Which Folders to Synchronize

ChronoSync is designed to be flexible. It can meet the needs of almost any synchronization or backup
strategy no matter how simple or complex. In some instances your needs may not be as simple as synchronizing one folder to another folder. You may, for example, want to synchronize many different folders
at the same level or perhaps synchronize one folder but not synchronize some of the folders contained
within it. Fortunately, there are many ways to narrow down your synchronization scope using ChronoSync. Find the one that best suits your situation below:
Option #1: Select a root folder and everything beneath it. For instance if you want to synchronize all
your personal files you would simply select your Home folder.
Option #2: Create separate Synchronizer documents for each folder you wish to synchronize. This is
a great solution if you want to synchronize some folders but not other folders. For example, instead of
creating one Synchronizer document for your home folder, perhaps you want to create three: one for
Documents, another for Pictures and a third for Library. Each Synchronizer document can be
synchronized separately.
Option #3: Add multiple Synchronizer documents to a single container document and then synchronize them all as one. For instance if you created three Synchronizer documents for your Documents, Pictures and Library folders, you could add them to a single Container document so all
three behave as one.
Option #4: You can permanently exclude any file or folder by selecting it from the Analyze panel and
choosing the Exclude command. The exclusion will be saved with the Synchronizer document and
the excluded file/folder will be skipped every time a synchronization is performed. When a folder is
excluded, all the files and folders contained within it are likewise excluded. For example, if you
wanted to synchronize your entire Home folder but did not want to synchronize your Music folder,
you could select your home folders as one of the targets and then exclude your Music folder from
the Analyze panel.
Option #5: Create rules. Rules allow you to exclude specific files and folders from a synchronization.
For instance, if you just want to backup all your Photoshop files to an external hard drive no matter
where they are located on your Mac you could select your entire Macs hard drive as one target and a
folder on the external hard drive as the other Target. You could then create a rule to only synchronize
Photoshop files - all other types of files will be skipped.
30
Option #6: Use a combination of the above methods to synchronize exactly what you want. For instance, what if you wanted to synchronize your entire home folder but not your Library folder, but
you do want to synchronize your Mail folder (which resides in Library)? You could create a Synchronizer document to synchronize your entire home folder but excluding your Library folder via
the Exclude action. Then you could create a second Synchronizer document to synchronize just
your Mail folder. Finally, you could combine both Synchronizer documents in a single Container
document. This way your Library folder gets completely excluded but the Mail folder still gets
synchronized. Furthermore, any new folders added to your Library folder would not get synchronized so you would not have to modify your exclusions in the future.
Cloning Data Using a Mirror Synchronization

The terms synchronization and cloning are often used interchangeably and for good reason - they each
represent a process that many consider functionally identical. We at Econ, however, make a distinction
between the two. Cloning is the process of making one target appear identical to another. Thus any change
in one target is projected to the other, no matter what. It is a brute force technique that makes no consideration for the possibility that data is legitimately changing in both targets, often simultaneously.
Synchronization, on the other hand, is a process that involves a little more finesse. It seeks to identify
changes in one target and to merge those changes with the opposing target. It does take into consideration
the possibility that data is changing in both targets and it also takes into consideration that there may be
data in the opposing target that is not a part of the synchronization.
The difference between synchronization and cloning are subtle but real. Both techniques have their uses
and which one is better depends on the specific task that is being performed.
Prior to version 3.0, ChronoSync had no true cloning capability. Version 3.0, however, introduced the
concept of the biased synchronization mode. To make the terminology easier to understand, we now call
this process mirroring. Mirrored synchronizations look for differences between file pairs, just as the
Backup synchronization does. However, when a difference is detected, it always copies the file in a predefined direction, even if that means a newer file will be replaced by an older one.
For example, suppose you run a computer lab in a school and you want each computer configured with a
certain set of applications and documents for your students to use. Kids being kids, they frequently delete
important files, modify and overwrite existing ones or create new files altogether. At the end of the day,
you need to restore each machine to a pristine state. To do this, you could just copy all the files over using
the Finder. But if we're talking hundreds or thousands of files (especially if they're big), this can be quite
time consuming.
Instead you could set up a mirror left to right synchronization document that synchronizes a master set
of files (the left target) with the students computer (the right target). The result is that any file the student
modified will get updated; any file the student deleted will get copied back over; and, if synchronize deletions is enabled, any files the student created will get removed. This practice gets more efficient when you
realize that any changes that you may make to the master target will get intelligently merged with all the
students' computers.
Changing Archive Location

ChronoSync saves deleted and modified files by storing them in an archive folder. The Archive panel
shows the contents of your archive folder and makes it easy to find, sort, and manage your archived files.
It maintains a history of your archived files.
At this time, the archive folder is placed at the root level of your target. ChronoSync places it there. To
maintain the archived items folder in a different location, you must create a symbolic link at the root level
of your target named "_Archived Items". That symbolic link can point to any other folder on your hard
drive or even an external hard drive or file server. If you don't have a graphical tool for creating symbolic
links, you can do so using the Terminal application.
31
Note: It is important to mention that this process is a bit of a hack and is considered an unsupported feature.
Here are the steps to follow:
1) Create a folder that will serve as your "real" archived items folder. This can be on any locally attached
hard drive or even a file server. Once created, make sure the folder icon is accessible in the Finder, i.e.
keep a Finder window open that displays the newly created folder (the folder icon itself, not its contents).
2) Using Finder, make sure the root folder of the target in which you want to create the symbolic link is
accessible, i.e. keep a Finder window open that displays the target's root folder (the folder icon itself,
not its contents).
3) Launch Terminal.
4) Type "cd " (DON'T type the quotes and DO type the space at the end).
5) Drag & drop the target's root folder icon from the Finder over to the terminal window. This automatically pastes the pathname of the folder icon into the Terminal shell.
6) In Terminal, press the RETURN key. You should have now changed the current working directory in
Terminal to the root folder of your target.
7) In Terminal, now type "ln -s " (again, DON'T type the quotes; DO type the space at the end).
8) Now drag & drop the folder icon you created in step 1 to the Terminal window. This pastes the full
pathname of the "real" archive folder into the Terminal shell.
9) In Terminal, now type "_Archived Items" (just to confuse you, this time you DO type the quotes).
10) In Terminal, press the RETURN key.
Assuming you did everything correctly, you have just created a symbolic link to the "real" archived items
folder. You can verify this by looking inside your target folder using Finder - you should see what appears
like a folder alias that takes you to the "real" archive folder. ChronoSync will resolve this alias and manage the archive in the new location.
Why this is an unsupported feature? Because ChronoSync does nothing to check the validity of the symbolic link. If it becomes broken, it is going to fail miserably. The most likely situation that this can happen
is if the archive is on a file server or external drive that is not mounted. ChronoSync will not try to mount
the volume. Things could also go wrong if the "real" archive folder is moved or renamed. If this unsupported feature is utilized in a situation where the "real" archive folder could become unavailable, you
should combine it with a pre-synchronization script that ensures the validity of the archive folder before
allowing synchronization to proceed.
In a future version of ChronoSync, this will become an official feature, providing a full user interface and
archive validation that will make selecting an alternate location for your archive very easy.
Synchronize 3 Macs
You can synchronize 3 Macs - or even three computers provided at least one of them is a Mac. There are
two very important rules:
1. You cannot work on more then one computer at a time because if two users are working on the
same file then one of the files will get copied over and lost.
2. You must always run your synchronizations when switching Macs so the data is kept up to date.
First you need to decide which computer will be the Master. Then you need to decide if you want to synchronize from the Master to the two other computers or synchronize from the two other computers to the
Master. You must synchronize from a Mac.
32
A = Master
B = Remote
C = Remote
Synchronizing from the Master
Master must be a Mac.
Set up two Synchronizer documents that Synchronize Bi-directionally with deletions checked.
Both Synchronizer documents reside on the Master Mac.
First document synchronizes A to B and second document synchronizes A to C.
Synchronizing from the Remotes
Remotes must be Macs.
Set up two Synchronizer documents that Synchronize Bi-directionally with deletions checked.
One Synchronizer document resides on the Remote Mac B and the other on Remote Mac C.
First document synchronizes B to A and second document synchronizes C to A.
For more examples of how to use ChronoSync, check out the ChronoSync guides on the Econ Technologies website: http://www.econtechnologies.com/chronosync/guides.html.
33
Chapter Six
Common Errors
Common Errors
Chapter 6. Common Errors

At times, while running a synchronization, errors may occur, alerting you to some problem with a certain
file within the synchronization tree. Below lists some common errors you may encounter while using
ChronoSync.
Dealing With Conflicts & Errors

Sometimes a file will not get copied because of an error or conflict between the two files. In all such cases
ChronoSync will notify you of the problem. In the case of an error it will notify you of the problem by
displaying an error message. In the case of a conflict, ChronoSync will provide you with a file conflict
sheet to let you resolve which file should be used in the synchronization.
Conflicts
A conflict arises when two files have been determined to have both changed since the time of last synchronization. While one file will likely be more recent than the other, ChronoSync decides to err on the
side of caution and flag these files as a conflict. When such is detected, a conflict resolution sheet appears.
When presented with this sheet, you can decide which file should actually be used. Do so by clicking the
radio button associated with the desired file and then clicking the Continue button.
If you cant decide which file should be used, just click Skip. Synchronization will resume as normal,
only nothing will be done with the conflicting files. You can then use the Analyze panel to determine
which one is the correct one.
You may also select the Ignore all additional conflicts by... option that provides you with a popup menu
of options. Choosing one of the options will inform ChronoSync what to do with future conflicts. This
choice only applies to the synchronization being performed - it does not stick for all future synchronizations.
If you determine that the conflict exists for a reason, and theres nothing you can do to resolve it, click the
Exclude button. This will exclude the file pair from synchronization and wont report a conflict for
them ever again. You can undo an exclude in the Analyze Panel using the Include command.
Choosing the Abort button will abort the synchronization process. When this is done, only the remaining files that have not been copied yet remain out of sync.
Note: Because conflicts are dependent on two files changing, they can only occur while doing a bidirectional synchronization. In the Options panel, you will find settings that allow you to automatically handle file conflicts. If your synchronizer is scheduled, conflicts will automatically be skipped
unless these conflict handling options have been specified.
Errors
When an error arises in the course of synchronization, an error sheet window will appear. If it is a scheduled synchronization, the error will be skipped but posted to the Log or, if set up properly, emailed to you.
At this stage, you can abort the entire process by clicking Abort. This gives you a chance to immediately resolve the problem and then re-invoke the synchronization.
Instead of aborting, you can choose to ignore the error and continue synchronizing. Do this by clicking
Continue. The error will get posted to the log for later review. If a string of errors arise and you just
want to finish synchronizing what you can, enable the Skip any additional errors check box. This will
still post errors to the log, but wont annoy you with additional error sheets.
The Retry button, as the name implies, will retry the operation that induced the error. Sometimes, the
condition that caused the error can be rectified, such as if the file in question is reported as being used by
35
Common Errors
another application. If it succeeds, it will resume the synchronization as normal. If not, it will display the
error message again.
Sometimes an error will repeatedly occur that simply cannot be corrected. For example, a file name may
be too long to be synchronized with a target whose file system doesnt support long file names. In this
case, you may quickly and easily exclude the offending file from future synchronizations by clicking the
Exclude button in the error sheet. You can undo an exclude in the Analyze panel using the Include
command.
Date Roll Backs

Date roll backs occur when the modification date of a file has gone back in time from its previous known
setting. Under normal circumstances, this should never happen. It can accidentally happen, though, when
you inadvertently replace a new file with an older one or it can also happen if something has gone wrong
with clock synchronization between two computers or the system clock setting on your computer. When
dealing with this, extra care should be taken to make sure something isn't seriously wrong with your computer.
Note: If your synchronizer is scheduled, date roll backs will automatically be skipped unless you
have specified date-roll back handling in the Options panel.
To track down the files you can get a list of the files and errors in the Synchronizer documents Log.
To handle date roll back errors before they occur, you can use the Pre-determination feature in the Options
Panel. This feature lets the Synchronizer document know how to handle a roll back error in case one is
encountered. It makes it so that user interaction isn't needed during the synchronization.
The most common cause is that the files were open and modified by an application at the time of the previous synchronization, but when they were closed by their respective application, the application took it
upon itself to restore their original modification date. Microsoft applications are notorious for this, but it
isn't purely a Microsoft behavior. Other legitimate causes would include the manual restoration of some
files by you; such as files you previously modified but then decided to replace them with original versions.
This said, we suggest you first try to determine why the files are going back in time. Once you understand
the cause and determine that there isn't a deeper issue, dealing with them in ChronoSync is pretty easy.
Your first option is to do nothing. A roll back is usually a relatively rare event; so dealing with the warning messages as they come up shouldn't be that much of a nuisance. This also allows you to catch legitimate instances where a file has gone back in time but you don't want it to synchronize.
In some cases, living with the warning messages may not be practical, especially if the synchronization is
scheduled. If this is the case, you can "predetermine" how ChronoSync deals with roll backs. In the Options panel of your Synchronizer document, in the "Reporting & Error Handling" section, you'll notice
some "Pre-Determination" settings. You can enable roll back pre-determination via the check box and
choosing the desired method of dealing with roll backs from the popup menu. Your options are:
Ask User: ChronoSync will stop at each date roll back error and ask you how you would like to proceed.
Once you choose your selection from the dialog, ChronoSync will continue on with the synchronization.
Skip: Don't synchronize the file just because it has gone back in time. If you always want your backed-up
file to have a more recent time-stamp, then this is the way to go.
Exclude: This will mark such files as "Excluded" and then they will be permanently ignored. You'd have
to have a really good reason to choose this option. Otherwise, stay away from it!
Copy: This will copy files that have gone back in time. If you want your backed up files to be an exact
image of your source files, then this is the way to go. We recommend enabling "Archive when replacing"
if you choose this option. That way, "accidental" rollbacks wont permanently wipe out a critical file.
36
Common Errors
Abort: This selection will cause the synchronization to abort if a date roll back error occurs. In this instance, it allows you to look into why the error occurred, handle it and then restart the synchronization.
Daylight Savings
When you run into a synchronization problem that is related to a Daylight Savings Time switch, it is not a
ChronoSync issue but an issue with the Mac OS.
Notice that the time difference appears if you do Get Info on the files from Finder. That is because the OS
is reporting the difference in time. It is due to an incompatibility between either the connection method or
the format of the destination. The best thing to do is to copy over the differences and then everything will
be in sync again. We must rely on the OS for reporting the correct times. It is impossible for ChronoSync
to try and interpret when a time is correct and when it is not.
Disk Full
If ChronoSync returns a disk full error, check your destination for available space. ChronoSync needs
enough space to handle all the files plus twice the size of your largest file.
Also, if you have an Archive, make sure the synchronization can accommodate this.
Apple Error Codes

Oftentimes ChronoSync will spit out error codes in its log messages. Mostly these error codes are generated by the OS, not ChronoSync. To get a better understanding of these codes, visit our tech note Error
Numbers Reported by ChronoSync.
37

ChronoSync 4.5 Manual

Uploaded by

Copyright:

Available Formats

ChronoSync 4.5 Manual

Uploaded by

Document Information

Copyright

Available Formats

Share this document

Share or Embed Document

Sharing Options

Did you find this document useful?

Is this content inappropriate?

Copyright:

Available Formats

ChronoSync 4.5 Manual

Uploaded by

Copyright:

Available Formats

ChronoSync

Econ Technologies, Inc.

This manual is intended to cover the more advanced concepts of ChronoSync.

Chapter 2. Basic Overview!

Blind Backup Operation!

Synchronize Bidirectional Operation!

Document Organizer Window!

Chapter 3. Scheduled Synchronization!

Sequential vs. Concurrent Execution!

Waking From Sleep!

Chapter 4. Advanced Concepts!

The Last Identity Test!

Extended Attributes & Access Control Lists!

Automatically Connecting to File Servers!

Other Server Options!

File Comparison Helpers!

Synchronizing Desktops With Laptops!

Setting Up Your Synchronization!

Controlling Which Folders to Synchronize!

Cloning Data Using a Mirror Synchronization!

Changing Archive Location!

Chapter 6. Common Errors!

Dealing With Conflicts & Errors!

Date Roll Backs!

Apple Error Codes!

Econ Technologies, Inc. Software License Agreement

ChronoSync Users Manual!

ChronoSync Users Manual!

Chapter 2 - Basic Overview

Chapter 2. Basic Overview

is like a folder to keep different backup or synchronization set ups

ChronoSync Users Manual!

Chapter 2 - Basic Overview

Blind Backup Operation

I dont understand very well the purpose of this operation

Synchronize Bidirectional Operation

ChronoSync Users Manual!

Chapter 2 - Basic Overview

the bootable operation is not described in detail

ChronoSync Users Manual!

Chapter 2 - Basic Overview

Synchronization Operations Quick Guide

ChronoSync Users Manual!

Chapter 2 - Basic Overview

Bootable Mirror Left-to-right

Document Organizer Window

ChronoSync Users Manual!

Chapter 3 - Scheduled Synchronization

Chapter 3. Scheduled Synchronization

Sequential vs. Concurrent Execution

Waking From Sleep

ChronoSync Users Manual!

Chapter 3 - Scheduled Synchronization

ChronoSync Users Manual!

Chapter 4 - Advanced Concepts

Chapter 4. Advanced Concepts

The Last Identity Test

ChronoSync Users Manual!

Chapter 4 - Advanced Concepts

ChronoSync Users Manual!