To register by using the CLI, you need to create a registration profile. Use the profile to register your systems. Information about using the CLI is also available in the following Solaris man pages:
sconadm ( 1M )
registration_profile ( 4 )
attributes ( 5 )
privileges ( 5 )
How to Create a RegistrationProfile
File
Become superuser or assume an equivalent role.
Roles contain authorizations and privileged commands. For more information about roles, see Configuring RBAC (Task Map) in System Administration Guide: Security Services .
Go to the /usr/lib/breg/data/
directory.
Copy the RegistrationProfile
file and save
it in your /tmp
directory.
/tmp/RegistrationProfile
Open the /tmp/RegistrationProfile
file in
a text editor.
Complete the RegistrationProfile
properties,
as needed, to meet your requirements.
The following properties
are in the RegistrationProfile
file:
Sun Online Account user name. Systems registered with this profile are identified with this Sun Online Account.
Sun Online Account password.
Portal host name (Portal Common Name).
(Optional) Sun support contract ID. A valid subscription key or service plan number is required to enable access to all Sun Update Connection services.
Determines if the local client is managed using the Sun hosted
Update Connection service. True
enables the Sun Update Connection
service. False
disables the Sun Update Connection.
(Optional) Proxy host name, if your system is connected to a network proxy.
(Optional) Proxy port number of the network proxy, if your system connects to the Internet through a network proxy.
(Optional) Network proxy user name. Network proxy user name. The user name is only needed if your network proxy requires authentication.
(Optional) Network proxy password. The proxy password is only needed if your network proxy requires authentication.
If your network proxy requires authentication, 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 system users.
Save your changes.
Example 18.1.
RegistrationProfile.properties
File
The following is an example of a completed RegistrationProfile.properties
file:
userName=
|
password=
|
hostName=
|
subscriptionKey=
|
portalEnabled=
|
proxyHostName=
|
proxyPort=
|
proxyUserName=
|
proxyPassword=
|
The Solaris software CLI registration uses the following command-line options:
a
Accepts the Terms of Use and the Binary Code License. If you
do not use the
a
option, you do not accept the Terms of Use
and the Binary Code License
and the registration fails.
e
Enables software updates with the Sun Update Connection services.
E
Disables software updates with the Update Connection services.
h
portal-name
Specifies the portal host name (Portal Common Name) of the system to be registered. If a name is not provided, the default is the UNIX host name.
l
logfile
Specifies the location of the log file.
N
Removes the registration options from your system.
p
proxy-host:[proxy port]
Specifies the proxy host name and optional proxy port number of your network proxy, if your system connects to the Internet thorough a network proxy.
r
registration-profile
Specifies the full path, or relative path, to the registration profile.
s
Operates the registration in fail-safe mode. For normal operation,
do not use the
s
option. If you are running at least the Express 3/06 software, the fail-safe mode is not
available.
u
Specifies the Sun Online Account user name.
x
Specifies your network proxy user name. The user name is only needed if you use a network proxy, and the proxy requires authentication.
The
u
,
h
,
e
,
E
,
p
,
x
options override the values that are specified
in the registration profile. If a property is not specified in the profile
or on the command line, it is not used.
To successfully register your Solaris software with the CLI, you
must always use the
a
option to accept the Terms of Use and
the Binary Code License.
Example 18.2. CLI Command to Register Your Solaris Software Using Your Default Options
To register a system using the properties defined in your /tmp/registrationprofile.properties
file, type the following command:
# /usr/sbin/sconadm register -a -r /tmp/registrationprofile.properties
Example 18.3. CLI Command to Register Your Solaris Software Using a Registration Subcommand Option to Override a Default Option
To register your Solaris software with a username that is not defined
in your /tmp/registrationprofile.properties
file, type
the following command:
# /usr/sbin/sconadm register -a -r /tmp
/registrationprofile.properties -u username
Example 18.4. CLI Command to Register Your Solaris Software Using a Network Proxy Subcommand Option to Override a Default Option
If you define the proxyHostName property in the
registration profile as webcache.mycompany.com
, run the
following command to change the proxyHostName to newcache.mycompany.com:
# /usr/sbin/sconadm proxy -a -r /tmp
/registrationprofile.properties -p newcache.mycompany.com
All proxy settings will use the
p
value of newcache.mycompany.com
.
How to Register Your Solaris Software With the CLI
Become superuser or assume an equivalent role.
Roles contain authorizations and privileged commands. For more information about roles, see Configuring RBAC (Task Map) in System Administration Guide: Security Services .
Create a registrationprofile.properties
file in the /tmp
directory.
Run the following command to register your Solaris software:
# /usr/sbin/sconadm register -a -r /tmp/registrationprofile.properties
How to Reregister Your Solaris Software With a Different User
The software registration is associated with the Sun Online Account used during registration. You can create a new registration profile with a new user and reregister the Solaris software to associate it with a new Sun Online Account. You might want to reregister if a user has moved to a different department or left the company.
Become superuser or assume an equivalent role.
Roles contain authorizations and privileged commands. For more information about roles, see Configuring RBAC (Task Map) in System Administration Guide: Security Services .
Create a new registration
profile in the /tmp
directory.
To reregister your Solaris software, run the following command:
# /usr/sbin/sconadm register -a -r /tmp/registrationprofile.properties
How to Reregister Your Solaris Software and Add a Subscription Key or Service Plan Number
You can add a subscription key (also called a service plan number) to an existing registration profile.
Become superuser or assume an equivalent role.
Roles contain authorizations and privileged commands. For more information about roles, see Configuring RBAC (Task Map) in System Administration Guide: Security Services .
Open the /tmp/registrationprofile.properties
file
in a text editor.
Type your subscription key or service plan number in the subscriptionKey property and save your changes.
Type the following command to register your Solaris software with the subscription key or service plan number:
# /usr/sbin/sconadm register -a -r /tmp/registrationprofile.properties
How to Reregister Your Solaris Software to Enable Access to All of the Update Connection Services
Become superuser or assume an equivalent role.
Roles contain authorizations and privileged commands. For more information about roles, see Configuring RBAC (Task Map) in System Administration Guide: Security Services .
Open the /tmp/registrationprofile.properties
file.
Change the portalEnabled property to true.
Run the following command to access all Update Connection services:
# /usr/sbin/sconadm register -a -r /tmp
/registrationprofile.properties -e softwareUpdate
How to Register Your Solaris Software in Fail-Safe Mode
If the software registration did not collect all system information, use this option to register the software in fail-safe mode.
Fail-safe mode is not available after the Solaris Express 10/05 release.
Become superuser or assume an equivalent role.
Roles contain authorizations and privileged commands. For more information about roles, see Configuring RBAC (Task Map) in System Administration Guide: Security Services .
Create a registrationprofile.properties
file
in the /tmp
directory.
Run the following command in fail-safe mode:
# /usr/sbin/sconadm register -a -r /tmp/registrationprofile.properties -s