Deployment configuration file

When installing a file package, the rsdeploy agent on each host retrieves the deployment.xml configuration file from within the file package and executes the specified installation command. Likewise, when uninstalling a file package, the rsdeploy agent executes the specified uninstallation command.

Guidelines for using the deployment.xml file

When creating the deployment.xml file, remember the following guidelines:
  • deployment.xml must be in the root location in the file package.
  • The current working directory for startCmd is set to the deployment directory.
  • Success codes are compared to the exit code of startCmd. If the successCodes attribute is not defined, exit code checks are not done.
  • The exit code of a script is usually the exit code of the last command that the script executes.
  • The <env> section can be used to set up the environment for the rsdeploy install and rsdeploy uninstall commands.
  • In a mixed cluster, each package can be associated with a specific OS type (using the -o option with rsdeploy). If the file package is to be installed on multiple OS types, the install and uninstall sections must include all the supported OS types.
  • The timeout periods for the install and uninstall scripts are specified in seconds. By default, a timeout is not configured.

Sample deployment.xml

The following is a sample deployment.xml file, which defines installations for Windows and Linux® environments running on x86 machines (OS types NTX86 and LINUX86):

<?xml version="1.0" encoding="UTF-8"?>
<Deployment xmlns="http://www.platform.com/Symphony/Deployment">
 <install>
  <osTypes>
    <osType name="NTX86" startCmd="cmd /c cmd /c wininst.bat" timeout="600" successCodes="0,1,2,3">
        <env name="WIN_ENV">c:\temp</env>
    </osType>
    <osType name="LINUX86" startCmd="/bin/sh linuxinst.sh" timeout="600" successCodes="0,1,2,3">
        <env name="LINUX_ENV">/tmp</env>
    </osType>
  </osTypes>
 </install>
 <uninstall>
  <osTypes>
    <osType name="NTX86" startCmd=" cmd /c cmd /c winuninst.bat " timeout="600" successCodes="0,1,2,3">
        <env name="WIN_ENV">c:\temp</env>
    </osType>
    <osType name="LINUX86" startCmd="/bin/sh linuxuninst.sh" timeout="600" successCodes="0,1,2,3">
        <env name="LINUX_ENV">/tmp</env>
    </osType>
  </osTypes>
 </uninstall>
</Deployment>