JavaScript is required to for searching.
Skip Navigation Links
Exit Print View
man pages section 1M: System Administration Commands     Oracle Solaris 10 8/11 Information Library
search filter icon
search icon

Document Information

Preface

Introduction

System Administration Commands - Part 1

System Administration Commands - Part 2

metaimport(1M)

metainit(1M)

metaoffline(1M)

metaonline(1M)

metaparam(1M)

metarecover(1M)

metarename(1M)

metareplace(1M)

metaroot(1M)

metaset(1M)

metassist(1M)

metastat(1M)

metasync(1M)

metattach(1M)

mib2c(1M)

mib2mof(1M)

mibiisa(1M)

mipagent(1M)

mipagentconfig(1M)

mipagentstat(1M)

mkbootmedia(1M)

mkdevalloc(1M)

mkdevmaps(1M)

mkfifo(1M)

mkfile(1M)

mkfs(1M)

mkfs_pcfs(1M)

mkfs_udfs(1M)

mkfs_ufs(1M)

mknod(1M)

mkpwdict(1M)

modinfo(1M)

modload(1M)

modunload(1M)

mofcomp(1M)

mofreg(1M)

monacct(1M)

monitor(1M)

mount(1M)

mountall(1M)

mount_cachefs(1M)

mountd(1M)

mount_hsfs(1M)

mount_nfs(1M)

mount_pcfs(1M)

mount_tmpfs(1M)

mount_udfs(1M)

mount_ufs(1M)

mount_xmemfs(1M)

mpathadm(1M)

mpstat(1M)

msgid(1M)

mvdir(1M)

named(1M)

named-checkconf(1M)

named-checkzone(1M)

named-compilezone(1M)

ncaconfd(1M)

ncheck(1M)

ncheck_ufs(1M)

ndd(1M)

netservices(1M)

netstat(1M)

netstrategy(1M)

newaliases(1M)

newfs(1M)

newkey(1M)

nfs4cbd(1M)

nfsd(1M)

nfslogd(1M)

nfsmapid(1M)

nfsstat(1M)

nisaddcred(1M)

nisaddent(1M)

nisauthconf(1M)

nisbackup(1M)

nis_cachemgr(1M)

nisclient(1M)

nisd(1M)

nisd_resolv(1M)

nisinit(1M)

nisldapmaptest(1M)

nislog(1M)

nispasswdd(1M)

nisping(1M)

nispopulate(1M)

nisprefadm(1M)

nisrestore(1M)

nisserver(1M)

nissetup(1M)

nisshowcache(1M)

nisstat(1M)

nisupdkeys(1M)

nlsadmin(1M)

nscd(1M)

nslookup(1M)

nsupdate(1M)

ntpdate(1M)

ntpq(1M)

ntptrace(1M)

nulladm(1M)

obpsym(1M)

ocfserv(1M)

oplhpd(1M)

parse_dynamic_clustertoc(1M)

passmgmt(1M)

patchadd(1M)

patchrm(1M)

pbind(1M)

pcitool(1M)

pcmciad(1M)

pfinstall(1M)

pginfo(1M)

pgstat(1M)

pgxconfig(1M)

picld(1M)

ping(1M)

pkg2du(1M)

pkgadd(1M)

pkgadm(1M)

pkgask(1M)

pkgchk(1M)

pkgcond(1M)

pkgrm(1M)

plockstat(1M)

pmadm(1M)

pmconfig(1M)

pntadm(1M)

pooladm(1M)

poolbind(1M)

poolcfg(1M)

poold(1M)

poolstat(1M)

ports(1M)

powerd(1M)

poweroff(1M)

ppdmgr(1M)

pppd(1M)

pppoec(1M)

pppoed(1M)

pppstats(1M)

pprosetup(1M)

pprosvc(1M)

praudit(1M)

prctmp(1M)

prdaily(1M)

printmgr(1M)

privatepw(1M)

prodreg(1M)

projadd(1M)

projdel(1M)

projmod(1M)

prstat(1M)

prtacct(1M)

prtconf(1M)

prtdiag(1M)

prtdscp(1M)

prtfru(1M)

prtpicl(1M)

