PTC Script for Working with Customized Files
PTC provides the insSafeArea.xml Ant script to help you manage the files in the InS_SW/wtSafeArea/siteMod directory. The insSafeArea.xml script is installed in the InS_SW/SW directory during PTC Arbortext Content Delivery installation.
To obtain a list of all insSafeArea.xml script target options, enter the following ant command from a Windchill shell: ant -f SW/insSafeArea.xml -projecthelp
Following is a list of the most common target options:
• createSafeArea creates the InS_SW/wtSafeArea/siteMod, InS_SW/wtSafeArea/ptcCurrent, and InS_SW/wtSafeArea/ptcOrig directories.
• listSiteChanges lists the files in the siteMod directory.
• installSiteChanges copies the files under the InS_SW/wtSafeArea/siteMod directories to their corresponding actual 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
• 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.
• 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 InS_SW/wtSafeArea/siteMod directory that are not copied to corresponding <ACD> installation directories when you run installSiteChanges. This target option is also run when you run the insSafeArea.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.
Executing the the insSafeArea.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 SW/SafeArea.xml installSiteChanges