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.

Note: The following steps were tested using Dreamweaver CS4 with Surround SCM 2009 and Dreamweaver CS5 with Surround SCM 2011 on Windows.

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.

Setting Surround SCM as the remote host

Dreamweaver CS4

1. Start Dreamweaver.
2. Choose Site > Manage Sites. The Manage Sites dialog box opens.
3. Select the site you want 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

1. Start Dreamweaver.
2. Choose Sites > Manage Sites. The Manage Sites dialog box opens.
3. Select the site you want 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: If you want 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 menu. Additional actions are also available if you right-click a file and choose Source Control.

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.

Putting files

You can add, or put, local files to Surround SCM.

1. Select the files you want to add to source control.
2. Choose Site > Put. The Add Files dialog box opens.
3. Select where you want to put the files and click OK. The files are added to Surround SCM.

Getting files

Get files when you want to view a file but do not need to make any changes.

1. Select the files you want to get and choose Site > Get. The Get Files dialog box opens.
2. Select where you want to retrieve the files to and click OK. A read-only copy of the file is created in the specified directory.

Checking out files

Check out files when you need to modify them.

1. Select the files you want to check out and choose Site > Check Out. The Check Out Files dialog box opens.
2. Enter any comments and select any options.
3. Click OK. The files are checked out.

Undoing check out

If you modify a checked out file but decide you do not want to save the changes, you can undo the check out. This discards any changes made to the file and checks in the file to the server.

1. Select the checked out file and choose Site > Undo Check Out.The Undo Check Out dialog box opens
2. Select a local file option.
3. Click OK. The file is no longer checked out.

Checking in files

Check in files with changes to remove the lock on the files and make the changes available to other users.

1. Select the files you want to check in and choose Site > Check In. The Check In Files dialog box opens.
2. Enter any comments and select any options.
3. Click OK. The files are checked in.

Viewing file history

You can view a source file's history and work with historical file versions.

1. Right-click the file and choose Source Control > History. The History dialog box opens.
2. Click Close to close the history.

Viewing file properties

You can view Surround SCM file properties from Dreamweaver.

1. Right-click a file and choose Source Control > Properties. The Properties dialog box opens.
2. Click the tabs to view file information.
3. Click OK to close the Properties dialog box.

Diffing files

You can diff files to compare, accept, or reject differences between two file versions.

1. Right-click the file and choose Source Control > Differences. The Differences dialog box opens.
2. Select the files and versions you want to compare and click Differences. The differences utility starts.

Renaming files

You can rename files. Renaming a file in the Local View does not rename it in Surround SCM. You must rename from the Remote View to rename it in Surround SCM.

1. Right-click the file you want to rename and choose Rename. The Rename File dialog box opens.
2. Enter the new file name and any comments.
3. Click OK. The file is renamed.

Refreshing file status

If you make changes to a file outside of Dreamweaver, you can refresh the file to update its status. For example, if you check out a file from the Surround SCM Client, it is not displayed as checked out in Dreamweaver unless you refresh the file status.

1. Select the file and Choose View> Refresh. The file status is refreshed.
   Note: Refreshing the Local View does not always refresh the Remote View.

Removing files

You can remove files from source control.

1. Right-click the remote file you want to remove and choose Delete. The Remove Files and Repositories dialog box opens.
2. Enter any comments and select any options.
3. Click OK. The file is removed from Surround SCM.

Synchronizing

You can synchronize files and folders with Surround SCM.

1. Right-click the file or folder you want to sync and choose Synchronize. The files are synchronized. Refer to Dreamweaver’s documentation for additional information.

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. Make sure you are using a supported version.
  
  
• The Surround SCM .dll file was not installed correctly. Make sure the file exists in the following directory: C:\Program Files\Adobe\Adobe Dreamweaver\VersionNumber\Language\Configuration\sourcecontrol. If it does not exist, you can either reinstall the extension or copy the .dll 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. Toggling between Local View and Remote View should 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.

Unable to 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.

Unable to 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.