Versions Compared

Old Version 2

changes.mady.by.user Erick Jones

Saved on

compared with

New Version Current

changes.mady.by.user Karl Henselin

Saved on

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.

FlexDeploy utilizes OpenSSH within a unix Unix shell for communicating to all endpoints.  For Microsoft Windows, Cygwin is required to provide the unixUnix-like enviornment environment containing the required SSH libraries.  The follow The following instructions can be used to install the Cygwin on a Windows client.

Table of Contents

Install Steps

  1. Download Cygwin from the following location: https://www.cygwin.com/

  2. Run the installer and follow the prompts:

Image RemovedImage Added
Image Removed
Image Added






3. Type "openssh" into the search dialog.

4. Drill down to Net>openssh . Click on the version number and it will check the Binary box.

5. Click nextNext.






6. Navigate to the location you installed Cygwin and run Cygwin.bat as an administrator.

7. Once the bash window opens, run:  ssh-host-config

...

*** Query: Should privilege separation be used? (yes/no) yes

*** Query: new local account 'sshd'? (yes/no) yes

...

*** Query: Create new privileged user account 'SYS\cyg_server' (Cygwin name: 'cyg_server')? (yes/no) yes

Tip

If you will be running build / deploy operations on this Endpoint as user other than cyg_server, you can say no to this answer and use existing account instead. Ideally, CYGWIN sshd service running as cyg_server should allow to connect as any other user if configured properly, but we have seen issues in this space due to various restrictions on Servers and Windows versions. If you decide to still continue with cyg_server, you can make the change later as well.

*** Query: Please enter the password: <ENTER PASSWORD>

...

11. Using a SSH client (such as PuTTY) attempt to log in to the host with user that has local access to the machine. If successful then the environment is setup and ready for use.

Troubleshooting Tips

  • If you installed CYGWIN sshd as cyg_server user, it should be able to allow Endpoint connection as any user on the server, but that may not work always. In this situation you can try these options.
    1. Make sure that cyg_server account is added to Replace a process level token policy using gpedit.msc. Reference - https://technet.microsoft.com/en-us/library/dn221975(v=ws.11).aspx, https://technet.microsoft.com/en-us/library/cc957225.aspx
    2. Another option is to run CYGWIN sshd as user that you want to connect as from FlexDeploy Endpoint. Here are the steps to make that change.
      1. Make sure the account you want to connect as is Administrator account. See my example of flexuser that I used instead of cyg_server
        Image Added
      2. Stop CYGWIN sshd service. 
      3. Edit CYGWIN sshd service and make it use user that you want to connect as from FlexDeploy Endpoint. See example below.
        Image Added
      4. Click OK.
      5. Run Cygwin terminal as Administrator.
      6. Run ssh-host-config option and follow prompts.
        Image Added
      7. Now start CYGWIN sshd service.


If you experience problems starting sshd, check the sshd.log in Cygwin64/var/log. That will indicate the issue that is occurring and should help with resolution.

If you receive an error like the permissions are too big for some folder or file, then you should perform a command in the bash window to reduce the permissions. An example would be chmod 700 /var/empty