sconadm(1m) - osol9

1sconadm(1M)             System Administration Commands             sconadm(1M)
2
3
4

NAME

6       sconadm - register system information
7

SYNOPSIS

9       /usr/sbin/sconadm register -a
10            [-e softwareUpdate | -E softwareUpdate]
11            [-h hostname] [-l logfile] [-N]
12            [-p proxy_host[:proxy_port]]
13            [-r registration_profile] [-u username]
14            [-x proxy_username]
15
16
17       /usr/sbin/sconadm proxy [-l logfile]
18            [-p proxy_host[:proxy_port]]
19            [-r registration_profile] [-x proxy_username]
20
21

DESCRIPTION

23       The sconadm utility is a command-line version of the Basic Registration
24       GUI. In the first form of the command in the SYNOPSIS, sconadm uses the
25       register  subcommand  to register a host with a registration server. In
26       the second form, sconadm uses the proxy subcommand to configure all  of
27       the components for software update to use an HTTP web proxy.
28
29
30       The  parameters  specified with -u, -e (or -E), -h, -p, and -x override
31       values specified in your registration profile. A template for this pro‐
32       file,   owned  by  root,  with  read-only  permissions,  is  stored  in
33       /usr/lib/breg/data/RegistrationProfile.properties.    See     registra‐
34       tion_profile(4).
35
36
37       For the proxy subcommand, the proxy password is stored in the Registra‐
38       tionProfile.properties  file,  available  if  proxy  authentication  is
39       needed.  Storage  in  the  profile  prevents proxy passwords from being
40       exposed as part of a listing of processes on a system.
41

OPTIONS

43       The following options are supported:
44
45       -a                            Accept "Terms  of  Use  and  Binary  Code
46                                     License".  Absence  of  this option means
47                                     that you do not accept the license.
48
49
50       -e softwareUpdate             Enable client to be managed at  the  Sun-
51                                     hosted Update Connection Service.
52
53
54       -E softwareUpdate             Disable client's ability to be managed at
55                                     the Sun-hosted Update Connection Service.
56
57
58       -h hostname                   Hostname of the machine you want to  reg‐
59                                     ister.
60
61
62       -l logfile                    Pathname of log file.
63
64
65       -N                            Never register.
66
67
68       -p proxy_host[:proxy_port]    Proxy  host  name and optional proxy port
69                                     number.
70
71
72       -r registration_profile       Pathname to a registration profile.
73
74
75       -u username                   User name (a Sun Online Account).
76
77
78       -x proxy_username             User name on the proxy host.
79
80

EXAMPLES

