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/04/10 10:39] – [Perform basic installation] vtbr72:install [2019/12/12 12:13] – [Configure SSL] twn
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 168: Line 168:
   * 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)