When creating a SoftwareDirector package for use with an IDM agent using the Package wizard of the Software Management application, the following differences are important to remember.
o An IDM software update package MUST have a single download instruction. Be sure to select the check box "Do not compress this file before downloading..."
o An IDM software update package MUST have at least one Package Execute instruction. If the package contains no instructions, then it is a simple file download rather than a SoftwareDirector package.
o The format of the Package Execute instruction is important. The "Application" field of the instruction is the full command text to send to the agent. The"Arguments" field of the instruction MUST be one of the following enumerated command definitions (case insensitive):
§ installCommand
§ rollbackCommand
§ activateCommand
§ preActivateCommand
§ postActivateCommand
§ preDownloadCommand
§ postDownloadCommand
§ preInstallCommand
§ postInstallCommand
o Software Director"Pull" from the agent is only available for Published software packages.
o Other types of instructions chosen in the Package wizard (for example, the wait instruction) are not supported by the IDM agent and are ignored when the package to send to the IDM agent.
o Do NOT use a ROLLBACK instruction to perform a rollback. Instead, use the rollbackCommand in the Arguments field of the Package Execute instruction.
o Service Agent Update Packages are just SoftwareDirector Packages with a specific install command that invokes the agent's saupdate script. When building a Service Agent Update package that will invoke the saupdate script, do not use any activate commands (*activateCommand, preActivateComamnd, postActivateCommand*). The agent update script does not process commands after the saupdate installation command.
Here is a simple software package that echoes data to a log file:
o Download Instruction: Any file. Not used by the package
o Execute Instruction:
§ Application: echo "PRE-DOWNLOAD" > "PKGDIR\DEVICENAME\REQID.log"
§ Arguments: preDownloadCommand
Here is an example of a package that updates the IDM Agent software (a SoftwareDirector package):
o Download Instruction: simplePatch.zip
o Execute Instruction:
§ Application: "SWDDIR\bin\saupdate" -pkg "PKGFILE" -device "DEVICENAME" -pkgid PKGID -reqid REQID > "PKGDIR\DEVICENAME\REQID.log" 2>&1
§ Arguments: installCommand