PTC Script for Working with Customized Files
PTC provides the swmaint.xml Ant script to help you manage the files in the <Windchill>/wtSafeArea/siteMod directory. The swmaint.xml script is installed in the <Windchill>/bin directory during Windchill Services installation.
To obtain a list of all swmaint.xml script target options, enter the following ant command from a Windchill shell:
ant -f bin/swmaint.xml -projecthelp
Following is a list of the most common target options:
• createSafeArea -- creates the <Windchill>/wtSafeArea/siteMod, <Windchill>/wtSafeArea/ptcCurrent, and <Windchill>/wtSafeArea/ptcOrig directories.
• listSiteChanges -- lists the files in the siteMod directory.
• installSiteChanges -- copies the files under the <Windchill>/wtSafeArea/siteMod directories to their corresponding <Windchill> installation directories. The timestamps on files from the siteMod directory are preserved when the copying is done.
There are a few files and directories that could be present under wtSafeArea/siteMod but are not copied. For example, the files under the following wtSafeArea/siteMod directory structures are not copied to installation directories:
.xconf-backup
installer
logs
codebase/instreg
tasks/codebase
temp
vaults
wtCustom
wtSafeArea
 |
Most of these directories contain files that you should never modify; therefore, the directories should not be in the wtSafeArea/siteMod directory. If you happen to have files in any of these directories, the target reports that the files were not copied.
|
The following files in the wtSafeArea/siteMod directory structure are also not copied to installation directories:
bin/swmaint.xml
codebase/.xconf-target-file-hints
declarations.xconf
site.xconf
For an up-to-date list of files and directory structures excluded when the installSiteChanges target option is processed, see the output from the listSiteModExclusions target option (described next).
• listSiteModExclusions -- lists the files and directory tree structure patterns of those files and directories that are excluded when the installSiteChanges target option is processed.
• listSiteChangesIgnored -- lists the files under the <Windchill>/wtSafeArea/siteMod directory that are not copied to corresponding <Windchill> installation directories when you run installSiteChanges. This target option is also run when you run the swmaint.xml script with the listSiteModExclusions target option.
• MakeJar.xml -- a script to build JAR files and maintain a network of definition files for building jar files. For more information see Managing Client JAR Files.
Executing the swmaint.xml script is always done from an ant command. For example, from a Windchill shell, execute the following ant command to copy the siteMod files to their executable location:
ant -f bin/swmaint.xml installSiteChanges
Parent topic