prtvtoc(1M)

psradm(1M)

psrinfo(1M)

psrset(1M)

putdev(1M)

putdgrp(1M)

pwck(1M)

pwconv(1M)

quot(1M)

quota(1M)

quotacheck(1M)

quotaoff(1M)

quotaon(1M)

raidctl(1M)

ramdiskadm(1M)

rarpd(1M)

rcapadm(1M)

rcapd(1M)

rctladm(1M)

rdate(1M)

rdisc(1M)

reboot(1M)

regadm(1M)

reject(1M)

rem_drv(1M)

remove_allocatable(1M)

removef(1M)

repquota(1M)

re-preinstall(1M)

restricted_shell(1M)

rexd(1M)

rexecd(1M)

rlogind(1M)

rm_install_client(1M)

rmmount(1M)

rmt(1M)

rndc(1M)

rndc-confgen(1M)

roleadd(1M)

roledel(1M)

rolemod(1M)

root_archive(1M)

route(1M)

routeadm(1M)

routed(1M)

rpcbind(1M)

rpc.bootparamd(1M)

rpcinfo(1M)

rpc.mdcommd(1M)

rpc.metad(1M)

rpc.metamedd(1M)

rpc.metamhd(1M)

rpc.nisd(1M)

rpc.nisd_resolv(1M)

rpc.nispasswdd(1M)

rpc.rexd(1M)

rpc.rstatd(1M)

rpc.rusersd(1M)

rpc.rwalld(1M)

rpc.smserverd(1M)

rpc.sprayd(1M)

rpc.yppasswdd(1M)

rpc.ypupdated(1M)

rpld(1M)

rquotad(1M)

rsh(1M)

rshd(1M)

rstatd(1M)

rtc(1M)

rtquery(1M)

runacct(1M)

rusersd(1M)

rwall(1M)

rwalld(1M)

rwhod(1M)

sa1(1M)

sa2(1M)

sac(1M)

sacadm(1M)

sadc(1M)

saf(1M)

sar(1M)

savecore(1M)

scadm(1M)

sckmd(1M)

sconadm(1M)

sdpadm(1M)

sendmail(1M)

setuname(1M)

setup_install_server(1M)

sf880drd(1M)

sftp-server(1M)

share(1M)

shareall(1M)

share_nfs(1M)

showmount(1M)

showrev(1M)

shutacct(1M)

shutdown(1M)

slpd(1M)

smartcard(1M)

smattrpop(1M)

smbios(1M)

smc(1M)

smccompile(1M)

smcconf(1M)

smcregister(1M)

smcron(1M)

smcwebserver(1M)

smdiskless(1M)

smexec(1M)

smgroup(1M)

smlog(1M)

smmaillist(1M)

smmultiuser(1M)

smosservice(1M)

smpatch(1M)

smprofile(1M)

smreg(1M)

smrole(1M)

smrsh(1M)

smserialport(1M)

smtnrhdb(1M)

smtnrhtp(1M)

smtnzonecfg(1M)

smuser(1M)

snmpbulkget(1M)

snmpbulkwalk(1M)

snmpcmd(1M)

snmpconf(1M)

snmpd(1M)

snmpdelta(1M)

snmpdf(1M)

snmpdx(1M)

snmpget(1M)

snmpgetnext(1M)

snmpinform(1M)

snmpnetstat(1M)

snmpset(1M)

snmptable(1m)

snmptest(1M)

snmptranslate(1m)

snmptrap(1M)

snmptrapd(1M)

snmpusm(1M)

snmpvacm(1M)

snmpwalk(1M)

snmpXdmid(1M)

snmpXwbemd(1M)

snoop(1M)

soconfig(1M)

soladdapp(1M)

soldelapp(1M)

solstice(1M)

sppptun(1M)

spray(1M)

sprayd(1M)

sshd(1M)

ssh-keysign(1M)

startup(1M)

statd(1M)

stclient(1M)

stmsboot(1M)

strace(1M)

strclean(1M)

strerr(1M)

sttydefs(1M)

su(1M)

sulogin(1M)

suninstall(1M)

SUNWafb_config(1M)

SUNWffb_config(1M)

