Resetting workspace configuration files

You can reset the workspace configuration files that you downloaded from the remote system by clearing the cached files.

About this task

Remote configuration files are stored in your workspace in a folder named workspacePath\RemoteConfigurationFiles. This folder contains the following subfolders:
  • A folder that is named global, which contains global configurations. Global configurations are defined on the primary push-to-client server.
  • One folder for each remote system to which you connect and that is enabled for push-to-client.
Clear Cached Files on the Configuration Files preference page deletes some of the contents of the RemoteConfigurationFiles folder.
You might consider clearing the cached files in the following circumstances:
  • If you are the push-to-client administrator, and you discover that you set preferences or configured features in a way that you did not intend to export to the remote system or group with which the workspace is associated.

    If you discover that you exported configurations that you did not intend to export, then you can clear the cached files, reconfigure the workspace, and then export the configurations again. Clear Cached Files provides a way to start over with workspace configurations.

  • If you downloaded configurations that you did not intend to download when you connected to a remote system.

    When you connect to a remote system, the push-to-client feature prompts you with a list of recent configuration updates. From this list, you can select the specific configurations that you want to download. If you select a configuration by mistake, you can clear the cached files, disconnect from the remote system, and then connect again to choose the configurations you want to download.

Important: If you changed configurations that are downloaded from a remote system and you clear the cached files, then any local changes you made to the downloaded configurations are overwritten the next time you connect to the remote system.

Configurations that you create locally, such property groups, are saved in a folder that is called client and are not deleted when you clear the cached files.

Procedure

To reset downloaded configuration files:

  1. On the Preferences window, navigate to Remote Systems > Configuration Files.
  2. Click Clear Cached Files.
    The next time that you connect to any of the remote systems that are enabled for push-to-client, you are prompted to accept configuration changes.

Results

Clearing the cached files affects your workspace in the following ways:
  • Eclipse preferences: No change. The preferences that you set are left as they were even after the cache is cleared. The Eclipse preferences are managed by the Open RSE base program, which has its own repository for the preferences. Clearing the cached files deletes only the local files in the RemoteConfigurationFiles folder.
  • Remote connections: No change. The remote connections are managed by the Open RSE base program, which has its own repository for the remote connections.
  • Property Groups: The imported property groups are deleted. Property groups use the RemoteConfigurationFiles folder as its repository and do not have another repository.
  • Mappings: The imported mappings are deleted.
  • Software Analyzer Configurations: No change. The software analyzer has a different repository from the RemoteConfigurationFiles folder.