How to Change the Webapp Name of an Existing Windchill Installation.

说明

The article describes how to change the webapp name for an existing Windchill installation. Following webapp names were used throughout this article:

Old webapp name: Windchill
New webapp name: wind

Please see “Additional Information” section for detailed instruction.

解决方案

Please see “Additional Information”

附加信息

Step 1: Go to "<Apache_Load_Point>\conf" folder, create a duplicate of “app-Windchill.properties” file and rename it to “app-wind.properties”

Step 2: Create a duplicate of “app-Windchill-AuthRes.xml” file and rename it to “app-wind-AuthRes.xml”

Note: If you have Apache 2.2 installed then these files will be located under "<Apache_Load_Point>\conf\extra" folder. Also for Apache 2.2 you have to rename one extra file called "app-Windchill-AuthProvider.xml" to "app-wind-AuthProvider.xml".

Step 3: Open a Windchill shell, browser to <Apache_Load_Point> then execute:

 ant -f webAppConfig.xml regenWebAppConf -DappName=wind

 
Step 4: Go to "<Apache_Load_Point>\conf" folder (for Apache 2.2 go to "<Apache_Load_Point>\conf\extra" folder), open the “additions.conf” in a text editor and remove or comment out the “Include conf/app-Windchill.conf” line

Step 5: Go to <Tomcat_Load_Point>\conf\Catalina\localhost folder and rename the “app-Windchill.xml” file to “app-wind.xml”

Note: In Windchill 9.0 the name of "app-Windchill.xml" file has changed to "Windchill.xml", so if you have Windchill 9.0 installed then rename “Windchill.xml” file to “wind.xml”

Step 6: Open the “app-wind.xml” file (for Windchill 9.0 open "wind.xml") in a text editor and change the "path" attribute from "/Windchill" to "/wind". For example:

 <?xml version="1.0" encoding="UTF-8"?>
 <Context path="/wind" docBase="C:\ptc\Windchill\codebase" debug="0" 
 ; reloadable="false">
  <Resources className="com.ptc.tomcat4.WebAppWithDocBaseDirContext"/>
  <Loader className="com.ptc.tomcat4.WebAppWithDocBaseLoader"
          loaderClass="com.ptc.tomcat4.ExtendedWebAppClassLoader"/>
  <Logger className="org.apache.catalina.logger.FileLogger"
          prefix="localhost_wind_log." suffix=".txt"
          timestamp="true"/>
 </Context>

 
Step 7: Clear the Tomcat cache and start Apache and Tomcat. Logon to the Info*Engine Administrator Page; if your host name is “example.com” then the URL for the Info*Engine Administrator Page will be: http://example.com/wind/infoengine/jsp/admin/index.jsp

Step 8: Click on the service name that ends with “.servlet” (i.e. “com.example.servlet”), this will bring up the Property Editor page for this particular service. Go to the “General Properties” section and change the value of “Task Prefix” property to to “/wind/servlet/IE/tasks” from “/Windchill/servlet/IE/tasks”

Step 8b: Change the web app path in WEB-INF/web.xml. See https://www.ptc.com/appserver/cs/view/solution.jsp?n=kA1F00000000RHi

Step 9: Using xconfmanager set “wt.webapp.name=wind”

Step 10: Stop Apache and Tomcat and clear the Tomcat cache again. Start Apache, Tomcat and Method Server(s) then access Windchill using the new webapp name.