Sun[TM] Update Connection 1.0, System Edition Registration Guide for the Command-Line Interface |
DescriptionThis document includes a description of the sconadm command, which you can use to register your system with the Sun[TM] Update Manager.
Steps to FollowBefore you can use Sun[TM] Update Manager application or use the Sun Update Connection services to manage updates on your system, you must register your system with the Sun Update Manager registration wizard or the command-line interface (CLI).
See the Sun Update Manager 1.0 Administration Guide for
more details about Sun Update Manager.
The CLI program contains a registration profile with optional
parameters. If a parameter is provided, it overrides the value in
the registration profile.
Requirements
To successfully register a system, you must have superuser
access to the system, have a valid Sun Online Account user name and
password, and optionally have a Sun subscription key.
To enable access to all the Sun Update Connection services, you
must provide a valid subscription key. You can add a key after you
register a system.
Note:
You must accept the Terms
of Use and Binary Code License to complete the registration.
See the Terms of Use and the Binary Code License.
A registration profile file contains the following
properties:
userName=
password=
hostName=
subscriptionKey=
portalEnabled=false
proxyHostName=
proxyPort=
proxyUserName=
proxyPassword=
For example:
userName=user123
password=test123
hostName=evita
subscriptionKey=abc12345678
portalEnabled=false
proxyHostName=webcache.mycompany.com
proxyPort=8080
proxyUserName=user123
proxyPassword=abc123
The registration profile template,
/usr/lib/breg/data/RegistrationProfile.properties, is owned by root
with 400 file permissions. If you cannot find the registration
profile template in the /usr/lib/breg/data directory, look in the
/var/SUNWbreg/data directory.
The register
Subcommand
The synopsis of the sconadm register command is as follows:
# /usr/sbin/sconadm register [ -a ] [ -r <reg-profile> ] [ -u <user-name> ] [ -h <host-name> ] [ -e softwareUpdate ] [ -p <proxy-host>[:proxy-port] ] [ -x <proxy-user-name> ] [ -l <log-file> ] [ -s ] [ -N ]
The register subcommand uses the following command-line
options:
When you specify any of the -u, -h, -e, -E, -p, and -x
options, the values specified on the command line override
the values you specified in the registration profile.
If you specify a parameter value in the profile or on the
command line, the value is set as specified. If you did not specify
a value in the profile or on the command line, the value is
unchanged.
How to Register a
New System
1. As a superuser, create a
registrationprofile.properties file in the /tmp
directory.
For example, you might create a
/tmp/registrationprofile.properties file that contains the
following:
userName=user123
password=abc123
hostName=
subscriptionKey=
portalEnabled=false
proxyHostName=
proxyPort=
proxyUserName=
proxyPassword=
2. Register a new system.
# /usr/sbin/sconadm register -a -r /tmp/registrationprofile.properties
How to
Re-Register a System with a Different User
You can re-register a system with a different user. You might
want to do this if a user has moved to a different department or
left the company.
1. As a superuser, create a new
registration profile in the /tmp directory.
For example, you might create a
/tmp/registrationprofile.properties file that contains the
following:
userName=newuser
password=newpassword
hostName=
subscriptionKey=
portalEnabled=false
proxyHostName=
proxyPort=
proxyUserName=
proxyPassword=
2. Re-register your system.
# /usr/sbin/sconadm register -a -r /tmp/registrationprofile.properties
How to
Re-Register and Add a Sun Subscription Key
You can add a Sun subscription key to an existing registration
profile.
1. As the superuser, open the
/tmp/registrationprofile.properties file.
2. Add the subscription
key.
For example:
userName=newuser
password=newpassword
hostName=
subscriptionKey=abc12345678
portalEnabled=false
proxyHostName=
proxyPort=
proxyUserName=
proxyPassword=
3. Re-register your system to add the
subscription key.
# /usr/sbin/sconadm register -a -r /tmp/registrationprofile.properties
How to
Re-Register to Enable Access to all the Update Connection
Services
1. As the superuser, open the
/tmp/registrationprofile.properties file.
2. Change the portalEnabled parameter
value to false.
For example:
userName=newuser
password=newpassword
hostName=
subscriptionKey=abc12345678
portalEnabled=false
proxyHostName=
proxyPort=
proxyUserName=
proxyPassword=
3. Re-register your system to enable
access to all of the Sun Update Connection services.
# /usr/sbin/sconadm register -a -r /tmp/registrationprofile.properties -e softwareUpdate
Note:
Go to the Sun Update
Connection web application at http://updates.sun.com.
How to Register
in Failsafe Mode
You can register a system in failsafe mode. Use this option if
it was not able to collect all system information, then it would
need to run it in failsafe mode in order to get assetid back.
1. As a superuser, create a
registrationprofile.properties file in the /tmp
directory.
For example:
userName=user123
password=test123
hostName=
subscriptionKey=
portalEnabled=false
proxyHostName=
proxyPort=
proxyUserName=
proxyPassword=
2. Register your system in failsafe
mode.
# /usr/sbin/sconadm register -a -s -r /tmp/registrationprofile.properties
How to State That
You Never Want to Register Your System
The -N option sets a flag so that Sun Update Connection service
will not prompt you for registration. However, the system can
still be registered later after this flag is set
1. Declare that you never want to register
your system.
# /usr/sbin/sconadm register -N
The proxy
Subcommand
The proxy subcommand is used to configure all of the components
for software
update to use a network proxy. The synopsis of the sconadm proxy
command is as follows:
# /usr/sbin/sconadm proxy [ -r <reg-profile> ] [ -p <proxy-host>[:proxy-port] ] [ -x <proxy-user-name> ] [ -l <log-file> ]
The proxy subcommand uses the following command-line
options:
If your network proxy needs authentication, you must store the
network proxy password in a registrationprofile.properties file. By
storing the password in a file, you prevent the proxy
password from becoming exposed as part of a process listing by
other users on the system.
Parameter values that you provide on
the command line override the values that you specified in the
registration profile. For example, you set the proxyHostName
parameter in the profile to webcache.mycompany.com. Then, you run
the following command:
# /usr/sbin/sconadm proxy -r /tmp/registrationprofile.properties -p newcache.mycompany.com
After running the previous command, all proxy settings will use
the -p value of newcache.mycompany.com that you specified on the
command line.
How to Configure
the System to Use a Proxy Server With Proxy
Authentication
1. As a superuser, add the proxy
authentication information to the registrationprofile.properties
file in the /tmp directory.
For example:
userName=
password=
hostName=
subscriptionKey=
portalEnabled=
proxyHostName=webcache.mycompany.com
proxyPort=8080
proxyUserName=myCompanyProxyUserName
proxyPassword=myCompanyProxyPassword
2. Register the system to use a network
proxy.
# /usr/sbin/sconadm proxy -r /tmp/registrationprofile.properties
How to Change
Proxy Host Settings
1. As a superuser, create a
registrationprofile.properties file in the /tmp
directory.
For example, you might create a
/tmp/registrationprofile.properties file that contains the
following:
userName=
password=
hostName=
subscriptionKey=
portalEnabled=
proxyHostName=webcache.mycompany.com
proxyPort=8080
proxyUserName=myCompanyProxyUserName
proxyPassword=myCompanyProxyPassword
2. Configure the proxy by running the
following command:
# /usr/sbin/sconadm proxy -r /tmp/registrationprofile.properties
3. Change the proxyHostName value by
running the following command:
# /usr/sbin/sconadm proxy -r /tmp/registrationprofile.properties -p newproxy.mycompany.com
This reconfigures all proxies to use newproxy.mycompany.com
How to Reset a
System to Not Use a Proxy
1. As a superuser, edit the registration
profile in the /tmp directory and delete all information from the
proxy fields.
For example, you might create a
/tmp/registrationprofile.properties file that contains the
following:
userName=
password=
hostName=
subscriptionKey=
portalEnabled=
proxyHostName=
proxyPort=
proxyUserName=
proxyPassword=
2. Configure the proxy by running the
following command:
# /usr/sbin/sconadm proxy -r /tmp/registrationprofile.properties
Note:
The default proxy values
cannot be overridden by removing the
proxyHostName, proxyPort, proxyUserName, and proxyPassword
parameters from the registration profile.
ProductSun Update Connection - System
AttachmentsThis solution has no attachment
Sun Contracted Content
Sun Contracted Feature
