regadm(1M) System Administration Commands regadm(1M)NAMEregadm - Solaris system registration utility
SYNOPSISregadm auth [-u username] [-p password_file]
regadm register [-q] [-d]
regadm list
regadm clear
regadm set [-n name] [-v value]
regadm status
regadm disable
regadm enable
DESCRIPTION
The regadm utility is used by a privileged system administrator to reg‐
ister products on a given Solaris system with My Oracle Support (MOS),
and to manage the background auto-registration service that runs at
system boot time. Registered products are extracted from the Service
Tag Registry (see stclient(1M)) and uploaded to MOS by means of a
secure HTTPS connection.
You can use regadm to explicitly register products. In addition, an
smf(5) service runs at boot time that attempts to refresh the registra‐
tion if the product installation base has changed. This service can be
administratively enabled or disabled by means of subcommands of regadm.
By default, the service is enabled.
OPTIONS
The following options are supported:
-d
Dry-run mode. Show the registration information that will be trans‐
mitted to MOS but do not perform the actual registration. Output is
displayed in XML format.
-p password_file
Used with the authentication subcommand, the -p option specifies a
file name containing the password associated with the MOS username
(the -u option). This should be a single-line file and it can be
immediately removed after running this command.
-q
Quiet mode. Do not show any output during a registration.
-u username
Used with the authentication subcommand, the -u option specifies
the MOS user name to be associated with registrations of products
on a given system.
SUB-COMMANDS
The subcommands for regadm are as follows:
auth
Each system must be authenticated with valid MOS credentials before
its products can be registered. A successful authentication is made
persistent and thus only needs to be done once.
clear
Remove all configured authentication and HTTPS connectivity infor‐
mation. This effectively configures an anonymous registration with
no HTTP proxy information.
disable
Disable the auto-registration service at system boot time.
enable
Enable the auto-registration service at system boot time.
list
Displays the current authenticated MOS user name and the network
connectivity information needed for HTTPS communication with MOS.
If no authentication has yet been done (by means of the auth com‐
mand), the anonymous account will be displayed.
register
Registers each product from the Solaris Service Tag registry (see
stclient(1M)) with MOS, using the current authentication creden‐
tials. If no credentials have been supplied, the registration is
performed using an anonymous MOS account.
set
Configure HTTP proxy information, to be used for HTTPS communica‐
tion with the MOS backend.
status
Report the status (enabled/disabled) of the Solaris auto-registra‐
tion smf(5) service. See the disable and enable subcommands.
EXAMPLES
Example 1 Authenticating with MOS Interactively
The following command is used to interactively authenticate this system
with MOS. You will be prompted for your support username and password.
# regadm auth
Example 2 Authenticating Non-Interactively
This is similar to the interactive example, but specifies the MOS user‐
name and password on the command line.
# regadm auth -u "pat.smith@example.com" -p mypassword
The file mypassword must contain the MOS password.
Example 3 Setting HTTP Proxy Information
The following command sequence configures an HTTP proxy and port, used
for HTTPS communication with the MOS.
# regadm set -n http_proxy -v webcache.example.com
# regadm set -n http_proxy_port -v 8080
Example 4 Setting HTTP Proxy Authentication Information
Some HTTP proxies require authentication. This example shows the con‐
figuring of a username/password for basic RFC 2617 HTTP authentication.
Note that a filename containing the password (mypassword) is specified,
not the actual password itself.
# regadm set -n http_proxy_user -v webuser
# regadm set -n http_proxy_user_pw -v mypassword
ATTRIBUTES
See attributes(5) for descriptions of the following attributes:
┌─────────────────────────────┬─────────────────────────────┐
│ ATTRIBUTE TYPE │ ATTRIBUTE VALUE │
├─────────────────────────────┼─────────────────────────────┤
│Availability │SUNWautoregu │
├─────────────────────────────┼─────────────────────────────┤
│Interface Stability │Committed │
└─────────────────────────────┴─────────────────────────────┘
SEE ALSOstclient(1M), attributes(5), smf(5)SunOS 5.10 11 Jun 2010 regadm(1M)
