rhncfg-manager

Langue: en

Version: 03 August 2005 (fedora - 01/12/10)

Section: 8 (Commandes administrateur)

NAME

rhncfg-manager - a tool used managing RHN's central repository of configuration files and channels.

SYNOPSIS

     
 
 rhncfg-manager [ MODE ] [ --server-name name ] [ params ]
 
 

DESCRIPTION

The RHN Configuration Manager (rhncfg-manager) is used to manage RHN configuration files and channels.

This tool offers a command line alternative to the configuration management features found within the RHN website (hosted or RHN Satellite), as well as the ability to script some or all of the related maintenance.

This tool is intended for use by the Config Administrator and therefore requires an RHN username and password that has the appropriate permission set. (The username may be specified in /etc/sysconfig/rhn/rhncfg-manager.conf or in the [rhncfg-manager] section of ~/.rhncfgrc).

Note that when run as root, rhncfg-manager attempts to pull in needed configuration values from the Red Hat Update Agent (up2date). When run as something other than root, configuration changes may be needed within the ~/.rhncfgrc file. The session file is cached in ~/.rhncfg-manager-session to prevent logging in for every command.

The ~/.rhncfgrc file overrides the values set in /etc/sysconfig/rhn/rhncfg-manager.conf which, by default, uses the values set in /etc/sysconfig/rhn/up2date. Please review rhncfg-manager.conf for further details.

The Red Hat Network Configuration Manager offers these primary modes: add, create-channel, diff, diff-revisions, download-channel, get, list, list-channels, remove, remove-channel, revisions, update, upload-channel.

Context sensitive help is available for each "mode", e.g., rhncfg-manager diff-revisions --help

This tool utilizes a "cvs style" command syntax: command mode options

For example: rhncfg-manager diff-revisions --help

MODES

add [ OPTIONS ] FILE [ FILE ... ]
Add a file to a config channel.

-cCHANNEL_LABEL, --channel=CHANNEL_LABEL -- upload file(s) in this config channel

-dDEST_FILE, --dest-file=DEST_FILE -- upload the file as this path

-tTOPDIR, --topdir=TOPDIR -- make all files relative to this string

--delim-start=DELIM_START -- start delimiter for variable interpolation

--delim-end=DELIM_END -- end delimiter for variable interpolation

create-channel CHANNEL_LABEL [ CHANNEL_LABEL ... ]
Create a config channel for your organization.
diff [ OPTIONS ] FILE [ FILE ... ]
Differentiating between latest configuration files in a channel and whats on disk.

-cCHANNEL_LABEL, --channel=CHANNEL_LABEL -- get file(s) from this config channel

-rREVISION, --revision=REVISION -- use this revision

-dDEST_FILE, --dest-file=DEST_FILE -- upload the file as this path

-tTOPDIR, --topdir=TOPDIR -- make all files relative to this string

diff-revisions [ OPTIONS ] FILE
Compare different versions of a file across channels and revisions. See documentation for further details.

-cCHANNEL_LABEL, --channel=CHANNEL_LABEL -- use this config channel

-rREVISION, --revision=REVISION -- use this revision

download-channel (-t|--topdir=)TOP_LEVEL_DIRECTORY [ OPTIONS ] CHANNEL_LABEL [ CHANNEL_LABEL ... ]
Download all the configuration files in a channel to disk.

-tTOPDIR, --topdir=TOPDIR -- directory all the file paths are relative to

get [ OPTIONS ] FILE [ FILE ... ]
Get the contents of a particular configuration file. Outputs to stdout.

-cCHANNEL_LABEL, --channel=CHANNEL_LABEL -- get file(s) from this config channel

-tTOPDIR, --topdir=TOPDIR -- make all files relative to this string

-rREVISION, --revision=REVISION -- get this file revision

list CHANNEL_LABEL
List all configuration files in a channel.
list-channels
List all configuration channels.
remove [ OPTIONS ] FILE [ FILE ... ]
Remove a configuration file from a channel. May be prompted for a username and password.

-cCHANNEL_LABEL, --channel=CHANNEL_LABEL -- remove file(s) from this config channel

-tTOPDIR, --topdir=TOPDIR -- make all files relative to this string

remove-channel CHANNEL_LABEL [ CHANNEL_LABEL ... ]
Remove a configuration channel. May be prompted for a username and password.
revisions [ OPTIONS ] FILE [ FILE ... ]
Determine the number of configuration file revisions.

-cCHANNEL_LABEL, --channel=CHANNEL_LABEL -- use this config channel

update [ OPTIONS ] FILE [ FILE ... ]
Create a new revision of a file in a channel (or add the first revisions to that channel if none existed before for the given path).

-cCHANNEL_LABEL, --channel=CHANNEL_LABEL -- upload file(s) in this config channel

-dDEST_FILE, --dest-file=DEST_FILE -- upload the file as this path

-tTOPDIR, --topdir=TOPDIR -- make all files relative to this string

--delim-start=DELIM_START -- start delimiter for variable interpolation

--delim-end=DELIM_END -- end delimiter for variable interpolation

upload-channel [ OPTIONS ] CHANNEL_LABEL [ CHANNEL_LABEL ... ]
Upload multiple configuration files (a tree) to a channel from disk.

-tTOPDIR, --topdir=TOPDIR -- directory all file paths are relative to

-h, --help
Display the help screen with a list of options.

Use context sensitive help as well with the diffent "modes". E.g., rhncfg-manager upload-channel --help

SEE ALSO

rhncfg-client (8)

AUTHORS

Mihai Ibanescu <misa@redhat.com>

Bret McMillan <bretm@redhat.com>

Todd Warner <taw@redhat.com> (man page only)