Stages Documentation

Differences

This shows you the differences between two versions of the page.

Link to this comparison view

Both sides previous revisionPrevious revision
Next revision		Previous revision
Next revisionBoth sides next revision
72:install [2019/01/28 15:33] – [Perform basic installation] alz72:install [2019/04/10 10:34] – [Perform basic installation] vtbr
Line 69: Line 69:
 </code> </code>
  
 +  * If you are updating from another version, check the release notes for any additional mandatory manual upgrade steps
   * Activate the configuration   * Activate the configuration
       * Windows Start Menu: Execute "Programs > Method Park > Stages > Update Configuration"       * Windows Start Menu: Execute "Programs > Method Park > Stages > Update Configuration"
Line 103: Line 104:
       * Modify the red colored value: //CONF_TOMCAT_OPTS="-Xmx<font inherit/inherit;;#c0392b;;inherit><RAM in MB></font>m -XX:+UseG1GC -XX_-OmitStackTraceInFastThrow"//       * Modify the red colored value: //CONF_TOMCAT_OPTS="-Xmx<font inherit/inherit;;#c0392b;;inherit><RAM in MB></font>m -XX:+UseG1GC -XX_-OmitStackTraceInFastThrow"//
       * Restart the Stages service:** stages restart**       * Restart the Stages service:** stages restart**
- 
  
 ===== Install customer specific metamodel (if available) ===== ===== Install customer specific metamodel (if available) =====
Line 122: Line 122:
       * Restart the Stages service: **stages start**       * Restart the Stages service: **stages start**
  
-===== Installing Fonts =====+===== Install Fonts =====
  
 If you want to work with international UTF-8 charsets (e.g. Chinese), we suggest to install and configure Stages to use dedicated fonts: If you want to work with international UTF-8 charsets (e.g. Chinese), we suggest to install and configure Stages to use dedicated fonts:
Line 134: Line 134:
  
 __Configuring font for Stages process visualizations (metamodel: Unified Configuration):__ __Configuring font for Stages process visualizations (metamodel: Unified Configuration):__
- 
   * Windows:   * Windows:
       * Open file: " <Stages installation path>\stages\data-cache\generated\model\unified_configuration\diagram\trunk\configs\scriptconfig.js"       * Open file: " <Stages installation path>\stages\data-cache\generated\model\unified_configuration\diagram\trunk\configs\scriptconfig.js"
Line 141: Line 140:
   * Linux:   * Linux:
       * Open file: "<Stages installation path>/stages/data-cache/generated/model/unified_configuration/diagram/trunk/configs/scriptconfig.js"       * Open file: "<Stages installation path>/stages/data-cache/generated/model/unified_configuration/diagram/trunk/configs/scriptconfig.js"
-      * Adjust the following setting according to the font to be used: \\ //var FONTNAME = "Arial Unicode MS"; \\ var FONTNAME = "DejaVu Sans Condensed";//+      * Adjust the following setting according to the font to be used: \\ //var FONTNAME = "Arial Unicode MS"; \\ 
 +   var FONTNAME = "DejaVu Sans Condensed";//
       * Repeat this step for file: "<Stages installation path>/stages/data-cache/generated/model/unified_configuration/diagram/trunk/configs/scriptconfig-bpmn_classic.js"       * Repeat this step for file: "<Stages installation path>/stages/data-cache/generated/model/unified_configuration/diagram/trunk/configs/scriptconfig-bpmn_classic.js"
  
 __Configuring font for Stages PDF printing:__ __Configuring font for Stages PDF printing:__
- 
   * Windows:   * Windows:
       * Open file: "<Stages installation path>\stages\conf\config.xml"       * Open file: "<Stages installation path>\stages\conf\config.xml"
Line 153: Line 152:
       * Adjust the following property: //<property name="pdf.font.list" value="/usr/share/fonts/TTF/arialuni.ttf"/>//       * Adjust the following property: //<property name="pdf.font.list" value="/usr/share/fonts/TTF/arialuni.ttf"/>//
  
- +===== Install Stages license =====
-===== Installing Stages license =====+
  
   * Windows:   * Windows:
Line 162: Line 160:
       * Extract the .tar.gz archive to folder "<Stages installation path>/stages/conf".       * Extract the .tar.gz archive to folder "<Stages installation path>/stages/conf".
       * Restart the Stages service:** stages restart**       * Restart the Stages service:** stages restart**
 +
 +===== Configure SSL =====
 +
 +To encrypt all connections between the users and Stages, we strongly recommend to configure SSL for the Stages server.
 +
 +  * Ask for a DNS alias for the server, e.g. "stages.company.com"
 +  * Ask for a SSL certificate for the server which refers to the above alias. Depending on your local procedures, this might require creating a certificate request (see [[https://www.digicert.com/csr-ssl-installation/tomcat-keytool.htm|https://www.digicert.com/csr-ssl-installation/tomcat-keytool.htm]] for more info).
 +  * Import the SSL certificate into a keystore (see link above for more info)
 +  * Configure Tomcat to use this SSL certificate (see link above for more info)
 +  * Configure a redirect from ports 80 and/or 8080 to the SSL port (typically 443 or 8443)
  
 ===== Accessing Stages ===== ===== Accessing Stages =====
  
-After successful installation process - Stages is accessible via web browser by URL: [[http://localhost:8080|http://localhost:8080]]+After successful installation process - Stages is accessible via web browser by URL [[https://localhost:8443|https://localhost:8443]] or [[https://localhost|https://localhost]] (depending on the SSL port)