In order to make an SSH connection, you must install a third party SSH server. This could be the open source Cygwin product or a commercial SSH server. If you employ a different SSH server product, please refer to your product documentation for setup information.
These instructions describe the process of installing and configuring Cygwin with OpenSSH.
NOTE |
These examples are provided for guidance only. Rocket does not provide support for third party servers. |
The following topics are presented:
Installing Cygwin with OpenSSH & OpenSSL
Configuring Cygwin with OpenSSH & OpenSSL
Configuring Cygwin with OpenSSH & Enterprise Licensing
Complete these instructions to install Cygwin with OpenSSH and OpenSSL.
To install Cygwin with OpenSSH and OpenSSL:
Create the Cygwin application folder. For example, C:\cygwin.
Create a temporary folder in which to place the installer. For example, C:\temp.
Download the installer using the following URL: http://www.cygwin.com/setup.exe. Be sure to save the installer to the temporary directory you created in step 2 above.
When the download completes, navigate to folder into which you downloaded the installer and double click the setup.exe file to start the installation process. Respond to the installation prompts accordingly using the table below as a guide.
Screen |
What to Select |
Choose a Download Source |
Select the Install from Internet option. |
Select Root Install Directory |
Ensure that C:/cygwin is the directory displayed in the Root Directory text box and select the All Users option from the Install for section. |
Select Local package Directory |
Ensure that the directory you created in step 2 above is the directory displayed in the Local package Directory text box. |
Select Your Internet Connection |
Select the Direct Connection option. |
Choose a Download Site |
Select any of the sites form the Available Download Sites list. |
Once you have completed making all of the above selections, the download process begins.
NOTE |
If a Setup Alert message displays, click OK. |
The Select Packages dialog box displays.
Select the appropriate packages as described in the table below. Selections are made by expanding the category and clicking the Skip icon corresponding to the package from the New column.
Category |
Packages |
Admin |
Select all packages. |
Archive |
Select zip and unzip. |
Base |
Select all packages. |
Doc |
Select man and cygwin doc. |
Editors |
Select vim. |
Net |
Select inetutils (if you wish to use telnet instead of d3tcl), openssh, openssl, rsync and tcp_wrappers. |
The Resolve Dependencies dialog box displays.
Select the Select required packages (RECOMMENDED) check box and then click Next.
The installation process begins. When the process completes, click Finish and then restart Windows.
Complete these instructions to configure Cygwin with OpenSSH and OpenSSL.
To configure Cygwin with OpenSSH and OpenSSL:
Open the cygwin.bat file located in the C:\cygwin\ directory and edit the script by adding the set command as shown below:
@echo off set CYGWIN='binmode mintty ntsec' C: chdir \cygwin\bin bash --login -i |
Save and close the cygwin.bat file.
Determine the 8-character name of the program files (or program files(x86)) directory that contains the TigerLogic\D3\D3Programs directory.
On a 32-bit system, this should be progra~1, but it is recommended that you verify this explicitly.
On a 64-bit system, this should be progra~2, but it is recommended that you verify this explicitly.
If you intend to use d3tcl instead of telnet, create a bat file named d3.bat in the C:\cygwin\ directory. The contents of the bat file on a 32-bit system should be as shown below (note that the progra~1 portion of the directory should be the name you determined in step 3).
@echo off c:\progra~1\TigerLogic\D3\D3Programs\D3Tcl -i cygwin -s -u dm |
Save and close the d3.bat file.
Open a command prompt, navigate to the cygwin directory and run cygwin. For example:
C:\Users\jsmith>cd \cygwin
C:\cygwin>cygwin
jsmith@jsmith-pc2 ~]
$ |
Note how this opens a unix-like shell.
Test some Cygwin commands (for example, pwd or ls /bin) to ensure it is functioning properly.
Run the ssh-host-config command to Install the SSH daemon:
$ ssh-host-config |
A series of prompts displays to which you respond as shown in the table below. Note that this list of prompts may not be all-inclusive. As such, if any other prompts display (that are not listed below), please respond accordingly.
Prompt |
Response |
Should privilege separation be used? (yes/no) |
yes |
Do you want to install sshd as a service? (Say "no" if it is already installed as a service) (yes/no) |
yes |
Enter the value of CYGWIN for the daemon: [] |
binmode mintty ntsec |
Do you want to use a different name? (yes/no) |
no |
Please enter the password for user cyg_server': |
Type the password you want to use, making sure it meets the minimum requirements. |
Reenter: |
Enter the password from above again. |
Open the Windows Service Control Manager and start the CYGWIN sshd service.
Complete these instructions to connect to the D3 server.
To connect to the D3 server:
Connect to the D3 server using PuTTY or your preferred SSH client.
Supply a Windows user with permissions and a password for that server.
Start the D3 session from the Cygwin shell prompt ($).
If you are using d3tcl, enter /d3.bat at the Cygwin shell prompt. This should take you to TCL in the dm account.
If you are using telnet, enter telnet localhost at the Cygwin shell prompt. This should open the D3 login dialog box.
Enter OFF or EXIT if you want to return to the Cygwin shell prompt.
Complete these instructions to configure Cygwin with OpenSSH & Enterprise licensing.
To configure Cygwin with OpenSSH & Enterprise licensing:
Open the sshd_config file located in the C:\cygwin\etc\ directory and edit the script by adding the line below:
AcceptEnv D3_CLIENTID |
Save and close the sshd_config file.