Setting Up Cygwin SSH on Windows

Set up Cygwin SSH on the DAS host and on all hosts where instances in your cluster will reside.

The following topics are addressed here:

• To Download and Install Cygwin

• To Set the Path for Windows and for the Cygwin Shell

• To Set the Home Directory for the Cygwin SSH User

• To Configure and Start the Cygwin SSH Server Daemon sshd

To Download and Install Cygwin

For centralized GlassFish Server administration, a basic Cygwin installation that includes the SSH client and the SSH server daemon sshd is sufficient. The default installation options are sufficient to create such a basic installation.

1. Log in as a user with Administrator privileges.
2. Create the folder C:\cygwin.
3. From the Cygwin home page, download and save the setup.exe file to your desktop.
4. Run the setup.exe file.
5. Select the default for the following options:

   • Install from Internet

   • Install Root Directory: C:\cygwin

   • Install for All Users

6. Specify a folder for the local package directory that is not the Cygwin root folder, for example, C:\cygwin\packages.
7. Specify the connection method.

   For example, if the host is connected to the Internet through a proxy server, specify the proxy server.

8. Select the mirror site from which to download the software.
9. Select the openssh package for installation.
   1. Under the Net category, search for openssh.
   2. Locate the openssh package and click Skip.

      The package is selected.

   3. Click Next.

      Any unsatisfied dependencies are listed.

10. Leave the Select Required Packages option selected and click Next

    The packages are installed.

11. Click Finish.

See Also

For detailed information about installing Cygwin, seeInternet Setup in Cygwin User's Guide.

To Set the Path for Windows and for the Cygwin Shell

To enable GlassFish Server tools to find commands for SSH, each user's path for Windows and for the Cygwin shell must contain the following directories:

• The Cygwin bin directory, for example C:\cygwin\bin

• The bin directory of the JDK software

1. Log in as a user with Administrator privileges.

   Logging in as a user with Administrator privileges ensures that the change applies to all users.

2. In the System Information control panel, click Advanced->Environment Variables.
3. Add the following directories to the Path environment variable:

   • The Cygwin bin directory, for example C:\cygwin\bin

   • The bin directory of the JDK software

To Set the Home Directory for the Cygwin SSH User

The SSH Server Daemon sshd locates a user's home directory from the configuration in the user database, not from environment variables such as HOME. To ensure that all GlassFish Server commands can run without errors, each SSH user must be configured to have a home directory.

Each user on a Windows host where SSH is set up potentially has two home directories:

• Windows home directory. GlassFish Server commands, which are run in a Windows command window, use the Windows home directory.

• SSH home directory. SSH commands, which are run in a shell such as bash or ksh, use the SSH home directory.

If these home directories are different, GlassFish Server and SSH each locate a user's .ssh directory in different directories. To simplify the set up of SSH, configure each user's home directory for SSH and Windows to be the same directory. A disadvantage of this approach is that the SSH home directory has spaces in its path name. Spaces in path names are cumbersome in the UNIX environment.

1. Log in as a user with Administrator privileges.
2. In the c:\cygwin\etc\passwd file, edit the home directory setting for the SSH user to specify the user's home directory for Windows.

To Configure and Start the Cygwin SSH Server Daemon sshd

Before You Begin

Ensure that the following prerequisites are met:

• A user account is created for each user that will log in to the host through SSH.

• A password is set for each user account.

  The SSH server daemon sshd disallows authentication of any user for whose account a password is not set.

1. Double-click the Cygwin icon.

   A Cygwin terminal is started.

2. If necessary, set the password for your user account.
   1. Run the passwd command as follows:

      $ passwd user-name

      user-name

      The user name for your account.

   2. Type a password.

   The password for your Windows account is also set.

3. Configure SSH on the host.
   1. Run the ssh-host-config command.

      $ ssh-host-config

      ---

      Tip - If you are using Windows XP, specify the -y option of ssh-host-config to answer yes to all prompts. If you run ssh-host-config with the -y option, omit Step b.

      ---

   2. Ensure that the following options are set to yes in the file /etc/ssh_config:

      • StrictModes

      • PubkeyAuthentication

      The file /etc/ssh_config can also be accessed as /cygdrive/c/cygwin/etc/sshd_config.

4. Start the SSH server daemon sshd.

   $ net start sshd

5. Confirm that the SSH server daemon sshd is running.

   $ cygrunsrv --query sshd
    Service             : sshd
    Display name        : CYGWIN sshd
    Current State       : Running
    Controls Accepted   : Stop
    Command             : /usr/sbin/sshd -D

Next Steps

After you have completed the setup of SSH on a host, test the setup on the host as explained in Testing the SSH Setup on a Host.