FileZilla/SFTP to update applications on OpenShift- for Windows users

Assuming that you have already setup rhc client in your system if not please refer following url:

https://www.openshift.com/developers/rhc-client-tools-install

Step 1. Convert SSH Keys to Putty format.

Note: You need to execute this step only once.

When rhc tools are installed, your SSH keys are created in the OpenSSH format. This format differs slightly from the PuTTYformat. In this step, we’ll import the OpenSSH key that you have created earlier and convert it to native PuTTY format.

If you have PuTTY and PuTTYgen already, continue; otherwise, download PuTTY and PuTTYgen from

http://www.chiark.greenend.org.uk/~sgtatham/putty/.

Start PuTTYgen and select Conversions -> Import Key

By default, OpenSSH stores your keys indrive:\Documents and Settings\user\.ssh folder on WindowsXP, or in drive:\Users\user\.ssh folder on Windows 7. In the file selector, navigate to this folder and select id_rsa file that contains your private key.

You may see another file that is actually a public key id_rsa.pub — Windows may misidentify it as a ‘Microsoft Publisher’ file. If you try to select id_rsa.pub, Puttygen errors that this file does not contain a private key.

Once imported, you will see the following imported information in Puttygen.

Then, click on Save private key and choose the samedrive:\Documents and Settings\user\.ssh folder. The file name defaults to id_rsa.ppk.

You should now have three files in this folder: OpenSSH private key id_rsa, PuTTY private key id_rsa.ppk and public keyid_rsa.pub.

We will use this key in the following sections when accessing your application securely.

Step 2. Determine username and host name.

The FAQ referenced above refers to the UUID and Gear Name. In PuTTY, this fields have to be separated.

You can find the UUID and gear name information in the OpenShift management console by selecting your application.

The string with the git repository contains the required information:

Step 3. Establish SSH connection using PuTTY.

Start PuTTY and paste Gear name as the Host Name as shown below:

Then, navigate to Connection->Data in the left panel and paste the complete UUID as the Auto-login username, as shown below. Since the UUID is quite long, it may not fully display.

Lastly, navigate to Connection->SSH->Auth and select the id_rsa.ppk as your Private key file for authentication, as shown below:

Finally, select Open to connect to your Application’s gear.

 

Installing FileZilla

Basically you need to make sure you have remote access over SSH working from your machine.

  1. Downloaded and installed FileZilla for your platform.

Getting FileZilla set to go with public/private keys

Ok let’s convert the key and get it set up with FileZilla. First open the settings dialog.

Now click on SFTP under connections in the left part of the setting dialog (green box). Then click on Add keyfile on the bottom of the dialog.

Then in the file chooser dialog, navigate to your home directory, then to the .ssh directory, in there you will see id_rsa. This is your private key that you need to convert to a .ppk format. Go ahead and select it.

When asked to convert it, go ahead and say Yes.

Save the new file as id_rsa.ppk in your .ssh directory. When you are done you should see the new keyfile listed in your key dialog. Then you can click ok and get back to the normal dialog. Now go ahead and click on File -> site manager or click on the site manager icon on the top left.

In the site manager you are going to define the connection parameters to your gear. If you need to get the ssh parameters for your gear(s) you can use the following rhc commands.

For a single gear app: 

rhc app-show {appname}

To get the SSH keys in a multi-gear app

rhc app-show {appname} –gears

Once you have clicked on the site manager. First click on the New Site button.

Then fill out the dialog with the information for your gear. The new site name can be anything you want so you can remember what it points to. The host field should be filled out with the contents of the ssh string to the right of the @ (usually the URL of the app). Change the protocl to SFTP. The login type is normal with the user being the UUID for your application. I have blanked out the password field but even if it is filled in, FileZilla will use the SSH keys for authentication. By pressing connect you will also save your settings for the site.

On the first connection it will ask if you want to save the key identifying the host and you should answer yes. It is up to you if you want to save it for always or authenticate it each time.

When the connection is completed you will have a drag and drop interface for transferring files. The white box on the top is the log output. The left window is the view of your local machine and the right view is the gear. So you can take files (or directories) and just move them between the two sides to transfer them. The bottom box shows you the status of the transfers.

And with that you are ready to move files back and forth between your local machine and your OpenShift gears. Have fun moving the megabytes!

 

 

9
2 Comments
  • business information
    July 16, 2015

    I really started laughing at one point. But, it’s all good.

  • click here
    July 30, 2015

    I’m glad I found this post. Emailed it to myself to learn afterwards from my desktop. Will try for connecting with you on Facebook then too.

Leave a Reply

Your email address will not be published. Required fields are marked *