Registering Your Solaris Software With the CLI

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:

How to Create a RegistrationProfile File

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

  2. Go to the /usr/lib/breg/data/ directory.

  3. Copy the RegistrationProfile file and save it in your /tmp directory.

    /tmp/RegistrationProfile

  4. Open the /tmp/RegistrationProfile file in a text editor.

  5. Complete the RegistrationProfile properties, as needed, to meet your requirements.

    The following properties are in the RegistrationProfile file:

    userName

    Sun Online Account user name. Systems registered with this profile are identified with this Sun Online Account.

    password

    Sun Online Account password.

    hostName

    Portal host name (Portal Common Name).

    subscriptionKey

    (Optional) Sun support contract ID. A valid subscription key or service plan number is required to enable access to all Sun Update Connection services.

    portalEnabled

    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.

    proxyHostName

    (Optional) Proxy host name, if your system is connected to a network proxy.

    proxyPort

    (Optional) Proxy port number of the network proxy, if your system connects to the Internet through a network proxy.

    proxyUserName

    (Optional) Network proxy user name. Network proxy user name. The user name is only needed if your network proxy requires authentication.

    proxyPassword

    (Optional) Network proxy password. The proxy password is only needed if your network proxy requires authentication.

    Note

    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.

  6. Save your changes.

Example 18.1.  RegistrationProfile.properties File

The following is an example of a completed RegistrationProfile.properties file:

userName= soa-username1

password= SOA-password1

hostName= evita

subscriptionKey= abc12345678

portalEnabled= false

proxyHostName= webcache.mycompany.com

proxyPort= 8080

proxyUserName= user123

proxyPassword= abc123

Solaris Software CLI Registration Subcommand Options

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.

Note

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

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

  2. Create a registrationprofile.properties file in the /tmp directory.

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

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

  2. Create a new registration profile in the /tmp directory.

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

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

  2. Open the /tmp/registrationprofile.properties file in a text editor.

  3. Type your subscription key or service plan number in the subscriptionKey property and save your changes.

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

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

  2. Open the /tmp/registrationprofile.properties file.

  3. Change the portalEnabled property to true.

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

Note

Fail-safe mode is not available after the Solaris Express 10/05 release.

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

  2. Create a registrationprofile.properties file in the /tmp directory.

  3. Run the following command in fail-safe mode:

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