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 [2020/04/03 12:06] – [(Optional) Secure MySQL connection with SSL] nswt72:install [2020/05/18 05:58] – [Adjust Java Heap Space] cnmy
Line 86: Line 86:
 If you want to secure your MySQL connection with SSL you need to provide the server certificate to the MySQL driver. To do this follow these steps: If you want to secure your MySQL connection with SSL you need to provide the server certificate to the MySQL driver. To do this follow these steps:
  
-  - Copy the server certificate pem file into the stages conf folder +  * Copy the server certificate pem file into the stages conf folder 
-  - Create a Java trust store based on the MySQL server certificate:+  * Create a Java trust store based on the MySQL server certificate:
  
 <code> <code>
Line 93: Line 93:
  
 </code> </code>
-  - Change the database.properties and append the following to your JDBC url:+ 
 +  * Change the database.properties and append the following to your JDBC url:
  
 <code> <code>
-&clientCertificateKeyStoreUrl=file:/opt/stages/conf/truststore&clientCertificateKeyStorePassword=mypassword+&clientCertificateKeyStoreUrl=file:/opt/stages/conf/truststore&&useSSL=trueclientCertificateKeyStorePassword=mypassword
  
 </code> </code>
-  - The complete JDBC url should now look similar like this:+ 
 +  * The complete JDBC url should now look similar like this:
  
 <code> <code>
-torque.database.default.url = jdbc:mysql://localhost:3306/stages?zeroDateTimeBehavior=round&jdbcCompliantTruncation=false&clientCertificateKeyStoreUrl=file:/opt/stages/conf/truststore&clientCertificateKeyStorePassword=mypassword+torque.database.default.url = jdbc:mysql://localhost:3306/stages?zeroDateTimeBehavior=round&jdbcCompliantTruncation=false&useSSL=true&clientCertificateKeyStoreUrl=file:/opt/stages/conf/truststore&clientCertificateKeyStorePassword=mypassword
  
 </code> </code>
- 
  
 ===== Configure Virus Scanner ===== ===== Configure Virus Scanner =====
Line 133: Line 134:
       * 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**
 +
 +=== Search engine memory ===
 +
 +Depending on the size of your database it can be necessary to adjust the memory settings of the search engine. To do that open the file "<Stages installation path>elasticsearch/config/jvm.options".
 +
 +Adjust the lines<code>
 +
 +-Xms1g
 +-Xmx1g
 +
 +</code>
 +
 +After that restart the Stages search service.
 +
  
 ===== Install customer specific metamodel (if available) ===== ===== Install customer specific metamodel (if available) =====
Line 162: Line 177:
       * PDF Print: **Arial Unicode MS**  (subject to add. license conditions)       * PDF Print: **Arial Unicode MS**  (subject to add. license conditions)
  
-__Configuring font for Stages process visualizations (metamodel: Unified Configuration):__+__Configuring font for Stages process visualizations (metamodel: Unified Configuration) [<font inherit/inherit;;#e67e22;;inherit>STAGES 7.4.4.4 and earlier</font>]:__
   * Windows:   * Windows:
       * Unzip: "<Stages installation path>\stages\conf\model\unified_configuration.mm" to "<Stages installation path>\stages\conf\model\unified_configuration"       * Unzip: "<Stages installation path>\stages\conf\model\unified_configuration.mm" to "<Stages installation path>\stages\conf\model\unified_configuration"
Line 168: Line 183:
       * Adjust the following setting: //var FONTNAME = "Arial Unicode MS";//       * Adjust the following setting: //var FONTNAME = "Arial Unicode MS";//
       * Repeat this step for file: " <Stages installation path>\stages\conf\model\unified_configuration\diagram\trunk\configs\scriptconfig-bpmn_classic.js"       * Repeat this step for file: " <Stages installation path>\stages\conf\model\unified_configuration\diagram\trunk\configs\scriptconfig-bpmn_classic.js"
 +      * Add the diagram.font.list property to your config.xml file in the following way: <property name=“diagram.font.list” value=“Arial Unicode MS:/destinationOfYourFontFile/arialuni.ttf”/>
       * Execute: "<Stages installation path>\stages\bin\update.bat"       * Execute: "<Stages installation path>\stages\bin\update.bat"
   * Linux:   * Linux:
Line 175: Line 191:
    var FONTNAME = "DejaVu Sans Condensed";//    var FONTNAME = "DejaVu Sans Condensed";//
       * Repeat this step for file: "<Stages installation path>/stages/conf/model/unified_configuration/diagram/trunk/configs/scriptconfig-bpmn_classic.js"       * Repeat this step for file: "<Stages installation path>/stages/conf/model/unified_configuration/diagram/trunk/configs/scriptconfig-bpmn_classic.js"
 +      * Add the diagram.font.list property to your config.xml file in the following way: <property name=“diagram.font.list” value=“DejaVu Sans Condensed:/destinationOfYourFontFile/arialuni.ttf”/>
       * Execute: "<Stages installation path>/stages/bin/update"       * Execute: "<Stages installation path>/stages/bin/update"
 +
 +<font inherit/inherit;;#e67e22;;inherit>**Caution**</font>//: //If Stages doesn't recognize your font via the config.xml, please additionally set the JVM parameter to the path of your fonts folder: -Dsun.java2d.fontpath=“c:/yourownfolder”.
 +
 +__Configuring font for Stages process visualizations (metamodel: Unified Configuration) [<font inherit/inherit;;#e67e22;;inherit>STAGES 7.4.4.5 and newer</font>]:__
 +  * Make sure the scriptconfig.js in your metamodel is up to date and contains var FONTNAME = availableFontFamilies.getConfiguredFont();
 +  * Place the custom font in your conf/fonts folder
 +  * Add the diagram.font property to your config.xml file in the following way: <property name=“diagram.font” value=“DejaVu Sans Condensed:DejaVuSansCondensed.ttf”/>
 +  * Execute: "<Stages installation path>/stages/bin/update"
  
 __Configuring font for Stages PDF printing:__ __Configuring font for Stages PDF printing:__
Line 184: Line 209:
       * Open file: "<Stages installation path>/stages/conf/config.xml"       * Open file: "<Stages installation path>/stages/conf/config.xml"
       * 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 ===== ===== Install Stages license =====