Differences

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

--- 72:install [2020/04/03 12:07] – [(Optional) Secure MySQL connection with SSL] nswt
+++ 72:install [2024/02/15 00:00] (current) – external edit 127.0.0.1
@@ Line 4: / Line 4: @@
   * Download and install Java Development Kit 8 (see [[:73:system_requirements|System Requirements]] for supported variants)
-  * Stages installation on Windows: Execute Stages installer as administrator (will be sent to you by [[stages-support@methodpark.de?subject=Stages installation package - Windows|Stages Support]])
+  * Stages installation on Windows: Execute Stages installer as administrator (will be sent to you by [[stages-support@ul.com?subject=Stages installation package - Windows|Stages Support]])
   * Stages installation on Linux:
-      * Install RPM package (will be sent to you by [[stages-support@methodpark.de?subject=Stages installation package - Linux|Stages Support]])
+      * Install RPM package (will be sent to you by [[stages-support@ul.com?subject=Stages installation package - Linux|Stages Support]])
       * A user with the name "stages" is needed to allow the command "stages start" to automatically start the Stages search engine. The user needs recursive read and execute permissions on the sub-direcory "elasticsearch" and additionally write permissions on "elasticsearch/data" and "elasticsearch/logs".
   * Database installation with Oracle 11g or 12c:
-      * Get Oracle database dump and installation instructions from [[stages-support@methodpark.de?subject=Stages database dump - Oracle|Stages Support]].
+      * Get Oracle database dump and installation instructions from [[stages-support@ul.com?subject=Stages database dump - Oracle|Stages Support]].
       * Download Oracle JDBC connector for your Oracle version.
       * Copy JDBC connector to "<stages installation path>/stages/lib" and rename it to "ojdbc.jar".
   * Database installation with MySQL5.7:
-      * Get MySQL database dump from [[stages-support@methodpark.de?subject=Stages database dump - MySQL|Stages Support]].
+      * Get MySQL database dump from [[stages-support@ul.com?subject=Stages database dump - MySQL|Stages Support]].
       * Download MySQL JDBC connector (Connector/J 5.1 Platform Independent) and installer for MySQL 5.7.
       * Copy JDBC connector to "<stages installation path>/stages/lib" and rename the file mysql-connector-java-*-bin.jar to mysql.jar.
@@ Line 81: / Line 81: @@
       * Windows: Start the services "Stages Search" and then "Stages"
       * Linux: Execute "stages start"
 ===== (Optional) Secure MySQL connection with SSL =====
@@ Line 94: / Line 95: @@
 </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>
-&clientCertificateKeyStoreUrl=file:/opt/stages/conf/truststore&clientCertificateKeyStorePassword=mypassword
+&clientCertificateKeyStoreUrl=file:/opt/stages/conf/truststore&&useSSL=trueclientCertificateKeyStorePassword=mypassword
 </code>
-  - The complete JDBC url should now look similar like this:
+  * The complete JDBC url should now look similar like this:
 <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>
 ===== Configure Virus Scanner =====
@@ Line 127: / Line 127: @@
   * Windows:
       * Open file "<Stages installation path>\stages\config.bat"
-      * Modify the red colored setting: //set TOMCAT_OPTS=–JvmMx=<font inherit/inherit;;#c0392b;;inherit><RAM in MB></font>//
+      * Modify the red colored setting: //set TOMCAT_OPTS=–JvmMx=<RAM in MB>//
       * Open a cmd with administrative permissions and navigate to folder "<Stages installation path>\stages\bin"
       * Reinstall the Stages service: **reinstallService.bat**
@@ Line 133: / Line 133: @@
   * Linux:
       * Open file "<Stages installation path>/stages/bin/rc.conf"
-      * 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<RAM in MB>m -XX:+UseG1GC -XX_-OmitStackTraceInFastThrow"//
       * 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) =====
@@ Line 164: / Line 178: @@
       * 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) [STAGES 7.4.4.4 and earlier]:__
   * Windows:
       * Unzip: "<Stages installation path>\stages\conf\model\unified_configuration.mm" to "<Stages installation path>\stages\conf\model\unified_configuration"
@@ Line 170: / Line 184: @@
       * 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"
+      * 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"
   * Linux:
@@ Line 177: / Line 192: @@
    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"
+      * 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"
+**Caution**//: //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) [STAGES 7.4.4.5 and newer]:__
+  * 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:__
@@ Line 186: / Line 210: @@
       * 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"/>//
 ===== Install Stages license =====