rhn-satellite-exporter

8 Version 1.0

`rhn-satellite-exporter`

A tool that exports Red Hat Satellite content into a directory in an XML format. That content can then be imported using satellite-sync's -m option.

            rhn-satellite-exporter
            options ...

            -v
            --verbose

            -dDIRECTORY
            --dir=DIRECTORY

            -cCHANNEL_LABEL
            --channel=CHANNEL_LABEL

            -a
            --all-channels

            --hard-links

            --start-date=START_DATE

            --end-date=END_DATE

            --use-rhn-date

            --use-sync-date

            --whole-errata

            -p
            --print-configuration

            --step

            --no-rpms

            --no-packages

            --no-errata

            --no-kickstarts

            --debug-level

            --email

            --traceback-mail

            --all-orgs

            -oORG
            --org=ORG

            --list-orgs

            --help

## Description

The &RHNSATEXPORTER; (rhn-satellite-exporter) tool exports Red Hat Satellite content in an XML format that is understood by satellite-sync's -m option. The means of transporting the exported information to the Red Hat Satellite server is up to the user and beyond the scope of this document. The content is exported into a directory that is specified by the user with the -d option. rhn-satellite-exporter can export the following content: Channel Families, Arches, Channel Metadata, Blacklists, RPMS, RPM Metadata, Errata, Kickstarts.

The amount of time it takes rhn-satellite-exporter to export data is dependent on the number and size of the channels being exported. Using the --no-packages, --no-kickstarts, --no-errata, and --no-rpms options will reduce the amount of time it takes for rhn-satellite-exporter to run, but they will also prevent potentially useful information from being exported. For that reason, they should only be used when you are certain that you will not need the content that they exclude. Additionally, you will need to use the matching options for satellite-sync when importing the data. For example, if you use --no-kickstarts with rhn-satellite-exporter you will have to use satellite-sync's --no-kickstarts option when importing the data.

If you are exporting one of the base channels provided by RHN, you will also need to export the tools channel associated with that base channel in order to kickstart machines to the distribution in the base channel. For instance, if you export rhel-i386-as-4 you should also export the rhn-tools-rhel-4-as-i386 channel in order to kickstart machines to RHEL 4 AS. This is because the tools channels contain the auto-kickstart packages that install packages for kickstarting a machine through the Red Hat Satellite.

The --email option is used to send a report to the administrator's email address when the export is complete. If an error occurs when the --email option is set, the error should be included in the report. The only time that --email will not work is if an error occurs while the program is starting up. Increasing the debug level by using --debug-level will increase the amount of information included in the report.

## Options

-v, --verbose

- Set debug level to 3. Overrides the value in rhn.conf.

-dDIR, --dir=DIR

- Place the exported information into this directory.

--hard-links

- Hard link exported packages and kickstarts to original files.

-c`CHANNEL_LABEL`, --channel=`CHANNEL_LABEL`

- Process data for this specific channel (specified by label) only. NOTE: the channel's *label* is NOT the same as the channel's *name*.

-a, --all-channels

- Export all channels.

--start-date=`START_DATE`

- The start date limit that the last modified dates are compared against. Should be in the format 'YYYYMMDDHH24MISS'. If you did not enter hour, minute and/or second, then zero is assumed. I.e. date 20100101 is expanded to 20100101000000.

--end-date=`END_DATE`

- The end date limit that the last modified dates are compared against. Must be in the format 'YYYYMMDDHH24MISS'. If you did not enter hour, minute and/or second, then zero is assumed. I.e. date 20100101 is expanded to 20100101000000.

--use-rhn-date

- Limit exported packages according to the date when they appeared at Red Hat Network. This is default.

--use-sync-date

- Limit exported packages according to the date they where pulled into Red Hat Satellite.

--whole-errata

- Always include package if it belongs to errata which is withing start/end-date range.

--make-isos=`MAKE_ISOS`

- Create channel dump isos directory called satellite-isos. Usage: --make-isos=cd or dvd.

--list-channels

- List the channels that can be exported.

--list-steps

- List all of the steps that rhn-satellite-exporter takes while exporting data. These can be used as values for --step.

-p, --print-configuration

- Print the configuration and exit.

--print-report

- Print a report to the terminal when the export is complete.

--step

- Export information only up to this step.

--no-rpms

- Do not export RPMs.

--no-packages

- Do not export RPM metadata.

--no-errata

- Do not export errata.

--no-kickstarts

- Do not export kickstart data.

--debug-level

- Set the debug level to this value. Overrides the value in /etc/rhn/rhn.conf for this tool.

--email

- Email a report of what was exported and what errors may have occurred.

--traceback-mail

- Alternative email address for --email.

--all-orgs

- Export all orgs.

-o`ORG`, --org=`ORG`

- Include the org with this id in the export.

--list-orgs

- List all orgs that can be exported.

-h, --help

- Show help message and exit.

## See Also

- satellite-sync(8)

## Authors

- John Wregglesworth wregglej@redhat.com