Synchronizing single and multi-context projects

The Remote Reconciler can be used to manually or automatically push and pull files in a local project to and from the remote location for a single context project or to and from the [current] context for a multi-context project. It can also be used to push files automatically to multiple locations for a multi-context project.

About this task

The Remote Reconciler actions are available from the Project Explorer view as well as the Remote Reconciler view.

Procedure

  • To synchronize from the Remote Reconciler view:
    1. In the Remote Reconciler view, select the project or file(s) you wish to synchronize.
    2. Right-click on your selection, and select one of the following:
      • Synchronize Refreshes the view, looking only for changes to the local resources.
      • Push/Pull Settings: Lists the settings available for synchronization with remote resources. These settings are also available when you open the project preferences and select the Remote Contexts page, but directly from the Project Explorer view.
        Configure Automatic Synchronization...
        The default Remote Refresh Interval (in seconds) is set to 0. A zero setting indicates that no automatic synchronization is done. Change the setting, for example to 10 to indicate that you would like to looking for local and remote changes to the project resources every 10 seconds.
        Push on Save
        When enabled, the resource will be pushed every time a save is performed on the resource to the <current context>.
        Push to All Contexts
        When enabled, the resource will be pushed every time a save is performed on the resource to all contexts available for the project. Push on Save must be enabled to enable Push to All Contexts.
        Push on Build
        When enabled, the resource will be pushed every time a build is launched for the project. Also check Project > Build Automatically setting to set the automatic build option for the project. Push on Build is not available for C/C++ projects.
        Pull on Remote Update
        Pulls all files in the remote location of the project into the project. Certain file types are ignored for download. These can be changed in the Remote Reconciler preferences.
      • Push To: Pushes selected resources. You must only select pending local resources to perform this action.
        <current context>
        context list
        Pushes selected resources with pending local changes to the context that you select in this list. <current context> is the remote context set as [current] in the Remote Contexts view. The <current context> is displayed at the top followed by any other contexts if any have been added to the project.
        All Contexts
        Pushes selected resources with pending local changes to all context that have been add to your project as listed above this menu.
      • Push All To: Pushes all files in the project. There must be at least one pending change to perform this action. This action is only available at the project level.
        <current context>
        context list
        Pushes selected resources with pending local changes to the context that you select in this list. <current context> is the remote context set as [current] in the Remote Contexts view. The <current context> is displayed at the top followed by any other contexts if any have been added to the project.
        All Contexts
        Pushes selected resources with pending local changes to all context that have been add to your project as listed above this menu.
      • Pull from <current context>: Pulls selected resources with pending remote changes from the remote context set as [current] in the Remote Contexts view.
      • Replace Remote: Replaces the remote file with the local copy. This option is only available at the file level when there is a pending local change or conflict.
      • Replace Local: Replaces the local file with the remote copy. This option is only available at the file level when there is a pending remote change or conflict.

    Feedback