home *** CD-ROM | disk | FTP | other *** search
/ PC Active 2009 April / PCA224.ISO / Software / remotes / setupssh.exe / docs / quickstart.txt < prev    next >
Encoding:
Text File  |  2004-07-09  |  3.5 KB  |  83 lines
  1. OpenSSH for Windows: Quick Start Guide
  2. Michael Johnson
  3. youngmug@users.sourceforge.net
  4.  
  5. Updated 9 July 2004
  6.  
  7.  
  8.  
  9. For detailed instructions, please see readme.txt. If you have questions, please check the readme and the online FAQ before contacting me.
  10.  
  11. In the descriptions of what to type, I use standard command notation. Items enclosed in [] are optional. Text you need to replace with entries is enclosed in <>.
  12.  
  13. This document is based in large part on the Quick Start Guide for Network Simplicity OpenSSH on Windows by Mark Bradshaw.
  14.  
  15.  
  16. PLEASE READ THROUGH THE FULL README BEFORE YOU ASK FOR HELP. MANY THINGS ARE EXPLAINED IN MORE DETAIL THERE.
  17.  
  18.  
  19.  
  20. Install
  21. -------
  22.  
  23. Run the setup program and accept the defaults (all categories).
  24. This will install the OpenSSH server and client in an appropiate place.
  25.  
  26.  
  27.  
  28. Configuration
  29. -------------
  30. 1.  Open a command prompt and change to the installation directory (Program Files\OpenSSH is the default).
  31.  
  32. 2.  CD into the bin directory.
  33.  
  34. 3.  Use mkgroup to create a group permissions file. For local groups, use the "-l" switch. For domain groups, use the "-d" switch.
  35.     For both domain and local, it is best to run the command twice (remember to use >>, not >). If you use both, make sure to edit the file to remove any duplicate entires.
  36.  
  37.       mkgroup -l >> ..\etc\group      (local groups)
  38.       mkgroup -d >> ..\etc\group      (domain groups)
  39.  
  40. 4.  Use mkpasswd to add authorized users into the passwd file. For local users, use the "-l" switch. For domain users, use the "-d" switch.
  41.     For both domain and local, it is best to run the command twice (remember to use >>, not >). If you use both, make sure to edit the file to remove any duplicate entires.
  42.  
  43.       mkpasswd -l [-u <username>] >> ..\etc\passwd      (local users)
  44.       mkpasswd -d [-u <username>] >> ..\etc\passwd      (domain users)
  45.  
  46.     NOTE: To add users from a domain that is not the primary domain of the machine, add the domain name after the user name.
  47.     NOTE: Ommitting the username switch adds ALL users from the machine or domain, including service accounts and the Guest account.
  48.  
  49. 5.  Start the OpenSSH server.
  50.  
  51.       net start opensshd
  52.  
  53. 6.  Test the server. Using a seperate machine as the client is best. If you connect but the connection immediately gets dropped, reboot the machine with the server and try connecting again.
  54.  
  55.  
  56.  
  57. Usage and Important Notes
  58. -------------------------
  59. Remember that the CYGWIN OpenSSH utilities are not graphical and are command-line based. Look at PuTTY, SSH Secure Shell, etc for graphical configuration. For more advanced ways to use the programs, look at the manual pages in the documentation directory.
  60.  
  61. SSH (client program):
  62.     ssh <user@servername>
  63.  
  64. SCP (file copy):
  65.     scp <localfilename> <user@servername>:<destinationdirectory>
  66.       or
  67.     scp <user@servername>:<remotefilename> <localfilename>
  68.       or
  69.     scp <user@servername>:<remotefilename> <user@otherservername>:<destinationdirectory>
  70.  
  71. SFTP (ftp):
  72.     sftp <user@servername>
  73.  
  74.  
  75. NOTE: While regular SSH provides a familiar Windows commandline, SCP and SFTP as well as the passwd file use Unix-style paths. This is due partly to the Unix history of SSH, and to the Cygwin source of the tools.
  76.  
  77. Paths in SCP and SFTP as well as the home directory listing in passwd use Unix notation. To access directories outside of the OpenSSH directory structure, use the Cygdrive notation described in readme.txt. Further explanation is in readme.txt.
  78.  
  79.  
  80.  
  81. Troubleshooting
  82. ---------------
  83. Troubleshooting tips can be found in the full readme.