Apache configuration

Description

Modifications are made to the Apache configuration. The following files will be modified:

$WT_HOME/apacheConf/config/authResAdditions.xml
<APACHE_HOME>/conf/templates/webapp/webAppAJPConf.template

To propagate the settings in the above files, the PTC Ant script "applyApacheWebAppConfig.xml" is executed:

During the execution, the following files, among others, are regenerated:

<APACHE_HOME>/conf/app-Windchill-AuthRes.xml
<APACHE_HOME>/conf/app-Windchill-AuthProvider.xml
<APACHE_HOME>/conf/conf.d/30-app-Windchill-AJP.conf

Caution

The changes which were manually made to the above-stated files (and NOT to the corresponding source files) will be overwritten.

Linux

Windows

Windchill Shell

CODE

ant setup_apache_context

The Apache home directory is by default $WT_HOME/../HTTPServer/

If the Apache directory differs from the Windchill default, it has to be specified as well!

Windchill Shell

CODE

ant setup_apache_context -Dapachedir=<Apache-home directory>

Info

After the setup, the Apache web service must be restarted.

Windchill Shell

CODE

ant setup_apache_context

The Apache home directory is by default %WT_HOME%\..\HTTPServer\

If the Apache directory differs from the Windchill default, it has to be specified as well!

Windchill Shell

CODE

ant setup_apache_context -Dapachedir=<Apache-home directory>

Info

After the setup, the Apache web service must be restarted.

Detailed execution

In the file, $WT_HOME/apacheConf/config/authResAdditions.xml following entries are added to the <resources> section:
- <resource>faces</resource>
- <resource>servlet/innoJSBridge</resource>
The following changes are made in the file <Apache_Home>/conf/templates/webapp/webAppAJPCont.template:
- Following entry is added in the section IfModule: JkMount /@@WEB_APP_NAME@@/faces/* @@AJP_WORKER_NAME@@
- Following line will be changed (bold): ProxyPassMatch ^(/@@WEB_APP_NAME@@/((?i).*\.jsp(.*)|servlet/.*|(.*/)?j_security_check|.*\.jar|gwt(/.*)?/servlet/.*|ptc1/.*|app|app/.*|trustedAuth/.*|protocolAuth/.*|sslClientAuth/.*|wt\.properties|servicecenter/|servicecenter/lib/isomorphic/login/loginSuccessMarker\.html|faces/.*))$ balancer://@@AJP_WORKER_NAME@@$1 @@nocanon@@

In the file, %WT_HOME%/apacheConf/config/authResAdditions.xml following entries are added to the <resources> section:
- <resource>faces</resource>
- <resource>servlet/innoJSBridge</resource>
The following changes are made in the file <Apache_Home>/conf/templates/webapp/webAppAJPCont.template:
- Following entry is added in the section IfModule: JkMount /@@WEB_APP_NAME@@/faces/* @@AJP_WORKER_NAME@@
- Following line will be changed (bold): ProxyPassMatch ^(/@@WEB_APP_NAME@@/((?i).*\.jsp(.*)|servlet/.*|(.*/)?j_security_check|.*\.jar|gwt(/.*)?/servlet/.*|ptc1/.*|app|app/.*|trustedAuth/.*|protocolAuth/.*|sslClientAuth/.*|wt\.properties|servicecenter/|servicecenter/lib/isomorphic/login/loginSuccessMarker\.html|faces/.*))$ balancer://@@AJP_WORKER_NAME@@$1 @@nocanon@@

Known issues:

Linux

If the comand ant setup_apache_context fails with an error message like: "/opt/ptc/Windchill_12.0/Windchill/HTTPServer does not exist.", the parameter -Dapachedir is probably set incorrectly.

This should refer to the Apache root directory.

Windows

If the comand ant setup_apache_context fails with an error message like: "C:\PTC\Windchill_12.0\Windchill\HTTPServer does not exist.", the parameter -Dapachedir is probably set incorrectly.

This should refer to the Apache root directory.