SUNWgfb_config(1M)

SUNWifb_config(1M)

SUNWjfb_config(1M)

SUNWkfb_config(1M)

SUNWm64_config(1M)

SUNWnfb_config(1M)

SUNWpfb_config(1M)

SUNWzulu_config(1M)

svcadm(1M)

svccfg(1M)

svc.configd(1M)

svc.startd(1M)

swap(1M)

sync(1M)

syncinit(1M)

syncloop(1M)

syncstat(1M)

sysdef(1M)

syseventadm(1M)

syseventconfd(1M)

syseventd(1M)

sysidconfig(1M)

sysidkbd(1M)

sysidnet(1M)

sysidnfs4(1M)

sysidns(1M)

sysidpm(1M)

sysidroot(1M)

sysidsys(1M)

sysidtool(1M)

syslogd(1M)

sys-unconfig(1M)

talkd(1M)

tapes(1M)

taskstat(1M)

tcxconfig(1M)

telinit(1M)

telnetd(1M)

tftpd(1M)

System Administration Commands - Part 3

smpatch

- download, apply, and remove updates

Synopsis

/usr/sbin/smpatch add -i update-id [auth-opts] 
     [-i update-id] … [-d update-dir] [-b BE_name]
     [-n system-name] … [-x mlist=system-list-file] [-V]
/usr/sbin/smpatch add -x idlist=update-list-file 
     [auth-opts] 
     [-d update-dir] [-n system-name] … 
     [-b BE_name] [-x mlist=system-list-file] [-V]
/usr/sbin/smpatch analyze [auth-opts] [-i update-id] … 
     [-n system-name] … 
     [-x idlist=update-list-file] [-V]
/usr/sbin/smpatch download [auth-opts] [-i update-id] … 
     [-d update-dir] [-f] [-n system-name] … 
     [-t] [-x idlist=update-list-file] [-V]
/usr/sbin/smpatch get [auth-opts] [-n system-name] … 
     [parameter-name]... [-V]
/usr/sbin/smpatch messages [-a] [-V]
/usr/sbin/smpatch order -i update-id [auth-opts] 
     [-i update-id] … [-d update-dir] 
     [-n system-name] … [-V]
/usr/sbin/smpatch order -x idlist=update-list-file 
     [auth-opts] 
     [-d update-dir] [-n system-name] … [-V]
/usr/sbin/smpatch remove -i update-id [auth-opts] 
     [-n system-name] … [-b BE_name] [-V]
/usr/sbin/smpatch set [auth-opts] [-n system-name] …
     parameter-name=parameter-value... [-V]
/usr/sbin/smpatch unset [auth-opts] [-n system-name] … 
     parameter-name... [-V]
/usr/sbin/smpatch update [auth-opts] [-i update-id] … 
     [-d update-dir] [-n system-name] … [-b BE_name]
     [-x idlist=update-list-file] [-V]

Description

The smpatch command manages the update process on a single system or on multiple systems. Use this command to download, apply, and remove updates. Also, use the smpatch command to configure the update management environment for your system.

If you want to run the smpatch command in remote mode, your system must run at least the Developer Solaris Software Group of the Solaris 10 system.

The smpatch analyze command determines the updates that are appropriate for the systems you want to update. The smpatch command can download and apply updates that you specify on the command line. Or, smpatch can download and apply updates based on an analysis of one or more systems. Use the -i option or the -x idlist= option to specify the particular updates.

All of the systems on which you want to apply updates must be running the same version of the Solaris Operating System, have the same hardware architecture, and have the same updates applied.

The list of updates that is generated by the analysis is based on all of the available updates from the Sun update server. No explicit information about your host system or its network configuration is transmitted to Sun. Only a request for the Sun update set is transmitted. The update set is scanned for updates that are appropriate for this host system, the results are displayed, and those updates are optionally downloaded.

smpatch supports the Live Upgrade feature of the Solaris operating system (see live_upgrade(5)). Through the add, remove, and update subcommands, described below, smpatch enables you to perform operations on a boot environment (BE). A BE is an operating system image, consisting of a particular set of operating system and application software packages.

The smpatch command supports the following subcommands:

