Differences

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

Link to this comparison view

Both sides previous revision Previous revision
Next revision
Previous revision
72:install [2019/04/10 10:39]
vtbr [Perform basic installation]
72:install [2019/12/12 12:21] (current)
Thomas Weinlein [Install Fonts]
Line 3: Line 3:
 ===== Perform basic installation ===== ===== Perform basic installation =====
  
-  * Download and install Java Development Kit 8 +  * 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+  * 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 Linux:   * Stages installation on Linux:
-      * Install RPM package+      * Install RPM package ​(will be sent to you by [[stages-support@methodpark.de?​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"​.       * 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:   * 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]].
       * Download Oracle JDBC connector for your Oracle version.       * Download Oracle JDBC connector for your Oracle version.
       * Copy JDBC connector to "<​stages installation path>/​stages/​lib"​ and rename it to "​ojdbc.jar"​.       * Copy JDBC connector to "<​stages installation path>/​stages/​lib"​ and rename it to "​ojdbc.jar"​.
-      * Get Oracle database dump and installation instructions from Stages Support. 
   * Database installation with MySQL5.7:   * Database installation with MySQL5.7:
 +      * Get MySQL database dump from [[stages-support@methodpark.de?​subject=Stages database dump - MySQL|Stages Support]].
       * Download MySQL JDBC connector (Connector/​J 5.1 Platform Independent) and installer for MySQL 5.7.       * 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.       * Copy JDBC connector to "<​stages installation path>/​stages/​lib"​ and rename the file mysql-connector-java-*-bin.jar to mysql.jar.
Line 43: Line 44:
 </​code>​ </​code>​
  
-  * MySQL: Create database "​stages"​ and import dump file (downloaded from [[https://​www.methodpark.de/​downloads/​stages/​mysql/​stages72_mysql57_content.zip|https://​www.methodpark.de/​downloads/​stages/​mysql/​stages72_mysql57_content.zip]] and unzip the file -or- customer specific dumpfile that has been sent to you). All commands need to be executed within path "<​MySQL installation path>/​bin":​+  * MySQL: Create database "​stages"​ and import dump file (unzip the file -or- customer specific dumpfile that has been sent to you). All commands need to be executed within path "<​MySQL installation path>/​bin":​
  
 <​code>​ <​code>​
 mysqladmin -uroot -p<​mysql-root-password>​ create stages mysqladmin -uroot -p<​mysql-root-password>​ create stages
-mysql -uroot -p<​mysql-root-password>​ stages <[PATH TO DUMP FILE\stages72_mysql57_content.sql]+mysql -uroot -p<​mysql-root-password>​ stages <[PATH TO DUMP FILE\stages7_mysql_content.sql]
 </​code>​ </​code>​
  
Line 76: Line 77:
       * 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 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"​+      ​* Unzip: "<​Stages installation path>​\stages\conf\model\unified_configuration.mm"​ to "<​Stages installation path>​\stages\conf\model\unified_configuration"​ 
 +      ​* Open file: " <Stages installation path>​\stages\conf\model\unified_configuration\diagram\trunk\configs\scriptconfig.js"​
       * 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\data-cache\generated\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
 +      * Execute: "<​Stages installation path>​\stages\bin\update.bat"
   * Linux:   * Linux:
-      * Open file: "<​Stages installation path>/​stages/​data-cache/​generated/​model/​unified_configuration/​diagram/​trunk/​configs/​scriptconfig.js"​ +      ​* Unzip: "<​Stages installation path>/​stages/​conf/​model/​unified_configuration.mm"​ to "<​Stages installation path>/​stages/​conf/​model/​unified_configuration"​ 
-      * Adjust the following setting according to the font to be used: \\ //var FONTNAME = "Arial Unicode MS"; \\ +      ​* Open file: "<​Stages installation path>/​stages/​conf/​model/​unified_configuration/​diagram/​trunk/​configs/​scriptconfig.js"​ 
-   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/​conf/​model/​unified_configuration/​diagram/​trunk/​configs/​scriptconfig-bpmn_classic.js
 +      * Execute: "<​Stages installation path>/​stages/​bin/​update"
  
 __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 151: Line 156:
       * 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 =====
Line 168: Line 174:
   * 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).   * 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)   * 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 Tomcat to use this SSL certificate (see link above for more info). The relevant Tomcat config file is located in ''​conf/​server.xml'' ​ ​and ​the SSL info needs to be configured for each ''<​Connector>'' ​ section. After updating the config file, run ''​bin/update.sh''  ​or ''​bin\update.bat''  ​to install it at the correct location. 
-  * Configure a redirect from ports 80 and/​or ​8080 to the SSL port (typically 443 or 8443)+  * To enforce redirection from http to https add the following to ''​conf/​web-customer.xml''​. This needs a Stages Version > 7.4.2.0. 
 + 
 +<​code>​ 
 +<​security-constraint>​ 
 +    <​display-name>​Enforce HTTPS</​display-name>​ 
 +    <​web-resource-collection>​ 
 +        <​web-resource-name>​stages-public</​web-resource-name>​ 
 +    </​web-resource-collection>​ 
 +    <​user-data-constraint>​ 
 +        <​description>​Force ​SSL for all connections.</​description>​ 
 +        <​transport-guarantee>​CONFIDENTIAL</​transport-guarantee>​ 
 +    </​user-data-constraint>​ 
 +</​security-constraint>​ 
 +</​code>​ 
  
 ===== Accessing Stages ===== ===== Accessing Stages =====
  
-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)+After successful installation process - Stages is accessible via web browser by URL [[https://​localhost:​8443|https://​localhost:​8443]] or [[http://​localhost:8080|http://​localhost:8080]] (depending on the SSL port)