sconadm(1M)															       sconadm(1M)

NAME

       sconadm - register system information

SYNOPSIS

       /usr/sbin/sconadm  register  -a	[-e softwareUpdate  |  -E softwareUpdate]  [-h portal_name] [-l logfile] [-N] [-p proxy_host[:proxy_port]]
       [-r registration_profile] [-s] [-u username] [-x proxy_username]

       /usr/sbin/sconadm proxy [-l logfile] [-p proxy_host[:proxy_port]] [-r registration_profile] [-x proxy_username]

       The sconadm utility is a command-line version of the Basic Registration GUI. In the first form of the command in the  ,	sconadm  uses  the
       register  subcommand  to register a host with a registration server. In the second form, sconadm uses the proxy subcommand to configure all
       of the components for software update to use an HTTP web proxy.

       The parameters specified with -u, -e (or -E), -h, -p, and -x override values specified in your registration profile. A  template  for  this
       profile,  owned	by root, with read-only permissions, is stored in /var/lib/breg/data/RegistrationProfile.properties. See registration_pro-
       file(4).

       For the proxy subcommand, the proxy password is stored in the RegistrationProfile.properties file, available  if  proxy	authentication	is
       needed. Storage in the profile prevents proxy passwords from being exposed as part of a listing of processes on a system.

       The following options are supported:

       -a

	   Accept "Terms of Use and Binary Code License". Absence of this option means that you do not accept the license.

       -e softwareUpdate

	   Enable client to be managed at the Sun-hosted Update Connection Service.

       -E softwareUpdate

	   Disable client's ability to be managed at the Sun-hosted Update Connection Service.

       -h portal_name

	   Hostname of portal (Portal Common Name).

       -l logfile

	   Pathname of log file.

       -N

	   Never register.

       -p proxy_host[:proxy_port]

	   Proxy host name and optional proxy port number.

       -r registration_profile

	   Pathname to a registration profile.

       -s

	   Failsafe mode. The absence of this option specifies normal (non-failsafe) mode.

       -u username

	   User name (a Sun Online Account).

       -x proxy_username

	   User name on the proxy host.

       Unless specified otherwise, the commands below require root privileges or privileges equivalent to root. See privileges(5).

       Example 1: Registering a New System

       Assume a file registrationprofile.properties in /tmp that contains the following:

       userName=user123
       password=abc123
       hostName=
       subscriptionKey=
       portalEnabled=false
       proxyHostName=
       proxyPort=
       proxyUserName=
       proxyPassword=

       To register a new system using the profile above, you enter:

       /usr/sbin/sconadm register -a -r /tmp/registrationprofile.properties

       Example 2: Reregistering a System with a Different User

       Assume  a  file registrationprofile.properties in /tmp with the contents shown below. Note the changed specification for userName and pass-
       word.

       userName=newuser
       password=newpassword
       hostName=
       subscriptionKey=
       portalEnabled=false
       proxyHostName=
       proxyPort=
       proxyUserName=
       proxyPassword=

       To reregister a new system using the profile above, you enter the same command you entered to register the system:

       /usr/sbin/sconadm register -a -r /tmp/registrationprofile.properties

       Example 3: Reregistering a System, Adding a Sun Subscription Key

       Modify registrationprofile.properties as follows:

       userName=newuser
       password=newpassword
       hostName=
       subscriptionKey=abc12345678
       portalEnabled=false
       proxyHostName=
       proxyPort=
       proxyUserName=
       proxyPassword=

       Run the command:

       /usr/sbin/sconadm register -a -r /tmp/registrationprofile.properties

       Example 4: Reregistering and Enabling Access to all Update Connection Services

       Modify registrationprofile.properties as follows:

       userName=newuser
       password=newpassword
       hostName=
       subscriptionKey=abc12345678
       portalEnabled=false
       proxyHostName=
       proxyPort=
       proxyUserName=
       proxyPassword=

       Note that portalEnabled is set to false. Run the command:

       /usr/sbin/sconadm register -a -r /tmp/registrationprofile.properties 
       -e softwareUpdate

       Example 5: Registering in Failsafe Mode

       Modify registrationprofile.properties as follows:

       userName=user123
       password=test123
       hostName=
       subscriptionKey=
       portalEnabled=false
       proxyHostName=
       proxyPort=
       proxyUserName=
       proxyPassword=

       Run the command:

       /usr/sbin/sconadm register -a -r /tmp/registrationprofile.properties -s

       Example 6: Never Registering

       To never register a system, enter:

       /usr/sbin/sconadm register -N

       Example 7: Using a Proxy Server With Proxy Authentication

       Edit registrationprofile.properties as follows:

       userName=
       password=
       hostName=
       subscriptionKey=
       portalEnabled=
       proxyHostName=webcache.mycompany.com
       proxyPort=8080
       proxyUserName=myCompanyProxyUserName
       proxyPassword=myCompanyProxyPassword

       Run the command:

       /usr/sbin/sconadm proxy -r /tmp/registrationprofile.properties

       Example 8: Changing Proxy Host Settings

       Edit registrationprofile.properties as follows:

       userName=
       password=
       hostName=
       subscriptionKey=
       portalEnabled=
       proxyHostName=webcache.mycompany.com
       proxyPort=8080
       proxyUserName=myCompanyProxyUserName
       proxyPassword=myCompanyProxyPassword

       Run the command:

       /usr/sbin/sconadm proxy -r /tmp/registrationprofile.properties

       Then, change the proxyHostName value by running the following command:

       /usr/sbin/sconadm proxy -r /tmp/registrationprofile.properties 
       -p newproxy.mycompany.com

       After the preceding command all proxies use newproxy.mycompany.com.

       Example 9: Resetting a System Not to Use a Proxy

       Edit registrationprofile.properties as follows:

       userName=
       password=
       hostName=
       subscriptionKey=
       portalEnabled=
       proxyHostName=
       proxyPort=
       proxyUserName=
       proxyPassword=

       Note that values for all proxy fields are null.

       Run the command:

       /usr/sbin/sconadm proxy -r /tmp/registrationprofile.properties

       0

	   Success.

       >0

	   An error occurred.

       /var/lib/breg/data/RegistrationProfile.properties

	   Registration profile template.

       See attributes(5) for descriptions of the following attributes:

       +-----------------------------+-----------------------------+
       |      ATTRIBUTE TYPE	     |	    ATTRIBUTE VALUE	   |
       +-----------------------------+-----------------------------+
       |Availability		     |SUNWbreg			   |
       +-----------------------------+-----------------------------+
       |Interface Stability	     |Stable			   |
       +-----------------------------+-----------------------------+

       registration_profile(4), attributes(5), privileges(5)

								    20 Sep 2005 						       sconadm(1M)