add

Applies one or more updates to one or more systems. You must specify at least one update to apply. By default, updates are applied to the local system.

This subcommand attempts to apply only the updates you specify. If you specify an update that depends on another that has not been applied, the add command fails to apply the update you specified.

This subcommand does not apply updates based on the specified update policy. To apply updates based on the update policy, use the update subcommand.

Use the -i or -x idlist= option to specify the updates to apply. Note that all of the updates you specify, and those on which they depend, must exist in the download directory.

Use the -n or the -x mlist= option to specify the systems on which to apply updates.

Optionally use the -d option to specify an alternate download directory.

If the updates on which the specified updates depend are unavailable, run the smpatch download subcommand to obtain the updates you need.

When you use the -b BE_name option, the add subcommand applies a specified update to the BE BE_name, rather than to the currently running operating system. Upon successful installation of the update, smpatch activates BE_name (see luactivate(1M)) and informs you that you can, at that point, boot from BE_name.

analyze

Analyzes a system to generate a list of the appropriate updates.

After analyzing the system, use the update subcommand or the download and add subcommands to download and apply the updates to your systems.

The list of updates is written to standard output, so you can redirect standard output to a file to create an update list.

If you supply a list of one or more updates, the list is augmented with the updates on which those updates depend. The list is also put in an order suitable for applying updates.

The smpatch analyze command depends on network services that are not available while the system is in single-user mode.

download

Downloads updates from the Sun update server to a system. You can optionally specify which updates to download. You can also specify the name of a system and download the appropriate updates to that system.

Use the -i or -x idlist= option to specify the updates to download.

Use the -f option to force the download of the exact update revision specified by -i update-id. If -i update-id does not specify a revision, the highest revision of the update is downloaded.

Use the -t option to download the README file for the update specified by -i update-id. If -i update-id does not specify a revision, the README file for the highest revision of the update is downloaded.

Use the -n option to analyze a remote system and to determine which updates to download. The updates, and those on which they depend, are downloaded from the Sun update server to the download directory of the system you specified.

The smpatch download command depends on network services that are not available while the system is in single-user mode.

get

Lists one or more of the smpatch configuration parameter values. See ``Configuring Your Update Management Environment.''

To see values for all parameters, run the smpatch get command with no arguments. The output shows an entry for all configuration parameters. Each entry appears on a line by itself. Each entry includes three fields: the parameter name, the value you have assigned it, and its default value. The fields are separated by one or more tab characters.

The following values have special meaning: - means that no value is set, "" means that the value is the null string, \- means that the value is -, and \"" means that the value is "" (two double quotes).

In addition to these special values, these special characters might appear in the output: \t for a tab, \n for a newline, and \\ for a backslash.

To see values for particular parameters, run the smpatch get command with one or more parameter names. The output lists one parameter value per line in the order in which the parameter names are specified on the command line.

messages

Displays messages from the message–of–the–day (MOTD) file. This file stores messages, some of which can be urgent, from Sun. By default, when there is a new message in this file, the message shown below is displayed in stderr:

You have new messages. To retrieve: smpatch messages [-a]

The preceding message appears at the top of any smpatch analyze/download/update reports. The -a option to the messages subcommand displays all messages. Without the -a option, only new (that is, as yet unread) messages are displayed.

The receiving of messages from the software update client is controlled by the property:

patchpro.report.motd.messages

When this property is enabled, the default condition, the client receives messages from Sun. To disable this property, enter:

# smpatch set patchpro.report.motd.messages=false
order

Sorts a list of updates into an order that can be used to apply updates.

The list of updates is written to standard output, so you can redirect standard output to a file to create an update list.

Use the -i or -x idlist= option to specify the updates to order. Note that all of the updates you specify must exist in the download directory.

remove

Removes a single update from a single system.

Use the -i option to specify which update to remove. Do not use the -x idlist= option. Optionally, use the -n option to specify the name of a system. Do not use the -x mlist= option. By default, the update is removed from the local system.

If the update that you want to remove is required by one or more of the updates that have already been applied to the system, the update is not removed.

When you use the -b BE_name option, the remove subcommand removes a specified update from the BE BE_name, rather than from the currently running operating system.

