rhn_register

 


RHN_REGISTER(8)           Red Hat, Inc.           RHN_REGISTER(8)



NAME
       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
              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.

              up2date kdebase


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_regis­
       ter to register a system 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
       conditions.  There is NO  warranty;  not  even  for
       MERCHANTABILITY  or  FITNESS  FOR A PARTICULAR PUR­
       POSE.



Linux                       FEB 9 2001            RHN_REGISTER(8)