rhn_register  - a program for registering with the Red Hat
       Network


SYNOPSIS

       rhn_register [OPTION]... [PACKAGE NAME]...


DESCRIPTION

       rhn_register provides an interactive utility for register­
       ing a srever with the Red Hat Network.

       When  you  run  rhn_register, you will be prompted for the
       computer's root password if you are not running  as  root.
       This  is because rhn_register needs read access to the RPM
       database. It also needs read/write access to  the  up2date
       systemid  file  in  /etc/sysconfig/rhn/systemid , and it's
       configuration    in     /etc/sysconfig/rhn/up2date     and
       /etc/sysconfig/rhn/rhn_register

       rhn_register  will start up a interactive utility for reg­
       istering with the Red Hat Network. If you are using X,  it
       will start up a client with a graphical user interface. If
       you are using the console, a  text  mode  client  will  be
       started.

       The  first  step  is  to  provide the Red Hat Network with
       information for the  creation  of  your  new  account,  or
       information about your existing Red Hat Network or Red Hat
       website registration.

       Please be sure to read the welcome messages, and the  pri­
       vacy statement that are presented.

       rhn_register will also attempt to gather some basic infor­
       mation about the hardware, and software installed  in  the
       machine  being  registered.  Please  note that all of this
       information is optional, but without it, the functionality
       of Red Hat Network will be reduced.

       rhn_register  use  a http based protocol for communication
       with Red Hat Network, so if you are behind web proxy,  you
       may  need  to  configure  the proxy support before you can
       proceed.

       To configure rhn_register, you can run it with the  --con­
       figure  option,  or   you  can edit the configuration file
       /etc/sysconfig/rhn/rhn_register directly.  A number of the
       command line arguments described below can also be used at
       runtime to override configuration options. There is also a
       text  mode  based  configuration  if invoked with with the
       --nox --configure option.

              Configure rhn_register options.   This  will  allow
              you to adjust things such as http proxy settings.

       --nox  do  not  even attempt to use the gui component. Run
              the text mode version instead.

       -h, --help
              display help on command line arguments and exit

       --verbose
              output more information about what up2date is doing

       -v, --version
              output version information and exit


RETURN CODES

       Update Agent returns 0 on success, 1 on error.


FILES

       /etc/sysconfig/rhn/up2date
              Configuration settings for Update Agent.
       /etc/sysconfig/rhn/systemid
              Unique  system  identification  certificate for Red
              Hat Network.


EXAMPLES

       The  following  example  starts  up  the  interactive  gui
       client.

              up2date

       The  following  example  shows  up2date being used in non-
       interactive batch mode.

              up2date -u

       This example shows up2date being used  to  discover  which
       packages  solve  a set of deps manually on a Red Hat Linux
       7.0 machine.

              up2date --whatprovides "/bin/bash,gimp,libhistory.so.4.1"
              bash-2.04-11
              readline-4.1-5
              gimp-1.1.25-1

       This example shows how to start up the text  based  config
       tool.

              up2date --nox --configure

       This example shows how to use up2date to install a package
       with many deps that isnt currently installed.



SEE ALSO

       Configuration is performed  through  up2date-config.   The
       Update  Agent  is  tightly  coupled  with Red Hat Network.
       Visit <http://www.redhat.com/network>  for  access  or  to
       sign up.  You can also run rhn_register to register a sys­
       tem with Red Hat Network.


AUTHORS

       Written by Preston Brown <pbrown@redhat.com> and
       Cristian Gafton <gafton@redhat.com>


REPORTING BUGS

       Report bugs to <http://bugzilla.redhat.com>.


COPYRIGHT

       Copyright © 1999, 2000 Red Hat, Inc.
       This is free software; see the source for  copying  condi­
       tions.  There is NO warranty; not even for MERCHANTABILITY
       or FITNESS FOR A PARTICULAR PURPOSE.


Man(1) output converted with man2html