set

Sets the values of one or more configuration parameters. Nothing is written to standard output or standard error when you set parameters, even if a parameter value you set is invalid. This command does not validate the values you set.

unset

Resets one or more configuration parameters to the default values. You must specify at least one configuration parameter.

update

Updates a single local or remote system by applying appropriate updates. This subcommand analyzes the system, then downloads the appropriate updates from the Sun update server to your system. After the availability of the updates has been confirmed, the updates are applied based on the update policy.

By default, standard updates and those that have rebootafter or reconfigafter properties are applied.

If an update does not meet the policy for applying updates, the update is not applied. Instead, the ID of the update is written to a file in the download directory. After the update ID is written to the file, smpatch continues to apply the other updates. Later, you can use patchadd to manually apply any updates listed in this file. The updates listed in the file are still in the download directory.

When you use the -b BE_name option, the update subcommand applies an update to the BE BE_name, rather than to the currently running operating system. Upon successful installation of the update, smpatch activates BE_name (see luactivate(1M)) and informs you that you can, at that point, boot from BE_name.

Installation instructions for updates that require special handling are included in the README file for each update.

The smpatch update command depends on network services that are not available while the system is in single-user mode.

Using Local Mode or Remote Mode

Starting with Solaris 9, the smpatch command is available in two modes: local mode and remote mode. Local mode can be run only on the local system and can be run by users who have the appropriate authorizations. This mode can be run while the system is in single-user mode. Remote mode can be used to perform tasks on remote systems and can be run by users or roles that have the appropriate authorizations.

By default, local mode is run. In local mode, the Solaris WBEM services are not used, and none of the authentication options or those options that refer to remote systems are available. The command in local mode runs faster than in remote mode.

If the Solaris WBEM services are running and you specify any of the remote or authentication options, the command in remote mode is used.

On Solaris 8 systems, the smpatch command only supports local mode operations.

Specifying the Source of Updates

Your system must specify the source of updates to use. By default, you obtain updates from the Sun update server. However, you can also obtain updates from an update server on your intranet or from a local collection of updates on your system.

You must specify the URL that points to the collection of updates. By default, the Sun update server is the source of updates. The URL is:

https://getupdates.sun.com/solaris/

The URL must point to an update server or to a collection of updates that is available to the local system. The value of this URL cannot be null.

Configuring Your Update Management Environment

You can use the smpatch set command to configure the update management environment for your system. Use these parameters:

patchpro.patchset

Name of the update set to use. The default name is current.

patchpro.download.directory

Path of the directory where downloaded updates are stored and from which updates are applied. The default location is /var/sadm/spool.

patchpro.backout.directory

Path of the directory where update backout data is saved. When an update is removed, the data is retrieved from this directory as well. By default, backout data is saved in the package directories.

patchpro.patch.source

URL that points to the collection of updates. The default URL is that of the Sun update server, https://getupdates.sun.com/solaris/.

patchpro.proxy.host

Host name of your web proxy. By default, no web proxy is specified, and a direct connection to the Internet is assumed.

patchpro.proxy.port

Port number used by your web proxy. By default, no web proxy is specified, and a direct connection to the Internet is assumed. The default port is 8080.

patchpro.proxy.user

Your user name used by your web proxy for authentication.

patchpro.proxy.passwd

Password used by your web proxy for authentication.

patchpro.install.types

Your policy for applying updates. The value is a list of zero or more colon-separated update properties that are permitted to be applied by an update operation (smpatch update).

This policy only affects which updates are installed on your system. The policy does not affect which updates are downloaded.

By default, updates that have the standard, rebootafter, and reconfigafter properties can be applied. See ``Setting an Update Policy.''

Setting an Update Policy

Updates are classified as being standard or nonstandard. A standard update can be applied by smpatch update. Such an update is associated with the standard update property. smpatch applies standard updates immediately. These updates require no system restart. A nonstandard update has one of the following characteristics:

Use smpatch set to specify the types of updates that smpatch can additionally apply during an update operation. Such updates might include those that require a reboot and those that must be applied while the system is in single-user mode.

This policy only affects which updates are installed on your system. The policy does not affect which updates are downloaded.

