rhncfg-manager(8)

1RHNCFG-MANAGER(8)                                            RHNCFG-MANAGER(8)
2
3
4

NAME

6       rhncfg-manager  - a tool used managing RHN's central repository of con‐
7       figuration files  and channels.
8

SYNOPSIS

10       rhncfg-manager [ MODE ] [ --server-name name ] [ params ]
11
12

DESCRIPTION

14       The RHN Configuration Manager (rhncfg-manager) is used  to  manage  RHN
15       configuration files and channels.
16
17       This  tool  offers a command line alternative to the configuration man‐
18       agement features found within the RHN website  (hosted  or  RHN  Satel‐
19       lite),  as  well  as  the  ability to script some or all of the related
20       maintenance.
21
22       This tool is intended for use by the Config Administrator and therefore
23       requires  an RHN username and password that has the appropriate permis‐
24       sion set. (The username may be specified in  /etc/sysconfig/rhn/rhncfg-
25       manager.conf or in the [rhncfg-manager] section of ~/.rhncfgrc).
26
27       Note  that  when run as root, rhncfg-manager attempts to pull in needed
28       configuration values from the Red Hat Update Agent (up2date). When  run
29       as  something  other  than  root,  configuration  changes may be needed
30       within the ~/.rhncfgrc file. The session file is cached  in  ~/.rhncfg-
31       manager-session to prevent logging in for every command.
32
33       The   ~/.rhncfgrc   file  overrides  the  values  set  in  /etc/syscon‐
34       fig/rhn/rhncfg-manager.conf which, by default, uses the values  set  in
35       /etc/sysconfig/rhn/up2date.  Please review rhncfg-manager.conf for fur‐
36       ther details.
37
38       The Red Hat Network Configuration Manager offers these  primary  modes:
39       add, create-channel, diff, diff-revisions, download-channel, get, list,
40       list-channels, remove, remove-channel, revisions, update,  upload-chan‐
41       nel.
42
43       Context  sensitive help is available for each "mode", e.g., rhncfg-man‐
44       ager diff-revisions --help
45
46       This tool utilizes a "cvs style" command syntax: command mode options
47
48       For example: rhncfg-manager diff-revisions --help
49

MODES

51       add [ OPTIONS ] FILE [ FILE ... ]
52              Add a file to a config channel.
53
54              -cCHANNEL_LABEL, --channel=CHANNEL_LABEL --  upload  file(s)  in
55              this config channel
56
57              -dDEST_FILE,  --dest-file=DEST_FILE  --  upload the file as this
58              path
59
60              -tTOPDIR, --topdir=TOPDIR -- make all  files  relative  to  this
61              string
62
63              --delim-start=DELIM_START -- start delimiter for variable inter‐
64              polation
65
66              --delim-end=DELIM_END -- end delimiter for  variable  interpola‐
67              tion
68
69       create-channel CHANNEL_LABEL [ CHANNEL_LABEL ... ]
70              Create a config channel for your organization.
71
72       diff [ OPTIONS ] FILE [ FILE ... ]
73              Differentiating  between latest configuration files in a channel
74              and whats on disk.
75
76              -cCHANNEL_LABEL, --channel=CHANNEL_LABEL  --  get  file(s)  from
77              this config channel
78
79              -rREVISION, --revision=REVISION -- use this revision
80
81              -dDEST_FILE,  --dest-file=DEST_FILE  --  upload the file as this
82              path
83
84              -tTOPDIR, --topdir=TOPDIR -- make all  files  relative  to  this
85              string
86
87       diff-revisions [ OPTIONS ] FILE
88              Compare  different  versions of a file across channels and revi‐
89              sions. See documentation for further details.
90
91              -cCHANNEL_LABEL,  --channel=CHANNEL_LABEL  --  use  this  config
92              channel
93
94              -rREVISION, --revision=REVISION -- use this revision
95
96       download-channel  (-t|--topdir=)TOP_LEVEL_DIRECTORY  [  OPTIONS ] CHAN‐
97       NEL_LABEL [ CHANNEL_LABEL ... ]
98              Download all the configuration files in a channel to disk.
99
100              -tTOPDIR, --topdir=TOPDIR -- directory all the  file  paths  are
101              relative to
102
103       get [ OPTIONS ] FILE [ FILE ... ]
104              Get  the contents of a particular configuration file. Outputs to
105              stdout.
106
107              -cCHANNEL_LABEL, --channel=CHANNEL_LABEL  --  get  file(s)  from
108              this config channel
109
110              -tTOPDIR,  --topdir=TOPDIR  --  make  all files relative to this
111              string
112
113              -rREVISION, --revision=REVISION -- get this file revision
114
115       list CHANNEL_LABEL
116              List all configuration files in a channel.
117
118       list-channels
119              List all configuration channels.
120
121       remove [ OPTIONS ] FILE [ FILE ... ]
122              Remove a configuration file from a channel. May be prompted  for
123              a username and password.
124
125              -cCHANNEL_LABEL,  --channel=CHANNEL_LABEL -- remove file(s) from
126              this config channel
127
128              -tTOPDIR, --topdir=TOPDIR -- make all  files  relative  to  this
129              string
130
131       remove-channel CHANNEL_LABEL [ CHANNEL_LABEL ... ]
132              Remove  a  configuration channel. May be prompted for a username
133              and password.
134
135       revisions [ OPTIONS ] FILE [ FILE ... ]
136              Determine the number of configuration file revisions.
137
138              -cCHANNEL_LABEL,  --channel=CHANNEL_LABEL  --  use  this  config
139              channel
140
141       update [ OPTIONS ] FILE [ FILE ... ]
142              Create  a  new revision of a file in a channel (or add the first
143              revisions to that channel if none existed before for  the  given
144              path).
145
146              -cCHANNEL_LABEL,  --channel=CHANNEL_LABEL  --  upload file(s) in
147              this config channel
148
149              -dDEST_FILE, --dest-file=DEST_FILE -- upload the  file  as  this
150              path
151
152              -tTOPDIR,  --topdir=TOPDIR  --  make  all files relative to this
153              string
154
155              --delim-start=DELIM_START -- start delimiter for variable inter‐
156              polation
157
158              --delim-end=DELIM_END  --  end delimiter for variable interpola‐
159              tion
160
161       upload-channel [ OPTIONS ] CHANNEL_LABEL [ CHANNEL_LABEL ... ]
162              Upload multiple configuration files (a tree) to a  channel  from
163              disk.
164
165              -tTOPDIR,  --topdir=TOPDIR -- directory all file paths are rela‐
166              tive to
167
168       -h, --help
169              Display the help screen with a list of options.
170
171              Use context sensitive help as well  with  the  diffent  "modes".
172              E.g., rhncfg-manager upload-channel --help
173

AUTHORS

178       Mihai Ibanescu <misa@redhat.com>
179
180       Bret McMillan <bretm@redhat.com>
181
182       Todd Warner <taw@redhat.com> (man page only)
183
184
185
186Version 4.0                     03 August 2005               RHNCFG-MANAGER(8)

NAME

SYNOPSIS

DESCRIPTION

MODES

SEE ALSO

AUTHORS