Exporting and Importing XML files-based settings

Installation and Configuration

Command and Utility Reference : Managing installation configurations : configutil : Exporting and Importing XML files-based settings

XML files always have their own hierarchy. If you want to forcibly over-write or do not want to over-write a setting stored in an XML file, you must create its hierarchy to refer to the element's attributes and value.

If you want to create a hierarchy rule for an element's text, then use the following format:

(<ElementHierachy>).#text

If you want to create a hierarchy rule for an element's attribute, then use the following format:

(<ElementHierachy>).<attributeName>

<ElementHierarcy> has the following format:

(<RootElement[ID]>/<childElement[ID]/[<childElement[ID]/...>)

ID is optional for each root or child element and, if not provided, it applies to all the elements. Here is a sample XML file:

<web-app>
<servlet>
<servlet-name>Aia</servlet-name>
<servlet-class>com.progress.aia.Aia</servlet-class>
<init-param>
<param-name>InstallDir</param-name>
<param-value>C:\Progress\OpenEdge</param-value>
</init-param>
<init-param>
<param-name>instanceName</param-name>
<param-value>Aia1</param-value>
</init-param>
<init-param>
<param-name>propertyFileName</param-name>
<param-value>C:\Progress\OpenEdge/properties/ubroker.properties</param-value>
</init-param>
</servlet>
</web-app>

If you do not want to OVERRIDE or FORCE-OVERRIDE the highlighted init-param, you can construct the hierarchy rule as follows:

(web-app/servlet/init-param[InstallDir]/param-value).#text

Here, web-app is the RootElement. Its child is servlet, and the servlet contains init-param. The init-param is the text value of installDir. So, installDir is the ID that you provide within square brackets.

Note that an ID for servlet is not added, so the above hierarchy applies to all servlets that have init-param as InstallDir. If you want the rule to be applied to a single servlet, say AIA, your hierarchy rule must look like this:

(web-app/servlet[Aia]/init-param[InstallDir]/param-value).#text

Here is a sample configutil.properties with XML hierarchy rule:

[$TCIB_HOME/webapps/aia/WEB-INF/web.xml]
FORCE_OVERRIDE:(web-app/servlet/init-param[InstallDir]/param-value).#text
FORCE_OVERRIDE:(web-app/servlet/init-param[propertyFileName]/param-value).#text

Here is another sample XML file:

If you want to retain or override the number for HTTP port, add the following in the configutil.properties file:

[$oemgmt/conf/Ports.xml]
DONT_OVERRIDE:(portlist/port[HTTP]).number