Chapter 05 Software Distributor (SD-UX) HP-UX Handbook Revision 13.
Chapter 05 Software Distributor (SD-UX) October 29, 2013 TERMS OF USE AND LEGAL RESTRICTIONS FOR THE HP-UX RECOVERY HANDBOOK ATTENTION: PLEASE READ THESE TERMS CAREFULLY BEFORE USING THE HP-UX HANDBOOK. USING THESE MATERIALS INDICATES THAT YOU ACCEPT THESE TERMS. IF YOU DO NOT ACCEPT THESE TERMS, DO NOT USE THE HP-UX HANDBOOK. THE HP-UX HANDBOOK HAS BEEN COMPILED FROM THE NOTES OF HP ENGINEERS AND CONTAINS HP CONFIDENTIAL INFORMATION.
Chapter 05 Software Distributor (SD-UX) October 29, 2013 TABLE OF CONTENTS Introduction ______________________________________________________________________ 5 Patches for SD-UX _________________________________________________________________ 5 The Basic SD-UX Object Types ________________________________________________________ 5 Fileset _________________________________________________________________________________5 Product ___________________________________________________________________________
Chapter 05 Software Distributor (SD-UX) October 29, 2013 Patch Text _______________________________________________________________________ 39 Patch Ratings___________________________________________________________________________40 Patch Category Tags _____________________________________________________________________41 Patch Rollback ___________________________________________________________________ 41 Patch Tools: show_patches, check_patches and cleanup _________________________________ 43 show_p
Chapter 05 Software Distributor (SD-UX) October 29, 2013 Introduction This chapter provides an overview of Software Distributor for HP-UX 11i (SD-UX) commands and concepts. SD-UX is included with the HP-UX Operating System and by default manages software on the local host only. You can also enable SD-UX to install and manage software simultaneously on multiple remote hosts from a central controller. This chapter does not present a comprehensive view of SD-UX.
Chapter 05 Software Distributor (SD-UX) October 29, 2013 Product An HP-UX patch is structured as a single SD-UX product that contains one or more filesets. HPUX 11.X patches that require customization include SD-UX control scripts at the product level. Bundle A bundle encapsulates products and filesets into a single software object. Bundles provide a convenient way to group software objects together for easy selection. More than one bundle can contain the same software objects.
Chapter 05 Software Distributor (SD-UX) October 29, 2013 product[.fileset][, version] bundle[.product[.fileset]][, version] where the version has the form: [r= revision][,a= arch][,v= vendor][,c= category] (The version may also have a l= locationcomponent that applies only to installed software and refers to software installed to a location other than the default product directory.) The software_spec attribute contains the full software specification for any bundle, product, or patch.
Chapter 05 Software Distributor (SD-UX) October 29, 2013 IPD directory, each bundle and product gets its own directory. # ll /var/adm/sw/products total 6648 dr-x------ 473 root drwxr-xr-x 13 bin drwxr-xr-x 7 root drwxr-xr-x 5 root drwxr-xr-x 11 root ... -rw-r--r-- 1 root sys sys bin sys sys sys 11264 Apr 9 12:24 ./ 1024 Apr 9 16:08 ..
Chapter 05 Software Distributor (SD-UX) October 29, 2013 $HOME/.sw/sessions/{ command}.last. This file is overwritten on each invocation. You can also save session information from interactive or command-line sessions. From an interactive session, you can save session information into a file at any time by selecting the Save Session or Save Session As option from the File menu. From a command-line session, save session information by executing swinstall or swcopy with the -C session_file option.
Chapter 05 Software Distributor (SD-UX) October 29, 2013 4. Option values in a session file affect activities only for that session and revert when that session is completed. 5. Option values changed on the command line affect only that activity. For system-wide policy setting, use the /var/adm/sw/defaults file. Keep in mind, however, that individual users may override these values with their own $HOME/.sw.defaults file, session files, or command line changes.
Chapter 05 Software Distributor (SD-UX) October 29, 2013 swinstall Command The swinstall command is used to load software from a source depot and onto a target system. Because many patches aren’t designed for individual installation, the automatic matching options(autoselect_patches, patch_match_target) should be the preferred method for installing patches. swinstall has numerous options that you should not use for patching because they lack dependency support.
Chapter 05 Software Distributor (SD-UX) October 29, 2013 recopy=false register_new_root=true reinstall=false reinstall_files=false reinstall_files_use_cksum=true retry_rpc=1 retry_rpc_interval= reuse_short_job_numbers=true rpc_binding_info=ncacn_ip_tcp:[2121] ncadg_ip_udp:[2121] rpc_binding_info_source= rpc_binding_info_target= rpc_timeout=5 run_as_superuser=true run_scripts=true select_local=true software= software_view=all_bundles source= source_cdrom=/SD_CDROM source_directory= source_tape=/dev/rmt/0m
Chapter 05 Software Distributor (SD-UX) October 29, 2013 create_target_path=true customer_id= defer_configure=false distribution_source_directory=/var/spool/sw enforce_dependencies=true enforce_dsa=true enforce_kernbld_failure=true enforce_scripts=true enforce_selections=false installed_software_catalog=products job_title= layout_version=1.0 loadorder_use_coreqs=true log_msgid=0 logdetail=false logfile=/var/adm/sw/swinstall.
Chapter 05 Software Distributor (SD-UX) October 29, 2013 Note that the swcopy command automatically registers (enables remote access to) any depot that it creates. You do not need to use the swreg command on depots created by swcopy.
Chapter 05 Software Distributor (SD-UX) compress_files=false OptionsChange transfer October 29, 2013 OptionsCompress files during Setting this option to true causes swcopy to compress file before transfer to the target depot. This will conserve disk space and can enhance performance on slower networks (50 Kilobytes/second or less), although it may not improve fast networks. OptionsChange OptionsEnforce dependency analysis enforce_dependencies=true errors in agent Enforces software dependencies.
Chapter 05 Software Distributor (SD-UX) October 29, 2013 do swcopy -s $PATCHDEPOT \* @ /hub/patches done swremove Command The swremove command deletes software that has been installed on your system. It also removes software from depots. You might occasionally want to remove a patch and restore the system to its prepatched state. This process is known as patch rollback. For example, if you installed a patch that resulted in unacceptable system behavior, you might choose to roll back this patch.
Chapter 05 Software Distributor (SD-UX) October 29, 2013 $ swinstall -s /tmp/temporary_depot/depot -x autoreboot=true \ -x patch_match_target=true x patch_save_files=false Only use the false option if you will never remove a patch under any circumstances Synopsis swremove [XToolkit Options] [-d|-r] [-i] [-p] [-v] [-C session_file] [-f software_file] [-J jobid] [-Q date] [-S session_file] [-t target_file] [-x option=value] [-X option_file] [software_selections] [@ target_selections] Command Line Argument
Chapter 05 Software Distributor (SD-UX) October 29, 2013 Enforces software dependencies. When software selected for removal has a registered dependency, if the dependencyis not present on the target system or also selected for removal from the source depot, removal only proceeds if enforce_dependencies is set to false. While few 11.00 patches currently exist with dependencies enforced by the SD-UX tools, those that do employ them to enforce critical requirements of content and removal order.
Chapter 05 Software Distributor (SD-UX) October 29, 2013 [software_selections] [@ target_selections] Command Line Arguments -i Invokes a GUI interface that lets you perform interactive software selections. If the environment variable DISPLAY is set to a valid X windows display, a graphical user interface is invoked. Otherwise a terminal user interface (TUI) designed for use on ASCII terminals is invoked. You must specify -i to invoke the GUI; it never starts by default.
Chapter 05 Software Distributor (SD-UX) October 29, 2013 The following options have the most relevancy to patching. Where appropriate, default values are shown. For the full set of available options, consult the swlist(1m) man page or refer to the Software Distributor Administration Guide HP-UX 11i v1, 11i v2, and 11i v3. Options option=default value Menu Path in Interactive Interface Description show_superseded_patches=false The swlist command lists the contents of the IPD. In 11.
Chapter 05 Software Distributor (SD-UX) October 29, 2013 swreg Command The swreg command registers or unregisters an existing depot. When a depot is registered, it can be accessed from remote systems. Unregistration of a depot can be a convenient way to limit access during development. (Note that unregistered depots are still available locally.
Chapter 05 Software Distributor (SD-UX) October 29, 2013 subsequent patching or system updates and leave your system in an unsupportable state. NOTE: You may choose the cleanup utility as a front-end to the patch_commit option of swmodify that provides an easier interface to commit multiple patches at once.
Chapter 05 Software Distributor (SD-UX) October 29, 2013 Add additional files to an existing fileset: swmodify -xfiles='/tmp/a /tmp/b /tmp/c' PRODUCT.FILESET Replace the definitions of existing files in an existing fileset (for example, to update current values for the files’ attributes): chown root /tmp/a /tmp/b swmodify -x files='/tmp/a /tmp/b' PRODUCT.FILESET Delete control files from a fileset in an existing depot: swmodify -d -u -x control_files='checkinstall subscript' \ PRODUCT.
Chapter 05 Software Distributor (SD-UX) October 29, 2013 [software_selections] [@ directory |device ] Command Line Arguments -p Previews the package operation without performing the actual packaging. Preview mode is not enabled by default. -v Requests verbose mode. This option affects only standard output and not the log files. -s directory An existing directory depot (which already contains products) to be used as the source.
Chapter 05 Software Distributor (SD-UX) October 29, 2013 Preview the same operation (do not create the target depot), and generate very verbose output: swpackage -p -vv -s products Package the products into the target depot no_files, insert references to the source files instead of copying them into the depot: swpackage -s products -x package_in_place=true @ no_files Re-package a specific fileset: swpackage -s products -x package_in_place=true product.
Chapter 05 Software Distributor (SD-UX) PHSS_24864 1.0 October 29, 2013 PRM C.01.08.2 Cumulative Patch Insert a DDS tape and copy the depot to the tape: # swpackage -x target_type=tape -s /tmp/glance_depot \* @ /dev/rmt/0m or to a depot file: # swpackage -x target_type=tape /tmp/glance_depot.depot -s /tmp/glance_depot \* @ \ Check depot contents: # swlist -d -l product @ /dev/rmt/0m Glance MeasureWare ... PHSS_24864 C.03.55.00 C.03.55.
Chapter 05 Software Distributor (SD-UX) October 29, 2013 Command Line Arguments -d Operate on a depot rather than installed software. -v Turn on verbose output to stdout and display all activity to the screen. Lets you see the results of the command as it executes. -f software file Read a list of software selections from a separate file instead of from the command line. -x option=value Specify a value to override a default value or a value in an options file.
Chapter 05 Software Distributor (SD-UX) October 29, 2013 Selected Command Line Arguments -p Preview a configuration task from the command line by running it through the Analysis Phase and then exiting. -v Turn on verbose output to stdout and display all activity to the screen. Lets you see the results of the command as it executes. -f software file Read a list of software selections from a separate file instead of from the command line.
Chapter 05 Software Distributor (SD-UX) October 29, 2013 swinstall, you would look in the file /var/adm/sw/swinstall.log. Of more interest in case of troubleshooting is to examine target agent logfiles for a current session. The location of the agent logfile varies, depending on the type of target: /var/adm/sw/swagent.log when operating on a host's primary root. //var/adm/sw/swagent.log for an alternate root. //swagent.log for a target or source depot.
Chapter 05 Software Distributor (SD-UX) October 29, 2013 Notes are used to notify you of an event that is not erroneous, unexpected or undesirable, but that you should be aware of: NOTE: The fileset "SD-DATABASE.SD-DATABASE1,r=9.00.1C" is already installed. If you wish to reinstall this fileset, change the "reinstall" option to "true".
Chapter 05 Software Distributor (SD-UX) October 29, 2013 ERROR:Remote Procedure Call to a daemon has failed. Could not start a management session for . Make sure the host is accessible from the network, and that its daemon, swagentd, is running. If the daemon is running see the daemon logfile on this target for more information. It means SD-UX could not contact the daemon program on a specific target system.
Chapter 05 Software Distributor (SD-UX) October 29, 2013 /var/adm/sw/sw*.log files. Example: # export SDU_DEBUG=1 # export SDU_DEBUG_TIMESTAMP=hour:minute:second:millisecond # script -a /tmp/SDdebug.out Perform SD-UX command. # exit # unset SDU_DEBUG # unset SDU_DEBUG_TIMESTAMP Analyze /tmp/SDdebug.out. The variable SDU_DEBUG can have a value between 1 and 4: Level 1: Level 2: Level 3: Level 4: Trace entry to major function calls. Add trace of exit from major function calls.
Chapter 05 Software Distributor (SD-UX) October 29, 2013 It might be necessary to kill the named process in order to switch off DNS. vi the /etc/hosts and replace the localhost entry by the actual hostname: 127.0.0.1 hostname loopback (Re-)start the swagentd: # /usr/sbin/swagentd –r Then use swinstall with the use_alternate_source=true option: # swinstall –x use_alternate_source=true ... Good luck! Don´t forget to reboot into single user mode and move the hosts.orig and resolv.conf.orig files back.
Chapter 05 Software Distributor (SD-UX) October 29, 2013 Patch Introduction HP-UX patch names have the following format: PHxx_yyyyy where: PH Patch HP-UX xx area patched CO general HP-UX commands KL Kernel Patch NE network specific patches SS all other subsystems: X11, Starbase, etc yyyyy unique number The number yyyyy is unique across all areas (or categories). The installation of kernel and networking patches modifies the kernel (/stand/vmunix) and is therefore always followed by a reboot.
Chapter 05 Software Distributor (SD-UX) October 29, 2013 management. Each patch has a superseeding flag which eases the administration, especially if a product has been patched more than one time. the swinstall option -x match_target is replaced by the more specific option -x patch_match_target for 11.X patches. swlist displays patches even if their successor(s) is installed. Such patches have the superseded flag.
Chapter 05 Software Distributor (SD-UX) October 29, 2013 were never created, since the flag -x patch_save_files=false was set during installation. Refer to the Patch Rollback section. been removed or superseded The patch is superseded by another installed patch. The superseding patch can be found using the -a superseded_by command-line option of swlist. It will switch back to applied or committed if you swremove (roll back) all superseding patch(es).
Chapter 05 Software Distributor (SD-UX) October 29, 2013 The SD file as a shell archive (shar) in compressed form comparable to tar. From the IT Resource Center The support portal HP IT Resource Center (ITRC) reached its end of life in June 2011. The HP Support Center portal now provides you with the capabilities you used and valued in ITRC, as well as new and enhanced features. The following ITRC users should migrate to the HP Support Center: * Those who had linked entitlements on ITRC.
Chapter 05 Software Distributor (SD-UX) October 29, 2013 * See the updated HP Support Center – Frequently Asked Questions document. * Videos are also available on the HP Support Center Overview page. We also recommend that you review the "Get Started with HP Support Center" information available from the HP Support Center Home Page.
Chapter 05 Software Distributor (SD-UX) October 29, 2013 set of mass storage related patches. Generally the Response Center delivers the patches in SD format on DDS tape. Install the patches using: # swinstall -x autoreboot=true -x patch_match_target=true -s /dev/rmt/0m Verifying Patch Installation The result of the patch installation can be seen in the swagent log / var/adm/sw/swagent.log.
Chapter 05 Software Distributor (SD-UX) October 29, 2013 Description of enhancements and bugfixes Dependencies Warnings Special installation instructions OS that incorporates the fix A detailed description of all patch fields can be found here (HP Internal only) For UX 11.X the patchtext is stored to /var/adm/sw/products/PHxx_yyyy/pfiles/README during installation. It can be displayed using: # swlist -a readme PHxx_yyyyy NOTE: For UX 10.X the patchtext is handled separately.
Chapter 05 Software Distributor (SD-UX) October 29, 2013 Patch Category Tags Category tags identify the type of patch. Possible values can be one or combinations of: critical Fixes one or more of the critical conditions depicted above under "Critical:". panic Fixes a system panic. halts_system Fixes a problem that leads to a system halt or hang. corruption Fixes a data corruption problem.
Chapter 05 Software Distributor (SD-UX) October 29, 2013 To delete existing patch rollbacks in order to save disk space you can use the cleanup(1M) command: for 10.X # cleanup -F for 11.X To remove (commit) patches that have been superseeded at least two times do: # cleanup –c 2 ### Cleanup program started at 02/20/02 13:15:43 Commit patches superseded at least 2 time(s) on 'grcdg319'. Obtaining superseded patch information...done.
Chapter 05 Software Distributor (SD-UX) October 29, 2013 Patch Tools: show_patches, check_patches and cleanup These useful tools are not delivered on HP-UX o/s versions 11.0 and 11.11 but are available as a patch. At HP-UX o/s 11.23 and 11.31 the patch tools are part of the core o/s. PHCO_24347 (or newer) PHCO_24630 (or newer) for UX 11.00 for UX 11.
Chapter 05 Software Distributor (SD-UX) October 29, 2013 Running swverify on all patch filesets, this may take several minutes RESULT: Problems found, review /tmp/check_patches.report for details. Refer to the check_patches manual page for details. cleanup Command The cleanup utility is used: to remove any patches for earlier releases from the Installed Product Database (IPD) after updating to a newer version of HP-UX. to commit patches across the entire system, i.e to remove patch rollbacks.
Chapter 05 Software Distributor (SD-UX) October 29, 2013 Diagnostics, including Support Tool Manager (STM) for online diagnostics, ODE (offline diagnostics), EMS hardware monitors, Predictive Support, EMS Kernel Resource Monitor, and the Instant Capacity on Demand (iCOD) client products. You can download Support Plus directly from the HP Patch Program website (HP internal), or install it from the quarterly media shipped to you if your HP-UX support contract is current.
Chapter 05 Software Distributor (SD-UX) October 29, 2013 Document Title Date Links Part Number Support Plus User's Guide December 2006 [PDF] 5991-7358 Support Plus Read Before Installing December 2009 [PDF] B3920-90000 HP-UX Patch Management User Guide September 2007 [PDF] 5992-0674 UX 11.22 (Itanium release) MAINTPACK Collection of defect-fix patches UX 11.
Chapter 05 Patch Content Software Distributor (SD-UX) Bundle Bundle READ Refresh Bundle READ ME File ed in Revision ME File (HTML Release ) October 29, 2013 Archive Depot FEATURE 11i Septem B.11.31.1109. patchsvr.fc.hp.com:/depots/SP1109/FE ber 367a ATURE11i 2011 HWEnable 11i Septem B.11.31.1109. patchsvr.fc.hp.com:/depots/SP1109/HW ber 367a Enable11i 2011 QPKAPPS Septem B.11.31.1109. patchsvr.fc.hp.com:/depots/SP1109/QP ber 367a K1131 2011 QPKBASE Septem B.11.31.1109. patchsvr.fc.hp.
Chapter 05 Software Distributor (SD-UX) October 29, 2013 There check_patches utility (see above) allows you to check for all overwritten files on the system and detect if a line in the sand patch had been reinstalled. If this is the case the safest way to repair it is to reinstall ALL kernel patches (PHKL) that are shown by swlist (minus the line in the sand patch itself).
Chapter 05 Software Distributor (SD-UX) October 29, 2013 Patch Management document: http://docs.hp.com/hpux/os/11.0/index.html#Patch%20Management The HP-UX patch tools: http://patch-hub.corp.hp.com/wtec/tools/default.shtml Patch white papers at this website: http://patch-hub.corp.hp.com/wtec/wp/default.shtml Sources: Software Distributor Administration Guide HP-UX 11i v1, 11i v2, and 11i v3 (Sept 2011) Patch Management User Guide for HP-UX 11.x Systems (Sept 2011) HP-UX Handbook – Rev 13.