Your work area is created automatically when
you create a project and when you check out a project using the check-out
commands. As you add new members to your project, your work area is
updated automatically. A sync operation writes out the database files
to the work area.
Manually sync (force
a sync) your work area in these cases:
- You "clean out" (delete) any or all objects in your
work area.
When you force a sync, only the necessary
(controlled) objects from your database are written out to your work
area.
- The work_area command fails while
changing your work area path.
When you change your
work area path from the CLI or the GUI, your work area path is updated
to the new location. If another application is using the old work
area path, the move fails. Synchronize your work area.
- You change your work area type from one that uses
local copies to one that uses symbolic links (or vice versa).
If you want to change your work area type:
- Reconcile the work area that you are currently using
(either local copies or symbolic links).
- Delete the work area objects from the file system.
- Set your work area path and options.
- Start a new session using the client option of choice
(either local copies or symbolic links).
- Re-create your work area by forcing a sync (execute
the sync command).
Note: To stop a
sync from the CLI, enter
CTRL+C at any time.
If
you stop the sync, an error message displays stating that errors might
occur in your work area. The errors do not occur until you try to
use the work area. To avoid problems, perform a complete synchronization
of the work area before you use it.
The sync command supports the
"Rewriting the work area" subcommand.