Skip to content


 




Pre-requisites


Java

You will require Java (TM) Runtime Environment to run this software.  It requires atleast Java 1.6 to be installed.



Firewall Settings

Garuda GridFTP tool connects to the port 2999 of the Garuda resource. Hence please open this port for outgoing connections in your Firewall settings.



Antivirus Settings on Microsoft Windows clients

Some of the Antivirus software report that the application is trying to open an untrusted port and hence block the application from running. In such cases, you can temporarily disable your antivirus software, while using the tool.

top arrow

Installation


For Windows


Download the installer and click to run the setup.  You can then invoke the program using the Start Menu Item -> Garuda -> Grid FTP GUI

top arrow

For Linux

Download the Zip file and extract the contents of it. This is our TOOL_HOME directory. Set Java to be available on the PATH.

The extracted content contains a folder called 'certificates'.  This contains the CA certificate files.

Login as root and move this folder to /etc/grid-security/.    If the 'grid-security' folder is not present in /etc, then please create it.

Use run.sh script available in the TOOL_HOME folder, to invoke the software

top arrow


Tutorials


Using the tool

Step 1    - Click the menu item "Tools -- Grid Authentication ". You will be presented with an authentication dialog as shown below in Figure 1.

Enter your Garuda Username and Password and hit the "Authenticate" button.

Figure 1 - Garuda Authentication Dialog



Step 2    - If the login is successful, please close the authentication dialog, and press the 'Connect' button as shown in Figure 2.

Figure 2 - Connect to Garuda Resource



Step 3    - On successful connection, the right panel lists all the files in your ".portalfiles" directory on the Garuda resource, as shown in Figure 3.

You can now drag and drop the remote files to the left panel to download them. Alternately, right click on the file, and click "Download Selected". The Bottom panel shows the progress of the download.

Figure 3 - Browsing Remote Files

 


Troubleshooting / FAQ


I am unable to see any display.  I just see some Java exceptions

Make sure that you are using Java 1.6 or later. You can also view the run.bat (for Windows) and run.sh (for Linux) files to see if the Java CLASSPATH is properly set.  

Make sure that the Java binaries are available in the PATH.  To check this, Windows users can open a command shell by typing 'cmd'  from Windows Start Menu->Run.   Linux users can use any terminal through which you are trying to open the tool.

Type 'java  -version' in the command line, and it should display the version of Java that you are using.  

If not, then the Java is not properly available in the executable PATH. So please add it by setting the PATH variable.

top arrow

I get 'Certificate Data Not Found' error when trying to authenticate.

This happens if the CA certificates are not available in proper path on your desktop.

On Windows machines, please ensure that under %HOMEPATH% directory, you have created a .globus directory and it contains a subfolder called 'certificates'.  The 'certificates' directory  should contain files starting with "da75f6a8", which are the CA certificate files.

On Linux machines, the certificates folder should be available in /etc/grid-security. If not, please follow the installation instructions carefully.

top arrow

I get algorithm related errors when trying to authenticate

This happens when you use different versions of OpenSSL to  convert your p12 or pfx certificate to PEM format. Please use OpenSSL version 0.9.8r for Windows.

top arrow

Additional Resources



Convert your .pfx or .p12 files to PEM format


Linux users please click here.

How to convert it on Windows Desktops ?  

Download and Install OpenSSL for Windows.  Please use OpenSSL version 0.9.8 available from Shining Light Productions.

Install OpenSSL into the folder C:\OpenSSL-Win32

Place your .pfx or .p12 files in the folder C:\my-cert

Follow the instructions given in this video tutorial to convert the file to PEM format with names usercert.pem and userkey.pem


After you have successfully converted the files, do not forget to place them in appropriate folders.

Go through this section to know where to place your certificate files.  
top arrow


How to convert .p12 or pfx files on Linux ?

The following sections assume that your .p12 file is named as igca-cert.p12.  Replace this name with the actual name of your file.

Make sure that OpenSSL is installed on your machine and the binaries are available on the PATH.
You can check this by issuing the following command in a terminal

pointer     $ openssl version

This will print the version of the OpenSSL that your system is installed with.

Now issue the following command to generate the file usercert.pem

pointer     $ openssl  pkcs12  -in igca-cert.p12  -out usercert.pem  -nokeys  -clcerts

You will be asked to enter the import password.

Next, Issue this command to generate the key file userkey.pem. You will be asked to enter the password thrice. You can enter the same password.

pointer     $ openssl  pkcs12  -in igca-cert.p12  -out userkey.pem  -nocerts


After you have successfully converted the files, do not forget to place them in appropriate folders.

Go through this section to know where to place your certificate files.      

top arrow


Placing the PEM files in appropriate location


Linux users please click here.

Where to place the PEM files on Windows Desktops ?  

On Windows, you have to place your files in a folder called .globus which should be created in the user's home directory.

Please follow the instructions given in this video tutorial to copy the files.

 

Where to place the PEM files on Linux machines ?

On Linux,  if the .globus folder is not present in your home directory, then create it using this command

pointer     $ mkdir $HOME/.globus

Please use the following commands to copy the files to .globus folder under your home directory.

pointer     $ cp usercert.pem $HOME/.globus/usercert.pem

pointer     $ cp userkey.pem $HOME/.globus/userkey.pem

pointer     $ chmod 644 $HOME/.globus/usercert.pem

pointer     $ chmod 400 $HOME/.globus/userkey.pem

top arrow



Third Party Content 


Garuda Grid FTP GUI is based on a number of third party libraries, including BouncyCastle Security libraries, JGoodies Form libraries and Globus Grid FTP libraries.  All these libraries come with their respective licenses.