Installation of s3cmd package
 =============================
 

 Copyright:
     TGRMN Software and contributors

 
 S3tools / S3cmd project homepage:

     http://s3tools.org

 
 !!!
 !!! 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 from PyPA (Python Package Authority)
 ---------------------

 S3cmd can be installed from the PyPA using PIP (the recommended tool for PyPA).

 
 1) Confirm you have PIP installed. PIP home page is here: https://pypi.python.org/pypi/pip 
    Example install on a RHEL yum based machine
 	sudo yum install python-pip
 2) Install with pip
 	sudo pip install s3cmd

 Installation from zip file 
 --------------------------

 There are three options to run s3cmd from source tarball:
 

 1) The S3cmd program, as distributed in s3cmd-X.Y.Z.tar.gz
    on SourceForge or in master.zip on GitHub, can be run directly 
    from where you unzipped 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 unzip the 
    package and then just 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 python-setuptools

 
    Again, consult your distribution documentation on how to 
    find out the actual package name and how to install it then.
 

    Note that on Linux, if you are not "root" already, you may 
    need to run:

        
         sudo python setup.py install
 
    instead.
 

 Note to distributions package maintainers

 ----------------------------------------
 Define shell environment variable S3CMD_PACKAGING=yes if you
 don't want setup.py to install manpages and doc files. You'll
 have to install them manually in your .spec or similar package
 build scripts.
 
 On the other hand if you want setup.py to install manpages 
 and docs, but to other than default path, define env 
 variables $S3CMD_INSTPATH_MAN and $S3CMD_INSTPATH_DOC. Check 
 out setup.py for details and default values.
 
 

 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
 

 or visit the S3cmd / S3tools homepage at: 
 
         http://s3tools.org