Differences
This shows you the differences between two versions of the page.
Both sides previous revisionPrevious revisionNext revision | Previous revision | ||
79:configure_stages [2024/03/07 15:51] – [Configure the Stages server **Currently under rework**] Weinlein, Thomas | 79:configure_stages [2024/03/08 10:32] (current) – Weinlein, Thomas | ||
---|---|---|---|
Line 42: | Line 42: | ||
| '' | | '' | ||
| Basic configuration ||| | | Basic configuration ||| | ||
- | | '' | + | | '' |
by using variable replacement | by using variable replacement | ||
)) | | )) | | ||
Line 63: | Line 63: | ||
| '' | | '' | ||
| '' | | '' | ||
- | | [[#Configuring SSL Certificate|Certificates]] ||| | + | | [[#configuring-tlsssl-certificate|Certificates]] ||| |
| '' | | '' | ||
| [[kerberos_autologin|Kerberos SSO]] ||| | | [[kerberos_autologin|Kerberos SSO]] ||| | ||
Line 70: | Line 70: | ||
| '' | | '' | ||
| Metamodels and customisations ||| | | Metamodels and customisations ||| | ||
- | | ''' | + | | '' |
- | | ''' | + | | '' |
- | | ''' | + | | '' |
**Shareable** files can be shared between a test and a production server without modifications, | **Shareable** files can be shared between a test and a production server without modifications, | ||
Line 82: | Line 82: | ||
**Windows: | **Windows: | ||
- | In case of changes to the service configurations | ||
- | < | ||
- | $STAGES_ROOT\bin\reinstallService.bat | ||
- | </ | ||
- | always | ||
< | < | ||
net stop stages | net stop stages | ||
Line 125: | Line 120: | ||
<code xml> | <code xml> | ||
- | | + | < |
- | < | + | < |
- | [...] | + | [...] |
- | </ | + | </ |
</ | </ | ||
Line 143: | Line 138: | ||
<code xml> | <code xml> | ||
< | < | ||
- | < | + | |
</ | </ | ||
Line 152: | Line 147: | ||
==== Configuration of Stages Service Parameters ==== | ==== Configuration of Stages Service Parameters ==== | ||
- | For configuring Stages service please proceed as follows: | + | For configuring Stages service please proceed as follows. In this example the max heap memory is changed. |
* Windows: | * Windows: | ||
Line 179: | Line 174: | ||
The server.xml for new installations looks as follows: [[server.xml]] | The server.xml for new installations looks as follows: [[server.xml]] | ||
- | Stages is started on TCP/IP port 80, 443 and 8085 and enforces usage of HTTPS by default. Thus, it can be accessed via the URL [[https://< | + | Stages is started on TCP/IP port 80, 443 and 8085 and enforces usage of HTTPS by default. Thus, it can be accessed via the URL [[https://< |
When you try to access Stages via HTTP the client will be redirect to HTTPS instead. | When you try to access Stages via HTTP the client will be redirect to HTTPS instead. | ||
Line 186: | Line 181: | ||
<code xml> | <code xml> | ||
- | | + | < |
- | | + | |
- | | + | protocol=" |
- | | + | URIEncoding=" |
- | | + | maxHttpHeaderSize=" |
- | | + | maxThreads=" |
- | | + | minSpareThreads=" |
- | [...] | + | enableLookups=" |
- | | + | [...] |
+ | </ | ||
</ | </ | ||
Line 200: | Line 196: | ||
<code xml> | <code xml> | ||
- | | + | < |
- | | + | protocol=" |
- | | + | URIEncoding=" |
- | | + | maxHttpHeaderSize=" |
- | | + | maxThreads=" |
- | | + | minSpareThreads=" |
- | | + | enableLookups=" |
- | [...] | + | [...] |
- | | + | </ |
</ | </ | ||
Line 216: | Line 212: | ||
<code xml> | <code xml> | ||
- | | + | < |
- | | + | protocol=" |
- | | + | proxyName=" |
- | | + | proxyPort=" |
- | | + | secure=" |
- | | + | scheme=" |
- | | + | URIEncoding=" |
- | | + | maxHttpHeaderSize=" |
- | | + | maxThreads=" |
- | | + | minSpareThreads=" |
- | | + | enableLookups=" |
- | | + | acceptCount=" |
- | | + | connectionTimeout=" |
- | | + | disableUploadTimeout=" |
- | | + | address=" |
- | /> | + | /> |
</ | </ | ||
Line 241: | Line 237: | ||
In case you use a IPv6 only configuration please replace '' | In case you use a IPv6 only configuration please replace '' | ||
- | ==== Configuring SSL Certificate ==== | + | Further explanations of the connector attributes are available at [[https:// |
+ | |||
+ | ==== Configuring | ||
Stages comes with a self signed certificate for [[https:// | Stages comes with a self signed certificate for [[https:// | ||
- | Please store your PKCS keystore in '' | + | * Register a DNS alias for the server, e.g. “stages.company.com” |
+ | * Apply for a TLS/SSL certificate for the server which refers to the above alias. Depending on your local procedures, this might require creating a certificate request (e.g. see https:// | ||
+ | * Store your PKCS#12 (requires JDK 8u301 or newer) or JKS keystore | ||
'' | '' | ||
Line 257: | Line 257: | ||
</ | </ | ||
- | For more details on certificate generation please refer to [[certificate_generation]]. | + | [[# |
==== Configuration for usage with Reverse Proxy ==== | ==== Configuration for usage with Reverse Proxy ==== | ||
- | in case you want to terminate the SSL connection on a reverse proxy, you need to adapt the '' | + | in case you want to terminate the TSL connection on a reverse proxy ([[https:// |
E.g. | E.g. | ||
Line 279: | Line 278: | ||
| | ||
| | ||
- | proxyname=" | + | proxyName=" |
- | proxyport=" | + | proxyPort=" |
| | ||
> | > | ||
Line 332: | Line 331: | ||
set JAVA_OPTS=[...] -Djavax.net.ssl.trustStoreType=Windows-ROOT -Djavax.net.ssl.trustStore=NUL | set JAVA_OPTS=[...] -Djavax.net.ssl.trustStoreType=Windows-ROOT -Djavax.net.ssl.trustStore=NUL | ||
</ | </ | ||
- | This is the default for new installations of 7.9.14.0 | + | This is the default for new installations of Stages |
Linux: | Linux: | ||
Line 341: | Line 340: | ||
===== Licenses ===== | ===== Licenses ===== | ||
- | Stages is delivered with a temporary license that allows running Stages on any machine. Running Stages with a permanent license requires the Stages server machine to have a fixed IP address. To request a permanent license for running Stages on a specific server, please follow these steps: | + | Stages is delivered with a temporary license that allows running Stages on any machine. Running Stages with a permanent license requires the Stages server machine to have a fixed IP address. To request a permanent license for running Stages on a specific server, please follow these steps: |
+ | |||
+ | * Install Stages on the server | ||
+ | | ||
+ | | ||
+ | | ||
+ | * An email with all the necessary information will be opening | ||
+ | * Send the email to the Stages Customer Care team | ||
===== Local Message Customization ===== | ===== Local Message Customization ===== |