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/03/26 15:20] – emr
Line 75: Line 75:
       * Windows: Start the services "Stages Search" and then "Stages"       * Windows: Start the services "Stages Search" and then "Stages"
       * Linux: Execute "stages start"       * Linux: Execute "stages start"
- 
  
 ===== Configure Virus Scanner ===== ===== Configure Virus Scanner =====
Line 103: Line 102:
       * 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 120:
       * 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 132:
  
 __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 138:
   * 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 150:
       * 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 158:
       * 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)