XMLModifier options

Use the XML modifier command-line tool of Symantec Protection Engine to modify the XML files.
For boolean values, allowed and recommended values are true or false.
Option commands provides the option commands that you can use with the XML modifier command-line tool of Symantec Protection Engine.
Option commands
Option name
Description
Remove
If the XPath specifies an attribute, then that attribute is set to an empty string.
If the XPath specifies a group, then the items within that group are removed. If you want to populate a list within the XML document with new items, first remove the whole list.
The command is as follows:
For Windows:
XMLModifier.exe -r <XPath> <XMLfile>
For Linux:
xmlmodifier -r <XPath> <XMLfile>
where <XPath> is the required XPath and <XMLfile> is the XML file name.
Bulk copy
Use the bulk copy command to insert a list of items that are stored at the XPath. Each item is separated as a new line. The bulk copy command appends the bulk file items to the XPath location. Only use this command to insert lists. Each entry must be on a separate line.
The command is as follows:
For Windows:
XMLModifier.exe -b <XPath> bulkfile <XMLfile>
For Linux:
xmlmodifier -b <XPath> bulkfile <XMLfile>
where <XPath> is the required XPath and <XMLfile> is the XML file name.
Node value
This command sets a node value.
The command is as follows:
For Windows:
XMLModifier.exe -s XPath newvalue <XMLfile>
For Linux:
xmlmodifier -s <XPath> newvalue <XMLfile>
where <XPath> is the required XPath and <XMLfile> is the XML file name.
For example,
xmlmodifier -s //filtering/URLFilter/@enabled <value> filtering.xml
Encrypt the password (using the AES 256-bit encryption method) and store in specified XPath location
This command encrypts the specified password using the AES 256-bit encryption method and stores it in the specified XPath location. However, only certain parameters support this encryption method in Symantec Protection Engine.
Parameters that require password encryption using the AES 256-bit method lists the parameters that are encrypted using this method.
The command is as follows:
For Windows:
XMLModifier.exe -k <XPath> <password> <SPE install directory> <XMLfile>
For Linux:
xmlmodifier -k <XPath> <password> <SPE install directory> <XMLfile>
where <XPath> is the required XPath, <password> is your password, <SPE install directory> is the path to the installation directory, and <XMLfile> is the XML file name.
Make sure the path to the Symantec Protection Engine installation directory does not end with
/
.
Query
This command returns the value of the node in the XML document with no newline.
The command is as follows:
For Windows:
XMLModifier.exe -q <XPath> <XMLfile>
For Linux:
xmlmodifier -q <XPath> <XMLfile>
where <XPath> is the required XPath and <XMLfile> is the XML file name.
Query list
This command returns the list of values of the node in the XML document with a newline. The l is lowercase, as in list.
The command is as follows:
For Windows:
XMLModifier.exe -l <Xpath> <XMLfile>
For Linux:
xmlmodifier -l <Xpath> <XMLfile>
where <XPath> is the required XPath and <XMLfile> is the XML file name.
Create a new entry in the RPC client list
This command adds a single network attached storage device in the RPC client list.
The command is as follows:
For Windows:
XMLModifier.exe -c //configuration/ProtocolSettings/RPC/ClientList/items <IP Address of RPC Client / NAS Device> configuration.xml
For Linux:
xmlmodifier -c //configuration/ProtocolSettings/RPC/ClientList/items <IP Address of RPC Client / NAS Device> configuration.xml
To list or remove the complete RPC client list, use the -l and -r option respectively.
XMLModifier.exe -l ​ //configuration/ProtocolSettings/RPC/ClientList/items​ ​configuration.xml
XMLModifier.exe -r ​ //configuration/ProtocolSettings/RPC/ClientList/items​ ​configuration.xml
Add local URL categories
This command adds local URL categories.
The command is as follows:
For Windows:
XMLModifier.exe -a <urlcategory1|urlcategory2|..>
For Linux:
xmlmodifier -a <urlcategory1|urlcategory2|..>
where <urlcategory> is the local URL category.
Delete local URL categories
This command deletes local URL categories.
The command is as follows:
For Windows:
XMLModifier.exe -d <urlcategory1|urlcategory2|..>
For Linux:
xmlmodifier -d <urlcategory1|urlcategory2|..>
where <urlcategory> is the local URL category.
Add URL(s) to local URL category
This command adds URL(s) to local URL category.
The command is as follows:
For Windows:
XMLModifier.exe -u <urlcategory|url1|url2|..>
For Linux:
xmlmodifier -u <urlcategory|url1|url2|..>
where <url> is the url to be added and <urlcategory> is the local URL category.
Delete URL(s) from local URL category
This command deletes URL(s) from the local URL category.
The command is as follows:
For Windows:
XMLModifier.exe -v <urlcategory|url1|url2|..>
For Linux:
xmlmodifier -v <urlcategory|url1|url2|..>
where <url> is the url to be deleted and <urlcategory> is the local URL category.
Add URL(s) to URL Override List
This command adds URL(s) to URL Override List
The command is as follows:
For Windows:
XMLModifier.exe -o <url1|url2|..>
For Linux:
xmlmodifier -o <url1|url2|..>
where <url> is the url to be added.
Delete URL(s) from URL Override List
This command deletes the URL(s) from the URL Override List.
The command is as follows:
For Windows:
XMLModifier.exe -i <url1|url2|..>
For Linux:
xmlmodifier -i <url1|url2|..>
where <url> is the url to be deleted.
Parameters that require password encryption using the AES 256-bit method
Parameter name
XPath
Configuration file name
Proxy Server Password
/configuration/ProxyServerSettings/Password/@value
configuration.xml
LiveUpdate Server Password
/liveupdate/UpdateServer/Password/@value
liveupdate.xml
The XMLModifier utility has a dependency on the libxml2 library. If this library is not found, the utility may throw an error. The libxml2 library is already present in the installation directory. However, if the XMLModifier utility is still unable to find the library on UNIX machines, you can add the path,
/opt/SYMCScan/bin
, to the LD_LIBRARY_PATH environment variable.