6.2. Importing with RHN Satellite Synchronization Tool
satellite-sync) enables an RHN Satellite to update its database metadata and RPM packages with those of RHN's central servers, another Satellite within your organization, or local media.
satellite-synccan import a large amount of data, especially on newly installed Satellite servers. If your database has performance issues after a significant amount of data changes, consider gathering statistics on the database. Refer to Section 8.4, “Using RHN DB Control” for more information.
channel-families— Import/synchronize channel family (architecture) data.
channels— Import/synchronize channel data.
rpms— Import/synchronize RPMs.
packages— Import/synchronize full package data for those RPMs retrieved successfully.
errata— Import/synchronize Errata information.
rpmsstep will automatically ensure the
channel-familiessteps take place first. To initiate an individual step, use the
--stepoption, like so:
--step, the RHN Satellite Synchronization Tool offers many other command line options. To use them, insert the option and the appropriate value after the
satellite-synccommand when launching import/synchronization.
Table 6.2. Satellite Import/Sync Options
| ||Display this list of options and exit.|
| ||Include alternate database connect string: username/password@SID.|
| ||Import/sync from local media mounted to the Satellite. To be used in closed environments (such as those created during disconnected installs).|
| ||List all available channels and exit.|
| ||Process data for this channel only. Multiple channels can be included by repeating the option. If no channels are specified, all channels on the Satellite will be freshened.|
| ||Print the current configuration and exit.|
| ||Not Advisable - Turn off SSL.|
| ||Perform the sync process only to the step specified. Typically used in testing.|
| ||Do not retrieve actual RPMs.|
| ||Do not process full package data.|
| ||Do not process Errata information.|
| ||Do not process kickstart data (provisioning only).|
| ||Forcibly process all package data without conducting a diff.|
| || Override the amount of messaging sent to log files and generated on the screen set in |
| ||Email a report of what was imported/synchronized to the designated recipient of traceback email.|
| || Direct sync output (from |
| ||Include the hostname of an alternative server to connect to for synchronization.|
| ||Add an alternative HTTP proxy server in the form hostname:port.|
| ||Include the username for the alternative HTTP proxy server.|
| ||Include the password for the alternative HTTP proxy server.|
| ||Use an alternative SSL CA certificate by including the full path and filename.|
| ||For debugging only - Include path to alternative digital system ID.|
| ||For debugging only - Set maximum batch size in percent for XML/database-import processing. Open man satellite-sync for more information.|
satellite-syncsynchronizes all channels that already exist in the Satellite's database. By default, the
--step(all steps) option is enabled.
--channeloption requires the channel label, not its name. For instance, use "rhel-i386-as-3" not "Red Hat Enterprise Linux 3 i386." Use the
--list-channelsoption to obtain a list of all channels by label. All displayed channels are available for importing and synchronizing.