Navigate This Site
Home
Download
Installation Guide
User Guide
FAQ
License
Automated Tests
Contacts
Sponsors
Resources
|
|
|
Document Sections
|
|
Getting Started
|
|
Commandline Options
|
|
Interactive Commands
|
|
Third-Party Transfers
|
|
Examples
|
|
|
This guide is for versions 1.6 and earlier.
|
|
Getting Started
|
|
UberFTP is typically dynamically linked. This means that, unless
the system administrator has taken the necessary precautions,
you have to configure your environment so the client can locate
all of its needed libraries. If you run uberftp and get this
message, then you need to configure your environment:
uberftp: error while loading shared libraries: libglobus_ftp_control_gcc64pthr.so.0: cannot open shared object file: No such file or directory
To fix this, set GLOBUS_LOCATION, then source
$GLOBUS_LOCATION/etc/globus-user-env.sh:
> export GLOBUS_LOCATION=/usr/local/globus
> . $GLOBUS_LOCATION/etc/globus-user-env.sh
|
|
Commandline Options
|
|
Usage: uberftp [-?] [-d]
[ [-H host] [-P port] {-a auth | -u user -p pass} ]
[-c N] [-t type]
uberftp [-?] [-d] -H host [-P port]
{-a auth | -u user -p pass}
[-c N] [-t type] "cmd"
uberftp -v
The options are as follows:
-? Print this help message
-d Turn on debug (verbose) output
-H host Connect to host
-P port Connect to port (default 21)
-a auth Use auth authentication. GSI and
MSS (NCSA passwordless) authentication methods
are supported. If this option is not used, the
default is username/password
-u user Username to use for default authentication
-p pass Password to use for default authentication
-c N Use N parallel data connections. Defaults to 1.
-t type Use ASCII or BINARY transfer type. Valid type options
are 'a' (ASCII) or 'b' (BINARY). Default is BINARY.
cmd This specifies the FTP commands to run once the control
connection is establish. This list is must be enclosed
in quotes. Multiple commands are semicolon delimited
uberftp will execute these commands and then exit
-v Print version information and exit
|
|
Interactive Commands
|
|
This listing is generated by typing 'help' at the command prompt.
ascii binary cat cd chmod debug close dir get hash
help lcat lcd lchmod lls lclose lmkdir lopen lpwd lrm
lrmdir lquote ls mget mput mkdir mode passive open parallel
pget pput pwd put rm rmdir quit quote
|
|
Third-Party Transfers
|
|
Third-party transfers are performed similarly to
other file transfers. Normally, you use 'open' to
select the remote host then perform 'put' and 'get'
between the local client machine and the remote
FTP service. In order to perform a third-party transfer,
you select a new 'local' service by using 'lopen'. Now all
'l*' commands perform actions on the new 'local' service as
if you were logged into that machine. 'put' will perform a
third-party transfer moving the file from the 'local' service to
the 'remote' service and vice versa for 'get'. You can use 'close'
and 'lclose' when you are finished with those connections.
|
|
Examples
|
|
Start a session using GSI authentication:
[jalt@cvs bin]$ grid-proxy-init
Your identity: /C=US/O=National Computational Science Alliance/CN=Jason Alt
Enter GRID pass phrase for this identity:
Creating proxy .................................................... Done
Your proxy is valid until: Thu Sep 25 22:14:10 2003
[jalt@cvs bin]$ ./uberftp -H mss.ncsa.uiuc.edu -a gsi
220-
%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
*******************************************************************************
NCSA's Mass Storage System
Running UniTree Central File Manager 2.3
for IRIX on a SGI Origin 2000
Dec 29, 2000: UniTree has been upgraded to version 2.3. There are a few
new enhancements to the ftp services. Please see the
consulting team's web pages for updated information:
http://www.ncsa.uiuc.edu/SCD/Hardware/UniTree/Doc/
*******************************************************************************
%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
Aug 18 2003 There may be delays accessing archived (AR) files from Mass
Storage, due to tape drive upgrades. Please let the Helpdesk
or Consult know if delays seem excessive.
Sept 23 2003 The certificate for MSS has been renewed using NCSA's CA
certificate. To continue using GSI authentication to MSS,
please get a copy of NCSA's CA certificate
(4a6cd8b1.0 and 4a6cd8b1.signing_policy) from
ftp://ftp.ncsa.uiuc.edu/aces/ncsa-ca/certificates and place them
in /etc/grid-security/certificates on your client machine.
UNIX Archive FTP server (DiskXtender Version 2.4) active. Checking DiskXtender.conf
220 UNIX Archive FTP server ready.
230 User jalt logged in.
uberftp>
Perform a third-party transfer with 5 data connections:
[jalt@cvs bin]$ ./uberftp
uberftp> open -H mss.ncsa.uiuc.edu -a mss
UNIX Archive FTP server (DiskXtender Version 2.4) active. Checking DiskXtender.conf
220 UNIX Archive FTP server ready.
230 User jalt logged in.
uberftp> lopen -H tg-tts1.ncsa.teragrid.org -a gsi
220 tg-tts1.ncsa.teragrid.org GridFTP Server 1.5 GSSAPI type Globus/GSI wu-2.6.2 (gcc32dbg, 1032298778-28) ready.
230 User jalt logged in. Access restrictions apply.
uberftp> ls
535 DCAU not supported for this authentication mechanism
150 Opening BINARY connection(s) for /usr/unitree/prod/bin/ddir.
drwx------ 2 jalt ac DK common 1024 Sep 18 12:54 .trash
-rw------- 1 jalt ac DK common 0 Sep 18 13:50 10
-rw------- 1 jalt ac AR common 10000000001 Sep 11 13:42 10GigFile.1
226 Transfer complete.
uberftp> lls
150 Opening BINARY mode data connection.
226 Transfer complete.
uberftp> get 10
dst> 150 Opening BINARY mode data connection.
src> 150 Opening BINARY connection(s) for 10.
dst> 226 Transfer complete.
src> 226 Transfer complete.
uberftp>
|
|