Skip to main content
Skip table of contents

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

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.


JavaScript errors detected

Please note, these errors can depend on your browser setup.

If this problem persists, please contact our support.