Toggle navigation

MantisBT Image Guide

Version 2.2.0

Websoft9 MantisBT is a pre-configured, ready to run image for running MantisBT on Alibaba Cloud.

MantisBT is an open source issue tracker that provides a delicate balance between simplicity and power. Users are able to get started in minutes and start managing their projects while collaborating with their teammates and clients effectively.MantisBT makes collaboration with team members & clients easy, fast, and professional

Software Version: MantisBT2.2.0
Software directory: /data/wwwroot/default/mantisbt

Basic software environment: LAMP
PHP Configuration File: /usr/local/php/etc/php.ini
Virtual host Configuration File directory: /usr/local/apache/conf/vhost
Virtual host Configuration Command: /root/oneinstack/vhost.sh

Database install directory: /usr/local/mysql
Database data directory: /data/mysql
Database Configuration File: /etc/my.cnf

This Image use MySQL for database

#default user/password:root/123456

MySQL User Guide: Click here

After the installation of Image,please verify it

  • Login on Alibaba Cloud console,get you Internet IP Address
  • Open you Chrome or Firefox on your local PC,visit the http://Internet IP Address/
  • If verify successfully,you can enter the boot page of Websoft9 below
  • If no response from browser,please check the Security Group settings to ensure that port 80 is been allowed

Step1. Create a database

1.login in MySQL:

Method 1:Use following URL to open phpMyAdmin page: http://< Public net IP >/phpMyAdmin

Method 2:Use SSH command to login in.

mysql -uroot –p                                #enter mysql console

 #default user/password:root/123456            More MySQL User Guide: Click here

 

2.create a database:

 

MySQL [(none)]> create database mydbname;

MySQL [(none)]> show databases;

 

3.Create a Database User and grants permissions to the User:

MySQL [(none)]> grant all privileges on mydbname.* to username@'localhost' identified by 'userpassword';

MySQL [(none)]> flush privileges;

MySQL [(none)]> exit;

 

before2

Step2. Add a virtual host

Use SSH Command to Add a virtual host:

[root@iZbp1i4rjdsy216yq7lgucZ ~]# cd /root/oneinstack
[root@iZbp1i4rjdsy216yq7lgucZ oneinstack]# ./vhost.sh

Step3. Install MantisBT

Open your domain name via browser:
1. Fill in your database configration, Click “Install/Upgrade Database”;

2. Installation done,  Click “Back to Administration”;

3. Fill in Admin user and password ,  Click “Login”;
Default user/password: administrator/root

4. The MantisBT page :

MantisBT plugins can be found at https://github.com/mantisbt-plugins.

More plugins can be found at http://www.mantisbt.org/bugs. Typically they are stored as issue attachments using own projects (look at projects starting with “Plugin -”) or project “mantisbt” and category “Plugins”.

A plugin is simply a directory with files in it. To install one:

  1. Download and unzip the plugin files to your computer
  2. Upload the plugin directory and the files it contains files under <yourMantisRoot>/plugins
  3. In MantisBT go to page Manage > Manage Plugins. You will see a list of installed and currently not installed plugins
  4. Click the Install link to install a plugin.

WARNING: some plugins require patching MantisBT’s core to operate (e.g. to add new Events). Please note that such changes are neither recommended nor supported by the MantisBT team, as they potentially introduce bugs and/or incompatibilities with future versions. Use such plugins at your own risk !

Routine backup (archives) of the database and application setup is essential to ensure failover is smooth.you can use Manual Backup as following steps:

  1. Download the entire MantisBT files in you root dictionary by FTP or other tools
  2. Visit http://< Internet IP Address >/phpMyAdmin,login in to the phpMyAdmin Panel
  3. Select you database,then Export
  4. Click “go” button,then download the SQL backup file

Before upgrade you should put the site down for maintenance and always Backup your code, data and config files.Below is the steps for upgrade:

  1. Copy the files listed below to subdirectory config of the new directory. You might have to copy as well other custom files such as logo, favicon, css, etc.
    config_inc.php,custom_strings_inc.php,custom_constants_inc.php and custom_functions_inc.php
  2. Execute the upgrade script. From your web browser, access
    http://yoursite/mantisbt-NEW/admin/install.php
    

    where mantisbt-NEW is the name of the directory where the new release was extracted

  3. Provide required information for the upgrade
    • high-privileged database account
      Additional privileges required: INDEX, CREATE, ALTER, and DROP
      If this account is not specified, the database user will be used.
  4. Click the Install/Upgrade Database button
  5. At the end of the upgrade, review and correct any warnings or errors.

More detais read the https://www.mantisbt.org/docs/master/en-US/Admin_Guide/html-desktop/#admin.install.upgrade

Zurmo support multi-languages,how to use your languages?

  1. go to Dashboard->Administrator->Manage->Manage User
  2. Then  find the language selection on Account Preferences Section
  3. Select the language and click the button “Update User”

Websoft9 Mantis Image have installed the phpMyadmin

Linux

Following is the step for access phpMyadmin

  1. Open Chrome or Firefox on your local PC
  2. visit the http://Internet IP Address/phpMyAdmin,you can enter the login page
  3. select you language,Username:root,Password:123456
  4. Click the button “Go”

Windows

Following is the step for access phpMyadmin

  1. User Remote Desktop Connection of Window to connect to you ECS
  2. Install a Chrome or Firefox browser on you ECS
  3. Open Chrome or Firefox on your ECS
  4. visit the http://localhost or 127.0.0.1/phpMyAdmin,you can enter the login page
  5. select you language,Username:root,Password:123456
  6. Click the button “Go”

When install new extension from back-end it will not successful,may be the permissions of file and folder is not appropriate,you should change it

Web site root permissions to follow:
file 644, folder 755 ,Permissions Users and groups www
If there is a file permissions problem, execute the following three commands:

chown -R www.www /data/wwwroot/default/mantis
find /data/wwwroot/default/mantis -type d -exec chmod 755 {} \;
find /data/wwwroot/default/mantis -type f -exec chmod 644 {} \;

Modify the  /usr/local/php/etc/php.ini file to increase the allowed size for uploads:

; Maximum size of POST data that PHP will accept.
post_max_size = 16M
; Maximum allowed size for uploaded files.
upload_max_filesize = 16M

then,restart the apache

# service httpd restart

The PHP configuration file allows you to configure the modules enabled, the email settings or the size of the upload files. It is located at /usr/local/php/etc/php.ini.

There are some PHP settings that need to be sufficient to install.

e.g The values for PHP.ini below are suggested values only.

  • memory_limit – Minimum: 256M Recommended: 1G or better
  • upload_max_filesize – Minimum: 20M
  • post_max_size – Minimum: 20M
  • max_execution_time: At Least 120 Recommended: 300

After modifying the PHP configuration file, restart both Apache and PHP-FPM for the changes to take effect:

# service httpd restart

If you receive the message “Maximum execution time of 30 seconds exceeded”.You may also like to extend the max_execution_time for PHP and you can modify it by two methods below

Method one: edit your  /usr/local/php/etc/php.ini


; Maximum execution time of each script, in seconds
; http://php.net/max-execution-time
; Note: This directive is hardcoded to 0 for the CLI SAPI
max_execution_time = 90
; Maximum amount of time each script may spend parsing request data. It's a good
; idea to limit this time on productions servers in order to eliminate unexpectedly
; long running scripts.

Method two: edit your .htaccess:


<IfModule mod_php5.c>
php_value max_execution_time 90
</IfModule>