rhnpush

Langue: en

Version: 27 February 2009 (fedora - 06/07/09)

Section: 8 (Commandes administrateur)

NAME

rhnpush - Utility to push binary and source RPMs into an RHN channel.

SYNOPSIS

     
 
 rhnpush [ options ... ]  [ -v ]  [ --verbose ] 
 
     
 
  [ -dDIRECTORY ]  [ --dir=DIRECTORY ] 
 
     
 
  [ -cCHANNEL_LABEL ]  [ --channel=CHANNEL_LABEL ] 
 
     
 
  [ -nN_HEADERS_PER_CALL ]  [ --count=N_HEADERS_PER_CALL ] 
 
     
 
  [ -l ]  [ --list ] 
 
     
 
  [ -rRELATIVE_DIRECTORY ]  [ --reldir=RELATIVE_DIRECTORY ] 
 
     
 
  [ -oORGANIZATION_ID ]  [ --orgid=ORGANIZATION_ID ] 
 
     
 
  [ -uUSERNAME ]  [ --username=USERNAME ] 
 
     
 
  [ -pPASSWORD ]  [ --password=PASSWORD ] 
 
     
 
  [ -s ]  [ --stdin ] 
 
     
 
  [ -Xglob ]  [ --exclude=GLOB ] 
 
     
 
  [ --force ] 
 
     
 
  [ --nosig ] 
 
     
 
  [ --newest ] 
 
     
 
  [ --nullorg ] 
 
     
 
  [ --header ] 
 
     
 
  [ --source ] 
 
     
 
  [ --server=SERVER ] 
 
     
 
  [ --new-cache ] 
 
     
 
  [ --extended-test ] 
 
     
 
  [ --test ] 
 
     
 
  [ --tolerant ] 
 
     
 
  [ -h ]  [ --help ] 
 
     
 
  [ -? ]  [ --usage ] 
 
 

DESCRIPTION

The RHN Satellite Package Pusher (rhnpush) pushes RPMs into locally managed channels on an RHN Satellite Server. Refer to the RHN Satellite documentation for further reference.

OPTIONS

-v --verbose
Increase verbosity (can use multiple times).
-dDIRECTORY
process packages from this directory.
-cCHANNEL_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*.
-nN_HEADERS_PER_CALL
process this number of headers per call. Current default is 25. Must be an integer.
-l --list
only list the specified channels.
-rRELATIVE_DIRECTORY
relative directory to associate with each file.
-oORGANIZATION_ID
Your organization's ID number. Must be an integer.
-uUSERNAME
username of user that has administrative access to the specified channel.
-pPASSWORD
see --username.
-s --stdin
read the package names from standard-in (allows piping).
-Xglob
exclude packages that matches this glob expression.
--force
force the package upload (overwrites if package is already uploaded).
--tolerant
If rhnpush errors while uploading a package, continue attempting to push the rest of the packages.
--nosig
don't fail if packages are unsigned.
--newest
push only the packages that are newer than those on the server.

Please note that source RPMs are special in that their versions are never compared. Therefore, using this option with RHN Satellite Package Pusher will upload source RPMs for the specified channels only if they were not previously uploaded, and binaries built from them exist in those channels.

In other words, you have to upload a binary rpm before being able to use --newest with its source rpm.

--nullorg
use the null org ID (most often the case).
--header
only upload the headers.
--source
the packages indicated are source packages (we treat them differently).
--server=SERVER
push to this server. The format is http[s]://<hostname>/APP
--test
only print the packages to be pushed, don't actually push them.
--new-cache
create a new username/password cache
--extended-test
perform a more verbose test.
-h --help
briefly describe the options.
-? --usage
usage summary.

NOTES ON USING RHNPUSH

Rhnpush has three configuration files called /etc/sysconfig/rhn/rhnpushrc, ~/.rhnpushrc, and ./.rhnpushrc.

/etc/sysconfig/rhn/rhnpushrc is the system-wide default settings for rhnpush.

~/.rhnpushrc is the user-specific settings that override the system-wide settings.

./.rhnpushrc controls the directory specific settings that override the user-specific and system-specific settings.

/etc/sysconfig/rhn/rhnpushrc must be present for rhnpush to function correctly. If it is missing, rhnpush will attempt to use a series of default settings stored internally as a replacement. ~/.rhnpushrc and ./.rhnpushrc are not required to be present, but will be used if they are present. They are not created automatically by rhnpush.

Rhnpush uses a cache, stored at ~/.rhnpushcache, to temporarily hold the username and password for a user.

If the cache is missing, it will be created by rhnpush.

If the cache is present and not too old, the usename-password combo will be used as a convenience for the user.

The amount of time a cache lasts is configurable in any of the three configuration files.

If your username/password combination gets messed up you have two options. One, you can wait until the cache expires, which takes minutes by default. Two, you can use the --new_cache option to force rhnpush to let you reenter your username/password.

Using the --stdin and --dir options at the same time works as follows: rhnpush will let you type in rpm names, each rpm name on a separate line. When you have finished entering in rpm names, hit Ctrl-D. Rhnpush will then grab the files from directory you specified with --dir, put them in a list with the rpms you listed through standard input, and send them to the channel that was listed on the command-line or in the configuration files.

SEE ALSO

db-control(1) - embedded database environment only!

rhn-charsets(8)

rhn-schema-version(8)

rhn-ssl-dbstore(8)

satellite-debug(8)

satellite-sync(8)

rhn-satellite-activate(8)

AUTHORS

Todd Warner <taw@redhat.com>

Mihai Ibanescu <misa@redhat.com>