Define synchronization directories

Synchronization directories allow you to compile, run, and debug files that are on the remote server.

This task assumes you have added a remote host. You must connect to the remote directory using SSH.

Warning: Do not delete the server directory during an operation on the files.
  1. Select Tools > Server Connections and select a remote host from the list.
  2. Select the Use synchronization directories radio button.
  3. In the Synchronization Directory Table, add a directory.
  4. Enter the local directory path, where your source files and project will be stored.
    Note: The local directory must be an absolute path.
  5. Enter the remote directory path, which will be synchronized with the local directory. If you are using this directory for the first time, it should be empty.
    Note: When the remote directory is associated with the local directory, it is not possible to associate it with another local directory. The association happens only the first time you synchronize the local directory with the remote one.
  6. Optional: You can exclude some files or directories from being synchronized when synchronizing back from server to client. Enter a list of file names or file patterns (for example, *.42m) separated by spaces.
  7. Select Apply.
  8. Define remote Genero installations, GAS configurations, and environment sets.

When a PM operation (for example, build, run, debug) is done, Genero Studio checks whether the targeted files belong to a synchronization directory. If Genero Studio finds a directory where these files are located, then it synchronizes this directory with the associated remote directory before executing the operation. When the synchronization is complete, the remote directory is identical to the local one. A second synchronization is then performed from server to client; after this, the local directory is identical to the remote one, except for any files in the exclude link.

If Genero Studio does not find a directory with these files, an error is thrown and the PM operation stops.

Note: Directories have a lock mechanism to prevent two instance of Studio to synchronize them at the same time. Occasionally, the directory can be stuck in a locked state and no operations can be performed. In this case, select Tools > Genero Tools > Unlock Synchronization Directory.