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
- If the
- 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
- If the
-
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.