TechNote

Subversioning in Adobe Dreamweaver CS4

What's covered

• How to setup an Open SSH site on Windows and Mac
• Examples of how to configure SSH access
• How to Setup and add Subversion control to a site
• Troubleshooting

This document addresses how to add and set up subversion control or SSH to a site.

How to setup an Open SSH site on Windows and Mac.

1. In your Dreamweaver site definition, choose Version Control from the Category list
2. Select Subversion from the Access menu.
3. Select SVN+SSH from the Protocol menu.
4. Enter your server address in the Server address field
5. Enter your Repository path (unless the path is included in the server address) in the Repository path field.
6. Specify Server Port if it is not the default port
7. Enter the Username and Password in the Username and Password fields (leave both fields empty for anonymous login).
   
   Note: The user name and password are NOT taken from Dreamweaver. The only way to send user is to type user@servername in the server name field.
8. Press the Test button to test the connection.

Examples of how to configure SSH access.

• Windows users will be using: TortoiseSVN and puttygen clients
• MacOS users will be using: MacOS ssh client

The following will require editing the Subversion configuration file, which is located in:

• Windows Vista: C:\Users\USERNAME\AppData\Roaming\Subversion\config
• Windows XP: C:\Documents and Settings\USERNAME\Application Data\Subversion\config
• Mac OS: /Users/USERNAME/.subversion/config
  Under [tunnel] section:
  

To configure the Subversion config file locally on Windows:

1. In the terminal, locate the .subversion folder in your user folder mentioned above. : C:\......
2. In the tunnels section you need to specify where ssh client exits.
   This depends on where you installed it.
3. Open the file and enter this under the tunnels section ([tunnels]):
   ssh = $SVN_SSH C:/pathtosshclient/tortoiseplink.exe
4. Save and close the config file.
   

   
   Note: For key, use plink or tortoisplink add -i privatekey. There is also a less secure possibility: -l username -pw password

To configure the Subversion config file locally on Mac:

1. In the terminal, locate the .subversion folder in your user folder mentioned above using : ls -al ~/.subversion
2. The path to SSH is usually "/usr/bin/ssh",
   but if you are not sure, enter: which ssh
3. Edit the Subversion config file with a text editor (e.g. nano, pico, etc.).
   For example, enter: nano ~/.subversion/config
4. Under the tunnels section ([tunnels]), enter: ssh = $SVN_SSH /usr/bin/ssh
   
5. Close and save the config file.

Steps to create keys on Windows:

1. Create the public and private keys (locally).
   Run puttygen: Select the number of bits for the key encryption and generate keys. Save both private and public keys (e.g private_key, public_key).
2. Copy the public key to server (locally).
   Ensure that you have access to login to the server and user account that you are attempting to connect to with subversion. Use an ftp or sftp application to put the file on server (e.g. temp_private_key.pub)
3. Connect to server (locally)
   In command line (cmd.exe), run tortoiseplink.exe youraccount@yourserver, or connect with Putty. Enter the user password and log in.
4. Add keys to authorized_keys (on server)
   If the previous step was successful, and you are connected through ssh, enter ls .al ./ssh in the terminal.
   If the previous step was unsuccessful, do the following:
   1. mkdir ~/.ssh
   2. mv ~/temp_privatekey.pub ~/ssh/authorized_keys
   else
   1. cat cat ~/.ssh/authorize_keys ~/temp_privatekey.pub > temp_keys
   2. mv temp_keys ~/.ssh/authorized_keys
5. Type exit to close the terminal.
6. Control settings (locally)
7. Return to step 3. You should now be able to log in without a password.
   

Steps to create keys on Mac:

1. Create public and private keys (locally)
   If you do not have any files, or a hidden folder called .ssh with files inside:
   • In the terminal, enter ls -al ~./ssh
   • If empty, enter: ssh-keygen -t rsa then answer the questions prompted by the application
2. Copy the public key to server (locally)
   In the terminal, enter: scp .ssh/id_rsa.pub youraccount@yourserver.com:~/temp_rsa.pub
   Enter the password when prompted.
3. Connect to server (locally)
   In the terminal, enter: ssh -l youraccount yourserver
   Enter the user password and log in.
4. Add keys to authorized_keys (on server)
   If the previous step was successful, and you are connected through ssh, enter ls -al ./ssh in the terminal.
   If the previous step was unsuccessful, do the following:
   1. mkdir ~/.ssh
   2. mv ~/temp_rsa.pub ~/ssh/authorized_keys
   else
   1. cat cat ~/.ssh/authorize_keys ~/temp_rsa.pub > temp_keys
   2. mv temp_keys ~/.ssh/authorized_keys
5. Enter exit to close the terminal.
6. Control settings (locally)
   Return to step 3. You should now be able to log in without a password.

Setup and add subversion control to a site.

1. Complete How to setup an Open SSH site on Windows and Mac.
2. Close the Site Definition dialog box.
3. In the Files panel, choose Local view or Repository view
4. Right+click (Windows) or Ctrl+click (MacOS) on the root folder to display the contextual menu.
5. Go to Version Control > Get Latest Versions to update the file list.

Troubleshooting

Be sure to use the correct bits in the keys. Using ssh -v (Mac) or plink -v the output from the server will tell you which one the server uses:

Host key fingerprint is: ssh-rsa 2048 la:3e:6b:c4:59:64:af:23:9c:4a:3f:18:f0:17:40:f4

This means that the server uses 2048 bits for the key and is something that you might have to add to the key generator application at the creation of the key.

Search Support

---