Specify the types of updates that can be applied by using the following command:

# smpatch set patchpro.install.types=update-property-list

update-property-list is a colon-separated list of one or more of the following update properties:

interactive

An update that cannot be applied by running the usual update management tools (pprosvc, smpatch, or patchadd). Before this update is applied, the user must perform special actions. Such actions might include checking the serial number of a disk drive, stopping a critical daemon, or reading the update's README file.

rebootafter

The effects of this update are not visible until after the system is rebooted.

rebootimmediate

When this update is applied, the system becomes unstable until the system is rebooted. An unstable system is one in which the behavior is unpredictable and data might be lost.

reconfigafter

The effects of this update are not visible until after a reconfiguration reboot (boot -r). See the boot(1M) man page.

reconfigimmediate

When this update is applied, the system becomes unstable until the system gets a reconfiguration reboot (boot -r). An unstable system is one in which the behavior is unpredictable and data might be lost.

singleuser

Do not apply this update while the system is in multiuser mode. You must apply this update on a quiet system with no network traffic and with extremely restricted I/O activity.

standard

This update can be applied while the system is in multiuser mode. The effects of the update are visible as soon as it is applied unless the application being updated is running while the update is applied. In this case, the effects of the update are visible after the affected application is restarted.

Options

The smpatch command supports two kinds of options: authentication options and subcommand options.

Authentication Options

The smpatch authentication options, auth-opts, apply to all of the subcommands.

If no authentication options are specified, certain defaults are assumed and the user might be prompted for additional information, such as a password for authentication purposes.

These authentication options are only available if the Solaris Management Console and the Solaris WBEM services are available on the local system. If the WBEM services are not running on the local system, smpatch performs update operations on the local system only. You can also ``force'' the use of the local-mode smpatch command by using the -L option.

The single letter options can also be specified by their equivalent option words preceded by two hyphens. For example, you can specify either -l or --rolepassword.

The following authentication options are supported:

-H | --hostname host-name:port

Specifies the host and port to which you want to connect. If you do not specify a port, the system connects to the default port, 898. If you do not specify a host (host-name:port), the Solaris Management Console connects to the local host on port 898. You might still have to choose a toolbox to load into the console. To override this behavior, use the smc -B command, or set your console preferences to load a home toolbox by default.

-L

Forces the smpatch command to use local mode, which does not rely on Solaris WBEM services. On Solaris 8 systems, this option does not do anything.

This option is mutually exclusive with the other authentication options.

-l | --rolepassword role-password

Specifies the password for role-name. If you specify role-name but do not specify role-password, you are prompted to supply role-password. Because passwords specified on the command line can be seen by any user on the system, this option is considered to be insecure.

-p | --password password

Specifies the password for user-name. If you do not specify a password, you are prompted to supply one. Because passwords specified on the command line can be seen by any user on the system, this option is considered to be insecure.

-r | --rolename role-name

Specifies a role name for authentication. If this option is not specified, no role is assumed.

-u | --username user-name

Specifies the user name for authentication. If you do not specify this option, the user identity running the console process is assumed.

Subcommand Options

The following options pertain to the smpatch subcommands:

-b BE_name

Specifies the name of BE that is to be created and updated (for the add and update subcommands), or to be removed, for the remove subcommand.

-d update-dir

Specifies an alternate download directory in which updates are downloaded and from which they are applied.

The default download directory is /var/sadm/spool.

The directory must be writable by root and be publicly readable.

update-dir uses one of the following forms:

  • For remote mode, specify host-name:/update-dir, where /update-dir is a fully qualified, shared directory.

  • For local mode, specify /update-dir, which is a fully qualified, shared directory.

This option is supported by the add, download, order, and update subcommands.

-f

Forces the download of the exact update revision specified by -i update-id. If -i update-id does not specify a revision, the highest revision of the update is downloaded.

This option is supported by the download subcommand.

-h

Displays information about the command-line options for the specified subcommand. This option is mutually exclusive with all other options.

-i update-id

Specifies the ID of an update.

You can specify more than one update ID by using the -i option for each update. You can also use the -x idlist= option to point to a list of update IDs.

