Differences
This shows you the differences between two versions of the page.
Both sides previous revisionPrevious revisionNext revision | Previous revisionLast revisionBoth sides next revision | ||
72:install [2019/04/10 10:39] – [Perform basic installation] vtbr | 72:install [2022/05/02 12:50] – [Perform basic installation] alz | ||
---|---|---|---|
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 [[: |
- | * Stages installation on Windows: Execute Stages installer as administrator | + | * Stages installation on Windows: Execute Stages installer as administrator |
* Stages installation on Linux: | * Stages installation on Linux: | ||
- | * Install RPM package | + | * Install RPM package |
* A user with the name " | * A user with the name " | ||
* Database installation with Oracle 11g or 12c: | * Database installation with Oracle 11g or 12c: | ||
+ | * Get Oracle database dump and installation instructions from [[stages-support@ul.com? | ||
* Download Oracle JDBC connector for your Oracle version. | * Download Oracle JDBC connector for your Oracle version. | ||
* Copy JDBC connector to "< | * Copy JDBC connector to "< | ||
- | * 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@ul.com? | ||
* Download MySQL JDBC connector (Connector/ | * Download MySQL JDBC connector (Connector/ | ||
* Copy JDBC connector to "< | * Copy JDBC connector to "< | ||
Line 18: | Line 19: | ||
* Select Setup Type " | * Select Setup Type " | ||
* Install MySQL with Config Type " | * Install MySQL with Config Type " | ||
- | * Adapt/check the following properties within " | + | * Adapt/check the following properties within " |
- | < | ||
[mysql] | [mysql] | ||
default-character-set=utf8 | default-character-set=utf8 | ||
Line 30: | Line 30: | ||
lower_case_table_names=1 | lower_case_table_names=1 | ||
sql-mode = " | sql-mode = " | ||
+ | |||
</ | </ | ||
Line 41: | Line 42: | ||
flush privileges; | flush privileges; | ||
exit; | exit; | ||
+ | |||
</ | </ | ||
- | * MySQL: Create database " | + | * MySQL: Create database " |
< | < | ||
mysqladmin -uroot -p< | mysqladmin -uroot -p< | ||
- | mysql -uroot -p< | + | mysql -uroot -p< |
</ | </ | ||
Line 57: | Line 60: | ||
torque.database.default.username = stages | torque.database.default.username = stages | ||
torque.database.default.password = < | torque.database.default.password = < | ||
+ | |||
</ | </ | ||
Line 67: | Line 71: | ||
torque.database.default.username=< | torque.database.default.username=< | ||
torque.database.default.password=< | torque.database.default.password=< | ||
+ | |||
</ | </ | ||
Line 77: | Line 82: | ||
* Linux: Execute " | * Linux: Execute " | ||
+ | |||
+ | ===== (Optional) Secure MySQL connection with SSL ===== | ||
+ | |||
+ | 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 | ||
+ | * Create a Java trust store based on the MySQL server certificate: | ||
+ | |||
+ | < | ||
+ | $JAVA_HOME/ | ||
+ | |||
+ | </ | ||
+ | |||
+ | * Change the database.properties and append the following to your JDBC url: | ||
+ | |||
+ | < | ||
+ | & | ||
+ | |||
+ | </ | ||
+ | |||
+ | * The complete JDBC url should now look similar like this: | ||
+ | |||
+ | < | ||
+ | torque.database.default.url = jdbc: | ||
+ | |||
+ | </ | ||
===== Configure Virus Scanner ===== | ===== Configure Virus Scanner ===== | ||
Line 104: | Line 135: | ||
* Modify the red colored value: // | * Modify the red colored value: // | ||
* 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 "< | ||
+ | |||
+ | Adjust the lines< | ||
+ | |||
+ | -Xms1g | ||
+ | -Xmx1g | ||
+ | |||
+ | </ | ||
+ | |||
+ | After that restart the Stages search service. | ||
+ | |||
===== Install customer specific metamodel (if available) ===== | ===== Install customer specific metamodel (if available) ===== | ||
Line 133: | Line 178: | ||
* 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) |
* Windows: | * Windows: | ||
- | * Open file: " <Stages installation path> | + | |
+ | | ||
* 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> | + | * Repeat this step for file: " <Stages installation path> |
+ | * Add the diagram.font.list property to your config.xml file in the following way: < | ||
+ | * Execute: "< | ||
* Linux: | * Linux: | ||
- | * Open file: "< | + | |
+ | | ||
* Adjust the following setting according to the font to be used: \\ //var FONTNAME = "Arial Unicode MS"; \\ | * Adjust the following setting according to the font to be used: \\ //var FONTNAME = "Arial Unicode MS"; \\ | ||
var FONTNAME = " | var FONTNAME = " | ||
- | * Repeat this step for file: "< | + | * Repeat this step for file: "< |
+ | * Add the diagram.font.list property to your config.xml file in the following way: < | ||
+ | * Execute: "< | ||
+ | |||
+ | <font inherit/ | ||
+ | |||
+ | __Configuring font for Stages process visualizations (metamodel: Unified Configuration) [<font inherit/ | ||
+ | * 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: < | ||
+ | * Execute: "< | ||
__Configuring font for Stages PDF printing:__ | __Configuring font for Stages PDF printing:__ | ||
Line 151: | Line 210: | ||
* Open file: "< | * Open file: "< | ||
* Adjust the following property: //< | * Adjust the following property: //< | ||
+ | |||
===== Install Stages license ===== | ===== Install Stages license ===== | ||
Line 168: | Line 228: | ||
* 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:// | * 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:// | ||
* 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 '' |
- | * Configure a redirect from ports 80 and/ | + | * To enforce redirection from http to https add the following to '' |
+ | |||
+ | < | ||
+ | < | ||
+ | < | ||
+ | < | ||
+ | </ | ||
+ | < | ||
+ | < | ||
+ | < | ||
+ | </ | ||
+ | </ | ||
+ | |||
+ | </ | ||
+ | |||
+ | * Enable global secure mode for Stages to set the neccessary headers for cross site scripting prevention in config.xml | ||
+ | |||
+ | < | ||
+ | [...] | ||
+ | < | ||
+ | [...] | ||
+ | < | ||
+ | </ | ||
+ | [...] | ||
+ | |||
+ | </ | ||
===== Accessing Stages ===== | ===== Accessing Stages ===== | ||
- | After successful installation process - Stages is accessible via web browser by URL [[https:// | + | After successful installation process - Stages is accessible via web browser by URL [[https:// |
+ | |||
+ | ===== Prepare Stages for productive usage ===== | ||
+ | |||
+ | **Users** | ||
+ | |||
+ | Delete all users except Superuser and Default, especially the demo users. | ||
+ | |||
+ | **Workspaces** | ||
+ | |||
+ | Delete the workspaces "'' | ||
+ | |||
+ | **Further setup** | ||
+ | |||
+ | Please contact your Method Park Product Consultant to further adapt the Stages process content for productive usage. | ||