Skip to content

Commit

Permalink
Browse files Browse the repository at this point in the history
Doc: update system requirements for 1.3.x
Re-introduce the notion of "experimental support" for MSSQL and Oracle,
following report of several issues preventing a clean install.
  • Loading branch information
dregad committed Nov 26, 2016
1 parent 31385f2 commit b3ef71d
Showing 1 changed file with 51 additions and 19 deletions.
70 changes: 51 additions & 19 deletions docbook/Admin_Guide/en-US/Installation.xml
Expand Up @@ -104,7 +104,7 @@

<listitem>
<para>Disk</para>
<para>The application code is less than 20 MB
<para>The application code is less than 30 MB.
</para>
<para>The amount of disk space required for the database
will vary depending on the RDBMS and the volume of
Expand Down Expand Up @@ -195,10 +195,7 @@
requesting an attachment.
</para>
<para>This extension is included by default from
PHP version 5.3.x and above. For older versions
you will need to install the fileinfo PECL
extension (this requires root access to the
server you're using).
PHP version 5.3.x and above.
</para></listitem>

<listitem><para><emphasis>mbstring</emphasis> -
Expand All @@ -218,17 +215,45 @@
<para>Database</para>
<para>MantisBT requires a database to store its data.
The supported RDBMS are:
MySQL (recommended),
PostgreSQL,
Microsoft SQL Server and
Oracle.
</para>
<note><para>
DB2 is deprecated. Since none of the MantisBT core
developers have access to this platform, support
is very limited and likely to be removed in the
future.
</para></note>
<itemizedlist>
<listitem><para>MySQL (or one of its forks, e.g. MariaDB)
</para></listitem>
<listitem><para>PostgreSQL</para></listitem>
</itemizedlist>
<para>Experimental support is also available for
</para>
<itemizedlist>
<listitem><para>Microsoft SQL Server</para></listitem>
<listitem><para>Oracle</para></listitem>
<listitem><para>DB2 (deprecated).
Since none of the MantisBT core developers have
access to this platform, support for it is very
limited and likely to be removed in the future.
</para></listitem>
</itemizedlist>
<para>Experimental support means that manual intervention
by a skilled Database Administrator may be required to
complete the installation, and/or that there may be
known issues or limitations when using the software.
Please refer to our
<ulink url="https://mantisbt.org/bugs/">Issue tracker</ulink>,
filtering on categories
<emphasis>db mssql</emphasis>,
<emphasis>db db2</emphasis> and
<emphasis>db oracle</emphasis>
to find out more about those.
</para>
<note>
<para>Please note that the MantisBT development team
mainly works with MySQL, so testing for other
drivers is not as extensive as we mainly rely on
community contributions to improve support and fix
issues with other RDBMS.
</para>
<para>We therefore recommend MySQL to store your database.
</para>
</note>
</listitem>

</itemizedlist>
Expand All @@ -250,7 +275,7 @@
<tbody>
<row>
<entry morerows='4' valign='middle'>RDBMS</entry>
<entry>MySQL</entry>
<entry>MySQL / MariaDB</entry>
<entry>5.0.8</entry>
<entry>5.5.x or above</entry>
<entry>PHP extension: mysqli (recommended) or mysql</entry>
Expand Down Expand Up @@ -283,8 +308,8 @@
<row>
<entry morerows='3' valign='middle'>Web Server</entry>
<entry>Apache</entry>
<entry>1.3.x</entry>
<entry>2.2.x</entry>
<entry>2.4.x</entry>
<entry></entry>
</row>
<row>
Expand All @@ -295,8 +320,8 @@
</row>
<row>
<entry>nginx</entry>
<entry>0.8.x</entry>
<entry>0.8.x</entry>
<entry>1.10.x</entry>
<entry>1.10.x</entry>
<entry></entry>
</row>
<row>
Expand All @@ -317,6 +342,13 @@
</tgroup>
</informaltable>

<warning>
<para>Running MantisBT with versions of the software
components lower than the minimum requirements listed
above is not supported.
</para>
</warning>

</section>
</section>

Expand Down

0 comments on commit b3ef71d

Please sign in to comment.