Post-Update Actions
Complete the instructions in the following sections after the update has completed;
• Reimporting the SSL Certificate
• Run the Update Tool
• Migrating Project Templates
• Migrating Program Templates
• Migrating Templates for Windchill Risk and Reliability
• Updating the HTTP Server configuration files
|
|
For a clustered installation, revert your cluster to a single system before following these instructions. For detailed instructions on reverting a cluster, see Reverting a Cluster to a Single System. |
Reimporting the SSL Certificate
If your site uses HTTPS, see the Windchill Installation and Configuration Guide in the section Completing Configurations — Manual Steps > Configuring HTTPS for Apache and Windchill to reimport the certificate of authority into the jssecacerts file after you update your solution.
Running the Update Tool
The update tool should be run after either adding or updating a product to an existing install. For example, in the following scenarios:
• After completing an update to an existing installation using the Windchill Service Pack option (such as a maintenance release update).
• After completing a non-PSI sub-installer addition to your Windchill installation.
• After completing an update to an existing installation using the PSI for a standalone component, such as visualization.
• If there are problems with your Windchill installation after an update, such as the method server failing to start, or tables missing from your database schema.
|
|
The PTC HTTP Server, Windchill Directory Server and Database should be up and running before running the Update tool.
|
To execute the update tool:
• Windows
Update_Tool.bat -username <username> -password <password> -noui
• UNIX
Update_Tool.sh -username <username> -password <password> -noui
When you see the message "Marking phase Load New Data as completed in the database", then the update tool has successfully completed.
Migrating Program Templates
|
|
The method server must be running when executing the following commands.
|
Choose from the following commands to migrate the program templates that you want to use with Enhanced Project Planning.
• To migrate all available program templates in your Windchill system, run the following command:
java com.ptc.projectmanagement.project.utils.MigrateProjectTemplateUtility ALL=true PROGRAM=true
• To migrate all program templates from a specific organization, run the following command:
java com.ptc.projectmanagement.project.utils.MigrateProjectTemplateUtility ORG=”<organization>” PROGRAM=true
where <organization> is the organization name.
• To migrate a specific program template from a specific organization, run the following command:
java com.ptc.projectmanagement.project.utils.MigrateProjectTemplateUtility TEMPLATE=”<templateA>” ORG=”<organization>” PROGRAM=true
where <templateA> is the template name, and<organization> is the organization name.
• To migrate specific program templates from any context, run the following command:
java com.ptc.projectmanagement.project.utils.MigrateProjectTemplateUtility TEMPLATE=”<templateA>, <templateB>” PROGRAM=true
where <templateA> and <templateB> are the template names.
Migrating Templates for Windchill Risk and Reliability
Choose from the following commands to migrate the program templates that you want to use when updating an existing Windchill CAPA context to include Windchill Nonconformance NC Roles and NC Access Rules:
• To load the NC Team roles:
windchill wt.load.LoadFromFile -d <Windchill>\loadFiles\nc\NCTeamRole.xml -u wcadmin -p wcadmin -CONT_PATH \"/wt.inf.container.OrgContainer=Demo Organization/wt.inf.library.WTLibrary=myQMS-1\"
where <Demo Organization> is the organization name and <myQMS-1> is the context name that needs to be updated.
• To load the NC Access rules:
windchill wt.load.LoadFromFile -d <Windchill>\loadXMLFiles\nc\NC_ACLRules.xml -u wcadmin -p wcadmin -CONT_PATH \"/wt.inf.container.OrgContainer=Demo Organization/wt.inf.library.WTLibrary=myQMS-1\"
where <Demo Organization> is the organization name and <myQMS-1> is the context name that needs to be updated.
• To update Windchill CAPA team roles:
• windchill wt.load.LoadFromFile -d <Windchill>\loadFiles\capa\ CAPATeamRole.xml -u wcadmin -p wcadmin -CONT_PATH \"/wt.inf.container.OrgContainer=Demo Organization/wt.inf.library.WTLibrary=myQMS-1\"
where <Demo Organization> is the organization name and <myQMS-1> is the context name that needs to be updated.
• To update Windchill CAPA Access rules:
• windchill wt.load.LoadFromFile -d <Windchill>\loadXMLFiles\capa\ CAPA_ACLRules.xml -u wcadmin -p wcadmin -CONT_PATH \"/wt.inf.container.OrgContainer=Demo Organization/wt.inf.library.WTLibrary=myQMS-1\"
• where <Demo Organization> is the organization name and <myQMS-1> is the context name that needs to be updated.
Updating the HTTP Server configuration files
If you have opted to preserve your web configurations in
Define Settings, then you need to compare the contents delivered by the latest
CD_CAPPS to be able to merge the updates in the new CD. For more information, see
Defining Settings.
PTC may have updated some configurations which should reflect in the WebApps deployed in Apache HTTPServer. Perform the following steps for the updates to take effect:
1. Regenerate Windchill WebApps
a. Open a Windchill shell environment or command prompt with Ant executable in your path.
b. Go to <PSI Install Dir>/<HTTPServer InstallDir>.
c. Execute the command —
▪ If you need to update only one of the deployed WebApps:
ant -f webAppConfig.xml regenWebApp -DappName=<WebAppName>
For example, if the WebAppName is Windchill that needs to be updated, use the command:
ant -f webAppConfig.xml regenWebApp -DappName=Windchill
▪ If you need to update all the deployed WebApps, use the command:
ant -f webAppConfig.xml regenAllWebApps
2. Update MIME type for WebAssembly
Copy <PSI Install Dir>/<HTTPServer InstallDir>/conf-BACKUP/mime.types to <PSI Install Dir>/<HTTPServer InstallDir>/conf
(Overwrite the existing file <HTTPServer InstallDir>/conf/mime.types)
Applying Maintenance Release Special Instructions
See the
Windchill Read This First for any additional instructions applicable for the maintenance release to which you are updating. You can download the latest
Windchill Read This First for your maintenance release at the following location on the PTC Web site:
https://www.ptc.com/en/support/refdocThis URL directs you to the PTC Online Support Web page for reference documents. For your document search criteria, select your product from the Product drop-down list, select the current release from the Release drop-down list, select Read This First from the Document Type drop-down list, and select Administrator from the User Role drop-down list.
