TurnKey Linux Virtual Appliance Library

Roundup

-

Issue Tracking System

Roundup is a simple-to-use and and powerful issue-tracking system with command-line, web and e-mail interfaces. Roundup is being used for bug tracking and TODO list management, issue management, customer help desk support, and sales lead tracking.

Stable version: 14.0 (changelog)

This appliance includes all the standard features in TurnKey Core, and on top of that:

  • Roundup configurations:
    • Installed from package management. See /var/www for links to file paths.
    • Uses Apache2 to serve roundup (instead of roundup-server).
    • Disabled registration confirmation via email (requires mail server).
    • Includes Xapian full text indexer (recommended for large issue DB).
    • Includes full timezone support and documentation.
  • SSL support out of the box.
  • Postfix MTA (bound to localhost) to allow sending of email (e.g., password recovery).
  • Webmin modules for configuring Apache2, MySQL and Postfix.

Initial configuration: /etc/roundup/tracker-config.ini

Required settings:

[tracker]
web = /                     (before)
web = http://appliance_ip/  (after)
# Note: If not set, links in emails will not include server address.

Recommended settings:

[main]
admin_email = admin
dispatcher_email = admin
[mail]
domain = example.com

Usage details & Logging in for Administration

No default passwords: For security reasons there are no default passwords. All passwords are set at system initialization time.

Ignore SSL browser warning: browsers don't like self-signed SSL certificates, but this is the only kind that can be generated automatically without paying a commercial Certificate Authority.

Username for roundup:

Login as username admin

Web - point your browser at either:

  1. http://12.34.56.789/ - not encrypted so no browser warning
  2. https://12.34.56.789/ - encrypted with self-signed SSL certificate

Username for database administration:

Login as MySQL username root at

  1. https://12.34.56.789:12322/ - Adminer database management web app
  2. MySQL command line tool:
    $ mysql --user root --password
    Enter password:
    Welcome to the MySQL monitor.  Commands end with ; or \g.
    Type 'help;' or '\h' for help. Type '\c' to clear the current input statement.
    
    mysql>
    

Username for OS system administration:

Login as root except on AWS marketplace which uses username admin.

  1. Point your browser to:
  2. Login with SSH client:
    ssh root@12.34.56.789
    

    Special case for AWS marketplace:

    ssh admin@12.34.56.789
    

* Replace 12.34.56.789 with a valid IP or hostname.