When using the remove subcommand, you can specify exactly one update ID.

This option is supported by the add, analyze, download, order, remove, and update subcommands.

-n system-name

Specifies the name of the system on which to manage updates.

When using the add subcommand, you can specify more than one system by using the -n option for each system. When using the analyze, download, remove, and update subcommands, you can only specify a single system.

To specify more than one system for the smpatch add command, use the -x mlist= option. This option enables you to specify a list of systems instead of using the -n option to specify each system. The -n option and the -x mlist= option are mutually exclusive.

If you do not specify this option, the system is assumed to be the one specified by the -H option.

This option is supported only if the Solaris Management Console and the Solaris WBEM services are running on the local system and any system that is specified by this option.

This option is supported by the add, analyze, download, get, order, remove, set, unset, and update subcommands.

-t

Downloads the README file associated with the update specified by -i update-id. If -i update-id does not specify a revision, the README file for the highest revision of the update is downloaded.

This option is supported by the download subcommand.

-V

Displays version information for an smpatch subcommand.

-x idlist=update-list-file

Specifies the name of a file, update-list-file, that contains a list of updates to download or apply.

Each update ID in the file must be terminated by a newline character. The file name you specify must be a full path name.

You can use the -i option to specify a list of update IDs.

This option is supported by the add, analyze, download, order, and update subcommands.

-x mlist=system-list-file

Specifies the name of a file, system-list-file, that contains a list of systems on which to manage updates.

Each system name must be terminated by a newline character. The file name you specify must be a full path name.

You can use the -n option to specify a list of systems instead of using the -x mlist= option. The -n option and the -x mlist= option are mutually exclusive.

This option is supported only if the Solaris Management Console and the Solaris WBEM services are running on the local system and any system that is specified in system-list-file.

This option is supported by the add subcommand.

Examples

Example 1 Analyzing Your System to Obtain the List of Appropriate Updates for the Local System

# smpatch analyze

Shows how to analyze your system to obtain the list of appropriate updates. After the analysis, you can download and apply the updates to your system.

Example 2 Analyzing Your System to Obtain the List of Appropriate Updates for Another System

# smpatch analyze -n lab1

Shows how to analyze a different system, lab1, to obtain the list of appropriate updates. After the analysis, you can download and apply the updates to that system.

Example 3 Applying Updates to Multiple Systems

# smpatch add -i 102893-01 -i 106895-09 -i 106527-05 \ -d fileserver:/files/updates/s10 -n lab1 -n lab2

Applies updates 102893-01, 106895-09, and 106527-05 to the systems lab1 and lab2. The updates are located in the /files/updates/s10 directory on the system named fileserver.

Example 4 Applying Updates by Using an Update List File

# smpatch add -x idlist=/tmp/update/update_file \ -d /net/fileserver/export/updatespool/Solaris10 -n lab1 -n lab2

Applies the updates specified in the file /tmp/update/update_file to the systems lab1 and lab2. The updates are located in the NFS-mounted directory named /net/fileserver/export/updatespool/Solaris10.

Example 5 Applying Updates by Using an Update List File and a System List File

# smpatch add -x idlist=/tmp/update/update_file \ -x mlist=/tmp/update/sys_file

Applies the updates listed in the file /tmp/update/update_file to the systems listed in the file /tmp/update/sys_file. The updates are located in the default /var/sadm/spool directory on the local system.

Example 6 Analyzing a System and Downloading Updates From the Sun Update Server

# smpatch download -n lab1

Analyzes the lab1 system and downloads the appropriate updates from the Sun update server to the download directory.

Example 7 Downloading Updates From the Sun Update Server

The command below downloads the 102893-01 and 106895-09 updates from the Sun update server to the /files/updates/s10 directory.

# smpatch download -i 102893-01 -i 106895-09 -d /files/updates/s10

Example 8 Downloading Specific Update Revisions From the Sun Update Server

The command below downloads the 102893-01 and 106895-02 updates from the Sun update server. The specific revisions are downloaded, not the highest available revision.

# smpatch download -f -i 102893-01 -i 106895-02

Example 9 Downloading the Highest Available Update Revisions From the Sun Update Server

