satellite-sync(8)

1SATELLITE-SYNC(8)                                            SATELLITE-SYNC(8)
2
3
4

NAME

6       satellite-sync  -  Incrementally synchronize an RHN Satellite's DB data
7       and RPM repository with Red Hat's RHN DB and RPM repository.
8

SYNOPSIS

10       satellite-sync [ options ... ]  [ -mDIRECTORY ]  [ --mount-point=DIRECTORY ]
11
12
13
14        [ --rhn-cert ]
15
16
17
18
19        [ -l ]  [ --list-channels ]
20
21        [ -cCHANNEL ]  [ --channel=CHANNEL ]
22
23        [ --iss-parent=ISS_PARENT ]
24
25        [ -p ]  [ --print-configuration ]
26
27        [ --step=[channels|rpms|packages|errata|kickstarts] ]
28
29        [ --no-rpms ]
30
31        [ --no-packages ]  [ --force-all-packages ]
32
33        [ --no-ssl ]
34
35        [ --force-all-errata ]
36
37        [ --no-errata ]
38
39        [ --no-kickstarts ]
40
41        [ --debug-level=DEBUG_LEVEL ]
42
43        [ --email ]
44
45        [ --traceback-mail=EMAIL_ADDESS(ES) ]
46
47        [ -sHOSTNAME ]  [ --server=HOSTNAME ]
48
49        [ --http-proxy=HOSTNAME:PORT ]
50
51        [ --http-proxy-username=USERNAME ]
52
53        [ --http-proxy-password=PASSWORD ]
54
55        [ --ca-cert=SSL_CA_CERT_FULL_PATH ]
56
57        [ -dDBUSERNAME/DBPASSWORD@DBSID ]  [ --db=DBUSERNAME/DBPASSWORD@DBSID ]
58
59        [ --orgid=ORGID ]
60
61        [ --systemid=SYSTEMID_PATH ]
62
63        [ --batch-size=BATCH_SIZE ]
64
65        [ --list-error-codes ]
66
67        [ --no-ssl ]
68
69        [ -h ]  [ --help ]
70
71        [ --usage ]
72
73
74

DESCRIPTION

76       The RHN Satellite  Incremental  Synchronization  Tool  (satellite-sync)
77       synchronizes an RHN Satellite Server with Red Hat's RHN servers.
78
79       This  tool enables an RHN Satellite Server to update its database meta‐
80       data and RPM packages with that of Red Hat. This  action  can  be  per‐
81       formed via the internet (ie. directly) or via the local file-system (an
82       update/channel CD dumped to the appropriate mount point).
83
84       Options set by default if no options  given:  --cache-refresh-level  2,
85       and all --step options.
86
87       The  --step options describe a step in a process (channels, rpms, pack‐
88       ages, errata, kickstarts). I.e. by default, the process is:
89
90       o channels: sync channel data
91
92       o rpms: sync (fetch) rpms
93
94       o packages: sync full package metadata for those rpms fetched  success‐
95       fully
96
97       o errata: sync errata data
98
99       o kickstarts: sync kickstart data
100
101       Each  option  is  dependent  on  the other. So, for example, if you use
102       "--step packages" and no other option, all other steps that occur prior
103       to the "packages" step will be performed as well.
104
105       As  can  be imagined, "--step channels" is called for nearly all opera‐
106       tions.
107

OPTIONS

