HP Smart Update Manager (SUM) manual Input file format and rules, File encoding, Error reporting

Page 29

When the file has been created, to use it with HP SUM, add it as the inputfile <filename> parameter to a HP SUM command line. For example, if the name of the input file is hpsum.in, the command-line syntax is hpsum -inputfile hpsum.in. Full paths can be added to the input file location if the file is not stored in the same location as the HP SUM executables. The <filename> field can be enclosed in double quotes to enable paths with spaces. Also, the input file itself might contain the same options on the command line. The usual command-line options can still be used with the -inputfileoption and they take precedence over any given input file.

Input file format and rules

The input file is divided into two sections:

Configuration

The configuration section starts from the beginning of the file and proceeds until the first target section is encountered. This section consists of a number of settings and their values. Each configuration setting must appear on a fresh line in the file, along with its value. Comments start with a pound (#) character at the beginning of the line. Only one pound character is allowed on any line.

Target

You can provide remote host targets to HP SUM. This section can repeat any number of times in the input file, providing a way to organize targets in related sets.

The section starts with the following special header enclosed in brackets:

[TARGETS]

The section ends with the following special string enclosed brackets:

[END]

The keyword TARGETS can be suffixed with an optional arbitrary string. This string enables you to tag the purpose of the TARGETS section. Other than the visible difference in the header, the contents of such a section are not treated any differently. For example:

[TARGETS_WIN2003]

...

[END]

Credentials: The TARGETS section allows the targets to be grouped according to the credentials needed for logging in remotely. Each TARGETS section must have a set of login credentials, which applies to all targets in that section. If you want to use the current host's login credentials to log in to one or more remote targets, you can do so by setting the variable USECURRENTCREDENTIAL to YES. You can supply login credentials for one or more hosts by using the variables UID and PWD. If you want to provide the variables at the beginning of a TARGETS section, use both of them. If you want to provide the variables in the middle of a TARGETS section, use one or the other to override the selected variable and continue using the active value for the remaining variable.

File encoding

Remote target: You can specify a remote target by using the variable HOST. Possible values are a DNS name or an IP address.

To allow for the inclusion of double-byte characters, the input file is in UTF-8 format.

Error reporting

If errors occur in the input file, HP SUM exits with a return value of –2 (bad parameter). The details of the location and nature of the error are recorded in hpsum_execution_log_<date>_<time>.raw.

Input files 29

Image 29
Contents HP ProLiant Support Pack User Guide Page Contents Documentation feedback Acronyms and abbreviations Index PSP overview IntroductionComponents in the PSP Not be available in some casesWhich does not ship in Red Hat or Suse Component Description/Benefit Storage-LinuxNew features New featuresObtaining PSP Version control Creating a centralized, network-based software repositoryPSP deployment scenarios Deploying PSPsDeployment for Microsoft Windows Minimum requirements for Microsoft Windows PSPInstalling the PSP for Windows Installing the PSP for WindowsUpgrading a PSP from HP SUM Deploying PSPs for LinuxServer virtualization detection and support Minimum requirements for Linux PSP Minimum requirements for Linux PSPMinimum requirements for Red Hat Enterprise Linux 6 servers Rpm-build-4.8.0-12.el6.arch.rpm Gcc-4.4.4-13.el6.arch.rpm E2fsprogs-32bit Installing or upgrading a PSP for Linux Verifying Installed Components Command-line syntax Command-line interfaceCommand-line interface Advanced topicsUseams No switchesUsesnmp UsewmiCommand-line arguments Installation options 22.33.4480 UsewebReboot options Installation options Overriding errorsReboot Rebootmessage reboot message Use this argument to select a partition to updateRebootalways Rebootdelay timeoutinsecsDryrun CurrentcredentialLogdir path PasswordSYSTEMDRIVE%\CPQSYSTEM\hp\ Path\hp\log\netAddressComponent configuration for Windows components only HP SUM Command-line examplesLinux smart-component return codes Return codesLinux RPM return codes Input filesInput file format and rules Error reportingFile encoding Input filesInput file parameters Sourcepath IgnoreerrorsUselatest YES, noSoftwareonly WebupdateneededUsecurrentcredential UseproxyserverCmalocalhostrocommstr CmalocalhostrwcommstrCmamgmtstationrwipordns CmamgmtstationrwcommstrHpvcavcrmloginpasswd HpvcavcrmloginidADMIN-GROUP ANONYMOUS-ACCESS10.1.1.1-10.1.1.10 10.2.2.2-10.2.2.10 IP-RESTRICTED-EXCLUDE orIP-RESTRICTED-INCLUDE Certlist TrustmodeXenamelist HPQLA2X00FORebootlist UpdatetypeIgnorewarnings DevicelistEND Targets Usage hpsum /report ReportsHpsumReportdate.html HpsumReportdate.xml HpsumInventoryReportdate.html HpsumInventoryReportdate.xmlReport type HPSUMInstalledReportdatatime.xml or HtmlInstallation troubleshooting for Microsoft Windows TroubleshootingInstallation troubleshooting for Microsoft Windows Ports Description TroubleshootingPorts Ports 445 and 137/138/139 Installation troubleshooting for Linux Send data to the target server How many target devices are selected for installationPorts PortSubscription service Related information How to contact HPSupport and other resources Information to collect before contacting HPHP Insight Remote Support software Typographic conventionsWebsites Monospace textHP Insight Remote Support software Documentation feedback Documentation feedbackTransmission Control Protocol/Internet Protocol Acronyms and abbreviationsIndex IndexObtaining PSPs overview