te
Copyright (c) 2005, Sun Microsystems, Inc. All Rights Reserved
The contents of this file are subject to the terms of the Common Development and Distribution License (the "License"). You may not use this file except in compliance with the License.
You can obtain a copy of the license at usr/src/OPENSOLARIS.LICENSE or http://www.opensolaris.org/os/licensing. See the License for the specific language governing permissions and limitations under the License.
When distributing Covered Code, include this CDDL HEADER in each file and include the License file at usr/src/OPENSOLARIS.LICENSE. If applicable, add the following below this CDDL HEADER, with the fields enclosed by brackets "[]" replaced with your own identifying information: Portions Copyright [yyyy] [name of copyright owner]
sconadm - register system information

/usr/sbin/sconadm register -a
 [-e softwareUpdate | -E softwareUpdate]
 [-h hostname] [-l logfile] [-N]
 [-p proxy_host[:proxy_port]]
 [-r registration_profile] [-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 SYNOPSIS, 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 /usr/lib/breg/data/RegistrationProfile.properties. See registration_profile(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

-e softwareUpdate -E softwareUpdate -h hostname -l logfile -N -p proxy_host[:proxy_port] -r registration_profile -u username -x proxy_username

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

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
-e softwareUpdate

Example 5 Never Registering

To never register a system, enter:

/usr/sbin/sconadm register -N

Example 6 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 7 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 \e
-p newproxy.mycompany.com

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

Example 8 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 >0 /usr/lib/breg/data/RegistrationProfile.properties

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

ATTRIBUTE TYPE ATTRIBUTE VALUE

Interface Stability Stable

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