1sconadm(1M) System Administration Commands sconadm(1M)
2
3
4
6 sconadm - register system information
7
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
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
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
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
293 0 Success.
294
295
296 >0 An error occurred.
297
298
300 /usr/lib/breg/data/RegistrationProfile.properties
301
302 Registration profile template.
303
304
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
320 registration_profile(4), attributes(5), privileges(5)
321
322
323
324SunOS 5.11 27 Feb 2006 sconadm(1M)