Toggle navigation

Redmine Image Guide

Version 3.3.0

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

Redmine is a flexible project management web application. Written using the Ruby on Rails framework, it is cross-platform and cross-database.Redmine is a free and open source, web-based project management and issue tracking tool. It allows users to manage multiple projects and associated subprojects. It features per project wikis and forums, time tracking, and flexible, role-based access control. It includes a calendar and Gantt charts to aid visual representation of projects and their deadlines. Redmine integrates with various version control systems and includes a repository browser and diff viewer.

Software version: Redmine 3.3.0
Software directory: /data/wwwroot/redmine
Software startup command: /data/wwwroot/redmine/startup.sh
Redmine default access to URL: http://< Public net IP >:3000
Default Redmine Admin Accout: admin/admin123

Ruby software version: ruby 2.1.0, gem 2.2.5, rails 4.2.6,  passenger 5.1.2, git 1.8.3.1
Ruby software environment guide: Click here
Other enviroment:LAMP

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 and 3000 is been allowed

This Image use MySQL for database

#default user/password:root/123456

#Redmine database name: redmine

MySQL User Guide: Click here

Step1. Start Redmine Service

[root@iZbp1i4rjdsy216yq7lgucZ ~]# cd /data/wwwroot/redmine
[root@iZbp1i4rjdsy216yq7lgucZ redmine]# ./start.sh

 

Step2. Open http://< Public net IP >:3000 via browser

1. Open http://< Public net IP >:3000 via browser, Click “Sign in”:

2. Fill in user and password (admin/admin123 ), Click “Login”:

The page after login:

A full list of available Redmine plugins can be found at the Plugin Directory.

Installing a plugin

1. Copy your plugin directory into #{RAILS_ROOT}/plugins (Redmine 2.x)  If you are downloading the plugin directly from GitHub, you can do so by changing into your plugin directory and issuing a command like git clone git://github.com/user_name/name_of_the_plugin.git.

2. If the plugin requires a migration, run the following command in #{RAILS_ROOT} to upgrade your database (make a db backup before).

 

bundle exec rake redmine:plugins:migrate RAILS_ENV=production

3. Restart Redmine

You should now be able to see the plugin list in Administration -> Plugins and configure the newly installed plugin (if the plugin requires to be configured).

Uninstalling a plugin

1. If the plugin required a migration, run the following command to downgrade your database (make a db backup before):

bundle exec rake redmine:plugins:migrate NAME=plugin_name VERSION=0 RAILS_ENV=production

2. Remove your plugin from the plugins folder: #{RAILS_ROOT}/plugins (Redmine 2.x) or #{RAILS_ROOT}/vendor/plugins (Redmine 1.x)..

3. Restart Redmine

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 Redmine 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,please always backup the files and the database of your current installation.

Redmine Upgrade Guide

Websoft9  Redmine Image have installed the phpMyadmin

phpMyAdmin install directory: /data/wwwroot/default/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”

MS Exchange works the same way as other SMTP servers: just edit your config/configuration.yml file with your favorite text editor. Initially, the production section should look something like this:

production:
    delivery_method: :smtp
    smtp_settings:
      address: smtp.example.net
      port: 25
      domain: example.net
      authentication: :login
      user_name: 
      password: redmine

Usually MS Exchange will not require authentication information for outgoing (SMTP) email, so you can just comment out domainauthenticationuser_name and password lines. Then, change address to point to the IP or DNS name of your Exchange server. (if using a DNS name, make sure your web server can resolve it using ping!)

production:
    delivery_method: :smtp
    smtp_settings:
      address: your_exchange_server_address
      port: 25
      #domain: example.net
      #authentication: :login
      #user_name: 
      #password: redmine

You may also have to change the port, depending on your Exchange server’s configuration.

It should also be possible to allow outgoing email instead of just outgoing, by re-enabling the authentication and configuring the domain, username, and password correctly. However, this will require a separate email account to be created specifically for Redmine; you’ll have to ask your Exchange server administrator about creating such an account.

You can very easily add a logo to your Redmine banner by modifying your base.html.erb file.

  1. Edit your base.html.erb file
    Find this line:

        <h1><%= page_header_title %></h1>
    

    Add this line directly above:

         <img src="<%= Redmine::Utils.relative_url_root %>/images/logo.png" style="margin-top: 15px; margin-left: 15px;"/>

    The ruby statement <%= Redmine::Utils.relative_url_root %> will produce the relative URI for your redmine installation.

    Now it should look like this:

        </div>
    
         <img src="<%= Redmine::Utils.relative_url_root %>/images/logo.png" style="margin-top: 15px; margin-left: 15px;"/>
         <h1><%= page_header_title %></h1>
    
        <% if display_main_menu?(@project) %>
  2. Upload your logo
    Example using the scp command:

    # scp logo.png root@example.com:/opt/redmine/public/images
    

    You probably should chown the uploaded logo:

    # chown redmine:redmine /opt/redmine/public/images/logo.png
  3. Restart your web server

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/redmine
find /data/wwwroot/default/redmine -type d -exec chmod 755 {} \;
find /data/wwwroot/default/redmine -type f -exec chmod 644 {} \;

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

Log in as admin,Administrator->Settings->Files,then you can set the maximum file size

And you should 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

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>