Knowledgebase

Search:     Advanced search

Surround SCM Dreamweaver Integration

Article ID: 755  |  Last updated: 12 Apr, 2016

Surround SCM supports integration with Dreamweaver. See Surround SCM Third-Party Integrations for supported platforms and versions.

This article includes information about installing the Dreamweaver extension, setting Surround SCM as the remote host, associating sites with Surround SCM, performing Surround SCM actions, and troubleshooting.

Installing the Dreamweaver extension

The Dreamweaver extension is installed during the Surround SCM Client installation. If you did not install it, rerun the Surround SCM installer.

Note: If you use Adobe Dreamweaver CC 13 - 2014.1, you must install Adobe Extension Manager CC before installing the Dreamweaver extension with Surround SCM.

Setting Surround SCM as the remote host

Dreamweaver CS4

Note: Dreamweaver CS4 integration is only supported in Surround SCM 2012 - 2015.1.1.

  1. Start Dreamweaver.
  2. Choose Site > Manage Sites. The Manage Sites dialog box opens.
  3. Select the site to associate with Surround SCM and click Edit. The Site Definition dialog box opens.
  4. Click the Advanced tab and select the Remote Info category.
  5. Select Surround SCM from the Access list.
  6. Click Settings to select the site’s root folder. The Browse for Folder dialog box opens.
  7. Browse for the site’s local root folder and click OK.
  8. Select any options and click OK to save the changes.

Dreamweaver CS5 and later

  1. Start Dreamweaver.
  2. Choose Sites > Manage Sites. The Manage Sites dialog box opens.
  3. Select the site to associate with Surround SCM and click Edit. The Site Setup dialog box opens.
  4. Select the Servers category and click the plus sign (+) button to add a server.
  5. Enter a Server Name and select RDS from the Connect using list to update the list of remote services. After the list is updated, select Surround SCM.
  6. Click Settings to select the site’s local root folder and click OK.
  7. Click the Advanced tab.
  8. Select Enable file check-out and enter your Surround SCM username in the Check-out Name field.
  9. Click Save. The remote host is added.
  10. In the Servers list, select Remote for the server you added.
  11. Select Cloaking from the Advanced Settings category.
  12. Select Enable Cloaking.
  13. Select Cloak files ending with and enter ‘.myscmserverinfo’.
  14. Click Save to save the changes.

Associating sites with Surround SCM

  1. In the Files Pane, click the Connects to Remote Host button. You are prompted to create an association between the local root folder and a Surround SCM repository.
  2. Click Fix. The Surround SCM Repository Browser opens.
  3. Click Create Repository to create a new repository or select an existing repository to associate with the site. Unless you already have a repository you want to associate with the site, we recommend creating a new repository to avoid working directory conflicts.

    Note: To use an existing repository, you must first change the working directory for that repository to the local root folder for the site. Right-click the repository, choose Set Working Directory, and select the local root folder. If the existing repository already contains other files, these files are added to the site and displayed in the Files Pane in Dreamweaver.

Performing Surround SCM actions

To perform Surround SCM actions, choose an action from the Site or Site > Source Control menu. 

Note: Only use the Remote View to get files that are not already in the local site from Surround SCM. Perform all other actions in the Local View.

 Action  Use to:
Get Retrieve local copies of the selected files to the working directory.
Check Out Check out the selected files to make changes to them.
Put Add local files to Surround SCM.
Check In Check in updated files and make changes available to other users.
Undo Check Out Discard any changes made to a checked out file and remove the lock.
History View the file history.
Properties View the file properties.
Differences Compare the local copy of a file in your working directory with the current version in Surround SCM.
Changelists View pending changelists.
Annotate Compare files to determine new or changed lines between versions.
Launch Surround SCM Open Surround SCM.

The following additional actions are available when you right-click a file or folder.

 Action  Use to:
Synchronize Synchronize files and folders with Surround SCM.
Refresh Update the current status of files. For example, if you check out a file from Surround SCM, it is not displayed as checked out in Dreamweaver unless you refresh the status. You may need to manually refresh files in the Local View and Remote View to see the current status.
Rename Rename files and folders. You must rename files and folders in the Remote View to rename them in Surround SCM.
Delete Remove files and folders from source control.

Troubleshooting

Surround SCM is not available in the Remote Info Access list

Following are common causes and solutions.

  • The Surround SCM extension is not installed. Run the Surround SCM Client installer to install the extension.
  • You are using an unsupported version of Dreamweaver.
  • The Surround SCM.dll (Windows) or Surround SCM SCCI.dylib (Mac OS X) file was not installed correctly. Make sure the file exists in the Configuration\SourceControl directory in the Dreamweaver application directory. If it does not exist, you can reinstall the extension or copy the file from the Surround SCM application directory to the Dreamweaver source control directory.

Clicking the Connect to Remote Host button opens the Edit Site dialog box instead of the prompt to associate the local root directory with a repository

This occurs when the Files Pane in Dreamweaver is set to Local View. Toggle between Local View and Remote View to resolve this issue.

Surround SCM files are not displayed

Following are common causes and solutions.

  • The integration is not configured correctly. Make sure Surround SCM is configured to use the same folder as the site’s root.
  • Dreamweaver cannot connect to the Surround SCM Server. Make sure the Surround SCM Server is running and that your username and password are valid.
  • The local .MySCMServerInfo file is out of sync. Dreamweaver uses the .MySCMServerInfo file to determine where to look for files in Surround SCM. Go to the site where the site exists and make sure the .MySCMServerInfo file data points to the correct branch or repository. If it is points to an incorrect branch or repository, delete the .MySCMServerInfo file and refresh the Dreamweaver site to regenerate it.

Cannot add files from Dreamweaver

Following are common causes and solutions.

  • The integration is not configured correctly. Make sure Surround SCM is configured to use the same folder as the site’s root.
  • The Put command does not fail but does not add files. This occurs if you remove the file from Surround SCM and then try to put it into Dreamweaver. Dreamweaver uses the .MySCMServerInfo file to determine if a Put command should be interpreted as an Add or Check In. To solve this problem, manually edit the .MySCMServerInfo file and delete the data row that contains the name of the file you cannot add.
  • Dreamweaver is pointing to the wrong branch or repository. This occurs if you use the same working directory for multiple branches. Dreamweaver uses the .MySCMServerInfo file to determine where to add files. Surround SCM cannot determine where to add files if multiple .MySCMServerInfo files exist in one directory. To solve this problem, perform a Get of the branch from Surround SCM or delete the .MySCMServerInfo files to be prompted to select a new branch or repository.

Cannot get or check out files from Dreamweaver

Following are common causes and solutions.

  • The integration is not configured correctly. Make sure Surround SCM is configured to use the same folder as the site’s root.
  • Dreamweaver is pointing to the wrong branch or repository. This occurs if you use the same working directory for multiple branches. Dreamweaver uses the .MySCMServerInfo file to determine where to add files. Surround SCM cannot determine where to add files if multiple .MySCMServerInfo files exist in one directory. To solve this problem, perform a Get of the branch from Surround SCM or delete the .MySCMServerInfo files to be prompted to select a new branch or repository.
Article ID: 755  |   Last updated: 12 Apr, 2016
Tags
Dreamweaver Adobe

Prev   Next
Surround SCM Hudson and Jenkins Integration     Dreamweaver MX Mac Returns an Access is Denied Error After Check...