1JETS3T-SYNCHRONIZE(1)                                    JETS3T-SYNCHRONIZE(1)
2
3
4

NAME

6       jets3t-synchronize - synchronize local directories with an Amazon S3
7       account
8

SYNOPSIS

10       Synchronize the contents of a local directory with S3:
11         jets3t-synchronize [options] UP <S3path> <path1> [[path2] .. [pathN]]
12
13       Synchronize the contents of S3 with a local directory:
14         jets3t-synchronize [options] DOWN <S3path> <download_dir>
15

OVERVIEW

17       jets3t-synchronize is a console (text mode) Java application for
18       synchronizing directories on a computer with an Amazon S3 account.
19

OPTIONS

21       -h, --help
22         Displays a brief summary with all options.
23
24       -n, --noaction
25         No action taken. No files will be changed locally or on S3, instead a
26         report will be generating showing what will happen if the command is
27         run without the -n option.
28
29       -q, --quiet
30         Runs quietly, without reporting on each action performed or
31         displaying progress messages. The summary is still displayed.
32
33       -p, --noprogress
34         Runs somewhat quietly, without displaying progress messages.  The
35         action report and overall summary are still displayed.
36
37       -f, --force
38         Force tool to perform synchronization even when files are up-to-date.
39         This may be useful if you need to update metadata or timestamps in
40         S3.
41
42       -k, --keepfiles
43         Keep outdated files on destination instead of reverting/removing
44         them.  This option cannot be used with --nodelete.
45
46       -d, --nodelete
47         Keep files on destination that have been removed from the source.
48         This option is similar to --keepfiles except that files may be
49         reverted.  This option cannot be used with --keepfiles.
50
51       -m, --move
52         Move items rather than merely copying them. Files on the local
53         computer will be deleted after they have been uploaded to S3, or
54         objects will be deleted from S3 after they have been downloaded. Be
55         *very* careful with this option.  This option cannot be used with
56         --keepfiles.
57
58       -b, --batch
59         Download or upload files in batches, rather than all at once.
60         Enabling this option will reduce the memory required to synchronize
61         large buckets, and will ensure file transfers commence as soon as
62         possible. When this option is enabled, the progress status lines
63         refer only to the progress of a single batch.
64
65       -s, --skipmetadata
66         Skip the retrieval of object metadata information from S3. This will
67         make the synch process much faster for large buckets, but it will
68         leave jets3t-synchronize with less information to make decisions. If
69         this option is enabled, empty files or directories will not be
70         synchronized reliably.  This option cannot be used with the --gzip or
71         --crypto options.
72
73       -g, --gzip
74         Compress (GZip) files when backing up and decompress gzipped files
75         when restoring.
76
77       -c, --crypto
78         Encrypt files when backing up and decrypt encrypted files when
79         restoring. If this option is specified the properties must contain a
80         password.
81
82       --properties filename
83         Load the synchronizer app properties from the given file rather than
84         from a synchronizer.properties file in the classpath.
85
86       --credentials filename
87         Load your AWS credentials from an encrypted file, rather than from
88         the synchronizer.properties file. This encrypted file can be created
89         using the Cockpit application, or the JetS3t API library.
90
91       --acl ACL_string
92         Specifies the Access Control List setting to apply. This value must
93         be one of: PRIVATE, PUBLIC_READ, PUBLIC_READ_WRITE. This setting will
94         override any acl property specified in the synchronize.properties
95         file
96
97       --reportlevel level
98         A number that specifies how much report information will be printed:
99
100         0 - no report items will be printed (the summary will still be
101         printed).
102
103         1 - only actions are reported
104
105         [Prefixes N, U, D, R, F, M]
106
107         2 - differences & actions are reported
108
109         [Prefixes N, U, D, R, F, M, d, r]
110
111         3 - DEFAULT: all items are reported
112
113         [Prefixes N, U, D, R, F, M, d, r, -]
114

NOTES

116       Required properties can be provided via: a file named
117       synchronize.properties in the classpath (or
118       /etc/jets3t/synchronize.properties), a file specified with the
119       --properties option, or by typing them in when prompted on the command
120       line. Required properties are:
121
122       accesskey: Your AWS Access Key (Required)
123       secretkey: Your AWS Secret Key (Required)
124       password: Encryption password (only required when using crypto)
125
126       Properties specified in this file will override those in
127       jets3t.properties (or in /etc/jets3t/jets3t.properties).
128

REPORT

130       Report items are printed on a single line with an action flag followed
131       by the relative path of the file or S3 object. The report legend
132       follows:
133
134       N: A new file/object will be created
135
136       U: An existing file/object has changed and will be updated
137
138       D: A file/object existing on the target does not exist on the source
139       and will be deleted.
140
141       d: A file/object existing on the target does not exist on the source
142       but because the --keepfiles or --nodelete option was set it was not
143       deleted.
144
145       R: An existing file/object has changed more recently on the target than
146       on the source. The target version will be reverted to the older source
147       version
148
149       r: An existing file/object has changed more recently on the target than
150       on the source but because the --keepfiles option was set it was not
151       reverted.
152
153       -: A file is identical between the local system and S3, no action is
154       necessary.
155
156       F: A file identical locally and in S3 was updated due to the Force
157       option.
158
159       M: The file/object will be moved (deleted after it has been copied
160       to/from S3).
161

SEE ALSO

163       http://jets3t.s3.amazonaws.com/applications/synchronize.html
164
165
166
167                                  2019-02-01             JETS3T-SYNCHRONIZE(1)
Impressum