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.7 and newer. For
older versions, refer to the previous
guide.
|
|
|
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]
[ host [-P port] [-a auth] [-c N] [-t type] ]
uberftp [-?] [-d] host [-P port] [-a auth]
[-c N] [-t type] "cmd"
uberftp -v
The options are as follows:
host Connect to host
-P port Connect to port (default 2811 for GSI)
-a auth Use auth authentication. GSI and
MSS (NCSA passwordless) authentication methods
are supported. If this option is not used, the
default is GSI
-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 must be enclosed
in quotes. Multiple commands are semicolon delimited
uberftp will execute these commands and then exit
-v Print version information and exit
-? Print this help message
-d Turn on debug (verbose) output
As of version 1.7,
'-u user' and '-p pass' are no longer supported.
'-H host' is now optional, you can just specify
'host'. The '-H' is supported for backwards
compatibility and will be removed in 2.0.
|
|
Interactive Commands
|
|
This listing is generated by typing 'help' at the command prompt.
ascii binary blksize 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 tcpbuf
tcpbuf was added in version 1.8.
|
|
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 mss.ncsa.uiuc.edu
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 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 tg-tts1.ncsa.teragrid.org
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>
|
|