swagentd(1M)

The kill option stops the currently running daemon. Stopping the daemon will not stop any agent processes currently performing management tasks (such as installing or removing software), but will cause any subsequent management requests to this host to be refused. This option is equivalent to sending a SIGTERM to the daemon that is running.

The no fork option runs the daemon as a synchronous process rather than the default behavior of forking to run it asynchronously. This is intended for running the daemon from other utilities that schedule processes, such as init.

The restart option stops the currently running daemon and restarts a new daemon. This operation is required whenever modifying default options that apply to the daemon since defaults are only processed on startup.

Set the option to value and override the default value (or a value in an option_file specified with the -X option). Multiple -x options can be specified.

Read the session options and behaviors from options_file.

the system-wide default values.

the user-specific default values.

The location of the agent program invoked by the daemon.

This is the default log file for the swagentd daemon.

The maximum number of agents that are permitted to run simultaneously. The value of -1 means that there is no limit.

(Applies only to HP OpenView Software Distributor.) Defines how often, in minutes, the daemon will wake up and scan the job queue to determine if any scheduled jobs need to be initiated or if any active jobs need their remote target status cached locally (see swinstall.job_polling_interval ). If set to 0, no scheduled jobs will be initiated, and no caching of active jobs will occur.

Defines the protocol sequence(s) and endpoint(s) on which the daemon listens and which the other commands use to contact the daemon. If the connection fails for one protocol sequence, the next is attempted. SD supports both the tcp (ncacn_ip_tcp:[2121]) and udp (ncadg_ip_udp:[2121]) protocol sequence on most platforms.

If the swinstall or swcopy controller has set use_alternate_source=true, the target agent will consult and use the configured value of its own alternate_source option to determine the source that it will use in the install or copy.

The agent's value for alternate_source is specified using the host:path syntax. If the host portion is not specified, the local host is used. If the path portion is not specified, the path sent by the command is used. If there is no configured value at all for alternate_source, the agent will apply the controller-supplied path to its own local host.

Defines the command called by the source agent to compress files before transmission. If the compression_type is set to other than gzip or compress, this path must be changed.

Defines the default compression_type used by the agent when it compresses files during or after transmission. If uncompress_files is set to false, the compression_type is recorded for each file compressed so that the correct uncompression can later be applied during a swinstall, or a swcopy with uncompress_files set to true. The compress_cmd specified must produce files with the compression_type specified. The uncompress_cmd must be able to process files of the compression_type specified unless the format is gzip, which is uncompressed by the internal uncompressor (funzip). The only supported compression types are compress and gzip.

Defines the script called by the agent to perform release-specific configure cleanup steps.

Defines the script called by the agent to perform release-specific install cleanup steps immediately after the last postinstall script has been run. For an OS update, this script should at least remove commands that were saved by the install_setup script. This script is executed after all filesets have been installed, just before the reboot to the new operating system.

Defines the script called by the agent to perform release-specific install preparation. For an OS update, this script should at least copy commands needed for the checkinstall, preinstall, and postinstall scripts to a path where they can be accessed while the real commands are being updated. This script is executed before any kernel filesets are loaded.

Defines the script called by the agent for kernel building after kernel filesets have been loaded.

Defines the path to the system's bootable kernel. This path is passed to the kernel_build_cmd via the SW_KERNEL_PATH environment variable.

Defines the command called by the agent to mount all filesystems.

Defines the command called by the agent to reboot the system after all filesets have been loaded, if any of the filesets required reboot.

Defines the script called by the agent to perform release-specific remove preparation. For an OS update, this script will invoke the tlink command when a fileset is removed.

Defines the protocol sequence(s) and endpoint(s) used when the agent attempts to contact an alternate source depot specified by the alternate_source option. HP-UX supports both the udp(ncadg_ip_udp:[2121]) and tcp(ncacn_ip_tcp:[2121]) protocol sequence/endpoint. SD on SunOS only supports udp (ncadg_ip_udp:[2121]). By default udp is used.

If both source and target machine are updated to HP-UX version 10.30 or later, the system administrator at the source depot machine can set this option to track which user pulls which software from a depot on the source machine and when the software is pulled. (A user running swinstall/swcopy from a target machine cannot set this option; only the administrator of the source depot machine can set it.)

When swagent.source_depot_audit is set to true, a swaudit.log file is created on the source depot (for writable directory depots) or in /var/tmp (for tar images, CD-ROMs, or other nonwritable depots).

Users can invoke the swlist interactive user interface (using swlist -i -d) to view, print, or save the audit information on a remote or local depot. Users can view audit information based on language preference, as long as the system has the corresponding SD message catalog files on it. For example, a user can view the source audit information in Japanese during one invocation of swlist, then view the same information in English at the next invocation.

Defines the path to the kernel's template file. This path is passed to the system_prep_cmd via the SW_SYSTEM_FILE_PATH environment variable.

Defines the kernel build preparation script called by the agent. This script must do any necessary preparation so that control scripts can correctly configure the kernel about to be built. This script is called before any kernel filesets have been loaded.

Defines the command called by the target agent to uncompress files after transmission. This command processes files which were stored on the media in a compressed format. If the compression_type stored with the file is gzip, the internal uncompression (funzip) is used instead of the external uncompress_cmd. The default value for HP-UX is undefined.

Determines the language in which messages are displayed. If LANG is not specified or is set to the empty string, a default value of C is used. See the lang(5) man page by typing man 5 sd for more information.

Note: The language in which the SD agent and daemon log messages are displayed is set by the system configuration variable script, /etc/rc.config.d/LANG. For example, /etc/rc.config.d/LANG, must be set to LANG=ja_JP.SJIS or LANG=ja_JP.eucJP to make the agent and daemon log messages display in Japanese.

- the initialization file for the PC controller.

The data directory set at installation, which contains the PC depot and other PC controller data files.

The command used to display the PC controller logfile when the View Log... menu item is selected.

The UNIX user at the specified UNIX host (below) who is granted all SD access permissions to the PC controller. (This remote user has permission to perform any SD action at this PC controller.)

The UNIX group at the specified UNIX host (below) which is granted all SD access permissions to the PC controller. (This remote group has permission to perform any SD action at this PC controller.)

The UNIX host from which the specified user and group (above) is granted all SD access permissions.

The secret password used in SD's internal form of authentication. (The -sdu- default value matches the default value defined for the SD commands.)