INSTALL
c3bc0a8c
 Installation of s3cmd package
 =============================
 
 Author:
     Michal Ludvig <michal@logix.cz>
 
 S3tools / S3cmd project homepage:
     http://s3tools.sourceforge.net
 
 Amazon S3 homepage:
     http://aws.amazon.com/s3
 
 !!!
 !!! Please consult README file for setup, usage and examples!
 !!!
 
 Package formats
 ---------------
 S3cmd is distributed in two formats:
 1) Prebuilt RPM file - should work on most RPM-based
    distributions
 2) Source .tar.gz package
 
 
 
 Installation of RPM package
 ---------------------------
 As user "root" run:
    
 	rpm -ivh s3cmd-X.Y.Z.noarch.rpm
 
 where X.Y.Z is the most recent s3cmd release version.
 
 You may be informed about missing dependencies
 on Python or some libraries. Please consult your 
 distribution documentation on ways to solve the problem.
 
 
 Installation of source .tar.gz package
 --------------------------------------
 There are three options to run s3cmd from source tarball:
 
 1) S3cmd program as distributed in s3cmd-X.Y.Z.tar.gz 
    can be run directly from where you untar'ed the package.
 
 2) Or you may want to move "s3cmd" file and "S3" subdirectory
    to some other path. Make sure that "S3" subdirectory ends up
    in the same place where you move the "s3cmd" file. 
 
    For instance if you decide to move s3cmd to you $HOME/bin
    you will have $HOME/bin/s3cmd file and $HOME/bin/S3 directory 
    with a number of support files.
 
 3) The cleanest and most recommended approach is to run
 
 	python setup.py install
 
    You will however need Python "distutils" module for this to 
    work. It is often part of the core python package (e.g. in 
    OpenSuse Python 2.5 package) or it can be installed using your
    package manager, e.g. in Debian use 
 
 	apt-get install python2.4-setuptools
 
    Again, consult your distribution documentation on how to 
    find out the actual package name and how to install it then.
 
 
 Where to get help
 -----------------
 If in doubt, or if something doesn't work as expected, 
 get back to us via mailing list:
 
 	s3tools-general@lists.sourceforge.net
 
 For more information refer to:
 * S3cmd / S3tools homepage at http://s3tools.sourceforge.net
 
 Enjoy!
 
 Michal Ludvig
 * michal@logix.cz
 * http://www.logix.cz/michal