Skip to content

PAA dependencies for deployment and removal

The deployment and removal of a Portal Application Archive (PAA) file might depend on deployment of other PAA applications. You can specify the PAA dependencies for a PAA file in the assembly level sdd.xml file.

Add PAA dependencies for deploying a PAA file

The deployment of a PAA file might depend on deployment of other PAA applications. You can specify the PAA dependencies for deploying a PAA file in the assembly level sdd.xml file.

To define the PAA dependencies for a PAA file, you must edit the assembly level sdd.xml file in the PAA directory. Open the sdd.xml file and search for the <rootIU> tag. Add the <paaDependencies> tag to the <rootIU> tag. Also, add the <paaDependency> tag for each PAA dependency in the <paaDependencies> tag. The <paaDependency> tag has the following attributes:

  • name

    This attribute is required. Set the value to the name of the PAA dependency.

  • lowerVersion

    This attribute is optional. Only one PAA dependency version value is acceptable for this attribute.

  • higherVersion

    This attribute is optional. Only one PAA dependency version value is acceptable for this attribute.

  • versions

    This attribute is optional. You can add multiple PAA dependency version value for this attribute as a comma-separated list.

You can specify more than one <paaDependency> tag in the <paaDependencies> tag. For example, you might add the following information to your sdd.xml file:

<paaDependencies> 
    <paaDependency name="Dependency1" lowerVersion="8.0.0.0" higherVersion="8.0.0.1" versions="8.5.0.0" /> 
    <paaDependency name="Dependency2" lowerVersion="8.0.0.0" higherVersion="8.0.0.1" versions="8.5.0.0" /> 
</paaDependencies>

All the PAA dependencies that are specified in the <paaDependencies> tag must be deployed on the Portal server. The version of each PAA dependency must match the values that are specified in <paaDependencies> tag. Then, the PAA file can be deployed into the Portal server.

The Solution Installer uses the following rules to determine whether a PAA file can be deployed:

  • The Solution Installer assumes the PAA dependency requirement is satisfied in the following situations:
    • If the <paaDependency> tag is not found in the assembly level sdd.xml file
    • If the <paaDependency> tag exists but has no attributes that are defined
  • All the PAA dependencies that are specified in the <paaDependencies> tag satisfy the requirement. The requirement is, for each of the PAA dependencies that are specified in a <paaDependency> tag, at least one of the following is true:
    • The PAA dependency is deployed. The lowerVersion attribute is set and the value is equal to or greater than the current version of PAA dependency.
    • The PAA dependency is deployed. The higherVersion attribute is set and the current version of PAA dependency is less than or equal to its value.
    • The PAA dependency is deployed. The versions attribute is set and the current version of PAA dependency matches one of the values.

Add PAA dependencies for removing a PAA file

The removal of a PAA file might depend on removal of other PAA applications. You can specify the PAA dependency for removing a PAA file in the assembly level sdd.xml file.

To define the PAA dependencies for a PAA file, you must edit the assembly level sdd.xml file in the PAA directory. Open the sdd.xml file and search for the <rootIU> tag. Add the <paaDependencies> tag to the <rootIU> tag. And add <removePaaDependency> tag for each PAA dependency in the <paaDependencies> tag. The <removePaaDependency> tag has the following attributes:

  • name

    This attribute is required. Set the value to the name of the PAA dependency.

  • lowerVersion

    This attribute is optional. Only one PAA dependency version value is acceptable for this attribute.

  • higherVersion

    This attribute is optional. Only one PAA dependency version value is acceptable for this attribute.

  • versions

    This attribute is optional. You can add multiple PAA dependency version value for this attribute as a comma-separated list.

You can specify more than one <paaDependency> tag in the <paaDependencies> tag. For example, you might add the following information to your sdd.xml file:

<paaDependencies> 
    <removePaaDependency name="Dependency1" lowerVersion="8.0.0.0" higherVersion="8.0.0.1" versions="8.5.0.0" /> 
    <removePaaDependency name="Dependency2" lowerVersion="8.0.0.0" higherVersion="8.0.0.1" versions="8.5.0.0" /> 
</paaDependencies>

The Solution Installer uses the following rules to determine whether a PAA file can be removed:

  • The Solution Installer assumes the PAA dependency requirement is satisfied in the following situations:

    • If the <removePaaDependency> tag is not found in the assembly level sdd.xml file
    • If the <removePaaDependency> tag exists but has no attributes that are defined

  • All the PAA dependencies satisfy the requirement. The requirement is, for each of the PAA dependencies that are specified in a <removePaaDependency> tag, the PAA dependency is not deployed, or not any of the following is true:

    • The PAA dependency is deployed. The lowerVersion attribute is set and the value is less than the current version of PAA dependency.
    • The PAA dependency is deployed. The higherVersion attribute is set and the value is greater than the current version of PAA dependency.
    • The PAA dependency is deployed. The versions attribute is set and the current version of PAA dependency matches any one of the values.