A package file refers to one or more compressed files in ZIP format. These files are used to associate the parameter collection script with the parameter collection definition. Package files are decompressed on the server once they have been forwarded. They are also used to store file attachments, which are output by the discovery script of the parameter collection script, on the admin server.
The package file to be associated with the parameter collection definition is known as the script package. The compressed file in ZIP format containing the file attachment output by the discovery script of the parameter collection script is known as the parameter package. The parameter collection scripts contained in each of these package files is different. An explanation is provided below:
Script package
Includes the discovery script of the parameter collection script, and the file attachment. The discovery script must be included.
Parameter package
Includes the file attachment output by the discovery script of the parameter collection script. The parameter information XML file (parameterinfo.xml) is not included. Note that no parameter package will be created if there is no file attachment.
Script package
A script package is a ZIP file that contains a discovery script and a file attachment. This ZIP file must be stored using the structure shown below. Always store the discovery script in the ZIP file root. The file attachment can contain a directory.
<ZIP file root> + <Discovery script (discover.cmd or discover.sh)> + <File attachment>
Parameter package
A parameter package is a ZIP file that contains a file attachment. This ZIP file must be stored using the structure shown below. It also contains a directory if the file attachment contains a directory.
<ZIP file root> + <File attachment>
Execution example of the parameter collection script
The script package is forwarded to the server and decompressed on it. The parameter collection script is stored in the work directory on the server as described below - note that the directory in which the discovery script is stored becomes the current directory, and the discovery script is executed.
<work directory> + <software id> + Discovery script (discover.cmd or discover.sh) + Script package file attachment
A description of each directory is provided below:
Software ID directory
Directory unique to each software product, with the name <software id>.
Stores the discovery script and the file attachment included in the script package.
The discovery script outputs the parameter information to the directory below (the file attachment for the collected parameters is included in the parameter package).
+ <output directory>
+ Collected parameter information XML file (parameterinfo.xml)
+ File attachment for collected parameters
Note
Package files
Store the discovery script in the ZIP file root, not in the directory, otherwise it cannot be executed.
Package files forwarded to the server are deleted once the script has been executed.