The command below downloads the 102893-01 and 106895-09 updates, which are the highest available revisions, from the Sun update server.

# smpatch download -f -i 102893 -i 106895

Example 10 Downloading Update README Files From the Sun Update Server

The command below downloads the README files for updates 102893-01 and 106895-02. Because update 102893 was specifi ed without a revision number, the README file for the highest available update revision, 102893-01, is downloaded from the Sun update server.

# smpatch download -t -i 102893 -i 106895-02

Example 11 Listing All Configuration Parameter Values

# smpatch get -p password
Loading Tool: com.sun.admin.patchmgr.cli.PatchMgrCli from mars
Login to mars as user root was successful.
Download of com.sun.admin.patchmgr.cli.PatchMgrCli from mars 
was successful.

On machine mars:

patchpro.backout.directory  -      ""
patchpro.download.directory -      /var/sadm/spool
patchpro.install.types      -      rebootafter:reconfigafter:standard
patchpro.patch.source       -      https://getupdates.sun.com/solaris/
patchpro.patchset           -      current
patchpro.proxy.host         -      ""
patchpro.proxy.passwd       ****   ****
patchpro.proxy.port         -      8080
patchpro.proxy.user         -      ""
patchpro.sun.passwd         ****   ****
patchpro.sun.user           -      ""

Lists the configuration settings for the system.

Example 12 Listing One or More Configuration Parameter Values

# smpatch get -L patchpro.patch.source patchpro.download.directory
https://getupdates.sun.com/solaris/
/var/sadm/spool

Uses smpatch in local mode to list the values of the patchpro.patch.source and the patchpro.download.directory parameters.

Example 13 Reordering a List of Updates

# smpatch order -x idlist=/tmp/plist

Reorders the update list called /tmp/plist in an order that is suitable for applying the updates.

Example 14 Removing an Update

# smpatch remove -i 102893-01

Removes update 102893-01.

Example 15 Specifying the Update Policy

The following command specifies the update policy.

# smpatch set \ patchpro.install.types=standard:singleuser:reconfigafter:rebootafter

Specifies the update policy for your system. The following types of updates are allowed to be applied to your system:

Example 16 Changing the Download Directory Location

# smpatch set patchpro.download.directory=/export/home/updates

Example 17 Specifying a Local Web Proxy

# smpatch set patchpro.proxy.host=webaccess.corp.net.com \ patchpro.proxy.port=8080

Specifies the host name, webaccess.corp.net.com, and port, 8080, of the local web proxy.

Example 18 Resetting a Configuration Parameter Value

# smpatch unset patchpro.patch.source

Resets the value of the patchpro.patch.source parameter to its default value, which is the URL that points to the Sun update server.

Example 19 Updating Your System

# smpatch update -L

Analyzes your local system, determines the appropriate updates, downloads those updates to the download directory, and applies those updates.

Example 20 Adding an Update to a BE

The following command adds a specific update to the BE altboot.

# smpatch add -b altboot 111111-01

Following successful completion of this command, you can then boot from altboot.

Example 21 Updating a BE

The following command performs an update on the BE altboot.

# smpatch update -b altboot

This command performs all of the usual analysis and dependency checking that occurs with any update command. Following successful completion of this command, you can then boot from altboot.

Example 22 Obtaining smpatch Version Number

The following command returns the version number for an smpatch subcommand.

# smpatch update -V
1.0.9

Environment Variables

See environ(5) for a description of the JAVA_HOME environment variable, which affects the execution of the smpatch command. The default value of this variable is /usr/java. See the smc(1M) man page.

Exit Status

The following exit values are returned:

0

Successful completion.

1

Invalid command syntax. A usage message displays.

2

An error occurred while executing the command. An error message displays.

Attributes

See the attributes(5) man page for descriptions of the following attributes:

ATTRIBUTE TYPE
ATTRIBUTE VALUE
Availability
SUNWswmt
Interface Stability
Evolving

See Also

boot(1M), luactivate(1M), patchadd(1M), patchrm(1M), smc(1M), attributes(5), environ(5), live_upgrade(5)

Sun Update Manager 1.0 Administration Guide