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

The following file is added:

<APACHE_HOME>/conf/conf.d/90-app-IFConnex-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 $WT_HOME/apacheConf/config/authResAdditions.xml file, the following entries are added to the <resources> section:
- <resource>faces</resource>
- <resource>servlet/innoJSBridge</resource>
In the <Apache_Home>/conf/templates/webapp/webAppAJPCont.template file, the following changes are made:
- In the IfModule section, the following entry is added: JkMount /@@WEB_APP_NAME@@/faces/* @@AJP_WORKER_NAME@@
- The following line is 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 %WT_HOME%/apacheConf/config/authResAdditions.xml file, the following entries are added to the <resources> section:
- <resource>faces</resource>
- <resource>servlet/innoJSBridge</resource>
In the <Apache_Home>/conf/templates/webapp/webAppAJPCont.template file, the following changes are made:
- In the IfModule section, the following entry is added: JkMount /@@WEB_APP_NAME@@/faces/* @@AJP_WORKER_NAME@@
- The following line is 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 command ant setup_apache_context fails, with an error message like: "/opt/ptc/Windchill_12.0/Windchill/HTTPServer does not exist.", the -Dapachedir parameter is probably set incorrectly.
This should refer to the Apache root directory.

Windows

If the command ant setup_apache_context fails, with an error message like: "C:\PTC\Windchill_12.0\Windchill\HTTPServer does not exist.", the -Dapachedir parameter is probably set incorrectly.
This should refer to the Apache root directory.