Skip to content

HTTPS clone URL

Subversion checkout URL

You can clone with
or
.
Download ZIP
Newer
Older
100644 98 lines (66 sloc) 2.707 kB
c3bc0a8 @mludvig Added more documentation.
mludvig authored
1 Installation of s3cmd package
2 =============================
3
4 Author:
5 Michal Ludvig <michal@logix.cz>
6
7 S3tools / S3cmd project homepage:
8 http://s3tools.sourceforge.net
9
10 Amazon S3 homepage:
11 http://aws.amazon.com/s3
12
13 !!!
14 !!! Please consult README file for setup, usage and examples!
15 !!!
16
17 Package formats
18 ---------------
19 S3cmd is distributed in two formats:
20 1) Prebuilt RPM file - should work on most RPM-based
21 distributions
22 2) Source .tar.gz package
23
24
25
26 Installation of RPM package
27 ---------------------------
28 As user "root" run:
29
30 rpm -ivh s3cmd-X.Y.Z.noarch.rpm
31
32 where X.Y.Z is the most recent s3cmd release version.
33
34 You may be informed about missing dependencies
35 on Python or some libraries. Please consult your
36 distribution documentation on ways to solve the problem.
37
38
39 Installation of source .tar.gz package
40 --------------------------------------
41 There are three options to run s3cmd from source tarball:
42
43 1) S3cmd program as distributed in s3cmd-X.Y.Z.tar.gz
44 can be run directly from where you untar'ed the package.
45
46 2) Or you may want to move "s3cmd" file and "S3" subdirectory
47 to some other path. Make sure that "S3" subdirectory ends up
48 in the same place where you move the "s3cmd" file.
49
50 For instance if you decide to move s3cmd to you $HOME/bin
51 you will have $HOME/bin/s3cmd file and $HOME/bin/S3 directory
52 with a number of support files.
53
54 3) The cleanest and most recommended approach is to run
55
56 python setup.py install
57
58 You will however need Python "distutils" module for this to
59 work. It is often part of the core python package (e.g. in
60 OpenSuse Python 2.5 package) or it can be installed using your
61 package manager, e.g. in Debian use
62
63 apt-get install python2.4-setuptools
64
65 Again, consult your distribution documentation on how to
66 find out the actual package name and how to install it then.
67
68
c993086 @mludvig 2007-06-19 Michal Ludvig <michal@logix.cz>
mludvig authored
69 Note to distibutions package maintainers
70 ----------------------------------------
71 Define shell environment variable S3CMD_PACKAGING=yes if you
72 don't want setup.py to install manpages and doc files. You'll
73 have to install them manually in your .spec or similar package
74 build scripts.
75
76 On the other hand if you want setup.py to install manpages
77 and docs, but to other than default path, define env
78 variables $S3CMD_INSTPATH_MAN and $S3CMD_INSTPATH_DOC. Check
79 out setup.py for details and default values.
80
81
c3bc0a8 @mludvig Added more documentation.
mludvig authored
82 Where to get help
83 -----------------
84 If in doubt, or if something doesn't work as expected,
85 get back to us via mailing list:
86
87 s3tools-general@lists.sourceforge.net
88
89 For more information refer to:
90 * S3cmd / S3tools homepage at http://s3tools.sourceforge.net
91
92 Enjoy!
93
94 Michal Ludvig
95 * michal@logix.cz
96 * http://www.logix.cz/michal
97
Something went wrong with that request. Please try again.