HP Integrity Superdome 2 8/16 HP Smart Update Manager 5.3 User Guide - Page 44

Input file format and rules, File encoding, Error reporting, Credentials:

Page 44 highlights

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. ◦ Remote target: You can specify a remote target by using the variable HOST. Possible values are a DNS name or an IP address. File encoding 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__.raw. 44 Using scripts to deploy updates

  • 1
  • 2
  • 3
  • 4
  • 5
  • 6
  • 7
  • 8
  • 9
  • 10
  • 11
  • 12
  • 13
  • 14
  • 15
  • 16
  • 17
  • 18
  • 19
  • 20
  • 21
  • 22
  • 23
  • 24
  • 25
  • 26
  • 27
  • 28
  • 29
  • 30
  • 31
  • 32
  • 33
  • 34
  • 35
  • 36
  • 37
  • 38
  • 39
  • 40
  • 41
  • 42
  • 43
  • 44
  • 45
  • 46
  • 47
  • 48
  • 49
  • 50
  • 51
  • 52
  • 53
  • 54
  • 55
  • 56
  • 57
  • 58
  • 59
  • 60
  • 61
  • 62
  • 63
  • 64
  • 65
  • 66
  • 67
  • 68
  • 69
  • 70
  • 71
  • 72
  • 73
  • 74
  • 75
  • 76
  • 77
  • 78
  • 79

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.
Remote target: You can specify a remote target by using the variable
HOST
. Possible
values are a DNS name or an IP address.
File encoding
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
.
44
Using scripts to deploy updates