Bài viết này hướng dẫn chi tiết các bước cài đặt MantisBT, một công cụ quản lý lỗi mã nguồn mở, trên môi trường Apache Tomcat.

Môi trường cài đặt

• Hệ điều hành: Windows 8.1 Update 1 64-bit
• Máy chủ web: Apache Tomcat 9.0.0 64-bit
• Ngôn ngữ kịch bản: PHP 7.1.7 (nts-Win32-VC14-x64)
• Cơ sở dữ liệu: PostgreSQL 9.5.3-1
• Ứng dụng: MantisBT 2.5.1

Các bước cài đặt

1. Cài đặt PostgreSQL

   Tải và cài đặt PostgreSQL theo hướng dẫn mặc định.

2. Chuẩn bị PHP

   Giải nén tệp PHP đã tải về vào thư mục gốc của Tomcat (ví dụ: C:\tomcat) và đổi tên thư mục thành php.

   Thêm đường dẫn đến tệp php.exe vào biến môi trường PATH của hệ thống.

   Sao chép tệp php.ini-development và đổi tên thành php.ini.

3. Cấu hình tệp php.ini

   Mở tệp php.ini đã tạo và thực hiện các thay đổi sau:

   • Bỏ chú thích dòng extension_dir:

     ;extension_dir = "ext"

     thành

     extension_dir = "ext"

   • Bỏ chú thích dòng kích hoạt extension PostgreSQL:

     ;extension=php_pgsql.dll

     thành

     extension=php_pgsql.dll

   • Thay đổi cấu hình CGI:

     ;cgi.force_redirect  = 1

     thành

     cgi.force_redirect  = 0

4. Triển khai MantisBT

   Tạo một thư mục mới tên là mantisbt bên trong <CATALINA_HOME>\webapps\ROOT\WEB-INF (<CATALINA_HOME> là thư mục cài đặt Tomcat).

   Giải nén toàn bộ nội dung của tệp mantisbt-2.5.1.zip vào thư mục <CATALINA_HOME>\webapps\ROOT\WEB-INF\mantisbt vừa tạo.

5. Cấu hình server.xml

   Mở tệp <CATALINA_HOME>\conf\server.xml và thêm các dòng cấu hình sau vào bên trong thẻ <Host>:

   <Context docBase="ROOT/WEB-INF/mantisbt/css" path="/mantisbt/css" />
   <Context docBase="ROOT/WEB-INF/mantisbt/js" path="/mantisbt/js" />

   Hoặc nếu bạn muốn cấu hình trực tiếp trong thẻ <Host>:

   <Host name="localhost" appBase="webapps" unpackWars="true" autoDeploy="true">
       <Context docBase="ROOT/WEB-INF/mantisbt/css" path="/mantisbt/css" />
       <Context docBase="ROOT/WEB-INF/mantisbt/js" path="/mantisbt/js" />
   </Host>

6. Cấu hình context.xml

   Mở tệp <CATALINA_HOME>\conf\context.xml và sửa đổi như sau:

   <Context>

   thành

   <Context privileged="true">

7. Cấu hình web.xml

   Mở tệp <CATALINA_HOME>\conf\web.xml và thêm đoạn cấu hình sau vào bên trong thẻ <web-app>:

   <servlet>
       <servlet-name>php</servlet-name>
       <servlet-class>org.apache.catalina.servlets.CGIServlet</servlet-class>
       <init-param>
           <param-name>clientInputTimeout</param-name>
           <param-value>200</param-value>
       </init-param>
       <init-param>
           <param-name>debug</param-name>
           <param-value>0</param-value>
       </init-param>
       <init-param>
           <param-name>executable</param-name>
           <param-value>C:\tomcat\php\php-cgi.exe</param-value>
       </init-param>
       <init-param>
           <param-name>passShellEnvironment</param-name>
           <param-value>true</param-value>
       </init-param>
       <init-param>
           <param-name>cgiPathPrefix</param-name>
           <param-value>WEB-INF/mantisbt</param-value>
       </init-param>
       <load-on-startup>5</load-on-startup>
   </servlet>
   
   <servlet-mapping>
       <servlet-name>php</servlet-name>
       <url-pattern>/mantisbt/*</url-pattern>
   </servlet-mapping>

8. Khởi động lại Tomcat

   Khởi động lại dịch vụ Apache Tomcat để áp dụng các thay đổi.

9. Kiểm tra cài đặt PHP và cài đặt MantisBT

   Trong thư mục <CATALINA_HOME>\webapps\ROOT\WEB-INF\mantisbt, tạo một tệp tin tên là test.php với nội dung sau:

   <?php phpinfo(); ?>

   Truy cập vào địa chỉ http://localhost:8080/mantisbt/test.php trong trình duyệt để kiểm tra xem PHP đã hoạt động đúng chưa.

   Sau đó, truy cập vào địa chỉ http://localhost:8080/mantisbt/install.php để bắt đầu quá trình cài đặt MantisBT theo các bước hướng dẫn trên giao diện.