Changeset 7613

Timestamp:

Mar 1, 2019, 11:14:39 AM (5 years ago)

Author:

Nicklas Nordborg

Message:

References #2152: Test BASE with Tomcat 9

Updated documentation to recommend Tomcat 9 instead of Tomcat 8.

Location:

trunk/doc/src/docbook

Files:

• admin/installation.xml (modified) (7 diffs)
• appendix/update_warnings.xml (modified) (1 diff)

trunk/doc/src/docbook/admin/installation.xml

@@ -37 +37 @@
     These instructions apply only to the BASE release which this
     document is a part of. The instructions here assume
-    that <ulink url="http://tomcat.apache.org/">Apache Tomcat 8</ulink> is used
+    that <ulink url="http://tomcat.apache.org/">Apache Tomcat 9 (or 8)</ulink> is used
     on the server side. Other servlet engines may work but we only
     test with Tomcat.
@@ -54 +54 @@
         upgrading from a BASE installation that is older (3.0-3.13) 
         you should also read <xref linkend="appendix.update_warnings" />.
+      </para>
+      
+      <bridgehead>Consider upgrading to Tomcat 9</bridgehead>
+      <para>
+        We have started to test BASE with Tomcat 9 and has not found any problems 
+        so far. For new installations we recommend that Tomcat 9 is used. Official 
+        support for Tomcat 8 will be dropped in a future BASE version. For existing
+        installations our recommendation is to start planning for an upgrade to 
+        Tomcat 9.
       </para>
       
@@ -102 +111 @@
             If the BASE application is not shut down already, it is
             time to do it now. Do something like <command>sudo
-            /etc/init.d/tomcat8.0 stop</command>
+            /etc/init.d/tomcat9.0 stop</command>
           </para>
           
@@ -237 +246 @@
           <para>
             Start the Tomcat server: <command>sudo
-              /etc/init.d/tomcat8.0 start</command>
+              /etc/init.d/tomcat9.0 start</command>
           </para>
         </listitem>
@@ -607 +616 @@
         <listitem>
           <para>
-            Download and install Apache Tomcat 8 
+            Download and install Apache Tomcat 9 
             available from <ulink url="http://tomcat.apache.org" />.
           </para>
@@ -613 +622 @@
           <important>
             <para>
-              As of BASE 3.6 we are only supporting Tomcat 8. 
-              Tomcat 7 may work, but there is no guarantee.
+              As of BASE 3.15 we are recommending that Tomcat 9 is used for new
+              installations. BASE still supports Tomcat 8, but this will (officially) 
+              be dropped in a future release.
             </para>
           </important>
@@ -660 +670 @@
           <para>
             For more information about Tomcat options see
-            <ulink url="http://tomcat.apache.org/tomcat-8.0-doc/index.html" />.
+            <ulink url="https://tomcat.apache.org/tomcat-9.0-doc/index.html" />.
           </para>
         </listitem>

trunk/doc/src/docbook/appendix/update_warnings.xml

@@ -38 +38 @@
   <sect1 id="appendix.update_warnings.3.15">
     <title>BASE 3.15</title>
+  
+    <bridgehead>Consider upgrading to Tomcat 9</bridgehead>
+    <para>
+      We have started to test BASE with Tomcat 9 and has not found any problems 
+      so far. For new installations we recommend that Tomcat 9 is used. Official 
+      support for Tomcat 8 will be dropped in a future BASE version. For existing
+      installations our recommendation is to start planning for an upgrade to 
+      Tomcat 9.
+    </para>
   
     <bridgehead>Secondary storage support has been removed</bridgehead>