82       Unless specified otherwise, the commands below require root  privileges
83       or privileges equivalent to root. See privileges(5).
84
85       Example 1 Registering a New System
86
87
88       Assume  a file registrationprofile.properties in /tmp that contains the
89       following:
90
91
92         userName=user123
93         password=abc123
94         hostName=
95         subscriptionKey=
96         portalEnabled=false
97         proxyHostName=
98         proxyPort=
99         proxyUserName=
100         proxyPassword=
101
102
103
104       To register a new system using the profile above, you enter:
105
106
107         /usr/sbin/sconadm register -a -r /tmp/registrationprofile.properties
108
109
110
111       Example 2 Reregistering a System with a Different User
112
113
114       Assume a file registrationprofile.properties in /tmp with the  contents
115       shown below. Note the changed specification for userName and password.
116
117
118         userName=newuser
119         password=newpassword
120         hostName=
121         subscriptionKey=
122         portalEnabled=false
123         proxyHostName=
124         proxyPort=
125         proxyUserName=
126         proxyPassword=
127
128
129
130       To  reregister a new system using the profile above, you enter the same
131       command you entered to register the system:
132
133
134         /usr/sbin/sconadm register -a -r /tmp/registrationprofile.properties
135
136
137
138       Example 3 Reregistering a System, Adding a Sun Subscription Key
139
140
141       Modify registrationprofile.properties as follows:
142
143
144         userName=newuser
145         password=newpassword
146         hostName=
147         subscriptionKey=abc12345678
148         portalEnabled=false
149         proxyHostName=
150         proxyPort=
151         proxyUserName=
152         proxyPassword=
153
154
155
156       Run the command:
157
158
159         /usr/sbin/sconadm register -a -r /tmp/registrationprofile.properties
160
161
162
163       Example 4 Reregistering and Enabling Access to  all  Update  Connection
164       Services
165
166
167       Modify registrationprofile.properties as follows:
168
169
170         userName=newuser
171         password=newpassword
172         hostName=
173         subscriptionKey=abc12345678
174         portalEnabled=false
175         proxyHostName=
176         proxyPort=
177         proxyUserName=
178         proxyPassword=
179
180
181
182       Note that portalEnabled is set to false. Run the command:
183
184
185         /usr/sbin/sconadm register -a -r /tmp/registrationprofile.properties \
186         -e softwareUpdate
187
188
189
190       Example 5 Never Registering
191
192
193       To never register a system, enter:
194
195
196         /usr/sbin/sconadm register -N
197
198
199
200       Example 6 Using a Proxy Server With Proxy Authentication
201
202
203       Edit registrationprofile.properties as follows:
204
205
206         userName=
207         password=
208         hostName=
209         subscriptionKey=
210         portalEnabled=
211         proxyHostName=webcache.mycompany.com
212         proxyPort=8080
213         proxyUserName=myCompanyProxyUserName
214         proxyPassword=myCompanyProxyPassword
215
216
217
218       Run the command:
219
220
221         /usr/sbin/sconadm proxy -r /tmp/registrationprofile.properties
222
223
224
225       Example 7 Changing Proxy Host Settings
226
227
228       Edit registrationprofile.properties as follows:
229
230
231         userName=
232         password=
233         hostName=
234         subscriptionKey=
235         portalEnabled=
236         proxyHostName=webcache.mycompany.com
237         proxyPort=8080
238         proxyUserName=myCompanyProxyUserName
239         proxyPassword=myCompanyProxyPassword
240
241
242
243       Run the command:
244
245
246         /usr/sbin/sconadm proxy -r /tmp/registrationprofile.properties
247
248
249
250
251       Then, change the proxyHostName value by running the following command:
252
253
254         /usr/sbin/sconadm proxy -r /tmp/registrationprofile.properties \
255         -p newproxy.mycompany.com
256
257
258
259
260       After the preceding command all proxies use newproxy.mycompany.com.
261
262
263       Example 8 Resetting a System Not to Use a Proxy
264
265
266       Edit registrationprofile.properties as follows:
267
268
269         userName=
270         password=
271         hostName=
272         subscriptionKey=
273         portalEnabled=
274         proxyHostName=
275         proxyPort=
276         proxyUserName=
277         proxyPassword=
278
279
280
281       Note that values for all proxy fields are null.
282
283
284
285       Run the command:
286
287
288         /usr/sbin/sconadm proxy -r /tmp/registrationprofile.properties
289
290
291

EXIT STATUS

293       0     Success.
294
295
296       >0    An error occurred.
297
298

FILES

300       /usr/lib/breg/data/RegistrationProfile.properties
301
302           Registration profile template.
303
304

ATTRIBUTES

306       See attributes(5) for descriptions of the following attributes:
307
308
309
310
311       ┌─────────────────────────────┬─────────────────────────────┐
312       │      ATTRIBUTE TYPE         │      ATTRIBUTE VALUE        │
313       ├─────────────────────────────┼─────────────────────────────┤
314       │Availability                 │SUNWbrg                      │
315       ├─────────────────────────────┼─────────────────────────────┤
316       │Interface Stability          │Stable                       │
317       └─────────────────────────────┴─────────────────────────────┘
318