OpenSSH on Windows Quick Start Guide
Mark Bradshaw
mark@networksimplicity.com
[Last Updated June 17, 2002]

Detailed instructions can be found in the readme.  If you don't understand something here, please refer to the readme before contacting me.


QUICK INSTALL
=============
Unzip setup.exe and run it.  Accept all the defaults. 

This places all appropriate files in C:\Program Files\NetworkSimplicity


QUICK CONFIGURE
===============
1) Open a command prompt and move to your install directory (c:\program files\networksimplicity by default).  
	Start -> Run -> cmd
	c:
	cd \program files\networksimplicity

2) Go into the ssh subdirectory
	cd ssh

3) Use mkpasswd to setup your passwd file.  For instance, if you want local user "localjoe" to be able to login you would type:
	mkpasswd -l -u localjoe >> ..\etc\passwd

If you wanted domain user "domainbob" to be able to login you would type:
	mkpasswd -d -u domainbob >> ..\etc\passwd

If you are on a domain controller I recommend using the -d option, rather than the -l option.  Though -l is a valid option on a domain controller for domain accounts you can end up having a spurious group ID associated with your username.  

NOTE: If you want to use mkpasswd with a user that is not in your primary domain then you must use a different syntax.  If you wanted to get user jdoe from trusted domain trustdomain you would type:
	mkpasswd -d -u jdoe trustdomain >> ..\etc\passwd

Do this for all users that should be able to login.  You can copy this files to other OpenSSH on Windows installations as long as the users are identical.

4) Use mkgroup to create a group file.  

Issue the following command for local groups:
mkgroup -l >> ..\etc\group

For domain groups do:
mkgroup -d >> ..\etc\group

If you do both open the file in notepad and remove any duplication.

5) Reboot the server.

6) Start the openssh service (if necessary).
	net start opensshd

7) Test connection from another machine.
	cmd
	ssh user@just_install_server


QUICK USE
=========
Keep in mind that these client utilities are COMMAND LINE BASED.  There are no slick GUIs.  For that check out WinSCP and PuTTY (urls on the NetworkSimplicity site).  The three client apps are ssh, scp, and sftp.  All three have manual pages that explain their operation (ssh-manual.htm, scp-manual.htm, and sftp-manual.htm).

SSH:
	ssh user@server

SCP:
	scp source_file user@server:destination/path/filename
or
	scp user@server:source/path/filename local_file_name

SFTP:
	sftp user@server


TROUBLESHOOTING
===============
Troubleshooting info can be found in readme.txt.