109       -h, --help
110              Display the help screen with a list of options.
111
112       --usage
113              Display the usage options for satellite sync.
114
115       -mDIRECTORY,
116              mount point for import : disk  update  or  disconnected  install
117              only.
118
119       --consider-full
120              When this option is used, the export being synced from disk dump
121              will be considered to be a full export; any package in the chan‐
122              nel  but  not in the export will be deleted. Without this option
123              all disk dumps  are  interpreted  as  incremental  dumps.   This
124              option  has sense only for --mount-point.  Live sync and ISS are
125              always considered as full sync.
126
127       --rhn-cert
128              satellite certificate to import(use only with -m option)
129
130       -l, --list-channels
131              list all available channels for import/syncing and exit.
132
133       -cCHANNEL,
134              process data for this channel only.
135
136       --iss-parent
137              parent satellite to import content from.
138
139       -p, --print-configuration
140              print the current configuration and exit.
141
142       --no-ssl
143              turn off SSL (not recommended).
144
145       --no-rpms
146              do not fetch actual rpms.
147
148       --no-packages
149              do not process full package metadata.
150
151       --no-errata
152              do not process errata data.
153
154       --no-kickstarts
155              do not process kickstart data (provisioning feature).
156
157       --force-all-packages
158              forcibly  process  full  package  metadata  regardless  of  diff
159              results.
160
161              This option will automatically enable --step rpms.
162
163       --force-all-errata
164              forcibly process all errata metadata regardless of diff results.
165
166       --debug-level=DEBUG_LEVEL
167              Override  the  level (amount) of messaging to both the log files
168              and the screen. This debug level  is  set  in  /etc/rhn/rhn.conf
169              (the  debug variable). The default setting (for normal levels of
170              messaging) is 2. --debug-level can be set to a level  between  0
171              (nearly no messaging) to 6 (insane amount of messaging).
172
173       --email
174              e-mail a report of what was synced/imported (sent to whomever is
175              considered the receiver of "traceback_email").
176
177       --traceback-mail=EMAIL_ADDRESS(ES)
178              alternative  email  address(es)  for  all  sync  correspondence.
179              Example:     --traceback-mail="user1@example.com,    user2@exam‐
180              ple.com".
181
182       -sHOSTNAME,
183              alternative server with which to connect (hostname).
184

DEBUGGING AND EXPERIMENTAL OPTIONS

186       --step=[channels|rpms|packages|errata|kickstarts]
187              DEBUG ONLY:
188
189              Perform the sync process *only* to the step specified
190
191              channels
192                     process channel  data.  This  option  will  automatically
193                     enable the "arches" step.
194
195              rpms   fetch rpms and fill repository. This option will automat‐
196                     ically enable the "channels" step.
197
198              packages
199                     process full package metadata (can be  very  slow).  This
200                     option will automatically enable the "rpms" step.
201
202              errata process  errata  data.  This  option  will  automatically
203                     enable the "channels" step.
204
205              kickstarts
206                     process kickstart data (metadata and  files)  for  provi‐
207                     sioning. This option will automatically enable the "chan‐
208                     nels" step.
209
210       --http-proxy=HOSTNAME:PORT
211              alternative http proxy (hostname:port)
212
213       --http-proxy-username=USERNAME
214              alternative http proxy username
215
216       --http-proxy-password=PASSWORD
217              alternative http proxy password
218
219       --ca-cert=SSL_CA_CERT_FULL_PATH
220              alternative SSL CA Cert (fullpath to cert file)
221
222       -dDBUSERNAME/DBPASSWORD@DB,
223              alternative database connection string (username/password@sid).
224
225       --orgid=ORGID
226              org to which the sync imports data. defaults to the org  in  the
227              export.
228
229       --systemid=SYSTEMID_PATH
230              DEBUG  ONLY:  alternative path to digital system id. This option
231              is generally only useful for internal testing.
232
233       --batch-size=BATCH_SIZE
234              DEBUG ONLY: maximum batch-size for XML/database-import  process‐
235              ing (1..50).
236
237              This  option  should  not be used except for debugging purposes.
238              The most useful case being --batch-size=1 where the  XML  parser
239              and  database  import  process  each piece of meta-data one at a
240              time, isolating any issues.
241
242              WARNING: --batch-size=1 will dramatically  slow  down  the  sync
243              process.
244
245       --list-error-codes
246              list the possible exit codes for satellite-sync
247

EXAMPLES

249       satellite-sync --list-channels
250
251       satellite-sync --channel=rhel-i386-as-3
252
253       satellite-sync -c rhel-i386-as-3 -c redhat-advanced-server-i386
254
255       satellite-sync -m /var/tmp/channel-dumps --list-channels
256
257       satellite-sync -m /var/tmp/channel-dumps -c rhel-i386-as-3
258
259       satellite-sync    --iss-parent=stage-satellite.yourorg.com   -c   rhel-
260       i386-as-4
261

AUTHORS

276       Todd Warner <taw@redhat.com>
277
278       Mihai Ibanescu <misa@redhat.com>
279
280       Pradeep Kilambi <pkilambi@redhat.com>
281
282
283
284Version 3.5.0                  18 November 2010              SATELLITE-SYNC(8)